- more consistent macros

- descriptions of examples before examples, and indent examples
- direct people to sigaction(2) for complete list of signals
- .Xr pkill 1
- simplify a list

from jared yanovich, and some bits from me;

1 files changed, 19 insertions, 17 deletions

diff --git a/bin/kill/kill.1 b/bin/kill/kill.1
index b1f1cbf894e..78c6f1d1c20 100644
--- a/bin/kill/kill.1
+++ b/bin/kill/kill.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: kill.1,v 1.25 2004/04/04 13:19:36 jmc Exp $
+.\"	$OpenBSD: kill.1,v 1.26 2004/07/06 13:32:44 jmc Exp $
 .\"	$NetBSD: kill.1,v 1.8 1995/09/07 06:30:26 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -48,11 +48,11 @@
 .Fl l
 .Op Ar exit_status
 .Nm kill
-.Fl signal_name
+.Fl Ar signal_name
 .Ar pid
 .Op Ar ...
 .Nm kill
-.Fl signal_number
+.Fl Ar signal_number
 .Ar pid
 .Op Ar ...
 .Sh DESCRIPTION
@@ -78,25 +78,21 @@ default
 If no operand is given, list the signal names; otherwise, write
 the signal name corresponding to
 .Ar exit_status .
-.It Fl signal_name
+.It Fl Ar signal_name
 A symbolic signal name specifying the signal to be sent instead of the
 default
 .Dv SIGTERM .
-.It Fl signal_number
+.It Fl Ar signal_number
 A non-negative decimal integer specifying the signal to be sent instead
 of the default
 .Dv SIGTERM .
 .El
 .Pp
 The following PIDs have special meanings:
-.Pp
-.Bl -tag -width Ds -compact -offset indent
+.Bl -tag -width Ds -offset indent
 .It \-1
 If superuser, broadcast the signal to all processes; otherwise, broadcast
 to all processes belonging to the user.
-.El
-.Pp
-.Bl -tag -width Ds -compact -offset indent
 .It \- Ns Ar pgid
 Send the signal to all processes within the specified process group.
 .El
@@ -120,8 +116,13 @@ ALRM (alarm clock)
 TERM (software termination signal)
 .El
 .Pp
-A signal number of 0 (kill \-0 pid) checks the validity of a
-certain PID, to see if it exists.
+For a more complete list, consult the
+.Xr sigaction 2
+manual page.
+.Pp
+A signal number of 0
+.Pq Li kill \-0 pid
+checks the validity of a certain PID, to see if it exists.
 An exit code of 0 means that the specified process exists.
 .Pp
 The
@@ -134,18 +135,19 @@ so process IDs are not as often used as
 .Nm
 arguments.
 .Sh EXAMPLES
-.Li $ kill -9 1234
+Forcibly terminate process ID 1234:
 .Pp
-Forcibly terminate process ID 1234.
-.Pp
-.Li # kill -HUP `cat /var/run/inetd.pid`
+.Dl $ kill -9 1234
 .Pp
 Send the
 .Xr inetd 8
 daemon the hangup signal, instructing it to re-read its configuration from
-.Pa /etc/inetd.conf .
+.Pa /etc/inetd.conf :
+.Pp
+.Dl # kill -HUP `cat /var/run/inetd.pid`
 .Sh SEE ALSO
 .Xr csh 1 ,
+.Xr pkill 1 ,
 .Xr ps 1 ,
 .Xr sh 1 ,
 .Xr kill 2 ,