Received-SPF: pass (google.com: domain of linux-kernel+bounces-103518-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
Precedence: bulk
MIME-Version: 1.0
References: <20240313214038.479253-1-chris.packham@alliedtelesis.co.nz>
In-Reply-To: <20240313214038.479253-1-chris.packham@alliedtelesis.co.nz>
From: "Rafael J. Wysocki" <rafael@kernel.org>
Date: Thu, 14 Mar 2024 16:39:09 +0100
Message-ID: <CAJZ5v0hi_eGEu-ON5SLLwE_m_ut55FYtmn8eJ848FseHYV+F+g@mail.gmail.com>
Subject: Re: [PATCH] ACPI: docs: enumeration: Make footnotes links
To: Chris Packham <chris.packham@alliedtelesis.co.nz>
Cc: rafael@kernel.org, lenb@kernel.org, linux-acpi@vger.kernel.org, 
	linux-kernel@vger.kernel.org
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Wed, Mar 13, 2024 at 10:40=E2=80=AFPM Chris Packham
<chris.packham@alliedtelesis.co.nz> wrote:
>
> Update the numeric footnotes so that they are rendered as hyperlinks in
> the html output.
>
> Signed-off-by: Chris Packham <chris.packham@alliedtelesis.co.nz>
> ---
>  Documentation/firmware-guide/acpi/enumeration.rst | 12 ++++++------
>  1 file changed, 6 insertions(+), 6 deletions(-)
>
> diff --git a/Documentation/firmware-guide/acpi/enumeration.rst b/Document=
ation/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 thes=
e pins.
> +16 GPIOs and we want to add the property ``gpio-line-names`` [1]_ to the=
se pins.
>  In this case, the ``lspci`` output for this component is::
>
>         07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (r=
ev 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 t=
ables,
> -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 ``lspc=
i``
>  output (both the devices list and the devices tree), we can write the fo=
llowing
>  ACPI description for the Exar PCIe UART, also adding the list of its GPI=
O line
> @@ -724,10 +724,10 @@ created analyzing the position of the Exar UART in =
the PCI bus topology.
>  References
>  =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
>
> -[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!