From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 20 Dec 2023 14:01:52 +0000 (+0100)
Subject: man: try to improve wording on --slice-inherit docs
X-Git-Tag: v256-rc1~1428^2~2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2118b179ca0d99f44953e3913318bd20d7ba509b;p=thirdparty%2Fsystemd.git

man: try to improve wording on --slice-inherit docs
---

diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 7b508a462c5..e6cf2a3bcb0 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -176,11 +176,14 @@
         <term><option>--slice-inherit</option></term>
 
         <listitem><para>Make the new <filename>.service</filename> or <filename>.scope</filename> unit part
-        of the inherited slice. This option can be combined with <option>--slice=</option>.</para>
-
-        <para>An inherited slice is located within <command>systemd-run</command> slice. Example: if
-        <command>systemd-run</command> slice is <filename>foo.slice</filename>, and the
-        <option>--slice=</option> argument is <filename>bar</filename>, the unit will be placed under the
+        of the slice the <command>systemd-run</command> itself has been invoked in. This option may be
+        combined with <option>--slice=</option>, in which case the slice specified via
+        <option>--slice=</option> is placed within the slice the <command>systemd-run</command> command is
+        invoked in.</para>
+
+        <para>Example: consider <command>systemd-run</command> being invoked in the slice
+        <filename>foo.slice</filename>, and the <option>--slice=</option> argument is
+        <filename>bar</filename>. The unit will then be placed under
         <filename>foo-bar.slice</filename>.</para>
 
         <xi:include href="version-info.xml" xpointer="v246"/>
diff --git a/src/run/run.c b/src/run/run.c
index 920e38af0c9..45da75f8897 100644
--- a/src/run/run.c
+++ b/src/run/run.c
@@ -110,7 +110,7 @@ static int help(void) {
                "  -p --property=NAME=VALUE        Set service or scope unit property\n"
                "     --description=TEXT           Description for unit\n"
                "     --slice=SLICE                Run in the specified slice\n"
-               "     --slice-inherit              Inherit the slice\n"
+               "     --slice-inherit              Inherit the slice from the caller\n"
                "     --expand-environment=BOOL    Control expansion of environment variables\n"
                "     --no-block                   Do not wait until operation finished\n"
                "  -r --remain-after-exit          Leave service around until explicitly stopped\n"