Installing AntWeave

AntWeave can be downloaded from here and is supplied as a compressed tar file. The contents of the file are

Installing AntWeave is fairly simple, for example, assuming that your Java extension folder is [JAVA_EXT_DIR] (for example this would be /Library/Java/Extensions/ on Mac OS-X):

bramley:build hsfr$ ls -l total 792 -rw-r--r-- 1 hsfr 503 370711 31 Aug 12:31 AntWeave-1.0.tar bramley:build hsfr$ tar xvf AntWeave-1.0.tar x AntWeave.jar x antweave/addXRef.xsl x antweave/filters.xml x antweave/index.xsl x antweave/tangle.xsl x antweave/types.xml x antweave/weave.xsl x docs.pdf x README bramley:build hsfr$ ls -l total 1464 -rw-r--r-- 1 hsfr 503 370711 31 Aug 12:31 AntWeave-1.0.tar -rw-r--r-- 1 hsfr 503 31976 31 Aug 12:30 AntWeave.jar -rw-r--r-- 1 hsfr 503 2106 29 Aug 20:06 README drwxr-xr-x 8 hsfr 503 272 31 Aug 13:12 antweave -rw-r--r-- 1 hsfr 503 337389 30 Aug 18:52 docs.pdf bramley:build hsfr$ mv AntWeave.jar antweave [JAVA_EXT_DIR] bramley:build hsfr$

You may have to move the files with admin privileges; also remember to replace [JAVA_EXT_DIR] with your local Java extensions folder.

File Descriptions

Antweave.jar

This is the jar containing all the necessary driving code for implementing the Ant plugin.

antweave folder

Contains all the necessary transforms and filters used by the Java. Some can be overridden to change the action of the plugin.

addXRef.xsl

Provides a cross-referencing function. Must not be changed or overridden.

filters.xml,index.xsl,tangle.xsl,weave.xsl

These are the filters in the AntWeave pipeline and can be overridden to achieve new behaviour of the plugin.

types.xml

This is a list (in XML) of the built-in file types to define comments that are added to aid debugging.