[groff] 04/20: [docs]: Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f776ec0e04be40dc17136db7e32926363dfc55b5
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 19 16:17:50 2022 -0600

    [docs]: Fix style nits.
    
    * Adjust dead-tree pagination to avoid widows and orphans.
    * Tigten wording.
    * Sync our Texinfo manual with groff(7).
---
 doc/groff.texi  |  6 +++---
 man/groff.7.man | 17 +++++++++--------
 2 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 5a9b7fdbc..1a8e4dc71 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12072,9 +12072,9 @@ sequence immediately adjacent to the last character of 
the string.
 .ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\" water
 @endExample
 
-It is good style to end string definitions (and appendments; see below)
-with a comment, even an empty one, to prevent unwanted space from
-creeping into them during source document maintenance.
+Ending string definitions (and appendments) with a comment, even an
+empty one, prevents unwanted space from creeping into them during source
+document maintenance.
 
 @Example
 .ds author Alice Pleasance Liddell\"
diff --git a/man/groff.7.man b/man/groff.7.man
index d34e2334f..1c323602f 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -754,6 +754,8 @@ in basic units.
 .
 The only constraint on the basic unit is that it is at least as small as
 any other unit.
+.\" That's a fib.  A device resolution of around 2^31 would surely also
+.\" cause problems.  But nobody does that.
 .
 .
 .P
@@ -1211,6 +1213,8 @@ The
 escape sequence tests its argument for validity as a numeric expression.
 .
 .
+.br
+.ne 2v
 .P
 A register interpolated as an operand in a numeric expression must have
 an Arabic format;
@@ -1428,12 +1432,11 @@ and
 requests,
 respectively.
 .
-When writing a macro,
+Within a macro definition,
 .\" you might wish to know
-use the
+register
 .B .br
-register to determine
-which control character was used to call it.
+indicates the control character used to call it.
 .\" END Keep (roughly) parallel with groff.texi node "Control
 .\" Characters".
 .
@@ -5079,11 +5082,11 @@ the second argument to these requests consumes the 
remainder of the
 input line,
 including trailing spaces.
 .
-It is good style to end string definitions
+Ending string definitions
 (and appendments)
 with a comment,
 even an empty one,
-to prevent unwanted space from creeping into them during source document
+prevents unwanted space from creeping into them during source document
 maintenance.
 .
 .
@@ -6736,8 +6739,6 @@ and device-independent intermediate output formats 
described by
 CSTR\~#54 are documented in
 .MR groff_diff @MAN7EXT@ .
 .
-.
-.P
 .I groff
 provides an AT&T compatibility mode;
 see