[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/06: doc/ms.ms: Use flexible-width tables.
From: |
G. Branden Robinson |
Subject: |
[groff] 02/06: doc/ms.ms: Use flexible-width tables. |
Date: |
Mon, 22 Feb 2021 19:31:56 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 1c970eb2420b9d62e28c7dde68f888304a8294c6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Feb 20 22:16:03 2021 +1100
doc/ms.ms: Use flexible-width tables.
* Stop using "expand" table option in favor of "x" modifier in a column.
* Use column format "l" instead of "a" in tables.
* Stop using explicit column widths in tables.
* Use consistent verb tense to describe operation of display macros.
* Format input of text blocks more idiomatically.
- Set multi-word parentheticals on their own input lines.
- Set macro parameter metasyntactic variables in italics.
- Use register interpolation syntax on register name not described as
such.
* Use term "align" instead of "justify" when discussing display
formatting, to attempt to reduce confusion around adjustment issues.
* Use two empty requests where vertical space is expected.
* Remove unnecessary bracketing of a table in .na/.ad requests.
---
doc/ms.ms | 49 +++++++++++++++++++++++++++++++------------------
1 file changed, 31 insertions(+), 18 deletions(-)
diff --git a/doc/ms.ms b/doc/ms.ms
index e99db7f..0e6dae3 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -1362,27 +1362,34 @@ Displays can be
.I kept
on a single page, or allowed to break across pages.
The following table shows the display types available.
+.
+.
.TS
-box expand;
-cb s | cb
+box;
+cb s | cb
cb cb | ^
-afCR afCR | a .
+lfCR lfCR | lx .
Display macro Description
With keep No keep
_
-\&.DS L \&.LD Left-justified display.
+\&.DS L \&.LD Left-aligns display.
\&.DS I [\fIindent\fP] \&.ID T{
-Indented display
-(default is the DI register).
+Indents display
+(by
+.I indent
+if given,
+otherwise the value of
+.CW \[rs]n[DI] ).
T}
\&.DS B \&.BD T{
-Block-centered display
-(left-justified,
-longest line centered).
+Block-centers display
+(left-aligns with the longest line centered).
T}
\&.DS C \&.CD Centers all lines in the display.
-\&.DS R \&.RD Right-justifies all lines in the display.
+\&.DS R \&.RD Right-aligns all lines in the display.
.TE
+.
+.
.LP
Use the
.CW .DE
@@ -1453,11 +1460,13 @@ and
.I refer .
You mark text meant for preprocessors by enclosing it
in pairs of tags as follows:
+.
+.
.TS
-box expand;
+box;
cb cb
-afCRw(1.5i) aw(4.5i) .
-Tag Pair Description
+lfCR lx .
+Tag pair Description
_
T{
\&.TS [H]
@@ -1545,6 +1554,8 @@ format of the bibliographic database.
T}
.TE
.KE
+.
+.
.KS
.NH 3
An example multi-page table
@@ -1626,11 +1637,10 @@ prints footnote numbers by changing the value of the
register as follows.
.
.
-.na
.TS
box;
cb cb
-aw(0.75i) lw(5.25i) .
+lfCR lx .
Value Description
_
0 T{
@@ -1651,7 +1661,6 @@ Like\~1,
but prints the footnote number as a paragraph with a hanging indent.
T}
.TE
-.ad
.KE
.
.
@@ -1773,10 +1782,12 @@ However, if the current mode is single-column, starting
a multi-column
mode does
.B not
force a page break.
+.
+.
.TS
-box expand;
+box;
cb cb
-lfCRw(2i) lw(4i).
+lfCR lx .
Macro Description
_
\&.1C Single-column mode.
@@ -1803,6 +1814,8 @@ number register is the default gutter width.
T}
.TE
.KE
+.
+.
.NH 2
Creating a table of contents
.XS
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/06: doc/ms.ms: Use flexible-width tables.,
G. Branden Robinson <=