|NAnt Help Fundamentals Running NAnt||v0.91-beta1|
[This is preliminary documentation and subject to change.]
Running NAnt is simple once you have it
installed, just type
NAnt -help to get usage information.
When nothing is specified, NAnt looks for a file ending with
NAnt.build, in the current directory. If found, it
uses that file as the build file. If more than one file is found you need
to specify the build file using the
-buildfile option (see below).
If you use the
-find option, NAnt will search for a build file in
the parent directory, and so on, until the root of the file system has been
reached. To make NAnt use another build file, use the command-line option
-buildfile:file, where file is the build file you want to
You can specify one or more targets that should be executed. When omitted, the
target that is specified in the
default attribute of the
tag is used.
-projecthelp option prints out the description of the project,
if it exists, followed by a list of the project's targets. First those with a
description, then those without one.
To override properties specified in the build file use the
-D:property=value option, where property is the
name of the property, and value is the value for that property.
Runs NAnt using the file ending in
*.build.xml file in the
current directory, on the default target.
Runs NAnt using the
ProjectName.build file in the parent
directory, on the default target.
Runs NAnt using the default build file in the current directory, on a target
NAnt -D:debug=false clean dist
Runs NAnt using the default build file in the current directory, first on
clean target and then on the
while setting the
debug property to
could, for example, make a release distribution from scratch.