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...
|
