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 <stephan.peter...@gmail.com> 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: pdbar...@llnl.gov P. O. Box 808 Voice: (925) 422-3384 Livermore, California 94550 Fax: (925) 423-3371 ------------------------------------------------------------------------------ "Accelerate Dev Cycles with Automated Cross-Browser Testing - For FREE Instantly run your Selenium tests across 300+ browser/OS combos. Get unparalleled scalability from the best Selenium testing platform available Simple to use. Nothing to install. Get started now for free." http://p.sf.net/sfu/SauceLabs _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
