One of the things I liked about Mark Rochkind's original "Advanced UNIX Programming" book was that he not only provided examples of what to do, but also examples of what NOT to do, like failing to close the write end of a pipe in a child that expects to read input. I'm not sure manual pages are the right place for this sort of thing, but it certainly is valuable.

On Thu, Sep 21, 2023 at 12:10 AM Wesley Parish <wobblygong@gmail.com> wrote:

On 21/09/23 10:31, Dave Horsfall wrote:
> On Wed, 20 Sep 2023, Larry McVoy wrote:
>
> [...]
>
>> I like examples in man pages, I think it jump starts you into using the
>> program more easily but maybe that's just me.
> No, it's not just you :-)
>
> -- Dave

Seconded. IDK when I was learning Linux, how many times I would've been
unable to follow the reference in the Linux man pages without a
reference example or more to show me how I could do it myself.

Wesley Parish