Boost logo

Boost-Build :

Subject: Re: [Boost-build] Doxygen and XML/BoostBook documentation
From: Anthony Foglia (AFoglia_at_[hidden])
Date: 2009-02-26 16:26:50


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.

$ bjam -d+2 doxygen:param="GENERATE_LATEX=YES"
doxygen:param="LATEX_OUTPUT=latex" doxygen:param="LATEX_CMD_NAME=latex"
doxygen:param="PAPER_TYPE=letter" doxygen:param="PDF_HYPERLINKS=YES"
doxygen:param="USE_PDFLATEX=YES" documentation.html

[...]
file /tmp/jam42b134c.000
ALPHABETICAL_INDEX = YES
BUILTIN_STL_SUPPORT = YES
CASE_SENSE_NAMES = YES
CLASS_GRAPH = YES
COLLABORATION_GRAPH = YES
DETAILS_AT_TOP = YES
DISTRIBUTE_GROUP_DOC = YES
DOT_MULTI_TARGETS = YES
EXTRACT_ALL = YES
EXTRACT_STATIC = YES
FILE_VERSION_FILTER = doxy-version-filter.sh
GENERATE_HTML = YES
GENERATE_LATEX = YES
GENERATE_TAGFILE = /home/AFoglia/projects/asa/trunk/doxygen/cpp/doxytags
GENERATE_XML = NO
GROUP_GRAPHS = YES
HAVE_DOT = YES
HTML_OUTPUT = documentation
INLINE_INHERITED_MEMB = YES
LATEX_CMD_NAME = latex
LATEX_OUTPUT = latex
OUTPUT_DIRECTORY = /home/AFoglia/projects/asa/trunk/doxygen/cpp
PAPER_TYPE = letter
PDF_HYPERLINKS = YES
SOURCE_BROWSER = YES
TEMPLATE_RELATIONS = YES
USE_PDFLATEX = YES
GENERATE_LATEX = NO
INPUT = # file list omitted
[...]

-- 
Anthony Foglia
Princeton Consultants
(609) 987-8787 x233

Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk