Re: [Patch] Adding examples to the man pages

[James Youngman]

On Fri, Mar 18, 2005 at 05:36:27PM +0000, Dr. David Alan Gilbert wrote:
> No I realise that; the issue is how to include examples in the help text
> and let them be formatted appropriately for the man page (e.g.
> highlighting the fixed text and user supplied text).
> 
> To be honest,  this is just too much hassle; I'll go and add
> examples to some other packages where I just need to edit man pages.
> There is no point in me jumping backwards through 5 hoops to do
> something useful when all I really need to do is add them to the .x
> files.

David, 

Please persevere a little longer.  A brief search shows that 'netpbm'
is the only package which has a worse combination of (a) extensive
installed base and (b) large number of manual pages lacking examples.

I'm not trying to question anybody else's contribution, but I'm just
trying to point out to you that the contribution you were planning to
make would be useful to many end-users.

Regards,
James.