[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: duplicate documentation
From: |
Jan Stary |
Subject: |
Re: duplicate documentation |
Date: |
Sun, 15 Nov 2020 19:26:05 +0100 |
On Nov 15 18:26:16, schwarze@usta.de wrote:
> > Implementing the -h or --help option mostly becomes calling usage(),
>
> Not usually.
>
> The usage() output ideally corresponds to the synopsis:
>
> $ man -h groff
> groff [-abcegijklpstzCEGNRSUVXZ] [-d cs] [-D arg] [-f fam] [-F dir]
> [-I dir] [-K arg] [-L arg] [-m name] [-M dir] [-n num] [-o list]
> [-P arg] [-r cn] [-T dev] [-w name] [-W name] [file ...]
> groff -h
> groff --help
I don't mean groff specifically here, I mean generally:
calling --help, in the software I see in the wild,
most often means "call usage() and exit", and the actual
printf() in usage() tend to lack behind.
- Re: Release Candidate 1.23.0.rc1, (continued)
- Re: Release Candidate 1.23.0.rc1, Dave Kemper, 2020/11/13
- Re: Release Candidate 1.23.0.rc1, G. Branden Robinson, 2020/11/13
- duplicate documentation, was: Release Candidate, Ingo Schwarze, 2020/11/14
- Re: duplicate documentation, was: Release Candidate, G. Branden Robinson, 2020/11/15
- Re: duplicate documentation, was: Release Candidate, Ingo Schwarze, 2020/11/15
- Re: duplicate documentation, Jan Stary, 2020/11/15
- Re: duplicate documentation, Ingo Schwarze, 2020/11/15
- Re: duplicate documentation,
Jan Stary <=
Re: Release Candidate 1.23.0.rc1, Ingo Schwarze, 2020/11/13
Re: Release Candidate 1.23.0.rc1, Dave Kemper, 2020/11/14