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

Alexander Neundorf neundorf at kde.org
Sun Oct 13 06:04:49 EDT 2013


On Friday 11 October 2013, Brad King wrote:
> On 10/11/2013 11:34 AM, Alexander Neundorf wrote:
> > On Thursday 10 October 2013, Brad King wrote:
> >> The topic breaks some of the existing --help-* commands like
> >> --help-full,
> > 
> > Do you mean there won't be an all-in-one page anymore ?
> 
> There can be with a little more work beyond the current topic:
> 
> * The cmRST processor is capable of starting with Help/index.rst
>   and printing out all manuals at once.  This will be useful only
>   for human consumption because the output format is only meant
>   to be human-readable text and does not conform to any markup.
> 
> * Sphinx supports a "singlehtml" builder that can generate all
>   the manual pages in one giant html file.

That sounds good :-)

Alex



More information about the cmake-developers mailing list