Doxygen: How to include source files in LaTeX output

Question

I'm using doxygen for the documentation of a program and I'm trying to get the actual source files to be included into the PDF-Output of the LaTeX generator.

I've set the following settings in the doxygen configuration file:

SOURCE_BROWSER = YES
INLINE_SOURCES = NO
LATEX_SOURCE_CODE = YES
STRIP_CODE_COMMENTS = NO

Some tex files containing the sources are being generated, but the generated refman.pdf doesn't contain it. When Enabling INLINE_SOURCES, the respective code parts get included though.

So does anyone know how to make doxygen include the actual source code into refman.pdf just like it's being included into the html documentation?

EDIT: While the source code isn't included in the PDF, doxygen creates links to the respective page, where the source code should be. However every link links to the nonexistent page 'i'.

EDIT: Same problem still exists with doxygen 1.8.6! I searched through the doxygen archives and found a post from 2008 stating, that doxygen can't include source code in the PDF file, but this is probably outdated.

EDIT: I found the corresponding bugreport. I will now start to strip everything from the Doxyfile that is not needed to reproduce the problem.

@albert I'm using doxygen version 1.8.5 on Archlinux with the following Doxyfile: pastebin.com/sTfp1GkW — FSMaxB
– FSMaxB, Commented Dec 11, 2013 at 21:57
I've been looking into the problem and with your Doxyfile the problem occurs also on my sources. When using my own Doxyfile the sources are shown. With my own Doxyfile I also noted that when clicking on the line number reference I go to the source code but when clicking on the file name I jump to the beginning of the pdf. an you file a bug report for this problem including your doxyfile and possibly a small dummy source file to reproduce the problem? — albert
– albert, Commented Dec 30, 2013 at 18:51
@albert Ok, as soon as I find the time, I'll file a bug report. But I'm not exactly sure, where to do this, the only place I could find that looks like a bugtracker are the archives ( doxygen.10944.n7.nabble.com ). — FSMaxB
– FSMaxB, Commented Dec 30, 2013 at 22:04
Please have a look at the doxygen documentation, especially: stack.nl/~dimitri/doxygen/manual/trouble.html#bug_reports here there is a reference to the bugzilla (bugzilla.gnome.org/enter_bug.cgi?product=doxygen) — albert
– albert, Commented Dec 31, 2013 at 12:35

FSMaxB · Accepted Answer · 2014-01-05 13:56:07Z

1

Thanks to albert, the bug should be solved ( I wasn't able to compile it myself, though ) and the fix is already merged upstream.

Albert also provided the workaround to either set EXTRACT_ALL = YES or add \file for each source file that has to be included.

answered Jan 5, 2014 at 13:56

FSMaxB

2,5204 gold badges30 silver badges43 bronze badges

Sign up to request clarification or add additional context in comments.

Collectives™ on Stack Overflow

Doxygen: How to include source files in LaTeX output

1 Answer 1

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Your Answer

Sign up or log in

Post as a guest

Related