From nobody Thu Aug 6 22:32:05 2026 X-Original-To: dev-commits-src-branches@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 4hGMTf3fBcz6nLf8 for ; Thu, 06 Aug 2026 22:32:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hGMTd3xg3z4Pp8 for ; Thu, 06 Aug 2026 22:32:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1786055525; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=YOBnGR8LvnV4+CFCZn/bPDImCrnaixzWRv35Q+FcuUo=; b=kpXhw0yuZbRtEhrNuxyAOOl5meUwLqf3zr8zjNIZsCibKH9XTlDAkumHYIIVMwfAA4AsfE CJlwIj84QMAQ2HuV0HW07v1Xc4EDxC5RtZvjbMOPt22wjzqjKLY3CElid6mxkNOCgy9pmX XoZP3oPkkLDevPOwlJZhio8vIlne8fNYzKypBNY8exKxX5cYyWXLur+VlP2JIFURW5rt43 B0PjUfVdLAjcerwq0hiLeCqrJrGIOFHNNqRzPs89As60oTwToNzYVfLzt2+DFoDFDTcLHm npuM8RlRIJM8lPnjVZy2Ph65VnL/3AGZUjvAlIEZGyGW3NwG+LFRdxLmQvVPkQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1786055525; a=rsa-sha256; cv=none; b=Y8xT9pL7rPUzQN8s/hofm9ogwcuMrYHxkxyVySgQuoGKNvzRDuv6YLuSBKB3tjm1CuBd48 +3pH3KPnlVOasHW6rSharO4n3355TdqbkUoNEoBgAwQ22DxTlAuZsE5MeWcYf9oVSTeVCB 0xXdKjvVWS9p1E/jOnaghU2rF+LRSEhP7brdU1P4Zn/d+RQ3xEqLvHQEGw2IDDnJ9dWAdh IbWOG4W6wOaMUKacwk0svYUeUiRbvV2UT+noWT3ax67G/ILrURGhUdhEP84B43kUozUSWx G+6pQLR3mhmBx+cD+g9LLYOelP+r0DoKARRNlBiqJm74a+36X3GJ1GzHocGs1A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1786055525; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=YOBnGR8LvnV4+CFCZn/bPDImCrnaixzWRv35Q+FcuUo=; b=b/pB/IhiO7S0B3JHskwkVxDirWZjtbAp+dGVm+CYloAdRLYQhHHaxwYGN6PUbs0Vr/FQh8 giaYBJuK4LiATk69ClRmB5KV5y4ewb7S09DxfdppKABa1cPkvDlEAhijFOgBvWuUN/EbGV jHdgytbl4jUVBW5uDS23x0TYDIIQYAG4vLJ1c3SLBoltj1ZE+O+2oK7cK+imRy4sLlEMIA W6cwhVhxUC5R0x7XyYCXhIfECORv0BmN/S7PfRY0g3h+KX3/PJ7sgoQl1/xbE0S1XEqGIl nS/ARTIWWUyH8A84eNuDYrFmoc+8GqPnrlcIieO/GU/OAtColNUrLYY81drj+w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hGMTd2wWfzh1c for ; Thu, 06 Aug 2026 22:32:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 1fcd0 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 06 Aug 2026 22:32:05 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 4f3662233a0c - stable/14 - mdoc.7: Revert upstream changes to Lb/LIBRARY List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 4f3662233a0c7a4ed328a008b913e87ec0421295 Auto-Submitted: auto-generated Date: Thu, 06 Aug 2026 22:32:05 +0000 Message-Id: <6a750b65.1fcd0.56d97efc@gitrepo.freebsd.org> The branch stable/14 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=4f3662233a0c7a4ed328a008b913e87ec0421295 commit 4f3662233a0c7a4ed328a008b913e87ec0421295 Author: Alexander Ziaee AuthorDate: 2026-05-22 18:09:23 +0000 Commit: Alexander Ziaee CommitDate: 2026-08-06 22:28:49 +0000 mdoc.7: Revert upstream changes to Lb/LIBRARY Since this manual describes the mdoc syntax throughout the ecosystem, I had to blend what we had before with what upstream is doing now. Thanks: adrian MFC after: 3 days (we shipped this doc in 15.0/14.4) Reviewed by: ivy, mhorne, des, adrian Discussed with: arch@ Differential Revision: https://reviews.freebsd.org/D56153 (cherry picked from commit 4e2bf6e90a65bee317e4dd379e098ba2eb5d8c0d) --- contrib/mandoc/mdoc.7 | 37 +++++++++++++++++++++++++++++++++---- 1 file changed, 33 insertions(+), 4 deletions(-) diff --git a/contrib/mandoc/mdoc.7 b/contrib/mandoc/mdoc.7 index 6c2d3568baa6..03bceadbeba5 100644 --- a/contrib/mandoc/mdoc.7 +++ b/contrib/mandoc/mdoc.7 @@ -196,8 +196,14 @@ and .Ic \&Nd . .It Em LIBRARY The name of the library containing the documented functions. -Using this section is no longer recommended. -If any +The syntax for this is as follows: +.Bd -literal -offset indent +\&.Lb libm +.Ed +.Pp +Using this section is no longer recommended outside +.Fx . +If writing for other operating systems, and any .Ic \&Lb macro is needed, put it at the beginning of the .Em SYNOPSIS @@ -223,7 +229,7 @@ Commands should be ordered alphabetically. .Pp For the second, function calls (sections 2, 3, 9): .Bd -literal -offset indent -\&.Lb libname \e" unless the functions are in libc +\&.Lb libname \e" unless on FreeBSD or the functions are in libc \&.In header.h \&.Vt extern const char *global; \&.Ft char * @@ -1880,7 +1886,30 @@ See also .Tg Lb .It Ic \&Lb Cm lib Ns Ar name Op Cm lib Ns Ar name ... Specify one or more libraries to link against. -Putting this macro at the beginning of the +.Pp +If used in the +.Em LIBRARY +section, the +.Ar name +parameter may be a system library, such as +.Cm z +or +.Cm pam , +in which case a small library description is printed next to the linker +invocation; or a custom library, in which case the library name is +printed in quotes. +This is most commonly used in the +.Em LIBRARY +or +.Em SYNOPSIS +sections, as described in +.Sx MANUAL STRUCTURE. +.Pp +Examples: +.Dl \&.Lb libz +.Dl \&.Lb libmandoc +.Pp +In other operating systems, putting this macro at the beginning of the .Em SYNOPSIS section is recommended, in which case it prints this comment: .D1 /* Fl l Ns Ar name Oo Fl l Ns Ar name ... Oc */