groff-commit
[Top][All Lists]
Advanced

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

[groff] 03/10: doc/groff.texi: Fix content and style nits.


From: G. Branden Robinson
Subject: [groff] 03/10: doc/groff.texi: Fix content and style nits.
Date: Sat, 30 Oct 2021 19:26:33 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit d24fe7fcea20373b43d964c781ba678ee0269f44
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Oct 29 13:46:44 2021 +1100

    doc/groff.texi: Fix content and style nits.
    
    Content:
    * Be clearer whence the default hyphenation mode comes.
    
    Style:
    * Wean ourselves further off the term "adjust[ment]" when applying it to
      only one margin.
    * Say "uppercase" instead of "upper-case".
    * Drop superfluous comma.
    * Tighten wording.
---
 doc/groff.texi | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index ba809ca..d00264e 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5730,7 +5730,7 @@ used as operands to an arithmetic operator; 
@xref{Assigning Formats}.
 @cindex space characters, in expressions
 @cindex expressions, and space characters
 Due to the way arguments are parsed, spaces are not allowed in
-expressions, unless the entire expression is surrounded by parentheses.
+expressions unless the entire expression is surrounded by parentheses.
 @xref{Request and Macro Arguments}, and @ref{Conditionals and Loops}.
 
 
@@ -7177,12 +7177,12 @@ text without filling it.
 
 @item l
 @cindex ragged-right text
-Adjust text to the left margin, producing what is sometimes called
+Align text to the left margin, producing what is sometimes called
 ragged-right text.
 
 @item r
 @cindex ragged-left text
-Adjust text to the right margin, producing ragged-left text.
+Align text to the right margin, producing ragged-left text.
 @end table
 
 @var{mode} can also be a value previously stored in the @code{.j}
@@ -7312,7 +7312,7 @@ With no arguments, @code{ce} centers the next line of 
text.  @var{nnn}
 specifies the number of lines to be centered.  If the argument is zero
 or negative, centering is disabled.
 
-The basic length for centering text is the line length (as set with the
+The basis for centering text is the line length (as set with the
 @code{ll} request) minus the indentation (as set with the @code{in}
 request).  Temporary indentation is ignored.
 
@@ -7546,8 +7546,8 @@ The hyphenation character is associated with the 
environment
 Set the @dfn{soft hyphen character},@footnote{``Soft hyphen
 @emph{character}'' is a misnomer since it is an output glyph.} inserted
 when a word is hyphenated automatically or at a hyphenation character,
-to@tie{}@var{glyph}.@footnote{It is ``soft'' because it only appears in
-output where hyphenation is actually performed; a ``hard'' hyphen, as in
+to@tie{}@var{glyph}.@footnote{``Soft'' because it appears in output only
+where a hyphenation break is performed; a ``hard'' hyphen, as in
 ``long-term'', always appears.}  If the argument is omitted, the soft
 hyphen glyph is set to the default, @code{\[hy]}.  If the selected glyph
 does not exist in the font in use at a potential hyphenation point, then
@@ -7576,11 +7576,11 @@ with up to a certain amount of additional inter-word 
space (@code{hys}).
 @DefreqList {hy, [@Var{mode}]}
 @DefregListEndx {.hy}
 Set automatic hyphenation mode to @var{mode}, an integer encoding
-conditions for hyphenation; if omitted, 1 is implied.  The hyphenation
-mode is available in the read-only register @samp{.hy}; it is associated
-with the environment (@pxref{Environments}).  The default hyphenation
-mode depends on the language in use on the system; see the @code{hpf}
-request below.
+conditions for hyphenation; if omitted, @samp{1} is implied.  The
+hyphenation mode is available in the read-only register @samp{.hy}; it
+is associated with the environment (@pxref{Environments}).  The default
+hyphenation mode depends on the localization package loaded when GNU
+@code{troff} starts up; see the @code{hpf} request below.
 
 Typesetting practice generally does not avail itself of every
 opportunity for hyphenation, but the details differ by language and site
@@ -9418,7 +9418,7 @@ With no argument or using @samp{P} as an argument, 
@code{ft} switches
 to the previous font.  Use @code{\f[]} to do this with the escape.  The
 old syntax forms @code{\fP} or @code{\f[P]} are also supported.
 
-Fonts are generally specified as upper-case strings, which are usually
+Fonts are generally specified as uppercase strings, which are usually
 1@tie{}to 4 characters representing an abbreviation or acronym of the
 font name.  This is no limitation, just a convention.
 



reply via email to

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