groff-commit
[Top][All Lists]
Advanced

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

[groff] 06/17: grn(1): Fix English style nits.


From: G. Branden Robinson
Subject: [groff] 06/17: grn(1): Fix English style nits.
Date: Fri, 13 Nov 2020 21:58:41 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 845ec123fa705712ea60d0bb972da4c7b871b5e8
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Nov 13 21:56:05 2020 +1100

    grn(1): Fix English style nits.
    
    * Hyphenate stranded prefix in compound expression.
    * Uncapitalize independent clause after colon (and don't precede it with
      an empty request).
    * Don't introduce lists with a sentence fragment.
    * Hyphenate "floating-point" (number(s)).
    * Use indefinite articles where warranted.
    * Heighten register: from "chopped" to "truncated".
    * Add comma to separate elements of a complex conjunction.
    * Use more idiomatic English.
---
 src/preproc/grn/grn.1.man | 37 ++++++++++++++++++-------------------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index d709c8b..aa7449e 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -148,7 +148,7 @@ command.
 Commands consist of one or two strings separated by white space,
 the first string being the command and the second its operand.
 .
-Commands may be upper or lower case and abbreviated down to one
+Commands may be upper- or lowercase and abbreviated down to one
 character.
 .
 .
@@ -158,11 +158,10 @@ Commands that affect a picture's environment
 .RB \%\[lq] default \[rq],
 see below)
 are only in effect for the current picture:
-.
-The environment is reinitialized to the defaults at the start of the
+the environment is reinitialized to the defaults at the start of the
 next picture.
 .
-The commands are as follows:
+The commands are as follows.
 .
 .
 .TP
@@ -253,7 +252,7 @@ Magnify the picture
 (in addition to any default magnification)
 by
 .IR N ,
-a floating point number larger than zero.
+a floating-point number larger than zero.
 .
 The command
 .B scale
@@ -592,20 +591,20 @@ version.
 means that
 .I gremlin
 will display things in horizontal format
-(drawing area wider than it is tall,
-with menu across top).
+(a drawing area wider than it is tall,
+with a menu across the top).
 .
 .B 1
 means that
 .I gremlin
 will display things in vertical format
-(drawing area taller than it is wide,
-with menu on left side).
+(a drawing area taller than it is wide,
+with a menu on the left side).
 .
 .B x
 and
 .B y
-are floating point values giving a positioning point to be used when
+are floating-point values giving a positioning point to be used when
 this file is read into another file.
 .
 The stuff on this line really isn't all that important;
@@ -620,7 +619,7 @@ After the last element specification is a line containing 
the string
 .
 .
 .IP \[bu]
-Lines longer than 127 characters are chopped to this limit.
+Lines longer than 127 characters are truncated to that length.
 .
 .
 .\" ====================================================================
@@ -674,7 +673,7 @@ Type Specifications in \fIgremlin\fP Files
 After the object type comes a variable number of lines,
 each specifying a point used to display the element.
 .
-Each line contains an x-coordinate and a y-coordinate in floating point
+Each line contains an x-coordinate and a y-coordinate in floating-point
 format,
 separated by spaces.
 .
@@ -696,7 +695,7 @@ The brush determines the style in which things are drawn.
 .
 For vectors,
 arcs,
-and curves there are six valid brush values:
+and curves there are six valid brush values.
 .sp
 .TS
 center, tab(@);
@@ -717,7 +716,7 @@ is valid.
 It specifies a polygon with an invisible border.
 .
 For text,
-the brush selects a font as follows:
+the brush selects a font as follows.
 .sp
 .TS
 center, tab(@);
@@ -732,7 +731,7 @@ If you're using
 .I \%@g@grn
 to run your pictures through
 .IR groff ,
-the font is really just a starting font:
+the font is really just a starting font.
 .
 The text string can contain formatting sequences like
 \[lq]\[rs]fI\[rq]
@@ -786,17 +785,17 @@ x-values range 116 to 511,
 and y-values from 0 to 483.
 .
 For horizontal pictures,
-x-values range from 0 to 511 and y-values range from 0 to 367.
+x-values range from 0 to 511,
+and y-values from 0 to 367.
 .
 Although you needn't absolutely stick to this range,
-you'll get best results if you at least stay in this vicinity.
+you'll get better results if you at least stay in this vicinity.
 .
 Also,
 point lists are terminated by a point of
 (\-1,
 \-1),
-so you
-shouldn't ever use negative coordinates.
+so you shouldn't ever use negative coordinates.
 .
 .I gremlin
 writes out coordinates using format \[lq]%f1.2\[rq]; it's probably



reply via email to

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