Package: mailcap
Version: 3.70+nmu1
Severity: minor
Tags: patch
Dear Maintainer,
here are some notes and editorial fixes for the manual.
The patch is in the attachment.
-.-
The difference between the formatted outputs can be seen with:
nroff -man >
nroff -man >
diff -u
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "
instead of "nroff -man"
Add the option "-t", if the file contains a table.
Read the output of "diff -u" with "less -R" or similar.
-.-.
If "man" (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint run-mailcap.1":
mandoc: run-mailcap.1:7:83: STYLE: input text line longer than 80 bytes:
run-mailcap, view, s...
mandoc: run-mailcap.1:25:2: WARNING: skipping paragraph macro: PP after SH
mandoc: run-mailcap.1:83:81: STYLE: input text line longer than 80 bytes: A
temporary symbolic...
-.-.
Use the correct macro for the font change of a single argument or
split the argument into two.
64:.IR cat
74:.BI \-\-debug
77:.BI \-\-nopager
80:.BI \-\-norun
-.-.
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
46:(.Z). A filename of "-" can be used to mean "standard input", but
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
run-mailcap.1: line 7 length 83
run-mailcap, view, see, edit, compose, print \- execute programs via entries in
the
run-mailcap.1: line 83 length 81
A temporary symbolic link to the file is opened if the file name matches the
Perl
-.-.
Translate the character "~" (tilde) to "\(ti" to make it more visible
in the output of "troff".
51: Both the user's files (~/.mailcap; ~/.mime.types) and the system files
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (990, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.4.13-1 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages mailcap depends on:
ii media-types 10.1.0
ii perl 5.36.0-7
Versions of packages mailcap recommends:
ii bzip2 1.0.8-5+b1
ii file 1:5.45-2
ii xz-utils 5.4.4-0.1
mailcap suggests no packages.
-- no debconf information
The difference between the formatted outputs can be seen with:
nroff -man >
nroff -man >
diff -u
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "
instead of "nroff -man"
Add the option "-t", if the file contains a table.
Read the output of "diff -u" with "less -R" or similar.
-.-.
If "man" (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint run-mailcap.1":
mandoc: run-mailcap.1:7:83: STYLE: input text line longer than 80 bytes:
run-mailcap, view, s...
mandoc: run-mailcap.1:25:2: WARNING: skipping paragraph macro: PP after SH
mandoc: run-mailcap.1:83:81: STYLE: input text line longer than 80 bytes: A
temporary symbolic...
-.-.
Use the correct macro for the font change of a single argument or
split the argument into two.
64:.IR cat
74:.BI \-\-debug
77:.BI \-\-nopager
80:.BI \-\-norun
-.-.
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.
46:(.Z). A filename of "-" can be used to mean "standard input", but
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
run-mailcap.1: line 7 length 83
run-mailcap, view, see, edit, compose, print \- execute programs via entries in
the
run-mailcap.1: line 83 length 81
A temporary symbolic link to the file is opened if the file name matches the
Perl
-.-.
Translate the character "~" (tilde) to "\(ti" to make it more visible
in the output of "troff".
51: Both the user's files (~/.mailcap; ~/.mime.types) and the system files