diff -r d45f3f11ad76 -r 714fbd1391a2 make/uwproj.xsd
--- a/make/uwproj.xsd Tue Nov 04 22:37:18 2025 +0100
+++ b/make/uwproj.xsd Sun Nov 30 22:16:31 2025 +0100
@@ -29,23 +29,61 @@
The configuration section.
- Consists of an arbitrary number of
The optional
+ You may customize the value and the help text,
+ but the variable name and the option name are pre-defined.
+ var elements.
+ Consists of an arbitrary number of var elements and pre-defined elements for
+ standard installation directories. If you want to use standard installation directories, you
+ must list the wanted variables here.
platform attribute may specify a single platform identifier and
the optional not attribute may specify a comma-separated list of platform identifiers.
The configure script shall skip this config declaration if the detected platform is not matching
the filter specification of these attributes.
+ When multiple config sections have a matching filter, and declare the same variables, the settings
+ of the first matching config section will be used for the affected variables.
name attribute is mandatory, the value is defined by the text body of the element.
- The optional Boolean exec attribute (false by default) controls, whether the entire
- definition is automatically executed under command substitution.
+ The optional Boolean exec attribute (false by default) controls, whether value denotes
+ a command which shall be executed at configuration time to produce the value.
+ With option and option-help you can control how the variable can be
+ overridden on the command line. When you don't specify either of those attributes, no command
+ line option will be generated. When you provide a option-help, but do not specify the
+ option name, a name is generated.
+ You can use the string %default in your help text when you want to show the default
+ value in the text. When exec is used, the default will not be resolved in the help
+ text and instead the command is shown (to avoid breaking the formatting).
arg attribute.
- Then, the children of this element specify possible values by defining the conditions
+ Optionally, a description for the help text of the resulting configure script can be specified by
+ a desc element.
+ Then, the next children of this element specify possible values by defining the conditions
(in terms of dependencies) and effects (in terms of defines and make variables) of each value.
Finally, a set of defaults is specified which supposed to automagically select the most
appropriate value for a specific platform under the available dependencies (in case the option is not
@@ -236,6 +285,7 @@