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

c-source and h-source missing for latex (Origin: bugzilla #436885) #2479

Closed
doxygen opened this Issue Jul 1, 2018 · 0 comments

Comments

Projects
None yet
1 participant
@doxygen
Owner

doxygen commented Jul 1, 2018

status RESOLVED severity normal in component general for ---
Reported in version 1.5.2 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

On 2007-05-08 13:37:28 +0000, Aaron Wright wrote:

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

On 2007-09-23 13:15:25 +0000, zaffanella@cs.unipr.it wrote:

Created attachment 96061
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).

On 2013-05-26 16:15:23 +0000, albert wrote:

Created attachment 245340
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).

On 2013-12-31 13:38:47 +0000, Max Bruckner wrote:

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.

On 2013-12-31 18:49:38 +0000, albert wrote:

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.

On 2014-01-02 16:09:02 +0000, Dimitri van Heesch wrote:

Thanks, I've merged the pull request.

On 2014-04-21 10:09:39 +0000, Dimitri van Heesch wrote:

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).

On 2014-04-25 21:42:00 +0000, Max Bruckner wrote:

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

@doxygen doxygen closed this Jul 1, 2018

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