[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 03/04: NEWS, ChangeLog: Fix a bad habit I picked up.
From: |
G. Branden Robinson |
Subject: |
[groff] 03/04: NEWS, ChangeLog: Fix a bad habit I picked up. |
Date: |
Tue, 30 Jun 2020 09:47:15 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit a682ddac2fb602ce9688aa2c25f5a36dceee13ce
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jun 30 23:31:30 2020 +1000
NEWS, ChangeLog: Fix a bad habit I picked up.
Refer to the groff Texinfo manual as...the groff Texinfo manual (NEWS),
or the slightly more casual "our Texinfo manual" (ChangeLog, a record of
developer-to-developer communication).
Texinfo itself has a fine manual and I've been been reading it lately.
Muddy, ambiguous terminology is a vice.
---
ChangeLog | 17 +++++++++--------
NEWS | 6 +++---
2 files changed, 12 insertions(+), 11 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 93e1f96..c7a7af0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -17,13 +17,14 @@
* src/devices/grotty/grotty.1.man (Description/Legacy output
format): Make slight wording changes prompted by content of
- parallel section in Texinfo manual.
+ parallel section in our Texinfo manual.
* src/roff/groff/groff.1.man (Options/-a): Parallelize with
- first sentence of corresponding material in Texinfo manual.
+ first sentence of corresponding material in our Texinfo
+ manual.
* src/roff/troff/troff.1.man (Options/-a): Parallelize with
- Texinfo manual.
+ our Texinfo manual.
Fixes the rest of
<https://savannah.gnu.org/bugs/index.php?55278>.
@@ -45,8 +46,8 @@
* man/groff.7.man (Numerical Expressions): Fix error: negative
expressions evaluate false, not true as was implied.
- Parallelize descriptions with Texinfo and groff_diff(7) (in
- abbreviated form).
+ Parallelize descriptions with our Texinfo manual and
+ groff_diff(7) (in abbreviated form).
2020-05-18 G. Branden Robinson <g.branden.robinson@gmail.com>
@@ -567,7 +568,7 @@
Correct and clarify point size documentation.
- The Texinfo manual has long documented the request '.ps 0' as
+ Our Texinfo manual has long documented the request '.ps 0' as
restoring the previous point size (just as '\s0' or '.ps' with
no argument does), but this is incorrect; since groff 1.02 or
earlier (June 1991), the request has not actually worked this
@@ -709,7 +710,7 @@
of date and did not correspond to recent releases of groff. If
you want all warnings on, use the ".warn" request with no
arguments in your ms document or pass "-w w" to groff (see
- troff(1) or the Texinfo manual for more on warnings).
+ troff(1) or our Texinfo manual for more on warnings).
Thanks to Bjarni Ingi Gislason for bringing this issue to our
attention.
@@ -1124,7 +1125,7 @@
2018-12-14 G. Branden Robinson <g.branden.robinson@gmail.com>
* doc/groff.texi: Drop documentation of "man" macro package from
- Texinfo manual. The mdoc, me, mm, and mom packages all
+ our Texinfo manual. The mdoc, me, mm, and mom packages all
maintain their documentation externally to this manual as
well. Exception: portions not about man proper--which are not
duplicated from groff_man(7)--on use of man.local (including
diff --git a/NEWS b/NEWS
index 136b436..ce931b9 100644
--- a/NEWS
+++ b/NEWS
@@ -15,7 +15,7 @@ Troff
o A new read-only register ".cp" is implemented. Within a .do request,
"\n[.cp]" holds the saved value of compatibility mode. See
- groff_diff(7) or the Texinfo manual for rationale, use case, and
+ groff_diff(7) or the groff Texinfo manual for rationale, use case, and
example.
o Point-size escapes of the form '\sNN', where NN is in the range 10-39,
@@ -102,8 +102,8 @@ o The an (man) macro package supports new CS and CT number
registers to
o The s (ms) macro package no longer manipulates the warning level. If
you want all warnings on, use the ".warn" request with no arguments in
- your ms document or pass "-w w" to groff (see troff(1) or the Texinfo
- manual for more on warnings).
+ your ms document or pass "-w w" to groff (see troff(1) or the groff
+ Texinfo manual for more on warnings).
Miscellaneous
-------------
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 03/04: NEWS, ChangeLog: Fix a bad habit I picked up.,
G. Branden Robinson <=