Re: [PATCH v3 2/2] docs: allow long table reference links to wrap and prevent overflow

[Randy Dunlap]

On 3/23/26 8:24 AM, Rito Rhymes wrote:
> Some 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.
> 
> Examples:
>   https://docs.kernel.org/6.15/arch/openrisc/openrisc_port.html
>   https://docs.kernel.org/6.15/filesystems/ext2.html
> 
> Signed-off-by: Rito Rhymes <rito@xxxxxxxxxxxxxx>
> Assisted-by: Codex:GPT-5.4

Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Acked-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>

thanks.

> ---
> v3: add latest public versioned URL examples to the patchlog
> 
>  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;

-- 
~Randy