bug#14976: [patch] use semicolons in option descriptions, not periods
From:
Benno Schulenberg
Subject:
bug#14976: [patch] use semicolons in option descriptions, not periods
Date:
Sat, 03 Aug 2013 12:33:01 +0200
Hello PƔdraig,
On Fri, Aug 2, 2013, at 10:11, PƔdraig Brady wrote:
> On 08/01/2013 08:56 PM, Benno Schulenberg wrote:
> > A semicolon is a sentence separator too; it just avoids the need for
> > a capital starter letter and a finishing period.
>
> Well generally there should be some tenuous relationship
> between the ; delimited "sentences"
True. But as the phrases all describe aspects of the same option,
there is in my opinion always some relationship between them,
which could be expressed with "where" or "however" or something.
Attached patch does some more semicolon substitutions, of periods
I overlooked the first time. It also does more indentation adjustments,
and adds some parentheses around equivalent short options for clarity.
It also removes the phrase "and do not dereference symbolic links" from
the 'ls -d' option, because 1) to be correct it would have to add "unless
-H or -L etcera", but such precision is something for the manual; 2) the
phrase is not given for -F nor -l either, for which it is also valid.
Regards,
Benno
--
http://www.fastmail.fm - The way an email service should be