Re: Man-pages

[Dennis Leeuw]

Hi Nicola,

Nicola Pero wrote:
> Hi Dennis,
>
> this is really good stuff :-)

Thanks :)

> nice manpages - before I commit, just thought I'd mention that gnustep-make already 
> has got a couple of manpages (GNUstep.7 and openapp.1), they are in 
> core/make/Documentation ... did you see them ?  You may want to merge your openapp
> manpage with the existing one ?

hmm... didn't look in the Documentation directory... read them quickly 
and they already look good. Will merge both openapp versions.

> We probably want to always install these tool manpages with gnustep-make (at the moment 
> they are installed only when gnustep-make's documentation is installed).  I suppose they
> could go into a new directory core/make/manpages, and we always install them 
> when
> gnustep-make is installed ?  I can do that if people like the idea (I like it). 
> ;-)

YES! That would be perfect!

> Thanks
>
> PS: debugapp is now completely equivalent to 'openapp --debug'; it may be worth
> documenting openapp very extensively and have debugapp just be a very short 
> page referencing openapp.  We haven't "deprecated" debugapp but it seems
> more logical for new users to just get used to using openapp all the time. ;-)

Right that is what I mention in the debugapp man-page in the NAME 
section, but I should probably also mention it in the DESCRIPTION 
section... maybe it would even be better to make both the Tools and the 
man-pages a symbolic link. Then openapp can act as openapp when it is 
called as debugapp. If you check on $0 in openapp you know if it is 
called as debugapp or openapp.

Just a thought,

Dennis

> -----Original Message-----
> From: Dennis Leeuw <dleeuw@made-it.com>
> Sent: Friday, December 7, 2007 12:33pm
> To: GNUstep Discuss <discuss-gnustep@gnu.org>
> Subject: Man-pages
>
> Hi all,
>
> I created a set of preliminary man-pages for the GNUstep tools. Comments 
> suggestions and additions highly appreciated.
>
> One little thing I noticed is that the set_show_service command does the 
> enable and disable, but is doesn't do the show. Is this a bug or 
> intentional?
>
> Happy Stepping,
>
> Dennis
> _______________________________________________
> Discuss-gnustep mailing list
> Discuss-gnustep@gnu.org
> http://lists.gnu.org/mailman/listinfo/discuss-gnustep