[groff] 04/07: doc/ms.ms: Improve document settings table.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b745123e77c85b3a9430574cb7b930773584a320
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jun 21 02:57:16 2021 +1000

    doc/ms.ms: Improve document settings table.
    
    * Rename register/string definitions in some cases so that the mnemonic
      of the register/string name is more obvious.
    * Say the word "paragraph" instead of using the paragraph symbol; the
      latter doesn't buy us very much space.
    
    Also:
    * Drop now-unused fallback character definition for \[ps].
    * Add comment motivating fallback character definition for \[dg].
---
 doc/ms.ms | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/doc/ms.ms b/doc/ms.ms
index b41bb8e..0f891f8 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -10,8 +10,8 @@
 .\" This document doesn't require the minus sign but we do want a copy-
 .\" and-pastable hyphen-minus.
 .char \- \N'45'
+.\" A very limited output device might not have a dagger glyph.
 .fchar \[dg] *
-.fchar \[ps] paragraph
 .\" Acronym (slightly smaller type)
 .de Acr
 \s-1\\$1\s0\\$2
@@ -318,20 +318,20 @@ Type      Parameter       Definition      Effective       
Default
 _
 .TH
 Margins        \[rs]n[PO]      Page offset (left margin)       next page       
1i
-\^     \[rs]n[LL]      Line length     next \[ps]      6i
-\^     \[rs]n[LT]      Header/footer (title) length    next \[ps]      6i
+\^     \[rs]n[LL]      Line length     next paragraph  6i
+\^     \[rs]n[LT]      Header/footer (title) length    next paragraph  6i
 \^     \[rs]n[HM]      Top (header) margin     next page       1i
 \^     \[rs]n[FM]      Bottom (footer) margin  next page       1i
 _
-Text   \[rs]n[PS]      Point size      next \[ps]      10p
-\^     \[rs]n[VS]      Line spacing (leading)  next \[ps]      12p
-\^     \[rs]n[HY]      Hyphenation mode        next \[ps]      6
-\^     \[rs]*[FAM]     Font family     next \[ps]      T
+Text   \[rs]n[PS]      Point size      next paragraph  10p
+\^     \[rs]n[VS]      Vertical spacing (leading)      next paragraph  12p
+\^     \[rs]n[HY]      Hyphenation mode        next paragraph  6
+\^     \[rs]*[FAM]     Font family     next paragraph  T
 _
-Paragraphs     \[rs]n[PI]      Initial indent  next \[ps]      5n
-\^     \[rs]n[PD]      Space between paragraphs        next \[ps]      0.3v
-\^     \[rs]n[QI]      Quoted paragraph indent next \[ps]      5n
-\^     \[rs]n[PORPHANS]        # of initial lines kept next \[ps]      1
+Paragraphs     \[rs]n[PI]      Indentation     next paragraph  5n
+\^     \[rs]n[PD]      Paragraph distance (spacing)    next paragraph  0.3v
+\^     \[rs]n[QI]      Quotation indentation   next paragraph  5n
+\^     \[rs]n[PORPHANS]        # of initial lines kept next paragraph  1
 _
 Headings       \[rs]n[PSINCR]  Point size increment    next heading    1p
 \^     \[rs]n[GROWPS]  Size increase level limit       next heading    0
@@ -341,7 +341,7 @@ _
 Footnotes      \[rs]n[FI]      Indentation     next footnote   2n
 \^     \[rs]n[FF]      Format  next footnote   0
 \^     \[rs]n[FPS]     Point size      next footnote   \[rs]n[PS]\-2
-\^     \[rs]n[FVS]     Vertical spacing        next footnote   \[rs]n[FPS]+2
+\^     \[rs]n[FVS]     Vertical spacing (leading)      next footnote   
\[rs]n[FPS]+2
 \^     \[rs]n[FPD]     Paragraph spacing       next footnote   \[rs]n[PD]/2
 \^     \[rs]*[FR]      Line length ratio       special 11/12
 _