From: Theo Buehler <tb@theobuehler.org>
Subject: Re: pthread man.3 inode conservation
To: Ted Unangst <tedu@tedunangst.com>
Cc: tech@openbsd.org
Date: Sat, 21 Jun 2025 06:46:35 +0200

On Sat, Jun 21, 2025 at 12:26:05AM -0400, Ted Unangst wrote:
> How about this? There's a lot of one sentence man pages in libpthread,
> which I think are probably not very useful. It's a lackluster experience
> having to read four or five different man pages just to use a condition
> variable. Why isn't this all in one place?

Yes, it's super easy to lose track of what one's looking for in all the
boring boiler plate.

> This diff more or less mechanically combines the pages. I think a bit more
> narrative structure can be added, but at least you can get some idea of what
> these functions are for and how they work together in a single page now.

I like this direction. The result is still a rather short manual and if
someone wants to add more meat it will still be a while until it is fat.

> Starting with condition variables.

pthreads.3 has about the same .Xr to remove as pthread_cond_init.3