From nobody Fri May 15 01:06:12 2026 X-Original-To: dev-commits-src-all@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 4gGptW5NNcz6cTj3; Fri, 15 May 2026 01:06:27 +0000 (UTC) (envelope-from kib@freebsd.org) Received: from kib.kiev.ua (kib.kiev.ua [IPv6:2001:470:d5e7:1::1]) (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 did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4gGptW1p0zz423X; Fri, 15 May 2026 01:06:27 +0000 (UTC) (envelope-from kib@freebsd.org) Authentication-Results: mx1.freebsd.org; none Received: from tom.home (kib@localhost [127.0.0.1] (may be forged)) by kib.kiev.ua (8.18.1/8.18.1) with ESMTP id 64F16COe031860; Fri, 15 May 2026 04:06:15 +0300 (EEST) (envelope-from kib@freebsd.org) DKIM-Filter: OpenDKIM Filter v2.10.3 kib.kiev.ua 64F16COe031860 Received: (from kostik@localhost) by tom.home (8.18.1/8.18.1/Submit) id 64F16CRc031859; Fri, 15 May 2026 04:06:12 +0300 (EEST) (envelope-from kib@freebsd.org) X-Authentication-Warning: tom.home: kostik set sender to kib@freebsd.org using -f Date: Fri, 15 May 2026 04:06:12 +0300 From: Konstantin Belousov To: John Baldwin Cc: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org Subject: Re: git: 8766e2122ac0 - main - mandoc: Updating FreeBSD thead library descriptions Message-ID: References: <6a04a811.3be57.aea6532@gitrepo.freebsd.org> <501769a6-e12b-428d-9dd3-c6764083e578@FreeBSD.org> List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@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=us-ascii Content-Disposition: inline In-Reply-To: <501769a6-e12b-428d-9dd3-c6764083e578@FreeBSD.org> X-Spam-Status: No, score=-2.9 required=5.0 tests=ALL_TRUSTED,BAYES_00 autolearn=ham autolearn_force=no version=4.0.2 X-Spam-Checker-Version: SpamAssassin 4.0.2 (2025-08-27) on tom.home X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:6939, ipnet:2001:470::/32, country:US] X-Rspamd-Queue-Id: 4gGptW1p0zz423X X-Spamd-Bar: ---- X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated On Thu, May 14, 2026 at 02:56:38PM -0400, John Baldwin wrote: > On 5/13/26 22:47, Konstantin Belousov wrote: > > On Wed, May 13, 2026 at 04:34:25PM +0000, John Baldwin wrote: > > > The branch main has been updated by jhb: > > > > > > URL: https://cgit.FreeBSD.org/src/commit/?id=8766e2122ac02ff4d86c254d8ef1c41d4a7f76a0 > > > > > > commit 8766e2122ac02ff4d86c254d8ef1c41d4a7f76a0 > > > Author: John Baldwin > > > AuthorDate: 2026-05-13 16:33:29 +0000 > > > Commit: John Baldwin > > > CommitDate: 2026-05-13 16:33:29 +0000 > > > > > > mandoc: Updating FreeBSD thead library descriptions > > > Remove libkse as it has been obsolete for many years and drop 1:1 from > > > description of libthr. > > > Reviewed by: brooks > > > Sponsored by: AFRL, DARPA > > > Differential Revision: https://reviews.freebsd.org/D56850 > > > --- > > > contrib/mandoc/lib.in | 3 +-- > > > 1 file changed, 1 insertion(+), 2 deletions(-) > > > > > > diff --git a/contrib/mandoc/lib.in b/contrib/mandoc/lib.in > > > index dcea23cf81ea..04d86f9add1e 100644 > > > --- a/contrib/mandoc/lib.in > > > +++ b/contrib/mandoc/lib.in > > > @@ -74,7 +74,6 @@ LINE("libisns", "Internet Storage Name Service Library (libisns, \\-lisns)") > > > LINE("libjail", "Jail Library (libjail, \\-ljail)") > > > LINE("libkcore", "Kernel Memory Core Access Library (libkcore, \\-lkcore)") > > > LINE("libkiconv", "Kernel-side iconv Library (libkiconv, \\-lkiconv)") > > > -LINE("libkse", "N:M Threading Library (libkse, \\-lkse)") > > > LINE("libkvm", "Kernel Data Access Library (libkvm, \\-lkvm)") > > > LINE("libm", "Math Library (libm, \\-lm)") > > > LINE("libm68k", "m68k Architecture Library (libm68k, \\-lm68k)") > > > @@ -126,7 +125,7 @@ LINE("libtacplus", "TACACS+ Client Library (libtacplus, \\-ltacplus)") > > > LINE("libtcplay", "TrueCrypt-compatible API library (libtcplay, \\-ltcplay)") > > > LINE("libtermcap", "Termcap Access Library (libtermcap, \\-ltermcap)") > > > LINE("libterminfo", "Terminal Information Library (libterminfo, \\-lterminfo)") > > > -LINE("libthr", "1:1 Threading Library (libthr, \\-lthr)") > > > +LINE("libthr", "Threading Library (libthr, \\-lthr)") > > Arguably the suggested linker argument should be -lpthread instead. > > I think there is a "libpthread" entry already and we could just use > that in our manpages going forward instead of .Lb libthr which would > have that effect. Actually, .Lib libthr is only used in a few places, > and several of those could either be removed (e.g. the IMPLEMENTATION > NOTES section in pthread(3) can probably just be removed, it was more > relevant when there were multiple libraries) or updated (_umtx_op.2 > can just reference libpthread instead of libthr). We do have libthr(3), and it should not be dropped. The reference from pthread(3) to libthr(3) in its current form IMO makes sense. What I mean is only to stop suggesting in any way to link against libthr.so, instead of libpthread.so. I do not envision that we ever would bump libthr major version number, but libpthread.so might become linker script instead of the symlink. > > It's not clear to me if there is true value in renaming the real > library, though if we ever bump the major version for libthr we should > probably use the opportunity to install it as libpthread for real. > Given it uses symbol versioning it seems unlikely we will ever do that > though. If we really cared we could rename it for 16 I guess. The > compat15 package would just need to contain libthr.so.3. I am only about man pages.