[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: (man|info) pages and --help
From: |
Micah Cowan |
Subject: |
Re: (man|info) pages and --help |
Date: |
Thu, 17 Sep 2009 11:59:50 -0700 |
User-agent: |
Thunderbird 2.0.0.23 (X11/20090817) |
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
C de-Avillez wrote:
> So. Would it be an acceptable idea to add, to the '--help', a warning
> that this is *not* the full documentation?
>
> Say, like:
>
> "This is an abridged documentation. The full documentation for blahblah
> is maintained as a Texinfo manual. If the info and date programs are
> properly installed at your site, the command
>
> info coreutils 'blahblah invocation'
>
> should give you access to the complete manual."
Is there anyone who's unaware that --help doesn't provide complete
documentation? I can't think of any program that provides complete
document via --help; the closest is software like Subversion, Git or
Mercurial, where they provide you access to extensive documentation via
"svn help <command>"-style inquiries. Indeed, the whole point behind
- --help is usually to generate very brief usage information. Though a
shorter, one-sentence message directing the user to the full Texinfo
documentation could be useful.
- --
Micah J. Cowan
Programmer, musician, typesetting enthusiast, gamer.
Maintainer of GNU Wget and GNU Teseq
http://micah.cowan.name/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iEYEARECAAYFAkqyhyYACgkQ7M8hyUobTrEoSwCdHodPi2KGyRoodcQIPaK62wGw
cHEAnj7sNx0iGvaIo+nLU2kgP8SDIX9W
=ssgG
-----END PGP SIGNATURE-----
- (man|info) pages and --help, C de-Avillez, 2009/09/17
- Re: (man|info) pages and --help,
Micah Cowan <=
- Re: (man|info) pages and --help, C de-Avillez, 2009/09/18
- Re: (man|info) pages and --help, Alfred M. Szmidt, 2009/09/18
- Re: (man|info) pages and --help, Pádraig Brady, 2009/09/18
- Re: (man|info) pages and --help, Jim Meyering, 2009/09/18
- Re: (man|info) pages and --help, C de-Avillez, 2009/09/18
- Re: (man|info) pages and --help, Pádraig Brady, 2009/09/18
- Re: (man|info) pages and --help, C de-Avillez, 2009/09/18
- Re: (man|info) pages and --help, Pádraig Brady, 2009/09/18