RS/RE and paragraphing macros

Hi Branden, I finally got a reproducible case of what I had in mind for a long time that .RS wasn't a good replacement for .in. Here it is: $ cat indent_code.man .TH a b c d .SH Experiment .TP foo .RS 4 .EX int main(void) { return 42; } .EE .RE .IP The code above was an example. .TP bar .in

Re: RS/RE and paragraphing macros

On 2/15/23 00:07, Alejandro Colomar wrote: > "bar" is what I'd expect. Now that I know what I was looking for, > I could search it and find it. Michael had this to say: > Heh, I just realized that Michael was quo

Re: RS/RE and paragraphing macros

Hi Branden, On 2/15/23 00:07, Alejandro Colomar wrote: > "bar" is what I'd expect. Now that I know what I was looking for, > I could search it and find it. Michael had this to say: > > > Shouldn't RS/RE nest nic

Re: RS/RE and paragraphing macros

Hi Alex, At 2023-02-15T00:07:14+0100, Alejandro Colomar wrote: > I finally got a reproducible case of what I had in mind for a long > time that .RS wasn't a good replacement for .in. Okay. > Here it is: > > $ cat indent_code.man > .TH a b c d > .SH Experiment > .TP > foo > .RS 4 > .EX > int >

Re: RS/RE and paragraphing macros

Hi Branden, On 2/15/23 03:16, G. Branden Robinson wrote: [...] > --end snip-- > > I know the above is lengthy; please point out any part of it that you > find difficult to follow. > > I came up with a list of constraints that Michael had on how he wanted > to set code examples in the Linux man-

Re: RS/RE and paragraphing macros

Hi Alex, Sorry for the delay in replying, I've been whacking on groff source pretty furiously and doing a _lot_ of testing. At 2023-02-15T03:56:44+0100, Alejandro Colomar wrote: > > Phrasing one of them a different way, I _think_ one of the things > > Michael wanted was to be able to relocate exa

Re: RS/RE and paragraphing macros

Hi Branden, On 2/20/23 07:10, G. Branden Robinson wrote: [...] Okay, so now it makes sense. There's indentation and left margin, and they're different things (still weird that the amount of movement(?) of the left margin is also called indentation (.RS [indentation])). That's such a good poi

Re: RS/RE and paragraphing macros

On 2/21/23 00:30, Alex Colomar wrote: Hummm, this is definitely not as simple as "breaks the line and moves the margin".  The margin is not moved because of 0, so this should be just equivalent to .br from your own definition.  However, it's not.  It does some extra magic, which I'd call "RS se

Re: RS/RE and paragraphing macros

Hi Alex, At 2023-02-21T00:30:19+0100, Alex Colomar wrote: > Ahh, okay, so it breaks the line but it doesn't separate paragraphs. That kind of depends on how a human reader interprets what they see. > > Paragraphing macros in *roff packages _separate_ paragraphs; they do > > not _enclose_ paragra

Re: RS/RE and paragraphing macros

At 2023-02-21T00:46:11+0100, Alex Colomar wrote: > On 2/21/23 00:30, Alex Colomar wrote: > > Hummm, this is definitely not as simple as "breaks the line and moves > > the margin".  The margin is not moved because of 0, so this should be > > just equivalent to .br from your own definition.  However,

Re: RS/RE and paragraphing macros

Hi Branden, On 2/21/23 01:29, G. Branden Robinson wrote: At 2023-02-21T00:46:11+0100, Alex Colomar wrote: On 2/21/23 00:30, Alex Colomar wrote: Hummm, this is definitely not as simple as "breaks the line and moves the margin".  The margin is not moved because of 0, so this should be just equiv

Re: RS/RE and paragraphing macros

Hi Branden, On 2/21/23 01:09, G. Branden Robinson wrote: [...] Not completely. I will go ahead and quote more of groff_man_style(7). I was at great pains to craft this material. Horizontal and vertical spacing The indentation argument accepted by .IP, .TP, and the deprecated .HP

Re: RS/RE and paragraphing macros

Hi Alex, At 2023-02-21T11:09:13+0100, Alex Colomar wrote: > On 2/21/23 01:29, G. Branden Robinson wrote: > > .\" Start a relative inset level (by the amount given in the argument). > > .\" .RS [indent] > > Which reminds us that this was missing in your recent patch, right? :) That was deliberate

Re: RS/RE and paragraphing macros

Hi Branden, On Tue, Feb 21, 2023, 17:49 G. Branden Robinson < g.branden.robin...@gmail.com> wrote: > Hi Alex, > > At 2023-02-21T11:09:13+0100, Alex Colomar wrote: > > On 2/21/23 01:29, G. Branden Robinson wrote: > > > .\" Start a relative inset level (by the amount given in the argument). > > > .

Re: RS/RE and paragraphing macros

[dropped Doug from CC; he hasn't replied yet so I don't want to clutter his inbox] At 2023-02-21T18:39:26+0100, Alejandro Colomar wrote: [...] > Would you mind rewriting the above with more unambiguous terms? > Although maybe it's not necessary. I managed to make you say what I > wanted you to sa

Re: RS/RE and paragraphing macros

Hi Branden, On 2/22/23 09:25, G. Branden Robinson wrote: [...] This sentence is precisely what I feel is missing in the documentation. Don't you think? Could you add this information to the manual page? How about this? diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in index 34a

RS/RE and (relative) inset (was: RS/RE and paragraphing macros)

Hi Branden, On 2/20/23 07:10, G. Branden Robinson wrote: [...] Okay, so now it makes sense.  There's indentation and left margin, and they're different things (still weird that the amount of movement(?) of the left margin is also called indentation (.RS [indentation])). That's such a good po

Re: RS/RE and (relative) inset (was: RS/RE and paragraphing macros)

Hi Alex, At 2023-02-21T00:37:55+0100, Alex Colomar wrote: > I'm not convinced about this change: > > > @@ -1976,7 +1978,7 @@ or > or its synonyms is called; > these clear the indentation entirely. > . > -Relative insets created by > +Insets created by > .B .RS > move the left margin and per

Re: RS/RE and (relative) inset (was: RS/RE and paragraphing macros)

On 2/21/23 01:18, G. Branden Robinson wrote: Hi Alex, Hi Branden, At 2023-02-21T00:37:55+0100, Alex Colomar wrote: I'm not convinced about this change: @@ -1976,7 +1978,7 @@ or or its synonyms is called; these clear the indentation entirely. . -Relative insets created by +Insets cre

Re: RS/RE and (relative) inset (was: RS/RE and paragraphing macros)

Hi Alex, At 2023-02-21T11:13:00+0100, Alex Colomar wrote: > On 2/21/23 01:18, G. Branden Robinson wrote: > > I have tried to write the groff_man(7) page accurately and concisely > > for experienced *roff macro package users, and groff_man_style(7) in > > a more tutorial and accommodating way for n