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
>