[groff] 02/18: doc/ms.ms: Revise.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1797d1a9ff9fb69f5dc764908d49366f19fe9406
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jul 19 23:51:41 2023 -0500

    doc/ms.ms: Revise.
    
    * Bump document date.
    * Fix bad formatting of repeating-heading table in nroff mode.  (If tbl
      has enough room to set _only_ the heading row(s) on a page, with no
      data below them before a page break, it will.  Prevent that.  Could an
      enhancement to the macro package do this automatically?)
    * Explicitly describe how we handle `UL` in nroff mode.
    * Fix Warren Zevon example to be correctly illustrative in nroff mode.
    * Tighten wording to fit in some new material.
    * Illustrate use of \w escape sequence in an appropriate scenario.
    * Fix spurious space after slash when switching fonts.
---
 doc/ms.ms | 55 +++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 37 insertions(+), 18 deletions(-)

diff --git a/doc/ms.ms b/doc/ms.ms
index cc3a877fd..61bdc00f0 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -36,8 +36,8 @@
 .nr TC-MARGIN \w'00' \" expect 2-digit page numbers at most
 .ie t .nr PI 3.5n
 .el   .nr PI 4n
-.ND May 2023
-.EH '%''May 2023'
+.ND July 2023
+.EH '%''July 2023'
 .EF ''''
 .OH 'Using \f[I]groff\f[] with the \f[I]ms\f[] macros''%'
 .OF ''''
@@ -697,6 +697,10 @@ is mandatory if
 is called.
 .
 .
+.if n \{
+.  br
+.  ne 12v
+.\}
 .TS H
 box;
 lb lb
@@ -1672,6 +1676,10 @@ Typeset
 with an
 .UL underline .
 .
+On terminal devices,
+.I text
+is bracketed with underscores (\[lq]_\[rq]).
+.
 .I post,
 if present,
 is set after
@@ -1931,6 +1939,9 @@ that a
 argument remains affixed to the first call.
 .
 .
+.\" We assume Times roman font metrics for these examples.
+.if t .ds gwidth 0.4i
+.if n .ds gwidth 0.5i
 .TS H
 box center;
 cb cb
@@ -1987,7 +1998,7 @@ _
 T{
 .nf
 A glossary-style list:
-\&.IP lawyers 0.4i
+\&.IP lawyers \*[gwidth]
 Two or more attorneys.
 \&.IP guns
 Firearms,
@@ -1999,7 +2010,7 @@ lawyers and guns!
 T}     T{
 A glossary-style list:
 .
-.IP lawyers 0.4i
+.IP lawyers \*[gwidth]
 Two or more attorneys.
 .IP guns
 Firearms,
@@ -2012,12 +2023,12 @@ T}
 .
 .PP
 In the enumerated list example,
-we employed the
+we created a register
+.CW step
+with the
 .CW nr
-request to create a register of our own,
-.CW step .
-.
-We initialized it to zero and assigned it an auto-increment of 1.
+request,
+initializing it to zero and setting its auto-increment to 1.
 .
 Each time we use the escape sequence
 .CW \[rs]n+[step]
@@ -2025,11 +2036,6 @@ Each time we use the escape sequence
 the formatter applies the increment just before interpolating the
 register's value.
 .
-Preparing the
-.CW PI
-register as well enables us to rearrange the list without the tedium of
-updating macro calls.
-.
 .
 .PP
 In the glossary example,
@@ -2089,7 +2095,7 @@ T}        T{
 .fi
 T}     T{
 .nf
-\&.IP guns\[rs]h\[aq]0.4i\[aq]
+\&.IP guns\[rs]h\[aq]\*[gwidth]\[aq]
 Firearms,
 .fi
 T}
@@ -2102,9 +2108,9 @@ _
 T{
 A glossary-style list:
 .
-.IP lawyers 0.4i
+.IP lawyers \*[gwidth]
 Two or more attorneys.
-.IP guns\h\[aq]0.4i\[aq] 0.4i
+.IP guns\h\[aq]\*[gwidth]\[aq] \*[gwidth]
 Firearms,
 preferably large-caliber.
 .IP money
@@ -2113,6 +2119,19 @@ T}
 .TE
 .
 .
+.PP
+If you need a measurement more than once,
+you can store the measured width of text in a register.
+.
+.
+.TS
+box center;
+lf(CR).
+\&.nr width \[rs]w\[aq]guns\[aq]
+\&.IP guns\[rs]h\[aq]\[rs]n[width]\[aq]
+.TE
+.
+.
 .NH 2
 Indented regions
 .XS
@@ -3982,7 +4001,7 @@ rather than to ignore them silently.
 .PP
 Tenth Edition \" possibly 9th
 Research Unix supported
-.B P1 /
+.B P1 /\c
 .B P2
 macros to bracket code examples;
 .I "groff ms"