[PATCH] powerpc/doc: Fix htmldocs errors

Subsystems: documentation, the rest

STALE1833d LANDED

Landed in mainline as f50da6edbf1e on 2021-08-26.

3 messages, 3 authors, 2021-08-27 · open the first message on its own page

[PATCH] powerpc/doc: Fix htmldocs errors

From: Aneesh Kumar K.V <hidden>
Date: 2021-08-25 04:26:05

Fix make htmldocs related errors with the newly added associativity.rst
doc file.

Reported-by: Stephen Rothwell <redacted>
Signed-off-by: Aneesh Kumar K.V <redacted>
---
 Documentation/powerpc/associativity.rst | 29 +++++++++++++------------
 Documentation/powerpc/index.rst         |  1 +
 2 files changed, 16 insertions(+), 14 deletions(-)
diff --git a/Documentation/powerpc/associativity.rst b/Documentation/powerpc/associativity.rst
index 07e7dd3d6c87..4d01c7368561 100644
--- a/Documentation/powerpc/associativity.rst
+++ b/Documentation/powerpc/associativity.rst
@@ -1,6 +1,6 @@
 ============================
 NUMA resource associativity
-=============================
+============================
 
 Associativity represents the groupings of the various platform resources into
 domains of substantially similar mean performance relative to resources outside
@@ -20,11 +20,11 @@ A value of 1 indicates the usage of Form 1 associativity. For Form 2 associativi
 bit 2 of byte 5 in the "ibm,architecture-vec-5" property is used.
 
 Form 0
------
+------
 Form 0 associativity supports only two NUMA distances (LOCAL and REMOTE).
 
 Form 1
------
+------
 With Form 1 a combination of ibm,associativity-reference-points, and ibm,associativity
 device tree properties are used to determine the NUMA distance between resource groups/domains.
 
@@ -78,17 +78,18 @@ numa-lookup-index-table.
 
 For ex:
 ibm,numa-lookup-index-table = <3 0 8 40>;
-ibm,numa-distace-table = <9>, /bits/ 8 < 10  20  80
-					 20  10 160
-					 80 160  10>;
-  | 0    8   40
---|------------
-  |
-0 | 10   20  80
-  |
-8 | 20   10  160
-  |
-40| 80   160  10
+ibm,numa-distace-table = <9>, /bits/ 8 < 10  20  80 20  10 160 80 160  10>;
+
+::
+
+	  | 0    8   40
+	--|------------
+	  |
+	0 | 10   20  80
+	  |
+	8 | 20   10  160
+	  |
+	40| 80   160  10
 
 A possible "ibm,associativity" property for resources in node 0, 8 and 40
 
diff --git a/Documentation/powerpc/index.rst b/Documentation/powerpc/index.rst
index bf5f1a2bdbdf..0f7d3c495693 100644
--- a/Documentation/powerpc/index.rst
+++ b/Documentation/powerpc/index.rst
@@ -7,6 +7,7 @@ powerpc
 .. toctree::
     :maxdepth: 1
 
+    associativity
     booting
     bootwrapper
     cpu_families
-- 
2.31.1

Re: [PATCH] powerpc/doc: Fix htmldocs errors

From: Stephen Rothwell <hidden>
Date: 2021-08-25 09:47:11

Hi Aneesh,

On Wed, 25 Aug 2021 09:54:47 +0530 "Aneesh Kumar K.V" [off-list ref] wrote:
Fix make htmldocs related errors with the newly added associativity.rst
doc file.

Reported-by: Stephen Rothwell <redacted>
Signed-off-by: Aneesh Kumar K.V <redacted>
---
 Documentation/powerpc/associativity.rst | 29 +++++++++++++------------
 Documentation/powerpc/index.rst         |  1 +
 2 files changed, 16 insertions(+), 14 deletions(-)
This fixes all the warnings related to this file for me.

Tested-by: Stephen Rothwell <redacted> # build test

Michael, it would be good if this could go in soon as without this
patch my "make htmldocs" run livelocks. :-(

-- 
Cheers,
Stephen Rothwell

Re: [PATCH] powerpc/doc: Fix htmldocs errors

From: Michael Ellerman <hidden>
Date: 2021-08-27 13:22:30

On Wed, 25 Aug 2021 09:54:47 +0530, Aneesh Kumar K.V wrote:
Fix make htmldocs related errors with the newly added associativity.rst
doc file.


Applied to powerpc/next.

[1/1] powerpc/doc: Fix htmldocs errors
      https://git.kernel.org/powerpc/c/f50da6edbf1ebf35dd8070847bfab5cb988d472b

cheers
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help