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 (?),
> 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
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC