Learning man(7) (was: fork(2), _Fork(), POSIX.1-2024, and AS-safety)

[G. Branden Robinson]

[shameless promotion of (in part) my own work follows]

At 2025-05-17T21:16:34+0200, Alejandro Colomar wrote:
> > Next time I will remember to remind you on
> > linux-man@vger.kernel.org. I would offer to do the patch myself, but
> > I don't know roff. :)
> 
> I don't know roff either.  :)
> 
> But man(7) is pretty easy.  I learnt by editing existing text, which
> for a beginner is much easier than writing from scratch.  Just imitate
> what you see in the surroundings.

I've tried hard over the past several years to make man(7) easy to
acquire.  I'm attaching a PDF of the groff_man_style(7) man page
(rendered with the forthcoming groff 1.24), which attempts the
oft-questioned objective of serving as both tutorial and a reference.
I seldom receive feedback on it, which means either that it's flawless
or no one reads it.

I'm also attaching the page source, which on Debian-based systems at
least, should fire up gxditview(1) to view the page from neomutt(1).
(However, changes to the `SY` and `YS` macros in the forthcoming release
mean that a couple of spurious blank lines will appear in two places,
unless your installed groff happens to be from the Git trunk.)

I welcome a critical review of the document's contents.

Regards,
Branden
-------------- next part --------------
A non-text attachment was scrubbed...
Name: groff_man_style.7.pdf
Type: application/pdf
Size: 158597 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/libc-alpha/attachments/20250517/c9c733bc/attachment-0001.pdf>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: groff_man_style.7.man
Type: application/x-troff-man
Size: 91109 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/libc-alpha/attachments/20250517/c9c733bc/attachment-0001.man>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/libc-alpha/attachments/20250517/c9c733bc/attachment-0001.sig>