(man|info) pages and --help

[C de-Avillez]

c.f.: https://bugs.launchpad.net/bugs/430953

I have been thinking about this, and discussed it a bit on our (Ubuntu)
bugs IRC channel (#ubuntu-bugs).

I understand the move to 'info', and the decision to make the man pages
a summary, taken off the '--help'. But, to old UNIX users -- those that
were taught 'read the man page' -- and mostly to users that use other
systems, like AIX, HP/UX, Solaris, etc, the idea of looking at 'info'
will not occur.

Hell, I myself every so often forget about it.

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

Thank you.

..Carl..

signature.asc
Description: This is a digitally signed message part