rbuild.dbk

ReactOS是一些高手根据Windows XP的内核编写出的类XP。内核实现机理和API函数调用几乎相同。甚至可以兼容XP的程序。喜欢研究系统内核的人可以看一看。

        <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>Content</title>

          <para>None.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.directory">directory</link>, <link
          linkend="element.directory">if</link>, <link
          linkend="element.project">project</link>.</para>
        </section>

        <section>
          <title>Children</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.pch">pch</link>, <link
          linkend="element.property">property</link>.</para>
        </section>
      </section>

      <section id="element.file">
        <title>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>Content</title>

          <para>Name of file.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.directory">directory</link>, <link
          linkend="element.module">module</link>.</para>
        </section>

        <section>
          <title>Children</title>

          <para>None.</para>
        </section>
      </section>

      <section id="element.group">
        <title>Group element</title>

        <para>A group element's purpose is grouping subelements.</para>

        <section>
          <title>Syntax</title>

          <para><programlisting>&lt;group&gt;
  &lt;file&gt;<replaceable>i386-dis.c</replaceable>&lt;/file&gt;
  &lt;file&gt;<replaceable>kdb_help.S</replaceable>&lt;/file&gt;
  &lt;file&gt;<replaceable>longjmp.S</replaceable>&lt;/file&gt;
  &lt;file&gt;<replaceable>setjmp.S</replaceable>&lt;/file&gt;
&lt;/group&gt;</programlisting></para>
        </section>

        <section>
          <title>Attributes</title>

          <para>None.</para>
        </section>

        <section>
          <title>Content</title>

          <para>None.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.if">if</link>.</para>
        </section>

        <section>
          <title>Children</title>

          <para><link linkend="element.file">file</link>.</para>
        </section>
      </section>

      <section id="element.if">
        <title>If element</title>

        <para>An if element allows for conditional processing of other
        elements.</para>

        <section>
          <title>Syntax</title>

          <para><programlisting>&lt;if property="<replaceable>DBG</replaceable>" value="<replaceable>1</replaceable>"&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>Content</title>

          <para>None.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.project">project</link>, <link
          linkend="element.directory">directory</link>.</para>
        </section>

        <section>
          <title>Children</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 id="element.importlibrary">
        <title>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>Content</title>

          <para>None.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.module">module</link>.</para>
        </section>

        <section>
          <title>Children</title>

          <para>None.</para>
        </section>
      </section>

      <section id="element.include">
        <title>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>Content</title>

          <para>Relative include directory.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.project">project</link>, <link
          linkend="element.module">module</link>.</para>
        </section>

        <section>
          <title>Children</title>

          <para>None.</para>
        </section>
      </section>

      <section id="element.input">
        <title>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>Content</title>

          <para>None.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.invoke">invoke</link>.</para>
        </section>

        <section>
          <title>Children</title>

          <para><link linkend="element.inputfile">inputfile</link>.</para>
        </section>
      </section>

      <section id="element.inputfile">
        <title>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>Content</title>

          <para>Name of file that is to be passed as a parameter to the build
          tool.</para>
        </section>

        <section>
          <title>Parents</title>

          <para><link linkend="element.input">input</link>.</para>
        </section>

        <section>
          <title>Children</title>

          <para>None.</para>
        </section>
      </section>

      <section id="element.installfile">
        <title>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>Content</title>

          <para>Name of file.</para>
        </section>

        <section>
          <title>Children</title>

          <para>None.</para>
        </section>
      </section>

      <section id="element.invoke">
        <title>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="<replaceable>wmc</replaceable>"&gt;
  &lt;input&gt;
    &lt;inputfile&gt;<replaceable>ntoskrnl.mc</replaceable>&lt;/inputfile&gt;
  &lt;/input&gt;
  &lt;output&gt;
    &lt;outputfile switches="<replaceable>-H</replaceable>"&gt;<replaceable>../include/reactos/bugcodes.h</replaceable>&lt;/outputfile&gt;
    &lt;outputfile switches="<replaceable>-o</replaceable>"&gt;<replaceable>bugcodes.rc</replaceable>&lt;/outputfile&gt;
  &lt;/output&gt;
&lt;/invoke&gt;</programlisting></para>
        </section>

        <section>
          <title>Attributes</title>

          <para><variablelist>
              <varlistentry>
                <term>module</term>