[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/18: doc/ms.ms: Revise.
From: |
G. Branden Robinson |
Subject: |
[groff] 02/18: doc/ms.ms: Revise. |
Date: |
Tue, 25 Jul 2023 05:49:17 -0400 (EDT) |
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"
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/18: doc/ms.ms: Revise.,
G. Branden Robinson <=