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
-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