Package: whois
Version: 5.5.3
Severity: minor
Tags: patch

  _Not all affected lines are changed in the patch!_
  Short description of changes:

Fix warnings from test-groff.

Change -- in x--y to \(em (em-dash), or, if an
option, to "\-\-".

Change a two-fonts macro to an one-font macro for a
single argument.

Use a macro to change to the italic font.

Change a HYPHEN-MINUS (code 0x55, 2D) to a dash
(minus) if it matches " -[:alpha:]" or \(aq-[:alpha:] (for options).

Begin a sentence on a new line.

Use \(en for a dash where appropriate.

Add a missing right italic correction or use a macro.


Split a punctuation from a single argument for a two-fonts marco


Set the name of a man page in bold but the section in roman.

####

Long description with the associated lines:

Input file is mkpasswd.1

chk_man: Next line: execute mandoc -T lint mkpasswd.1
mandoc: mkpasswd.1:1:16: WARNING: cannot parse date, using it verbatim: 21 
March 2008
mandoc: mkpasswd.1:8:2: WARNING: skipping paragraph macro: PP empty

#######

chk_man: Next line: execute doclifter -w -v mkpasswd.1
mkpasswd.1 uses man macros...
"mkpasswd.1", line 51: warning - variable-list header just before section break
"mkpasswd.1": warning - portability warning: nonportable requests 'end' seen.


#######

Test nr. 2:

Enable and fix warnings from 'test-groff'.

Input file is ./mkpasswd.1

<mkpasswd.1>:6 (macro BR): only 1 argument, but more are expected
<mkpasswd.1>:7 (macro BR): only 1 argument, but more are expected
<mkpasswd.1>:12 (macro BR): only 1 argument, but more are expected
<mkpasswd.1>:52 (macro IR): only 1 argument, but more are expected
<mkpasswd.1>:53 (macro IR): only 1 argument, but more are expected
<mkpasswd.1>:54 (macro IR): only 1 argument, but more are expected
<mkpasswd.1>:55 (macro IR): only 1 argument, but more are expected
<mkpasswd.1>:56 (macro IR): only 1 argument, but more are expected
<mkpasswd.1>:57 (macro IR): only 1 argument, but more are expected

Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z

  [ "test-groff" is a developmental version of "groff" ]

####

Test nr. 13:

Change -- in x--y to \(em (em-dash), or, if an
option, to \-\-

16:.B -S, --salt=STRING
19:.B -R, --rounds=NUMBER
23:The behavior is undefined if this option is used without \fI--method\fP.
25:.B -m, --method=TYPE
32:Like \fI--method=md5\fP.
34:.B -P, --password-fd=NUM
40:.B -s, --stdin
41:Like \fI--password-fd=0\fP.
47:If the \fI--stdin\fP option is used, passwords containing some control

#####

Test nr. 16:

Use the correct macro for the font change of a single argument.

6:.BR PASSWORD
7:.BR SALT

#####

Test nr. 21:

Use a macro to change to the italic font, instead of \fI [1], if
possible.
The macros have the italic corrections, but "\c" removes the "\/" part.

  Or

add the italic corrections.
[1] man-pages(7) [package "manpages"]

17:Use the \fISTRING\fP as salt. It must not contain prefixes such as \fI$1$\fP.
20:Use \fINUMBER\fP rounds. This argument is ignored if the method chosen
23:The behavior is undefined if this option is used without \fI--method\fP.
26:Compute the password using the \fITYPE\fP method.
27:If \fITYPE\fP is \fIhelp\fP then the available methods are printed.
28:If \fITYPE\fP begins and end with \fI$\fP characters then the string
29:is passed to \fIcrypt_gensalt(3)\fP as-is.
32:Like \fI--method=md5\fP.
35:Read the password from file descriptor \fINUM\fP instead of using
36:\fIgetpass(3)\fP.
41:Like \fI--password-fd=0\fP.
47:If the \fI--stdin\fP option is used, passwords containing some control
60:and this man page were written by Marco d'Itri <\f...@linux.it\fP>

#####

Test nr. 25:

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

16:.B -S, --salt=STRING
19:.B -R, --rounds=NUMBER
25:.B -m, --method=TYPE
34:.B -P, --password-fd=NUM
40:.B -s, --stdin

#####

Test nr. 41:

Wrong distance between sentences or protect the indicator.

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

Or

b) Adjust space between sentences (two spaces),

c) or protect the indicator by adding "\&" after it.

The "indicator" is an "end-of-sentence character" (.!?).

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

17:Use the \fISTRING\fP as salt. It must not contain prefixes such as \fI$1$\fP.
20:Use \fINUMBER\fP rounds. This argument is ignored if the method chosen
21:does not support variable rounds. For the OpenBSD Blowfish method this is

#####

Test nr. 46:

Add a missing right italic correction after \fI (and before "\f[BPR]"), or use 
a macro

60:and this man page were written by Marco d'Itri <\f...@linux.it\fP>

#####

Test nr. 52:

Split a punctuation mark from a single argument for a two-fonts marco

52:.IR passwd(1),
53:.IR passwd(5),
54:.IR crypt(3),
55:.IR crypt(5),
56:.IR crypt_gensalt(3),

#####

Test nr. 53:

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

3:mkpasswd \- Overfeatured front end to crypt(3)
12:.BR crypt(3)
29:is passed to \fIcrypt_gensalt(3)\fP as-is.
36:\fIgetpass(3)\fP.
52:.IR passwd(1),
53:.IR passwd(5),
54:.IR crypt(3),
55:.IR crypt(5),
56:.IR crypt_gensalt(3),
57:.IR getpass(3)

#####

  Patch:

--- mkpasswd.1  2019-11-17 20:33:50.000000000 +0000
+++ mkpasswd.1.new      2019-11-24 02:33:56.000000000 +0000
@@ -3,45 +3,57 @@
 mkpasswd \- Overfeatured front end to crypt(3)
 .SH SYNOPSIS
 .B mkpasswd
-.BR PASSWORD
-.BR SALT
+.B PASSWORD
+.B SALT
 .PP
 .SH DESCRIPTION
 .B mkpasswd
 encrypts the given password with the
-.BR crypt(3)
+.BR crypt (3)
 libc function using the given salt.
 .SH OPTIONS
 .TP
-.B -S, --salt=STRING
-Use the \fISTRING\fP as salt. It must not contain prefixes such as \fI$1$\fP.
+.BR \-S ", "\c
+.BI \-\-salt= STRING
+Use the \fISTRING\fP as salt.
+It must not contain prefixes such as \fI$1$\fP.
 .TP
-.B -R, --rounds=NUMBER
-Use \fINUMBER\fP rounds. This argument is ignored if the method chosen
-does not support variable rounds. For the OpenBSD Blowfish method this is
+.BR \-R ", "\c
+.BI \-\-rounds= NUMBER
+Use \fINUMBER\fP rounds.
+This argument is ignored if the method chosen
+does not support variable rounds.
+For the OpenBSD Blowfish method this is
 the logarithm of the number of rounds.
-The behavior is undefined if this option is used without \fI--method\fP.
+The behavior is undefined if this option is used without
+.IR \-\-method .
 .TP
-.B -m, --method=TYPE
+.BR \-m ", "\c
+.BI \-\-method= TYPE
 Compute the password using the \fITYPE\fP method.
 If \fITYPE\fP is \fIhelp\fP then the available methods are printed.
 If \fITYPE\fP begins and end with \fI$\fP characters then the string
-is passed to \fIcrypt_gensalt(3)\fP as-is.
+is passed to
+.IR crypt_gensalt (3)
+as-is.
 .TP
 .B -5
-Like \fI--method=md5\fP.
+Like
+.IR \-\-method=md5 .
 .TP
-.B -P, --password-fd=NUM
+.BR \-P ", "\c
+.BI \-\-password-fd= NUM
 Read the password from file descriptor \fINUM\fP instead of using
-\fIgetpass(3)\fP.
+.IR getpass (3).
 If the file descriptor is not connected to a tty then no other message
 than the hashed password is printed on stdout.
 .TP
-.B -s, --stdin
-Like \fI--password-fd=0\fP.
+.BR  \-s ", " \-\-stdin
+Like
+.IR \-\-password-fd=0 .
 .SH "ENVIRONMENT"
 .IP "MKPASSWD_OPTIONS"
-A list of options which will be evalued before the ones specified on the
+A list of options which will be evaluated before the ones specified on the
 command line.
 .SH BUGS
 If the \fI--stdin\fP option is used, passwords containing some control
@@ -49,15 +61,15 @@ characters may not be read correctly.
 .TP
 This programs suffers of a bad case of featuritis.
 .SH "SEE ALSO"
-.IR passwd(1),
-.IR passwd(5),
-.IR crypt(3),
-.IR crypt(5),
-.IR crypt_gensalt(3),
-.IR getpass(3)
+.IR passwd (1),
+.IR passwd (5),
+.IR crypt (3),
+.IR crypt (5),
+.IR crypt_gensalt (3),
+.IR getpass (3)
 .SH AUTHOR
 .B mkpasswd
-and this man page were written by Marco d'Itri <\f...@linux.it\fP>
+and this man page were written by Marco d'Itri
+.RI < m...@linux.it >
 and are licensed under the terms of the GNU General Public License,
 version 2 or higher.
-


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

Kernel: Linux 5.3.9-3 (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 whois depends on:
ii  libc6  2.29-3

whois recommends no packages.

whois suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason

Reply via email to