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-----