[sdk/kdesrc-build/docbook_historied_per_file] doc/cmdline: Add and document --rebuild-failures command line option.

[Michael Pyne]

Git commit 1b4cec70f485d2172301ad63e37792e05689c20d by Michael Pyne.
Committed on 26/08/2015 at 20:53.
Pushed by ashark into branch 'docbook_historied_per_file'.

Add and document --rebuild-failures command line option.

Original commit: 51c3a7ec
https://invent.kde.org/sdk/kdesrc-build/-/commit/51c3a7ec543aedc87b685f88fd6b5fbeac5ea350

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

https://invent.kde.org/sdk/kdesrc-build/-/commit/1b4cec70f485d2172301ad63e37792e05689c20d

diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index 445e52b0..98fb5cf4 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -150,6 +150,24 @@ linkend="cmdline-pretend">--pretend</link></option> command line option to work.
 </para></listitem>
 </varlistentry>
 
+<varlistentry id="cmdline-rebuild-failures">
+<term><parameter>--rebuild-failures</parameter></term>
+<listitem><para>
+Use this option to build only those modules which failed to build on a previous
+&kdesrc-build; run. This is useful if a significant number of failures occurred mixed with
+successful builds. After fixing the issue causing the build failures you can then easily
+build only the modules that failed previously.</para>
+
+<note><para>Note that the list of <quote>previously-failed modules</quote> is
+reset every time a &kdesrc-build; run finishes with some module failures.
+However it is not reset by a completely successful build, so you can
+successfully rebuild a module or two and this flag will still
+work.</para></note>
+
+<para>This option was added for &kdesrc-build; 15.09.</para>
+</listitem>
+</varlistentry>
+
 <varlistentry id="cmdline-ignore-modules">
 <term><parameter>--ignore-modules</parameter></term>
 <listitem><para>