[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: Bracket modules into sorted tiers.

[Michael Pyne]

Git commit 6930018f02d1fb1c4374a0fc2387b0b86e77675d by Michael Pyne.
Committed on 30/03/2012 at 11:14.
Pushed by ashark into branch 'docbook_historied_per_file'.

Bracket modules into sorted tiers.

This occurs before dependency resolution (so that the dependency metadata is
still "preferred"), and is a simplistic dependency sorting technique.

This prevents dependency-data metadata from having to become insanely
complicated to ensure that each module depends on kdelibs (since kdelibs can't
simply be special-cased to be "dependency #2" as it has a lot of dependencies
itself on kdesupport/ modules like automoc.

So, we instead group modules after dependency resolution into:

qt (right now, just the projects.kde.org one, not any generic Qt)
kdesupport/*
kdelibs
projects.kde.org modules not already determined
other modules

It is possible to override the tier you end up at by setting the
"ordering-tier" option for that module to an integer.

Original commit: 089edc6a
https://invent.kde.org/sdk/kdesrc-build/-/commit/089edc6a73646bce540d39c784fd2991cdefd1d2

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

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

diff --git a/doc/kdesrc-buildrc/conf-options-table.docbook b/doc/kdesrc-buildrc/conf-options-table.docbook
index 5cf29621..25e35550 100644
--- a/doc/kdesrc-buildrc/conf-options-table.docbook
+++ b/doc/kdesrc-buildrc/conf-options-table.docbook
@@ -512,6 +512,27 @@ module if it normally would have tried anyways.</entry>
 due to fixes in the underlying build system.</entry>
 </row>
 
+<row id="conf-ordering-tier">
+<entry>ordering-tier</entry>
+<entry>Module setting overrides global</entry>
+<entry><para>This option allows the user to alter the grouping &kdesrc-build;
+will use for this module, for the purpose of determining the order to build
+modules in.
+</para>
+<para>The value should be a whole number (i.e. integer) greater than or equal to 0.
+The lower the value, the earlier &kdesrc-build; will try to build the module.
+</para>
+
+<tip><para>You shouldn't need to use this option... and if you do, you should only need to use it
+to get a module to build before kdelibs. In this case you would want to set this option to
+<option><replaceable>1</replaceable></option>, which is the grouping used for modules that
+kdelibs itself depends on.
+</para></tip>
+
+<para>This option was added in &kdesrc-build; 1.15.</para>
+</entry>
+</row>
+
 <row id="conf-override-url">
 <entry>override-url</entry>
 <entry>Module setting overrides global</entry>