[groff] 28/45: [docs]: Improve terminological discipline.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c553a5cd505a9d7c6d4ab03593b68438186fcf60
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jan 18 11:09:34 2022 +1100

    [docs]: Improve terminological discipline.
    
    Migrate from "base line" to "baseline".  Also drop "baseline" from
    injection in the midst of the "vertical spacing" term (which is defined
    in terms of the baseline).
    
    Add "baseline" and "vertical spacing" as terms in the at present
    notional "Concepts" section of roff(7), which the page has long promised
    but not yet delivered.
---
 NEWS               |  2 +-
 doc/webpage.ms     |  2 +-
 man/groff.7.man    | 10 ++++++----
 man/roff.7.man     |  8 ++++++++
 src/include/font.h |  4 ++--
 5 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/NEWS b/NEWS
index 3d44a18a..64fc0305 100644
--- a/NEWS
+++ b/NEWS
@@ -953,7 +953,7 @@ o The following macros aren't new but haven't been 
documented
   previously:
 
     Alpha, ..., Omega   (the same as `ALPHA', ..., `OMEGA')
-    ldots               (three dots on the base line)
+    ldots               (three dots on the baseline)
     dollar              (a dollar glyph)
 
 o The following keywords have been extended.  Again, this isn't new but
diff --git a/doc/webpage.ms b/doc/webpage.ms
index 5abfd9a1..9e690196 100644
--- a/doc/webpage.ms
+++ b/doc/webpage.ms
@@ -1030,7 +1030,7 @@ The following macros aren't new but haven't been 
documented previously:
 \&\.\.\.,
 .B OMEGA )
 .br
-\fBldots\fP (three dots on the base line)
+\fBldots\fP (three dots on the baseline)
 .br
 \fBdollar\fP (a dollar glyph)
 .in
diff --git a/man/groff.7.man b/man/groff.7.man
index eacb2368..20b06340 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3350,11 +3350,11 @@ Disable vertical position traps.
 .
 .TPx
 .REQ .vs
-Change to previous vertical base line spacing.
+Change to previous vertical spacing.
 .
 .TPx
 .REQ .vs "\[+-]N"
-Set vertical base line spacing to
+Set vertical spacing to
 .I \[+-]N
 (default scaling indicator\~\c
 .scaleindicator p ).
@@ -5284,7 +5284,8 @@ but takes account of the heights and depths of glyphs.
 .
 .TPx
 .REG sb
-Depth of string below base line (generated by width function
+Depth of string below baseline
+(generated by width function
 .esc w ).
 .
 .TPx
@@ -5323,7 +5324,8 @@ function
 .
 .TPx
 .REG st
-Height of string above base line (generated by width function
+Height of string above baseline
+(generated by width function
 .esc w ).
 .
 .TPx
diff --git a/man/roff.7.man b/man/roff.7.man
index 9a75e778..9aaf753c 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -106,6 +106,14 @@ and many suggestions for further reading.
 .
 .
 .\" ====================================================================
+.\"SH Concepts
+.\" ====================================================================
+.\"
+.\" (text) baseline
+.\" vertical spacing
+.
+.
+.\" ====================================================================
 .SH History
 .\" ====================================================================
 .
diff --git a/src/include/font.h b/src/include/font.h
index f3f6bed0..08725861 100644
--- a/src/include/font.h
+++ b/src/include/font.h
@@ -120,14 +120,14 @@ public:
                        // (arg2).  Return the distance between the base
                        // line and the top of this rectangle.
                        // This is often also called the 'ascent' of the
-                       // glyph.  If the top is above the base line, this
+                       // glyph.  If the top is above the baseline, this
                        // value is positive.
   int get_depth(glyph *, int); // A rectangle represents the shape of the
                        // given glyph (arg1) at the given point size
                        // (arg2).  Return the distance between the base
                        // line and the bottom of this rectangle.
                        // This is often also called the 'descent' of the
-                       // glyph.  If the bottom is below the base line,
+                       // glyph.  If the bottom is below the baseline,
                        // this value is positive.
   int get_space_width(int);    // Return the normal width of a space at the
                        // given point size.