Re: [PATCH 08/42] doc: improve formatting of command synopses (1/2)

"G. Branden Robinson" <[email protected]> Thu, 1 Jan 2026 00:39:44 -0600
Newsgroups gmane.comp.gnu.findutils.bugs
Message-ID <20260101063944.ckbwnyyf73udk6et@illithid>
Hi Bernhard,

Following up on my own message...

At 2025-12-30T17:47:43-0600, G. Branden Robinson wrote:
> (One _can_ specify the indentation that a `TP` paragraph uses, but
> this can be tedious to maintain,[2] so neither I nor mandoc(1)
> maintainer Ingo Schwarze recommend it.)
[...]
> [2] I can't find it right now, I had an exchange with Alex Colomar,
>     Linux man-pages project maintainer, on this topic some years ago.
>     In so doing I managed to dream up a sequence of text layout
>     problems, solutions, and further problems that may have resembled
>     those that drove Mike Lesk's development of the tbl(1)
>     preprocessor at the Bell Labs CSRC.

I found it.

https://lore.kernel.org/linux-man/20220722033353.ap7aqxh6uhghdcxo@illithid/

If anyone _needs_ to read a _long_ case against taking on the tedium of
maintaining paragraphing indentation amounts in man pages to be
discouraged from doing so, that's it.

Regards,
Branden
signature.asc (application/pgp-signature, 833 B)
-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAmlWFqkACgkQ0Z6cfXEm
bc7DJg/7BgUf5hbFYEa39vSM9YGl5ebsy17b5aFnkA/YlZY1o4EuGYNgvvF+IRD6
OWYnyzSQ34/JbB6Vu6Ig+/iC6Qbt+DxUmEc3bX7uc8SC4vueedG3yolI6PsNyV7u
DmKhMYjNhCljSgScsz7fJFfINyizzkELIIiO3pM/8U3lBNmta2BPQz/10Tu2Xsx5
3drdUWLJgtbFeQwHgUkIdKVNovZG11mHN0xAmN6pBXkGRqOEtQeLJfAzULwzLqMw
24Tt34ZwSP94LFnye9AAxAZFlJ+kiDV3Jt7InAYUC/EwuwazvWnligPSamBFuuNd
WmnuVIeR+KH/tQDBRIk3K+unZy2LdApdxIW8tp3K5DSC9oiEy029Ypoi2iRiv76y
8G/UAmm8HyhnN5zp46lwk0/o/rw7yUeTuxEqtFsch64eMp0BYr+arpyz9HChIWnA
eIwQnvFLaqFTEbn9UJhbkOK05nLECQ81VvRqkQsNZO2riRTMaXA8DHncAcLpq2sZ
q0Uv6FJFHdsaoLmDjXROMBukjPSLS28AzFG5vd08rjme3Jk4AxSn46WEWUHhsOm3
De9T+3p8Elistu2kIihYlGbR/XrwaqFab19gcfBGFnImwmkZ2sy7eAFok05t3qBn
2FbIvvOigABfTtGDZbNiPg3Xtn8GPmjbTYfeXQjif45Ht+whDm8=
=cI4J
-----END PGP SIGNATURE-----