Re: [Doxygen-users] Can doxygen do this (including not only examples, but also their output )?

[Barnes, P. D. <bar...@ll...>]

Hello Stephan,

We[1] use a combination of doxygen (for API) and Sphinx[2] for more expository docs, such as tutorial and manual.  In particular, it's straightforward Sphinx to integrate portions of an example program along with the output.  Sphinx uses make to generate the documentation, so it's also straightforward to build and run the example code as part of building the documentation.

Peter

[1]  https://www.nsnam.org/docs/release/3.19/tutorial/html/index.html
https://www.nsnam.org/docs/release/3.19/manual/html/index.html

[2]  http://sphinx-doc.org

On May 19, 2014, at 7:17 AM, Stephan Petersen <ste...@gm...> wrote:
> I'm new to doxygen and I'm currently trying to figure out whether it's
> the right tool for the job.
> - short (but complete) example programs that illustrate the use of all
> the functions the library provides, currently in C and Fortran, but
> potentially later also in Pascal/Python/Java.
> 
> The latter is where I'm currently not 100% sure whether and how it can
> be done with doxygen, since what I would like to do looks like this:
> 
> http://gtt.mch.rwth-aachen.de/gtt-web/Software/ChemApp/CAL-DOC/cal62.html#l100
> 
> Stephan

_______________________________________________________________________
Dr. Peter D. Barnes, Jr.                Physics Division
Lawrence Livermore National Laboratory  Physical and Life Sciences
7000 East Avenue, L-50                  email:  pdb...@ll...
P. O. Box 808                           Voice:  (925) 422-3384
Livermore, California 94550             Fax:    (925) 423-3371