Commands for NAnt:
===================

NAnt is a command line utility for .NET build. It reads the build.xml file to build the project, create exe and dll files.


Basic usage command and different options for NAnt are as under:
================================================================
Usage : NAnt [options] <target> <target> ...
Options :

  -t[argetframework]:<text>      Specifies the framework to target
  -defaultframework:<text>       Specifies the framework to target (Short format: /k)
  -buildfile:<text>              Use given buildfile (Short format: /f)
  -v[erbose][+|-]                Displays more information during build process
  -debug[+|-]                    Displays debug information during build process

  -q[uiet][+|-]                  Displays only error or warning messages during build process
  -e[macs][+|-]                  Produce logging information without adornments
  -find[+|-]                     Search parent directories for build file
  -indent:<number>               Indentation level of build output
  -D:<name>=<value>              Use value for given property
  -logger:<text>                 Use given type as logger
  -l[ogfile]:<filename>          Use value as name of log output file
  -listener:<text>               Add an instance of class as a project listener
  -ext[ension]:<text>            Load NAnt extensions from the specified assembly
  -projecthelp[+|-]              Prints project help information
  -nologo[+|-]                   Suppresses display of the logo banner
  -h[elp][+|-]                   Prints this message

A file ending in .build will be used if no buildfile is specified.


Some examples:
==============

nant clean => cleans the built project. In other words deletes exe and other files made by the build.

nant -logger:NAnt.Core.XmlLogger -l:log.xml => creates the xml log file. Other option is to send it through mail with inbuilt send mail utility.

Structure of small build file is as under:
==========================================

BUild file is an xml file which provides instruction / commands to NAnt what to do for the current project.


-----------------------------------------------------------------------------------------------------------

<?xml version="1.0"?>
<project name="Hello World" default="run">
    <property name="basename" value="HelloWorld"/>
    <property name="debug" value="true"/>

    <target name="clean">
        <delete>
            <fileset>
                <include name="${basename}-??.exe"/>
                <include name="${basename}-??.pdb"/>
            </fileset>
        </delete>
    </target>

    <target name="build">
        <csc target="exe" output="${basename}-cs.exe" debug="${debug}">
            <sources>
                <include name="${basename}.cs"/>
            </sources>
        </csc>
        
	<csc target="library" output="${basename}.dll" debug="${debug}">
            <sources>
                <include name="${basename}.cs"/>
            </sources>
        </csc>

	<jsc target="exe" output="${basename}-js.exe" debug="${debug}">
            <sources>
                <include name="${basename}.js"/>
            </sources>
        </jsc>
        <vbc target="exe" output="${basename}-vb.exe" debug="${debug}">
            <sources>
                <include name="${basename}.vb"/>
            </sources>
        </vbc>
    </target>

    <target name="run" depends="build">
        <exec program="${basename}-cs.exe" basedir="."/>
        <exec program="${basename}-js.exe" basedir="."/>
        <exec program="${basename}-vb.exe" basedir="."/>
    </target>
</project>

-----------------------------------------------------------------------------------------------------------


BUild file above creates exe file for the Visual Basic, C# and Jscript file present in the current directory.