From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E7D9C2459EA; Wed, 25 Mar 2026 19:23:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.79.88.28 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774466616; cv=none; b=EpqzF2FVjOi1W++G2H0HGeRBdrd0y/l1M53QJGY6oulcv7mWGzFGLWfxwccym6jZOvxHsILvAMKD/f5WifGJuJP9YwCR4F2PpImTAyrKqPw8ssmlCH3bjSoveoJdNiuaCflVTSJmDhnT1PVAdpAO2vElfgrn7h2lL5lFP1GXWDE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774466616; c=relaxed/simple; bh=+L8wi6kyHthm4KaOrAYDops3HeciAMFCYqrPNjpJA+s=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=hG9w/xgaaOq1rhgi/i2MpMJV/NVMeiZesdk/QRKzHmeHIOVNZXGEyCCZNhryUX7LxZ6BJ1H6jfbM47Lja8tTazkd9ukeaebr+bMhWDsXU9xgcFhSnCTUUdX6w0Sf9Ayvvimm2ZjJGge8RNeCbEpGMvikLePjz2ResgP2OCyHnXA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net; spf=pass smtp.mailfrom=lwn.net; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=AykulBIK; arc=none smtp.client-ip=45.79.88.28 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lwn.net Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="AykulBIK" DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 2FFF540C6F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1774466614; bh=wieBmyn6zy83Upz01fxLFWq9zlqS4iXUVwJYPV21W3I=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=AykulBIKbNjUr1f/OH9ffsmp57nDta8YJsqT6QQ9AC17XQZHMt6V7pql2ZNshAxk4 F4ayDgBm+Zj84UKjMl5BtTG+rqtQTVuZw/dPHYqi4TNWx3Fol9x0fB+L1iG3FgEoAo wpv87AARr/hexQWbEQEL8lpWipqp7M61FZ6oIzAJgRqyY0y73I7ESOqRJWJPyGJD9T XQwZzHSFZZPGUJtEnywx2RPocYXq87F+UTEXr2hFECrk4557B6P30nnz3V8fv71i1b 8qV8nyHfvNaKBWz5zkUWtt/cn5Ri4Hf+U0u7MhPF+w/4HBFs1PlkW/qaLUE/KyrrUe ZamQ7NiRrpImQ== Received: from localhost (unknown [IPv6:2601:280:4600:27b::1fe]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 2FFF540C6F; Wed, 25 Mar 2026 19:23:34 +0000 (UTC) From: Jonathan Corbet To: Rito Rhymes , linux-doc@vger.kernel.org Cc: Shuah Khan , linux-kernel@vger.kernel.org, rdunlap@infradead.org, Rito Rhymes Subject: Re: [PATCH v3] docs: allow inline literals in paragraphs to wrap to prevent overflow In-Reply-To: <20260323151401.27415-1-rito@ritovision.com> References: <20260321141118.23828-1-rito@ritovision.com> <20260323151401.27415-1-rito@ritovision.com> Date: Wed, 25 Mar 2026 13:23:33 -0600 Message-ID: <87bjgbg1ca.fsf@trenco.lwn.net> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Rito Rhymes writes: > 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 > Assisted-by: Codex:GPT-5.4 > --- > v3: add latest public versioned URL examples to the patchlog > > Documentation/sphinx-static/custom.css | 9 +++++++++ > 1 file changed, 9 insertions(+) I have applied this one as well. Thanks, jon