Thread (20 messages) 20 messages, 3 authors, 2021-09-12

Re: [PATCH 3/3] Use subsections instead of sections

From: G. Branden Robinson <hidden>
Date: 2021-09-12 18:49:55

At 2021-09-12T15:22:35+0000, Thaddeus H. Black wrote:
On Sun, Sep 12, 2021 at 04:56:21PM +0200, Alejandro Colomar
(man-pages) wrote:
quoted
I'm a bit worried that this might be overcomplicating it, and maybe
a hypothetical .SSS macro would be useful here (or another
solution).  Do you have any thoughts about it?

That hypothetical macro would behave like .TP + .B + .RS (as shown
above; and that .RS would only end at a following .SSS/.SS/.SH)
It is not important to me that my .SSS macro be used, but for
reference here it is:

.de1 SSS
.  if !r SSS_SN_ORIG .nr SSS_SN_ORIG \\n[SN]
.  nr SN (2 * \\n[SSS_SN_ORIG])
.  SS \&\\$*
.  nr SN (\\n[SSS_SN_ORIG])
..
Oh, I definitely like this better than my own straw-man proposal.  It's
much cleaner.

I still question the need for this depth of organization in a man page,
but I could see the aboev becoming a nestable `SN` sub*-sectioning macro
much more straightforwardly than a TP/B/RS-based solution.

Of course, this one only indents the section heading itself, not the
paragraphs the follow, so some RS/RE tomfoolery would likely still be
required.

Good to see you, Thaddeus--I definitely remember you from Debian mailing
list days.  :)

Regards,
Branden

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help