As long as we're still considering documentation fixes, here's another
set. These are all low urgency but also low risk, so depending on the
prevailing winds, they could go into this release or wait till the
next one.
The attached patch fixes some simple typos in documentation files and
comment lines that should be completely uncontroversial. Three other
possible changes might warrant further discussion (which might also
imply they're not good candidates for last-minute changes, but I offer
them for second opinions).
1. src/devices/grotty/grotty.1.man
Part of the documentation for -i says "most terminals (including
xterm) don't support this."
No doubt this was true when it was added (Feb 2002, commit
e30e96cf2e61dc8dced25f426b7615573916eee4), but today it's not true of
at least xterm or MacOS's Terminal. Is it true of enough modern
terminals to reduce it down to "many terminals" or "some terminals"?
Or should it just be removed altogether?
2. doc/groff.texi
Part of the documentation for -a says "this option is rather useless
today since graphic output devices are available virtually
everywhere." This seems a needless bit of editorializing -- and of
questionable accuracy, given that a recent thread on this list pointed
out the virtues of this option. For one, this sentence implies that
-a output has no use besides as a poor substitute for graphical
output. And the ubiquity of graphic-output devices doesn't mean
you're working in a session that has easy access to one (e.g., over
ssh).
The simplest fix is to axe this sentence. A better fix might be to
give the user ideas on how the option enables tasks (e.g., allowing
easy diffs of typeset output; grepping for widows; automated
regression testing; probably more) that are difficult or impossible
with PostScript and PDF output.
3. doc/groff.texi
Underlining by overstrike is described as "printing an underline
character, then moving the caret back one character position, and
printing the actual character at the same position as the underline
character."
I'm betting "moving the caret back" was intended to say "moving the
cursor back." If so, probably just shortening it to "moving back" is
just as clear (and arguably more accurate, as there's no cursor
involved).
diff --git a/contrib/groffer/main_subs.pl b/contrib/groffer/main_subs.pl
index 797d9d77..a40e356a 100644
--- a/contrib/groffer/main_subs.pl
+++ b/contrib/groffer/main_subs.pl
@@ -8,7 +8,7 @@
# Copyright (C) 2006-2018 Free Software Foundation, Inc.
# Written by Bernd Warken <groff-bernd.warken...@web.de>.
-# LAst update: 27 Aug 2015
+# Last update: 27 Aug 2015
# This file is part of 'groffer', which is part of 'groff'.
diff --git a/doc/groff.texi b/doc/groff.texi
index f8396dab..78da2f51 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -951,7 +951,7 @@ The section on the @file{man} macro package is partly based on
Susan@tie{}G.@: Kleinmann's @file{groff_man} manual page written for the
Debian GNU/Linux system.
-Larry Kollar contributed the section in the @file{ms} macro package.
+Larry Kollar contributed the section on the @file{ms} macro package.
diff --git a/doc/meref.me b/doc/meref.me
index d8c744d2..43e93e36 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -213,7 +213,7 @@ defined in this section
or the
.b .sh
macro
-(defined in the next session),
+(defined in the next section),
the effects of changing parameters
which will have a global effect
on the format of the page
diff --git a/tmac/e.tmac-u b/tmac/e.tmac-u
index cba8fbc9..96afd99f 100644
--- a/tmac/e.tmac-u
+++ b/tmac/e.tmac-u
@@ -215,7 +215,7 @@
.\}
..
.
-.de ef \" *** define even foot
+.de ef \" *** define even footer
.ie !\\n(.$ \
. rm |6
.el \
