How to get a single PDF document from Doxygen?

See Converting a LaTeX document to a PDF document.

When Doxygen is finished processing, in the latex directory there's a file called 'refman.tex'.

There are three ways you can use that file to get 'a book' out of Doxygen:

  • LaTeX -> dvips -> ps2pdf

    latex myfile

    dvips myfile

    ps2pdf myfile.ps

  • LaTeX -> dvipdfm

    latex myfile

    dvipdfm myfile

  • pdflatex (or pdftex for plain TeX)

    pdflatex myfile


Using Doxygen 1.8.4+ (on Windows), there is also a make.bat script so you don't even need to open the command line.

  1. Configure Doxygen for LaTeX output.

    GENERATE_LATEX = YES LATEX_OUTPUT = latex OUTPUT_DIRECTORY =

  2. Set up all your images for LaTeX output.

    \image html application.jpg \image latex application.eps "My application" width=10cm

  3. Run Doxygen.

  4. Run {OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\make.bat.
  5. Open {OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\refman.pdf.

If refman.pdf is not created, run make.bat from a command window and read the errors.

Errors like: 'pdflatex' is not recognized as an internal or external command,... Mean that you do not have the prerequisites to run latex at all. Other errors may be due to missing latex packages or doxygen bugs causing invalid .tex files.

Once you have all the prerequisites installed, and a good version of doxygen, the simpler procedure should work every time.


Assuming that doxygen is configured correctly, under Linux:

doxygen
cd latex
make

The generated file will be refman.pdf unless it's configured otherwise.