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

Doxygen don't support longer key in bibtex (Origin: bugzilla #751300) #5808

doxygen opened this Issue Jul 2, 2018 · 0 comments


None yet
1 participant

doxygen commented Jul 2, 2018

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

Original attachment names and IDs:

On 2015-06-21 22:02:48 +0000, wrote:

See here for details about this bug:

Just summarized it here.

Doxygen will give a warning message "does not have an associated number" when keys in bibtex are longer than 19 characters. For example

bib file:

title = {The {DSSAT} cropping system model},
volume = {18},
journaltitle = {European Journal of Agronomy},
author = {A, F.},

title = {The {DSSAT} cropping system model},
volume = {18},
journaltitle = {European Journal of Agronomy},
author = {A, F.},

source codes:

namespace Test

/// A test class

/// This is test citation, see \cite mcmaster_phenology_ and
/// \cite mcmaster_phenology_1.
public class TestClass


On 2015-07-01 13:44:49 +0000, albert wrote:

Comment copied regarding investigations done:

I've did some tests and it looks indeed that doxygen.bst (called from causes the problem. bibtex is called here and the .aux file for the bibtex call is OK but the resulting .bbl file is wrong. Unfortunately I've not been able to spot the problem

On 2015-07-19 12:05:43 +0000, Dimitri van Heesch wrote:

Confirmed. Should be fixed in the next GIT update.

On 2015-11-01 00:52:05 +0000, Tim Janik wrote:

(In reply to Dimitri van Heesch from comment # 2)

Confirmed. Should be fixed in the next GIT update.

Is there a workaround for this Dimitri?

I'm also seeing the error for much shorter keys after switching to, e.g.:
/randomhash.hh:86: warning: \cite command to 'Fips202' does not have an associated number
/randomhash.hh:102: warning: \cite command to 'Keccak11' does not have an associated number

On 2015-12-30 10:19:13 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.11. 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 (preferably in the form of a self-contained example).

On 2016-07-15 07:53:06 +0000, Johannes Rieke wrote:

Deall all,

I've encountered still an issue in 1.8.11 on Windows 7 x64 with MikTex 2.9 x64 in a Fortran project. It is nearly the same as in the post from Tim Janik.

The Fortran code line is:
!!@cite Piegl1996

The bibtex entry looks like:
title = {The NURBS Book},
publisher = {Springer},
year = {1996},
author = {L. Piegl and W. Tiller},
file = {:Buecher\THE NURBS BOOK.pdf:PDF},
owner = {RiekeJ},
timestamp = {2016.07.14},

The warning from doxygen looks like:
warning: \cite command to 'Piegl1996' does not have an associated number

There is an *.bib file generated in the doxygen generated latex subfolder, but I have not seen an *.aux or *.bbl file. The generated *.bib looks normal.

I tried the same thing in Linux Mint 17.3 with texlive (TeX 3.1415926 (TeX Live 2013/Debian)) and doxygen 1.8.7. The same code works without any issues.

Any hints, how to solve this in Windows with 1.8.11?

On 2016-08-21 16:54:56 +0000, albert wrote:

Johannes Rieke made a comment about a problem, but didn't set the issue back to reopened.

On 2016-08-21 16:57:48 +0000, albert wrote:

I've tried to reproduce the problem with but was not able to. I didn't see any warning message.

Can you please attach a (small) self-contained example (source+config file in a tar or zip) that allows us to reproduce the problem?

On 2016-09-05 10:23:04 +0000, Johannes Rieke wrote:

Created attachment 334780
Minimum working example for issue with citing (1.8.11 Windows)

Dear all,

Thanks for the feedback and sorry for the delay from my side, I was in vacation.

This is a minimum working example to show up the issue, when citing within Fortran source code. Hopefully this works for you.

kind regards, Johannes

On 2016-09-11 15:52:32 +0000, albert wrote:

With the attached example I still cannot reproduce the problem, so my guess is that it is a system dependent problem, i.e. the perl is not installed on the system or perl has not been added, correctly, to the PATH
In the log file I see:
error: Problems running bibtex. Verify that the command 'perl --version' works from the command line. Exit code: 1

Furthermore I think doxygen is not run from a terminal window but from one or another GUI.

Some questions:

  • Can you run doxygen directly from a terminal window and what is the output
  • what is the output of the command: perl --version
  • what is the output of the command: where perl
  • what is the output of the command: echo %PATH%

On 2016-09-12 09:07:12 +0000, Johannes Rieke wrote:

Dear Albert,

mea culpa. It was a Problem on my system. The path variable was too long and the perl path was corrupted. I had to uninstall some not needed programs (older MPI versions) to correct this. Now citing works great! No error or issue with Doxygen. Very nice!
However, all the other stuff of Doxygen was running fine without Perl present. Is there a way to avoid the dependency to Perl in this certain case?

Best regard, Johannes

On 2016-09-12 16:39:01 +0000, albert wrote:

For the translation of the bibtex information perl is required.

@doxygen doxygen closed this Jul 2, 2018

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