Date: Mon, 30 Mar 2026 01:07:33 +0000 (UTC) From: "Alexander Ziaee" <ziaee@FreeBSD.org> To: "Dag-Erling Smørgrav" <des@FreeBSD.org> Cc: "arch" <arch@freebsd.org>, "doc" <doc@freebsd.org>, "ivy" <ivy@freebsd.org>, "kib" <kib@freebsd.org>, "adrian" <adrian@freebsd.org>, "schwarze" <schwarze@usta.de> Subject: Re: man: Merging LIBRARY and SYNOPSIS Message-ID: <E1w716L-0007z4-Qp@rmmprod06.runbox> In-Reply-To: <86bjhhvkuj.fsf@ltc.des.dev>
index | next in thread | previous in thread | raw e-mail
On 2026-02-21 16:37 -05:00 EDT, "Dag-Erling Smørgrav" <des@FreeBSD.org> wrote: > <ziaee@FreeBSD.org> 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, Alexhome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?E1w716L-0007z4-Qp>