[PATCH tip/core/rcu 0/16] Documentation updates for v4.15

From: Paul E. McKenney
Date: Wed Oct 04 2017 - 17:27:02 EST


Hello!

This series contains documentation updates, including some updates to
docbook header comments:

1. Design documentation illustrating RCU's grace-period memory
ordering guarantees.

2. Add verbiage stating that long-running irq handlers can stall
RCU grace periods.

3. Add verbiage stating that slow systems can stall RCU grace periods.

4. Update description of RCU CPU stall warning messages.

5. Replace uses of "transitive" in memory-barriers.txt.

6. Rework multicopy-atomicity section of memory-barriers.txt,
courtesy of Alan Stern.

7. Fix RCU's docbook options.

8. Add parameters to rcupdate.h docbook comments.

9. Remove extra docbook comment in rculist.h.

10. Fix docbook comments for rcu_sync functions.

11. Fix list and emphasis in rcupdate.h docbook comments.

12. Flag code segment in rcu_pointer_handoff()'s docbook comment.

13. Fix code display in rcu_pointer_handoff()'s docbook comment.

14. Fix tree.c bulleted lists in docbook comments.

15. Fix typo in pairing example in memory-barriers.txt, courtesy
of Scott Tsai.

16. Rewrite confusing statement about memory barriers in
memory-barriers.txt, courtesy of Guilherme G. Piccoli.

Thanx, Paul

------------------------------------------------------------------------

Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Diagram.html | 9
Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.html | 707 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-callback-invocation.svg | 486
Documentation/RCU/Design/Memory-Ordering/TreeRCU-callback-registry.svg | 655 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-dyntick.svg | 700 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-cleanup.svg | 1126 ++
Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-fqs.svg | 1309 ++
Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-init-1.svg | 656 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-init-2.svg | 656 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-init-3.svg | 632 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp.svg | 5135 ++++++++++
Documentation/RCU/Design/Memory-Ordering/TreeRCU-hotplug.svg | 775 +
Documentation/RCU/Design/Memory-Ordering/TreeRCU-qs.svg | 1095 ++
Documentation/RCU/Design/Memory-Ordering/rcu_node-lock.svg | 229
Documentation/RCU/stallwarn.txt | 200
Documentation/core-api/kernel-api.rst | 14
Documentation/memory-barriers.txt | 249
include/linux/rculist.h | 2
include/linux/rcupdate.h | 26
kernel/rcu/sync.c | 9
kernel/rcu/tree.c | 18
21 files changed, 14449 insertions(+), 239 deletions(-)