groff-commit
[Top][All Lists]
Advanced

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

[groff] 33/122: [man pages]: Apply the Dave Kemper scalpel.


From: G. Branden Robinson
Subject: [groff] 33/122: [man pages]: Apply the Dave Kemper scalpel.
Date: Wed, 11 Nov 2020 02:59:12 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 94f650ad473582f7dc7e624f2866a3f5c57d9d23
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Nov 8 10:43:42 2020 +1100

    [man pages]: Apply the Dave Kemper scalpel.
    
    * src/preproc/pic/pic.1.man:
    * src/preproc/preconv/preconv.1.man:
    * src/preproc/refer/refer.1.man:
    * tmac/groff_man.7.man.in: Drop use of "note that".  As Dave observes,
      why are we reading a manual if not to note things?
---
 src/preproc/pic/pic.1.man         | 10 ++++------
 src/preproc/preconv/preconv.1.man |  2 +-
 src/preproc/refer/refer.1.man     |  4 ++--
 tmac/groff_man.7.man.in           | 17 +++++++----------
 4 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 9984c55..a206f1b 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -614,7 +614,7 @@ Reset pre-defined variables
 If no arguments are given, reset all pre-defined variables to their
 default values.
 .
-Note that assigning a value to
+Assigning a value to
 .B scale
 also causes all pre-defined variables that control dimensions to be
 reset to their default values times the new value of scale.
@@ -1127,8 +1127,7 @@ Initially,
 .B arrowhead
 has a value of\ 1.
 .
-Note that solid arrow heads are always filled with the current outline
-color.
+Solid arrow heads are always filled with the current outline color.
 .
 .
 .LP
@@ -1164,8 +1163,8 @@ attribute will be rotated about the center of the object
 so that it is aligned in the direction from the start point
 to the end point of the object.
 .
-Note that this attribute will have no effect for objects whose start
-and end points are coincident.
+This attribute will have no effect on objects whose start and end points
+are coincident.
 .
 .
 .LP
@@ -1175,7 +1174,6 @@ is allowed
 .BI \[oq] expr \[cq]th
 is also allowed.
 .
-Note that
 .B \[cq]th
 is a single token: no space is allowed between the
 .B \[cq]
diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index 730f89d..eadc428 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -178,7 +178,7 @@ in which case assume Latin-1
 .
 .
 .PP
-Note that the coding tag and
+The coding tag and
 .I uchardet
 methods in the above procedure rely upon a seekable input stream;
 when
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 2535d3c..fd1c257 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -1547,7 +1547,7 @@ reversed so that the last name is first.
 .I expr
 with first names abbreviated.
 .
-Note that fields specified in the
+Fields specified in the
 .B abbreviate
 command are abbreviated before any labels are evaluated.
 .
@@ -1656,7 +1656,7 @@ the resulting label will also be a two-part label with 
the same first
 part as before merging,
 and so additional labels can be merged into it.
 .
-Note that it is permissible for the first part to be empty;
+It is permissible for the first part to be empty;
 this may be desirable for expressions used in the
 .B short\-label
 command.
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 45627aa..42724d9 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1111,7 +1111,6 @@ argument to
 .B .ME
 is placed at the end of the link text without intervening space.
 .
-Note that
 .I address
 may not be visible in the output text,
 particularly if the man page is being viewed as HTML.
@@ -1173,7 +1172,6 @@ argument to
 .B .UE
 is placed at the end of the link text without intervening space.
 .
-Note that
 .I URL
 may not be visible in the output text,
 particularly if the man page is being viewed as HTML.
@@ -2023,9 +2021,9 @@ of a man page look like this:
 .
 .
 .PP
-Note that the line starts with an apostrophe (\(aq),
+The line starts with an apostrophe (\(aq),
 not a dot,
-and that a single space character follows the double quote.
+and a single space character follows the double quote.
 .
 The
 .I word
@@ -2058,8 +2056,8 @@ and
 .BR .EN ,
 may be used freely.
 .
-Note that terminal devices are extremely limited in presentation of
-mathematical equations.
+Terminal devices are extremely limited in presentation of mathematical
+equations.
 _ifstyle()dnl
 .
 .
@@ -2430,7 +2428,7 @@ $ \ec
 .
 .
 .IP
-Note that when using this trick with the
+When using this trick with the
 .B .BI
 or
 .B .RI
@@ -2540,7 +2538,6 @@ if desired and if supported by your implementation.
 .
 .
 .IP
-Note that
 .B \efP
 reliably returns to the style in use immediately preceding the
 previous
@@ -3190,7 +3187,7 @@ encouraged to re-use them.
 .
 .
 .IP
-Note that the definitions for these macros are read after a page calls
+The definitions for these macros are read after a page calls
 .BR .TH ,
 so they will replace any macros of the same names preceding it in your
 file.
@@ -3247,7 +3244,7 @@ One way to achieve the latter is by placing the following 
at the end of
 .EE
 .RE
 .
-Note that the above request will produce a warning if
+The above request will produce a warning if
 .RI \%$HOME /\:\%man.local
 does not exist;
 you may wish to `include' one in



reply via email to

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