diff --git a/TODO b/TODO
index 099ce36f01..7d4d54aa7a 100644
--- a/TODO
+++ b/TODO
@@ -1087,7 +1087,8 @@ Features:
- document systemd-journal-flush.service properly
- documentation: recommend to connect the timer units of a service to the service via Also= in [Install]
- man: document the very specific env the shutdown drop-in tools live in
- - man: add more examples to man pages
+ - man: add more examples to man pages,
+ - in particular an example how to do the equivalent of switching runlevels
- man: maybe sort directives in man pages, and take sections from --help and apply them to man too
- document root=gpt-auto properly
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 28c2194285..506f9ca68f 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -263,11 +263,9 @@ Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago
If a unit name with no extension is given, an extension of
.target will be assumed.
- This is similar to changing the runlevel in a
- traditional init system. The isolate
- command will immediately stop processes that are not enabled
- in the new unit, possibly including the graphical
- environment or terminal you are currently using.
+ This command is dangerous, since it will immediately stop processes that are not enabled in
+ the new target, possibly including the graphical environment or terminal you are currently using.
+ Note that this is allowed only on units where
is enabled. See