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

["G. Branden Robinson" <g.branden.robinson@gmail.com>]

[-- Attachment #1.1: Type: text/plain, Size: 1281 bytes --]

[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

[-- Attachment #1.2: groff_man_style.7.pdf --]
[-- Type: application/pdf, Size: 158597 bytes --]

[-- Attachment #1.3: groff_man_style.7.man --]
[-- Type: application/x-troff-man, Size: 95744 bytes --]

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]