[groff] 09/29: [ms]: (docs) Clarify \n[FF] behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 40714fe2cf8bd4c86f746a320b5ea91e77b2bcbc
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Apr 17 12:10:36 2022 +1000

    [ms]: (docs) Clarify \n[FF] behavior.
    
    ...by relating each supported register value to a paragraphing macro.
---
 doc/groff.texi      | 11 ++++++-----
 doc/ms.ms           | 23 ++++++++++++++++-------
 tmac/groff_ms.7.man | 24 +++++++++++++++++-------
 3 files changed, 39 insertions(+), 19 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 81a862c0..be458a38 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2916,18 +2916,19 @@ the bottom of a column or page.  This is a Berkeley 
extension.
 @item 0
 Set an automatic number as a superscript (on typesetter devices) or
 surrounded by square brackets (on terminals).  The footnote paragraph is
-indented if there is an @code{FS} argument or an automatic number.  This
-is the default.
+indented as with @code{PP} if there is an @code{FS} argument or an
+automatic number, and as with @code{LP} otherwise.  This is the default.
 
 @item 1
-Like @code{0}, but set the marker as regular text and follow an
+As @code{0}, but set the marker as regular text and follow an
 automatic number with a period.
 
 @item 2
-Like @code{1}, but without indentation.
+As @code{1}, but without indentation (like @code{LP}).
 
 @item 3
-Like @code{1}, but set the footnote paragraph with the marker hanging.
+As @code{1}, but set the footnote paragraph with the marker hanging
+(like @code{IP}).
 @end table
 
 Effective: next footnote.
diff --git a/doc/ms.ms b/doc/ms.ms
index 55164c5b..76772dd7 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -2436,27 +2436,36 @@ Set an automatic number as a superscript
 or surrounded by square brackets
 (on terminals).
 .
-The footnote paragraph is indented if there is an
+The footnote paragraph is indented as with
+.CW .PP
+if there is an
 .CW .FS
-argument or an automatic number.
+argument or an automatic number,
+and as with
+.CW .LP
+otherwise.
 .
 This is the default.
 T}
 1      T{
-Like
+As
 .CW 0 ,
 but set the marker as regular text,
 and follow an automatic number with a period.
 T}
 2      T{
-Like
+As
 .CW 1 ,
-but without indentation.
+but without indentation
+(like
+.CW .LP ).
 T}
 3      T{
-Like
+As
 .CW 1 ,
-but set the footnote paragraph with the marker hanging.
+but set the footnote paragraph with the marker hanging
+(like
+.CW .IP ).
 T}
 .TE
 .KE
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 83a18b09..5d2b0b9f 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1627,16 +1627,21 @@ as a superscript
 or surrounded by square brackets
 (on terminals).
 .
-The footnote paragraph is indented if there is an
+The footnote paragraph is indented as with
+.B .PP
+if there is an
 .B .FS
-argument or an automatically generated number.
+argument or an automatic number,
+and as with
+.B .LP
+otherwise.
 .
 This is the default.
 .
 .
 .TP
 1
-Like
+As
 .BR 0 ,
 but set the marker as regular text,
 and follow an automatically generated number with a period.
@@ -1644,18 +1649,23 @@ and follow an automatically generated number with a 
period.
 .
 .TP
 2
-Like
+As
 .BR 1 ,
-but without indentation.
+but without indentation
+(like
+.BR .LP ).
 .
 .
 .TP
 3
-Like
+As
 .BR 1 ,
-but set the footnote paragraph with the marker hanging.
+but set the footnote paragraph with the marker hanging
+(like
+.BR .IP ).
 .RE
 .
+.
 .P
 Conversely,
 if you choose to provide your own