Re: man: Merging LIBRARY and SYNOPSIS

On 2026-02-21 16:37 -05:00 EDT, "Dag-Erling Sm=C3=B8rgrav" <[email protected]=
> wrote:
> <[email protected]> writes:
>> i want to merge the library section into the synopsis section in the
>> rest of our manuals, [...] so far kib and ivy said they didn't really
>> like it but neither objected.
>=20
> Sorry but I'm going to have to agree with Konstantin and Lexi.  The
> result looks awful on the terminal, and I can only imagine it looks even
> worse on paper.

Okay, this leaves our mdoc(7) broken. We have two options to correct this. =
We can:

1. Diverge from mandoc and groff to recommend authors in our ecosystem do w=
hat we were doing before, patch below.
2. Align with upstream and switch our manuals over

It sounds like we want #1, so here is a review to do that:

https://reviews.freebsd.org/D56153

Best,
Alex=