Re: [Boost-build] Doxygen and XML/BoostBook documentation

Subject: Re: [Boost-build] Doxygen and XML/BoostBook documentation
From: Phillip Seaver (phil_at_[hidden])
Date: 2009-02-26 17:04:49

Anthony Foglia wrote:
> Phillip Seaver wrote:
>
>> I generate html (with "doxygen foo.html") then use LaTeX to create the
>> PDF.  Here are (I believe) all the relevant doxygen parameters:
>>
>>     # generate LaTeX output (used to create PDF)
>>     GENERATE_LATEX=YES
>>     # set output sub-directory to "latex"
>>     LATEX_OUTPUT=latex
>>     # command to run for latex
>>     LATEX_CMD_NAME=latex
>>     # paper size to use in latex output
>>     PAPER_TYPE=letter
>>     # "The PDF file will contain links (just like the HTML output)
>> instead
>>     # of page references"
>>     PDF_HYPERLINKS=YES
>>     # "doxygen will use pdflatex to generate the PDF file directly
>> from the
>>     # LaTeX files."
>>     USE_PDFLATEX=YES
>>
>> This creates a "latex" subdirectory in the same directory as the output
>> html.  If you have the right software installed, you can simply run
>> "make" in that directory to create the PDF (which will be named
>> refman.pdf).
>
> Good idea, except I was hoping to use the doxygen settings we've set
> in the Jamroot, without having to copy them into a Doxyfile file.
> Unfortunately, passing doxygen:param="GENERATE_LATEX=YES" when
> invoking bjam does no good because boost.build adds a
> GENERATE_LATEX=NO at the end of the Doxyfile it creates.

Ah.  I'd forgotten that.  I've made a few changes to my copy -- I'll
look it over later to see if it's okay for posting.

In the meantime, you could change doxygen.jam to move the "text +=
"GENERATE_LATEX = NO" ;" line up above the place where it has "#
Translate <doxygen:param> into command line flags." to avoid that problem.

Phillip