[groff] 07/14: [docs]: Apply lexical discipline to "adjustment".

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 5bec074c88a77d567e1cc068f42a54ac3641c35c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jul 12 21:44:18 2021 +1000

    [docs]: Apply lexical discipline to "adjustment".
    
    Update discussions and code comments to reserve the term "adjustment" to
    the only situation where the formatter logic actually
    applies--"full justification" or "normal"/"both" margins in *roff
    parlance.  Use forms of the term "align" for contexts where on the left
    or right margin is expected to be straight.  The overloading of the term
    "adjustment" in roff systems is, I think, a historical artifact of there
    once being only two alternatives: adjustment to both margins, and no
    adjustment (with a presumption of left-to-right orthography).
    
    We can't rename the .ad request, but we can stop abusing terminology
    when we discuss it or macros that interact with it.
---
 contrib/mm/examples/README | 6 +++---
 contrib/mm/groff_mm.7.man  | 6 +++---
 contrib/mm/m.tmac          | 4 ++--
 contrib/mom/om.tmac        | 4 ++--
 doc/groff.texi             | 4 ++--
 doc/ms.ms                  | 2 +-
 tmac/groff_man.7.man.in    | 2 +-
 tmac/groff_mdoc.7.man      | 4 ++--
 tmac/groff_ms.7.man        | 2 +-
 9 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/contrib/mm/examples/README b/contrib/mm/examples/README
index 1d46e1c..cb0956a 100644
--- a/contrib/mm/examples/README
+++ b/contrib/mm/examples/README
@@ -14,9 +14,9 @@ COVER         My general cover macro, this example is using
                ms.cov.
 IND            A general indexing method, see manual for INITI.
 LT             The letter macro.
-LT.se          A Swedish example with the extra
-               Swedish macros for getting a letter conforming
-               to Swedish standard letter, both left and right adjusted.
+LT.se          A Swedish example with extra Swedish macros for
+               composing a letter conforming to Swedish standard style,
+               adjusted to left and right margins.
 ML             Marked list, an extended list type.
 MOVE           The MOVE macro, how to begin to print on an exact position.
 MUL            Enhanced multicolumn mode.
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 235b1d7..d2597b3 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -942,7 +942,7 @@ This is used to include external pictures;
 just give the size of the picture.
 .
 .B \-L
-left-adjusts the picture;
+left-aligns the picture;
 the default is to center.
 .
 See
@@ -1041,7 +1041,7 @@ The default is stored in string variable
 Footnote default format.
 .
 Controls the hyphenation (hyphen),
-right margin justification (adjust),
+adjustment to the right margin (adjust),
 and indentation of footnote text (indent).
 .
 It can also change the label justification (ljust).
@@ -3491,7 +3491,7 @@ Default is\~0.
 .
 .TP
 .B Eq
-Equation labels are left-adjusted if set to\~0 and right-adjusted if
+Equation labels are left-aligned if set to\~0 and right-aligned if
 set to\~1.
 .
 Default is\~0.
diff --git a/contrib/mm/m.tmac b/contrib/mm/m.tmac
index 91be07b..84a1e65 100644
--- a/contrib/mm/m.tmac
+++ b/contrib/mm/m.tmac
@@ -880,12 +880,12 @@ in=\\n[.i] fi=\\n[.u] .d=\\n[.d] nl=\\n[nl] pg=\\n[%]
 .\}
 ..
 .\" external picture
-.\" -L left adjust
+.\" -L left align
 .de EPIC
 .if \\n[.$]<2 .@error "EPIC: Not enough arguments"
 .nr pict*adj 0         \" centered
 .if '\\$1'-L' \{\
-.      shift 1         \" left adjust
+.      shift 1         \" left align
 .      nr pict*adj 1
 .\}
 .if \\n[nl]<0 \&
diff --git a/contrib/mom/om.tmac b/contrib/mom/om.tmac
index 5071325..46868ac 100644
--- a/contrib/mom/om.tmac
+++ b/contrib/mom/om.tmac
@@ -22699,8 +22699,8 @@ does not fit on page \\n[pgnum]\\*[col-num].
 \# default values.  If the first argument is the string 'ragged',
 \# left and right margin notes are printed ragged-right.  If it is
 \# 'symmetric', left margin notes are printed ragged-left and right
-\# margin notes ragged-right.  If omitted, margin notes are left
-\# and right adjusted.
+\# margin notes ragged-right.  If omitted, margin notes are adjusted to
+\# both margins.
 \#
 .de MNinit
 .  nr #MNinit 1
diff --git a/doc/groff.texi b/doc/groff.texi
index 26a06cf..f9115ce 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4327,7 +4327,7 @@ until the first @file{ms} macro is called.  This implies 
that
 also: accessing an undefined register automatically defines it.
 
 @item
-Displays are left-adjusted by default, not indented.  In @acronym{AT&T}
+Displays are left-aligned by default, not indented.  In @acronym{AT&T}
 @file{ms}, @samp{.DS} is synonymous with @samp{.DS I}; in @code{groff}
 @file{ms}, it is synonymous with @samp{.DS L}.
 
@@ -7158,7 +7158,7 @@ not write logic to interpret or perform arithmetic on it.
 
 @Defreq {na, }
 Disable output line adjustment.  This produces the same output as
-adjustment to the left margin, but the value of the adjustment mode
+alignment to the left margin, but the value of the adjustment mode
 register @code{.j} is altered differently.  The adjustment mode and
 enablement status are associated with the environment
 (@pxref{Environments}).
diff --git a/doc/ms.ms b/doc/ms.ms
index 05e75aa..513bfd1 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -2793,7 +2793,7 @@ and
 .
 .
 .PP
-Displays are left-adjusted by default,
+Displays are left-aligned by default,
 not indented.
 .
 In AT&T
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 2d19d35..0a06349 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -2907,7 +2907,7 @@ for adjustment to both margins
 (the default),
 or
 .RB \[lq] l \[rq]
-for left adjustment
+for left alignment
 (ragged right margin).
 .
 Any valid argument to
diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index ab4eefa..5a44540 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -4926,8 +4926,8 @@ able to.
 .\" declaration.
 .\" In
 .\" .Xr @g@nroff
-.\" the right margin adjustment is normally ragged and the problem is
-.\" not as severe.
+.\" the right margin is normally ragged and the problem is not as
+.\" severe.
 .
 .\" Local Variables:
 .\" mode: nroff
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 43d8e2c..c264ffe 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1862,7 +1862,7 @@ accessing an undefined register automatically defines it.
 .
 .
 .IP \[bu]
-Displays are left-adjusted by default,
+Displays are left-aligned by default,
 not indented.
 .
 In AT&T