2017-11-13 09:10:59

by Elena Reshetova

[permalink] [raw]
Subject: RE: [PATCH] refcount: provide same memory ordering guarantees as in atomic_t

<snip>

> Note that there's work done on better documents and updates to this one.
> One document that might be good to read (I have not in fact had time to
> read it myself yet :-():
>
> https://github.com/aparri/memory-
> model/blob/master/Documentation/explanation.txt
>

I have just finished reading over this and must say that this is excellent.
If I would have started reading on this topic from this doc and then move
to other in-tree docs, including memory-barriers.txt, I would
have had much less issues/questions and it would be much less of a bumpy
read.

Is there any plan to include it into official kernel doc tree? I really think it
would be very helpful for others also even basically to explain the notations, properties
and language people talk about these issues and give examples.

I will try to improve a bit the new doc I have previously sent a patch for in the
spirit of this reading.


Best Regards,
Elena.


From 1583045870703591022@xxx Fri Nov 03 11:56:28 +0000 2017
X-GM-THRID: 1582046402032606032
X-Gmail-Labels: Inbox,Category Forums,HistoricalUnread