Generated by:
Craftsman

Obtaining Craftsman Bootstrap


The Craftsman Bootstrap is a module that takes care of finding your local Craftsman installation and loading its libraries into the Ant runtime. If the bootstrap cannot find a Craftsman installation, it prompts you to specify its location. If there is no local installation, it then asks you if you would like to download Craftsman and to where.

The bootstrap's main purpose is to make using Craftsman as easy as possible for developers. If you include the bootstrap in your source distribution, it allows other developers to use your Craftsman build without any configuration headaches (since if they do not have Craftsman, it will help them download and install it to any local directory they want).

Obtaining Craftsman Bootstrap

You can obtain the latest version of the Craftsman bootstrap at:

http://craftsman.redstarhackers.com/Bootstrap/

Obtaining a bootstrap.xml file for your Craftsman build.

The bootstrap.xml file is the standard way of telling your build how to get at the bootstrap, which will then initialize your build system. You can download a typical example here:

http://craftsman.redstarhackers.com/Bootstrap/bootstrap.xml

Just change the project name and th3e "lib.bootstrap.dir" property to the appropriate cvalues for your setup. For example:

<project name="CHANGE-ME-bootstrap">

    <!-- change the value to where you have put the bootstrap and its libs -->
    <property name="lib.bootstrap.dir" value="CHANGE-ME/lib/bootstrap"/>

    ...
</project>
If your project is "foobar", change the name to "foobar-bootstrap". If your lib directory is in your module/project directory, change "CHANGE-ME/lib/bootstrap" to "lib/bootstrap". If you have your bootstrap in a lib directory above your module directory (that is, in a parent directory, change it to "../lib/bootstrap".

If you don't get the lib directory setting right, Ant will complain very obviously about it missing. Just change it to the correct value.

Special Note: Craftsman vs. Craftsman Bootstrap

Craftsman, the build system, and Craftsman Bootstrap are two separate entities. In the end, the bootstrap manages the Craftsman build system. As such, they have totally separate libraries and installation directories.

NEVER place Craftsman in the same directory as the bootstrap.