[PATCH tip/core/rcu 0/20] Documentation updates for v4.21/v5.0

From: Paul E. McKenney
Date: Sun Nov 11 2018 - 14:56:30 EST


Hello!

This series provides documentation updates:

1. Set down forward-progress requirements.

2. Clarify RCU data-structure comment about rcu_tree fanout,
courtesy of Joel Fernandes.

3. Remove rcu_preempt_state reference in stallwarn, courtesy of
Joel Fernandes.

4. Update information about resched_cpu, courtesy of Joel Fernandes.

5. Remove rcu_dynticks from Data-Structures, courtesy of Joel
Fernandes.

6. Update Data-Structures for RCU flavor consolidation, courtesy of
Joel Fernandes.

7. Better clarify the rcu_segcblist ->len field, courtesy of Joel
Fernandes.

8. Update description of gp_seq fields in rcu_data, courtesy of
Joel Fernandes.

9. Document rcutorture forward-progress test kernel parameters.

10. Update core and full API in whatisRCU, courtesy of Joel Fernandes.

11. Add more rationale for using rcu_read_lock_sched() in checklist,
courtesy of Joel Fernandes.

12. Remove obsolete suggestion from checklist, courtesy of Joel
Fernandes.

13. Remove obsolete checklist item about synchronize_rcu() usage,
courtesy of Joel Fernandes.

14. Encourage use of rcu_barrier in checklist, courtesy of Joel
Fernandes.

15. Make reader aware of rcu_dereference_protected(), courtesy of
Joel Fernandes.

16. Remove obsolete (non-)requirement about disabling preemption,
courtesy of Joel Fernandes.

17. Make listing in RCU perf/scale requirements use rcu_assign_pointer(),
courtesy of Joel Fernandes.

18. RCU scheduler spinlock rcu_read_unlock() restriction remains.

19. Correct the parameter in stallwarn, courtesy of Joel Fernandes.

20. Fix "struction" typo in RCU memory-ordering documentation,
courtesy of Joel Fernandes.

Thanx, Paul

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

Documentation/RCU/Design/Data-Structures/BigTreeClassicRCUBH.svg | 499 -----
Documentation/RCU/Design/Data-Structures/BigTreeClassicRCUBHdyntick.svg | 695 --------
Documentation/RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntick.svg | 741 --------
b/Documentation/RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntickCB.svg | 834 +++-------
b/Documentation/RCU/Design/Data-Structures/Data-Structures.html | 177 --
b/Documentation/RCU/Design/Data-Structures/blkd_task.svg | 676 ++------
b/Documentation/RCU/Design/Expedited-Grace-Periods/Expedited-Grace-Periods.html | 6
b/Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.html | 2
b/Documentation/RCU/Design/Requirements/Requirements.html | 206 +-
b/Documentation/RCU/checklist.txt | 49
b/Documentation/RCU/stallwarn.txt | 7
b/Documentation/RCU/whatisRCU.txt | 70
b/Documentation/admin-guide/kernel-parameters.txt | 17
13 files changed, 823 insertions(+), 3156 deletions(-)