rbuild.txt

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

	<define name="WINVER">0x501</define>

Attributes:
	name - Name of define.

Value:
	Value of define. The value is optional.

Elements:
	None.


Dependency element
------------------
A dependency element specifies the name of a module (usually of type buildtool) that is to be processed before the current module.

Syntax:
	<dependency>OtherModule</dependency>

Attributes:
	None.

Value:
	Name of module.

Elements:
	None.


Directory element
-----------------
A directory element specifies the name of a subdirectory.

Syntax:
	<directory name="MyDirectory">
		...
	</directory>

Attributes:
	name - Name of directory.

Value:
	None.

Elements:
	cdfile, directory, file, if, property.


File element
------------
A file element specifies the name of a file that is to be processed.

Syntax:
	<file>MyFile.c</file>

Attributes:
	None.

Value:
	Name of file.

Elements:
	None.


If element
----------
An if element allows for conditional processing of other elements.

Syntax:
	<if property="DBG" value="1">
		...
	</if>

Attributes:
	property - Name of the property that is to be evaluated.
	value - Value to compare to the value of the property. If the property has the specified value, then the subelements are processed.

Value:
	None.

Elements:
	compilationunit, compilerflag, define, directory, file, if, include, property.


Importlibrary element
---------------------
An importlibrary element specifies that an import library should be generated which other modules can use to link with the current module.

Syntax:
	<importlibrary definition="MyModule.def" />

Attributes:
	definition - Filename of definition file (.def) used to generate the import library. The filename is relative to the current module.

Value:
	None.

Elements:
	None.


Include element
---------------
An include element specifies an include directory for the C/C++ compiler and resource compiler.

Syntax:
	<include base="MyLibraryModule">include</include>

Attributes:
	base - 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.

Value:
	Relative include directory.

Elements:
	None.


Installfile element
-------------------
An installfile element specifies the name of a file that is to be installed when using 'make install'.

Syntax:
	<installfile base="reactos" newname="ReadMe.txt">ReadMe.txt</installfile>

Attributes:
	base - Put file in this directory within the install directory. This attribute is optional.
	newname - Name of file within the install directory. This attribute is optional.

Value:
	Name of file.

Elements:
	None.


Invoke element
--------------
An invoke element specifies the name of a module which is to be executed before the current module is processed.

Syntax:
	<invoke module="wmc">
		<input>
			<inputfile>ntoskrnl.mc</inputfile>
		</input>
		<output>
			<outputfile switches="-H">../include/reactos/bugcodes.h</outputfile>
			<outputfile switches="-o">bugcodes.rc</outputfile>
		</output>
	</invoke>

Attributes:
	None.

Value:
	Name of the module to execute.

Elements:
	input, output.


Input element
-------------
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. 

Attributes:
	None.

Value:
	None.

Elements:
	inputfile.


Inputfile element
-----------------
An inputfile element specifies a filename that is to be passed as a parameter to a build tool.

Attributes:
	switches - Switches that is passed as parameters just before the filename. This attribute is optional.

Value:
	Name of file that is to be passed as a parameter to the build tool.

Elements:
	None.


Output element
--------------
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. 

Attributes:
	None.

Value:
	None.

Elements:
	outputfile.


Outputfile element
------------------
An outputfile element specifies a filename that is to be passed as a parameter to a build tool.

Attributes:
	switches - Switches that is passed as parameters just before the filename. This attribute is optional.

Value:
	Name of file that is to be passed as a parameter to the build tool.

Elements:
	None.


Library
-------
An importlibrary element specifies the name of another module which is to be linked with the current module.

Syntax:
	<library>MyLibraryModule</library>

Attributes:
	None.

Value:
	Name of the module to link with.

Elements:
	None.


Linkerscript
------------
A linkerscript element specifies the filename of a binutils linker script.

Syntax:
	<linkerscript base="mymodule">MyLinkerScript</linkerscript>

Attributes:
	base - Module which the value of this element is relative to. This attribute is optional. If left out, the linker script is relative to the position of the top-level xml build file.

Value:
	Relative linker script filename.

Elements:
	None.


Property
--------
A property element specifies the name and value of a property that can be used for conditional processing of the xml build file.

Syntax:
	<property name="mypropertyname" value="mypropertyvalue" />

Attributes:
	name - Name of property.
	value - Value of property.

Value:
	None.

Elements:
	None.