On Nov 15 18:26:16, schwa...@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]
>
Hi Jan,
Jan Stary wrote on Sun, Nov 15, 2020 at 04:55:08PM +0100:
> On Nov 15 16:23:38, schwa...@usta.de wrote:
>> Some people argue for a third level of conciseness vs.
>> completeness, e.g. the --help option. I consider that detrimental
>> because it adds a larger amount of text th
On Nov 15 16:23:38, schwa...@usta.de wrote:
> Some people argue for a third level of conciseness vs.
> completeness, e.g. the --help option. I consider that detrimental
> because it adds a larger amount of text than the SYNOPSIS for
> a lesser gain (because you already have both ve
Hi Branden,
G. Branden Robinson wrote on Sun, Nov 15, 2020 at 11:49:48PM +1100:
> At 2020-11-14T17:03:42+0100, Ingo Schwarze wrote:
>> I would strongly oppose copying the same text to multiple
>> documentation files. Apart from correctness and completeness,
>> conciseness is among the most impor
As so often happens, Ingo and I are at loggerheads.
At 2020-11-14T17:03:42+0100, Ingo Schwarze wrote:
> I would strongly oppose copying the same text to multiple
> documentation files. Apart from correctness and completeness,
> conciseness is among the most important quality criteria for
> docume
