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

On 01/03/26 11:25, Benno Schulenberg wrote:
> 
> 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.)

Oh, sorry - I now realize I misunderstood the original e-mail. It is 
embarassing; I should have double-checked things, namely the syntax 
(which I overlooked in part because I *still* need to configure Gnus - 
where I usually read this list - not to eat some of the characters when 
applying formatting...).

That'd have probably made the meaning obvious. Instead, not being 
acquainted with the syntax, I wrongly intepreted the commit message as 
you meaning angle brackets would be removed because they mean/generate 
italic.


-- 
Apologies again,
Nuno Silva