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: Eric Niebler (eric_at_[hidden])
Date: 2008-08-20 15:07:35

Vladimir Prus wrote:
> Beman Dawes wrote:
> 
>> The following tools have to be installed:
>>
>>     libxml2, libxslt, doxygen, docbook-xml42, docbook-xsl, tetex (?),
>>     ghostscript
> 
> This list seems fairly strange to me:
> 
> - How comes we depend on tetex? And ghostscript? Is this always necessary 
> for building docs, or just for maintaining some files that are subsequently
> included into final docs? If the latter, then it's not our problem. If the
> former, then how comes?

This is because the Accumulators docs have LaTeX formulas embedded in 
Doxygen comments directly in the C++ source code. The Accumulators 
reference section is built using Doxygen, which needs to invoke LaTeX to 
process the formulas, generate the images and link to them correctly.

I could generate the images by hand and check them in, but then as soon 
as someone modifies the Doxygen comments in my code, the links to the 
images would get out of whack, and the problem could be very subtle: 
different formulas showing up in the wrong places.

-- 
Eric Niebler
BoostPro Computing
http://www.boostpro.com