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