[Doxygen-users] Suggestion

[Luigi B. <lui...@ri...>]

Hi all (and especially Dimitri),
	lately I have been writing a few general sections in my 
documentation---"general" meaning an overview of the problem addressed by 
the code as opposed to "non general" being the documentation of a single 
method/class---and I thought that it would be nice to have a command for 
references.

It could work like:
/*! \page etc.
     ...
     As pointed out in
     \cite (some_label?)
     Doe J., "Gnats and Gnus", Journal of This and That 12, 2001
     \endcite
     gnats can be nastier than gnus at times.
     ...
*/

This would cause the above block to appear in the documentation as

     As pointed out in [1], gnats can be nastier than gnus at times.

while a separate page (the list of references) would contain among others

     [1] Doe J., "Gnats and Gnus", Journal of This and That 12, 2001.

The [1] in the documentation would be a link to the appropriate entry in 
the list of references.

Would it be at least moderately easy to implement? Could it use BibTeX for 
LaTeX output? Does anyone like the idea? Suggestions? Rejections?

Bye,
	Luigi