Create a subdir for rbuild documentation.
authorEmanuele Aliberti <ea@iol.it>
Sat, 30 Jul 2005 16:53:09 +0000 (16:53 +0000)
committerEmanuele Aliberti <ea@iol.it>
Sat, 30 Jul 2005 16:53:09 +0000 (16:53 +0000)
Move rbuild.txt there.
Convert rbuild.txt in Docbook.
Fix some minor inconsistencies in the element reference.

svn path=/trunk/; revision=16895

reactos/tools/rbuild/doc/rbuild.dbk [new file with mode: 0644]
reactos/tools/rbuild/doc/rbuild.txt [moved from reactos/tools/rbuild/rbuild.txt with 100% similarity]

diff --git a/reactos/tools/rbuild/doc/rbuild.dbk b/reactos/tools/rbuild/doc/rbuild.dbk
new file mode 100644 (file)
index 0000000..edd6e85
--- /dev/null
@@ -0,0 +1,1529 @@
+<?xml version="1.0" encoding="US-ASCII"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+<book>
+  <title>ReactOS Build System Documentation</title>
+
+  <bookinfo>
+    <releaseinfo>$Id$</releaseinfo>
+
+    <author>
+      <firstname>Casper</firstname>
+
+      <surname>Hornstrup</surname>
+    </author>
+
+    <othercredit>
+      <surname>Emanuele Aliberti</surname>
+    </othercredit>
+
+    <copyright>
+      <year>2005</year>
+    </copyright>
+  </bookinfo>
+
+  <chapter>
+    <title>Building ReactOS</title>
+
+    <section>
+      <title>Building ReactOS</title>
+
+      <para>To generate GNU make makefiles and building ReactOS, do the
+      following:<orderedlist>
+          <listitem>
+            <para>Go to the top-level <filename>reactos</filename>
+            directory;</para>
+          </listitem>
+
+          <listitem>
+            <para>Run the command:<screen>mingw32-make</screen></para>
+
+            <para>This will start building ReactOS.</para>
+          </listitem>
+        </orderedlist></para>
+
+      <para>To build a bootable CD, run the following command:<screen>mingw32-make bootcd</screen>This
+      will create <filename>ReactOS.iso</filename> in the top-level
+      <filename>reactos</filename> directory.</para>
+    </section>
+  </chapter>
+
+  <chapter>
+    <title>How build directions are stored</title>
+
+    <para>XML files are used throughout the ReactOS source tree to drive the
+    build system.</para>
+
+    <section>
+      <title>Top-level XML Build File</title>
+
+      <para>The top-level XML build file (<filename>ReactOS.xml</filename>) is
+      processed by <command>rbuild</command>. The following is an example of
+      how it could look like:<programlisting>&lt;?xml version="1.0"?&gt;
+&lt;!DOCTYPE project SYSTEM "tools/rbuild/project.dtd"&gt;
+&lt;project name="ReactOS" makefile="Makefile.auto" xmlns:xi="http://www.w3.org/2001/XInclude"&gt;
+  &lt;xi:include href="config.xml"&gt;
+    &lt;xi:fallback&gt;
+      &lt;xi:include href="config.template.xml" /&gt;
+    &lt;/xi:fallback&gt;
+  &lt;/xi:include&gt;
+
+  &lt;define name="_M_IX86" /&gt;
+  &lt;if property="DBG" value="1"&gt;
+    &lt;define name="DBG" value="1" /&gt;
+    &lt;property name="DBG_OR_KDBG" value="true" /&gt;
+  &lt;/if&gt;
+
+  &lt;include base="ReactOS"&gt;include&lt;/include&gt;
+
+  &lt;directory name="boot"&gt;
+    &lt;xi:include href="boot/boot.xml" /&gt;
+  &lt;/directory&gt;
+
+  &lt;module name="bootcd" type="iso"&gt;
+  &lt;/module&gt;
+&lt;/project&gt;</programlisting></para>
+
+      <section>
+        <title>XInclude</title>
+
+        <para>XML files used by <command>rbuild</command> are modular and use
+        XInclude to include other chunks of XML in the top-level ReactOS.xml
+        file. The namespace used by XInclude is <literal>xi</literal>.</para>
+
+        <section>
+          <title>xi:include</title>
+
+          <para>It is possible to split an XML build file over several files.
+          The include element in the <literal>xi</literal> namespace is used
+          to accomplish this.</para>
+
+          <section>
+            <title>Syntax</title>
+
+            <programlisting>  &lt;xi:include href="config.xml"&gt;
+    &lt;xi:fallback&gt;
+      &lt;xi:include href="config.template.xml" /&gt;
+    &lt;/xi:fallback&gt;
+  &lt;/xi:include&gt;</programlisting>
+          </section>
+
+          <section>
+            <title>Attributes</title>
+
+            <para><variablelist>
+                <varlistentry>
+                  <term>href</term>
+
+                  <listitem>
+                    <para>Name of XML build file to include. The filename is
+                    relative to the location of the current XML build
+                    file.</para>
+                  </listitem>
+                </varlistentry>
+              </variablelist></para>
+          </section>
+
+          <section>
+            <title>Value</title>
+
+            <para>None.</para>
+          </section>
+
+          <section>
+            <title>Elements</title>
+
+            <para>xi:fallback</para>
+          </section>
+        </section>
+
+        <section>
+          <title>xi:fallback</title>
+
+          <para>This element is used to provide the name of an alternate file
+          that is to be included if the first include file did not
+          exists.</para>
+
+          <section>
+            <title>Attributes</title>
+
+            <para>None.</para>
+          </section>
+
+          <section>
+            <title>Value</title>
+
+            <para>None.</para>
+          </section>
+
+          <section>
+            <title>Elements</title>
+
+            <para>xi:include</para>
+          </section>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_project">Project element</title>
+
+        <para>There can be one <sgmltag class="element">project</sgmltag> per
+        top-level XML build file. A project can only be defined in a top-level
+        XML build file.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;project name="ReactOS" makefile="Makefile.auto" xmlns:xi="http://www.w3.org/2001/XInclude"&gt;
+  ...
+&lt;/project&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>name</term>
+
+                <listitem>
+                  <para>Name of the project.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>makefile</term>
+
+                <listitem>
+                  <para>Filename of the GNU makefile that is to be
+                  created.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_define">define</link>, <link
+          linkend="element_directory">directory</link>, <link
+          linkend="element_if">if</link>, <link
+          linkend="element_include">include</link>, <link
+          linkend="element_module">module</link>, <link
+          linkend="element_property">property</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_module">Module element</title>
+
+        <para>There can be zero or more <sgmltag
+        class="element">module</sgmltag>s per XML build file.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;module if="${MP}" ifnot="${MP}" name="msvcrt" type="win32dll" extension=".dll" entrypoint="_DllMain@12" baseaddress="0x70000000" mangledsymbols="true" installbase="system32" installname="msvcrt.dll" usewrc="false" warnings="true" aliasof="module1"&gt;
+  ...
+&lt;/module&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>if</term>
+
+                <listitem>
+                  <para>If the value is 1, then the module is enabled,
+                  otherwise it is disabled. A disabled module is not
+                  processed.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>ifnot</term>
+
+                <listitem>
+                  <para>If the value is 1, then the module is disabled,
+                  otherwise it is enabled. A disabled module is not
+                  processed.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>name</term>
+
+                <listitem>
+                  <para>Name of the module. Also the base name of the
+                  generated file if such file is generated for the particular
+                  module type.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>type</term>
+
+                <listitem>
+                  <para>Type of module. See below for an explanation of module
+                  types. <emphasis><emphasis>The module type determines the
+                  actions that is to be carried out to process the module. The
+                  defined module types are seen
+                  below:</emphasis></emphasis></para>
+
+                  <table>
+                    <title>Module Types</title>
+
+                    <tgroup cols="6">
+                      <thead>
+                        <row>
+                          <entry>Value</entry>
+
+                          <entry>Output name suffix</entry>
+
+                          <entry>Entrypoint</entry>
+
+                          <entry>Baseaddress</entry>
+
+                          <entry>Mangledsymbols</entry>
+
+                          <entry>Description</entry>
+                        </row>
+                      </thead>
+
+                      <tbody>
+                        <row>
+                          <entry>buildtool</entry>
+
+                          <entrytbl cols="2">
+                            <tbody>
+                              <row>
+                                <entry><filename>.exe</filename> (Windows)</entry>
+
+                                <entry>none (Linux)</entry>
+                              </row>
+                            </tbody>
+                          </entrytbl>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a tool that can be run (invoked) when
+                          building ReactOS.</entry>
+                        </row>
+
+                        <row>
+                          <entry>staticlibrary</entry>
+
+                          <entry><filename>.a</filename></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a static library containing object
+                          files that can be linked together with other
+                          modules.</entry>
+                        </row>
+
+                        <row>
+                          <entry>objectlibrary</entry>
+
+                          <entry><filename>.o</filename></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds object files that can be linked
+                          together with other modules.</entry>
+                        </row>
+
+                        <row>
+                          <entry>kernel</entry>
+
+                          <entry><filename>.exe</filename></entry>
+
+                          <entry><function>_NtProcessStartup</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds
+                          <filename>ntoskrnl.exe</filename>.</entry>
+                        </row>
+
+                        <row>
+                          <entry>kernelmodedll</entry>
+
+                          <entry><filename>.dll</filename></entry>
+
+                          <entry><function>_DriverEntry@8</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a kernel-mode DLL.</entry>
+                        </row>
+
+                        <row>
+                          <entry>kernelmodedriver</entry>
+
+                          <entry><filename>.sys</filename></entry>
+
+                          <entry><function>_DriverEntry@8</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a kernel-mode driver.</entry>
+                        </row>
+
+                        <row>
+                          <entry>nativedll</entry>
+
+                          <entry><filename>.dll</filename></entry>
+
+                          <entry><function>_DllMainCRTStartup@12</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a native DLL.</entry>
+                        </row>
+
+                        <row>
+                          <entry>win32dll</entry>
+
+                          <entry><filename>.dll</filename></entry>
+
+                          <entry><function>_DllMain@12</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a Win32 DLL.</entry>
+                        </row>
+
+                        <row>
+                          <entry>win32cui</entry>
+
+                          <entry><filename>.exe</filename></entry>
+
+                          <entry><function>_mainCRTStartup</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a Win32 console executable.</entry>
+                        </row>
+
+                        <row>
+                          <entry>win32gui</entry>
+
+                          <entry><filename>.exe</filename></entry>
+
+                          <entry><function>_WinMainCRTStartup</function></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a Win32 GUI executable.</entry>
+                        </row>
+
+                        <row>
+                          <entry>bootloader</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a bootloader.</entry>
+                        </row>
+
+                        <row>
+                          <entry>bootsector</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds one or more bootsector binaries. The
+                          entrypoint, baseaddress, and mangledsymbols module
+                          attributes are not applicable for this module
+                          type.</entry>
+                        </row>
+
+                        <row>
+                          <entry>iso</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-.</entry>
+
+                          <entry>Builds a bootable CD.</entry>
+                        </row>
+
+                        <row>
+                          <entry>test</entry>
+
+                          <entry>.exe</entry>
+
+                          <entry>_mainCRTStartup</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Builds a testsuite.</entry>
+                        </row>
+
+                        <row>
+                          <entry>rpcserver</entry>
+
+                          <entry><filename>.o</filename></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Generates and builds server code for an RPC
+                          interface.</entry>
+                        </row>
+
+                        <row>
+                          <entry>rpcclient</entry>
+
+                          <entry><filename>.o</filename></entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Generates and builds client code for an RPC
+                          interface.</entry>
+                        </row>
+
+                        <row>
+                          <entry>alias</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>-</entry>
+
+                          <entry>Module is an alias for another module. This
+                          module type is the only module type for which the
+                          aliasof attribute is applicable. Only the module
+                          install functionality is aliased.</entry>
+                        </row>
+                      </tbody>
+                    </tgroup>
+                  </table>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>extension</term>
+
+                <listitem>
+                  <para>Extension of the generated file if such file is
+                  generated for the particular module type.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>entrypoint</term>
+
+                <listitem>
+                  <para>Entrypoint symbol of the generated file if such file
+                  is generated for the particular module type.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>baseaddress</term>
+
+                <listitem>
+                  <para>Base address of the generated file if such file is
+                  generated for the particular module type.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>mangledsymbols</term>
+
+                <listitem>
+                  <para>Controls wether or not to pass --kill-at to dlltool.
+                  If this attribute has the value false then --kill-at is
+                  passed to dlltool. If the value is true, then --kill-at is
+                  not passed to dlltool. If the generated file exports C++
+                  classes then this need to be true.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>installbase</term>
+
+                <listitem>
+                  <para>Base directory of the generated file in the
+                  installation directory. This attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>installname</term>
+
+                <listitem>
+                  <para>Name of generated file in the installation directory.
+                  This attribute is optional, but if not specified, the
+                  generated file is not copied to the installation
+                  directory.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>usewrc</term>
+
+                <listitem>
+                  <para>Use WRC to compile resources if true. If false,
+                  windres is used. This attribute is optional. If not
+                  specified, WRC will be used.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>warnings</term>
+
+                <listitem>
+                  <para>Error out if false and at least one warning is emitted
+                  during building of this module. This attribute is optional.
+                  If not specified, it is assumed to be false.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>aliasof</term>
+
+                <listitem>
+                  <para>Name of module that is aliased.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_bootstrap">bootstrap</link>, <link
+          linkend="element_component">component</link>, <link
+          linkend="element_define">define</link>, <link
+          linkend="element_dependency">dependency</link>, <link
+          linkend="element_directory">directory</link>, <link
+          linkend="element_file">file</link>, <link
+          linkend="element_if">if</link>, <link
+          linkend="element_importlibrary">importlibrary</link>, <link
+          linkend="element_include">include</link>, <link
+          linkend="element_invoke">invoke</link>, <link
+          linkend="element_library">library</link>, <link
+          linkend="element_property">property</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_bootstrap">Bootstrap element</title>
+
+        <para>A bootstrap element specifies that the generated file should be
+        put on the bootable CD as a bootstrap file.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;bootstrap base="reactos" nameoncd="halmp.dll" /&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>base</term>
+
+                <listitem>
+                  <para> Put file in this directory on the bootable CD. This
+                  attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>nameoncd</term>
+
+                <listitem>
+                  <para> Name of file on the bootable CD. This attribute is
+                  optional.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_cdfile">CDFile element</title>
+
+        <para>A cdfile element specifies the name of a file that is to be put
+        on the bootable CD.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;cdfile base="reactos" nameoncd="ReadMe.txt"&gt;ReadMe.txt&lt;/cdfile&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>base</term>
+
+                <listitem>
+                  <para> Put file in this directory on the bootable CD. This
+                  attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>nameoncd</term>
+
+                <listitem>
+                  <para>Name of file on the bootable CD. This attribute is
+                  optional.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of file.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_component">Component element</title>
+
+        <para>A component element specifies that imports from a library are to
+        be stubbed so tests can be run without actually calling the functions
+        in the library. This element can only be used for modules of type
+        test.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;component name="ntdll.dll"&gt;
+  ...
+&lt;/component&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>name</term>
+
+                <listitem>
+                  <para>Name of library.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_symbol">symbol</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_symbol">Symbol element</title>
+
+        <para>A symbol element specifies an imported function from a library
+        that is to be stubbed so tests can be run without actually calling the
+        function in the library.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;symbol newname="RtlAllocateHeap"&gt;HeapAlloc@12&lt;/symbol&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>newname</term>
+
+                <listitem>
+                  <para>New name of symbol. This attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of symbol.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_define">Define element</title>
+
+        <para>A define element specifies the name and (optionally) value of a
+        define for the C/C++ compiler and resource compiler.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;define name="WINVER"&gt;0x501&lt;/define&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>name</term>
+
+                <listitem>
+                  <para> Name of define.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Value of define. The value is optional.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_dependency">Dependency element</title>
+
+        <para>A dependency element specifies the name of a module (usually of
+        type buildtool) that is to be processed before the current
+        module.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;dependency&gt;OtherModule&lt;/dependency&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of module.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_directory">Directory element</title>
+
+        <para>A directory element specifies the name of a subdirectory.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;directory name="<replaceable>MyDirectory</replaceable>"&gt;
+  ...
+&lt;/directory&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>name</term>
+
+                <listitem>
+                  <para>Name of directory.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_cdfile">cdfile</link>, <link
+          linkend="element_directory">directory</link>, <link
+          linkend="element_file">file</link>, <link
+          linkend="element_if">if</link>, <link
+          linkend="element_property">property</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_file">File element</title>
+
+        <para>A file element specifies the name of a file that is to be
+        processed.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;file&gt;<replaceable>MyFile.c</replaceable>&lt;/file&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of file.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_if">If element</title>
+
+        <para>An if element allows for conditional processing of other
+        elements.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;if property="DBG" value="1"&gt;
+  ...
+&lt;/if&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>property</term>
+
+                <listitem>
+                  <para>Name of the property that is to be evaluated.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>value</term>
+
+                <listitem>
+                  <para>Value to compare to the value of the property. If the
+                  property has the specified value, then the subelements are
+                  processed.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_compilerflag">compilerflag</link>,
+          <link linkend="element_define">define</link>, <link
+          linkend="element_directory">directory</link>, <link
+          linkend="element_file">file</link>, <link
+          linkend="element_if">if</link>, <link
+          linkend="element_include">include</link>, <link
+          linkend="element_property">property</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_importlibrary">Importlibrary element</title>
+
+        <para>An importlibrary element specifies that an import library should
+        be generated which other modules can use to link with the current
+        module.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;importlibrary definition="<replaceable>MyModule.def</replaceable>" /&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>definition</term>
+
+                <listitem>
+                  <para>Filename of definition file
+                  (<filename>.def</filename>) used to generate the import
+                  library. The filename is relative to the current
+                  module.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_include">Include element</title>
+
+        <para>An include element specifies an include directory for the C/C++
+        compiler and resource compiler.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;include base="<replaceable>MyLibraryModule</replaceable>"&gt;<replaceable>include</replaceable>&lt;/include&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>base</term>
+
+                <listitem>
+                  <para>Module or project which the value of this element is
+                  relative to. This attribute is optional. If left out, the
+                  include directory is relative to the position of the
+                  top-level xml build file.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Relative include directory.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_installfile">Installfile element</title>
+
+        <para>An installfile element specifies the name of a file that is to
+        be installed when using '<command>make install</command>'.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;installfile base="<replaceable>reactos</replaceable>" newname="<replaceable>ReadMe.txt</replaceable>"&gt;<replaceable>ReadMe.txt</replaceable>&lt;/installfile&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>base</term>
+
+                <listitem>
+                  <para>Put file in this directory within the install
+                  directory. This attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>newname</term>
+
+                <listitem>
+                  <para>Name of file within the install directory. This
+                  attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of file.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_invoke">Invoke element</title>
+
+        <para>An invoke element specifies the name of a module which is to be
+        executed before the current module is processed.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;invoke module="wmc"&gt;
+  &lt;input&gt;
+    &lt;inputfile&gt;ntoskrnl.mc&lt;/inputfile&gt;
+  &lt;/input&gt;
+  &lt;output&gt;
+    &lt;outputfile switches="-H"&gt;../include/reactos/bugcodes.h&lt;/outputfile&gt;
+    &lt;outputfile switches="-o"&gt;bugcodes.rc&lt;/outputfile&gt;
+  &lt;/output&gt;
+&lt;/invoke&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>module</term>
+
+                <listitem>
+                  <para>Name of the module to execute.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_input">input</link>, <link
+          linkend="element_output">output</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_input">Input element</title>
+
+        <para>An input element specifies a group of filenames that is to be
+        passed as parameters to a build tool. Input filename parameters are
+        located after output filename parameters on the command line.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;input&gt;
+  ...
+&lt;/input&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_inputfile">inputfile</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_inputfile">Inputfile element</title>
+
+        <para>An inputfile element specifies a filename that is to be passed
+        as a parameter to a build tool.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;inputfile&gt;<replaceable>ntoskrnl.mc</replaceable>&lt;/inputfile&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>switches</term>
+
+                <listitem>
+                  <para>Switches that is passed as parameters just before the
+                  filename. This attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of file that is to be passed as a parameter to the build
+          tool.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_output">Output element</title>
+
+        <para>An output element specifies a group of filenames that is to be
+        passed as parameters to a build tool. Output filename parameters are
+        located before input filename parameters on the command line.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;output&gt;
+  ...
+&lt;/output&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para><link linkend="element_outputfile">outputfile</link>.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_outputfile">Outputfile element</title>
+
+        <para>An outputfile element specifies a filename that is to be passed
+        as a parameter to a build tool.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;outputfile switches="<replaceable>-H</replaceable>"&gt;<replaceable>../include/reactos/bugcodes.h</replaceable>&lt;/outputfile&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>switches</term>
+
+                <listitem>
+                  <para>Switches that are passed as parameters just before the
+                  filename. This attribute is optional.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of file that is to be passed as a parameter to the build
+          tool.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title xreflabel="element_library">Library element</title>
+
+        <para>A library element specifies the name of another module which is
+        to be linked with the current module.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;library&gt;<replaceable>MyLibraryModule</replaceable>&lt;/library&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>Name of the module to link with.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+
+      <section>
+        <title>Property element</title>
+
+        <para>A property element specifies the name and value of a property
+        that can be used for conditional processing of the XML build
+        file.</para>
+
+        <section>
+          <title>Syntax</title>
+
+          <para><programlisting>&lt;property name="<replaceable>mypropertyname</replaceable>" value="<replaceable>mypropertyvalue</replaceable>" /&gt;</programlisting></para>
+        </section>
+
+        <section>
+          <title>Attributes</title>
+
+          <para><variablelist>
+              <varlistentry>
+                <term>name</term>
+
+                <listitem>
+                  <para>Name of property.</para>
+                </listitem>
+              </varlistentry>
+
+              <varlistentry>
+                <term>value</term>
+
+                <listitem>
+                  <para>Value of property.</para>
+                </listitem>
+              </varlistentry>
+            </variablelist></para>
+        </section>
+
+        <section>
+          <title>Value</title>
+
+          <para>None.</para>
+        </section>
+
+        <section>
+          <title>Elements</title>
+
+          <para>None.</para>
+        </section>
+      </section>
+    </section>
+
+    <bibliography>
+      <title>Bibliography</title>
+
+      <bibliomixed><title><ulink
+      url="http://www.w3.org/TR/2004/REC-xml-20040204/">Extensible Markup
+      Language (XML) 1.0 (Third Edition)</ulink></title><releaseinfo>W3C
+      Recommendation</releaseinfo><author>
+          <firstname>Fran&ccedil;ois</firstname>
+
+          <surname>Yergeau</surname>
+        </author><author>
+          <firstname>Tim</firstname>
+
+          <surname>Bray</surname>
+        </author><author>
+          <firstname>Jean</firstname>
+
+          <surname>Paoli</surname>
+        </author><author>
+          <firstname>C. M.</firstname>
+
+          <surname>Sperberg-McQueen</surname>
+        </author><author>
+          <firstname>Eve</firstname>
+
+          <surname>Maler</surname>
+        </author><date>4th February 2004</date></bibliomixed>
+
+      <bibliomixed><title><ulink
+      url="http://www.w3.org/TR/2004/REC-xinclude-20041220/">XML Inclusions
+      (XInclude) Version 1.0 </ulink></title><releaseinfo>W3C
+      Recommendation</releaseinfo><editor>
+          <firstname>Jonathan</firstname>
+
+          <surname>Marsh</surname>
+
+          <affiliation>
+            <orgname>Microsoft</orgname>
+          </affiliation>
+
+          <email>&lt;jmarsh@microsoft.com&gt;</email>
+        </editor><editor>
+          <firstname>David</firstname>
+
+          <surname>Orchard</surname>
+
+          <affiliation>
+            <orgname>BEA Systems</orgname>
+          </affiliation>
+
+          <email>&lt;dorchard@bea.com&gt;</email>
+        </editor>20 December 2004</bibliomixed>
+    </bibliography>
+  </chapter>
+</book>
\ No newline at end of file