Fix mistakes in cptest asserts

[oweals/dinit.git] / README.md

diff --git a/README.md b/README.md
index f36e368ef2c30af2fea6af2b15c14c60169ee5a9..03f430dd89ba98d9414ddc2e8f9f6a3c02224c52 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 # Dinit
-v0.6.0 (development release)
+v0.8.2 (development release)
 
 This is the README for Dinit, the service manager and init system. It is
 intended to provide an overview; For full documentation please check the manual pages. 
@@ -308,10 +308,18 @@ command by default acts as a "release" that also forces the service to stop
 (although it may then immediately restart, depending on how it and its
 dependents are configured).
 
-Use the "-s" switch to talk the "system" instance of Dinit, rather than a
-personal instance, e.g:
+If stopping a service would also require a dependent service to stop, a warning
+will be issued and the `--force` option will be required.
 
-    dinitctl -s start mysql   # start system mysql service
+When run as root, dinitctl (by default) communicates with the system instance of
+Dinit. Otherwise, it communicates with a user (personal) instance. This can be
+overridden (using "-u" or "-s" for the user or system instance, respectively), but
+note that regular users will generally lack the required permission to communicate
+with the system instance. 
+
+Here is an example command for starting a service:
+
+    dinitctl start mysql   # start mysql service
 
 For complete details on the command line, use:
 
@@ -321,9 +329,9 @@ You can "pin" a service in either the stopped or started state, which prevents
 it from changing state either due to a dependency/dependent or a direct
 command:
 
-    dinitctl -s start --pin mysql  # start mysql service, pin it as "started"
-    dinitctl -s stop mysql  # issues stop, but doesn't take effect due to pin
-    dinitctl -s unpin mysql # release pin; service will now stop
+    dinitctl start --pin mysql  # start mysql service, pin it as "started"
+    dinitctl stop mysql  # issues stop, but doesn't take effect due to pin
+    dinitctl unpin mysql # release pin; service will now stop
 
 You can pin a service in the stopped state in order to make sure it doesn't
 get started accidentally (either via a dependency or directly). You can also
@@ -333,7 +341,7 @@ to restart automatically).
 
 Finally, you can list the state of all loaded services:
 
-    dinitctl -s list
+    dinitctl list
 
 This may result in something like the following: