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

[C de-Avillez]

On Thu, 2009-09-17 at 11:59 -0700, Micah Cowan wrote:
> -----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 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?

Cheers

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