groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 04/18: doc/groff.texi: Fix style nits.


From: G. Branden Robinson
Subject: [groff] 04/18: doc/groff.texi: Fix style nits.
Date: Thu, 3 Jun 2021 11:03:20 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit d33339a6031bc10f37ea883344da6869037f28eb
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jun 1 21:10:55 2021 +1000

    doc/groff.texi: Fix style nits.
    
    * Vary wording (i.e., beat the "typically" drum less stridently).
    * Condense warning diagnostic in example.
    * Say "escape sequence" instead of the less formal "escape".
    * Reinforce syntactical equivalence of "macro files" and "macro
      packages" (and "roff documents", already established).
---
 doc/groff.texi | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index da4d84d..d02a357 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4738,7 +4738,7 @@ an automatic break, GNU @code{troff} adjusts the line if 
applicable (see
 below), and then resumes collecting and filling text on the next output
 line.
 
-Sometimes, a line cannot be broken automatically.  This typically does
+Sometimes, a line cannot be broken automatically.  This usually does
 not happen with natural language text unless the output line length has
 been manipulated to be extremely short, but it can with specialized
 text like program source code.  We can use @code{perl} at the shell
@@ -4860,8 +4860,8 @@ An input line beginning with a control character is 
called a
 @dfn{control line}.
 @cindex text line
 Every line of input that is not a control line is a @dfn{text
-line}.@footnote{The @key{\RET} escape can alter how an input line is
-classified; see @ref{Line Control}.}
+line}.@footnote{The @key{\RET} escape sequence can alter how an input
+line is classified; see @ref{Line Control}.}
 
 @cindex argument
 Requests often take @dfn{arguments}, words (separated from the request
@@ -5014,11 +5014,12 @@ the preparation of other @code{roff} documents.  There 
is no syntactical
 difference between a macro file and any other @code{roff} document; only
 its purpose distinguishes it.  When a macro file is installed at a
 standard location and suitable for use by a general audience, it is
-often termed a @dfn{macro package}.@footnote{Macro packages frequently
-define registers and strings as well.}  Macro packages can be loaded by
-supplying the @option{-m} option to @command{groff} or @command{troff}.
-Alternatively, a @code{groff} document wishing to use a macro package
-can load it with the @code{mso} (``macro source'') request.
+often termed a @dfn{macro package}.@footnote{Macro files and packages
+frequently define registers and strings as well.}  Macro packages can be
+loaded by supplying the @option{-m} option to @command{groff} or
+@command{troff}.  Alternatively, a @code{groff} document wishing to use
+a macro package can load it with the @code{mso} (``macro source'')
+request.
 
 @c ---------------------------------------------------------------------
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]