[sdk/kdesrc-build/docbook_historied_per_file] doc/cmdline: Document the new --list-build and --dependency-tree commandline options.

[Johan Ouwerkerk]

Git commit 009c1047ade102acbde012b4941650736bd91d71 by Johan Ouwerkerk.
Committed on 31/03/2019 at 11:07.
Pushed by ashark into branch 'docbook_historied_per_file'.

Document the new --list-build and --dependency-tree commandline options.

Original commit: 8bbd8954
https://invent.kde.org/sdk/kdesrc-build/-/commit/8bbd895462819835c9456ed846f623bb7341fa38

M  +29   -0    doc/cmdline/supported-cmdline-params.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/009c1047ade102acbde012b4941650736bd91d71

diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index b50ded18..04b0c2f4 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -512,6 +512,35 @@ also <xref linkend="kdesrc-buildrc" />.
 </para></listitem>
 </varlistentry>
 
+<varlistentry id="cmdline-list-build">
+<term><parameter>--list-build</parameter></term>
+<listitem>
+<para>
+    Lists the modules that would be built, in the order in which they would be built.
+    If applicable, the output listing also mentions which commit/branch/tag would be
+    selected for checkout.
+</para>
+<para>
+    This option is similar to
+    <link linkend="cmdline-print-modules"><option>--print-modules</option></link>.
+    For more detailed information on how modules relate to each other, see also:
+    <link linkend="cmdline-dependency-tree"><option>--dependency-tree</option></link>.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry id="cmdline-dependency-tree">
+<term><parameter>--dependency-tree</parameter></term>
+<listitem>
+<para>
+    Prints out dependency information on the modules that would be built using a tree
+    format (recursive). Listed information also includes which specific commit/branch/tag
+    is dependend on and whether or not the dependency would be built. Note: the generated
+    output may become quite large for applications with many dependencies.
+</para>
+</listitem>
+</varlistentry>
+
 <varlistentry id="cmdline-run">
 <term><parameter>--run</parameter></term>
 <listitem><para>