Re: [RFC PATCH v2 01/18] cxl: update documentation structure in prep for new docs

From: Bagas Sanjaya
Date: Sun May 11 2025 - 03:34:40 EST


On Wed, Apr 30, 2025 at 02:10:31PM -0400, Gregory Price wrote:
> rename Documentation/driver-api/cxl/{ => linux}/access-coordinates.rst (100%)

Not strictly related to this patch is I'm seeing example hierarchy diagram in
access-coordinates.rst renders in htmldocs output as long-running paragraph,
so I wrap it in literal code-block:

---- >8 ----
diff --git a/Documentation/driver-api/cxl/linux/access-coordinates.rst b/Documentation/driver-api/cxl/linux/access-coordinates.rst
index 77ba9be9af2d60..cd6d66cdf9e691 100644
--- a/Documentation/driver-api/cxl/linux/access-coordinates.rst
+++ b/Documentation/driver-api/cxl/linux/access-coordinates.rst
@@ -27,20 +27,20 @@ a CXL Host Bridge (HB). There can be multiple HBs under a CXL Fixed Memory
Window Structure (CFMWS) in the
Documentation/driver-api/cxl/platform/acpi/cedt.rst.

-An example hierarchy:
+An example hierarchy::

-> CFMWS 0
-> |
-> _________|_________
-> | |
-> ACPI0017-0 ACPI0017-1
-> GP0/HB0/ACPI0016-0 GP1/HB1/ACPI0016-1
-> | | | |
-> RP0 RP1 RP2 RP3
-> | | | |
-> SW 0 SW 1 SW 2 SW 3
-> | | | | | | | |
-> EP0 EP1 EP2 EP3 EP4 EP5 EP6 EP7
+ CFMWS 0
+ |
+ _________|_________
+ | |
+ ACPI0017-0 ACPI0017-1
+ GP0/HB0/ACPI0016-0 GP1/HB1/ACPI0016-1
+ | | | |
+ RP0 RP1 RP2 RP3
+ | | | |
+ SW 0 SW 1 SW 2 SW 3
+ | | | | | | | |
+ EP0 EP1 EP2 EP3 EP4 EP5 EP6 EP7

Computation for the example hierarchy:


The fixup may be added as separate commit.

Thanks.

--
An old man doll... just what I always wanted! - Clara

Attachment: signature.asc
Description: PGP signature