docs: add long options and tidy up kill.1

Signed-off-by: Sami Kerola <kerolasa@iki.fi>

1 files changed, 45 insertions, 41 deletions

diff --git a/misc-utils/kill.1 b/misc-utils/kill.1
index 404fb724e..7daa6acf5 100644
--- a/misc-utils/kill.1
+++ b/misc-utils/kill.1
@@ -1,7 +1,7 @@
 .\" Copyright 1994 Salvatore Valente (svalente@mit.edu)
 .\" Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
 .\" May be distributed under the GNU General Public License
-.TH KILL 1 "February 2011" "util-linux" "User Commands"
+.TH KILL 1 "March 2013" "util-linux" "User Commands"
 .SH NAME
 kill \- terminate a process
 .SH SYNOPSIS
@@ -19,15 +19,14 @@ kill \- terminate a process
 .SH DESCRIPTION
 The command
 .B kill
-sends the specified signal to the specified process or process group.
-If no signal is specified, the TERM signal is sent.  The TERM signal
-will kill processes which do not catch this signal.  For other processes,
-it may be necessary to use the KILL (9) signal, since this signal cannot
-be caught.
+sends the specified signal to the specified process or process group.  If no
+signal is specified, the TERM signal is sent.  The TERM signal will kill
+processes which do not catch this signal.  For other processes, it may be
+necessary to use the KILL (9) signal, since this signal cannot be caught.
 .PP
-Most modern shells have a builtin kill function, with a usage rather similar
-to that of the command described here.  The `-a' and `-p' options,
-and the possibility to specify processes by command name are a local extension.
+Most modern shells have a builtin kill function, with a usage rather similar to
+that of the command described here.  The '-a' and '-p' options, and the
+possibility to specify processes by command name are a local extension.
 .PP
 If sig is 0, then no signal is sent, but error checking is still performed.
 .SH OPTIONS
@@ -38,7 +37,6 @@ Specify the list of processes that
 should signal.  Each
 .I pid
 can be one of five things:
-
 .RS
 .TP
 .I n
@@ -57,65 +55,66 @@ All processes with pid larger than 1 will be signaled.
 .BI - n
 where
 .I n
-is larger than 1.
-All processes in process group
+is larger than 1.  All processes in process group
 .I n
-are signaled.  When an argument of the form `-n' is given,
-and it is meant to denote a process group,
-either the signal must be specified first, or the argument must be preceded
-by a `--' option, otherwise it will be taken as the signal to send.
+are signaled.  When an argument of the form '-n' is given, and it is meant to
+denote a process group, either the signal must be specified first, or the
+argument must be preceded by a '--' option, otherwise it will be taken as the
+signal to send.
 .TP
 .I commandname
 All processes invoked using that name will be signaled.
 .RE
 .TP
-.BI \-s " signal"
-Specify the signal to send.
-The signal may be given as a signal name or number.
+\fB\-s\fR, \fB\-\-signal\fR \fIsignal\fR
+Specify the signal to send.  The signal may be given as a signal name or
+number.
 .TP
-.B \-l
+\fB\-l\fR, \fB\-\-list\fR [\fIsignal\fR]
 Print a list of signal names.  These are found in
-.I /usr/include/linux/signal.h
+.I /usr/\:include/\:linux/\:signal.h
 .TP
-.B \-a
-Do not restrict the commandname-to-pid conversion to processes
-with the same uid as the present process.
+\fB\-a\fR, \fB\-\-all\fR
+Do not restrict the commandname-to-pid conversion to processes with the same
+uid as the present process.
 .TP
-.B \-p
+\fB\-p\fR, \fB\-\-pid\fR
 Specify that
 .B kill
-should only print the process id (pid)
-of the named processes, and not send any signals.
+should only print the process id (pid) of the named processes, and not send any
+signals.
 .TP
-.BI \-q " sigval"
+\fB\-q\fR, \fB\-\-queue\fR \fIsigval\fR
 Use
 .BR sigqueue (2)
 rather than
 .BR kill (2)
-and the sigval argument is used to specify an integer to be sent with the
-signal.  If the receiving process has installed a handler for this signal using
-the SA_SIGINFO flag to
+and the
+.I sigval
+argument is used to specify an integer to be sent with the signal.  If the
+receiving process has installed a handler for this signal using the SA_SIGINFO
+flag to
 .BR sigaction (2),
 then it can obtain this data via the si_value field of the siginfo_t structure.
 .SH NOTES
-It's not possible to send a signal to explicitly selected thread in a
+It is not possible to send a signal to explicitly selected thread in a
 multithreaded process by
 .BR kill (2)
-syscall. If
+syscall.  If
 .BR kill(2)
-is used to send a signal to a thread group,  then
-kernel selects arbitrary member of the thread group that has not blocked
-the signal. For more details see
+is used to send a signal to a thread group, then kernel selects arbitrary
+member of the thread group that has not blocked the signal.  For more details
+see
 .BR clone (2)
 CLONE_THREAD description.
-
+.PP
 The command
 .BR kill (1)
 as well as syscall
 .BR kill (2)
 accepts TID (thread ID, see
 .BR gettid (2))
-as argument. In this case the kill behavior is not changed and the signal is
+as argument.  In this case the kill behavior is not changed and the signal is
 also delivered to the thread group rather than to the specified thread.
 .SH "SEE ALSO"
 .BR bash (1),
@@ -124,8 +123,13 @@ also delivered to the thread group rather than to the specified thread.
 .BR sigvec (2),
 .BR signal (7)
 .SH AUTHOR
-Taken from BSD 4.4.  The ability to translate process names to process
-ids was added by Salvatore Valente <svalente@mit.edu>.
+Taken from BSD 4.4.  The ability to translate process names to process ids was
+added by
+.MT svalente@mit.edu
+Salvatore Valente
+.ME .
 .SH AVAILABILITY
 The kill command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+Linux Kernel Archive
+.UE .