All of lore.kernel.org
 help / color / mirror / Atom feed
From: "tip-bot2 for Randy Dunlap" <tip-bot2@linutronix.de>
To: linux-tip-commits@vger.kernel.org
Cc: Randy Dunlap <rdunlap@infradead.org>,
	Thomas Gleixner <tglx@linutronix.de>,
	"Paul E. McKenney" <paulmck@kernel.org>, x86 <x86@kernel.org>,
	LKML <linux-kernel@vger.kernel.org>
Subject: [tip: locking/core] Documentation/locking/locktypes: Minor copy editor fixes
Date: Sat, 28 Mar 2020 11:52:03 -0000	[thread overview]
Message-ID: <158539632348.28353.11072082042183429562.tip-bot2@tip-bot2> (raw)
In-Reply-To: <ac615f36-0b44-408d-aeab-d76e4241add4@infradead.org>

The following commit has been merged into the locking/core branch of tip:

Commit-ID:     51e69e6551a8c6fffe0185ba305bb4e2d7223616
Gitweb:        https://git.kernel.org/tip/51e69e6551a8c6fffe0185ba305bb4e2d7223616
Author:        Randy Dunlap <rdunlap@infradead.org>
AuthorDate:    Wed, 25 Mar 2020 09:58:14 -07:00
Committer:     Thomas Gleixner <tglx@linutronix.de>
CommitterDate: Sat, 28 Mar 2020 12:47:34 +01:00

Documentation/locking/locktypes: Minor copy editor fixes

Minor editorial fixes:
- remove 'enabled' from PREEMPT_RT enabled kernels for consistency
- add some periods for consistency
- add "'" for possessive CPU's
- spell out interrupts

