Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

re-visit building pdf from doxygen latex output #59

Open
derekbruening opened this issue Nov 27, 2014 · 0 comments
Open

re-visit building pdf from doxygen latex output #59

derekbruening opened this issue Nov 27, 2014 · 0 comments

Comments

@derekbruening
Copy link
Contributor

From derek.br...@gmail.com 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant