From b14a7dda59bf0fcf10667a40a31fabe78e479ebd Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Wed, 15 Feb 2023 10:27:47 -0600
Subject: groff_man*(7): Distinguish `RS`'s inset amount.

...from indentation.  While both are horizontal distances, we are
otherwise at pains to distinguish indentation from insets (left margin
manipulation), and using "indentation" to name `RS`'s argument confounds
this distinction.

Prompted by discussion with Alex Colomar.
---
 tmac/groff_man.7.man.in | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 20da6cd7a..1acc686ee 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -733,11 +733,11 @@ installation.
 .
 .TP
 .BR .RS " ["\c
-.IR indentation ]
+.IR inset-amount ]
 Start a new relative inset level.
 .
 The left margin moves right by
-.I indentation,
+.I inset-amount,
 if specified,
 and by a default amount otherwise;
 see subsection \(lqHorizontal and vertical spacing\(rq below.
@@ -1936,12 +1936,14 @@ _endif()dnl
 The
 .I indentation
 argument accepted by
-.BR .RS ,
 .BR .IP ,
 .BR .TP ,
 and the deprecated
 .B .HP
-is a number plus an optional scaling unit.
+is a number plus an optional scaling unit,
+as is
+.BR .RS 's
+.IR inset-amount .
 .
 If no scaling unit is given,
 the
@@ -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 persist until
 .BR .RS ,
-- 
cgit v1.2.1