Subject: Re: pregenerate docs for a package
To: Klaus Heinz <k.heinz.mai.zwei@onlinehome.de>
From: None <mcmahill@mtl.mit.edu>
List: tech-pkg
Date: 05/05/2002 09:56:41
My preference is pre-generate the docs and include either in files/ (if
small) or as an extra distfile. I hate when a pkg wants latex just to
format the docs....
-Dan
On Sun, 5 May 2002, Klaus Heinz wrote:
> Hi,
>
> would it be acceptable to generate the documentation (HTML from SGML)
> and include it in the package instead of depending on other big
> packages to generate the HTML pages at build time?
>
> The program in question is mail/rblcheck which requires a 'db2html' command.
> This command is contained in a Linux package called docbook-utils
> (which we currently do not have) which requires docbook DTDs/stylesheets,
> a SGML processor, maybe some gnome documentation tools, whatever...
> This seems to be a rather huge overhead to me.
>
> Or should I omit the HTML completely and only install the original SGML
> source file and the postscript and rtf formats from the archive?
> I guess the HTML files were simply forgotten, because the other formats
> _were_ created by similar tools (db2ps, db2rtf) and included in the
> archive.
>
> ciao
> Klaus
>