[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: please attempt to minimize string changes
From: |
Benno Schulenberg |
Subject: |
Re: please attempt to minimize string changes |
Date: |
Sun, 22 Dec 2013 10:18:22 +0100 |
On Sun, Dec 22, 2013, at 5:55, Andrey Borzenkov wrote:
> Will below patch help? It also removes trailing dot on the first
> paragraph which was not present before.
Thanks, the patch looks good. Except that the trailing dot needs
to be there: it is a doc string and should end in a period. The
addition of the dot was an improvement. :)
The general rule is: when the string starts with a capitalized word,
it wants to be a full sentence and should end in a period. When the
message starts with a lowercase letter, don't use a period anywhere
in the message; when you need a second sentence, use a semicolon.
> I usually use [TERMINAL ...] (with extra spaces). I find it established
> enough practice at least in UNIX manuals.
Indeed. Although in most of the man pages I've looked at just now
(df, ls, grep, sed, swapon, gawk), only gawk uses a space before the
dots. But whatever you choose, please make it consistent across
grub -- I've seen at least one instance without a space before the
dots in grub's messages.
Regards,
Benno
--
http://www.fastmail.fm - mmm... Fastmail...
Re: please attempt to minimize string changes, Benno Schulenberg, 2013/12/22