Documentation/sphinx-static/custom.css | 10 ++++++++++ 1 file changed, 10 insertions(+)
Patch 1 allows long link text to wrap per character so unbroken links in the main document body do not force page-wide horizontal scroll overflow. Patch 2 remains necessary for rendered reference links inside docutils tables, where the affected table case still needs an explicit selector to keep the table within the content column. Some of these pages may also overflow for other reasons, but the examples listed under [2/2] specifically include tables containing long reference links that may still need a table-specific CSS rule to keep the table within the content column. Examples of affected pages on docs.kernel.org this patch improves: [1/2] firmware-guide/acpi/non-d0-probe.html firmware-guide/acpi/lpit.html arch/arm/vlocks.html arch/arm/keystone/overview.html arch/arm/keystone/knav-qmss.html arch/loongarch/introduction.html arch/nios2/nios2.html arch/x86/earlyprintk.html arch/x86/orc-unwinder.html#etymology arch/x86/tdx.html arch/x86/sva.html driver-api/xilinx/eemi.html [2/2] arch/openrisc/openrisc_port.html power/apm-acpi.html networking/devlink/stmmac.html filesystems/ext2.html networking/l2tp.html process/embargoed-hardware-issues.html arch/x86/boot.html networking/devlink/devlink-info.html admin-guide/sysctl/fs.html userspace-api/ioctl/ioctl-number.html Rito Rhymes (2): docs: allow long links to wrap per character to prevent page overflow docs: allow long table reference links to wrap and prevent overflow Documentation/sphinx-static/custom.css | 10 ++++++++++ 1 file changed, 10 insertions(+) -- 2.51.0
Patch 1 allows long link text to wrap per character so unbroken links in the main document body do not force page-wide horizontal scroll overflow. Patch 2 remains necessary for rendered reference links inside docutils tables, where the affected table case still needs an explicit selector to keep the table within the content column. Some of these pages may also overflow for other reasons, but the examples listed under [2/2] specifically include tables containing long reference links that may still need a table-specific CSS rule to keep the table within the content column. Examples of affected pages on docs.kernel.org this patch improves: [1/2] firmware-guide/acpi/non-d0-probe.html firmware-guide/acpi/lpit.html arch/arm/vlocks.html arch/arm/keystone/overview.html arch/arm/keystone/knav-qmss.html arch/loongarch/introduction.html arch/nios2/nios2.html arch/x86/earlyprintk.html arch/x86/orc-unwinder.html#etymology arch/x86/tdx.html arch/x86/sva.html driver-api/xilinx/eemi.html [2/2] arch/openrisc/openrisc_port.html power/apm-acpi.html networking/devlink/stmmac.html filesystems/ext2.html networking/l2tp.html process/embargoed-hardware-issues.html arch/x86/boot.html networking/devlink/devlink-info.html admin-guide/sysctl/fs.html userspace-api/ioctl/ioctl-number.html Rito Rhymes (2): docs: allow long links to wrap per character to prevent page overflow docs: allow long table reference links to wrap and prevent overflow Documentation/sphinx-static/custom.css | 10 ++++++++++ 1 file changed, 10 insertions(+) -- 2.51.0
Some documentation pages contain long link text without natural
break points, which can force page-wide horizontal scroll overflow
on small screens.
Use overflow-wrap: anywhere for anchor text in the docs stylesheet so
links can wrap per character as a fallback when normal word boundaries
are unavailable.
Signed-off-by: Rito Rhymes <rito@ritovision.com>
Assisted-by: Codex:GPT-5.4
---
v2: add Assisted-by attribution
Documentation/sphinx-static/custom.css | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Documentation/sphinx-static/custom.css b/Documentation/sphinx-static/custom.css
index db24f4344..4ec617d40 100644
--- a/Documentation/sphinx-static/custom.css
+++ b/Documentation/sphinx-static/custom.css
@@ -149,6 +149,11 @@ div.language-selection ul li:hover {
background: #dddddd;
}
+/* Let long link text wrap instead of forcing overflow. */
+a {
+ overflow-wrap: anywhere;
+}
+
/* Make xrefs more universally visible */
a.reference, a.reference:hover {
border-bottom: none;
--
2.51.0Some documentation pages contain docutils tables with reference links
that use long unbroken strings. Those strings can expand the table
width beyond the content column and cause page-wide horizontal
overflow.
Allow reference links in docutils tables in the main document body to
wrap when needed so the table stays within the content column and does
not break page layout.
Signed-off-by: Rito Rhymes <rito@ritovision.com>
Assisted-by: Codex:GPT-5.4
---
v2: add Assisted-by attribution
Documentation/sphinx-static/custom.css | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Documentation/sphinx-static/custom.css b/Documentation/sphinx-static/custom.css
index 4ec617d40..b41c54c71 100644
--- a/Documentation/sphinx-static/custom.css
+++ b/Documentation/sphinx-static/custom.css
@@ -154,6 +154,11 @@ a {
overflow-wrap: anywhere;
}
+/* Let rendered reference links in tables wrap when needed. */
+div.body table.docutils a.reference {
+ overflow-wrap: anywhere;
+}
+
/* Make xrefs more universally visible */
a.reference, a.reference:hover {
border-bottom: none;
--
2.51.0© 2016 - 2026 Red Hat, Inc.