From nobody Wed Jun 25 19:09:23 2025 X-Original-To: current@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 4bSBFv4gmpz60P9t for ; Wed, 25 Jun 2025 19:09:39 +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 4bSBFv1g1hz3dff for ; Wed, 25 Jun 2025 19:09:39 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Authentication-Results: mx1.freebsd.org; dkim=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; dmarc=fail reason="No valid SPF, No valid DKIM" header.from=freebsd.org (policy=none) Received: from mailtransmit02.runbox ([10.9.9.162] 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 1uUVV4-00F1PH-8P for current@freebsd.org; Wed, 25 Jun 2025 21:09:38 +0200 Received: from [10.9.9.73] (helo=submission02.runbox) by mailtransmit02.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1uUVV3-00088T-Uk for current@freebsd.org; Wed, 25 Jun 2025 21:09:38 +0200 Received: by submission02.runbox with esmtpsa [Authenticated ID (960477)] (TLS1.2:ECDHE_SECP256R1__RSA_PSS_RSAE_SHA256__AES_256_GCM:256) (Exim 4.93) id 1uUVUr-006FlU-Id for current@freebsd.org; Wed, 25 Jun 2025 21:09:25 +0200 Received: from ziaee (uid 1001) (envelope-from ziaee@FreeBSD.org) id 2870a by baud (DragonFly Mail Agent v0.13+ on baud); Wed, 25 Jun 2025 15:09:23 -0400 To: current@freebsd.org, doc@freebsd.org, hackers@freebsd.org Subject: Heads up: LIBRARY is deprecated in manuals Date: Wed, 25 Jun 2025 15:09:23 -0400 Message-Id: <685c4963.2870a.14aaa2cf@baud> From: X-Spamd-Result: default: False [2.97 / 15.00]; NEURAL_SPAM_MEDIUM(0.98)[0.976]; NEURAL_SPAM_SHORT(0.88)[0.878]; NEURAL_SPAM_LONG(0.72)[0.719]; MID_RHS_NOT_FQDN(0.50)[]; RCVD_IN_DNSWL_LOW(-0.10)[2a0c:5a00:149::26:from]; MIME_GOOD(-0.10)[text/plain]; DMARC_POLICY_SOFTFAIL(0.10)[freebsd.org : No valid SPF, No valid DKIM,none]; ARC_NA(0.00)[]; FROM_NO_DN(0.00)[]; FREEFALL_USER(0.00)[ziaee]; MIME_TRACE(0.00)[0:+]; MISSING_XM_UA(0.00)[]; ASN(0.00)[asn:50304, ipnet:2a0c:5a00::/29, country:NO]; RCVD_VIA_SMTP_AUTH(0.00)[]; R_DKIM_NA(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; TO_DN_NONE(0.00)[]; R_SPF_SOFTFAIL(0.00)[~all:c]; FROM_EQ_ENVFROM(0.00)[]; TO_MATCH_ENVRCPT_SOME(0.00)[]; RCVD_COUNT_THREE(0.00)[4]; RCVD_TLS_LAST(0.00)[]; MLMMJ_DEST(0.00)[current@freebsd.org] X-Rspamd-Queue-Id: 4bSBFv1g1hz3dff X-Spamd-Bar: ++ List-Id: Discussions about the use of FreeBSD-current List-Archive: https://lists.freebsd.org/archives/freebsd-current List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-current@FreeBSD.org Hello, Today's mandoc update in CURRENT [0] comes with two changes for writing library manuals: The library macro, Lb, is now to be used in SYONPSIS for brevity, where it renders as a C-style comment. The LIBRARY section is now deprecated for new manuals. The function type macro, Ft, has been overhauled, allowing for multiple arguments. It can, but should not be quoted. Both changes are reflected in the mdoc(7) manual and should produce no change in existing manuals. [0]: 4c07abdbacf4 (mandoc: Vendor import of upstream at 2025-06-13) Best, Alex