Re: [Patch] Adding examples to the man pages

[James Youngman]

On Mon, Mar 14, 2005 at 03:12:16AM -0500, Alfred M. Szmidt wrote:
> I think it would be better to add this where it belongs, in the info
> pages.  That is the proper place to document this.  The format for man
> pages is very bad to provide proper documentation to users in either
> case.

You're right; if Texinfo is the GNU projet's preferred documentation
format, then the GNU developers themselves should be directing their
energies towards improving the Info documentation.

However, if someone offers a patch which improves the manual pages, it
seems logical to welcome such improvements, especially since GNU
developers less likely to work on them.  Very few of the coreutils
manpages have examples.  This is unfortunate, since coreutils contains
tools which are heavily used by beginners as well as expert users.  I,
for one, welcome improvements to the manpages.

Regards,
James.