re-visit building pdf from doxygen latex output

[derekbruening]

From [email protected] on March 02, 2009 13:51:59

we should try building pdf docs again w/ newer doxygen

w/ cmake ( issue #19 ) I'm initially disabling latex generation and processing
(so no longer need epstopdf)

this case covers re-adding (optional) pdf generation

if epstopdf and latex are available, set "GENERATE_LATEX" to "YES" in the
Doxyfile

need to add a pdf target using fix-latex.pl and pdf install rules to cmake

xref PR 314339 inlined below:

PR 314339: doxygen pdf missing most intro pages on linux and missing page
headers on windows

linux one is missing almost all of the intro pages

windows looks much better: has some minor issues still (e.g., no header for
Usage Model), and pages+sections are all collapsed into one level

for now, for govirtual, not bothering to give out pdf: html will always
look nicer and be easier to browse.

doxygen 1.5.3 from toolchain looks pretty good, actually: my local 1.5.6 is
the one missing the intro pages, which is strange, since 1.5.5's changelog
claims it handles pages in latex better

if we do revive should hack the latex to wrap some lines that go off the edge:
C:\dr\bin\drdeploy.exe -reg calc.exe -root C:\dr -client C:\dr\docs\html...

1.5.6 changelog:
a page marked as a sub page (\subpage) is now shown in the LaTeX and RTF
output as a section of its parent page. So the top level pages are shown
a chapters, subpages as sections, subpages of a subpage as subsections,
etc.

1.5.7 has a LAYOUT_FILE option for more control

Original issue: http://code.google.com/p/dynamorio/issues/detail?id=59