Bug#1038601: tcpspy.8: remarks and editing fixes for the manual

[Bjarni Ingi Gislason]

Package: tcpspy
Version: 1.7d-15
Severity: minor
Tags: patch

Dear Maintainer,

here are some remarks and fixes for the manual.

Input file is tcpspy.8

Output from "mandoc  -T lint tcpspy.8":

mandoc: tcpspy.8:3:51: STYLE: whitespace at end of input line
mandoc: tcpspy.8:52:2: WARNING: skipping paragraph macro: PP empty
mandoc: tcpspy.8:117:2: WARNING: skipping paragraph macro: PP empty
mandoc: tcpspy.8:176:81: STYLE: input text line longer than 80 bytes: a default 
mask with ...
mandoc: tcpspy.8:187:71: STYLE: whitespace at end of input line
mandoc: tcpspy.8:194:73: STYLE: whitespace at end of input line
mandoc: tcpspy.8:260:85: STYLE: input text line longer than 80 bytes: tcpspy 
\-e 'not radd...

###

Remove space characters at the end of lines.

Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

3:.\" Copyright (c) 2000, 2001, 2002 Tim J. Robbins. 
5:.\" 
16:.\" 
187:True if the full filename (including directory) of the executable that 
194:The pattern "" (an empty string) matches connections created/accepted by 

#

Reduce space between words.

202:Expressions (including the  comparisons listed above) may be joined together

#

Use the correct macro for the font change of a single argument or
split the argument into two.

135:.BI ip
138:.BI ip6

#

Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.

