After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 317328 - Difficult to add citations and cross references.
Difficult to add citations and cross references.
Status: RESOLVED DUPLICATE of bug 503239
Product: doxygen
Classification: Other
Component: general
Other All
: Normal enhancement
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Reported: 2005-09-27 10:26 UTC by Edward Grace
Modified: 2011-07-28 18:47 UTC
See Also:
GNOME target: ---
GNOME version: ---

Description Edward Grace 2005-09-27 10:26:10 UTC
I would like to be able to add a bibliography to the documentation.  

Much of my work involves scientific codes which often reference papers written
by many authors.  It would be really great to be able to have a \cite tag in the
manner of LaTeX which could be used in conjunction with a BibTeX database to add
a line to the documentation such as "See: A. N. Other et. al. Proc. R. Soc.
Blah. pp223"

Currently I am doing this by hand, using a preprocessing stage which is of
course error prone.

Perhaps this could be done by subverting doxytag?
Comment 1 Richard J. Mathar 2006-02-10 13:28:00 UTC
My graceful approach to this is embedding the standard
LaTeX cite with the doxygen brackets
in the source code, then calling doxygen in a script like this one:

# using xr later on
echo "EXTRA_PACKAGES = xr" >> Doxyfile
doxygen Doxyfile

# wherever the OUTPUT was put according to Doxyfile
cd .../doc/latex

# edit the refman.tex...
sed 's+tableofcontents+tableofcontents \\bibliographystyle{alpha} \\bibliography{eso,all}+' refman.tex > tmp1.tex
# supposed we're using xr.sty, further editing
sed 's+makeindex+makeindex \\externaldocument[1-]{VLT-TRE-AOS-15753-0001} \\externaldocument[10-]{UL-TRE-AOS-15753-0010}+' tmp1.tex > refman.tex 

# pre-run bibtex
pdflatex refman
bibtex -terse refman
rm refman.pdf
make refman.pdf
Comment 2 Dimitri van Heesch 2011-07-28 18:47:43 UTC

*** This bug has been marked as a duplicate of bug 503239 ***