Skip to content

Commit a557f67

Browse files
mchehabJonathan Corbet
authored andcommitted
docs: PCI: Replace non-breaking spaces to avoid PDF issues
The conversion tools used during DocBook/LaTeX/html/Markdown->ReST conversion and some cut-and-pasted text contain some characters that aren't easily reachable on standard keyboards and/or could cause troubles when parsed by the documentation build system. Replace the occurences of the following characters: - U+00a0 (' '): NO-BREAK SPACE as it can cause lines being truncated on PDF output Acked-by: Bjorn Helgaas <[email protected]> Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/8036126a59adb720dbc9233341ad5a08531cf73f.1623826294.git.mchehab+huawei@kernel.org Signed-off-by: Jonathan Corbet <[email protected]>
1 parent 729979e commit a557f67

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

Documentation/PCI/acpi-info.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,9 @@ or if the device has INTx interrupts connected by platform interrupt
2222
controllers and a _PRT is needed to describe those connections.
2323

2424
ACPI resource description is done via _CRS objects of devices in the ACPI
25-
namespace [2].   The _CRS is like a generalized PCI BAR: the OS can read
25+
namespace [2]. The _CRS is like a generalized PCI BAR: the OS can read
2626
_CRS and figure out what resource is being consumed even if it doesn't have
27-
a driver for the device [3].  That's important because it means an old OS
27+
a driver for the device [3]. That's important because it means an old OS
2828
can work correctly even on a system with new devices unknown to the OS.
2929
The new devices might not do anything, but the OS can at least make sure no
3030
resources conflict with them.
@@ -41,15 +41,15 @@ ACPI, that device will have a specific _HID/_CID that tells the OS what
4141
driver to bind to it, and the _CRS tells the OS and the driver where the
4242
device's registers are.
4343

44-
PCI host bridges are PNP0A03 or PNP0A08 devices.  Their _CRS should
45-
describe all the address space they consume.  This includes all the windows
44+
PCI host bridges are PNP0A03 or PNP0A08 devices. Their _CRS should
45+
describe all the address space they consume. This includes all the windows
4646
they forward down to the PCI bus, as well as registers of the host bridge
47-
itself that are not forwarded to PCI.  The host bridge registers include
47+
itself that are not forwarded to PCI. The host bridge registers include
4848
things like secondary/subordinate bus registers that determine the bus
4949
range below the bridge, window registers that describe the apertures, etc.
5050
These are all device-specific, non-architected things, so the only way a
5151
PNP0A03/PNP0A08 driver can manage them is via _PRS/_CRS/_SRS, which contain
52-
the device-specific details.  The host bridge registers also include ECAM
52+
the device-specific details. The host bridge registers also include ECAM
5353
space, since it is consumed by the host bridge.
5454

5555
ACPI defines a Consumer/Producer bit to distinguish the bridge registers
@@ -66,7 +66,7 @@ the PNP0A03/PNP0A08 device itself. The workaround was to describe the
6666
bridge registers (including ECAM space) in PNP0C02 catch-all devices [6].
6767
With the exception of ECAM, the bridge register space is device-specific
6868
anyway, so the generic PNP0A03/PNP0A08 driver (pci_root.c) has no need to
69-
know about it.  
69+
know about it.
7070

7171
New architectures should be able to use "Consumer" Extended Address Space
7272
descriptors in the PNP0A03 device for bridge registers, including ECAM,
@@ -75,9 +75,9 @@ ia64 kernels assume all address space descriptors, including "Consumer"
7575
Extended Address Space ones, are windows, so it would not be safe to
7676
describe bridge registers this way on those architectures.
7777

78-
PNP0C02 "motherboard" devices are basically a catch-all.  There's no
78+
PNP0C02 "motherboard" devices are basically a catch-all. There's no
7979
programming model for them other than "don't use these resources for
80-
anything else."  So a PNP0C02 _CRS should claim any address space that is
80+
anything else." So a PNP0C02 _CRS should claim any address space that is
8181
(1) not claimed by _CRS under any other device object in the ACPI namespace
8282
and (2) should not be assigned by the OS to something else.
8383

0 commit comments

Comments
 (0)