Re: git: 8766e2122ac0 - main - mandoc: Updating FreeBSD thead library descriptions

[John Baldwin]

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 <j...@freebsd.org>
AuthorDate: 2026-05-13 16:33:29 +0000
Commit:     John Baldwin <j...@freebsd.org>
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).

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.

--
John Baldwin