[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: Add support for overridding detected build system.

[Michael Pyne]

Git commit 49351d3df66745e04d7f982019951e864c0488fc by Michael Pyne.
Committed on 01/09/2012 at 23:41.
Pushed by ashark into branch 'docbook_historied_per_file'.

Add support for overridding detected build system.

This is necessary in situations where the source includes more than one
build system (especially when only one of those actually works but
kdesrc-build auto-detects the other). The current example would be
libraptor.

Original commit: c29948e3
https://invent.kde.org/sdk/kdesrc-build/-/commit/c29948e3a5325a3178c7162e3b1261af6ae7fed4

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

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

diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 9e47c5c5..dfcaac2b 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -579,6 +579,46 @@ module if it normally would have tried anyways.</entry>
 due to fixes in the underlying build system.</entry>
 </row>
 
+<row id="conf-override-build-system">
+<entry>override-build-system</entry>
+<entry>Module setting overrides global</entry>
+<entry><para>This is an advanced option, added in &kdesrc-build; 1.16.</para>
+
+<para>Normally &kdesrc-build; will detect the appropriate build system to use
+for a module after it is downloaded. This is done by checking for the existence
+of specific files in the module's source directory.</para>
+
+<para>Some modules may include more than one required set of files, which could confuse
+the auto-detection. In this case you can manually specify the correct build type.</para>
+
+<para>Currently supported build types that can be set are:</para>
+
+<variablelist>
+    <varlistentry>
+        <term>KDE</term>
+        <listitem><para>Used to build &kde; modules. In reality it can be used to build
+            almost any module that uses &cmake; but it is best not to rely on this.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+        <term>Qt</term>
+        <listitem><para>Used to build the &Qt; library itself.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+        <term>qmake</term>
+        <listitem><para>Used to build &Qt; modules that use
+            <application>qmake</application>-style <literal>.pro</literal>
+            files.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+        <term>generic</term>
+        <listitem><para>Used to build modules that use plain Makefiles and that do not
+            require any special configuration.</para></listitem>
+    </varlistentry>
+</variablelist>
+
+</entry>
+</row>
+
 <row id="conf-override-url">
 <entry>override-url</entry>
 <entry>Module setting overrides global</entry>