At 2018-06-28T11:31:30+0200, Michel Dänzer wrote: > > Please send this kind of change directly upstream to the > amd-gfx@lists.freedesktop.org list for review, split up into one patch > per logical change. Well, a lot of these changes aren't "logical", they're stylistic. > On 2018-06-27 09:07 PM, Bjarni Ingi Gislason wrote: > > > > Don't begin a sentence with a digit. > > Why not? What's the problem with that? It's considered substandard English style. See, e.g., [1] https://www.editage.com/insights/scientific-writing-avoid-starting-sentences-with-a-number-or-abbreviation The Chicago Manual of Style, which is the preferred style guide of Michael Kerrisk of the Linux Man-Pages Project, is paywalled[2], but my copy of the 14th edition says: §8.9 "At the beginning of a sentence any number that would ordinarily be set in numerals is spelled out, regardless of any inconsistency this may create [...]". Other style guides broadly agree, though they might not be quite as militant about it as Chicago is. > > Add a comma after "e.g.". > > That looks odd to me. It's standard to have the comma. Chicago, 14th ed. again: §5.62 "A comma is usually used after such expressions as _that is_, _namely_, _i.e._, and _e.g._ The punctuation preceding such expressions should be determined by the magnitude of the break in continuity. If the break is minor, a comma should be used. If the break is greater than that signaled by a comma, a semicolon or an em dash may be used, or the expression and the element it introduces may be enclosed in parentheses". [italics replaced by underscore delimeters] I've run into Bjarni in the groff and man-pages projects. He's a detail-oriented style maven after my own heart and I can vouch that his proposed corrections are usually sound ones. [1] ;-) [2] >:( http://www.chicagomanualofstyle.org/16/ch06/ch06_toc.html redirects me to a login screen. -- Regards, Branden
Attachment:
signature.asc
Description: PGP signature