From: Zbigniew Jędrzejewski-Szmek Date: Thu, 23 Jul 2020 07:03:58 +0000 (+0200) Subject: man: do not say that isolate is like switching runlevels X-Git-Tag: v246-rc2~11 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5cf821acf8bb65a265e38a5756871ab630255c8f;p=thirdparty%2Fsystemd.git man: do not say that isolate is like switching runlevels We need to do better here, but for now let's at least not trick users into nuking their graphical environment. Inspired by #16548. --- diff --git a/TODO b/TODO index 099ce36f01a..7d4d54aa7a0 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 28c2194285f..506f9ca68f8 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