diff --git a/src/excelant/java/org/apache/poi/ss/excelant/ExcelAntHandlerTask.java b/src/excelant/java/org/apache/poi/ss/excelant/ExcelAntHandlerTask.java index af210f63ef..eef50c7a92 100755 --- a/src/excelant/java/org/apache/poi/ss/excelant/ExcelAntHandlerTask.java +++ b/src/excelant/java/org/apache/poi/ss/excelant/ExcelAntHandlerTask.java @@ -24,6 +24,21 @@ import org.apache.tools.ant.Task; /** * This is the class that backs the tag in the Ant task. + *

+ * Its purpose is to provide a way to manipulate a workbook in the course + * of an ExcelAnt task. The idea being to model a way for test writers to + * simulate the behaviors of the workbook. + *

+ * Suppose, for example, you have a workbook that has a worksheet that + * reacts to values entered or selected by the user. It's possible in + * Excel to change other cells based on this but this isn't easily possible + * in POI. In ExcelAnt we handle this using the Handler, which is a Java + * class you write to manipulate the workbook. + *

+ * In order to use this tag you must write a class that implements the + * IExcelAntWorkbookHandler interface. After writing the + * class you should package it and it's dependencies into a jar file to + * add as library in your Ant build file. * * @author Jon Svede ( jon [at] loquatic [dot] com ) * @author Brian Bush ( brian [dot] bush [at] nrel [dot] gov ) diff --git a/src/excelant/resources/org/apache/poi/ss/excelant/antlib.xml b/src/excelant/resources/org/apache/poi/ss/excelant/antlib.xml index 31dadfaf60..af13cc649b 100755 --- a/src/excelant/resources/org/apache/poi/ss/excelant/antlib.xml +++ b/src/excelant/resources/org/apache/poi/ss/excelant/antlib.xml @@ -26,5 +26,6 @@ under the License. +