Package: psmisc Version: 23.1-1+b1 Severity: minor Tags: patch Dear Maintainer,
* What led up to the situation? Warnings from "groff": <fuser.1>:29 (macro RB): only 1 argument, but more are expected <fuser.1>:32 (macro RB): 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" ] The patch is in the attachment. #### Summary of changes: Use macros for font changes instead of font escapes Change a two-fonts macro to an one-font macro for one argument Add an italic correction (\/) in front of '\c' as that removes the correction in the macro. Fix the spelling of "comparisions" and "seatbelt" Protect '.' if not end of sentence (change " ..." to " \&...\&") Begin a sentence in a new line Add a comma after "e.g." (instead of using '\&') #### Details: Input file is fuser.1 Test nr. 8: Protect a full stop (.) with "\&", if it has a blank (white-space) in front of or (ignoring characters transparent to it) after it, and it does not mean an end of a sentence. 166:shortcut notation \fIname\fB/\fIspace\fR (e.g. \fI80\fB/\fItcp\fR) ##### Test nr. 16: Use the correct macro for the font change of one argument. Split a punctuation mark from the only argument if one is there 29:.RB \-l 32:.RB \-V ##### 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 them or add the italic corrections. [1] man-pages(7) [package "manpages"] 91:\fB[\fR\fIlcl_port\fR\fB][\fR,\fB[\fR\fIrmt_host\fR\fB][\fR,\fB[\fIrmt_port\fR\fB]]] 112:\fB\-\fR\fISIGNAL\fR, SIGKILL is sent. An 135:\fB\-m\fR \fINAME\fR, \fB\-\-mount\fR \fINAME\fR 157:\fB\-n \fISPACE\fR, \fB\-\-namespace\fR \fISPACE\fR 166:shortcut notation \fIname\fB/\fIspace\fR (e.g. \fI80\fB/\fItcp\fR) 179:\fB\-\fISIGNAL\fR 227:\fBif fuser \-s /dev/ttyS1; then :; else \fIsomething\fB; fi\fR ##### Test nr. 40: Add a comma after "e.g." and "i.e." (man-pages(7) [package "manpages"]). 166:shortcut notation \fIname\fB/\fIspace\fR (e.g. \fI80\fB/\fItcp\fR) 181:Signals can be specified either by name (e.g. 183:number (e.g. ##### Test nr. 41: Wrong distance between sentences or protect the indicator. 1) Separate the sentences and subordinate clauses; each begins on a new line. See man-pages(7) [package "manpages"] and "info groff". Or 2) Adjust space between sentences (two spaces), 3) or protect the indicator by adding "\&" after it. The "indicator" is an "end-of-sentence character" (.!?). 80:option. By default 121:Ask the user for confirmation before killing a process. This option is ##### Test nr. 42: Split lines longer than 80 characters into two or more lines. Appropriate break points are the end of a sentence and a subordinate clause. fuser.1: line 91 length 84 \fB[\fR\fIlcl_port\fR\fB][\fR,\fB[\fR\fIrmt_host\fR\fB][\fR,\fB[\fIrmt_port\fR\fB]]] ##### -- System Information: Debian Release: buster/sid APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 4.9.88-1-u1 (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 psmisc depends on: ii libc6 2.27-3 ii libselinux1 2.7-2+b2 ii libtinfo6 6.1+20180210-4 psmisc recommends no packages. psmisc suggests no packages. -- no debconf information -- Bjarni I. Gislason
--- fuser.1 2018-05-06 08:19:46.000000000 +0000 +++ fuser.1.new 2018-05-27 17:36:59.000000000 +0000 @@ -21,15 +21,14 @@ fuser \- identify processes using files .RB [ \-i ] .RB [ \-M ] .RB [ \-w ] -.RB [ \- \fISIGNAL\fR] +.RB [ \-\c +.IR SIGNAL ] ] -.IR name " ..." +.IR name " \&...\&" .br -.B fuser -.RB \-l +.B fuser \-l .br -.B fuser -.RB \-V +.B fuser \-V .ad b .SH DESCRIPTION .B fuser @@ -88,7 +87,7 @@ options. The socket(s) can be specified and the remote address. All fields are optional, but commas in front of missing fields must be present: .PP -\fB[\fR\fIlcl_port\fR\fB][\fR,\fB[\fR\fIrmt_host\fR\fB][\fR,\fB[\fIrmt_port\fR\fB]]] +.RI [ lcl_port ][,[ rmt_host ][,[ rmt_port ]]] .PP Either symbolic or numeric values can be used for IP addresses and port numbers. @@ -97,19 +96,21 @@ numbers. outputs only the PIDs to stdout, everything else is sent to stderr. .SH OPTIONS .TP -\fB\-a\fR, \fB\-\-all\fR +.BR \-a ", " \-\-all Show all files specified on the command line. By default, only files that are accessed by at least one process are shown. .TP -\fB\-c\fR +.B \-c Same as \-m option, used for POSIX compatibility. .TP -\fB\-f\fR +.B \-f Silently ignored, used for POSIX compatibility. .TP -\fB\-k\fR, \fB\-\-kill\fR +.BR \-k ", "\-\-kill Kill processes accessing the file. Unless changed with -\fB\-\fR\fISIGNAL\fR, SIGKILL is sent. An +.BI \- SIGNAL\/\c +, SIGKILL is sent. +An .B fuser process never kills itself, but may kill other .B fuser @@ -117,22 +118,23 @@ processes. The effective user ID of the .B fuser is set to its real user ID before attempting to kill. .TP -\fB\-i\fR, \fB\-\-interactive\fR -Ask the user for confirmation before killing a process. This option is +.BR \-i ", " \-\-interactive +Ask the user for confirmation before killing a process. +This option is silently ignored if .B \-k is not present too. .TP -\fB\-I\fR, \fB\-\-inode\fR +.BR \-I ", " \-\-inode For the name space .B file -let all comparisions be based on the inodes of the specified file(s) +let all comparisons be based on the inodes of the specified file(s) and never on the file names even on network based file systems. .TP -\fB\-l\fR, \fB\-\-list\-signals\fR +.BR \-l ", " \-\-list\-signals List all known signal names. .TP -\fB\-m\fR \fINAME\fR, \fB\-\-mount\fR \fINAME\fR +.BI -m " NAME \fR, " "\-\-mount " NAME .I NAME specifies a file on a mounted file system or a block device that is mounted. All processes accessing files on that file system are listed. @@ -140,21 +142,21 @@ If a directory file is specified, it is .IR NAME /. to use any file system that might be mounted on that directory. .TP -\fB\-M\fR, \fB\-\-ismountpoint\fR +.BR \-M ", " \-\-ismountpoint Request will be fulfilled only if .I NAME -specifies a mountpoint. This is an invaluable seatbelt which prevents +specifies a mountpoint. This is an invaluable seat belt which prevents you from killing the machine if .I NAME happens to not be a filesystem. .TP -\fB\-w\fP +.B \-w Kill only processes which have write access. This option is silently ignored if .B \-k is not present too. .TP -\fB\-n \fISPACE\fR, \fB\-\-namespace\fR \fISPACE\fR +.BI \-n " SPACE\fR, " "\-\-namespace " SPACE Select a different name space. The name spaces .B file (file names, the default), @@ -163,10 +165,13 @@ Select a different name space. The name .B tcp (local TCP ports) are supported. For ports, either the port number or the symbolic name can be specified. If there is no ambiguity, the -shortcut notation \fIname\fB/\fIspace\fR (e.g. \fI80\fB/\fItcp\fR) +shortcut notation +.IB name / space +(e.g., +.IB 80 / tcp \fR) can be used. .TP -\fB\-s\fR, \fB\-\-silent\fR +.BR \-s ", " \-\-silent Silent operation. .B \-u and @@ -176,20 +181,20 @@ are ignored in this mode. must not be used with .BR \-s . .TP -\fB\-\fISIGNAL\fR +.BI \- SIGNAL Use the specified signal instead of SIGKILL when killing processes. -Signals can be specified either by name (e.g. -.BR \-HUP ) or by -number (e.g. +Signals can be specified either by name (e.g., +.BR \-HUP ) +or by number (e.g., .BR \-1 ). This option is silently ignored if the .B \-k option is not used. .TP -\fB\-u\fR, \fB\-\-user\fR +.BR \-u ", " \-\-user Append the user name of the process owner to each PID. .TP -\fB\-v\fR, \fB\-\-verbose\fR +.BR \-v ", " \-\-verbose Verbose mode. Processes are shown in a .BR ps -like @@ -201,15 +206,15 @@ export or swap file. In this case .B kernel is shown instead of the PID. .TP -\fB\-V\fR, \fB\-\-version\fR +.BR \-V ", " \-\-version Display version information. .TP -\fB\-4\fR, \fB\-\-ipv4\fR +.BR \-4 ", " \-\-ipv4 Search only for IPv4 sockets. This option must not be used with the .B \-6 option and only has an effect with the tcp and udp namespaces. .TP -\fB\-6\fR, \fB\-\-ipv6\fR +.BR \-6 ", " \-\-ipv6 Search only for IPv6 sockets. This option must not be used with the .B \-4 option and only has an effect with the tcp and udp namespaces. @@ -224,7 +229,7 @@ location of the proc file system .B fuser \-km /home kills all processes accessing the file system /home in any way. .TP -\fBif fuser \-s /dev/ttyS1; then :; else \fIsomething\fB; fi\fR +.BI "if fuser \-s /dev/ttyS1; then :; else " something "; fi" invokes .I something if no other process is using /dev/ttyS1.
