Bug#890842: xpdf.1: Some formatting improvements in the manual
Package: xpdf
Version: 3.04-5
Severity: minor
Tags: patch
Dear Maintainer,
Input file is xpdf.1
Test nr. 2: Fix warning from man/groff
<standard input>:221 (macro BI): only 1 argument, but more are expected
chk_manuals: Output is from: test-groff -Tutf8 -b -e -mandoc -rF0 -t -w w -z
####
Test nr. 5: Change <number>-<number> to <number>\(en<number> if it is
a numeric range
895:The xpdf software and documentation are copyright 1996-2014 Glyph &
#####
Test nr. 23: Change a HYPHEN-MINUS (code 0x55, 2D) to a dash
(minus) if it matches " -[:alpha:]" or \(aq-[:alpha:] (for options)
696: bind x "run(ls -l)"
#####
Test nr. 26: Split long lines (> 80).
xpdf.1: line 42 length 81
#####
Test nr. 27: Wrong distance between sentences or protect the indicator.
1) Separate the sentences; each begins on a new line.
See man-pages(7) and "info groff".
Or
2) Adjust space between sentences (two spaces),
3) or protect the indicator by adding "\&" after it.
The "indicator" is an "end-of-sentence character" (.!?).
832: bind ? any about
#####
Additionally:
have a space around '|', meaning 'or', making it more
readable.
adjust sentences only on the left side in the section "SEE ALSO" to
avoid too long a space between words.
#####
The patch:
--- xpdf.1 2017-11-25 00:15:13.000000000 +0000
+++ xpdf.1.new 2018-02-19 01:56:29.000000000 +0000
@@ -39,7 +39,8 @@ You can also start xpdf without opening
xpdf
.RE
.PP
-Various compressed formats (gz, bz2, xz, and Z) are also supported, for example::
+Various compressed formats (gz, bz2, xz, and Z) are also supported,
+for example::
.PP
.RS
xpdf file.pdf.gz
@@ -124,7 +125,7 @@ Enable or disable vector anti-aliasing.
.BI \-ps " PS-file"
Set the default file name for PostScript output (i.e., the name which
will appear in the print dialog). This can also be of the form
-\'|command' to pipe the PostScript through a command.
+\'| command' to pipe the PostScript through a command.
.RB "[config file: " psFile ]
.TP
.BI \-paper " size"
@@ -218,7 +219,7 @@ Open multiple pdf files:
etc. NOTE: The list of files is terminated once an argument starting with
a dash is encountered. In order to view file names starting with
a dash, simply append "./".
-.BI \-m
+.B \-m
may be used multiple times.
.PP
Several other standard X options and resources will work as expected:
@@ -278,8 +279,8 @@ Find a text string.
.B "print button"
Bring up a dialog for generating a PostScript file. The dialog has
options to set the pages to be printed and the PostScript file name.
-The file name can be '-' for stdout or '|command' to pipe the
-PostScript through a command, e.g., '|lpr'.
+The file name can be '-' for stdout or '| command' to pipe the
+PostScript through a command, e.g., '| lpr'.
.TP
.B "'?' button"
Bring up the 'about xpdf' window.
@@ -693,7 +694,7 @@ The external command string will often c
command must be quoted in the xpdfrc file:
.nf
- bind x "run(ls -l)"
+ bind x "run(ls \-l)"
.fi
.TP
@@ -829,7 +830,7 @@ The default key bindings are as follows:
bind alt-f any toggleFullScreenMode
bind ctrl-l any redraw
bind ctrl-w any closeWindowOrQuit
- bind ? any about
+ bind ?\& any about
bind q any quit
bind Q any quit
@@ -892,9 +893,10 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The xpdf software and documentation are copyright 1996-2014 Glyph &
+The xpdf software and documentation are copyright 1996\(en2014 Glyph &
Cog, LLC.
.SH "SEE ALSO"
+.ad l
.BR pdftops (1),
.BR pdftotext (1),
.BR pdftohtml (1),
-- System Information:
Debian Release: buster/sid
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.80-2 (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 xpdf depends on:
ii libc6 2.26-6
ii libgcc1 1:8-20180207-2
ii libpaper1 1.1.24+nmu5
ii libpoppler68 0.57.0-2
ii libstdc++6 8-20180207-2
ii libx11-6 2:1.6.4-3
ii libxm4 2.3.8-1
ii libxt6 1:1.1.5-1
Versions of packages xpdf recommends:
pn cups-bsd <none>
ii gsfonts-x11 0.25
ii poppler-data 0.4.8-2
ii poppler-utils 0.61.1-2
xpdf suggests no packages.
-- no debconf information
--
Bjarni I. Gislason
Reply to: