[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