Re: [GIT PULL v2 rcu/next] memory-barriers.txt commits for 4.6

From: Ingo Molnar
Date: Wed Mar 16 2016 - 03:26:59 EST



* Paul E. McKenney <paulmck@xxxxxxxxxxxxxxxxxx> wrote:

> [...] In fact, in view of the no-diagrams and no-quizzes restrictions, I don't
> see a way to improve on comments in the source code. [...]

So I don't think there's such a hard restriction: AFAICS Linus's main problem was
the dual .html and .htmlx file for what essentially are the same documents.

If you can solve that with a single (.html?) file then I think it's all OK.

> The memory-barriers.txt commits are available in the git repository at:
>
> git://git.kernel.org/pub/scm/linux/kernel/git/paulmck/linux-rcu.git for-mingo
>
> for you to fetch changes up to 65f95ff2e41a32dd190cf28e3abb029625eef968:
>
> documentation: Clarify compiler store-fusion example (2016-03-14 15:52:19 -0700)
>
> ----------------------------------------------------------------
> Paul E. McKenney (7):
> documentation: Fix control dependency and identical stores
> documentation: Fix memory-barriers.txt section references
> documentation: Remove obsolete reference to RCU-protected indexes
> documentation: Subsequent writes ordered by rcu_dereference()
> documentation: Distinguish between local and global transitivity
> documentation: Add alternative release-acquire outcome
> documentation: Transitivity is not cumulativity
>
> SeongJae Park (1):
> documentation: Clarify compiler store-fusion example
>
> Documentation/memory-barriers.txt | 141 +++++++++++++++++++++++++++++++-------
> 1 file changed, 116 insertions(+), 25 deletions(-)

Pulled into tip:locking/urgent, thanks a lot Paul!

Ingo