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

[Alexander Neundorf]

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.
> 
> > I find that one very useful (and use it also to add the documentation for
> > previous cmake releases in the cmake wiki ... still have to do this for
> > 2.8.12).
> 
> Huh?  Why/where are you doing this?

I was earlier (July 2007), and just continued to do it when you added 
documentation for older cmake versions to the main cmake page, for 
completeness. :-)
 
Alex