[ tglx: Picked up Paul's suggestions ]

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Reviewed-by: Paul E. McKenney <paulmck@kernel.org>
Link: https://lkml.kernel.org/r/ac615f36-0b44-408d-aeab-d76e4241add4@infradead.org

---
 Documentation/locking/locktypes.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/Documentation/locking/locktypes.rst b/Documentation/locking/locktypes.rst
index 1c18bb8..09f45ce 100644
--- a/Documentation/locking/locktypes.rst
+++ b/Documentation/locking/locktypes.rst
@@ -84,7 +84,7 @@ rtmutex
 
 RT-mutexes are mutexes with support for priority inheritance (PI).
 
-PI has limitations on non PREEMPT_RT enabled kernels due to preemption and
+PI has limitations on non-PREEMPT_RT kernels due to preemption and
 interrupt disabled sections.
 
 PI clearly cannot preempt preemption-disabled or interrupt-disabled
@@ -150,7 +150,7 @@ kernel configuration including PREEMPT_RT enabled kernels.
 
 raw_spinlock_t is a strict spinning lock implementation in all kernels,
 including PREEMPT_RT kernels.  Use raw_spinlock_t only in real critical
-core code, low level interrupt handling and places where disabling
+core code, low-level interrupt handling and places where disabling
 preemption or interrupts is required, for example, to safely access
 hardware state.  raw_spinlock_t can sometimes also be used when the
 critical section is tiny, thus avoiding RT-mutex overhead.
@@ -160,20 +160,20 @@ spinlock_t
 
 The semantics of spinlock_t change with the state of PREEMPT_RT.
 
-On a non PREEMPT_RT enabled kernel spinlock_t is mapped to raw_spinlock_t
-and has exactly the same semantics.
+On a non-PREEMPT_RT kernel spinlock_t is mapped to raw_spinlock_t and has
+exactly the same semantics.
 
 spinlock_t and PREEMPT_RT
 -------------------------
 
-On a PREEMPT_RT enabled kernel spinlock_t is mapped to a separate
-implementation based on rt_mutex which changes the semantics:
+On a PREEMPT_RT kernel spinlock_t is mapped to a separate implementation
+based on rt_mutex which changes the semantics:
 
- - Preemption is not disabled
+ - Preemption is not disabled.
 
  - The hard interrupt related suffixes for spin_lock / spin_unlock
-   operations (_irq, _irqsave / _irqrestore) do not affect the CPUs
-   interrupt disabled state
+   operations (_irq, _irqsave / _irqrestore) do not affect the CPU's
+   interrupt disabled state.
 
  - The soft interrupt related suffix (_bh()) still disables softirq
    handlers.
@@ -279,8 +279,8 @@ fully preemptible context.  Instead, use spin_lock_irq() or
 spin_lock_irqsave() and their unlock counterparts.  In cases where the
 interrupt disabling and locking must remain separate, PREEMPT_RT offers a
 local_lock mechanism.  Acquiring the local_lock pins the task to a CPU,
-allowing things like per-CPU irq-disabled locks to be acquired.  However,
-this approach should be used only where absolutely necessary.
+allowing things like per-CPU interrupt disabled locks to be acquired.
+However, this approach should be used only where absolutely necessary.
 
 
 raw_spinlock_t

  parent reply	other threads:[~2020-03-28 11:52 UTC|newest]

Thread overview: 195+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-03-21 11:25 [patch V3 00/20] Lock ordering documentation and annotation for lockdep Thomas Gleixner
2020-03-21 11:25 ` Thomas Gleixner
2020-03-21 11:25 ` Thomas Gleixner
2020-03-21 11:25 ` Thomas Gleixner
2020-03-21 11:25 ` [patch V3 01/20] PCI/switchtec: Fix init_completion race condition with poll_wait() Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25 ` [patch V3 02/20] pci/switchtec: Replace completion wait queue usage for poll Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 11:25 ` [patch V3 03/20] usb: gadget: Use completion interface instead of open coding it Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Thomas Gleixner
2020-03-25  8:37   ` [patch V3 03/20] " Felipe Balbi
2020-03-25  8:37     ` Felipe Balbi
2020-03-25  8:37     ` Felipe Balbi
2020-03-25  8:37     ` Felipe Balbi
2020-03-27 12:14     ` Sebastian Siewior
2020-03-27 12:14       ` Sebastian Siewior
2020-03-27 12:14       ` Sebastian Siewior
2020-03-27 12:14       ` Sebastian Siewior
2020-03-21 11:25 ` [patch V3 04/20] orinoco_usb: Use the regular completion interfaces Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Thomas Gleixner
2020-03-22 14:42   ` [patch V3 04/20] " Kalle Valo
2020-03-22 14:42     ` Kalle Valo
2020-03-22 14:42     ` Kalle Valo
2020-03-21 11:25 ` [patch V3 05/20] acpi: Remove header dependency Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 12:23   ` Andy Shevchenko
2020-03-21 12:23     ` Andy Shevchenko
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Peter Zijlstra
2020-03-22  7:02   ` [patch V3 05/20] " Rafael J. Wysocki
2020-03-22  7:02     ` Rafael J. Wysocki
2020-03-21 11:25 ` [patch V3 06/20] nds32: Remove mm.h from asm/uaccess.h Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 11:25 ` [patch V3 07/20] csky: " Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 11:25 ` [patch V3 08/20] hexagon: " Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-23 21:46   ` [patch V3 08/20] " Brian Cain
2020-03-23 21:46     ` Brian Cain
2020-03-23 21:46     ` Brian Cain
2020-03-23 21:46     ` Brian Cain
2020-03-21 11:25 ` [patch V3 09/20] ia64: " Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 11:25 ` [patch V3 10/20] microblaze: " Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 11:25 ` [patch V3 11/20] rcuwait: Add @state argument to rcuwait_wait_event() Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Peter Zijlstra (Intel)
2020-03-21 11:25 ` [patch V3 12/20] powerpc/ps3: Convert half completion to rcuwait Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 13:22   ` Thomas Gleixner
2020-03-21 13:22     ` Thomas Gleixner
2020-03-21 13:22     ` Thomas Gleixner
2020-03-21 13:22     ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Peter Zijlstra (Intel)
2020-03-27 19:14   ` [patch V3 12/20] " Geoff Levand
2020-03-27 19:14     ` Geoff Levand
2020-03-27 19:14     ` Geoff Levand
2020-03-27 19:14     ` Geoff Levand
2020-03-21 11:25 ` [patch V3 13/20] Documentation: Add lock ordering and nesting documentation Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Thomas Gleixner
2020-03-23  2:55   ` [patch V3 13/20] " Paul E. McKenney
2020-03-23  2:55     ` Paul E. McKenney
2020-03-23  2:55     ` Paul E. McKenney
2020-03-23  2:55     ` Paul E. McKenney
2020-03-23  2:55     ` Paul E. McKenney
2020-03-24 23:13     ` Thomas Gleixner
2020-03-24 23:13       ` Thomas Gleixner
2020-03-24 23:13       ` Thomas Gleixner
2020-03-24 23:13       ` Thomas Gleixner
2020-03-24 23:13       ` Thomas Gleixner
2020-03-25  0:28       ` Paul E. McKenney
2020-03-25  0:28         ` Paul E. McKenney
2020-03-25  0:28         ` Paul E. McKenney
2020-03-25  0:28         ` Paul E. McKenney
2020-03-25  0:28         ` Paul E. McKenney
2020-03-25 12:27         ` Documentation/locking/locktypes: Further clarifications and wordsmithing Thomas Gleixner
2020-03-25 12:27           ` Thomas Gleixner
2020-03-25 12:27           ` Thomas Gleixner
2020-03-25 12:27           ` Thomas Gleixner
2020-03-25 12:27           ` Thomas Gleixner
2020-03-25 16:02           ` Sebastian Siewior
2020-03-25 16:02             ` Sebastian Siewior
2020-03-25 16:02             ` Sebastian Siewior
2020-03-25 16:02             ` Sebastian Siewior
2020-03-25 16:02             ` Sebastian Siewior
2020-03-25 16:39             ` Paul E. McKenney
2020-03-25 16:39               ` Paul E. McKenney
2020-03-25 16:39               ` Paul E. McKenney
2020-03-25 16:39               ` Paul E. McKenney
2020-03-25 16:54               ` Sebastian Siewior
2020-03-25 16:54                 ` Sebastian Siewior
2020-03-25 16:54                 ` Sebastian Siewior
2020-03-25 16:54                 ` Sebastian Siewior
2020-03-25 16:58           ` [PATCH v2] Documentation/locking/locktypes: minor copy editor fixes Randy Dunlap
2020-03-25 16:58             ` Randy Dunlap
2020-03-25 16:58             ` Randy Dunlap
2020-03-25 16:58             ` Randy Dunlap
2020-03-26  2:40             ` Paul E. McKenney
2020-03-26  2:40               ` Paul E. McKenney
2020-03-26  2:40               ` Paul E. McKenney
2020-03-26  2:40               ` Paul E. McKenney
2020-03-26  2:40               ` Paul E. McKenney
2020-03-28 11:52             ` tip-bot2 for Randy Dunlap [this message]
2020-03-28 11:52           ` [tip: locking/core] Documentation/locking/locktypes: Further clarifications and wordsmithing tip-bot2 for Thomas Gleixner
2020-03-21 11:25 ` [patch V3 14/20] timekeeping: Split jiffies seqlock Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Thomas Gleixner
2020-03-21 11:25 ` [patch V3 15/20] sched/swait: Prepare usage in completions Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 11:25   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Thomas Gleixner
2020-03-21 11:26 ` [patch V3 16/20] completion: Use simple wait queues Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Thomas Gleixner
2020-03-23 15:20   ` [PATCH] completion: Use lockdep_assert_RT_in_threaded_ctx() in complete_all() Sebastian Siewior
2020-03-23 15:20     ` Sebastian Siewior
2020-03-23 15:20     ` Sebastian Siewior
2020-03-23 15:20     ` Sebastian Siewior
2020-03-23 17:50     ` [tip: locking/core] " tip-bot2 for Sebastian Siewior
2020-03-21 11:26 ` [patch V3 17/20] lockdep: Introduce wait-type checks Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Peter Zijlstra
2020-03-21 11:26 ` [patch V3 18/20] lockdep: Add hrtimer context tracing bits Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 16:46     ` Frederic Weisbecker
2020-03-21 11:26 ` [patch V3 19/20] lockdep: Annotate irq_work Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 16:40     ` Frederic Weisbecker
2020-03-21 18:12       ` Sebastian Andrzej Siewior
2020-03-22  2:33         ` Frederic Weisbecker
2020-03-22  2:39           ` Frederic Weisbecker
2020-03-22 12:27           ` Sebastian Andrzej Siewior
2020-03-21 11:26 ` [patch V3 20/20] lockdep: Add posixtimer context tracing bits Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 11:26   ` Thomas Gleixner
2020-03-21 15:53   ` [tip: locking/core] " tip-bot2 for Sebastian Andrzej Siewior
2020-03-21 17:19 ` [patch V3 00/20] Lock ordering documentation and annotation for lockdep Davidlohr Bueso
2020-03-21 17:19   ` Davidlohr Bueso
2020-03-21 17:19   ` Davidlohr Bueso
2020-03-21 17:19   ` Davidlohr Bueso
2020-03-21 17:45   ` Thomas Gleixner
2020-03-21 17:45     ` Thomas Gleixner
2020-03-21 17:45     ` Thomas Gleixner
2020-03-21 17:45     ` Thomas Gleixner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=158539632348.28353.11072082042183429562.tip-bot2@tip-bot2 \
    --to=tip-bot2@linutronix.de \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-tip-commits@vger.kernel.org \
    --cc=paulmck@kernel.org \
    --cc=rdunlap@infradead.org \
    --cc=tglx@linutronix.de \
    --cc=x86@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.