Re: [PATCH] findfs: (man) improve the markup, the layout, and the wording

Benno Schulenberg <[email protected]> Sun, 1 Mar 2026 12:25:48 +0100

Newsgroups	org.kernel.vger.util-linux
Message-ID	<[email protected]>

Op 28-02-2026 om 14:03 schreef Nuno Silva:
> On 2026-02-28, Benno Schulenberg wrote:
>> Drop the angle brackets around placeholders -- those are used
>> in --help output, but in man pages it is just italics.
> 
> My apologies if I'm missing some convention from util-linux itself,

Have a look at some other util-linux man pages.  They all use just
italics for placeholders (normally displayed as underline).

> from a quick check, it looks to me that italics is used for such
> placeholders in IEEE 1003.1.

And italics is exactly what this patch uses for placeholders.  (Not
angle brackets -- those are for --help texts.)

Benno

OpenPGP_signature.asc (application/pgp-signature, 840 B)