Improve "stop" documentation, bring in line with implementation.

diff --git a/doc/manpages/dinitctl.8 b/doc/manpages/dinitctl.8
index 14a486a9a43f7e5477420a9d7dc78bc201a27042..2c7420fb05b1332540b0f1cba5406546134bb23d 100644 (file)
--- a/doc/manpages/dinitctl.8
+++ b/doc/manpages/dinitctl.8
@@ -72,7 +72,15 @@ to stop before it is then restarted.
 .TP
 \fBstop\fR
 Stop the specified service, and remove explicit activation. The service will stop, but may restart
 .TP
 \fBstop\fR
 Stop the specified service, and remove explicit activation. The service will stop, but may restart

-immediately if it or any dependents are configured to restart.  Any pending \fBstart\fR orders are cancelled,
+immediately if any dependents are configured to restart. If the service has dependents only via
+soft dependency links (i.e. \fBwaits-for\fR dependencies) then these links will be broken, so that
+the service will not restart (any other dependencies, however, are retained).
+
+The \fBrestart\fR option applied to the stopped service will not by itself cause the service to restart
+when it is stopped via this command. However, a dependent which is configured to restart may
+cause the service itself to restart as a result.
+
+Any pending \fBstart\fR orders are cancelled,

 though a service which is starting might continue its startup before then stopping.
 .TP
 \fBwake\fR
 though a service which is starting might continue its startup before then stopping.
 .TP
 \fBwake\fR