GNOME Bugzilla – Bug 436885
c-source and h-source missing for latex
Last modified: 2014-04-25 21:42:00 UTC
When having doxygen generate linked PDF files as output using latex, pdfTex gives a warning that the files that contain the header and source code (i.e. the .h and .c files) are being referenced, but the files are missing. The refman.pdf contains links to the files, but they just go to the title page. The files are not being generated by doxygen and put in the latex directory. The warnings given are as follows: ! pdfTeX warning (dest): name{my_f_i_f_o_8h-source} has been referenced but does not exits, replaced with a fixed one ! pdfTeX warning (dest): name{my_f_i_f_o_8c-source} has been referenced but does not exits, replaced with a fixed one
Created attachment 96061 [details] [review] PATCH: disable source file inclusion for all but HTML documentation. The following is a proposal of a patch for bug 436885. The bug is still present in the last tarball (doxygen-1.5.3-20070902) and the patch applies to that version. As far as I can understand, the listing of the source files is to be included in the documentation produced for the HTML format only (all other output formats being disabled when writing the listing). Hence, the proposed patch modifies the generation of the file documentation so that a link to such a listing is only produced for HTML (i.e., not for LaTeX). The patch has been tested successfully on our own project (where we had the same problem).
Created attachment 245340 [details] Example to reproduce the problem In version 1.8.4 the problem is still present. The patch as attached to this bug does, as far as I can see, not solve the problem. Find attached a complete project with source and results. The problem occurs when the source file is in a subdirectory of the current directory. To see the problem occurs select the hyperlink to aa.cpp at the bottom of page numbered 3 (Definition at line 4 of file aa.cpp.) The essential difference is: ...\latex>diff aa_8cpp_source.tex bb_8cpp_source.tex 1,2c1 < \hypertarget{aa_8cpp}{\section{aa.\-cpp} < \label{aa_8cpp}\index{src/aa.\-cpp@{src/aa.\-cpp}} --- > \hypertarget{bb_8cpp_source}{\section{bb.\-cpp} We see that aa.cpp in the \hypertarget does not have "_source" (and also that there is an extra \label statement).
The same problem still exists in 1.8.6. I can reproduce it on GNU/Linux and Windows with the following Doxyfile: OUTPUT_DIRECTORY = doc EXCLUDE_PATTERNS = */doc/* */build/* SOURCE_BROWSER = YES LATEX_SOURCE_CODE = YES The source code isn't included into the PDF but there are links to it that point to page 'i'. But there are latex files called XXXX_8cpp_source.tex where XXXX is the name of the C++ source file. When adding "INLINE_SOURCES = YES", the source code for the respective functions get's included into the pdf file.
Regarding comment 3.Been diving into the problem a bit looks like it has to do whether or not the file is included in the documentation or not. In case of HTML the source code is included even when function documentation is not included. When setting \file in a file or globally set EXTRACT_ALL to YES the source code is included in the LaTeX output. The problem of the mentioned bug_436885 originally looks like to be the same problem but has got a different meaning in time, I think now it is about jumping to the beginning of the document. For the later problem I've pushed a solution for the later problem to github (pull request 77), In case the original problem of this bug report still exists, after checking the suggestions regarding EXTRACT_ALL and \file, please add a small self containing example with doxyfile to this bug report.
Thanks, I've merged the pull request.
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.8.7. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant (preferrably in the form of a self-contained example).
This bug still exists in the same way as described earlier. The Bug can be reproduced with any source files and following DOXYFILE: OUTPUT_DIRECTORY = doc EXCLUDE_PATTERNS = */doc/* */build/* SOURCE_BROWSER = YES LATEX_SOURCE_CODE = YES