Re: [PATCH] defer: Fix grammar issues across Chapter 9 text

"Kunwu Chan" <[email protected]> Sat, 28 Feb 2026 02:12:47 +0000
Newsgroups org.kernel.vger.perfbook
Message-ID <[email protected]>
February 28, 2026 at 3:13 AM, "Paul E. McKenney" <[email protected] mail=
to:[email protected]?to=3D%22Paul%20E.%20McKenney%22%20%3Cpaulmck%40kern=
el.org%3E > wrote:


>=20
>=20On Fri, Feb 27, 2026 at 12:48:45PM +0900, Akira Yokosawa wrote:
>=20
>=20>=20
>=20> Hi,
> >=20=20
>=20>  Let me chime in.
> >=20
>=20Thank you both for digging into this!
>=20
>=20I am with Akira on these. Responding to each inline...
>=20
Thanks=20for the clear explanation =E2=80=94 very helpful, appreciate it.

> >=20
>=20> On Fri, 27 Feb 2026 02:34:43 +0000, Kunwu Chan wrote:
> >  [...]
> >=20=20
>=20>  Hi Paul,
> >=20=20
>=20>  Sounds good. I went through the current PDF and gathered the occur=
rences=20
>=20>  of "hinted at/on" that I could find. Here is the list for review:
> >=20=20
>=20>  Using PDF file: perfbook.2025.12.18a.pdf.
> >=20=20
>=20>  1) PDF location:
> >  p.98 (PDF page 110/686), Chapter 6 (Beyond Partitioning)
> >  Source location: SMPdesign/beyond.tex (line 14)
> >=20=20
>=20>  =E2=80=9CThis chapter has discussed how data partitioning can be u=
sed to
> >  design simple linearly scalable parallel programs.
> >  \Cref{sec:SMPdesign:Data Ownership} hinted at the possibilities of
> >  data replication, which will be used to great effect in
> >  \cref{sec:defer:Read-Copy Update (RCU)}.=E2=80=9D
> >=20
>=20Here we are referencing a section, so we say "in Section ...".
>=20
Thanks.
>=20>=20
>=20> 2) PDF location:
> >  p.142 (PDF page 154/686), Chapter 9.4 (Sequence Locks)
> >  Source location: defer/seqlock.tex (lines 411=E2=80=93416)
> >=20=20
>=20>  =E2=80=9CAs hinted on
> >  \cpageref{sec:defer:Mysteries sequence locking},
> >  both the read-side and write-side critical sections of a sequence
> >  lock can be thought of as transactions, and sequence locking
> >  therefore can be thought of as a limited form of transactional
> >  memory, which will be discussed in
> >  \cref{sec:future:Transactional Memory}.=E2=80=9D
> >=20
>=20And here as well.
>=20
>=20>=20
>=20> 3) PDF location:
> >  p.155 (PDF page 167/686), Chapter 9.5 (RCU)
> >  Source location: defer/rcufundamental.tex (lines 559=E2=80=93563)
> >=20=20
>=20>  =E2=80=9CIn such cases, RCU readers can be considered to be fully =
ordered with
> >  updaters, despite the fact that these readers might be executing the
> >  exact same sequence of machine instructions that would be executed b=
y
> >  a single-threaded program, as hinted on
> >  \cpageref{sec:defer:Mysteries RCU}.=E2=80=9D
> >=20
>=20But the English language being what it is, we say "on page ...".
> The rational is that when you read a physical dead-tree book, the page =
is
> laid out flat, with the ink you are reading being physically on the pag=
e.
> As opposed to inside of it or something.
>=20
Thanks=20=E2=80=94 the "ink physically on the page" image really helped.=
=20
Much=20easier to grasp. :-)

