Re: [Doxygen-users] Suggestion

[Roberto B. <ba...@cs...>]

Luigi Ballabio wrote:
> 
> 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?

I think that this is a great idea and a feature (BibTeX support included)
that I would love to have.
All the best,

    Roberto

-- 
Roberto Bagnara
Computer Science Group
Department of Mathematics, University of Parma, Italy
http://www.cs.unipr.it/~bagnara/
mailto:ba...@cs...