[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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 33/122: [man pages]: Apply the Dave Kemper scalpel.,
G. Branden Robinson <=