groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [BUG] groff: inconsistent behavior of " to separate arguments


From: G. Branden Robinson
Subject: Re: [BUG] groff: inconsistent behavior of " to separate arguments
Date: Mon, 21 Mar 2022 03:32:33 +1100
User-agent: NeoMutt/20180716

At 2022-03-20T12:59:38+0100, Ingo Schwarze wrote:
> But since modern manual pages are mostly written and maintained
> by people used to younger languages, i still think the following
> advice is useful to avoid confusion of modern manual page maintainers:
> If you quote a macro argument, always provide the closing quote,
> even at the end of the input line where the roff language regards
> it as optional.

I agree.

There is also the point that man(7) and mdoc(7) both offer macros that
accept many arguments.  If the last argument is quoted, ending it with a
double quote, superfluously to irritable old graybeards, preserves its
robustness in revision when someone tacks on "just one more argument".

Kernighan made a similar point about semicolons in Pascal.  (If I
remember correctly, ANSI didn't get this memo when they introduced
array-of-struct initializers to C, nor did they correct this defect in
initializers for arrays of primitives.)

Regards,
Branden

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]