Update manpage/README for new "dinitctl stop" semantics.

[oweals/dinit.git] / doc / manpages / dinitctl.8.m4

diff --git a/doc/manpages/dinitctl.8.m4 b/doc/manpages/dinitctl.8.m4
index d56e476cc0e8455d2092f60b4501695730e96e6e..c40d70024771b8c93858d5e9e4a901a4c677143a 100644 (file)
--- a/doc/manpages/dinitctl.8.m4
+++ b/doc/manpages/dinitctl.8.m4
@@ -83,17 +83,19 @@ automatically if its dependents stop. If the service is currently stopping it wi
 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 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).
+Stop the specified service, and remove explicit activation. If the service has (non-soft) dependents, an
+error will be displayed unless the \fB\-\-force\fR option is used.
+
+A service with any dependents via soft dependencies will have these dependency links broken when it stops.
 
 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.
+though a service which is starting will continue its startup before then stopping (unless the service is
+configured to have an interruptible startup or is otherwise at a stage of startup which can be safely
+interrupted).
 .TP
 \fBwake\fR
 Start the specified service, but do not mark it as explicitly activated if it is not already so