From: Job Snijders <job@openbsd.org>
Subject: Re: pthread man.3 inode conservation
To: Theo Buehler <tb@theobuehler.org>
Cc: Ted Unangst <tedu@tedunangst.com>, tech@openbsd.org
Date: Sat, 21 Jun 2025 08:24:14 +0000

On Sat, Jun 21, 2025 at 06:46:35AM +0200, Theo Buehler wrote:
> 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.

I agree, the one sentence man pages weren't all that helpful.

I'd still like to add somewhere an elucidation that condition variables
are used together with mutes, as (for me as novice) that made things
'click'.

> > Starting with condition variables.
> 
> pthreads.3 has about the same .Xr to remove as pthread_cond_init.3