On 2026-02-21 16:37 -05:00 EDT, "Dag-Erling Smørgrav" <[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. > > 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 what 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
