]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
docs: allow inline literals in paragraphs to wrap to prevent overflow
authorRito Rhymes <rito@ritovision.com>
Mon, 23 Mar 2026 15:14:01 +0000 (11:14 -0400)
committerJonathan Corbet <corbet@lwn.net>
Wed, 25 Mar 2026 19:16:58 +0000 (13:16 -0600)
commitf2679ac773899f5fdea0b68d5077eef5f88dfd42
tree6da942761eb5f5559e61fdc5ed347d58a6ba47fa
parent19dcccbc064d6c58eaafae1ecb94821a2535cc26
docs: allow inline literals in paragraphs to wrap to prevent overflow

Some documentation pages contain long inline literals in paragraph
text that can force page-wide horizontal scroll overflow and break
layout on smaller screens.

Override the default `span.pre` white-space behavior for inline
literals and use `overflow-wrap: anywhere` so they can wrap when
needed. For code used as part of a paragraph, wrapping is appropriate
because it is stylistically part of the surrounding text. Code blocks,
by contrast, are meant to preserve formatting fidelity and are better
served by contained horizontal scrolling.

Examples:
  https://docs.kernel.org/6.15/userspace-api/futex2.html
  https://docs.kernel.org/6.15/security/IMA-templates.html

Signed-off-by: Rito Rhymes <rito@ritovision.com>
Assisted-by: Codex:GPT-5.4
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20260323151401.27415-1-rito@ritovision.com>
Documentation/sphinx-static/custom.css