id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
2232	Documentation build needs to detect missing prerequisites	Beman Dawes	No-Maintainer	"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

user-config.jam needs to supply usings for:

     xsltproc,
     boostbook with docbook-xsl and docbook/4.2,
     doxygen,
     quickbook
     
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.

The requested fix is twofold:

*  Specific error messages should be issued if the tool chain is not complete. The messages should distinguish between tools not being installed and user-config.jam not having all the required entires. The error messages should name the specific missing tool or missing user-config.jam entry.

*  If one of the above errors is detected, the process should stop at that point. Currently partial documentation is built, and that can be very misleading and time-consuming. If the tool chain is wrong, nothing at all should be built."	Feature Requests	new	To Be Determined	Documentation	Boost 1.36.0	Problem			john@… daniel@…