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>
 
