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

Dear Maintainer,

here are some notes and a fix for the man page.

####

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"

#####

  Spelling mistakes:

intsall
pkgintsall

#####

  Only "skipping paragraph ..." is in the patch.

  Use "sed" to remove trailing space.

  Use "git apply ... --whitespace=fix" to fix extra space issues, or
use global configuration "core.whitespace".

  Report defects to the creator.

27:.\" created by instant / docbook-to-man, Sun 13 Jan 2008, 09:40 


Output from "mandoc -T lint discover-pkginstall.8":

mandoc: discover-pkginstall.8:1:2: WARNING: missing date, using "": TH
mandoc: discover-pkginstall.8:1:31: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:2:12: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:3:83: STYLE: input text line longer than 80 
bytes: discover-pkginstall ...
mandoc: discover-pkginstall.8:3:83: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:4:16: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:5:2: WARNING: skipping paragraph macro: PP after 
SH
mandoc: discover-pkginstall.8:5:4: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:6:47: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:7:19: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:8:2: WARNING: skipping paragraph macro: PP after 
SH
mandoc: discover-pkginstall.8:8:4: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:9:49: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:10:65: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:11:61: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:12:64: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:13:64: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:14:30: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:15:15: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:16:19: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:17:32: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:18:19: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:19:25: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:20:51: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:21:6: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:22:19: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:23:12: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:24:16: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:25:2: WARNING: skipping paragraph macro: PP after 
SH
mandoc: discover-pkginstall.8:25:4: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:26:46: STYLE: whitespace at end of input line
mandoc: discover-pkginstall.8:27:64: STYLE: whitespace at end of input line

#######

Reduce space between words.

6:\fBdiscover-pkginstall\fR [\-l]  [\-n]  [\-v]  

#####

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

16:.IP "\fB-l\fP" 10 
18:.IP "\fB-n\fP" 10 
22:.IP "\fB-v\fP" 10 

#####

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

26:aptitude(8), discover(1), module-assistant(8) 

#####

  Not in the patch.

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

Input file is ./discover-pkginstall.8

Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w-z -rSTYLECHECK=3":

an.tmac:<stdin>:1: style: .TH missing third argument; suggest document
modification date in ISO 8601 format (YYYY-MM-DD)

an.tmac:<stdin>:1: style: .TH missing fourth argument; suggest
package/project name and version (e.g., "groff 1.23.0")

####

--- discover-pkginstall.8       2023-06-25 19:23:06.000000000 +0000
+++ discover-pkginstall.8.new   2023-06-25 19:53:03.000000000 +0000
@@ -1,11 +1,9 @@
-.TH "discover-pkgintsall" "8" 
+.TH "discover-pkginstall" "8" 
 .SH "NAME" 
-discover-pkginstall \(em intsall packages for available hardware using 
discover(1) 
+discover-pkginstall \(em install packages for available hardware using 
discover(1) 
 .SH "SYNOPSIS" 
-.PP 
-\fBdiscover-pkginstall\fR [\-l]  [\-n]  [\-v]  
+\fBdiscover-pkginstall\fR [\-l] [\-n] [\-v]  
 .SH "Description" 
-.PP 
 \fBdiscover-pkginstall\fR install packages based 
 on detected hardware.  It will use the discover-data database to 
 map for hardware to debian packages, install the packages by 
@@ -13,15 +11,16 @@ default.  Packages using module-assistan
 built and the result installed if module-assistant is installed 
 or pulled in as a dependency. 
 .SH "Options" 
-.IP "\fB-l\fP" 10 
+.IP "\fB\-l\fP" 10 
 Only list the detected packages 
-.IP "\fB-n\fP" 10 
+.IP "\fB\-n\fP" 10 
 Echo the \fBaptitude and 
 module-assistant\fR invocations instead of running 
 them. 
-.IP "\fB-v\fP" 10 
+.IP "\fB\-v\fP" 10 
 Be verbose. 
 .SH "See Also" 
-.PP 
-aptitude(8), discover(1), module-assistant(8) 
+.BR aptitude (8),
+.BR discover (1),
+.BR module-assistant (8) 
 .\" created by instant / docbook-to-man, Sun 13 Jan 2008, 09:40 


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