Re: Prefered manpage idioms?

On Thu, May 30, 2019 at 09:09:58PM +0200, Marc Espie wrote:
> On Thu, May 30, 2019 at 07:29:55PM +0100, Jason McIntyre wrote:
> > i think any of man page, manual page, or manual is fine.
> >
> > > 2. Standard output
> > >
> > > Is it:
> > > Print to standard output/error
> > > tee(1)
> > > Print to the standard output/error
> > > cat(1), echo(1)
> > > Print to stdout/stderr
> > > bzcat(1)
> > >
> >
> > these are all fine, i think.
>
> IMO, these are highly contextual.
>

agreed.

> "End user commands" will tend to say standard output or error.
>
> stdout and stderr *are* programmer's idioms, so I would be surprised
> to see them in less technical commands.
>

i'm pretty sure you'll find stdout/stderr scattered all over userland
docs. the post itself quoted bzcat.

i don;t think we can (or should) attempt to police this.

jmc