[sdk/kdesrc-build/docbook_historied_per_file] doc: Allow 'options' groups to apply to named module-sets.

[Michael Pyne]

Git commit dc70f55c7dc6e494fbc8a16b94e48111a59b5740 by Michael Pyne.
Committed on 24/07/2016 at 17:01.
Pushed by ashark into branch 'docbook_historied_per_file'.

Allow 'options' groups to apply to named module-sets.

This makes it more convenient to work with baseline configurations (that
are 'include'd) without changing the upstream configuration.

Still to do: add a warning when modules and module-sets end up sharing
the same name somehow.

BUG:365813
FIXED-IN:16.08

Original commit: c3081844
https://invent.kde.org/sdk/kdesrc-build/-/commit/c3081844077eb53adb8a9d58c8a3e3dc66921cee

M  +1    -1    doc/index.docbook
M  +8    -0    doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook

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

diff --git a/doc/index.docbook b/doc/index.docbook
index 2a618664..44c6ff2a 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -144,7 +144,7 @@
 <legalnotice>&FDLNotice;</legalnotice>
 
 <date>2016-05-02</date>
-<releaseinfo>&kdesrc-build; 16.05</releaseinfo>
+<releaseinfo>&kdesrc-build; 16.08</releaseinfo>
 
 <abstract>
 <para>&kdesrc-build; is a script which builds and installs &kde; software
diff --git a/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook b/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook
index 0105c607..122a3760 100644
--- a/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook
+++ b/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook
@@ -112,6 +112,14 @@ mis-typing the name.</para></important>
 <literal>module-set</literal> worth of modules, all using the same options, and
 then using <literal>options</literal> groups to make individual changes.</para>
 
+<para><literal>options</literal> groups can also apply to named module sets.
+This allows expert users to use a common configuration file (which includes
+<literal>module-set</literal> declarations) as a baseline, and then make changes
+to the options used by those module-sets in configuration files that
+use the <literal><link
+linkend="kdesrc-buildrc-including">include</link></literal> command to reference
+the base configuration.</para>
+
 <example id="ex-options-group">
 <title>Example of using options</title>