universe@753: <?xml version="1.0" encoding="UTF-8"?>
universe@753: <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
universe@753:            xmlns="http://unixwork.de/uwproj"
universe@753:            targetNamespace="http://unixwork.de/uwproj"
universe@753:            elementFormDefault="qualified"
universe@815:            version="0.2"
universe@753: >
universe@753:     <xs:element name="project" type="ProjectType"/>
universe@753: 
universe@753:     <xs:complexType name="ProjectType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 The root element of an uwproj project.
universe@753:                 Consists of an optional <code>config</code> element
universe@753:                 and an arbitrary number of <code>dependency</code>
universe@753:                 and <code>target</code> elements.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:sequence>
universe@753:             <xs:element name="config" type="ConfigType" minOccurs="0"/>
universe@753:             <xs:element name="dependency" type="DependencyType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:             <xs:element name="target" type="TargetType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:         </xs:sequence>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="ConfigType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 The configuration section.
universe@753:                 Consists of an arbitrary number of <code>var</code> elements.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:sequence>
universe@753:             <xs:element name="var" type="ConfigVarType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:         </xs:sequence>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="ConfigVarType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 The definition of a configuration variable.
universe@753:                 <p>
universe@753:                     Configuration variables are supposed to be used in the configure script and are also
universe@753:                     written to the resulting config file (in contrast to make variables, which are only
universe@753:                     written to the config file).
universe@753:                     The <code>name</code> attribute is mandatory, the value is defined by the text body of the element.
universe@753:                     The optional Boolean <code>exec</code> attribute (false by default) controls, whether the entire
universe@753:                     definition is automatically executed under command substitution.
universe@753:                 </p>
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:simpleContent>
universe@753:             <xs:extension base="xs:string">
universe@753:                 <xs:attribute name="name" type="xs:string" use="required"/>
universe@753:                 <xs:attribute name="exec" type="xs:boolean" default="false"/>
universe@753:             </xs:extension>
universe@753:         </xs:simpleContent>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="PkgConfigType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Instructs configure to invoke <code>pkg-config</code>, if present on the system, to determine
universe@753:                 compiler and linker flags. The text body of this element defines the package name to search.
universe@753:                 To constrain the allowed versions, use the attributes <code>atleast, exact, max</code>.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:simpleContent>
universe@753:             <xs:extension base="xs:string">
universe@753:                 <xs:attribute name="atleast" type="xs:string"/>
universe@753:                 <xs:attribute name="exact" type="xs:string"/>
universe@753:                 <xs:attribute name="max" type="xs:string"/>
universe@753:             </xs:extension>
universe@753:         </xs:simpleContent>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:simpleType name="LangType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Requests a compiler for the specified language. Allowed values are
universe@753:                 c, cpp.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:restriction base="xs:string">
universe@753:             <xs:enumeration value="c"/>
universe@753:             <xs:enumeration value="cpp"/>
universe@753:         </xs:restriction>
universe@753:     </xs:simpleType>
universe@753: 
universe@753:     <xs:complexType name="DependencyType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Declares a dependency.
universe@753:                 <p>
universe@753:                     If the optional <code>name</code> attribute is omitted, the dependency is global
universe@753:                     and must be satisfied, otherwise configuration shall fail.
universe@753:                     A <em>named dependency</em> can be referenced by a target (or is implicitly referenced
universe@753:                     by the default target, if no targets are specified).
universe@753:                     Multiple declarations for the same named dependency may exist, in which case each declaration
universe@753:                     is checked one after another, until one block is satisfied. The result of the first satisfied
universe@753:                     dependency declaration is supposed to be applied to the config file.
universe@753:                 </p>
universe@753:                 <p>
universe@753:                     The optional <code>platform</code> attribute may specify a <em>single</em> platform identifier and
universe@815:                     the optional <code>toolchain</code> attribute may specify a <em>single</em> toolchain.
universe@815:                     The optional <code>not</code> attribute may specify a comma-separated list of platform and/or
universe@815:                     toolchain identifiers.
universe@815:                     The configure script shall skip this dependency declaration if the detected platform and toolchain
universe@815:                     is not matching the filter specification of these attributes.
universe@753:                 </p>
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:choice minOccurs="0" maxOccurs="unbounded">
universe@753:             <xs:element name="lang" type="LangType"/>
universe@753:             <xs:element name="cflags" type="FlagsType"/>
universe@753:             <xs:element name="cxxflags" type="FlagsType"/>
universe@753:             <xs:element name="ldflags" type="FlagsType"/>
universe@753:             <xs:element name="pkgconfig" type="PkgConfigType"/>
universe@753:             <xs:element name="test" type="xs:string">
universe@753:                 <xs:annotation>
universe@753:                     <xs:documentation>
universe@753:                         Specifies a custom command that shall be executed to test whether this dependency is satisfied.
universe@753:                     </xs:documentation>
universe@753:                 </xs:annotation>
universe@753:             </xs:element>
universe@753:             <xs:element name="make" type="MakeVarType"/>
universe@753:         </xs:choice>
universe@753:         <xs:attribute name="name" type="xs:string"/>
universe@753:         <xs:attribute name="platform" type="xs:string"/>
universe@815:         <xs:attribute name="toolchain" type="xs:string"/>
universe@753:         <xs:attribute name="not" type="xs:string"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="FlagsType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Instructs configure to append the contents of the element's body to the respective flags variable.
universe@753:                 If the optional <code>exec</code> flag is set to <code>true</code>, the contents are supposed to be
universe@753:                 executed under command substitution <em>at configuration time</em> before they are applied.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:simpleContent>
universe@753:             <xs:extension base="xs:string">
universe@753:                 <xs:attribute name="exec" type="xs:boolean" default="false"/>
universe@753:             </xs:extension>
universe@753:         </xs:simpleContent>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="TargetType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Declares a build target that is supposed to be configured.
universe@753:                 <p>
universe@753:                     If no build target is declared explicitly, an implicit default
universe@753:                     target is generated, which has the <code>alldependencies</code>
universe@753:                     flag set.
universe@753:                 </p>
universe@753:                 <p>
universe@753:                     The optional <code>name</code> attribute is also used to generate a prefix
universe@753:                     for the compiler and linker flags variables.
universe@753:                     Furthermore, a target may consist of an arbitrary number of <code>feature</code>,
universe@753:                     <code>option</code>, and <code>define</code> elements.
universe@753:                     Named dependencies can be listed (separated by comma) in the <code>dependencies</code>
universe@753:                     element. If this target shall use <em>all</em> available named dependencies, the empty
universe@753:                     element <code>alldependencies</code> can be used as a shortcut.
universe@753:                 </p>
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:choice minOccurs="0" maxOccurs="unbounded">
universe@753:             <xs:element name="feature" type="FeatureType"/>
universe@753:             <xs:element name="option" type="OptionType"/>
universe@753:             <xs:element name="define" type="DefineType"/>
universe@753:             <xs:element name="dependencies" type="DependenciesType"/>
universe@753:             <xs:element name="alldependencies">
universe@753:                 <xs:complexType/>
universe@753:             </xs:element>
universe@753:         </xs:choice>
universe@753:         <xs:attribute name="name" type="xs:string"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="FeatureType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Declares an optional feature, that can be enabled during configuration, if all
universe@753:                 <code>dependencies</code> are satisfied.
universe@753:                 If a feature is enabled, all <code>define</code> and <code>make</code> definitions are
universe@753:                 supposed to be applied to the config file.
universe@753:                 In case the optional <code>default</code> attribute is set to true, the feature is enabled by default
universe@753:                 and is supposed to be automatically disabled (without error) when the dependencies are not satisfied.
universe@753:                 The name that is supposed to be used for the --enable and --disable arguments can be optionally
universe@753:                 specified with the <code>arg</code> attribute. Otherwise, the <code>name</code> is used by default.
universe@815:                 Optionally, a description for the help text of the resulting configure script can be specified by
universe@815:                 adding a <code>desc</code> element.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:choice minOccurs="0" maxOccurs="unbounded">
universe@753:             <xs:group ref="TargetDataGroup"/>
universe@753:         </xs:choice>
universe@753:         <xs:attribute name="name" type="xs:string" use="required"/>
universe@753:         <xs:attribute name="arg" type="xs:string"/>
universe@753:         <xs:attribute name="default" type="xs:boolean" default="false"/>
universe@815:         <xs:element name="desc" type="xs:string"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="OptionType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Declares a configuration option.
universe@753:                 The option argument name is specified with the <code>arg</code> attribute.
universe@753:                 Then, the children of this element specify possible <code>values</code> by defining the conditions
universe@753:                 (in terms of dependencies) and effects (in terms of defines and make variables) of each value.
universe@753:                 Finally, a set of <code>default</code>s is specified which supposed to automagically select the most
universe@753:                 appropriate value for a specific platform under the available dependencies (in case the option is not
universe@753:                 explicitly specified by using the command line argument).
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:sequence>
universe@753:             <xs:element name="value" type="OptionValueType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:             <xs:element name="default" type="OptionDefaultType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:         </xs:sequence>
universe@753:         <xs:attribute name="arg" type="xs:string" use="required"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="OptionValueType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Declares a possible value for the option (in the <code>str</code> attribute) and
universe@753:                 the conditions (<code>dependencies</code>) and effects, the value has.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:choice minOccurs="0" maxOccurs="unbounded">
universe@753:             <xs:group ref="TargetDataGroup"/>
universe@753:         </xs:choice>
universe@753:         <xs:attribute name="str" type="xs:string" use="required"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:complexType name="OptionDefaultType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Specifies a default value for this option. Multiple default values can be specified, in which case
universe@753:                 they are checked one after another for availability. With the optional <code>platform</code> attribute,
universe@753:                 the default value can be constrained to a <em>single</em> specific platform and is supposed to be
universe@753:                 skipped by configure, when this platform is not detected.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:attribute name="value" type="xs:string" use="required"/>
universe@753:         <xs:attribute name="platform" type="xs:string"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:group name="TargetDataGroup">
universe@753:         <xs:choice>
universe@753:             <xs:element name="define" type="DefineType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:             <xs:element name="dependencies" type="DependenciesType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:             <xs:element name="make" type="MakeVarType" minOccurs="0" maxOccurs="unbounded"/>
universe@753:         </xs:choice>
universe@753:     </xs:group>
universe@753: 
universe@753:     <xs:complexType name="DefineType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 Specifies C/C++ pre-processor definitions that are supposed to
universe@753:                 be appended to the compiler flags, if supported.
universe@753:                 (Note: for example, Fortran also supports C/C++ style pre-processor definitions under
universe@753:                 certain circumstances)
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:attribute name="name" type="xs:string" use="required"/>
universe@753:         <xs:attribute name="value" type="xs:string"/>
universe@753:     </xs:complexType>
universe@753: 
universe@753:     <xs:simpleType name="DependenciesType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>A comma-separated list of named dependencies.</xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:restriction base="xs:string"/>
universe@753:     </xs:simpleType>
universe@753: 
universe@753:     <xs:simpleType name="MakeVarType">
universe@753:         <xs:annotation>
universe@753:             <xs:documentation>
universe@753:                 The text contents in the body of this element are supposed to be appended literally
universe@753:                 to the config file without prior processing.
universe@753:             </xs:documentation>
universe@753:         </xs:annotation>
universe@753:         <xs:restriction base="xs:string"/>
universe@753:     </xs:simpleType>
universe@815: </xs:schema>