Re: man/man8/ldconfig.8: document system-wide tunables

"G. Branden Robinson" <[email protected]> Mon, 13 Jul 2026 17:22:34 -0500

Newsgroups	org.kernel.vger.linux-man
Message-ID	<20260713222234.h3efoiaq3jsakk6s@illithid>

At 2026-07-13T17:33:05-0400, DJ Delorie wrote:
> Alejandro Colomar <[email protected]> writes:
> > Please split into separate patches with commit messages,
> 
> How do you want them split?  Per man page, or one for breaking out
> ld.so.conf and one for adding tunables.conf?
> 
> Also, I've been using the output of "git show" for these patches.
> 
> > Let's start a new paragraph:
> >
> > 	.P
> 
> We still need a better language ;-) ("why doesn't it know to start a
> paragraph after a heading?" ;)

It does.

groff_man(7):

     .SH [heading‐text]
            Set heading‐text as a section heading.  Given no argument,
            SH plants a one‐line input trap; text on the next line
            becomes heading‐text.  The heading text is set in bold (or
            the font specified by the string HF), and, on typesetters,
            slightly larger than the base type size.  If the heading
            font \*[HF] is bold, use of an italic style in heading‐text
            is mapped to the bold‐italic style if available in the font
            family.  The inset level is reset to 1; see subsection
            “Horizontal and vertical spacing” below.  Text lines after
                                                      ^^^^^^^^^^^^^^^^
            the call are set as an ordinary paragraph (P).
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

> > You should indent this compared to the surrounding text:
> >
> > 	.IP
> > 	.in +4n
> 
> Isn't that what the .IP does ?

There were difficulties, some imposed by the previous Linux man-pages
maintainer, Michael Kerrisk.

https://lore.kernel.org/linux-man/[email protected]/

The better language that doesn't yet exist would, of course, solve all
of everyone's problems at once, even the problems that are mutually
exclude each other's solutions.

Regards,
Branden

signature.asc (application/pgp-signature, 833 B)