[PATCH] Re: [cmake-developers] splitting the man page ?

[Alexander Neundorf]

On Thursday 31 August 2006 19:23, you wrote:
> Alexander Neundorf wrote:
> > Ok, I added a virtual bool IsDiscouraged() to cmCommand (as a non-native
> > speaker the difference between obsolete and deprecated isn't quite clear
> > to me). So these commands are now only "discouraged". This term is used
> > through the whole patch, the new man pages are also called
> > "cmake-modules" and "cmake-discouraged". Maybe "cmake-compat" or
> > "cmake-deprecated" would be better.
>
> I like the name IsDiscouraged in the source, but I don't think it is the
> best name for the man page.  I don't think having the string
> "cmake-discouraged" floating around the web is a good idea :)
>
> Please change the name of the generated files to cmake-compat.
>
> > The patch is not perfect, it probably needs some tuning, e.g. for the
> > see-also section or the description at the top of each man page.
>
> I've applied the part of the patch that adds IsDiscouraged to the
> cmCommand interface and all the discouraged commands.  

Any reason why you left cmRemoveCommand out ?

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