Package: symlinks
Version: 1.4-4
Severity: minor
Tags: patch

Dear Maintainer,

  Summary:

  Trim trailing space.

  Remove superfluous paragraph macros (.PP).

  Use the correct font macro for one argument (one font, not two).

  Use '\-' to indicate an option, not '-'.

  Split long lines into shorter.


  Details:

Input file is symlinks.1

chk_man: Next line: execute mandoc -T lint symlinks.1
mandoc: symlinks.1:66:7: STYLE: whitespace at end of input line
mandoc: symlinks.1:88:7: STYLE: whitespace at end of input line
mandoc: symlinks.1:92:7: STYLE: whitespace at end of input line
mandoc: symlinks.1:107:7: STYLE: whitespace at end of input line
mandoc: symlinks.1:108:38: STYLE: whitespace at end of input line
mandoc: symlinks.1:110:27: STYLE: whitespace at end of input line
mandoc: symlinks.1:119:13: STYLE: whitespace at end of input line
mandoc: symlinks.1:1:16: WARNING: cannot parse date, using it verbatim: October 
2008
mandoc: symlinks.1:63:2: WARNING: skipping paragraph macro: PP empty
mandoc: symlinks.1:113:2: WARNING: skipping paragraph macro: PP empty
mandoc: symlinks.1:117:2: WARNING: skipping paragraph macro: PP empty

#######

Test nr. 2:

Enable and fix warnings from 'test-groff'.

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

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

Input file is ./symlinks.1

<symlinks.1>:12 (macro BI): only 1 argument, but more are expected

####

Test nr. 25:

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

8:.B -cdorstv
46:.B -c
53:.B -s
55:.B -c
61:.B -r
66:.I -c 
73:.B -s
78:.B -c
83:.I -d
88:.I -o 
92:.I -r 
95:.I -s
100:.I -t
104:.B -c
107:.I -v 
111:.B -v

#####

Test nr. 37:

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.

symlinks.1: line 120    length 86
has been written by Mark Lord <ml...@pobox.com>, the original developer and 
maintainer

symlinks.1: line 121    length 114
of the IDE Performance Package for linux, the Linux IDE Driver subsystem, 
hdparm, and a current day libata hacker.


#####

  Patch:

--- symlinks.1  2020-02-21 23:55:08.000000000 +0000
+++ symlinks.1.new      2020-04-10 23:34:53.000000000 +0000
@@ -5,11 +5,11 @@ symlinks \- symbolic link maintenance ut
 .SH SYNOPSIS
 .B symlinks
 [
-.B -cdorstv
+.B \-cdorstv
 ]
 dirlist
 .SH DESCRIPTION
-.BI symlinks
+.B symlinks
 is a useful utility for maintainers of FTP sites, CDROMs,
 and Linux software distributions.
 It scans directories for symbolic links and lists them on stdout,
@@ -43,81 +43,81 @@ mounted at /mnt after booting from alter
 .B messy
 links are links which contain unnecessary slashes or dots in the path.
 These are cleaned up as well when
-.B -c
+.B \-c
 is specified.
 .PP
 .B lengthy
 links are links which use "../" more than necessary in the path
-(eg.  /bin/vi -> ../bin/vim)
+(e.g., /bin/vi \-> \&../bin/vim).
 These are only detected when
-.B -s
+.B \-s
 is specified, and are only cleaned up when
-.B -c
+.B \-c
 is also specified.
 .PP
 .B other_fs
 are those links whose target currently resides on a different filesystem
 from where symlinks was run (most useful with
-.B -r
+.B \-r
 ).
-.PP
 .SH OPTIONS
 .TP
-.I -c 
+.I \-c
 convert absolute links (within the same filesystem) to relative links.
 This permits links to maintain their validity regardless of the mount
 point used for the filesystem -- a desirable setup in most cases.
 This option also causes any
 .B messy
 links to be cleaned up, and, if
-.B -s
+.B \-s
 was also specified, then
 .B lengthy
 links are also shortened.
 Links affected by
-.B -c
+.B \-c
 are prefixed with
 .B changed
 in the output.
 .TP
-.I -d
+.I \-d
 causes
 .B dangling
 links to be removed.
 .TP
-.I -o 
+.I \-o
 fix links on other filesystems encountered while recursing.
 Normally, other filesystems encountered are not modified by symlinks.
 .TP
-.I -r 
+.I \-r
 recursively operate on subdirectories within the same filesystem.
 .TP
-.I -s
+.I \-s
 causes
 .B lengthy
 links to be detected.
 .TP
-.I -t
+.I \-t
 is used to test for what
 .B symlinks
 would do if
-.B -c
+.B \-c
 were specified, but without really changing anything.
 .TP
-.I -v 
-show all symbolic links.  By default, 
+.I \-v
+show all symbolic links.  By default,
 .B relative
-links are not shown unless 
-.B -v
+links are not shown unless
+.B \-v
 is specified.
-.PP
 .SH BUGS
 .B symlinks
 does not recurse or change links across filesystems.
-.PP
 .SH AUTHOR
-.B symlinks 
-has been written by Mark Lord <ml...@pobox.com>, the original developer and 
maintainer
-of the IDE Performance Package for linux, the Linux IDE Driver subsystem, 
hdparm, and a current day libata hacker.
+.B symlinks
+has been written by Mark Lord <ml...@pobox.com>,
+the original developer and maintainer
+of the IDE Performance Package for linux,
+the Linux IDE Driver subsystem, hdparm,
+and a current day libata hacker.
 .SH SEE ALSO
 .BR symlink (2)


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

Kernel: Linux 5.4.19-1 (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 symlinks depends on:
ii  libc6  2.30-4

symlinks recommends no packages.

symlinks suggests no packages.

-- no debconf information

-- 
Bjarni I. Gislason

Reply via email to