Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: irq/concepts: Add commas and reflow

For easier reading, it is always desired to add commas at some places in
text. Like before adverbs or after fronted sentences.

[ tglx: Fix up subject prefix ]

Signed-off-by: Jiri Slaby (SUSE) <jirislaby@kernel.org>
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Link: https://lore.kernel.org/all/20250319092951.37667-54-jirislaby@kernel.org



authored by

Jiri Slaby (SUSE) and committed by
Thomas Gleixner
2f7bd329 2272a78b

+9 -10
+9 -10
Documentation/core-api/irq/concepts.rst
··· 2 2 What is an IRQ? 3 3 =============== 4 4 5 - An IRQ is an interrupt request from a device. 6 - Currently they can come in over a pin, or over a packet. 7 - Several devices may be connected to the same pin thus 8 - sharing an IRQ. 5 + An IRQ is an interrupt request from a device. Currently, they can come 6 + in over a pin, or over a packet. Several devices may be connected to 7 + the same pin thus sharing an IRQ. 9 8 10 9 An IRQ number is a kernel identifier used to talk about a hardware 11 - interrupt source. Typically this is an index into the global irq_desc 12 - array, but except for what linux/interrupt.h implements the details 10 + interrupt source. Typically, this is an index into the global irq_desc 11 + array, but except for what linux/interrupt.h implements, the details 13 12 are architecture specific. 14 13 15 14 An IRQ number is an enumeration of the possible interrupt sources on a 16 - machine. Typically what is enumerated is the number of input pins on 17 - all of the interrupt controller in the system. In the case of ISA 15 + machine. Typically, what is enumerated is the number of input pins on 16 + all of the interrupt controllers in the system. In the case of ISA, 18 17 what is enumerated are the 16 input pins on the two i8259 interrupt 19 18 controllers. 20 19 21 20 Architectures can assign additional meaning to the IRQ numbers, and 22 - are encouraged to in the case where there is any manual configuration 23 - of the hardware involved. The ISA IRQs are a classic example of 21 + are encouraged to in the case where there is any manual configuration 22 + of the hardware involved. The ISA IRQs are a classic example of 24 23 assigning this kind of additional meaning.