Re: [PATCH 08/42] doc: improve formatting of command synopses (1/2)

"G. Branden Robinson" <[email protected]> Sun, 28 Dec 2025 17:06:37 -0600

Newsgroups	gmane.comp.gnu.findutils.bugs
Message-ID	<20251228230637.og63wangzskak2b3@illithid>

At 2025-12-28T23:42:27+0100, Bernhard Voelker wrote:
> On 12/28/25 23:26, Bernhard Voelker wrote:
> > On 11/19/25 04:45, G. Branden Robinson wrote:
> > > diff --git a/find/find.1 b/find/find.1
> > > [...]
> > >    .SH SYNOPSIS
> > > +.HP
> > 
> > This triggers a 'make check' error:
> > 
> >     env GROFF=groff ../build-aux/man-lint.sh . find.1
> >     check_manpages_format_without_error_messages  (         find.1): OK
> >     check_manpages_with_groff_checkstyle_2        (         find.1): FAILED
> >     an.tmac:./find.1:23: style: use of deprecated macro: .HP
> >     make[3]: *** [Makefile:3112: findutils-check-manpages] Error 1
> > 
> > Should we replace .HP by a simple .P?
> > Or better just remove it?
> 
> According to groff_man_style(7), the better replacement seems to be .TP,
> which also caters better for the hanging indentation of the lines
> following ...

Okay.  We can revisit the issue, maybe, after I manage to get groff
1.24.0 released.  I have my fingers crossed that the Savannah bug
tracker comes back up soon...

Regards,
Branden

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