Re: RS/RE and paragraphing macros

[G. Branden Robinson]

[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 say (below).  That might be enough.

Well, long-term, I want to rename things in the macro source away from
"prevailing indent" anyway.

> > > What happens to the actual indentation (as in IP)?
> >
> > It is disregarded, but preserved for possible restoration upon a
> > subsequent `RE` call.
> >
> 
> 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 34a14c8c7..8416825cf 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1980,9 +1980,14 @@ or
 or its synonyms is called;
 these clear the indentation entirely.
 .
-Insets created by
+A relative inset created by
 .B .RS
-move the left margin and persist until
+saves the current indentation,
+resets it to zero,
+and
+moves the left margin.
+.
+The new left margin persists until
 .BR .RS ,
 .BR .RE ,
 .BR .SH ,

Regards,
Branden

signature.asc
Description: PGP signature