From 2fc16ec957b6255fb06841bd3e0e312701a62a03 Mon Sep 17 00:00:00 2001
From: Charles Forsyth <charles.forsyth@gmail.com>
Date: Fri, 27 Mar 2015 09:09:09 +0000
Subject: new version of broke as script

---
 man/1/kill | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

(limited to 'man/1/kill')

diff --git a/man/1/kill b/man/1/kill
index 27b39a6a..151ec170 100644
--- a/man/1/kill
+++ b/man/1/kill
@@ -14,6 +14,9 @@ kill, broke \- terminate process(es)
 ]
 .PP
 .B broke
+[
+.I user
+]
 .SH DESCRIPTION
 .I Kill
 terminates each process (for a numeric
@@ -46,9 +49,14 @@ file, and the process ID of each such process is printed on standard output.
 A process that incurs an exception (eg, array bounds check)
 is normally suspended in the `broken' state to allow debugging.
 .I Broke
-kills all such processes owned by the current user, releasing any resources
-they hold back to the system;
-it prints their process IDs.
+finds all such processes owned by
+.I user
+(default: the current user), and
+prints
+.I sh (1)
+commands to them.
+The commands can be piped to the shell or selectively run,
+releasing back to the system any resources owned by those processes.
 .SH FILES
 .TF "/prog/pid/status  "
 .TP
@@ -58,7 +66,7 @@ it prints their process IDs.
 .SH SOURCE
 .B /appl/cmd/kill.b
 .br
-.B /appl/cmd/broke.b
+.B /dis/broke
 .SH "SEE ALSO"
 .IR ps (1),
 .IR prog (3)
-- 
cgit v1.2.3