cleanup. doc.

4 files changed, 53 insertions, 15 deletions

diff --git a/man/runsv.8 b/man/runsv.8
index fdc8d50..68b6c9f 100644
--- a/man/runsv.8
+++ b/man/runsv.8
@@ -50,18 +50,19 @@ maintains status information in a binary format compatible to
 .BR supervise (8)
 in
 .IR service /supervise/status
-( and
-.IR service /log/supervise/status),
-and in a human readable format in
-.IR service /supervise/stat
-( and
-.IR service /log/supervise/stat).
+and
+.IR service /log/supervise/status,
+and in a human-readable format in
+.IR service /supervise/stat,
+.IR service /log/supervise/stat,
+.IR service /supervise/pid,
+.IR service /log/supervise/pid.
 .SH CONTROL
-The named pipe
-.IR service /supervise/control
-(and
-.IR service /log/supervise/control)
-is provided to give commands to
+The named pipes
+.IR service /supervise/control,
+and (optionally)
+.IR service /log/supervise/control
+are provided to give commands to
 .BR runsv .
 You can use
 .BR svc (8)
@@ -128,6 +129,10 @@ If
 on your systems does not provide the -n option, leave it out,
 .B runsv
 ignores unknown characters written to the control pipe.
+.BR echo (1)
+usally blocks if no
+.B runsv
+process is running in the service directory.
 .SH SIGNALS
 If
 .B runsv
diff --git a/man/runsvdir.8 b/man/runsvdir.8
index 7bea8fa..eee032d 100644
--- a/man/runsvdir.8
+++ b/man/runsvdir.8
@@ -70,6 +70,12 @@ Normally
 is started by
 .BR runit (8)
 in stage 2.
+.SH SIGNALS
+If
+.B runsvdir
+receives a TERM signal, it sends a TERM signal to each
+.BR runsv (8)
+process it is monitoring and then exits.
 .SH SEE ALSO
 runit(8),
 runit-init(8),
diff --git a/man/svwaitdown.8 b/man/svwaitdown.8
index d5f53b9..402ec3e 100644
--- a/man/svwaitdown.8
+++ b/man/svwaitdown.8
@@ -5,15 +5,18 @@ svwaitdown \- waits for services controlled by supervise(8) to be down
 .B svwaitdown
 [
 .B \-v
-]
-[
+] [
+.B \-k
+] [
 .B \-t
 .I sec
 ]
 .I services
 .SH DESCRIPTION
 .I services
-consist of one or more arguments.
+consist of one or more arguments. Each
+.I service
+directory must start with a slash.
 .P
 .B svwaitdown
 checks each
@@ -43,6 +46,28 @@ to become down to
 seconds.
 .I sec
 must be between 2 and 6000. Default is 600 (10 minutes).
+.TP
+.B \-k
+Kill. If the timeout is reached before all
+.I services
+are down, tell the
+.BR supervise (8)
+processes to send the
+.I services
+a KILL signal.
+.TP
+.B \-x
+Exit. Wait for the corresponding
+.BR runsv (8)
+processes to exit instead for the
+.I services
+to be down.
+This option should only be used by
+.BR runit (8)
+in stage 3 when
+.BR runsvdir (8)
+is already stopped.
+
 .SH EXIT CODES
 .B svwaitdown
 returns 0 as soon as all
diff --git a/man/svwaitup.8 b/man/svwaitup.8
index 82b2470..8e1bc00 100644
--- a/man/svwaitup.8
+++ b/man/svwaitup.8
@@ -13,7 +13,9 @@ svwaitup \- waits for services controlled by supervise(8) to be up
 .I services
 .SH DESCRIPTION
 .I services
-consist of one or more arguments.
+consist of one or more arguments. Each
+.I service
+directory must start with a slash.
 .P
 .B svwaitup
 checks each