From 588e3e8008d24021ec025d54318fb07d2212293c Mon Sep 17 00:00:00 2001

From: Lennart Poettering <lennart@poettering.net>

Date: Tue, 26 Mar 2019 18:02:49 +0100

Subject: [PATCH] man: document the new systemctl --show-transaction option

(cherry picked from commit df4a7cb7323c8cf00553d766913312c5b7ccd508)

Related: #846319

---

 man/systemctl.xml | 14 ++++++++++++++

 1 file changed, 14 insertions(+)

diff --git a/man/systemctl.xml b/man/systemctl.xml

index 6145486123..fa08ab6c0a 100644

--- a/man/systemctl.xml

+++ b/man/systemctl.xml

@@ -298,6 +298,20 @@

       </varlistentry>

+      <varlistentry>

+        <term><option>-T</option></term>

+        <term><option>--show-transaction</option></term>

+

+        <listitem>

+          <para>When enqueuing a unit job (for example as effect of a <command>systemctl start</command>

+          invocation or similar), show brief information about all jobs enqueued, covering both the requested

+          job and any added because of unit dependencies. Note that the output will only include jobs

+          immediately part of the transaction requested. It is possible that service start-up program code

+          run as effect of the enqueued jobs might request further jobs to be pulled in. This means that

+          completion of the listed jobs might ultimately entail more jobs than the listed ones.</para>

+        </listitem>

+      </varlistentry>

+

       <varlistentry>

         <term><option>--fail</option></term>