From 6ac82cfa9e2b5078ba99491c3b141331c1f03567 Mon Sep 17 00:00:00 2001
From: ru <ru@FreeBSD.org>
Date: Fri, 9 Nov 2007 16:02:10 +0000
Subject: - Fix documentation to match code.  Specifically, -c doesn't have  
 to be specified together with either -u or -t to have an effect,   and exit
 status of 2 is not possible after a Perl->C conversion.

- While here, fix markup.
---
 usr.bin/killall/killall.1 | 36 +++++++++++++++---------------------
 1 file changed, 15 insertions(+), 21 deletions(-)

(limited to 'usr.bin/killall')

diff --git a/usr.bin/killall/killall.1 b/usr.bin/killall/killall.1
index bfac13f..d2af033 100644
--- a/usr.bin/killall/killall.1
+++ b/usr.bin/killall/killall.1
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 26, 2004
+.Dd November 9, 2007
 .Os
 .Dt KILLALL 1
 .Sh NAME
@@ -38,12 +38,12 @@
 .Op Fl u Ar user
 .Op Fl t Ar tty
 .Op Fl c Ar procname
-.Op Fl SIGNAL
+.Op Fl Ar SIGNAL
 .Op Ar procname ...
 .Sh DESCRIPTION
 The
 .Nm
-utility kills processes selected by name, as opposed to the selection by pid
+utility kills processes selected by name, as opposed to the selection by PID
 as done by
 .Xr kill 1 .
 By default, it will send a
@@ -56,7 +56,7 @@ that match the name
 The super-user is allowed to kill any process.
 .Pp
 The options are as follows:
-.Bl -tag -width 10n -offset indent
+.Bl -tag -width ".Fl c Ar procname"
 .It Fl d | v
 Be more verbose about what will be done.
 For a single
@@ -84,12 +84,12 @@ This is dangerous, a single dot will match any process
 running under the real UID of the caller.
 .It Fl s
 Show only what would be done, but do not send any signal.
-.It Fl SIGNAL
+.It Fl Ar SIGNAL
 Send a different signal instead of the default
 .Dv TERM .
 The signal may be specified either as a name
 (with or without a leading
-.Dv SIG ) ,
+.Dq Li SIG ) ,
 or numerically.
 .It Fl j Ar jid
 Kill processes in the jail specified by
@@ -103,11 +103,7 @@ Limit potentially matching processes to those running on
 the specified
 .Ar tty .
 .It Fl c Ar procname
-When used with the
-.Fl u
-or
-.Fl t
-flags, limit potentially matching processes to those matching
+Limit potentially matching processes to those matching
 the specified
 .Ar procname .
 .It Fl z
@@ -116,23 +112,21 @@ This should not have any effect except to print a few error messages
 if there are zombie processes that match the specified pattern.
 .El
 .Sh ALL PROCESSES
-Sending a signal to all processes with uid
-.Em XYZ
+Sending a signal to all processes with then given UID
 is already supported by
 .Xr kill 1 .
 So use
 .Xr kill 1
-for this job (e.g.\& $ kill -TERM -1 or
-as root $ echo kill -TERM -1 | su -m <user>)
+for this job (e.g.\&
+.Dq Li "kill -TERM -1
+or as root
+.Dq Li "echo kill -TERM -1 | su -m <user>" ) .
 .Sh EXIT STATUS
 The
 .Nm
-command will respond with a short usage message and exit with a status
-of 2 in case of a command error.
-A status of 1 will be returned if
-either no matching process has been found or not all processes have
-been signalled successfully.
-Otherwise, a status of 0 will be
+utility exits 0 if some processes have been found and
+signalled successfully.
+Otherwise, a status of 1 will be
 returned.
 .Sh DIAGNOSTICS
 Diagnostic messages will only be printed if requested by
-- 
cgit v1.1