rbuild.dbk

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

              </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>allowwarnings</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>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.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.linkerflag">linkerflag</link>, <link
          linkend="element.property">property</link>.</para>
        </section>
      </section>

      <section id="element.output">
        <title>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>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.outputfile">outputfile</link>.</para>
        </section>
      </section>

      <section id="element.outputfile">
        <title>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>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.output">output</link>.</para>
        </section>

        <section>
          <title>Children</title>

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

      <section id="element.pch">
        <title>Pch element</title>

        <para>A pch element specifies a GCC precompiled header file.</para>

        <section>
          <title>Syntax</title>

          <para><programlisting>&lt;pch&gt;<replaceable>ntdll.h</replaceable>&lt;/pch&gt;</programlisting></para>
        </section>

        <section>
          <title>Attributes</title>

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

        <section>
          <title>Content</title>

          <para>Name of the include file to be precompiled.</para>
        </section>

        <section>
          <title>Parents</title>

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

        <section>
          <title>Children</title>

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

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

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

        <section>
          <title>Parents</title>

          <para>None. This is the top-level (root) element of
          <filename>ReactOS.rbuild</filename> file.</para>
        </section>

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

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

        <section>
          <title>Parents</title>

          <para></para>
        </section>

        <section>
          <title>Children</title>

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

      <section id="element.symbol">
        <title>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="<replaceable>RtlAllocateHeap</replaceable>"&gt;<replaceable>HeapAlloc@12</replaceable>&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>Content</title>

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

        <section>
          <title>Children</title>

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

  <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>[e-mail]</email>
      </editor><editor>
        <firstname>David</firstname>

        <surname>Orchard</surname>

        <affiliation>
          <orgname>BEA Systems</orgname>
        </affiliation>

        <email>[e-mail]</email>
      </editor>20 December 2004</bibliomixed>
  </bibliography>
</book>