bug-coreutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Patch] Adding examples to the man pages


From: Paul Eggert
Subject: Re: [Patch] Adding examples to the man pages
Date: Thu, 17 Mar 2005 11:44:53 -0800
User-agent: Gnus/5.1006 (Gnus v5.10.6) Emacs/21.4 (gnu/linux)

"Dave Gilbert (Home)" <address@hidden> writes:

>> My kneejerk reaction is that I like the idea of adding examples, but
>> I'd rather see them added to the output of "--help"....
>> We should also add them to doc/coreutils.texi.
>
> Hmm - if you can suggest a good way to do this then I'd be happy to
> write the examples in any reasonable way as long as they end up in 'man'
> (as well as anywhere you want them).

The general way is to submit a patch, in "diff -u" format.  You'd
need to patch doc/coreutils.texi and each source file (e.g., src/cp.c).

> I'd like on some things to include the really useful GNU options;

I'd prefer fairly terse examples that focus on "really useful" uses
(my, I'm starting to sound like Thomas the Tank Engine).  It's OK for
examples to mention GNU extensions.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]