cleanups. return when printing NULL commands

[unix-history] / usr / src / bin / kill / kill.1

diff --git a/usr/src/bin/kill/kill.1 b/usr/src/bin/kill/kill.1
index ab43903..b5e2734 100644 (file)
--- a/usr/src/bin/kill/kill.1
+++ b/usr/src/bin/kill/kill.1
@@ -1,13 +1,16 @@
 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"

-.\" %sccs.include.redist.man%
+.\" This code is derived from software contributed to Berkeley by
+.\" the Institute of Electrical and Electronics Engineers, Inc.

 .\"
 .\"

-.\"     @(#)kill.1     6.5 (Berkeley) %G%
+.\" %sccs.include.redist.roff%
+.\"
+.\"    @(#)kill.1      6.9 (Berkeley) %G%

 .\"
 .Dd 
 .Dt KILL 1
 .\"
 .Dd 
 .Dt KILL 1

-.Os BSD 4.4
+.Os

 .Sh NAME
 .Nm kill
 .Nd terminate or signal a process
 .Sh NAME
 .Nm kill
 .Nd terminate or signal a process


@@ -17,48 +20,51 @@
 .Ar pid
 \&...
 .Nm kill
 .Ar pid
 \&...
 .Nm kill

+.Op Fl signal_number
+.Ar pid
+\&...
+.Nm kill

 .Op Fl l
 .Sh DESCRIPTION
 .Op Fl l
 .Sh DESCRIPTION

-The kill utility sends a signal to the process(es) specified
-by each pid operand. It is used to kill runaway or misbegotten
-processes, such as those
-.Em backgrounded
-with
-.Sq Li \&& .
-.Nm Kill
-is intelligent about who owns a process.
+The kill utility sends the
+.Dv TERM
+signal to the processes specified
+by the pid operand(s).
+.Pp
+Only the super-user may send signals to other users' processes.

 .Pp
 .Pp

-Options available:
+The options are as follows:

 .Pp
 .Pp

-.Tw Ds
-.Tp Fl signal_name
-A symbolic signal name. To find out all the possible signal names
-do a
-.Li kill -l .
-.Tp Fl l
-Available signal names are listed and are as found in
-.Pa /usr/include/signal.h ,
-stripped of the common SIG prefix.
-.Tp Fl signal_number
-A (nonnegative) decimal integer, representing the signal
-to be used instead of TERM as the sig argument in
-the effective call to
-.Xr kill 2 .
-.Tp
+.Bl -tag -width Ds
+.It Fl l
+List the signal names.
+.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
 .Pp

-Some of the more commonly used signals with kill:
-.Ds I
-.Cw XXX TERM
-.Cl -1 -1      (broadcast to all processes, super user only)
-.Cl 0  0       (sh(1) only, signals all members of process group)
-.Cl 2  INT     (interupt)
-.Cl 3  QUIT    (quit)
-.Cl 6  ABRT    (abort)
-.Cl 9  KILL    (non-catchable non-ignorable kill)
-.Cl 14 ALRM    (alarm clock)
-.Cl 15 TERM    (software termination signal)
-.Cw
-.De
+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)
+.El
+.Ed

 .Pp
 .Nm Kill
 is a built-in to
 .Pp
 .Nm Kill
 is a built-in to


@@ -78,9 +84,10 @@ for details.
 .Sh HISTORY
 A
 .Nm kill
 .Sh HISTORY
 A
 .Nm kill

-command appeared in Version 6 AT&T Unix.
+command appeared in
+.At v6 .

 .Sh BUGS
 .Sh BUGS

-A replacement for
+A replacement for the command

 .Dq Li kill 0
 for
 .Xr csh  1
 .Dq Li kill 0
 for
 .Xr csh  1