[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: documentation types

On Fri, 2006-02-10 at 07:36 -0500, Neil Roeth wrote:
>  > I about packaging a library that ships an API reference in docbook SGML and 
>  > provides manual build targets for PDF, PS and HTML.
>  > 
>  > Is there any preference on which type should be included in the -dev package?
>  > I would prefer PDF:
>  >  * one file only
>  >  * easy to print
>  >  * many viewers available
>  > 
>  > I would rather not build all three as this is a definite waste of disk space.
>  > 
>  > Suggestions are welcome...
> Could it be a configure option, so that the first time the package is
> installed it would ask which subset of the three to install (defaulting to PDF
> only), and later, when upgrading the package, it would install the same
> subset with no further interaction?

Unless each copy of the documentation is 20M, then I'd say install both
HTML and PDF (in a -doc package if they are over say a meg) as anything
else is overcomplicated.  We're just talking about a few megabytes.

Ross Burton                                 mail: ross@burtonini.com
                                          jabber: ross@burtonini.com
                                     www: http://www.burtonini.com./
 PGP Fingerprint: 1A21 F5B0 D8D0 CFE3 81D4 E25A 2D09 E447 D0B4 33DF

Attachment: signature.asc
Description: This is a digitally signed message part

Reply to: