Re: (man|info) pages and --help

[Pádraig Brady]

Alfred M. Szmidt wrote:
>    > Is there anyone who's unaware that --help doesn't provide
>    > complete documentation?
> 
>    I would not expect anyone to *not* know that help output is
>    abridged.  But I would rather have them go straight into 'info'
>    than wasting time on 'man', only to be redirected to 'info'.
> 
>    Usually one looks at the '--help' output first. If we redirect on
>    'man', why not there?
> 
> Because man pages are secondary on GNU systems, the offical spot has
> always been info.  The redirection is only for convience for old
> timers who still use man.

While that may be the official line, practically nobody reads info pages,
and if they do it's indirectly through google.

I'd vote for removing the translation help line unconditionally
(I notice it's not mentioned in man pages) and replace with:

For complete documentation, run: info coreutils '$cmd invocation'

cheers,
Pádraig.