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

[Jim Meyering]

Pádraig Brady wrote:

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

Seconded.