On Thu, Jul 08, 2021 at 07:40:16PM +0900, Akira Yokosawa wrote: > Hi Paul, > > Here are colon related tweaks though Chapter 9. > > Patches 1/6 -- 3/6 don't change sentences/clauses/phrases except > for capitalization. > Patches 4/6 -- 6/6 remove redundant looking Oxford commas in > two-item enumeration lists. > However, I'm not sure Patches 4/6 -- 6/6 are the right fixes or not. > > Please pick whichever ones you'd like. After some thought and web searching, I took them all. The missing comma in the numbered list looks a bit strange to me, but the style manuals don't differentiate between numbered and non-numbered lists, so I am willing to have things look strange to avoid yet another perfbook-specific composition rule. ;-) > NOTE: There is a hunk in Patch 3/6: > > > @@ -535,9 +537,10 @@ and with increasing use of hazard pointers in other projects, demonstrates > > that tolerance for such inconsistencies is more common than one might > > imagine. > > This is especially the case given that single-item lookups are much more > > -common than traversals: After all, (1)~concurrent updates are less likely > > -to affect a single-item lookup than they are a full traversal, and > > -(2)~an isolated single-item lookup cannot detect such inconsistencies. > > +common than traversals: > > +After all, (1)~concurrent updates are less likely to affect a single-item > > +lookup than they are a full traversal, and (2)~an isolated single-item > > +lookup cannot detect such inconsistencies. > > > > From a more theoretical viewpoint, there are even some special cases where > > RCU readers can be considered to be fully ordered with updaters, despite > > , where the inline enumerated list is not converted to the "enumerate*" list. > This one is lead by "After all," not by a colon, and I kept the lowercase > words following (1) and (2). > > This level of fluctuation is unavoidable in natural language text, > I suppose. I wordsmithed this passage to get rid of the list entirely. I believe that it now reads better, in addition to avoiding another perfbook-specific special case. Thanx, Paul > Thanks, Akira > > -- > Akira Yokosawa (6): > toolsoftrade, count, SMPdesign: Break and capitalize after colon > locking: Break and capitalize after colon > defer: Break and capitalize after colon > count: Remove Oxford comma in two-item enumeration list > locking: Remove Oxford comma in two-item list > defer: Remove Oxford comma in two-item list > > SMPdesign/SMPdesign.tex | 23 ++++---- > SMPdesign/beyond.tex | 19 +++---- > count/count.tex | 66 ++++++++++++----------- > defer/hazptr.tex | 9 ++-- > defer/rcufundamental.tex | 29 ++++++----- > defer/rcuintro.tex | 6 ++- > defer/rcuusage.tex | 34 +++++++----- > defer/seqlock.tex | 12 +++-- > defer/whichtochoose.tex | 19 ++++--- > locking/locking-existence.tex | 4 +- > locking/locking.tex | 98 ++++++++++++++++++++--------------- > toolsoftrade/toolsoftrade.tex | 31 ++++++----- > 12 files changed, 201 insertions(+), 149 deletions(-) > > -- > 2.17.1 >
