[cmake-developers] splitting the man page ?

[Alexander Neundorf]

On Thursday 24 August 2006 23:34, Alexander Neundorf wrote:
> Hi,
>
> the cmake man page has become quite big. How about splitting it ?
>
> One idea would be:
> cmake-compat: LINK_LIBRARIES, REMOVE, VTK_*, QT_*, INSTALL_*, EXEC_PROGRAM,
> BUILD_NAME
> cmake-modules: docs generated from the modules
> cmake: everything else
>
> If you think that's ok I'll try to produce a patch.

I had a look at the code, and found that there is already a 
cmCommand::IsDeprecated(int major, int minor); which currently for all 
commands returns false.
If I would now make it return true for the deprecated commands, I would be 
able to use this to generated the documentation of all/only the 
deprecated/only the not deprecated commands.
The problem here is that if I would do this, then cmake would report an error 
(in cmMakefile::ExecuteCommand() ) everytime a deprecated command is used, so 
many cmake scripts out there would break.

So what do you suggest ?
Add another function IsObsolete() to cmCommand and use this only for the 
docs ?
Make IsDeprecated return true for the appropriate commands but don't let 
cmMakefile::ExecuteCommand() generate an error for this case ? 

What do you suggest ?

Bye
Alex
-- 
Work: alexander.neundorf AT jenoptik.com - http://www.jenoptik-los.de
Home: neundorf AT kde.org                - http://www.kde.org
      alex AT neundorf.net               - http://www.neundorf.net