-----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-----
