[groff] 02/07: doc/ms.ms: Document new FR string.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f7b737e456bd2fc015aec362f5781db80a7790c7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jan 29 03:49:53 2021 +1100

    doc/ms.ms: Document new FR string.
---
 ChangeLog |  4 ++++
 doc/ms.ms | 72 +++++++++++++++++++++++++++++++++++++++++++++------------------
 2 files changed, 56 insertions(+), 20 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f1a68ef..4cdb6a9 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2021-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * doc/ms.ms (Document control settings): Document new FR string.
+
 2021-01-29  T. Kurt Bond <tkurtbond@gmail.com>
 
        [ms]: Add new string FR to hold an expression for computing the
diff --git a/doc/ms.ms b/doc/ms.ms
index e6fd2ec..46d5431 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -220,47 +220,79 @@ body text.
 .\" ------------------------
 .if t .bp
 .NH 1
-Document control registers
+Document control settings
 .XS
-Document control registers
+Document control settings
 .XE
 .LP
-The following table lists the document control
-number registers.
+The following table lists document control registers and strings.
+.
 For the sake of consistency,
 set registers related to margins at the beginning of your document,
 or just after the
 .CW .RP
 macro.
+.
 You can set other registers later in your document,
 but you should keep them together at the beginning
 to make them easy to find and edit as necessary.
 .TS H
 box expand;
 cb | cb cb cb cb
-l | afCW l l l .
-Type   Register        Definition      Effective       Default
+l | afCW l l lfCW .
+Type   Parameter       Definition      Effective       Default
 _
 .TH
-Margins        PO      Page offset (left margin)       next page       1i
-\^     LL      Line length     next \(pp       6i
-\^     LT      Header/footer (title) length    next \(pp       6i
-\^     HM      Top (header) margin     next page       1i
-\^     FM      Bottom (footer) margin  next page       1i
+Margins        \[rs]n[PO]      Page offset (left margin)       next page       
1i
+\^     \[rs]n[LL]      Line length     next \(pp       6i
+\^     \[rs]n[LT]      Header/footer (title) length    next \(pp       6i
+\^     \[rs]n[HM]      Top (header) margin     next page       1i
+\^     \[rs]n[FM]      Bottom (footer) margin  next page       1i
 _
-Text   PS      Point size      next \(pp       10p
-\^     VS      Line spacing (leading)  next \(pp       12p
+Text   \[rs]n[PS]      Point size      next \(pp       10p
+\^     \[rs]n[VS]      Line spacing (leading)  next \(pp       12p
 _
-Paragraphs     PI      Initial indent  next \(pp       5n
-\^     PD      Space between paragraphs        next \(pp       0.3v
-\^     QI      Quoted paragraph indent next \(pp       5n
+Paragraphs     \[rs]n[PI]      Initial indent  next \(pp       5n
+\^     \[rs]n[PD]      Space between paragraphs        next \(pp       0.3v
+\^     \[rs]n[QI]      Quoted paragraph indent next \(pp       5n
 _
-Footnotes      FL      Footnote length next footnote   LL*11/12
-\^     FI      Footnote indent next footnote   2n
-\^     FF      Footnote format next footnote   0
+Footnotes      \[rs]*[FR]      Footnote length ratio   next footnote   11/12
+\^     \[rs]n[FI]      Footnote indent next footnote   2n
+\^     \[rs]n[FF]      Footnote format next footnote   0
 _
-Other  MINGW   Minimum width between columns   next page       2n
+Other  \[rs]n[MINGW]   Minimum width between columns   next page       2n
 .TE
+.
+.PP
+The default footnote line length is 11/12ths of the normal line length
+for compatibility with the expectations of historical
+.I ms
+documents;
+you may wish to set
+.CW \[rs]*[FR]
+to
+.CW 1
+to suit contemporary typesetting practices.
+.
+In the past,\**
+.FS
+in Version 7 Unix
+.I ms ,
+its descendants,
+and GNU
+.I ms
+prior to
+.I groff
+version 1.23.0
+.FE
+an
+.CW FL
+register was used for the line length in footnotes;
+however,
+setting this register had no effect on the footnote line length in
+multi-column environments.
+.
+.
 .\" ------------------------
 .bp
 .NH 1