[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: Add custom build command option.

[Michael Pyne]

Git commit 382afa11df63fd8924ea891165540d5327e6d74b by Michael Pyne.
Committed on 28/07/2012 at 23:12.
Pushed by ashark into branch 'docbook_historied_per_file'.

Add custom build command option.

Unfortunately I was not able to split out moving safe_make and
run_make_command with the actual implementation of this option
after-the-fact. Whoops.

This should implement support for a custom build command (and custom
install command, assuming the install can be performed by adding
'install' to the command line).

Hopefully that will be sufficient for 'ninja' or other buildsystems.
Note that this only changes the *build* command, the other parts of the
build system still needs to be supported in kdesrc-build (for now,
custom build systems probably wouldn't be too hard to implement if
necessary).

Assuming your proposed command is available in PATH and can be called
like make, doing something like this should suffice:

module (or module-set) foo
    custom-build-command ninja
end module (or module-set)

BUG:303692

Original commit: 9d0f34ce
https://invent.kde.org/sdk/kdesrc-build/-/commit/9d0f34cefd1f7233cc90cf3f17b8566a280dd3f8

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

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

diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 4b32f9c9..fc64a8c8 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -213,6 +213,24 @@ only works for qt.</emphasis></para>
 </entry>
 </row>
 
+<row id="conf-custom-build-command">
+<entry>custom-build-command</entry>
+<entry>Module setting overrides global</entry>
+<entry>
+    <para>This option can be set to run a different command (other than
+    <command>make</command>, for example) in order to perform the build
+    process.  &kdesrc-build; should in general do the right thing, so you
+    should not need to set this option. However it can be useful to use
+    alternate build systems.
+    </para>
+
+    <para>The value of this option is used as the command line to run, modified
+    by the <link linkend="conf-make-options">make-options</link> option as
+    normal.
+    </para>
+</entry>
+</row>
+
 <row id="conf-cxxflags">
 <entry>cxxflags</entry>
 <entry>Appends to global option</entry>