Merge Lite2 mods, and -Wall cleaning.

1 files changed, 51 insertions, 28 deletions

diff --git a/bin/kill/kill.1 b/bin/kill/kill.1
index fabafc0..5359199 100644
--- a/bin/kill/kill.1
+++ b/bin/kill/kill.1
@@ -32,10 +32,10 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"	@(#)kill.1	8.1 (Berkeley) 5/31/93
-.\"	$Id: kill.1,v 1.2 1994/09/24 02:55:43 davidg Exp $
+.\"	@(#)kill.1	8.2 (Berkeley) 4/28/95
+.\"	$Id: kill.1,v 1.3 1996/07/03 22:19:50 wosch Exp $
 .\"
-.Dd May 31, 1993
+.Dd April 28, 1995
 .Dt KILL 1
 .Os
 .Sh NAME
@@ -43,57 +43,74 @@
 .Nd terminate or signal a process
 .Sh SYNOPSIS
 .Nm kill
-.Op Fl signal_name
+.Op Fl s Ar signal_name
 .Ar pid
 \&...
 .Nm kill
-.Op Fl signal_number
+.Fl l
+.Op Ar exit_status
+.Nm kill
+.Fl signal_name
 .Ar pid
 \&...
 .Nm kill
-.Op Fl l
+.Fl signal_number
+.Ar pid
+\&...
 .Sh DESCRIPTION
-The kill utility sends the
-.Dv TERM
-signal to the processes specified
-by the pid operand(s).
+The
+.Nm
+utility sends a signal to the processes specified by the pid operand(s).
 .Pp
 Only the super-user may send signals to other users' processes.
 .Pp
 The options are as follows:
 .Pp
 .Bl -tag -width Ds
-.It Fl l
-List the signal names.
+.It Fl s Ar signal_name
+A symbolic signal name specifying the signal to be sent instead of the
+default
+.Dv TERM .
+.It Fl l Op Ar exit_status
+If no operand is given, list the signal names; otherwise, write
+the signal name corresponding to
+.Ar exit_status .
 .It Fl signal_name
 A symbolic signal name specifying the signal to be sent instead of the
 default
 .Dv TERM .
-The
-.Fl l
-option displays the signal names.
 .It Fl signal_number
 A non-negative decimal integer, specifying the signal to be sent instead
 of the default
 .Dv TERM .
 .El
 .Pp
+The following pids have special meanings:
+.Bl -tag -width Ds -compact
+.It -1
+If superuser, broadcast the signal to all processes; otherwise broadcast
+to all processes belonging to the user.
+.El
+.Pp
 Some of the more commonly used signals:
-.Bd -ragged -offset indent -compact
-.Bl -column XXX TERM
-.It -1	-1	(super-user broadcast to all processes, or user broadcast
-to user's processes)
-.It 0	0	(sh(1) only, signals all members of process group)
-.It 2	INT	(interrupt)
-.It 3	QUIT	(quit)
-.It 6	ABRT	(abort)
-.It 9	KILL	(non-catchable, non-ignorable kill)
-.It 14	ALRM	(alarm clock)
-.It 15	TERM	(software termination signal)
+.Bl -tag -width Ds -compact
+.It 1
+HUP (hang up)
+.It 2
+INT (interrupt)
+.It 3
+QUIT (quit)
+.It 6
+ABRT (abort)
+.It 9
+KILL (non-catchable, non-ignorable kill)
+.It 14
+ALRM (alarm clock)
+.It 15
+TERM (software termination signal)
 .El
-.Ed
 .Pp
-.Nm Kill
+.Nm
 is a built-in to
 .Xr csh  1  ;
 it allows job specifiers of the form ``%...'' as arguments
@@ -109,6 +126,12 @@ for details.
 .Xr ps 1 ,
 .Xr kill 2 ,
 .Xr sigvec 2
+.Sh STANDARDS
+The
+.Nm
+function is expected to be
+.St -p1003.2
+compatible.
 .Sh HISTORY
 A
 .Nm kill