Messages in this thread | | | Date | Wed, 4 Oct 2017 14:20:51 -0700 | From | "Paul E. McKenney" <> | Subject | [PATCH tip/core/rcu 0/16] Documentation updates for v4.15 |
| |
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(-)
| |