Received: by 2002:ab2:5c0e:0:b0:1ef:a325:1205 with SMTP id i14csp9971lqk; Wed, 13 Mar 2024 14:40:58 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXw5Gztqe2gfjZjVtY429JgsX0M+p6S7hx40edwj4ojrI/gksb5IU30dD/sFOtnHd0AsdhdQ4Tx3DHcBtV2t2mXcvNmcsJ1h5+EU4Un6Q== X-Google-Smtp-Source: AGHT+IHp3TTcwCYIBMsDGSu5Yg/9usxoAAYSYjVveibnTlDLLKd3KlPgpYSPKFCDw4ETytdwSCTI X-Received: by 2002:a50:cc0c:0:b0:565:2458:4f5a with SMTP id m12-20020a50cc0c000000b0056524584f5amr2993707edi.4.1710366058199; Wed, 13 Mar 2024 14:40:58 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1710366058; cv=pass; d=google.com; s=arc-20160816; b=y97/5Teb0u4WO1djzX6ePe4rgb1R3hiBVx1lbaGUHuOIdemeApDXbPf9WPraXFUKjM HnajaHpOTcNlpdijHkyfdrFubakGqh5sNizrE1GIYw9oJIqJUBKSz4IMHtIsJdOsdxdp 4v5pn+KSmPnTbv5CbOOIndIoGmmPgFbISZMqvH1x+UowAEMrM4nUTqnBazLQfBHN+UTC pispVdMDbl8+XQqrFGuPIvDgmUjs3/NWR9gqE95NhNOmKQc0uIlm1ol/srEWzcq4aAl7 2a6/YGq4dllfCdPo0KkAnSLcm/udqtGZLiIdf35dOUB2sYY/2kqXIEc2tFsh6Jb6t1HV z65g== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=mV4oUURtJa5fDu6eFwW5lGCkuKZZh3l9yb4RSs8QcHQ=; fh=UDlsOGw5P7t2bQvCTc5hL7sP4cs+XMNL9/f0BAkYOz8=; b=ARalrlS154t6xODUsoBN72XMq3/M5BZp0cLuYbZhaQZgH/RyADrE9Uxlmh9rkuzqLj E/MG/goVqmmpFECG5bhO7bGcn5wA3HCcqS5ZvP33LXYcLTwK1L7QX01lS5RNVgfkHo+A 8Z34b9GxjjBLeErcw+HMwahC8SuiHDJiXoH4XTxGziP5OpkKA5kIVGr7vyHPcygre/Q9 x54sH9b/I5pNNsjo4qj8BvpIRfMe3YUE2RbKOlTI5j7mf/O5kYKPzvOCxMNlYo8S4CO0 BSMpNAQ3GhBf3hhjhuC79bry4ZjLCV23uVFC0EbJXiqpna9AW/ToXf0Q3dddNXgFgb7q 39ng==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@alliedtelesis.co.nz header.s=mail181024 header.b=pxVlJYub; arc=pass (i=1 spf=pass spfdomain=alliedtelesis.co.nz dkim=pass dkdomain=alliedtelesis.co.nz dmarc=pass fromdomain=alliedtelesis.co.nz); spf=pass (google.com: domain of linux-kernel+bounces-102540-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-102540-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=REJECT dis=NONE) header.from=alliedtelesis.co.nz Return-Path: Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id et13-20020a056402378d00b00568358cd714si40775edb.216.2024.03.13.14.40.58 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Mar 2024 14:40:58 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-102540-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@alliedtelesis.co.nz header.s=mail181024 header.b=pxVlJYub; arc=pass (i=1 spf=pass spfdomain=alliedtelesis.co.nz dkim=pass dkdomain=alliedtelesis.co.nz dmarc=pass fromdomain=alliedtelesis.co.nz); spf=pass (google.com: domain of linux-kernel+bounces-102540-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-102540-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=REJECT dis=NONE) header.from=alliedtelesis.co.nz Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id E264E1F23883 for ; Wed, 13 Mar 2024 21:40:57 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 58CE4535B7; Wed, 13 Mar 2024 21:40:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=alliedtelesis.co.nz header.i=@alliedtelesis.co.nz header.b="pxVlJYub" Received: from gate2.alliedtelesis.co.nz (gate2.alliedtelesis.co.nz [202.36.163.20]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0A90C5336D for ; Wed, 13 Mar 2024 21:40:48 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=202.36.163.20 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710366051; cv=none; b=OVNlZAIUiSOHp6HADvzAf4clQac/0V2wqpw7e/P6bojewlIqL+u6gSyLGwKNweY/dfTDEc/Xj1pE63tW5Mz1WJbPOCDUkifRS3X0VlKIzQbVtVhicwpcnl3IWQXac8ncwAzDaXpSp1WUJRBJHjAWtwrbBjCnCwpfsYNFvCtbT/E= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710366051; c=relaxed/simple; bh=mPoVTQYq7VdvrrxQ6la9CwblUF2lFdSL1QHuZq2WXy8=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=KodjNKCN3fzWay4r29OaCr/aIJDbayQzGKu7JW+m+LnqdkxTxs6AlrHIWjxH4aseq4fEHBijRFjf3nI65YE9qKEoEnuCVsjsacsIhUhU/aggyHTFt/Z1dSKm2YnU0J2NuHtYeAQrG57MtLpbLE5Rzhr667MLmsPi7ObTOHu3Fks= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=alliedtelesis.co.nz; spf=pass smtp.mailfrom=alliedtelesis.co.nz; dkim=pass (2048-bit key) header.d=alliedtelesis.co.nz header.i=@alliedtelesis.co.nz header.b=pxVlJYub; arc=none smtp.client-ip=202.36.163.20 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=alliedtelesis.co.nz Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=alliedtelesis.co.nz Received: from svr-chch-seg1.atlnz.lc (mmarshal3.atlnz.lc [10.32.18.43]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by gate2.alliedtelesis.co.nz (Postfix) with ESMTPS id CA5592C018E; Thu, 14 Mar 2024 10:40:40 +1300 (NZDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alliedtelesis.co.nz; s=mail181024; t=1710366040; bh=mV4oUURtJa5fDu6eFwW5lGCkuKZZh3l9yb4RSs8QcHQ=; h=From:To:Cc:Subject:Date:From; b=pxVlJYubjo1eWXzzeyJ8BwJYcJGiFp8JZOY6qVsg+gF+blBWcweh8BYyMwD1+MWPu Eg7vmuhvRYLrkh5aM2XAIuvx91yL35m9wZIiYmTM0uqN1HNOnJjIWWAo/r5RkBxWR/ cY7K1x5FlVeacgNN6i5VFH0ImCP+A+CGgIQdKhmm6tLYCnTsedSShaquxE63jCqOsE Xz8nqfaPSgaKTiy3JHFXlfe5MoKaG/gmi4F4gJt2tCS2CR9Rgo9oicQCH7cUgZT1yJ cxKtB4vnBgD4J2/oycOTk+UItUkVyuJmId4P5CB8PGF1EkvZMbk+bSCUbeg9Q0zWE7 ty8e/8v6vgLJw== Received: from pat.atlnz.lc (Not Verified[10.32.16.33]) by svr-chch-seg1.atlnz.lc with Trustwave SEG (v8,2,6,11305) id ; Thu, 14 Mar 2024 10:40:40 +1300 Received: from chrisp-dl.ws.atlnz.lc (chrisp-dl.ws.atlnz.lc [10.33.22.30]) by pat.atlnz.lc (Postfix) with ESMTP id 85A5D13EE36; Thu, 14 Mar 2024 10:40:40 +1300 (NZDT) Received: by chrisp-dl.ws.atlnz.lc (Postfix, from userid 1030) id 80C5D280A37; Thu, 14 Mar 2024 10:40:40 +1300 (NZDT) From: Chris Packham To: rafael@kernel.org, lenb@kernel.org Cc: linux-acpi@vger.kernel.org, linux-kernel@vger.kernel.org, Chris Packham Subject: [PATCH] ACPI: docs: enumeration: Make footnotes links Date: Thu, 14 Mar 2024 10:40:38 +1300 Message-ID: <20240313214038.479253-1-chris.packham@alliedtelesis.co.nz> X-Mailer: git-send-email 2.43.2 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-SEG-SpamProfiler-Analysis: v=2.4 cv=KIH5D0Fo c=1 sm=1 tr=0 ts=65f21d58 a=KLBiSEs5mFS1a/PbTCJxuA==:117 a=K6JAEmCyrfEA:10 a=dw0t6H4-AAAA:8 a=iFXl2urbudpVc5562-MA:9 a=3ZKOabzyN94A:10 a=wVJa4CU9-Z26yuRAZDil:22 X-SEG-SpamProfiler-Score: 0 x-atlnz-ls: pat Update the numeric footnotes so that they are rendered as hyperlinks in the html output. Signed-off-by: Chris Packham --- 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. =20 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:: =20 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 =20 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]_):: =20 mkdir ~/tables/ cd ~/tables/ @@ -667,7 +667,7 @@ device:: } ... other definitions follow ... =20 -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 =20 -[1] Documentation/firmware-guide/acpi/gpio-properties.rst +.. [1] Documentation/firmware-guide/acpi/gpio-properties.rst =20 -[2] Documentation/admin-guide/acpi/initrd_table_override.rst +.. [2] Documentation/admin-guide/acpi/initrd_table_override.rst =20 -[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 --=20 2.43.2