From: "Omar Polo" <op@omarpolo.com>
Subject: Re: stat.1: assorted mdoc fixes
To: Christian Weisgerber <naddy@mips.inka.de>
Cc: tech@openbsd.org, Ingo Schwarze <schwarze@openbsd.org>
Date: Tue, 27 Oct 2026 19:33:15 +0100

Christian Weisgerber <naddy@mips.inka.de> wrote:
> While trying to make sense of stat(1), I noticed first some weird
> markup in the man page, and then that FreeBSD had already improved
> on it.  The following is mostly taken from
> https://cgit.freebsd.org/src/commit/usr.bin/stat/stat.1?id=f937c268cf95bb650f455bac678bcf1c83bb90e7
> 
> Further tweaks?  OK?

looks correct to me; ok op@ fwiw.  just one nit:

> [...]
> @@ -133,14 +146,15 @@ passed directly to
>  .It Fl x
>  Display information in a more verbose way.
>  .El
> -.Ss FORMATS
> +.Ss Formats
>  Format strings are similar to
>  .Xr printf 3
>  formats in that they start with
>  .Cm % ,
>  are then followed by a sequence of formatting characters, and end in
> -a character that selects the field of the struct stat which is to be
> -formatted.
> +a character that selects the field of the
> +.Vt "struct stat

I'd terminate this quoting, as man -Tlint reports, too.

> +which is to be formatted.
>  If the
>  .Cm %
>  is immediately followed by one of