]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
docs: contain horizontal overflow in C API descriptions
authorRito Rhymes <rito@ritovision.com>
Mon, 23 Mar 2026 15:33:42 +0000 (11:33 -0400)
committerJonathan Corbet <corbet@lwn.net>
Wed, 25 Mar 2026 19:17:13 +0000 (13:17 -0600)
commit3aff388bc4e8d64583d144f3be9c0aff9a54f14d
tree1410c31418ed479b61ce3a43692376e9fe10c5d3
parentf2679ac773899f5fdea0b68d5077eef5f88dfd42
docs: contain horizontal overflow in C API descriptions

Some documentation pages contain long C API signatures that can exceed
the content width and cause page-wide horizontal scroll overflow.

Apply contained horizontal scrolling to C API description blocks and
keep their signature rows on one line. This preserves signature
formatting while preventing them from breaking page layout.

Contained horizontal scrolling is preferred over wrapping here because
code fidelity is the priority. These blocks are intended to remain
representative of the code itself. Wrapping distorts spacing and line
structure, which affects fidelity, creates misleading renderings, and
reduces readability.

Examples:
  https://docs.kernel.org/6.15/driver-api/regulator.html
  https://docs.kernel.org/6.15/userspace-api/fwctl/fwctl-cxl.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: <20260323153342.33447-1-rito@ritovision.com>
Documentation/sphinx-static/custom.css