[groff] 14/23: groff_man*(7): Clarify `RS` behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 528321164933dae47e3c534321a67eb05c630b8f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Feb 22 02:44:58 2023 -0600

    groff_man*(7): Clarify `RS` behavior.
    
    Thanks to Alex Colomar for the feedback.
    
    Also align a code comment with the documentation.
---
 tmac/an.tmac            | 2 +-
 tmac/groff_man.7.man.in | 9 +++++++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/tmac/an.tmac b/tmac/an.tmac
index 941c25d08..0d540fbcb 100644
--- a/tmac/an.tmac
+++ b/tmac/an.tmac
@@ -948,7 +948,7 @@ contains unsupported escape sequence
 ..
 .
 .\" Start a relative inset level (by the amount given in the argument).
-.\" .RS [indent]
+.\" .RS [inset-amount]
 .de1 RS
 .  nr an-saved-margin\\n[an-inset-level] \\n[an-margin]
 .  nr an-saved-prevailing-indent\\n[an-inset-level] \
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 ,