[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: Add new option 'include-dependencies'.

[Michael Pyne]

Git commit b410ca35592270f25487f0f042f5331282aa6564 by Michael Pyne.
Committed on 22/02/2015 at 03:07.
Pushed by ashark into branch 'docbook_historied_per_file'.

Add new option 'include-dependencies'.

Currently it (probably) doesn't support pulling in options for these
modules from their host module-sets (although using 'options' sections
might actually work). I think it ignores the 'ignore-modules' option as
well.

Other than that, it should do pretty much what it says on the tin,
although I had to implement a few other bug fixes as well to get it to
that point.

I want to say that there was an open bug for this but I can't seem to
find it now.

Original commit: b452401f
https://invent.kde.org/sdk/kdesrc-build/-/commit/b452401f50d3c740e8529986bf19e074920be0c6

M  +20   -0    doc/kdesrc-buildrc/conf-options-table.docbook

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

diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 6e7ea349..48606442 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -531,6 +531,26 @@ is compared).</para>
 </entry>
 </row>
 
+<row id="conf-include-dependencies">
+<entry>include-dependencies</entry>
+<entry>Module setting overrides global</entry>
+<entry>
+<para>This option, when set to <userinput>true</userinput> requests that
+&kdesrc-build; also include known dependencies of this module in its build,
+without requiring you to mention those dependencies (even indirectly).</para>
+
+<note><para>This option only works for <link
+linkend="kde-projects-module-sets"><literal>kde-project</literal>-based
+modules</link>, and requires that the metadata maintained by the &kde;
+developers is accurate for your selected <link
+linkend="conf-branch-group">branch-group</link>.</para></note>
+
+<para>This option is disabled by default, to avoid inadvertently selecting a
+bunch of modules that were not desired. It was added with &kdesrc-build;
+1.16 in 2015.</para>
+</entry>
+</row>
+
 <row id="conf-install-after-build">
 <entry>install-after-build</entry>
 <entry>Module setting overrides global</entry>