chiark / gitweb /
man: extend documentation on systemctl isolate
authorMatthew Miller <mattdm@mattdm.org>
Tue, 31 Aug 2010 16:25:22 +0000 (12:25 -0400)
committerLennart Poettering <lennart@poettering.net>
Fri, 3 Sep 2010 02:48:00 +0000 (04:48 +0200)
Lennart has convinced me that it's more helpful to participate than to sit
on the sidelines and complain. So, hello everyone.

I'm starting by giving up the battle to change the systemctl "isolate"
command to "switch-to". Can't win them all. :) I've got a suggested patch
to expand the documentation a bit, hopefully making it more clear to new
systemd users.

Is there an easy way to list all units where AllowIsolate is enabled? That
should be included alongside this, I think.

man/systemctl.xml

index 768f3ad..6359872 100644 (file)
 
                                 <listitem><para>Start the unit
                                 specified on the command line and its
-                                dependencies and stop all others. Note
-                                that this works only on units where
-                                <option>AllowIsolate=</option> is
+                                dependencies and stop all others.</para>
+
+                                <para>This is similar to changing the
+                                runlevel in a traditional init system. The
+                                <command>isolate</command> command will
+                                immediately stop processes that are not
+                                enabled in the new unit, possibly including
+                                the graphical environment or terminal you
+                                are currently using.</para>
+
+                                <para>Note that this works only on units
+                                where <option>AllowIsolate=</option> is
                                 enabled. See
                                 <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
                                 for details.</para></listitem>