I sympathize, but am hesitant to give up three properties of the current setup:
(1) people don't have to worry about having LaTeX installed, or that their
different LaTeX setup or package versions might lead to a failure to make the
docs or lead to differences in typesetting from the version I see; (2) they can
read the full docs immediately upon download *before* compiling the package or
any of its dependencies, or on a system that is not able to build the package;
(3) I can give a direct link to docs on GitHub (e.g.,
https://github.com/OpenImageIO/oiio/blob/master/src/doc/openimageio.pdf) that
will always be up to date without having to separately upload PDF docs
somewhere from time to time.
Is there any way we can have a compromise that will make things easier for you,
but still distribute the PDF with our package? How about if you go ahead and
rebuilt it every time, even if other people don't strictly have to?
In the link you give for the DFSG, I do not see any rule that seems to preclude
distributing my PDF file. Can you clarify? Which clause do you think applies
here?
-- lg
On Jul 2, 2013, at 12:40 AM, Matteo F. Vescovi wrote:
> Hi!
>
> Since I started packaging OIIO for Debian, I had to repack anytime the
> source code removing the PDF file of documentation since its presence
> violates the Debian Free Software Guidelines, aka DFSG[1].
> That why you see the [+|~]dsfg0 suffix in the package name.
>
> To follow them, there should be no compiled file in the original code
> tree that could be obtained from source and this is the case, given that
> the Documentation PDF is actually compiled at build time in Debian
> package, being the LaTeX files already in the upstream source.
>
> I know, anyone should install a minimal LaTeX environment to build the
> PDF, but that would be a minor issue in my point of view;
> OTOH, compiling directly from source could drastically decrease the
> possibilities of outdated PDF built from older versions of the code.
>
> Thanks for considering this idea.
>
> Cheers.
>
>
> [1] http://www.debian.org/social_contract#guidelines
>
> --
> Matteo F. Vescovi
> Debian Maintainer
> GnuPG KeyID: 0x83B2CF7A
>
--
Larry Gritz
[email protected]
_______________________________________________
Oiio-dev mailing list
[email protected]
http://lists.openimageio.org/listinfo.cgi/oiio-dev-openimageio.org
