2024-03-13 21:40:58

by Chris Packham

[permalink] [raw]
Subject: [PATCH] ACPI: docs: enumeration: Make footnotes links

Update the numeric footnotes so that they are rendered as hyperlinks in
the html output.

Signed-off-by: Chris Packham <[email protected]>
---
Documentation/firmware-guide/acpi/enumeration.rst | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/Documentation/firmware-guide/acpi/enumeration.rst b/Documentation/firmware-guide/acpi/enumeration.rst
index d79f69390991..0165b09c0957 100644
--- a/Documentation/firmware-guide/acpi/enumeration.rst
+++ b/Documentation/firmware-guide/acpi/enumeration.rst
@@ -595,7 +595,7 @@ bridges/switches of the board.

For example, let's assume we have a system with a PCIe serial port, an
Exar XR17V3521, soldered on the main board. This UART chip also includes
-16 GPIOs and we want to add the property ``gpio-line-names`` [1] to these pins.
+16 GPIOs and we want to add the property ``gpio-line-names`` [1]_ to these pins.
In this case, the ``lspci`` output for this component is::

07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (rev 03)
@@ -637,7 +637,7 @@ of the chipset bridge (also called "root port") with address::
Bus: 0 - Device: 14 - Function: 1

To find this information, it is necessary to disassemble the BIOS ACPI tables,
-in particular the DSDT (see also [2])::
+in particular the DSDT (see also [2]_)::

mkdir ~/tables/
cd ~/tables/
@@ -667,7 +667,7 @@ device::
}
... other definitions follow ...

-and the _ADR method [3] returns exactly the device/function couple that
+and the _ADR method [3]_ returns exactly the device/function couple that
we are looking for. With this information and analyzing the above ``lspci``
output (both the devices list and the devices tree), we can write the following
ACPI description for the Exar PCIe UART, also adding the list of its GPIO line
@@ -724,10 +724,10 @@ created analyzing the position of the Exar UART in the PCI bus topology.
References
==========

-[1] Documentation/firmware-guide/acpi/gpio-properties.rst
+.. [1] Documentation/firmware-guide/acpi/gpio-properties.rst

-[2] Documentation/admin-guide/acpi/initrd_table_override.rst
+.. [2] Documentation/admin-guide/acpi/initrd_table_override.rst

-[3] ACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
+.. [3] ACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
https://uefi.org/sites/default/files/resources/ACPI_6_3_May16.pdf,
referenced 2020-11-18
--
2.43.2



2024-03-14 15:39:29

by Rafael J. Wysocki

[permalink] [raw]
Subject: Re: [PATCH] ACPI: docs: enumeration: Make footnotes links

On Wed, Mar 13, 2024 at 10:40 PM Chris Packham
<[email protected]> wrote:
>
> Update the numeric footnotes so that they are rendered as hyperlinks in
> the html output.
>
> Signed-off-by: Chris Packham <[email protected]>
> ---
> Documentation/firmware-guide/acpi/enumeration.rst | 12 ++++++------
> 1 file changed, 6 insertions(+), 6 deletions(-)
>
> diff --git a/Documentation/firmware-guide/acpi/enumeration.rst b/Documentation/firmware-guide/acpi/enumeration.rst
> index d79f69390991..0165b09c0957 100644
> --- a/Documentation/firmware-guide/acpi/enumeration.rst
> +++ b/Documentation/firmware-guide/acpi/enumeration.rst
> @@ -595,7 +595,7 @@ bridges/switches of the board.
>
> For example, let's assume we have a system with a PCIe serial port, an
> Exar XR17V3521, soldered on the main board. This UART chip also includes
> -16 GPIOs and we want to add the property ``gpio-line-names`` [1] to these pins.
> +16 GPIOs and we want to add the property ``gpio-line-names`` [1]_ to these pins.
> In this case, the ``lspci`` output for this component is::
>
> 07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (rev 03)
> @@ -637,7 +637,7 @@ of the chipset bridge (also called "root port") with address::
> Bus: 0 - Device: 14 - Function: 1
>
> To find this information, it is necessary to disassemble the BIOS ACPI tables,
> -in particular the DSDT (see also [2])::
> +in particular the DSDT (see also [2]_)::
>
> mkdir ~/tables/
> cd ~/tables/
> @@ -667,7 +667,7 @@ device::
> }
> ... other definitions follow ...
>
> -and the _ADR method [3] returns exactly the device/function couple that
> +and the _ADR method [3]_ returns exactly the device/function couple that
> we are looking for. With this information and analyzing the above ``lspci``
> output (both the devices list and the devices tree), we can write the following
> ACPI description for the Exar PCIe UART, also adding the list of its GPIO line
> @@ -724,10 +724,10 @@ created analyzing the position of the Exar UART in the PCI bus topology.
> References
> ==========
>
> -[1] Documentation/firmware-guide/acpi/gpio-properties.rst
> +.. [1] Documentation/firmware-guide/acpi/gpio-properties.rst
>
> -[2] Documentation/admin-guide/acpi/initrd_table_override.rst
> +.. [2] Documentation/admin-guide/acpi/initrd_table_override.rst
>
> -[3] ACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
> +.. [3] ACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
> https://uefi.org/sites/default/files/resources/ACPI_6_3_May16.pdf,
> referenced 2020-11-18
> --

Applied as 6.9-rc material, thanks!