Customizability vs. Shipping a Good Product

Gervase Markham gerv at
Wed Aug 15 09:37:33 UTC 2007

Frédéric Buclin wrote:
> Some installations compile their own documentation, some others (which
> e.g. don't have openjade or all DSSSL librairies installed) point to
> or to some other external reference. Having it hardcoded is
> a mistake. This param is useful as it's used in error messages to give
> some help to users.

OK, let me turn the question round. Why do we make _anyone_ compile 
their own documentation? (I seem to remember it being a right pain; 
perhaps it's got easier since.) Why don't we ship the HTML version in 
the tarball? 99% of installs aren't going to modify it; those who do can 
read our docs on how to do so correctly, then recompile it into the same 


More information about the developers mailing list