Hi Anders, we generate doxyfiles using cmake. This can produce html, htmlhelp and latex/pdf files for our products. Now we are testing out combining this with markdown files (requires doxygen 1.8) and using pandoc to be more flexible regarding output formats. Markdown is nice, but I can't say that it is better (or worse) than rst (reStructuredText), which seems to be the selection of some "big" players (like CMake).
Anyway, we need a system that can regenerate documentation every night and currently we do that using CMake, doxygen (with markdown support) and pandoc. cheers Mattias On Sat, Jun 6, 2015 at 7:50 AM, Anders Backman <ande...@cs.umu.se> wrote: > Hi all. > > A OT question regarding documentation. > > > What tool/pipeline do you use for building your documentation for your > software? > If you want to maintain documentation which contains pictures, references > and you want to be able to create indexed nice printable PDF:s, online/html > documentation etc. > Support for version control through svn is a bonus (so don't say Microsoft > Word!) > > > Grateful for your input! > > /Anders > > -- > __________________________________________ > Anders Backman, HPC2N > 90187 UmeƄ University, Sweden > and...@cs.umu.se http://www.hpc2n.umu.se > Cell: +46-70-392 64 67 > > _______________________________________________ > osg-users mailing list > osg-users@lists.openscenegraph.org > http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org > _______________________________________________ osg-users mailing list osg-users@lists.openscenegraph.org http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org