Package: debianutils
Version: 5.7-0.4
Severity: minor
Tags: patch

Dear Maintainer,

here are a few remarks and fixes for the manual.

####

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

"groff -man -Z" instead of "nroff -man"

#####

Output from "mandoc -T lint run-parts.8":

mandoc: run-parts.8:12:2: WARNING: skipping paragraph macro: PP after SH
mandoc: run-parts.8:14:81: STYLE: input text line longer than 80 bytes: 
[\-\-test] [\-\-verb...
mandoc: run-parts.8:21:2: WARNING: skipping paragraph macro: PP after SH
mandoc: run-parts.8:117:2: WARNING: skipping paragraph macro: PP after SH
mandoc: run-parts.8:123:2: WARNING: skipping paragraph macro: PP after SH

#######

Reduce space between words.

33:in .dpkg\-old  or .dpkg\-dist or .dpkg\-new or .dpkg\-tmp, and must

#####

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).

33:in .dpkg\-old  or .dpkg\-dist or .dpkg\-new or .dpkg\-tmp, and must

#####

--- run-parts.8 2023-06-25 13:43:36.000000000 +0000
+++ run-parts.8.new     2023-06-25 13:55:27.000000000 +0000
@@ -9,7 +9,6 @@
 .SH NAME
 run\-parts \- run scripts or programs in a directory
 .SH SYNOPSIS
-.PP
 .B run\-parts
 [\-\-test] [\-\-verbose] [\-\-debug] [\-\-report] [\-\-lsbsysinit] 
[\-\-regex=RE]
 [\-\-umask=umask] [\-\-arg=argument] [\-\-exit\-on\-error] [\-\-help]
@@ -18,7 +17,6 @@ run\-parts \- run scripts or programs in
 .B run\-parts
 \-V
 .SH DESCRIPTION
-.PP
 .B run\-parts
 runs all the executable files named within constraints described below, found
 in directory
@@ -30,7 +28,7 @@ then the names must consist entirely of
 letters, ASCII digits, ASCII underscores, and ASCII minus-hyphens.
 
 If the \-\-lsbsysinit option is given, then the names must not end
-in .dpkg\-old  or .dpkg\-dist or .dpkg\-new or .dpkg\-tmp, and must
+in \&.dpkg\-old or \&.dpkg\-dist or \&.dpkg\-new or \&.dpkg\-tmp, and must
 belong to one or more of the following namespaces: the
 LANANA-assigned namespace (^[a\-z0\-9]+$); the LSB hierarchical and
 reserved namespaces (^_?([a\-z0\-9_.]+\-)+[a\-z0\-9]+$);
@@ -114,13 +112,11 @@ display usage information and exit.
 display version and copyright and exit.
 
 .SH EXAMPLES
-.P
 Print the names of all files in /etc that start with `p' and end with `d':
 .P
 run-parts \-\-list \-\-regex \[aq]^p.*d$\[aq] /etc
 
 .SH COPYRIGHT
-.P
 Copyright (C) 1994 Ian Jackson.
 .P
 Copyright (C) 1996 Jeff Noxon.


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

Kernel: Linux 6.3.7-1 (SMP w/2 CPU threads; PREEMPT)
Kernel taint flags: TAINT_WARN
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 debianutils depends on:
ii  libc6  2.36-9

debianutils recommends no packages.

debianutils suggests no packages.

-- no debconf information

Reply via email to