[PATCH 17/27] docs: sphinx/kernel_abi: properly split lines

From: Mauro Carvalho Chehab
Date: Mon Feb 10 2025 - 05:20:42 EST


Sphinx doesn't like to have lines split with str.split("\n").

Instead, it uses its own splitter, with handles line breaks the way
Spinx expects. Not using it cause issues at the output files.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
---
Documentation/sphinx/kernel_abi.py | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/Documentation/sphinx/kernel_abi.py b/Documentation/sphinx/kernel_abi.py
index 742ebd35454f..0a4057183208 100644
--- a/Documentation/sphinx/kernel_abi.py
+++ b/Documentation/sphinx/kernel_abi.py
@@ -36,7 +36,7 @@ import os
import re
import sys

-from docutils import nodes
+from docutils import nodes, statemachine
from docutils.statemachine import ViewList
from docutils.parsers.rst import directives, Directive
from sphinx.util.docutils import switch_source_input
@@ -105,7 +105,8 @@ class KernelCmd(Directive):
old_f = fname
n = 0
for msg, f, ln in self.parser.doc():
- msg_list = msg.split("\n")
+ msg_list = statemachine.string2lines(msg, tab_width,
+ convert_whitespace=True)
if "debug" in self.options:
lines = [
"", "", ".. code-block:: rst",
--
2.48.1