> >=20
>=20> 4) PDF location:
> >  p.184 (PDF page 196/686), Chapter 9.5.4.12 area
> >  Source location: defer/rcuusage.tex (lines 2052=E2=80=932054)
> >=20=20
>=20>  =E2=80=9CAnd so it is that RCU's use cases are conceptually more c=
omplex than
> >  is RCU itself, as hinted on
> >  \cpageref{sec:defer:Mysteries RCU Use Cases}.=E2=80=9D
> >=20
>=20Again "on page ...".
>=20
>=20>=20
>=20> 5) PDF location:
> >  p.533 (PDF page 545/686), Quick Quiz answers area
> >  Source location: defer/rcuintro.tex (lines 141=E2=80=93145)
> >=20=20
>=20>  =E2=80=9CAs hinted at in
> >  \cref{sec:cpu:Hardware Optimizations,sec:cpu:Hardware Free Lunch?},
> >  speed-of-light delays mean that a computer's data is always stale
> >  compared to whatever external reality that data is intended to model=
.=E2=80=9D
> >=20
>=20And again "in Section ...".
>=20
>=20One way of thinking of this is that sections are usually multiple pag=
es.
> If you held in your hand the pages making up a section, the writing
> would be in (not on) the stack of pages.
>=20
Thanks=20=E2=80=94 that =E2=80=9Cstack of pages=E2=80=9D picture makes it=
 very clear.

> >=20
>=20> Please let me know which ones you=E2=80=99d prefer to keep as-is an=
d=20
>=20>  which should be adjusted, and I=E2=80=99ll prepare a patch accordi=
ngly.
> >=20=20
>=20>  Not a native speaker of English, but I don't see any need of chang=
ing them.
> >=20=20
>=20> From 1)
> >=20=20
>=20>  Section XXX hinted at the possibilities of data replication, ...
> >=20=20
>=20> From 2), 3), and 4)
> >=20=20
>=20>  As/as hinted on page YYY ...
> >=20=20
>=20> From 5)
> >=20=20
>=20>  As hinted at in Section ZZZ, ...
> >=20=20
>=20>  All of them sound pretty natural to me.
> >=20=20
>=20>  You might be missing the implication of "page XXX", which can mean
> >  physical page in a book. Saying "on page XXX" is quite natural.
> >  OTOH, when you see "Section XXX hinted at <some ideas>", you should
> >  consider "hint at" works as a synonym of "indicate" as a verb.
> >=20
>=20I suspect that both Chinese and Japanese make different choices, but =
I
> don't know enough about either to say. Google Translate seems to treat
> pages and sections the same for Chinese ("=E5=9C=A8=E7=AC=AC3=E9=A1=B5"=
 and "=E5=9C=A8=E7=AC=AC2=E9=83=A8=E5=88=86"
> but Arabic numerals?) and for Japanese ("3=E3=83=9A=E3=83=BC=E3=82=B8=
=E3=81=AB=E3=81=82=E3=82=8A=E3=81=BE=E3=81=99" and
> "=E3=82=BB=E3=82=AF=E3=82=B7=E3=83=A7=E3=83=B32=E3=81=AB=E3=81=82=E3=82=
=8A=E3=81=BE=E3=81=99" and also Arabic numerals?). On the
> other hand, I trust Google Translate only up to a point. So you guys
> tell me! ;-)
>=20
>=20For whatever it is worth, French is similar to English, with "=C3=A0 =
la"
> for pages and "dans la" for sections, where "la" is the feminine form o=
f
> the English word "the". The in/on/with words are big bags of meanings,
> so French "=C3=A0" can be English "on", but the meanings do not coincid=
e
> precisely, for example, "=C3=A0" sometimes translates instead to Englis=
h
> "from". However, French "dans" almost always translates to English "in"=
.
>=20
>=20I took four years of French in high school, mais cela signifie en
> am=C3=A9ricain =C2=ABJe ne parle pas fran=C3=A7ais=C2=BB ("but that is =
American for
> 'I don't speak French'"). ;-)
>=20
>=20And you know the old joke: English is what you get when Germans attem=
pt
> to speak French.
>=20
Thanks=20for the explanation =E2=80=94 very helpful.
The language notes (and the joke!) were fun too.=20
Learned=20something new there. ;-)

Thanx, Kunwu

>  Thanx, Paul
>=20
>=20>=20
>=20> Hope this helps.
> >=20=20
>=20>  Thanks, Akira
> >=20=20
>=20>=20=20
>=20>=20=20
>=20>  Thanx, Kunwu
> >
>