Bug#958728: dvi2tty.1: Correct some mistakes and typographic issues in the manual
Package: texlive-binaries
Version: 2019.20190605.51237-3
Severity: minor
Tags: patch
Dear Maintainer,
Summary:
Fix spelling of
cahracters
powerfull
Scandinavion
Delete repeated words.
Change '-' to '\-', if it is a minus.
Change "c.f." to "cf.", as this is one word.
Mark periods ('. ' or '.\n') with '\&', if they do not mean an end of a
sentence.
Add a comma after "e.g." and "i.e.", or use English words.
Change \\ to \e to print the escape character.
Remove space at end of lines.
Fix warnings from test-groff.
Change <number>[\]-<number> to <number>\(en<number> if it is
a numeric range.
Use the word 'valid' instead of "legal" (GNU coding standard).
Change a HYPHEN-MINUS (code 0x55, 2D) to a dash
(minus) if it matches " -[:alpha:]" or \[aq]-[:alpha:] (for options).
Use horizontal move function (\h'...') instead of a series of spaces.
####
Details:
Input file is dvi2tty.1
chk_man: Next line: execute mandoc -T lint dvi2tty.1
mandoc: dvi2tty.1:86:43: STYLE: whitespace at end of input line
mandoc: dvi2tty.1:1:15: WARNING: cannot parse date, using it verbatim: 13 November 1990
mandoc: dvi2tty.1:48:2: WARNING: skipping paragraph macro: PP empty
#######
Remove space characters at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
86:With a negative value the number of spaces
#####
Test nr. 2:
Enable and fix warnings from 'test-groff'.
Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z
[ "test-groff" is a developmental version of "groff" ]
Input file is ./dvi2tty.1
troff: backtrace: file '<dvi2tty.1>':86
troff: <dvi2tty.1>:86: warning: trailing space
####
---- End of tempfile -----
#####
Test nr. 5:
Change '-' (\-) to '\(en' (en-dash) for a numeric range.
dvi2tty.1:69:Legal range 16\-132.
#####
Test nr. 20:
Use "\e" to print the escape character instead of "\\" (which gets
interpreted in copy mode).
55:Numbers refer to TeX\-page numbers (known as \\count0).
128:terminals in Scandinavia are mapped to ``{|}[\\]''.
#####
Test nr. 22:
Use the word 'valid' instead of "legal" if not related to legal matters.
See "www.gnu.org/prep/standards".
Think about translations into other languages!
69:Legal range 16\-132.
#####
Test nr. 25:
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
29:ordinary ascii terminal, such as the '+' and '-' symbol.
110:Dvi2tty normally tries to output accented characters. With the -a option,
124:Note this may interfere with -s. Best not to use -u and -s together.
129:Note this may interfere with -u. Best not to use -u and -s together.
#####
Test nr. 27:
Find a repeated word
! 28 --> be
! 40 --> a
#####
Test nr. 35:
Add a comma after "e.g." and "i.e.", or use English words
(man-pages(7).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.
35:devices (e.g. laser printers). To show that a broken line is really
#####
Patch is in the attachment.
-- System Information:
Debian Release: bullseye/sid
APT prefers testing-proposed-updates
APT policy: (500, 'testing-proposed-updates'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 5.4.19-1 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages texlive-binaries depends on:
ii dpkg 1.19.7
ii install-info 6.7.0.dfsg.2-5
ii libc6 2.30-4
ii libcairo2 1.16.0-4
ii libfontconfig1 2.13.1-2+b1
ii libfreetype6 2.10.1-2
ii libgcc-s1 [libgcc1] 10-20200418-1
ii libgcc1 1:10-20200418-1
ii libgraphite2-3 1.3.14-1
ii libharfbuzz-icu0 2.6.4-1
ii libharfbuzz0b 2.6.4-1
ii libicu63 63.2-3
ii libkpathsea6 2019.20190605.51237-3
ii libmpfr6 4.0.2-1
ii libpaper1 1.1.28+b1
ii libpixman-1-0 0.36.0-1
ii libpng16-16 1.6.37-2
ii libptexenc1 2019.20190605.51237-3
ii libstdc++6 10-20200418-1
ii libsynctex2 2019.20190605.51237-3
ii libteckit0 2.5.8+ds2-5
ii libtexlua53 2019.20190605.51237-3
ii libtexluajit2 2019.20190605.51237-3
ii libx11-6 2:1.6.9-2
ii libxaw7 2:1.0.13-1+b2
ii libxi6 2:1.7.9-1
ii libxmu6 2:1.1.2-2+b3
ii libxpm4 1:3.5.12-1
ii libxt6 1:1.1.5-1+b3
ii libzzip-0-13 0.13.62-3.2
ii perl 5.30.0-10
ii t1utils 1.41-3
ii tex-common 6.14
ii zlib1g 1:1.2.11.dfsg-2
Versions of packages texlive-binaries recommends:
pn dvisvgm <none>
ii texlive-base 2019.20200302-1
texlive-binaries suggests no packages.
-- no debconf information
--
Bjarni I. Gislason
--- dvi2tty.1 2019-09-18 08:15:44.000000000 +0000
+++ dvi2tty.1.new 2020-04-24 17:14:34.000000000 +0000
@@ -25,19 +25,19 @@ representation of documents is naturally
In principle Font Changes are totally ignored, but
.I dvi2tty
recognizes
-a few mathematical and special symbols that can be be displayed on an
-ordinary ascii terminal, such as the '+' and '-' symbol.
+a few mathematical and special symbols that can be displayed on an
+ordinary ascii terminal, such as the '+' and '\-' symbol.
.PP
If the width of the output text requires more columns than fits
-in one line (c.f. the \-w option) it is broken into several lines by
+in one line (cf.\& the \-w option) it is broken into several lines by
.I dvi2tty
although they will be printed as one line on regular TeX output
-devices (e.g. laser printers). To show that a broken line is really
+devices (e.g., laser printers). To show that a broken line is really
just one logical line an asterisk (``*'') in the last position
means that the logical line is continued on the next physical
line output by
.I dvi2tty.
-Such a continuation line is started with a a space and an asterisk
+Such a continuation line is started with a space and an asterisk
in the first two columns.
.PP
Options may be specified in the environment variable DVI2TTY.
@@ -52,11 +52,11 @@ Write output to file ``file''.
.TP
.B \-p list
Print the pages chosen by list.
-Numbers refer to TeX\-page numbers (known as \\count0).
+Numbers refer to TeX\-page numbers (known as \ecount0).
An example of format for list is ``1,3:6,8''
to choose pages 1, 3 through 6 and 8.
Negative numbers can be used exactly as in TeX,
-e g \-1 comes before \-4 as in ``\-p\-1:\-4,17''.
+e.g., \-1 comes before \-4 as in ``\-p\-1:\-4,17''.
.TP
.B \-P list
Like \-p except that page numbers refer to
@@ -66,7 +66,7 @@ Negative numbers don't make a lot of sen
.B \-w n
Specify terminal width
.I n.
-Legal range 16\-132.
+Valid range 16\(en132.
Default is 80. If your terminal has the
ability to display in 132 columns it might
be a good idea to use \-w132 and toggle the
@@ -83,7 +83,7 @@ This may be the default on some systems
.TP
.B \-e n
This option can be used to influence the spacing between words.
-With a negative value the number of spaces
+With a negative value the number of spaces
between words becomes less, with a positive value it becomes more.
\-e\-11 seems to worked well.
.TP
@@ -100,14 +100,14 @@ This overrides the $PAGER and the defaul
.TP
.B \-Fprog
Use ``prog'' as program to pipe output into. Can be used to choose an
-alternate pager (e g ``-Fless'').
+alternate pager (e.g., ``\-Fless'').
.TP
.B \-t
\\tt fonts were used (instead of cm) to produce dvi file. (screen.sty
-is a powerfull mean to do that with LaTeX).
+is a powerful mean to do that with LaTeX).
.TP
.B \-a
-Dvi2tty normally tries to output accented characters. With the -a option,
+Dvi2tty normally tries to output accented characters. With the \-a option,
accented characters are output without the accent sign.
.TP
.B \-l
@@ -115,18 +115,18 @@ Mark page breaks with the two-character
to mark them with a form-feed character.
.TP
.B \-c
-Do not attempt to translate any characters (like the Scandinavion/latin1 mode)
+Do not attempt to translate any characters (like the Scandinavian/latin1 mode)
except when running in tt-font.
.TP
.B \-u
Toggle option to process certain latin1 characters. Use this if your output
-devices supports latin1 cahracters.
-Note this may interfere with -s. Best not to use -u and -s together.
+devices supports latin1 characters.
+Note this may interfere with \-s. Best not to use \-u and \-s together.
.TP
.B \-s
Toggle option to process the special Scandinavian characters that on most (?)
-terminals in Scandinavia are mapped to ``{|}[\\]''.
-Note this may interfere with -u. Best not to use -u and -s together.
+terminals in Scandinavia are mapped to ``{|}[\e]''.
+Note this may interfere with \-u. Best not to use \-u and \-s together.
.TP
.B \-J
Auto detect NTT JTeX, ASCII pTeX, and upTeX dvi format.
@@ -148,14 +148,13 @@ denotes EUC-JP, Shift_JIS, ISO-2022-JP,
Print the name of fonts when switching to it (and ending it). The delim
argument is used to delimit the fontname.
.SH FILES
-/bin/more \ \ \ \
-probably the default pager.
+.nr L1 \w'/bin/more \ \ \ \ '
+/bin/more\h'|\n(L1u'probably the default pager.
.SH ENVIRONMENT
-PAGER \ \ \ \ \ \ \ \ \ \ \ \
-the pager to use.
+.\".nr L1 \w'DVI2TTY '
+PAGER\h'|\n(L1u'the pager to use.
.br
-DVI2TTY \ \ \ \ \ \ \ \ \ \ \
-can be set to hold command-line options.
+DVI2TTY\h'|\n(L1u'can be set to hold command-line options.
.SH "SEE ALSO"
TeX, dvi2ps
.SH AUTHOR
Reply to: