There are basically two ways to get Quilt - and most other open source software. The first is CVS, which gives you access to last night's version of the code. The second is to download the latest release. This is more likely to work, but is less up to date; current plans are to put out incremental Quilt 0.6a releases at roughly 2 week intervals.
Quilt is being developed on systems running Linux and FreeBSD. If you are working under a Microsoft operating system, you may need to use some initiative to get the advice that follows to work. We will try to improve on this situation; please be patient.
Quilt is hosted on SourceForge. On Unix systems, you can get a copy of the most recent version of Quilt by typing:
cvs -d:pserver:firstname.lastname@example.org:/cvsroot/quilt checkout quilt-dev
This will deliver the very latest version to your desktop, creating a quilt-dev subdirectory in the current directory.
If you are using another operating system, or have trouble with the instructions above, try Sourceforge's CVS documentation ; this is lucid and reasonably easy to follow.
The alternative is downloading a tarball. This is very
simple indeed. You should see a
the top of this Web page; if you click on it, it will take
you to Quilt's Sourceforge download page. The most recent
tarballs will be listed towards the top. If you just want
to use Quilt, get the binary distribution, which will have
a name like
Javadocs are included with the binary distribution and built by the source distribution.
Click on whichever you prefer, and your browser will get it for you.
Once you have the tarball, put it in the directory where you want your Quilt subdirectory and type
tar -vzxf quilt*gz
and it will be extracted for you. (These instructions are of course suitable for Linux/Unix hosts; if you are using Windows, you need to adjust appropriately.)
Either of the procedures above will give you a distribution
in a subdirectory with a name like
This will create a Quilt jar in the
You can now actually use Quilt by copying the Quilt jar
directory and then moving into one
of the directories below hat. For example, the following
commands will copy the jar, take you into the
cp quilt*jar example cd example/3x6 ant test
Those with an interest in Quilt's inner workings are advised to get the software using CVS. There are currently several file changes a day.
Once you have the software, you should go into the base Quilt directory and run the tests.
cd quilt ant test
These should execute with no or very few errors. If you do see serious errors, it is likely that there are problems with the installation.
The most likely problems are classpath errors and missing jar files.