Package: expect
Version: 5.45.4-3
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 <file1> > <out1>
  nroff -man <file2> > <out2>
  diff -u <out1> <out2>

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 expect_mkpasswd.1": (possibly shortened list)

mandoc: expect_mkpasswd.1:51:96: STYLE: input text line longer than 80 bytes: 
flag defines the min...
mandoc: expect_mkpasswd.1:56:96: STYLE: input text line longer than 80 bytes: 
flag defines the min...
mandoc: expect_mkpasswd.1:61:83: STYLE: input text line longer than 80 bytes: 
flag defines the min...

-.-.

Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, u[2010]) in the output.

39:     mkpasswd -l 20
47:     mkpasswd -d 3
85:     mkpasswd -l 15 -d 3 -C 5

-.-.

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.

expect_mkpasswd.1: line 51 length 96
flag defines the minimum number of lowercase alphabetic characters that must be 
in the password.

expect_mkpasswd.1: line 56 length 96
flag defines the minimum number of uppercase alphabetic characters that must be 
in the password.

expect_mkpasswd.1: line 61 length 83
flag defines the minimum number of special characters that must be in the 
password.

-.-.

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

Kernel: Linux 6.7.12-amd64 (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 expect depends on:
ii  libc6       2.38-11
ii  libtcl8.6   8.6.14+dfsg-1
ii  tcl-expect  5.45.4-3
ii  tcl8.6      8.6.14+dfsg-1

expect recommends no packages.

Versions of packages expect suggests:
ii  tk8.6  8.6.14-1

-- no debconf information

Reply via email to