[sdk/kdesrc-build/docbook_historied_per_file] doc: Allow ignoring modules from global config

Andrew Shark null at kde.org
Fri May 10 10:16:52 BST 2024


Git commit 24f6b604e110113070dfef7e3d3951fbe55a1a2f by Andrew Shark.
Committed on 28/01/2024 at 07:28.
Pushed by ashark into branch 'docbook_historied_per_file'.

Allow ignoring modules from global config

This will let users to constantly ignore specified modules in global section, so they do not need to pass it in command line each time.

Also, it will allow to ignore some defined modules that are not in any module set (for example, gpgme).

BUG: 472917

Original commit: 66bff6dc
https://invent.kde.org/sdk/kdesrc-build/-/commit/66bff6dc56039cc75bcc64bc5a7c6fb38f9b1e82

M  +3    -1    doc/cmdline/supported-cmdline-params.docbook
M  +2    -2    doc/kdesrc-buildrc/conf-options-table.docbook

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

diff --git a/doc/cmdline/supported-cmdline-params.docbook b/doc/cmdline/supported-cmdline-params.docbook
index 494a3363..7c4f8f31 100644
--- a/doc/cmdline/supported-cmdline-params.docbook
+++ b/doc/cmdline/supported-cmdline-params.docbook
@@ -53,7 +53,9 @@ Do not include the modules passed on the rest of the command line in the
 update/build process (this is useful if you want to build most of the modules
 in your <link linkend="configure-data">configuration file</link> and just skip
 a few).
-</para></listitem>
+</para>
+<para>Note that this option does not override <link linkend="conf-ignore-modules">ignore-modules</link> config option in global section. Instead, it appends it.</para>
+</listitem>
 </varlistentry>
 
 <varlistentry id="cmdline-run">
diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 8722b1ae..ed52e6bc 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -1335,8 +1335,8 @@ installations. However this only works on build systems that support
 <member>Type</member><member>String</member>
 <member>Available since</member><member>1.16</member>
 </simplelist>
-<para>Currently can only be used in module-set, see <ulink
-url="https://bugs.kde.org/show_bug.cgi?id=472917">Bug 472917</ulink>.</para>
+<para>This option can be used in global section and in module-sets.</para>
+<para>Note that when specified in global section, &cmd-ignore-modules; cmdline option does not override this, but instead appends.</para>
 <para>Modules named by this option, which would be chosen by &kdesrc-build;
 due to a <link linkend="conf-use-modules">use-modules</link> option, are
 instead skipped entirely. Use this option when you want to build an entire



More information about the kde-doc-english mailing list