From nobody Mon Mar 30 01:07:33 2026 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4fkY5G5k1Dz6XnJk for ; Mon, 30 Mar 2026 01:07:46 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Received: from mailtransmit05.runbox.com (mailtransmit05.runbox.com [IPv6:2a0c:5a00:149::26]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4fkY5F6xLWz3P7B; Mon, 30 Mar 2026 01:07:45 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=fail reason="No valid SPF, No valid DKIM" header.from=freebsd.org (policy=none); spf=softfail (mx1.freebsd.org: 2a0c:5a00:149::26 is neither permitted nor denied by domain of ziaee@FreeBSD.org) smtp.mailfrom=ziaee@FreeBSD.org Received: from mailtransmit03.runbox ([10.9.9.163] helo=aibo.runbox.com) by mailtransmit05.runbox.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1w716R-00GQ6H-CB; Mon, 30 Mar 2026 03:07:39 +0200 Received: from [10.9.9.128] (helo=rmmprod06.runbox) by mailtransmit03.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1w716L-0003EI-Sd; Mon, 30 Mar 2026 03:07:34 +0200 Received: from mail by rmmprod06.runbox with local (Exim 4.86_2) (envelope-from ) id 1w716L-0007z4-Qp; Mon, 30 Mar 2026 03:07:33 +0200 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@FreeBSD.org MIME-Version: 1.0 Received: from [Authenticated alias (960477)] by runbox.com with http (RMM6); Mon, 30 Mar 2026 01:07:33 GMT From: "Alexander Ziaee" To: "Dag-Erling Smørgrav" CC: "arch" , "doc" , "ivy" , "kib" , "adrian" , "schwarze" Subject: Re: man: Merging LIBRARY and SYNOPSIS Date: Mon, 30 Mar 2026 01:07:33 +0000 (UTC) X-RMM-Aliasid: 960477 X-Mailer: RMM6 In-Reply-To: <86bjhhvkuj.fsf@ltc.des.dev> Message-Id: X-Spamd-Result: default: False [-2.01 / 15.00]; TO_NEEDS_ENCODING(1.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_LONG(-1.00)[-0.997]; NEURAL_HAM_SHORT(-0.92)[-0.916]; MIME_GOOD(-0.10)[text/plain]; RCVD_IN_DNSWL_LOW(-0.10)[2a0c:5a00:149::26:from]; DMARC_POLICY_SOFTFAIL(0.10)[freebsd.org : No valid SPF, No valid DKIM,none]; ASN(0.00)[asn:50304, ipnet:2a0c:5a00::/29, country:NO]; FREEFALL_USER(0.00)[ziaee]; ARC_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; RCPT_COUNT_SEVEN(0.00)[7]; MLMMJ_DEST(0.00)[doc@freebsd.org]; RCVD_COUNT_THREE(0.00)[4]; R_SPF_SOFTFAIL(0.00)[~all:c]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; TO_MATCH_ENVRCPT_SOME(0.00)[]; RCVD_TLS_LAST(0.00)[]; TO_DN_ALL(0.00)[]; FROM_HAS_DN(0.00)[] X-Rspamd-Queue-Id: 4fkY5F6xLWz3P7B X-Spamd-Bar: -- On 2026-02-21 16:37 -05:00 EDT, "Dag-Erling Sm=C3=B8rgrav" wrote: > 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=