| 27 <xs:complexType name="ConfigType"> |
27 <xs:complexType name="ConfigType"> |
| 28 <xs:annotation> |
28 <xs:annotation> |
| 29 <xs:documentation> |
29 <xs:documentation> |
| 30 <p> |
30 <p> |
| 31 The configuration section. |
31 The configuration section. |
| 32 Consists of an arbitrary number of <code>var</code> elements. |
32 Consists of an arbitrary number of <code>var</code> elements and pre-defined elements for |
| |
33 standard installation directories. If you want to use standard installation directories, you |
| |
34 must list the wanted variables here. |
| 33 </p> |
35 </p> |
| 34 <p> |
36 <p> |
| 35 The optional <code>platform</code> attribute may specify a <em>single</em> platform identifier and |
37 The optional <code>platform</code> attribute may specify a <em>single</em> platform identifier and |
| 36 the optional <code>not</code> attribute may specify a comma-separated list of platform identifiers. |
38 the optional <code>not</code> attribute may specify a comma-separated list of platform identifiers. |
| 37 The configure script shall skip this config declaration if the detected platform is not matching |
39 The configure script shall skip this config declaration if the detected platform is not matching |
| 38 the filter specification of these attributes. |
40 the filter specification of these attributes. |
| |
41 When multiple config sections have a matching filter, and declare the same variables, the settings |
| |
42 of the first matching config section will be used for the affected variables. |
| 39 </p> |
43 </p> |
| 40 </xs:documentation> |
44 </xs:documentation> |
| 41 </xs:annotation> |
45 </xs:annotation> |
| 42 <xs:sequence> |
46 <xs:sequence> |
| |
47 <xs:element name="prefix" type="StandardConfigVarType" minOccurs="0"/> |
| |
48 <xs:element name="exec-prefix" type="StandardConfigVarType" minOccurs="0"/> |
| |
49 <xs:element name="bindir" type="StandardConfigVarType" minOccurs="0"/> |
| |
50 <xs:element name="sbindir" type="StandardConfigVarType" minOccurs="0"/> |
| |
51 <xs:element name="libdir" type="StandardConfigVarType" minOccurs="0"/> |
| |
52 <xs:element name="libexecdir" type="StandardConfigVarType" minOccurs="0"/> |
| |
53 <xs:element name="datarootdir" type="StandardConfigVarType" minOccurs="0"/> |
| |
54 <xs:element name="datadir" type="StandardConfigVarType" minOccurs="0"/> |
| |
55 <xs:element name="sysconfdir" type="StandardConfigVarType" minOccurs="0"/> |
| |
56 <xs:element name="sharedstatedir" type="StandardConfigVarType" minOccurs="0"/> |
| |
57 <xs:element name="localstatedir" type="StandardConfigVarType" minOccurs="0"/> |
| |
58 <xs:element name="runstatedir" type="StandardConfigVarType" minOccurs="0"/> |
| |
59 <xs:element name="includedir" type="StandardConfigVarType" minOccurs="0"/> |
| |
60 <xs:element name="infodir" type="StandardConfigVarType" minOccurs="0"/> |
| |
61 <xs:element name="localedir" type="StandardConfigVarType" minOccurs="0"/> |
| |
62 <xs:element name="mandir" type="StandardConfigVarType" minOccurs="0"/> |
| 43 <xs:element name="var" type="ConfigVarType" minOccurs="0" maxOccurs="unbounded"/> |
63 <xs:element name="var" type="ConfigVarType" minOccurs="0" maxOccurs="unbounded"/> |
| 44 </xs:sequence> |
64 </xs:sequence> |
| 45 <xs:attribute name="platform" type="xs:string"/> |
65 <xs:attribute name="platform" type="xs:string"/> |
| 46 <xs:attribute name="not" type="xs:string"/> |
66 <xs:attribute name="not" type="xs:string"/> |
| 47 </xs:complexType> |
67 </xs:complexType> |
| 48 |
68 |
| |
69 <xs:complexType name="StandardConfigVarType"> |
| |
70 <xs:annotation> |
| |
71 <xs:documentation> |
| |
72 The definition of a standard configuration variable. |
| |
73 <p> |
| |
74 You may customize the value and the help text, |
| |
75 but the variable name and the option name are pre-defined. |
| |
76 </p> |
| |
77 </xs:documentation> |
| |
78 </xs:annotation> |
| |
79 <xs:simpleContent> |
| |
80 <xs:extension base="xs:string"> |
| |
81 <xs:attribute name="option-help" type="xs:string"/> |
| |
82 <xs:attribute name="exec" type="xs:boolean" default="false"/> |
| |
83 </xs:extension> |
| |
84 </xs:simpleContent> |
| |
85 </xs:complexType> |
| |
86 |
| 49 <xs:complexType name="ConfigVarType"> |
87 <xs:complexType name="ConfigVarType"> |
| 50 <xs:annotation> |
88 <xs:annotation> |
| 51 <xs:documentation> |
89 <xs:documentation> |
| 52 The definition of a configuration variable. |
90 The definition of a configuration variable. |
| 53 <p> |
91 <p> |
| 54 Configuration variables are supposed to be used in the configure script and are also |
92 Configuration variables are supposed to be used in the configure script and are also |
| 55 written to the resulting config file (in contrast to make variables, which are only |
93 written to the resulting config file (in contrast to make variables, which are only |
| 56 written to the config file). |
94 written to the config file). |
| 57 The <code>name</code> attribute is mandatory, the value is defined by the text body of the element. |
95 The <code>name</code> attribute is mandatory, the value is defined by the text body of the element. |
| 58 The optional Boolean <code>exec</code> attribute (false by default) controls, whether the entire |
96 The optional Boolean <code>exec</code> attribute (false by default) controls, whether value denotes |
| 59 definition is automatically executed under command substitution. |
97 a command which shall be executed at configuration time to produce the value. |
| |
98 With <code>option</code> and <code>option-help</code> you can control how the variable can be |
| |
99 overridden on the command line. When you don't specify either of those attributes, no command |
| |
100 line option will be generated. When you provide a <code>option-help</code>, but do not specify the |
| |
101 <code>option</code> name, a name is generated. |
| |
102 You can use the string <code>%default</code> in your help text when you want to show the default |
| |
103 value in the text. When <code>exec</code> is used, the default will not be resolved in the help |
| |
104 text and instead the command is shown (to avoid breaking the formatting). |
| 60 </p> |
105 </p> |
| 61 </xs:documentation> |
106 </xs:documentation> |
| 62 </xs:annotation> |
107 </xs:annotation> |
| 63 <xs:simpleContent> |
108 <xs:simpleContent> |
| 64 <xs:extension base="xs:string"> |
109 <xs:extension base="xs:string"> |
| 65 <xs:attribute name="name" type="xs:string" use="required"/> |
110 <xs:attribute name="name" type="xs:string" use="required"/> |
| |
111 <xs:attribute name="option" type="xs:string"/> |
| |
112 <xs:attribute name="option-help" type="xs:string"/> |
| 66 <xs:attribute name="exec" type="xs:boolean" default="false"/> |
113 <xs:attribute name="exec" type="xs:boolean" default="false"/> |
| 67 </xs:extension> |
114 </xs:extension> |
| 68 </xs:simpleContent> |
115 </xs:simpleContent> |
| 69 </xs:complexType> |
116 </xs:complexType> |
| 70 |
117 |