34:.RB [ "-dp" ]
35:.RB [ "-e"
37:.RB [ "-f"
39:.RB [ "-F"
41:.RB [ "-I"
43:.RB [ "-U"
45:.RB [ "-G"
55:.BI -e " 'rule'"
60:.BI -f " rulefile"
67:.B -e
69:.B -f
72:.BI -F " facility"
79:.BI -I " interval"
89:.BI -U " user"
94:.BI -G " group"
99:.B -U
101:.B -G
104:.B -d
109:.B -p
120:.B -e
155:.I -high
198:.B -p

#

Wrong distance between sentences.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.

50:syslog. The following information is logged: username, local address and 
port,
56:Log only connections matching the specified rule. Rule syntax is outlined
57:below. If this option is specified more than once, connections matching any
58:of the specified rules are logged. You should quote the rule, as shown above.
63:Each rule is on a new line. The `#' character may be used to add comments;
75:instead of the compile-time default setting. See the
82:milliseconds, instead of the default of 1000 ms. Connections that last less
156:is used, low is assumed to be 0. It is an error to omit both
175:AND of the local address of the connection and "mask". If no mask is 
specified,
176:a default mask with all bits set (255.255.255.255) is used. The CIDR type 
netmask
177:is also possible. With IPv6 only a prefix length netmask is allowed, and the
178:length defaults to 128. Depending on the address family, these rules contain
224:Rules are evaluated from left to right. Whitespace (space, tab and newline)
225:characters are ignored between "words". Rules consisting of only whitespace
273:Tim J. Robbins 

#

Use \(en for a dash (en-dash) between space characters, not a minus
(\-) or a hyphen (-), except in the NAME section.

tcpspy.8:145:.BI lport " [low] - [high]"

#

Protect a period (.) or a apostrophe (') with '\&' from becoming a
control character, if it could end up at the start of a line (by
splitting the line into more lines).

227:Parentheses, '(' and ')' may be placed around expressions to affect the 
order

#

"[" and "]", showing optional arguments to options, should be typeset in roman.

145:.BI lport " [low] - [high]"
169:.BI laddr " n.n.n.n[/m.m.m.m]"
173:.BI laddr " ip6-addr[/m]"

#

--- tcpspy.82023-06-18 17:56:03.0 +
+++ tcpspy.8.new2023-06-18 19:01:15.0 +
@@ -1,8 +1,8 @@
 .\" This file is part of tcpspy, a TCP/IP connection monitor.
 .\"
-.\" Copyright (c) 2000, 2001, 2002 Tim J. Robbins. 
+.\" Copyright (c) 2000, 2001, 2002 Tim J. Robbins.
 .\" All rights reserved.
-.\" 
+.\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -13,7 +13,7 @@
 .\"documentation and/or other materials provided with the distribution.
 .\" 3. The name of the author may not be used to endorse or promote products
 .\"derived from this software without specific prior written permission.
-.\" 
+.\"
 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
 .\" INCLUDING, BUT NOT LIMITED TO

Bug#1038597: tcpspy.rules.5: some remarks and editing fixes for the manual

[Bjarni Ingi Gislason]

Package: tcpspy
Version: 1.7d-15
Severity: minor
Tags: patch

Dear Maintainer,

here are some editing fixes of the man page with remarks.

Input file is tcpspy.rules.5

Output from "mandoc  -T lint tcpspy.rules.5":

mandoc: tcpspy.rules.5:36:2: WARNING: skipping paragraph macro: PP after SH
mandoc: tcpspy.rules.5:40:24: STYLE: whitespace at end of input line
mandoc: tcpspy.rules.5:69:2: WARNING: skipping paragraph macro: PP empty
mandoc: tcpspy.rules.5:70:2: WARNING: skipping paragraph macro: PP empty
mandoc: tcpspy.rules.5:124:81: STYLE: input text line longer than 80 bytes: a 
default mask with ...
mandoc: tcpspy.rules.5:135:71: STYLE: whitespace at end of input line
mandoc: tcpspy.rules.5:142:73: STYLE: whitespace at end of input line
mandoc: tcpspy.rules.5:177: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".

40:.IR /etc/init.d/tcpspy 
135:True if the full filename (including directory) of the executable that 
142:The pattern "" (an empty string) matches connections created/accepted by 

#

Reduce space between words.

150:Expressions (including the  comparisons listed above) may be joined together
196:Pablo Lorenzzoni (this manpage) and  Mats Erik Andersson (changes for IPv6)

#

Use the correct macro for the font change of a single argument or
split the argument into two.

40:.IR /etc/init.d/tcpspy 
83:.BI ip
86:.BI ip6

#

Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.

103:.I -high
146:.B -p

#

Wrong distance between sentences.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.

104:is used, low is assumed to be 0. It is an error to omit both
123:AND of the local address of the connection and "mask". If no mask is 
specified,
124:a default mask with all bits set (255.255.255.255) is used. The CIDR type 
netmask
125:is also possible. With IPv6 only a prefix length netmask is allowed, and the
126:length defaults to 128. Depending on the address family, these rules contain
172:Rules are evaluated from left to right. Whitespace (space, tab and newline)
173:characters are ignored between "words". Rules consisting of only whitespace
195:Tim J. Robbins (tcpspy),

#

Use \(en for a dash (en-dash) between space characters, not a minus
(\-) or a hyphen (-), except in the NAME section.

tcpspy.rules.5:55:to 4 rules (line 1 to line 4 - one per each line) using the 
boolean
tcpspy.rules.5:60:line 1 - for user "joedoe" connecting to 192.168.1.10:22 
(remote)
tcpspy.rules.5:62:line 2 - for user whose UID is 1003
tcpspy.rules.5:64:line 3 - to *:22 or *:21 (both locally)
tcpspy.rules.5:66:line 4 - for user "joedoe" to *:23 (local) or to 192.168.1.20 
(remote)
tcpspy.rules.5:71:.SS "Rule Syntax - just extracted from tcpspy(8)"
tcpspy.rules.5:93:.BI lport " [low] - [high]"

#

The name of a man page is set in bold type and the section in roman (see
man-pages(7)).

42:tcpspy (see tcpspy(8)) logger filtering rules.

#

Protect a period (.) or a apostrophe (') with '\&' from becoming a
control character, if it could end up at the start of a line (by
splitting the line into more lines).

175:Parentheses, '(' and ')' may be placed around expressions to affect the 
order

#

--- tcpspy.rules.5  2023-06-18 02:25:13.0 +
+++ tcpspy.rules.5.new  2023-06-18 17:42:52.0 +
@@ -33,13 +33,15 @@
 .SH NAME
 tcpspy.rules \- configuration file for tcpspy
 .SH DESCRIPTION
-.LP
 This file, by default
 .IR /etc/tcpspy.rules ,
 is read by the
-.IR /etc/init.d/tcpspy 
+.I /etc/init.d/tcpspy
 script at init time in order to configure
-tcpspy (see tcpspy(8)) logger filtering rules.
+tcpspy
+(see
+.BR tcpspy (8))
+logger filtering rules.
 .LP
 It might look like:
 .IP
@@ -52,23 +54,21 @@ lport 22 or lport 21
 .fi
 .LP
 This rules file specifies that tcpspy logs tcp connections according
-to 4 rules (line 1 to line 4 - one per each line) using the boolean
+to 4 rules (line 1 to line 4 \(en one per each line) using the boolean
 logic (see below) to evaluate each rule.
 .LP
 This particular example logs connections:
 .TP
-line 1 - for user "joedoe" connecting to 192.168.1.10:22 (remote)
+line 1 \(en for user "joedoe" connecting to 192.168.1.10:22 (remote)
 .TP
-line 2 - for user whose UID is 1003
+line 2 \(en for user whose UID is 1003
 .TP
-line 3 - to 

Bug#1037552: manpages: bad code

[Bjarni Ingi Gislason]

Package: docbook-xsl
Version: 1.79.2+dfsg-2
Severity: normal

Dear Maintainer,

  here are some remarks about the creation of man pages with an example
from "valgrind.1".



  Examples of bad formatting codes in the output from

DocBook XSL Stylesheets vsnapshot 

for a man page.

Example file is valgrind.1

Output from "mandoc  -T lint valgrind.1"

mandoc: valgrind.1:36:2: WARNING: skipping paragraph macro: PP after SH
mandoc: valgrind.1:38:304: STYLE: input text line longer than 80 bytes: is a 
flexible progra...

  and more.

###

Lines with \c before lines that contain only '\}'.
Here the '\c' is redundant.

The Code block

.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}

  should be in a macro or this should be enough

.IP \(bu 3m\" adjust width of the indent

#

Remove space characters at the end of lines.

Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

838:==15380== 
842:==15380== 
863:==15377== 
868:==15377== 
890:==15363== 
913:==15370== 

#

Mark a full stop (.) with "\&",
if it does not mean an end of a sentence,
that is use ".\&".

This is a preventive action,
the paragraph could be reshaped, e.g., after changes.

When typing, one does not always notice when the line wraps after the
period.
There are too many examples of input lines in manuals,
that end with an abbreviation point.

This marking is robust, and independent of the position on the line.

It corresponds to "\ " in TeX, and to "@:" in Texinfo.

DO NOT PUT "\&" randomly in front of a full stop).  Only when the full
stop is

1) at the start of a line

2) after a space character

that is

sed -e 's/^\./\\\&./' -e '/ \./ \\\&./g'

Similar applies to the single quote ('),
which is a control character in front of a command (request).

52:\fItoolname\fR, e\&.g\&. memcheck, cachegrind, callgrind, helgrind, drd, 
massif, dhat, lackey, none, exp\-bbv, etc\&.
102:\fB\-\-trace\-children\-skip=patt1,patt2,\&.\&.\&. \fR

#

Use a font macro (.I, .B) for a font change if possible.

See man-pages(7).

52:\fItoolname\fR, e\&.g\&. memcheck, cachegrind, callgrind, helgrind, drd, 
massif, dhat, lackey, none, exp\-bbv, etc\&.
88:\fIexec\fR
92:\fIfork\fR
94:\fIfork\fR
96:\fIfork\fR
98:\fIexec\fR
123:\fIfork\fR
125:\fI\-\-trace\-children=\fR\&. Use of this option is also strongly 
recommended if you are requesting XML output (\fI\-\-xml=yes\fR), since 
otherwise the XML from child and parent may become mixed up, which usually 
makes it useless\&.
218:\fIv\&.info open_fds\fR\&. Along with each file descriptor is printed a 
stack backtrace of where the file was opened and any details relating to the 
file descriptor such as the file name or socket details\&. Use
255:\fIFOO\fR\&. If the

#

Use the word "(in)valid" instead of "(il)legal" if not related to legal
matters.
See "www.gnu.org/prep/standards".
Think about translations into other languages!

valgrind.1:442:Enable/disable printing of illegal instruction diagnostics\&. 
Enabled by default, but defaults to disabled when
valgrind.1:446:When enabled, a warning message will be printed, along with some 
diagnostics, whenever an instruction is encountered that Valgrind cannot decode 
or translate, before the program is given a SIGILL signal\&. Often an illegal 
instruction indicates a bug in the program or missing support for the 
particular instruction in Valgrind\&. But some programs do deliberately try to 
execute an instruction that might be missing and trap the SIGILL signal to 
detect processor features\&. Using this flag makes it possible to avoid the 
diagnostic output that you would otherwise get in such cases\&.
valgrind.1:1925:\fIyes\fR, such loads do not produce an address error\&. 
Instead, loaded bytes originating from illegal addresses are marked as 
uninitialised, and those corresponding to legal addresses are handled in the 
normal way\&.
valgrind.1:1928:\fIno\fR, loads from partially invalid addresses are treated 
the same as loads from completely invalid addresses: an illegal\-address error 
is issued, and the resulting bytes are marked as initialised\&.

#

Add a hair space (\^) around "|" to increase readability

85:\fB\-\-trace\-children= [default: no] \fR
120:\fB\-\-child\-silent\-after\-fork= [default: no] \fR
128:\fB\-\-vgdb= [default: yes] \fR
215:\fB\-\-track\-fds= [default: no] \fR

#

Wrong distance between sentences.

APPLIES ALSO TO THE SOURCE FILE.

a) Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) and "info groff".

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

  The amount of space between sentences in the output can then be
contro

Bug#971930: a2ps-lpr-wrapper.1: fix some typographic issues

[Bjarni Ingi Gislason]

On Tue, Dec 29, 2020 at 08:16:30PM -0800, Vagrant Cascadian wrote:
> Control: tags 971930 - patch
> 
[...]
> Thanks for the patch!
> 
> Unfortunately it cannot be applied to the package, as a2ps-lpr-wrapper.1
> is generated from debian/manpages/a2ps-lpr-wrapper.sgml:
> 
>   
> https://browse.dgit.debian.org/a2ps.git/tree/debian/manpages/a2ps-lpr-wrapper.sgml
> 
> In debian/rules:
> 
>   https://browse.dgit.debian.org/a2ps.git/tree/debian/rules#n27
> 
> 
> Can you update your patch to apply to the .sgml source?
> 
> 

  A diff-file for the sgml-file is in the first attachment.

  There is a missing command in the sgml-file,
that suppresses a space character after a '' command.

  The example is where one line ends with '' and
the next line begins with '',
resulting in two space characters between words.

  The addition of '\&' before a period in the middle or
end of a word is wrong.

  The output of programs, that transform docbook files to man files,
needs postprocessing.

  A shell script for the postprocessing is in a second attachment.


-- 
Bjarni I. G�slason
--- a2ps-lpr-wrapper.sgml   2021-01-08 23:40:51.0 +
+++ a2ps-lpr-wrapper.sgml.new   2021-01-09 01:22:00.0 +
@@ -63,23 +63,21 @@ manpage.1: manpage.sgml
 
   &dhpackage;
 
-  -d printer
-
-  files
+  \-d printer
+  files
 
   
   
 DESCRIPTION
 
 This manual page documents briefly the
-  &dhpackage;
-  command.
+  &dhpackage; command.
 
 &dhpackage; uses either
   lp or lpr to send
-  files to printer. 
It
-  determines which of the two programs is currently installed and adds the
-  appropriate parameters.
+  files to printer.
+  It determines which of the two programs is currently installed and
+  adds the appropriate parameters.
 
   
   
@@ -87,15 +85,13 @@ manpage.1: manpage.sgml
 
 
   
--d printer
-
+\-d printer
 
   Destination system printer.
 
   
   
-files
-
+files
 
   List of files to be printed.
 
@@ -105,7 +101,7 @@ manpage.1: manpage.sgml
   
 SEE ALSO
 
-a2ps (1).
+a2ps(1).
 
 The programs are documented fully by the a2ps documentation 
available via the
   Info system.
@@ -116,13 +112,12 @@ manpage.1: manpage.sgml
 This manual page was written by &dhusername; &dhemail; for
   the &debian; system (but may be used by others).  Permission is
   granted to copy, distribute and/or modify this document under
-  the terms of the &gnu; General Public License, Version 2 any 
- later version published by the Free Software Foundation.
+  the terms of the &gnu; General Public License, Version 2 any
+  later version published by the Free Software Foundation.
+
+  On Debian systems, the complete text of the GNU General Public
+  License can be found in /usr/share/common-licenses/GPL.
 
-   
- On Debian systems, the complete text of the GNU General Public
- License can be found in /usr/share/common-licenses/GPL.
-   
 
   
 
#!/bin/sh
set -efu

# Skip lines with comments.
# Skip tables.
# Remove trailing spaces.
# Remove .PP after .SH and .SH.
# Remove '\&' before a period inside or after a word.
#  '\&' suppresses kerning between characters on both sides of it
# Break lines after a punctuation mark, before a parentheses,


sed -e '/\\"/n' -e '/^\.TS,^\.TE/n' \
  -e 's/  *$//' -e '/^\.S[SH]/{n; /\.PP/d}' -e 's/\([^ ]\)\\&\./\1./g' \
  -e 's/\([^ ][.,;!]\)  */\1\n/g' -e 's/ (/\n(/g' $1

Bug#971930: a2ps-lpr-wrapper.1: fix some typographic issues

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: minor
Tags: patch

Dear Maintainer,

Fix warnings from "mandoc -T lint" (superfluous macro ".PP").

Fix warnings from test-groff (space at the end of an argument).

Reduce space between words.

Begin a sentence on a new line.

Remove an unnecessary second font change.

Use ".BR" for references for a manual page.

###

Patch:

--- a2ps-lpr-wrapper.1  2020-10-08 20:32:56.0 +
+++ a2ps-lpr-wrapper.1.new  2020-10-08 23:24:03.0 +
@@ -2,31 +2,27 @@
 .SH "NAME"
 a2ps-lpr-wrapper \(em lp/lpr wrapper script for GNU a2ps on Debian
 .SH "SYNOPSIS"
-.PP
-\fBa2ps-lpr-wrapper\fR [\fB-d \fIprinter\fR\fP]  [\fB\fIfiles\fR\fP]
+\fBa2ps-lpr-wrapper\fR [\fB-d \fIprinter\fR] [\fB\fIfiles\fR]
 .SH "DESCRIPTION"
-.PP
 This manual page documents briefly the
-\fBa2ps-lpr-wrapper\fR   command.
+\fBa2ps-lpr-wrapper\fR command.
 .PP
 \fBa2ps-lpr-wrapper\fR uses either
 \fBlp\fP or \fBlpr\fP to send
-\fIfiles\fR to \fIprinter\fR. It
-determines which of the two programs is currently installed and adds the
-appropriate parameters.
+\fIfiles\fR to \fIprinter\fR.
+It determines which of the two programs is currently installed and
+adds the appropriate parameters.
 .SH "OPTIONS"
-.IP "\fB-d \fIprinter\fR\fP " 10
+.IP "\fB-d \fIprinter\fR" 10
 Destination system printer.
-.IP "\fB\fIfiles\fR\fP " 10
+.IP \fIfiles\fR 10
 List of files to be printed.
 .SH "SEE ALSO"
-.PP
-a2ps (1).
+.BR a2ps (1).
 .PP
 The programs are documented fully by the a2ps documentation available via the
 \fBInfo\fP system.
 .SH "AUTHOR"
-.PP
 This manual page was written by Michael Tautschnig tauts...@model.in.tum.de for
 the \fBDebian\fP system (but may be used by others).  Permission is
 granted to copy, distribute and/or modify this document under



-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages a2ps depends on:
ii  file   1:5.38-5
ii  libc6  2.31-3
ii  libpaper1  1.1.28+b1
ii  psutils1.17.dfsg-4

Versions of packages a2ps recommends:
ii  bzip2 1.0.8-4
pn  lpr | rlpr | cups-client  
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971822: ogongify.1: fix some formatting in the manual

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: minor
Tags: patch

Dear Maintainer,

  the only change in the output is

1) \- (minus) replaces - for options (only visible in "troff" output)

2) Two spaces (if groff request ".ss .. 0" is not used) after an end of
a sentence instead of a single space.

Patch:

--- ogonkify.1  2020-10-08 02:05:19.0 +
+++ ogonkify.1.new  2020-10-08 02:09:27.0 +
@@ -79,9 +79,9 @@ Includes the specified procset in the ou
 
 .TP
 .B \-e
-Set the encoding of the output. Defaults to
+Set the encoding of the output.  Defaults to
 .B L2
-(ISO 8859\-2, a.k.a. ISO Latin\-2). Other possible values are
+(ISO 8859\-2, a.k.a. ISO Latin\-2).  Other possible values are
 .B L1
 (ISO 8859\-1, a.k.a. ISO Latin\-1),
 .B L3
@@ -198,9 +198,9 @@ processing.
 Do
 .B mp
 processing.  Will not work with the
-.B -A
+.B \-A
 option (use
-.B -C
+.B \-C
 instead).
 
 .TP
@@ -236,15 +236,15 @@ End options.
 
 .SH USAGE
 Let us assume that you want to print a WWW page encoded in
-ISO Latin\-2. Netscape stubbornly insists on printing it as
-ISO Latin\-1. By using the File->Print command, have Netscape send the
+ISO Latin\-2.  Netscape stubbornly insists on printing it as
+ISO Latin\-1.  By using the File->Print command, have Netscape send the
 output to a file, say alamakota.ps.
 
 As
 .B ogonkify
 is configured for ISO Latin\-2 by default, passing it the PostScript
-generated by Netscape will correct the encoding of the fonts. It is
-enough to do:
+generated by Netscape will correct the encoding of the fonts.
+It is enough to do:
 .IP
 % ogonkify \-N 
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971821: fixnt.1: fix formatting of references to manuals

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: minor
Tags: patch

Dear Maintainer,

  see man-pages(7), about formatting of references to man pages (bold
typeface).

Patch:

--- fixnt.1 2020-10-08 01:50:28.0 +
+++ fixnt.1.new 2020-10-08 01:51:55.0 +
@@ -11,7 +11,8 @@ fixnt \- Filter for the Windows NT posts
 The Windows NT postscript driver has a tendency to make broken postscript
 files, that are incompatible with psutils.
 .B fixnt
-is a filter that fixes these problems, allowing the use of psnup(1).
+is a filter that fixes these problems, allowing the use of
+.BR psnup (1).
 .PP
 The filter takes the broken postscript file on
 .BR stdin ,
@@ -24,7 +25,9 @@ It has no other form for invocation and
 takes no options.
 .SH BUGS
 .B fixnt
-does not check for NTPSOct94.  For a workaround, use a sed(1) command
+does not check for NTPSOct94.  For a workaround, use a
+.BR sed (1)
+command
 to replace 'NTPSOct94' with 'NTPSOct95', like so:
 .RS
 sed 's/NTPSOct94/NTPSOct95/g'
@@ -40,4 +43,5 @@ Report bugs to the Authors, but avoid se
 .P
 Patches are always welcome; send to .
 .SH "SEE ALSO"
-psnup(1), sed(1)
+.BR psnup (1),
+.BR sed (1)


-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages a2ps depends on:
ii  file   1:5.38-5
ii  libc6  2.31-3
ii  libpaper1  1.1.28+b1
ii  psutils1.17.dfsg-4

Versions of packages a2ps recommends:
ii  bzip2 1.0.8-4
pn  lpr | rlpr | cups-client  
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971820: composeglyphs.1: Remove a repeated word

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: minor
Tags: patch

Dear Maintainer,

  remove a repeated word "that".

Patch:

--- composeglyphs.1 2020-10-08 01:39:14.0 +
+++ composeglyphs.1.new 2020-10-08 01:42:57.0 +
@@ -18,7 +18,7 @@ composeglyphs \- generate an encoding ve
 .B composeglyphs
 is a script to generate either an encoding vector or a new
 font for postscript.  It requires a pre-existing AFM and allows
-for the use of composite characters that that AFM does not already
+for the use of composite characters that AFM does not already
 provide.
 .SH OPTIONS
 .TP


-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages a2ps depends on:
ii  file   1:5.38-5
ii  libc6  2.31-3
ii  libpaper1  1.1.28+b1
ii  psutils1.17.dfsg-4

Versions of packages a2ps recommends:
ii  bzip2 1.0.8-4
pn  lpr | rlpr | cups-client  
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971819: manuals created with a "help2man" version that is far too old

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: normal

Dear Maintainer,

  the used version of "help2man" is from the year 1999 (version 1.019).

  It should not be local in the package.

  The current version is from the year 2020 (version 1.47.16).


-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages a2ps depends on:
ii  file   1:5.38-5
ii  libc6  2.31-3
ii  libpaper1  1.1.28+b1
ii  psutils1.17.dfsg-4

Versions of packages a2ps recommends:
ii  bzip2 1.0.8-4
pn  lpr | rlpr | cups-client  
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971817: Some manuals have trailing spaces

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: minor

Dear Maintainer,

  some manuals in this package contain trailing spaces.
These should be removed before the files are compressed.

a2ps-lpr-wrapper.1.gz

composeglyphs.1.gz

fixnt.1.gz

ogonkify.1.gz

-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages a2ps depends on:
ii  file   1:5.38-5
ii  libc6  2.31-3
ii  libpaper1  1.1.28+b1
ii  psutils1.17.dfsg-4

Versions of packages a2ps recommends:
ii  bzip2 1.0.8-4
pn  lpr | rlpr | cups-client  
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971818: ogonkify.1: fix a misuse of a two-font macro

[Bjarni Ingi Gislason]

Package: a2ps
Version: 1:4.14-5
Severity: minor
Tags: patch

Dear Maintainer,

  correct the misuse of a two-fonts macro, which function is to

1) use the first font for each odd numbered argument and the second
font for all others.

2) join the arguments without an intervening space.

###

Patch:

--- ogonkify.1  2020-10-08 00:04:50.0 +
+++ ogonkify.1.new  2020-10-08 00:07:48.0 +
@@ -139,7 +139,7 @@ Helvetica.
 .TP
 .B \-A
 Like
-.BR \-a
+.B \-a
 but also downloads the Courier\-Ogonki fonts.
 
 .TP


-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.10-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages a2ps depends on:
ii  file   1:5.38-5
ii  libc6  2.31-3
ii  libpaper1  1.1.28+b1
ii  psutils1.17.dfsg-4

Versions of packages a2ps recommends:
ii  bzip2 1.0.8-4
pn  lpr | rlpr | cups-client  
ii  wdiff 1.2.2-2+b1

Versions of packages a2ps suggests:
ii  emacsen-common   3.0.4
ii  ghostscript  9.52.1~dfsg-1
pn  graphicsmagick-imagemagick-compat | imagemagick  
ii  groff1.22.4-5
ii  gv   1:3.7.4-2+b1
pn  html2ps  
pn  t1-cyrillic  
ii  texlive-binaries [texlive-base-bin]  2020.20200327.54578-5

-- no debconf information

-- 
Bjarni I. Gislason

Bug#971239: grap.1: Some mistakes in the manual

[Bjarni Ingi Gislason]

Package: grap
Version: 1.45-3
Severity: minor

Dear Maintainer,

  Misspelled words:

comarisons

retore

  Trailing space:

There is a lot of instances of a space character at the end of a line.

  Other mistakes:

The warnings from "mandoc -T lint" should be fixed.

-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.8.7-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages grap depends on:
ii  libc6   2.31-3
ii  libgcc-s1   10.2.0-9
ii  libstdc++6  10.2.0-9

Versions of packages grap recommends:
ii  groff  1.22.4-5

grap suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason

Bug#970206: "pylint doclifter" produces a lot of warnings

[Bjarni Ingi Gislason]

Package: doclifter
Version: 2.19-2
Severity: normal

Dear Maintainer,

   * What led up to the situation?

  Issuing "doclifter groff_diff.7", which produced a few lines on
standard error.

   * What exactly did you do (or not do) that was effective (or
 ineffective)?

  Running "pylint /usr/bin/doclifter"

   * What was the outcome of this action?

  A lot of warnings, issues.


-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.7.17-1 (SMP w/2 CPU threads)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages doclifter depends on:
ii  python3  3.8.2-3

Versions of packages doclifter recommends:
ii  groff-base  1.22.4-5
pn  plotutils   

doclifter suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason

Bug#927908: xpdf: Italic text is shown as a regular one

[Bjarni Ingi Gislason]

Package: xpdf
Version: 3.04-13
Severity: normal

  This can be fixed by adding the following to the ~/.xpdrc file

fontFile Times-Italic /usr/share/fonts/type1/gsfonts/n021023l.pfb
fontFile Times-Roman  /usr/share/fonts/type1/gsfonts/n021003l.pfb

N.B.

  The URL for new versions is wrong.

  A new version of the software is avilable.

-- System Information:
Debian Release: buster/sid
  APT prefers testing-proposed-updates
  APT policy: (500, 'testing-proposed-updates'), (500, 'unstable'), (500, 
'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.19.28-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.28-8
ii  libgcc1   1:8.3.0-6
ii  libpaper1 1.1.26
ii  libpoppler82  0.71.0-3
ii  libstdc++68.3.0-6
ii  libx11-6  2:1.6.7-1
ii  libxm42.3.8-2
ii  libxt61:1.1.5-1+b3

Versions of packages xpdf recommends:
pn  cups-bsd
ii  gsfonts-x11 0.26
ii  poppler-data0.4.9-2
ii  poppler-utils   0.71.0-3
ii  sensible-utils  0.0.12

xpdf suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason

Bug#890842: xpdf.1: Some formatting improvements in the manual

[Bjarni Ingi Gislason]

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

: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 - to \(en 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.0 +
+++ xpdf.1.new  2018-02-19 01:56:29.0 +
@@ -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++68-20180207-2
ii  libx11-6  2:1.6.4-3
ii  libxm42.3.8-1
ii  libxt61:1.1.5-1

Versions of packages xpdf recommends:
pn  cups-bsd   
ii  gsfonts-x110.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