[cmake-developers] Converting CMake documentation to reStructuredText and Sphinx

Daniel Pfeifer daniel at pfeifer-mail.de
Fri Oct 11 01:09:59 EDT 2013


2013/10/10 Brad King <brad.king at kitware.com>:
> Hi Folks,
>
> ...  After considering markup languages
> such as Markdown and AsciiDoc I settled on reStructuredText:
>
>  http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html
>
> It has a great extension mechanism and is supported by fantastic
> tools like Sphinx to handle suites of multiple document files with
> cross-referencing links among them:
>
>  http://sphinx-doc.org/

Currently, CMake can generate its own documentation in various formats
without imposing any additional tools.
Will that still be the case?

Will it still be able to generate DocBook, so companies can include
the documentation in their handbook?

cheers, Daniel



More information about the cmake-developers mailing list