[osg-users] OT: documentation tool

[Mattias Helsing]

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 <andersb at 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
> anders at cs.umu.se http://www.hpc2n.umu.se
> Cell: +46-70-392 64 67
>
> _______________________________________________
> osg-users mailing list
> osg-users at lists.openscenegraph.org
> http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
>