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: Vladimir Prus (vladimir_at_[hidden])
Date: 2008-08-20 16:04:17

Eric Niebler wrote:

> 
> 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.

Well, on the other hand, the dependency on tetex is fairly nasty; personally,
I would not even dare to try installing tetex on windows. Did you discuss this
extra requirement on the mailing list?

- Volodya