development-macros 1.2

JPlate development macros

Import Summary

Task Definition Summary

Macro Definition Summary

Macro Definition Details

compute-class-branch

Compute the class' branch information converting dots to OS file separator. By "branch" the meaning is to convey the branch in the CLASSPATH. The path representation of @{class-name} is stored in property @{property}

Attributes
@{class-name} = the fully qualified class name to convert.
@{property} = the property to store the class branch information.
@{description} = information about calling this macro.

Example
@{class-name} = com.foo.bar.Alpha

Result
@{property} = com/foo/bar/Alpha

compute-class-info

Compute information about a class - namely its parent dir and file name (less the .class).

Attributes
@{class-name} = the fully qualified name of a class for which the directory name and file name are sought.
@{dir-property} = the name of the property that will hold the directory of @{class-name}.
@{file-property} = the name of the property to store the file name of @{class-name}.
@{description} = information about calling this macro.

Example
@{class-name} = com.foo.bar.Alpha

Result
@{dir-property} = com/foo/bar
@{file-property} = Alpha

javacc

Defines a simpler javacc - acting similar to javacc. One does not need to specify each and every JavaCC file - simply provide a "root" or @{srcdir} location from which to start finding javacc files for invocation with the javacc task. The branch directory from @{destdir} is computed from @{srcdir} and the javacc files found.

Attributes
@{javacchome} = the location of javacc.
@{srcdir} = the directory from which to start searching for javacc files.
@{destdir} = the directory where javacc should generate - this is really the root directory from which javacc generation will be relative.
@{static} = static generation flag for javacc.
@{listfiles} = if set to true, information will be displayed as to which files are being javacc'd.
@{description} = information about calling this macro.

Example
@{srcdir} = /foo/bar
@{destdir} = /beta/theta
javacc file found at /foo/bar/alpha/zeta/SomeFile.jj

Result
javacc generation will occur to /beta/theta/alpha/zeta

release

This will create a release that will have a tar, zip, bzip and gzip files.

Attributes
@{dir} = the directory to create the release files.
@{stage-dir} = the staging directory where the created release files will be copied when completed.
@{base-file} = the base name of the tar, zip, bzip and gzip files.
@{base-dir} = Directory name where the release when unpacked will reside.
@{description} = information about calling this macro.

Elements
@{pre-processing} = will perform any pre-processing before the release is created.
@{pre-stage-processing} = will perform an pre-stage processing before copying files.
@{release-fileset} = should contain a fileset that will include all release files.
@{post-stage-processing} = will perform an post-stage processing before tar'ing/gzip/bzip/zip work.
@{post-processing} = will perform any post-processing after the release is created.

svn-xml-log

This will extract the log information from subversion to XML format.

Attributes
@{dir} = the directory in which to start gather log information
@{file} = the file that will contain the outputted XML.
@{rev-start} = the starting revision number.
@{rev-end} = the ending revision number.
@{description} = information about calling this macro.