I'm using a 10-day old version compiled from git (8cd4425a523965a5541d46a84828fb7e16f98bae).


My lab maintain several large BibTeX files in which each entry key has the form

   name.year.conference

For instance

@InProceedings{	  vardi.86.lics,
  author	= {Moshe Y. Vardi},
  title		= {An Automata-Theoretic Approach to Automatic Program
		  Verification},
  booktitle	= {Proceedings of the 1st IEEE Symposium on Logic in Computer
		  Science (LICS'86)},
  pages		= {332--344},
  year		= {1986},
  publisher	= {IEEE Computer Society Press}
}

Unfortunately, when I use 

/// \brief First test
///
/// bar
/// \cite{vardi.86.lics}
/// baz
int test1(int f);

and run the Doxygen with default options (expect for the obvious CITE_BIB_FILES = myfile)

I get

[...]
/home/adl/doxygen-bug/test.hh:5: warning: Invalid or missing cite label
[...]
/home/adl/doxygen-bug/test.hh:5: warning: unable to resolve reference to `vardi' for \cite command
[...]

and the generated HTML documentation for test1()


<div class="memdoc">
<p>First test. </p>
<p>bar <b>[vardi]</b>.86.lics} baz </p>
</div>

So apparently Doxygen considers only the first component of the citation key, but this contradicts its documentation that states that "The <label> must be a valid BibTeX label".

I can't point to a definition of what characters are allowed as keys in a BibTeX entry.  I've seen : and - used as separators as well.


Unfortunately, renaming these BibTeX entries to match what Doxygen expect is not a satisfying option for me, because the BibTeX files are used in too many places.  Being able to refer to these from Doxygen would have been a bonus.

I nonetheless tried to play with this little example, and had other surprises:

@InProceedings{	  vardi,
  author	= {Moshe Y. Vardi},
  title		= {An Automata-Theoretic Approach to Automatic Program
		  Verification},
  booktitle	= {Proceedings of the 1st IEEE Symposium on Logic in Computer
		  Science (LICS'86)},
  pages		= {332--344},
  year		= {1986},
  publisher	= {IEEE Computer Society Press}
}

/// \brief First test
///
/// bar
/// \cite{vardi}
/// baz
int test1(int f);

Gives the very same diagnostics (!) and produces:

<div class="memdoc">
<p>First test. </p>
<p>bar <b>[vardi]</b>} baz </p>
</div>First test q barq vardi baz.



hinting that probably the use of braces is unwelcome (I believe people using BibTeX are used to call \cite with braces, so it would be very nice to support it).


My next try without braces was more successful, but not entirely.

/// \brief First test
///
/// bar
/// \cite vardi
/// baz.


int test1(int f);

This replaced all the warnings by

citelist:3: warning: expected <dt> tag but found <dl> instead!
citelist:4: warning: unexpected end of comment while looking for a html description title

and successfully output a link to the bibliography in the description of test1().  Unfortunately the bibliography page is empty :-(


I have found no file named citelist, so I find these warnings very unhelpful.