Re: Explaining +/-n

[Bernhard Voelker]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 11/23/2016 04:22 AM, Eric Blake wrote:
> On 11/22/2016 06:57 PM, Dale R. Worley wrote:
>> I started working out the manual changes to address 
>> http://savannah.gnu.org/bugs/?49640
>> 
>> Because my setup is old, I figured I'd start trying out the new wording 
>> using commit 1a009ccb from 2015-12-20.
>> But the structure of that commit is peculiar:  the find.1 manual page is 
>> installed from findutils/find/find.1,
>> but that file is *not* generated from findutils/doc/find.texi like you'd 
>> expect, it's a source file in the Git 
>> archive.  (Though that may be different from the structure of the latest 
>> commit.)
>> 
>> Could someone fill me in on what is going on here?  I'm reluctant to believe 
>> that find.1 and find.texi are
>> maintained separately, but that's what it looks like.
> 
> Yes, findutils is one of the few pages that actually maintains a separate man 
> page at the moment.

Yes, it's all quite redundant currently.
IMO the docs should be consolidated like for other GNU projects, e.g.
I like the way coreutils presents the documentation:

- - generatig the man page from --help via help2man,

- - having a detailed documentation as texinfo manuals (from
  which nice HTML and/or PDF files to place on www.gnu.org

- - leaving terse usage() output for --help, pointing to the
  texinfo manual or the web page for more details, e.g.:

  $ df --help | tail -n3
  GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  Full documentation at: <http://www.gnu.org/software/coreutils/df>
  or available locally via: info '(coreutils) df invocation'

WDYT?

Have a nice day,
Berny

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBAgAGBQJYPgGWAAoJEEZQLveWkXGVrhMIAJ00IZjIGmMauT/LubcB2UM0
w6Nn1UsjtBiK6ozx+HkYJRJZ1IqhqHbjn33bbehldt8ci1Cm1wIDy1oHyffdz9u7
LRyshtuG99lWhNf1zylGFbIi2Cl/J2PhpYGTZ85XKQTGwpqmZAu29HWq9gf4xfjC
zFojFbLIaDy729/5U6SRXa09EvP/bCp/FoCtxuSkVEhQrD52NmrWCMIdjgAtiz2a
G5HsNN0fnPbCr0zQWYpfpAG5Nibhf3yDnlbFWXDJ9W4kAt5GmCYHlDsm2Ke81r4U
2KstLGYrMuDpE2x6VU5Xj5ZN70ZxPvGKVkd+2EKfEbEmhdU++StrgW5Vqp/ePVQ=
=lE7w
-----END PGP SIGNATURE-----