Skip to content

Documentation updates for v4.15

Paul E. McKenney lkml 1 version New

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest16 patches 0 repliesNew

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/16documentation: RCU grace-period memory ordering guaranteesDocumentation/RCU/Design/Memory-Ordering/Tree-RCU-Diagram.html Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.html Documentation/RCU/Design/Memory-Ordering/TreeRCU-callback-invocation.svg +11 more+14170 -00 replies
2/16documentation: Long-running irq handlers can stall RCU grace periodsDocumentation/RCU/stallwarn.txt+11 -10 replies
3/16documentation: Slow systems can stall RCU grace periodsDocumentation/RCU/stallwarn.txt+6 -00 replies
4/16documentation: Update RCU CPU stall warning messagesDocumentation/RCU/stallwarn.txt+105 -770 replies
5/16memory-barriers: Replace uses of "transitive"Documentation/memory-barriers.txt+91 -940 replies
6/16memory-barriers: Rework multicopy-atomicity sectionDocumentation/memory-barriers.txt+30 -280 replies
7/16doc: Fix options for RCU optionsDocumentation/core-api/kernel-api.rst+0 -140 replies
8/16doc: Add parameters to rcupdate.h docbook commentsinclude/linux/rcupdate.h+4 -00 replies
9/16rcu: Remove extra docbook comment in rculist.hinclude/linux/rculist.h+1 -10 replies
10/16rcu: Fix docbook comments for rcu_sync functionskernel/rcu/sync.c+6 -30 replies
11/16doc: Fix list and emphasis in rcupdate.hinclude/linux/rcupdate.h+8 -70 replies
12/16doc: Flag code segment in rcu_pointer_handoff()'s docbook headerinclude/linux/rcupdate.h+1 -10 replies
13/16doc: Fix code display in rcu_pointer_handoff()'s docbook commentinclude/linux/rcupdate.h+3 -20 replies
14/16doc: Fix tree.c bulleted lists in docbook comment headerskernel/rcu/tree.c+10 -80 replies
15/16memory-barriers.txt: Fix typo in pairing exampleDocumentation/memory-barriers.txt+1 -10 replies
16/16Documentation: rewrite confusing statement about memory barriersDocumentation/memory-barriers.txt+2 -20 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [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(-)