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

\cite feature doesn't work under Windows (Origin: bugzilla #656878) #4370

Open
doxygen opened this Issue Jul 2, 2018 · 0 comments

Comments

Projects
None yet
2 participants
@doxygen
Copy link
Owner

doxygen commented Jul 2, 2018

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

Original attachment names and IDs:

On 2011-08-19 09:45:03 +0000, goeck wrote:

using something like:
CITE_BIB_FILES = Literatur

yields the following output of doxygen wioth having a fully functional
bibtex installed :
"Resolving citations...
I couldn't open database file 

C:/Users/me/Documents/NetBeansProjects/project_Qt/doc/bib/doxygen_bibtex_5728_Literatur.bib.bib
---line 3 of file doxygen_bibtex_5728.aux
:
\bibdata{C:/Users/me/Documents/NetBeansProjects/project_Qt/doc/bib/doxygen_bibtex_5728_Literatur.bib
: }
I'm skipping whatever remains of this command
I found no database files---while reading file doxygen_bibtex_5728.aux
Warning--I didn't find a database entry for "richard2005technische"
(There were 2 error messages)
I couldn't open database file
C:/Users/me/Documents/NetBeansProjects/project_Qt/doc/bib/doxygen_bibtex_5728_Literatur.bib.bib
---line 3 of file doxygen_bibtex_5728.aux
:
\bibdata{C:/Users/me/Documents/NetBeansProjects/project_Qt/doc/bib/doxygen_bibtex_5728_Literatur.bib
: }
I'm skipping whatever remains of this command
I found no database files---while reading file doxygen_bibtex_5728.aux
Warning--I didn't find a database entry for "richard2005technische"
(There were 2 error messages)
Generating citations page..."

No citelist HTML page is created.

On 2011-08-20 21:35:57 +0000, Dimitri van Heesch wrote:

Confirmed. Should be fixed in the next subversion update.

On 2011-08-21 08:19:48 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.5.1. 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.

On 2011-08-22 07:48:17 +0000, goeck wrote:

Thanks for the fix. Unfortunetly it's not yet running well on my system.
I get:
citelist:3: warning: Found unknown command `\rev'
citelist:8: warning: end of comment block while expecting command </em>

It doesn't matter, whether I used a bib extension in the config file or not.
Tried both. A citelist.html is not created.
Sorry, I have to reopen the ticket. Maybe it's just a little quirk in my
setup.

Keep it up.
Stefan

On 2011-08-22 17:22:16 +0000, Dimitri van Heesch wrote:

Hi Stefan,

These problems seem related to the contents of your citations as seen by
doxygen (which contain commands like \rev), not the bibtex invocation
itself.

Can you attach a self-contained example with the \cite commands as you use
it (and the config file) together in a zip so I can reproduce the problem?

On 2011-08-23 12:18:10 +0000, goeck wrote:

Created attachment 194477
self contained example of not working cite feature

As asked, I constructed a minimalistic self contained example, where the
cite usage of the feature doesn't work:
* citelist.html is not created, the link within the documented function
points to that file
* if "url=" is removed from the bib file, no error is produced and the
"Related Pages"-"Bibiography" looks nice

On 2017-04-16 16:02:34 +0000, apps@rader.us wrote:

FWIW: Any use of \cite failed on Windows 10 using doxygen 1.8.13 until after
I also installed Strawberry Perl 5.24.1 and added it to %PATH%.

On 2017-06-04 16:15:30 +0000, albert wrote:

I tested it with version 1.7.5.1 and here I got 2 error message and observed
that the reference is not reachable (from function calcTest).
In the current version 1.8.13 it all works.

I think the problem has been solved in the mean time.

Regarding the remark from apps@rader.us the manual states (so perl is a
prerequisite):
CITE_BIB_FILES The CITE_BIB_FILES tag can be used to specify one or more bib
files containing the reference definitions. This must be a list of .bib
files. The .bib extension is automatically appended if omitted.
This requires the bibtex tool to be installed. See also
http://en.wikipedia.org/wiki/BibTeX for more info. For LATEX the style of
the bibliography can be controlled using LATEX_BIB_STYLE.
To use this feature you need bibtex and perl available in the search path.
See also \cite for info how to create references.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.