84b277
From 8c346633426ec3476f87e7558407b75d9da1d5a4 Mon Sep 17 00:00:00 2001
84b277
From: "Jason St. John" <jstjohn@purdue.edu>
84b277
Date: Mon, 17 Mar 2014 00:03:46 -0400
84b277
Subject: [PATCH] man: improve wording of systemctl's --after/--before
84b277
84b277
Commit 4a77ca7 was an attempt at fixing the wording of --after and --before,
84b277
but the new wording was unclear.
84b277
84b277
Split the combined --after/--before section into a separate section for
84b277
each, explicitly state what each option does, and add information about
84b277
how these lists are generated.
84b277
84b277
Reported-by: Andrey Borzenkov <arvidjaar@gmail.com>
84b277
Reported-by: Lennart Poettering <lennart@poettering.net>
84b277
84b277
(cherry-picked from 9029f64298cb70c12ecf638fddee7f41b056fcf1)
84b277
84b277
Resolves: #1147524
84b277
---
84b277
 man/systemctl.xml | 21 ++++++++++++++++++---
84b277
 1 file changed, 18 insertions(+), 3 deletions(-)
84b277
84b277
diff --git a/man/systemctl.xml b/man/systemctl.xml
84b277
index 045d520..cb63bb0 100644
84b277
--- a/man/systemctl.xml
84b277
+++ b/man/systemctl.xml
84b277
@@ -173,12 +173,27 @@ systemctl start foo
84b277
 
84b277
       <varlistentry>
84b277
         <term><option>--after</option></term>
84b277
+
84b277
+        <listitem>
84b277
+          <para>With <command>list-dependencies</command>, show the
84b277
+          units that are ordered before the specified unit. In other
84b277
+          words, list the units that are in the <varname>After=</varname>
84b277
+          directive of the specified unit, have the specified unit in
84b277
+          their <varname>Before=</varname> directive, or are otherwise
84b277
+          implicit dependencies of the specified unit.</para>
84b277
+        </listitem>
84b277
+      </varlistentry>
84b277
+
84b277
+      <varlistentry>
84b277
         <term><option>--before</option></term>
84b277
 
84b277
         <listitem>
84b277
-          <para>Show after (before) which units the specified unit is started
84b277
-          with <command>list-dependencies</command>.
84b277
-          </para>
84b277
+          <para>With <command>list-dependencies</command>, show the
84b277
+          units that are ordered after the specified unit. In other
84b277
+          words, list the units that are in the <varname>Before=</varname>
84b277
+          directive of the specified unit, have the specified unit in
84b277
+          their <varname>After=</varname> directive, or otherwise depend
84b277
+          on the specified unit.</para>
84b277
         </listitem>
84b277
       </varlistentry>
84b277