From 7fdaf8c0b9a1568f5423f175c97455e7cc3ee13c Mon Sep 17 00:00:00 2001 From: Davin McCall Date: Wed, 29 May 2019 20:16:18 +1000 Subject: [PATCH] Improve "stop" documentation, bring in line with implementation. --- doc/manpages/dinitctl.8 | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/manpages/dinitctl.8 b/doc/manpages/dinitctl.8 index 14a486a..2c7420f 100644 --- 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 -- 2.25.1