Re: [Boost-docs] Ticket #2232: Documentation build needs to detect missing prerequisites

Subject: Re: [Boost-docs] Ticket #2232: Documentation build needs to detect missing prerequisites
From: Daryle Walker (darylew_at_[hidden])
Date: 2008-08-20 18:06:20

On Aug 20, 2008, at 7:20 AM, Beman Dawes wrote:

[SNIP]
> Building documentation requires a lengthy tool chain to work  
> correctly.
>
> The following tools have to be installed:
>
>    libxml2, libxslt, doxygen, docbook-xml42, docbook-xsl, tetex (?),
>    ghostscript

Does it have to be tetex and ghostscript, or can any (La)TeX system  
be used?  (I think I now have texlive on my system.)

> user-config.jam needs to supply usings for:
>
>    xsltproc, boostbook with docbook-xsl and docbook/4.2, doxygen,
>    quickbook

Doesn't there need to be entries for TeX in there too (especially if  
we don't want to be locked to tetex)?

> Experience has shown that (1) even very experienced Boost  
> developers can have missing tool chain items, and (2) missing tool  
> chain items are very difficult to diagnose and repair because the  
> current bjam setup does not issue meaningful error messages,  
> produces partial documentation, and gives the appearance of working.
[TRUNCATE]

-- 
Daryle Walker
Mac, Internet, and Video Game Junkie
darylew AT hotmail DOT com