void-packages/srcpkgs/procps/patches/skill.1.patch

116 lines
3.5 KiB
Diff

Description: Cleanup man page #282168
Bug-Debian: http://bugs.debian.org/282168
Author: Brendan O'Dea <bod@debian.org>
Reviewed-by: Craig Small <csmall@debian.org>
Index: b/skill.1
===================================================================
--- a/skill.1 2009-11-24 20:53:05.000000000 +1100
+++ b/skill.1 2009-11-24 21:00:31.000000000 +1100
@@ -11,37 +11,38 @@
skill, snice \- send a signal or report process status
.SH SYNOPSIS
-.nf
-skill [signal to send] [options] process selection criteria
-snice [new priority] [options] process selection criteria
-.fi
+.B skill
+.RI [ "signal to send" ]
+.RI [ options ]
+.I process selection criteria
+.br
+.B snice
+.RI [ "new priority" ]
+.RI [ options ]
+.I process selection criteria
.SH DESCRIPTION
These tools are probably obsolete and unportable. The command
syntax is poorly defined. Consider using the killall, pkill,
and pgrep commands instead.
-The default signal for skill is TERM. Use -l or -L to list available signals.
+The default signal for skill is TERM. Use \-l or \-L to list available signals.
Particularly useful signals include HUP, INT, KILL, STOP, CONT, and 0.
-Alternate signals may be specified in three ways: -9 -SIGKILL -KILL.
+Alternate signals may be specified in three ways: \-9 \-SIGKILL \-KILL.
The default priority for snice is +4. (snice +4 ...)
-Priority numbers range from +20 (slowest) to -20 (fastest).
+Priority numbers range from +20 (slowest) to \-20 (fastest).
Negative priority numbers are restricted to administrative users.
.SH "GENERAL OPTIONS"
.TS
-l l l.
--f fast mode This is not currently useful.
--i interactive use T{
-You will be asked to approve each action.
-T}
--v verbose output T{
-Display information about selected processes.
-T}
--w warnings enabled This is not currently useful.
--n no action This only displays the process ID.
--V show version Displays version of program.
+lB l l.
+\-f fast mode This is not currently useful.
+\-i interactive use You will be asked to approve each action.
+\-v verbose output Display information about selected processes.
+\-w warnings enabled This is not currently useful.
+\-n no action This only displays the process ID.
+\-V show version Displays version of program.
.TE
.SH "PROCESS SELECTION OPTIONS"
@@ -49,11 +50,11 @@
The options below may be used to ensure correct interpretation.
Do not blame Albert for this interesting interface.
.TS
-l l.
--t The next argument is a terminal (tty or pty).
--u The next argument is a username.
--p The next argument is a process ID number.
--c The next argument is a command name.
+lB l.
+\-t The next argument is a terminal (tty or pty).
+\-u The next argument is a username.
+\-p The next argument is a process ID number.
+\-c The next argument is a command name.
.TE
.SH SIGNALS
@@ -63,7 +64,6 @@
lB rB lB lB
lfCW r l l.
Name Num Action Description
-.TH
0 0 n/a exit code indicates if a signal may be sent
ALRM 14 exit
HUP 1 exit
@@ -104,15 +104,20 @@
lB lB
lfCW l.
Command Description
-.TC
snice seti crack +7 Slow down seti and crack
-skill -KILL -v /dev/pts/* Kill users on new-style PTY devices
-skill -STOP viro lm davem Stop 3 users
-snice -17 root bash Give priority to root's shell
+skill \-KILL \-v /dev/pts/* Kill users on new-style PTY devices
+skill \-STOP viro lm davem Stop 3 users
+snice \-17 root bash Give priority to root's shell
.TE
.SH "SEE ALSO"
-killall(1) pkill(1) kill(1) renice(1) nice(1) signal(7) kill(2)
+.BR killall (1),
+.BR pkill (1),
+.BR kill (1),
+.BR renice (1),
+.BR nice(1),
+.BR kill(2),
+.BR signal(7)
.SH STANDARDS
No standards apply.