[groff] 28/40: roff(7): Rename new (sub)section and fix nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b6296d8fb243f2673c1720045a944c3179ae3014
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Feb 5 10:49:43 2022 +1100

    roff(7): Rename new (sub)section and fix nits.
    
    * Rename "groff elements" to "Language elements" and demote it to a
      subsection.
    * Stop quoting period/dot and neutral apostrophe when they're already in
      parentheses.
    * Update cross-reference to correctly point to groff(7) page, since it
      was previously internal.
    * Drop misleading implication that other *roffs don't have .cc, .c2,
      .ec, or .eo requests.
    * Drop some examples of syntax and request names; the enclosing section
      is entitled "Concepts" and that should be our focus.  groff(7) has the
      particulars.
    * Recast discussion of registers.  Introduce "scaling unit" term.
    * Downcase "roman" when used as a typeface style.
---
 man/roff.7.man | 73 ++++++++++++++++++----------------------------------------
 1 file changed, 22 insertions(+), 51 deletions(-)

diff --git a/man/roff.7.man b/man/roff.7.man
index 4e04eeba..f2cf0f41 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -242,7 +242,7 @@ least bear vertical margins larger than one vee.
 .
 .
 .\" ====================================================================
-.SH "\f[I]groff\f[] elements"
+.SS "Language elements"
 .\" ====================================================================
 .
 Lines of input to any
@@ -257,11 +257,11 @@ A
 starts with the
 .I control character,
 a dot
-.RB (\[lq] .\& \[rq])
+.RB ( .\& )
 or the
 .I no-break control character,
 a neutral apostrophe
-.RB (\[lq] \[aq] \[rq]).
+.RB ( \[aq] ).
 .
 Either control character is followed by zero or more spaces or tabs
 and then an optional
@@ -278,8 +278,9 @@ separated from the request name and each other only by 
spaces.
 Any input line that is not a control line is a
 .I text line.
 .
-See section \[lq]Line continuation\[rq] below for an exception to this
-rule.
+See section \[lq]Line continuation\[rq] in
+.MR groff @MAN7EXT@
+for an exception to this rule.
 .
 Text lines generally become formatted output.
 .
@@ -302,20 +303,16 @@ They can appear anywhere in the input.
 .
 .P
 With requests,
-the escape and control characters can be changed and,
-in
-.I groff,
-the escape mechanism can be turned off and back on.
+the escape and control characters can be changed;
+further,
+escape sequence recognition can be turned off and back on.
 .
 .
 .P
 .I Macros
 permit the extension or replacement of the request repertoire.
 .
-Requests like
-.request .de
-(shown here with a leading control character to clarify its identity)
-can be invoked to define a macro,
+Certain requests can be invoked to define a macro,
 a user-directed abbreviation for a collection of input lines.
 .
 Macros are called on control lines much as requests are invoked,
@@ -335,26 +332,20 @@ Its contents are then parsed normally.
 .I Strings
 store character sequences.
 .
-They are defined with the
-.request .ds
-request and interpolated with the
-.esc *
-escape sequence.
-.
-Strings can be parameterized as macros can.
+In
+.IR groff ,
+they can be parameterized as macros can.
 .
 .
 .P
 .I Registers
-store numerical values.
-.
-They are set with the
-.request .nr
-request or
-.esc R
-escape sequence and interpolated with the
-.esc n
-escape sequence.
+store numerical values,
+including measurements.
+.
+The latter are generally in basic units;
+.I scaling units
+can be appended to numeric expressions to clarify their meaning when
+stored or interpolated.
 .
 Some read-only predefined registers interpolate text.
 .
@@ -364,16 +355,10 @@ Some read-only predefined registers interpolate text.
 are identified either by a name or by a mounting position
 (a non-negative number).
 .
-A font is selected for glyph rendering by the
-.request .ft
-request or by the
-.esc f
-escape sequence.
-.
 Four font styles are available on all devices.
 .
 .B R
-is \[lq]Roman\[rq]:
+is \[lq]roman\[rq]:
 normal,
 upright text.
 .
@@ -408,19 +393,6 @@ for glyph rendering and drawing of geometric primitives.
 Stroke and fill colors are distinct;
 the stroke color is used for glyphs.
 .
-Colors are defined with the
-.request .defcolor
-request,
-and selected with the
-.request .gcolor
-and
-.request .fcolor
-requests or
-.esc m
-and
-.esc M
-escape sequences.
-.
 .
 .P
 .I Glyphs
@@ -472,7 +444,6 @@ see
 A further few language elements arise as page layouts become more
 sophisticated and demanding.
 .
-.
 .I Environments
 collect formatting parameters like line length and typeface.
 .
@@ -488,7 +459,7 @@ that is associated with a macro,
 causing it to be called when that condition is fulfilled.
 .
 .
-.\" TODO: Move this paragraph to our Texinfo manual and roff(7).
+.\" TODO: Copy this paragraph to our Texinfo manual.
 .P
 Footnote support often exercises all three of the foregoing features.
 .