[cmake-developers] [PATCH] split the cmake man page into four man pages

[Brad King]

Brad King wrote:
> Alexander Neundorf wrote:
>> To make things easier I split the patch in two parts.
>> Attached is the first part, it only refactors cmDocumentation a bit.
> 
> I tried it out and the generated pages look okay.  I've applied the
> patch with a few line length and code style fixes:
> 
> /cvsroot/CMake/CMake/Source/cmDocumentation.cxx,v  <--  cmDocumentation.cxx
> new revision: 1.40; previous revision: 1.39
> /cvsroot/CMake/CMake/Source/cmDocumentation.h,v  <--  cmDocumentation.h
> new revision: 1.18; previous revision: 1.17

This patch has broken the command-line per-command help syntax:

$ cmake --help-command install
cmake version 2.5-20070201
  INSTALL                     = Specify rules to run at install time.

The correct behavior is:

$ cmake --help-command install
cmake version 2.5-20070201
  INSTALL
       Specify rules to run at install time.

       This command generates installation rules for a project.  Rules
       specified by calls to this command within a source directory are
       executed in order during installation.
       ....rest of documentation for command....

Alex, please fix this ASAP.

Thanks,
-Brad