diff options
| author | Darin Swanson | 2003-04-28 20:37:42 +0000 |
|---|---|---|
| committer | Darin Swanson | 2003-04-28 20:37:42 +0000 |
| commit | fef0514a620261a887f98d1244a517cbd4fee8d2 (patch) | |
| tree | 21ff78493cb7d3fba6d2a4de3ccef0b5c8a5d58c | |
| parent | 27a92397ead817c5fdb1054b855f4c39f77fdf8e (diff) | |
| download | eclipse.platform.debug-fef0514a620261a887f98d1244a517cbd4fee8d2.tar.gz eclipse.platform.debug-fef0514a620261a887f98d1244a517cbd4fee8d2.tar.xz eclipse.platform.debug-fef0514a620261a887f98d1244a517cbd4fee8d2.zip | |
Bug 36870 - Separate the Ant UI from the ExternalToolsUI
180 files changed, 5 insertions, 78333 deletions
diff --git a/org.eclipse.ui.externaltools/.classpath b/org.eclipse.ui.externaltools/.classpath index f7b4768f2..c10abc845 100644 --- a/org.eclipse.ui.externaltools/.classpath +++ b/org.eclipse.ui.externaltools/.classpath @@ -1,10 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?>
<classpath>
- <classpathentry kind="src" path="Ant Runner Support/"/>
<classpathentry kind="src" path="External Tools Base/"/>
<classpathentry kind="src" path="Program Tools Support/"/>
- <classpathentry kind="src" path="Ant Tools Support/"/>
- <classpathentry kind="src" path="Ant Editor"/>
<classpathentry kind="src" path="/org.apache.ant"/>
<classpathentry kind="src" path="/org.apache.xerces"/>
<classpathentry kind="src" path="/org.eclipse.ant.core"/>
diff --git a/org.eclipse.ui.externaltools/Ant Editor/XDOCtasks.xml b/org.eclipse.ui.externaltools/Ant Editor/XDOCtasks.xml deleted file mode 100644 index b82075ecc..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/XDOCtasks.xml +++ /dev/null @@ -1,18688 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<tasks> -<task name="ant" category="control" - classname="org.apache.tools.ant.taskdefs.Ant" - > - - <short-description><![CDATA[Build a sub-project.]]></short-description> - <description> - <![CDATA[Build a sub-project. - - <pre> - <target name="foo" depends="init"> - <ant antfile="build.xml" target="bar" > - <property name="property1" value="aaaaa" /> - <property name="foo" value="baz" /> - </ant></SPAN> - </target></SPAN> - - <target name="bar" depends="init"> - <echo message="prop is ${property1} ${foo}" /> - </target> - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="antfile" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The buildfile to use.]]></short-description> - <description><![CDATA[ - The buildfile to use. - Defaults to "build.xml". This file is expected to be a filename relative - to the dir attribute given. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to use as a base directory for the new Ant project.]]></short-description> - <description><![CDATA[ - The directory to use as a base directory for the new Ant project. - Defaults to the current project's basedir, unless inheritall - has been set to false, in which case it doesn't have a default - value. This will override the basedir setting of the called project. - ]]></description> - </attribute> - <attribute name="inheritall" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, pass all properties to the new Ant project.]]></short-description> - <description><![CDATA[ - If true, pass all properties to the new Ant project. - Defaults to true. - ]]></description> - </attribute> - <attribute name="inheritrefs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, pass all references to the new Ant project.]]></short-description> - <description><![CDATA[ - If true, pass all references to the new Ant project. - Defaults to false. - ]]></description> - </attribute> - <attribute name="output" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Filename to write the output to.]]></short-description> - <description><![CDATA[ - Filename to write the output to. - This is relative to the value of the dir attribute - if it has been set or to the base directory of the - current project otherwise. - ]]></description> - </attribute> - <attribute name="target" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The target of the new Ant project to execute.]]></short-description> - <description><![CDATA[ - The target of the new Ant project to execute. - Defaults to the new project's default target. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="reference" type="org.apache.tools.ant.taskdefs.Ant.Reference" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Reference element identifying a data type to carry - over to the new project.]]></short-description> - <description> - <![CDATA[Reference element identifying a data type to carry - over to the new project.]]> - </description> - </element> - - <element name="property" type="org.apache.tools.ant.taskdefs.Property" - briefType="see <property>" - required="NOTDEFINED"> - <short-description><![CDATA[Property to pass to the new project.]]></short-description> - <description> - <![CDATA[Property to pass to the new project. - The property is passed as a 'user property']]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="antcall" category="control" - classname="org.apache.tools.ant.taskdefs.CallTarget" - > - - <short-description><![CDATA[Call another target in the same project.]]></short-description> - <description> - <![CDATA[Call another target in the same project. - - <pre> - <target name="foo"> - <antcall target="bar"> - <param name="property1" value="aaaaa" /> - <param name="foo" value="baz" /> - </antcall> - </target> - - <target name="bar" depends="init"> - <echo message="prop is ${property1} ${foo}" /> - </target> - </pre> - - <p>This only works as expected if neither property1 nor foo are - defined in the project itself.]]> - </description> - - <structure> - - <attributes> - <attribute name="inheritall" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, pass all properties to the new Ant project.]]></short-description> - <description><![CDATA[ - If true, pass all properties to the new Ant project. - Defaults to true. - ]]></description> - </attribute> - <attribute name="inheritrefs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, pass all references to the new Ant project.]]></short-description> - <description><![CDATA[ - If true, pass all references to the new Ant project. - Defaults to false - ]]></description> - </attribute> - <attribute name="target" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Target to execute, required.]]></short-description> - <description><![CDATA[ - Target to execute, required. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="reference" type="org.apache.tools.ant.taskdefs.Ant.Reference" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Reference element identifying a data type to carry - over to the invoked target.]]></short-description> - <description> - <![CDATA[Reference element identifying a data type to carry - over to the invoked target.]]> - </description> - </element> - - <element name="param" type="org.apache.tools.ant.taskdefs.Property" - briefType="see <property>" - required="NOTDEFINED"> - <short-description><![CDATA[Property to pass to the invoked target.]]></short-description> - <description> - <![CDATA[Property to pass to the invoked target.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="antlr" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ANTLR" - > - - <short-description><![CDATA[Invokes the ANTLR Translator generator on a grammar file.]]></short-description> - <description> - <![CDATA[Invokes the ANTLR Translator generator on a grammar file.]]> - </description> - - <structure> - - <attributes> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to enable ParseView debugging.]]></short-description> - <description><![CDATA[ - Sets a flag to enable ParseView debugging - ]]></description> - </attribute> - <attribute name="diagnostic" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to emit diagnostic text.]]></short-description> - <description><![CDATA[ - Sets a flag to emit diagnostic text - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The working directory of the process.]]></short-description> - <description><![CDATA[ - The working directory of the process - ]]></description> - </attribute> - <attribute name="glib" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets an optional super grammar file.]]></short-description> - <description><![CDATA[ - Sets an optional super grammar file. - ]]></description> - </attribute> - <attribute name="html" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, emit html.]]></short-description> - <description><![CDATA[ - If true, emit html - ]]></description> - </attribute> - <attribute name="outputdirectory" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to write the generated files to.]]></short-description> - <description><![CDATA[ - The directory to write the generated files to. - ]]></description> - </attribute> - <attribute name="target" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The grammar file to process.]]></short-description> - <description><![CDATA[ - The grammar file to process. - ]]></description> - </attribute> - <attribute name="trace" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables all tracing.]]></short-description> - <description><![CDATA[ - If true, enables all tracing. - ]]></description> - </attribute> - <attribute name="tracelexer" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables lexer tracing.]]></short-description> - <description><![CDATA[ - If true, enables lexer tracing. - ]]></description> - </attribute> - <attribute name="traceparser" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables parser tracing.]]></short-description> - <description><![CDATA[ - If true, enables parser tracing. - ]]></description> - </attribute> - <attribute name="tracetreewalker" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to allow the user to enable tree walker tracing.]]></short-description> - <description><![CDATA[ - Sets a flag to allow the user to enable tree walker tracing - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a classpath to be set - because a directory might be given for Antlr debug.]]></short-description> - <description> - <![CDATA[Adds a classpath to be set - because a directory might be given for Antlr debug.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a new JVM argument.]]></short-description> - <description> - <![CDATA[Adds a new JVM argument.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="antstructure" category="xml" - classname="org.apache.tools.ant.taskdefs.AntStructure" - > - - <short-description><![CDATA[Creates a partial DTD for Ant from the currently known tasks.]]></short-description> - <description> - <![CDATA[Creates a partial DTD for Ant from the currently known tasks.]]> - </description> - - <structure> - - <attributes> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The output file.]]></short-description> - <description><![CDATA[ - The output file. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="apply" category="control" - classname="org.apache.tools.ant.taskdefs.ExecuteOn" - > - - <short-description><![CDATA[Executes a given command, supplying a set of files as arguments.]]></short-description> - <description> - <![CDATA[Executes a given command, supplying a set of files as arguments.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether output should be appended to or overwrite an existing file.]]></short-description> - <description><![CDATA[ - Whether output should be appended to or overwrite an existing file. - Defaults to false. - ]]></description> - </attribute> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory where target files are to be placed.]]></short-description> - <description><![CDATA[ - The directory where target files are to be placed. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The working directory of the process.]]></short-description> - <description><![CDATA[ - The working directory of the process. - ]]></description> - </attribute> - <attribute name="executable" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The command to execute.]]></short-description> - <description><![CDATA[ - The command to execute. - ]]></description> - </attribute> - <attribute name="failifexecutionfails" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Stop the build if program cannot be started.]]></short-description> - <description><![CDATA[ - Stop the build if program cannot be started. Defaults to true. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Fail if the command exits with a non-zero return code.]]></short-description> - <description><![CDATA[ - Fail if the command exits with a non-zero return code. - ]]></description> - </attribute> - <attribute name="newenvironment" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Do not propagate old environment when new environment variables are specified.]]></short-description> - <description><![CDATA[ - Do not propagate old environment when new environment variables are specified. - ]]></description> - </attribute> - <attribute name="os" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[List of operating systems on which the command may be executed.]]></short-description> - <description><![CDATA[ - List of operating systems on which the command may be executed. - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File the output of the process is redirected to.]]></short-description> - <description><![CDATA[ - File the output of the process is redirected to. - ]]></description> - </attribute> - <attribute name="outputproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property name whose value should be set to the output of - the process.]]></short-description> - <description><![CDATA[ - Property name whose value should be set to the output of - the process. - ]]></description> - </attribute> - <attribute name="parallel" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, run the command only once, appending all files as arguments.]]></short-description> - <description><![CDATA[ - If true, run the command only once, appending all files as arguments. - If false, command will be executed once for every file. Defaults to false. - ]]></description> - </attribute> - <attribute name="relative" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the filenames should be passed on the command line as - absolute or relative pathnames.]]></short-description> - <description><![CDATA[ - Whether the filenames should be passed on the command line as - absolute or relative pathnames. Paths are relative to the base - directory of the corresponding fileset for source files or the - dest attribute for target files. - ]]></description> - </attribute> - <attribute name="resultproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of a property in which the return code of the - command should be stored.]]></short-description> - <description><![CDATA[ - The name of a property in which the return code of the - command should be stored. Only of interest if failonerror=false. - ]]></description> - </attribute> - <attribute name="skipemptyfilesets" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If no source files have been found or are newer than their - corresponding target files, do not run the command.]]></short-description> - <description><![CDATA[ - If no source files have been found or are newer than their - corresponding target files, do not run the command. - ]]></description> - </attribute> - <attribute name="type" type="org.apache.tools.ant.taskdefs.ExecuteOn.FileDirBoth" - briefType=""file", "dir", "both"" required="NOTDEFINED"> - <short-description><![CDATA[Whether the command works only on files, directories or both?.]]></short-description> - <description><![CDATA[ - Whether the command works only on files, directories or both? - ]]></description> - </attribute> - <attribute name="vmlauncher" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, launch new process with VM, otherwise use the OS's shell.]]></short-description> - <description><![CDATA[ - If true, launch new process with VM, otherwise use the OS's shell. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an environment variable to the launched process.]]></short-description> - <description> - <![CDATA[Add an environment variable to the launched process.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Source files to operate upon.]]></short-description> - <description> - <![CDATA[Source files to operate upon.]]> - </description> - </element> - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a command-line argument.]]></short-description> - <description> - <![CDATA[Adds a command-line argument.]]> - </description> - </element> - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" - briefType="Mapper" - required="NOTDEFINED"> - <short-description><![CDATA[Mapper to use for mapping source files to target files.]]></short-description> - <description> - <![CDATA[Mapper to use for mapping source files to target files.]]> - </description> - </element> - - <element name="srcfile" type="org.apache.tools.ant.types.Commandline.Marker" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Marker that indicates where the name of the source file should - be put on the command line.]]></short-description> - <description> - <![CDATA[Marker that indicates where the name of the source file should - be put on the command line.]]> - </description> - </element> - - <element name="targetfile" type="org.apache.tools.ant.types.Commandline.Marker" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Marker that indicates where the name of the target file should - be put on the command line.]]></short-description> - <description> - <![CDATA[Marker that indicates where the name of the target file should - be put on the command line.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="available" category="control" - classname="org.apache.tools.ant.taskdefs.Available" - > - - <short-description><![CDATA[Will set the given property if the requested resource is available at runtime.]]></short-description> - <description> - <![CDATA[Will set the given property if the requested resource is available at - runtime. This task may also be used as a condition by the condition task.]]> - </description> - - <structure> - - <attributes> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Classname of a class which must be available to set the given - property.]]></short-description> - <description><![CDATA[ - Set a classname of a class which must be available to set the given - property. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when searching for classes and resources.]]></short-description> - <description><![CDATA[ - Set the classpath to be used when searching for classes and resources. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Classpath by reference.]]></short-description> - <description><![CDATA[ - Set the classpath by reference. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File which must be present in the file system to set the given - property.]]></short-description> - <description><![CDATA[ - Set the file which must be present in the file system to set the given - property. - ]]></description> - </attribute> - <attribute name="filepath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Path to use when looking for a file.]]></short-description> - <description><![CDATA[ - Set the path to use when looking for a file. - ]]></description> - </attribute> - <attribute name="ignoresystemclasses" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether the search for classes should ignore the runtime classes and - just use the given classpath.]]></short-description> - <description><![CDATA[ - Set whether the search for classes should ignore the runtime classes and - just use the given classpath. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property which will be set if the particular resource - is available.]]></short-description> - <description><![CDATA[ - Set the name of the property which will be set if the particular resource - is available. - ]]></description> - </attribute> - <attribute name="resource" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of a Java resource which is required to set the property.]]></short-description> - <description><![CDATA[ - Set the name of a Java resource which is required to set the property. - ]]></description> - </attribute> - <attribute name="type" type="org.apache.tools.ant.taskdefs.Available.FileDir" - briefType=""file", "dir"" required="NOTDEFINED"> - <short-description><![CDATA[Set what type of file is required - either directory or file.]]></short-description> - <description><![CDATA[ - Set what type of file is required - either directory or file. - ]]></description> - </attribute> - <attribute name="value" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Value to be given to the property if the desired resource is - available.]]></short-description> - <description><![CDATA[ - Set the value to be given to the property if the desired resource is - available. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when searching for classes and resources.]]></short-description> - <description> - <![CDATA[Classpath to be used when searching for classes and resources.]]> - </description> - </element> - - <element name="filepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Path to search for file resources.]]></short-description> - <description> - <![CDATA[Path to search for file resources.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="basename" category="property" - classname="org.apache.tools.ant.taskdefs.Basename" - > - - <short-description><![CDATA[Sets a property to the base name of a specified file, optionally minus a suffix.]]></short-description> - <description> - <![CDATA[Sets a property to the base name of a specified file, optionally minus a - suffix. - - This task can accept the following attributes: - <ul> - <li>file - <li>property - <li>suffix - </ul> - The <b>file</b> and <b>property</b> attributes are required. The - <b>suffix</b> attribute can be specified either with or without - the ".", and the result will be the same (ie., the - returned file name will be minus the .suffix). - <p> - When this task executes, it will set the specified property to the - value of the last element in the specified file. If file is a - directory, the basename will be the last directory element. If file - is a full-path filename, the basename will be the simple file name. - If a suffix is specified, and the specified file ends in that suffix, - the basename will be the simple file name without the suffix.]]> - </description> - - <structure> - - <attributes> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File or directory to get base name from.]]></short-description> - <description><![CDATA[ - File or directory to get base name from. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property to set base name to.]]></short-description> - <description><![CDATA[ - Property to set base name to. - ]]></description> - </attribute> - <attribute name="suffix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Optional suffix to remove from base name.]]></short-description> - <description><![CDATA[ - Optional suffix to remove from base name. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="blgenclient" category="ejb" - classname="org.apache.tools.ant.taskdefs.optional.ejb.BorlandGenerateClient" - > - - <short-description><![CDATA[Generates a Borland Application Server 4.5 client JAR using as input the EJB JAR file.]]></short-description> - <description> - <![CDATA[Generates a Borland Application Server 4.5 client JAR using as - input the EJB JAR file. - - Two mode are available: java mode (default) and fork mode. With the fork mode, - it is impossible to add classpath to the commmand line.]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Path to use for classpath.]]></short-description> - <description><![CDATA[ - Path to use for classpath. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Reference to existing path, to use as a classpath.]]></short-description> - <description><![CDATA[ - Reference to existing path, to use as a classpath. - ]]></description> - </attribute> - <attribute name="clientjar" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Client JAR file name.]]></short-description> - <description><![CDATA[ - Client JAR file name. - ]]></description> - </attribute> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, turn on the debug mode for each of the Borland tools launched.]]></short-description> - <description><![CDATA[ - If true, turn on the debug mode for each of the Borland tools launched. - ]]></description> - </attribute> - <attribute name="ejbjar" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[EJB JAR file.]]></short-description> - <description><![CDATA[ - EJB JAR file. - ]]></description> - </attribute> - <attribute name="mode" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Command launching mode: java or fork.]]></short-description> - <description><![CDATA[ - Command launching mode: java or fork. - ]]></description> - </attribute> - <attribute name="version" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds path to the classpath.]]></short-description> - <description> - <![CDATA[Adds path to the classpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="buildnumber" category="other" - classname="org.apache.tools.ant.taskdefs.BuildNumber" - > - - <short-description><![CDATA[Read, increment, and write a build number in a file It will first attempt to read a build number from a file, then set the property "build.number" to the value that was read in (or 0 if no such value).]]></short-description> - <description> - <![CDATA[Read, increment, and write a build number in a file - It will first - attempt to read a build number from a file, then set the property - "build.number" to the value that was read in (or 0 if no such value). Then - it will increment the build number by one and write it back out into the - file.]]> - </description> - - <structure> - - <attributes> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file in which the build number is stored.]]></short-description> - <description><![CDATA[ - The file in which the build number is stored. Defaults to - "build.number" if not specified. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="bunzip2" category="packaging" - classname="org.apache.tools.ant.taskdefs.BUnzip2" - > - - <short-description><![CDATA[Expands a file that has been compressed with the BZIP2 algorithm.]]></short-description> - <description> - <![CDATA[Expands a file that has been compressed with the BZIP2 - algorithm. Normally used to compress non-compressed archives such - as TAR files.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The destination file or directory; optional.]]></short-description> - <description><![CDATA[ - The destination file or directory; optional. - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to expand; required.]]></short-description> - <description><![CDATA[ - The file to expand; required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="bzip2" category="packaging" - classname="org.apache.tools.ant.taskdefs.BZip2" - > - - <short-description><![CDATA[Compresses a file with the BZIP2 algorithm.]]></short-description> - <description> - <![CDATA[Compresses a file with the BZIP2 algorithm. Normally used to compress - non-compressed archives such as TAR files.]]> - </description> - - <structure> - - <attributes> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to compress; required.]]></short-description> - <description><![CDATA[ - the file to compress; required. - ]]></description> - </attribute> - <attribute name="zipfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The required destination file.]]></short-description> - <description><![CDATA[ - the required destination file. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="cab" category="other" - classname="org.apache.tools.ant.taskdefs.optional.Cab" - matchingTask="true"> - - <short-description><![CDATA[Create a CAB archive.]]></short-description> - <description> - <![CDATA[Create a CAB archive.]]> - </description> - - <structure> - - <attributes> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Base directory to look in for files to CAB.]]></short-description> - <description><![CDATA[ - Base directory to look in for files to CAB. - ]]></description> - </attribute> - <attribute name="cabfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The name/location of where to create the .cab file.]]></short-description> - <description><![CDATA[ - The name/location of where to create the .cab file. - ]]></description> - </attribute> - <attribute name="compress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, compress the files otherwise only store them.]]></short-description> - <description><![CDATA[ - If true, compress the files otherwise only store them. - ]]></description> - </attribute> - <attribute name="options" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets additional cabarc options that are not supported directly.]]></short-description> - <description><![CDATA[ - Sets additional cabarc options that are not supported directly. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, display cabarc output.]]></short-description> - <description><![CDATA[ - If true, display cabarc output. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files to archive.]]></short-description> - <description> - <![CDATA[Adds a set of files to archive.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="cccheckin" category="other" - classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCCheckin" - > - - <short-description><![CDATA[Performs ClearCase checkin.]]></short-description> - <description> - <![CDATA[Performs ClearCase checkin. - - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>comment</td> - <td>Specify a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - <tr> - <td>commentfile</td> - <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - <tr> - <td>nowarn</td> - <td>Suppress warning messages</td> - <td>No</td> - <tr> - <tr> - <td>preservetime</td> - <td>Preserve the modification time</td> - <td>No</td> - <tr> - <tr> - <td>keepcopy</td> - <td>Keeps a copy of the file with a .keep extension</td> - <td>No</td> - <tr> - <tr> - <td>identical</td> - <td>Allows the file to be checked in even if it is identical to the original</td> - <td>No</td> - <tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="cleartooldir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the cleartool executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the cleartool executable is located. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment string.]]></short-description> - <description><![CDATA[ - Sets the comment string. - ]]></description> - </attribute> - <attribute name="commentfile" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a file containing a comment.]]></short-description> - <description><![CDATA[ - Specifies a file containing a comment. - ]]></description> - </attribute> - <attribute name="identical" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, allows the file to be checked in even - if it is identical to the original.]]></short-description> - <description><![CDATA[ - If true, allows the file to be checked in even - if it is identical to the original. - ]]></description> - </attribute> - <attribute name="keepcopy" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, keeps a copy of the file with a .keep extension.]]></short-description> - <description><![CDATA[ - If true, keeps a copy of the file with a .keep extension. - ]]></description> - </attribute> - <attribute name="nowarn" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, suppress warning messages.]]></short-description> - <description><![CDATA[ - If true, suppress warning messages. - ]]></description> - </attribute> - <attribute name="preservetime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, preserve the modification time.]]></short-description> - <description><![CDATA[ - If true, preserve the modification time. - ]]></description> - </attribute> - <attribute name="viewpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the item in a ClearCase view to operate on.]]></short-description> - <description><![CDATA[ - Set the path to the item in a ClearCase view to operate on. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="cccheckout" category="other" - classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCCheckout" - > - - <short-description><![CDATA[Performs ClearCase checkout.]]></short-description> - <description> - <![CDATA[Performs ClearCase checkout. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>reserved</td> - <td>Specifies whether to check out the file as reserved or not</td> - <td>Yes</td> - <tr> - <tr> - <td>out</td> - <td>Creates a writable file under a different filename</td> - <td>No</td> - <tr> - <tr> - <td>nodata</td> - <td>Checks out the file but does not create an editable file containing its data</td> - <td>No</td> - <tr> - <tr> - <td>branch</td> - <td>Specify a branch to check out the file to</td> - <td>No</td> - <tr> - <tr> - <td>version</td> - <td>Allows checkout of a version other than main latest</td> - <td>No</td> - <tr> - <tr> - <td>nowarn</td> - <td>Suppress warning messages</td> - <td>No</td> - <tr> - <tr> - <td>comment</td> - <td>Specify a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - <tr> - <td>commentfile</td> - <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="branch" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specify a branch to check out the file to.]]></short-description> - <description><![CDATA[ - Specify a branch to check out the file to. - ]]></description> - </attribute> - <attribute name="cleartooldir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the cleartool executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the cleartool executable is located. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment string.]]></short-description> - <description><![CDATA[ - Sets the comment string. - ]]></description> - </attribute> - <attribute name="commentfile" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a file containing a comment.]]></short-description> - <description><![CDATA[ - Specifies a file containing a comment. - ]]></description> - </attribute> - <attribute name="nodata" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, checks out the file but does not create an - editable file containing its data.]]></short-description> - <description><![CDATA[ - If true, checks out the file but does not create an - editable file containing its data. - ]]></description> - </attribute> - <attribute name="nowarn" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, warning messages are suppressed.]]></short-description> - <description><![CDATA[ - If true, warning messages are suppressed. - ]]></description> - </attribute> - <attribute name="out" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Creates a writable file under a different filename.]]></short-description> - <description><![CDATA[ - Creates a writable file under a different filename. - ]]></description> - </attribute> - <attribute name="reserved" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, checks out the file as reserved.]]></short-description> - <description><![CDATA[ - If true, checks out the file as reserved. - ]]></description> - </attribute> - <attribute name="version" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, allows checkout of a version other than main latest.]]></short-description> - <description><![CDATA[ - If true, allows checkout of a version other than main latest. - ]]></description> - </attribute> - <attribute name="viewpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the item in a ClearCase view to operate on.]]></short-description> - <description><![CDATA[ - Set the path to the item in a ClearCase view to operate on. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccmcheckin" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCheckin" - > - - <short-description><![CDATA[Performs Continuus checkin command.]]></short-description> - <description> - <![CDATA[Performs Continuus checkin command.]]> - </description> - - <structure> - - <attributes> - <attribute name="ccmdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the ccm executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the ccm executable is located. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a comment.]]></short-description> - <description><![CDATA[ - Specifies a comment. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to the file that the command will operate on.]]></short-description> - <description><![CDATA[ - Sets the path to the file that the command will operate on. - ]]></description> - </attribute> - <attribute name="task" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the task number used to check - in the file (may use 'default').]]></short-description> - <description><![CDATA[ - Specifies the task number used to check - in the file (may use 'default'). - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccmcheckintask" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCheckinDefault" - > - - <short-description><![CDATA[Performs Continuus Checkin Default task command.]]></short-description> - <description> - <![CDATA[Performs Continuus Checkin Default task command.]]> - </description> - - <structure> - - <attributes> - <attribute name="ccmdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the ccm executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the ccm executable is located. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a comment.]]></short-description> - <description><![CDATA[ - Specifies a comment. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to the file that the command will operate on.]]></short-description> - <description><![CDATA[ - Sets the path to the file that the command will operate on. - ]]></description> - </attribute> - <attribute name="task" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the task number used to check - in the file (may use 'default').]]></short-description> - <description><![CDATA[ - Specifies the task number used to check - in the file (may use 'default'). - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccmcheckout" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCheckout" - > - - <short-description><![CDATA[Performs Continuus checkout command.]]></short-description> - <description> - <![CDATA[Performs Continuus checkout command.]]> - </description> - - <structure> - - <attributes> - <attribute name="ccmdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the ccm executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the ccm executable is located. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a comment.]]></short-description> - <description><![CDATA[ - Specifies a comment. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to the file that the command will operate on.]]></short-description> - <description><![CDATA[ - Sets the path to the file that the command will operate on. - ]]></description> - </attribute> - <attribute name="task" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the task number used to check - in the file (may use 'default').]]></short-description> - <description><![CDATA[ - Specifies the task number used to check - in the file (may use 'default'). - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccmcreatetask" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCreateTask" - > - - <short-description><![CDATA[Creates new Continuus ccm task and sets it as the default.]]></short-description> - <description> - <![CDATA[Creates new Continuus ccm task and sets it as the default.]]> - </description> - - <structure> - - <attributes> - <attribute name="ccmdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the ccm executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the ccm executable is located. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a comment.]]></short-description> - <description><![CDATA[ - Specifies a comment. - ]]></description> - </attribute> - <attribute name="platform" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the target platform.]]></short-description> - <description><![CDATA[ - Specifies the target platform. - ]]></description> - </attribute> - <attribute name="release" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specify the CCM release.]]></short-description> - <description><![CDATA[ - Specify the CCM release. - ]]></description> - </attribute> - <attribute name="resolver" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the resolver.]]></short-description> - <description><![CDATA[ - Specifies the resolver. - ]]></description> - </attribute> - <attribute name="subsystem" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the subsystem.]]></short-description> - <description><![CDATA[ - Specifies the subsystem. - ]]></description> - </attribute> - <attribute name="task" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the task number used to checkin - the file (may use 'default').]]></short-description> - <description><![CDATA[ - Specifies the task number used to checkin - the file (may use 'default'). - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccmreconfigure" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMReconfigure" - > - - <short-description><![CDATA[Task allows to reconfigure a project, recurcively or not]]></short-description> - <description> - <![CDATA[Task allows to reconfigure a project, recurcively or not]]> - </description> - - <structure> - - <attributes> - <attribute name="ccmdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the ccm executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the ccm executable is located. - ]]></description> - </attribute> - <attribute name="ccmproject" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Ccm project on which the operation is applied.]]></short-description> - <description><![CDATA[ - Sets the ccm project on which the operation is applied. - ]]></description> - </attribute> - <attribute name="recurse" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, recurse on subproject (default false).]]></short-description> - <description><![CDATA[ - If true, recurse on subproject (default false). - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do a verbose reconfigure operation (default false).]]></short-description> - <description><![CDATA[ - If true, do a verbose reconfigure operation (default false). - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccuncheckout" category="other" - classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCUnCheckout" - > - - <short-description><![CDATA[Performs ClearCase UnCheckout command.]]></short-description> - <description> - <![CDATA[Performs ClearCase UnCheckout command. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>keepcopy</td> - <td>Specifies whether to keep a copy of the file with a .keep extension or not</td> - <td>No</td> - <tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="cleartooldir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the cleartool executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the cleartool executable is located. - ]]></description> - </attribute> - <attribute name="keepcopy" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, keep a copy of the file with a .keep extension.]]></short-description> - <description><![CDATA[ - If true, keep a copy of the file with a .keep extension. - ]]></description> - </attribute> - <attribute name="viewpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the item in a ClearCase view to operate on.]]></short-description> - <description><![CDATA[ - Set the path to the item in a ClearCase view to operate on. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ccupdate" category="other" - classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCUpdate" - > - - <short-description><![CDATA[Performs a ClearCase Update command.]]></short-description> - <description> - <![CDATA[Performs a ClearCase Update command. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>graphical</td> - <td>Displays a graphical dialog during the update</td> - <td>No</td> - <tr> - <tr> - <td>log</td> - <td>Specifies a log file for ClearCase to write to</td> - <td>No</td> - <tr> - <tr> - <td>overwrite</td> - <td>Specifies whether to overwrite hijacked files or not</td> - <td>No</td> - <tr> - <tr> - <td>rename</td> - <td>Specifies that hijacked files should be renamed with a .keep extension</td> - <td>No</td> - <tr> - <tr> - <td>currenttime</td> - <td>Specifies that modification time should be written as the current time. Either currenttime or preservetime can be specified.</td> - <td>No</td> - <tr> - <tr> - <td>preservetime</td> - <td>Specifies that modification time should preserved from the VOB time. Either currenttime or preservetime can be specified.</td> - <td>No</td> - <tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="cleartooldir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the cleartool executable is located.]]></short-description> - <description><![CDATA[ - Set the directory where the cleartool executable is located. - ]]></description> - </attribute> - <attribute name="currenttime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, modification time should be written as the current time.]]></short-description> - <description><![CDATA[ - If true, modification time should be written as the current time. - Either currenttime or preservetime can be specified. - ]]></description> - </attribute> - <attribute name="graphical" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, displays a graphical dialog during the update.]]></short-description> - <description><![CDATA[ - If true, displays a graphical dialog during the update. - ]]></description> - </attribute> - <attribute name="log" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Log file where cleartool records - the status of the command.]]></short-description> - <description><![CDATA[ - Sets the log file where cleartool records - the status of the command. - ]]></description> - </attribute> - <attribute name="overwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, overwrite hijacked files.]]></short-description> - <description><![CDATA[ - If true, overwrite hijacked files. - ]]></description> - </attribute> - <attribute name="preservetime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, modification time should be preserved from the VOB time.]]></short-description> - <description><![CDATA[ - If true, modification time should be preserved from the VOB time. - Either currenttime or preservetime can be specified. - ]]></description> - </attribute> - <attribute name="rename" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, hijacked files are renamed with a .keep extension.]]></short-description> - <description><![CDATA[ - If true, hijacked files are renamed with a .keep extension. - ]]></description> - </attribute> - <attribute name="viewpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the item in a ClearCase view to operate on.]]></short-description> - <description><![CDATA[ - Set the path to the item in a ClearCase view to operate on. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="checksum" category="control" - classname="org.apache.tools.ant.taskdefs.Checksum" - matchingTask="true"> - - <short-description><![CDATA[Used to create or verify file checksums.]]></short-description> - <description> - <![CDATA[Used to create or verify file checksums.]]> - </description> - - <structure> - - <attributes> - <attribute name="algorithm" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the algorithm to be used to compute the checksum.]]></short-description> - <description><![CDATA[ - Specifies the algorithm to be used to compute the checksum. - Defaults to "MD5". Other popular algorithms like "SHA" may be used as well. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File for which the checksum is to be calculated.]]></short-description> - <description><![CDATA[ - Sets the file for which the checksum is to be calculated. - ]]></description> - </attribute> - <attribute name="fileext" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[File extension that is be to used to - create or identify destination file.]]></short-description> - <description><![CDATA[ - Sets the file extension that is be to used to - create or identify destination file. - ]]></description> - </attribute> - <attribute name="forceoverwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether or not to overwrite existing file irrespective of - whether it is newer than - the source file.]]></short-description> - <description><![CDATA[ - Whether or not to overwrite existing file irrespective of - whether it is newer than - the source file. Defaults to false. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property to hold the generated checksum.]]></short-description> - <description><![CDATA[ - Sets the property to hold the generated checksum. - ]]></description> - </attribute> - <attribute name="provider" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[MessageDigest algorithm provider to be used - to calculate the checksum.]]></short-description> - <description><![CDATA[ - Sets the MessageDigest algorithm provider to be used - to calculate the checksum. - ]]></description> - </attribute> - <attribute name="readbuffersize" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[The size of the read buffer to use.]]></short-description> - <description><![CDATA[ - The size of the read buffer to use. - ]]></description> - </attribute> - <attribute name="verifyproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Verify property.]]></short-description> - <description><![CDATA[ - Sets the verify property. This project property holds - the result of a checksum verification - "true" or "false" - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Files to generate checksums for.]]></short-description> - <description> - <![CDATA[Files to generate checksums for.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="chmod" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Chmod" - > - - <short-description><![CDATA[Chmod equivalent for unix-like environments.]]></short-description> - <description> - <![CDATA[Chmod equivalent for unix-like environments.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether output should be appended to or overwrite an existing file.]]></short-description> - <description><![CDATA[ - Whether output should be appended to or overwrite an existing file. - Defaults to false. - ]]></description> - </attribute> - <attribute name="defaultexcludes" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether default exclusions should be used or not.]]></short-description> - <description><![CDATA[ - Sets whether default exclusions should be used or not. - ]]></description> - </attribute> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory where target files are to be placed.]]></short-description> - <description><![CDATA[ - The directory where target files are to be placed. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory which holds the files whose permissions must be changed.]]></short-description> - <description><![CDATA[ - The directory which holds the files whose permissions must be changed. - ]]></description> - </attribute> - <attribute name="excludes" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set of exclude patterns.]]></short-description> - <description><![CDATA[ - Sets the set of exclude patterns. Patterns may be separated by a comma - or a space. - ]]></description> - </attribute> - <attribute name="executable" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The command to execute.]]></short-description> - <description><![CDATA[ - The command to execute. - ]]></description> - </attribute> - <attribute name="failifexecutionfails" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Stop the build if program cannot be started.]]></short-description> - <description><![CDATA[ - Stop the build if program cannot be started. Defaults to true. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Fail if the command exits with a non-zero return code.]]></short-description> - <description><![CDATA[ - Fail if the command exits with a non-zero return code. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file or single directory of which the permissions must be changed.]]></short-description> - <description><![CDATA[ - The file or single directory of which the permissions must be changed. - ]]></description> - </attribute> - <attribute name="includes" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set of include patterns.]]></short-description> - <description><![CDATA[ - Sets the set of include patterns. Patterns may be separated by a comma - or a space. - ]]></description> - </attribute> - <attribute name="newenvironment" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Do not propagate old environment when new environment variables are specified.]]></short-description> - <description><![CDATA[ - Do not propagate old environment when new environment variables are specified. - ]]></description> - </attribute> - <attribute name="os" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[List of operating systems on which the command may be executed.]]></short-description> - <description><![CDATA[ - List of operating systems on which the command may be executed. - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File the output of the process is redirected to.]]></short-description> - <description><![CDATA[ - File the output of the process is redirected to. - ]]></description> - </attribute> - <attribute name="outputproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property name whose value should be set to the output of - the process.]]></short-description> - <description><![CDATA[ - Property name whose value should be set to the output of - the process. - ]]></description> - </attribute> - <attribute name="parallel" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, run the command only once, appending all files as arguments.]]></short-description> - <description><![CDATA[ - If true, run the command only once, appending all files as arguments. - If false, command will be executed once for every file. Defaults to false. - ]]></description> - </attribute> - <attribute name="perm" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The new permissions.]]></short-description> - <description><![CDATA[ - The new permissions. - ]]></description> - </attribute> - <attribute name="relative" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the filenames should be passed on the command line as - absolute or relative pathnames.]]></short-description> - <description><![CDATA[ - Whether the filenames should be passed on the command line as - absolute or relative pathnames. Paths are relative to the base - directory of the corresponding fileset for source files or the - dest attribute for target files. - ]]></description> - </attribute> - <attribute name="resultproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of a property in which the return code of the - command should be stored.]]></short-description> - <description><![CDATA[ - The name of a property in which the return code of the - command should be stored. Only of interest if failonerror=false. - ]]></description> - </attribute> - <attribute name="skipemptyfilesets" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If no source files have been found or are newer than their - corresponding target files, do not run the command.]]></short-description> - <description><![CDATA[ - If no source files have been found or are newer than their - corresponding target files, do not run the command. - ]]></description> - </attribute> - <attribute name="type" type="org.apache.tools.ant.taskdefs.ExecuteOn.FileDirBoth" - briefType=""file", "dir", "both"" required="NOTDEFINED"> - <short-description><![CDATA[Whether the command works only on files, directories or both?.]]></short-description> - <description><![CDATA[ - Whether the command works only on files, directories or both? - ]]></description> - </attribute> - <attribute name="vmlauncher" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, launch new process with VM, otherwise use the OS's shell.]]></short-description> - <description><![CDATA[ - If true, launch new process with VM, otherwise use the OS's shell. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an environment variable to the launched process.]]></short-description> - <description> - <![CDATA[Add an environment variable to the launched process.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Source files to operate upon.]]></short-description> - <description> - <![CDATA[Source files to operate upon.]]> - </description> - </element> - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a command-line argument.]]></short-description> - <description> - <![CDATA[Adds a command-line argument.]]> - </description> - </element> - - <element name="exclude" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the exclude list.]]></short-description> - <description> - <![CDATA[Add a name entry on the exclude list.]]> - </description> - </element> - - <element name="include" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the include list.]]></short-description> - <description> - <![CDATA[Add a name entry on the include list.]]> - </description> - </element> - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" - briefType="Mapper" - required="NOTDEFINED"> - <short-description><![CDATA[Mapper to use for mapping source files to target files.]]></short-description> - <description> - <![CDATA[Mapper to use for mapping source files to target files.]]> - </description> - </element> - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" - briefType="Patternset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a set of patterns.]]></short-description> - <description> - <![CDATA[Add a set of patterns.]]> - </description> - </element> - - <element name="srcfile" type="org.apache.tools.ant.types.Commandline.Marker" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Marker that indicates where the name of the source file should - be put on the command line.]]></short-description> - <description> - <![CDATA[Marker that indicates where the name of the source file should - be put on the command line.]]> - </description> - </element> - - <element name="targetfile" type="org.apache.tools.ant.types.Commandline.Marker" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Marker that indicates where the name of the target file should - be put on the command line.]]></short-description> - <description> - <![CDATA[Marker that indicates where the name of the target file should - be put on the command line.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="concat" category="other" - classname="org.apache.tools.ant.taskdefs.Concat" - > - - <short-description><![CDATA[This class contains the 'concat' task, used to concatenate a series of files into a single stream.]]></short-description> - <description> - <![CDATA[This class contains the 'concat' task, used to concatenate a series - of files into a single stream. The destination of this stream may - be the system console, or a file. The following is a sample - invocation: - - <pre> - <concat destfile="${build.dir}/index.xml" - append="false"> - - <fileset dir="${xml.root.dir}" - includes="*.xml" /> - - </concat> - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Behavior when the destination file exists.]]></short-description> - <description><![CDATA[ - Sets the behavior when the destination file exists. If set to - <code>true</code> the stream data will be appended to the - existing file, otherwise the existing file will be - overwritten. Defaults to <code>false</code>. - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination file, or uses the console if not specified.]]></short-description> - <description><![CDATA[ - Sets the destination file, or uses the console if not specified. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding for the input files, used when displaying the - data via the console.]]></short-description> - <description><![CDATA[ - Sets the encoding for the input files, used when displaying the - data via the console. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="filelist" type="org.apache.tools.ant.types.FileList" - briefType="Filelist" - required="NOTDEFINED"> - <short-description><![CDATA[List of files to concatenate.]]></short-description> - <description> - <![CDATA[List of files to concatenate.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Set of files to concatenate.]]></short-description> - <description> - <![CDATA[Set of files to concatenate.]]> - </description> - </element> - - </elements> - - <body > - <description><![CDATA[ - This method adds text which appears in the 'concat' element. - ]]></description> - </body> - - </structure> - -</task> - - -<task name="condition" category="control" - classname="org.apache.tools.ant.taskdefs.ConditionTask" - > - - <short-description><![CDATA[Task to set a property conditionally using <uptodate>, <available>, and many other supported conditions.]]></short-description> - <description> - <![CDATA[Task to set a property conditionally using <uptodate>, <available>, - and many other supported conditions. - - <p>This task supports boolean logic as well as pluggable conditions - to decide, whether a property should be set.</p> - - <p>This task does not extend Task to take advantage of - ConditionBase.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the property to set.]]></short-description> - <description><![CDATA[ - The name of the property to set. Required. - ]]></description> - </attribute> - <attribute name="value" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The value for the property to set, if condition evaluates to true.]]></short-description> - <description><![CDATA[ - The value for the property to set, if condition evaluates to true. - Defaults to "true". - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="and" type="org.apache.tools.ant.taskdefs.condition.And" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <and> condition "container".]]></short-description> - <description> - <![CDATA[Add an <and> condition "container".]]> - </description> - </element> - - <element name="available" type="org.apache.tools.ant.taskdefs.Available" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <available> condition.]]></short-description> - <description> - <![CDATA[Add an <available> condition.]]> - </description> - </element> - - <element name="checksum" type="org.apache.tools.ant.taskdefs.Checksum" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <checksum> condition.]]></short-description> - <description> - <![CDATA[Add an <checksum> condition.]]> - </description> - </element> - - <element name="contains" type="org.apache.tools.ant.taskdefs.condition.Contains" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <contains> condition.]]></short-description> - <description> - <![CDATA[Add a <contains> condition.]]> - </description> - </element> - - <element name="equals" type="org.apache.tools.ant.taskdefs.condition.Equals" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <equals> condition.]]></short-description> - <description> - <![CDATA[Add an <equals> condition.]]> - </description> - </element> - - <element name="filesmatch" type="org.apache.tools.ant.taskdefs.condition.FilesMatch" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <filesmatch> condition.]]></short-description> - <description> - <![CDATA[Add a <filesmatch> condition.]]> - </description> - </element> - - <element name="http" type="org.apache.tools.ant.taskdefs.condition.Http" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <http> condition.]]></short-description> - <description> - <![CDATA[Add an <http> condition.]]> - </description> - </element> - - <element name="isfalse" type="org.apache.tools.ant.taskdefs.condition.IsFalse" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <isfalse> condition.]]></short-description> - <description> - <![CDATA[Add a <isfalse> condition.]]> - </description> - </element> - - <element name="isset" type="org.apache.tools.ant.taskdefs.condition.IsSet" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <isset> condition.]]></short-description> - <description> - <![CDATA[Add an <isset> condition.]]> - </description> - </element> - - <element name="istrue" type="org.apache.tools.ant.taskdefs.condition.IsTrue" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <istrue> condition.]]></short-description> - <description> - <![CDATA[Add a <istrue> condition.]]> - </description> - </element> - - <element name="not" type="org.apache.tools.ant.taskdefs.condition.Not" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <not> condition "container".]]></short-description> - <description> - <![CDATA[Add an <not> condition "container".]]> - </description> - </element> - - <element name="or" type="org.apache.tools.ant.taskdefs.condition.Or" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <or> condition "container".]]></short-description> - <description> - <![CDATA[Add an <or> condition "container".]]> - </description> - </element> - - <element name="os" type="org.apache.tools.ant.taskdefs.condition.Os" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <os> condition.]]></short-description> - <description> - <![CDATA[Add an <os> condition.]]> - </description> - </element> - - <element name="socket" type="org.apache.tools.ant.taskdefs.condition.Socket" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <socket> condition.]]></short-description> - <description> - <![CDATA[Add a <socket> condition.]]> - </description> - </element> - - <element name="uptodate" type="org.apache.tools.ant.taskdefs.UpToDate" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <uptodate> condition.]]></short-description> - <description> - <![CDATA[Add an <uptodate> condition.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="copy" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Copy" - > - - <short-description><![CDATA[Copies a file or directory to a new file or directory.]]></short-description> - <description> - <![CDATA[Copies a file or directory to a new file - or directory. Files are only copied if the source file is newer - than the destination file, or when the destination file does not - exist. It is possible to explicitly overwrite existing files.</p> - - <p>This implementation is based on Arnout Kuiper's initial design - document, the following mailing list discussions, and the - copyfile/copydir tasks.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Character encoding.]]></short-description> - <description><![CDATA[ - Sets the character encoding - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If false, note errors to the output but keep going.]]></short-description> - <description><![CDATA[ - If false, note errors to the output but keep going. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Single source file to copy.]]></short-description> - <description><![CDATA[ - Sets a single source file to copy. - ]]></description> - </attribute> - <attribute name="filtering" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables filtering.]]></short-description> - <description><![CDATA[ - If true, enables filtering. - ]]></description> - </attribute> - <attribute name="flatten" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[When copying directory trees, the files can be "flattened" - into a single directory.]]></short-description> - <description><![CDATA[ - When copying directory trees, the files can be "flattened" - into a single directory. If there are multiple files with - the same name in the source directory tree, only the first - file will be copied into the "flattened" directory, unless - the forceoverwrite attribute is true. - ]]></description> - </attribute> - <attribute name="includeemptydirs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Used to copy empty directories.]]></short-description> - <description><![CDATA[ - Used to copy empty directories. - ]]></description> - </attribute> - <attribute name="overwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Overwrite any existing destination file(s).]]></short-description> - <description><![CDATA[ - Overwrite any existing destination file(s). - ]]></description> - </attribute> - <attribute name="preservelastmodified" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Give the copied files the same last modified time as the original files.]]></short-description> - <description><![CDATA[ - Give the copied files the same last modified time as the original files. - ]]></description> - </attribute> - <attribute name="todir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory.]]></short-description> - <description><![CDATA[ - Sets the destination directory. - ]]></description> - </attribute> - <attribute name="tofile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination file.]]></short-description> - <description><![CDATA[ - Sets the destination file. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Used to force listing of all names of copied files.]]></short-description> - <description><![CDATA[ - Used to force listing of all names of copied files. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files to copy.]]></short-description> - <description> - <![CDATA[Adds a set of files to copy.]]> - </description> - </element> - - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" - briefType="FilterChain" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a FilterChain.]]></short-description> - <description> - <![CDATA[Adds a FilterChain.]]> - </description> - </element> - - <element name="filterset" type="org.apache.tools.ant.types.FilterSet" - briefType="Filterset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a filterset.]]></short-description> - <description> - <![CDATA[Adds a filterset.]]> - </description> - </element> - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" - briefType="Mapper" - required="NOTDEFINED"> - <short-description><![CDATA[Defines the mapper to map source to destination files.]]></short-description> - <description> - <![CDATA[Defines the mapper to map source to destination files.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="copydir" category="other" - classname="org.apache.tools.ant.taskdefs.Copydir" - deprecated="true" - matchingTask="true"> - - <short-description><![CDATA[Copies a directory.]]></short-description> - <description> - <![CDATA[Copies a directory.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="filtering" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="flatten" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="forceoverwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="copyfile" category="other" - classname="org.apache.tools.ant.taskdefs.Copyfile" - deprecated="true" - > - - <short-description><![CDATA[Copies a file.]]></short-description> - <description> - <![CDATA[Copies a file.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="filtering" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="forceoverwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="csc" category="dotnet" - classname="org.apache.tools.ant.taskdefs.optional.dotnet.CSharp" - matchingTask="true"> - - <short-description><![CDATA[Compiles C# source into executables or modules.]]></short-description> - <description> - <![CDATA[Compiles C# source into executables or modules. - - The task will only work on win2K until other platforms support - csc.exe or an equivalent. CSC.exe must be on the execute path too. <p> - - All parameters are optional: <csc/> should suffice to produce a debug - build of all *.cs files. References to external files do require explicit - enumeration, so are one of the first attributes to consider adding. <p> - - The task is a directory based task, so attributes like <b>includes="*.cs" - </b> and <b>excludes="broken.cs"</b> can be used to control the files pulled - in. By default, all *.cs files from the project folder down are included in - the command. When this happens the output file -if not specified- is taken - as the first file in the list, which may be somewhat hard to control. - Specifying the output file with <b>'outfile'</b> seems prudent. <p> - - <p> - - TODO - <ol> - <li> is incremental build still broken in beta-1? - <li> is Win32Icon broken? - <li> all the missing options - </ol> - <p> - - History - <Table> - - <tr> - - <td> - 0.3 - </td> - - <td> - Beta 1 edition - </td> - - <td> - To avoid having to remember which assemblies to include, the task - automatically refers to the main dotnet libraries in Beta1. - </tr> - - <tr> - - <td> - 0.2 - </td> - - <td> - Slightly different - </td> - - <td> - Split command execution to a separate class; - </tr> - - <tr> - - <td> - 0.1 - </td> - - <td> - "I can't believe it's so rudimentary" - </td> - - <td> - First pass; minimal builds only support; - </tr> - - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="additionalmodules" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Semicolon separated list of modules to refer to.]]></short-description> - <description><![CDATA[ - Semicolon separated list of modules to refer to. - ]]></description> - </attribute> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Debug flag on or off.]]></short-description> - <description><![CDATA[ - set the debug flag on or off. - ]]></description> - </attribute> - <attribute name="definitions" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Semicolon separated list of defined constants.]]></short-description> - <description><![CDATA[ - Semicolon separated list of defined constants. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory of files to be compiled.]]></short-description> - <description><![CDATA[ - Set the destination directory of files to be compiled. - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of exe/library to create.]]></short-description> - <description><![CDATA[ - Set the name of exe/library to create. - ]]></description> - </attribute> - <attribute name="docfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File for generated XML documentation.]]></short-description> - <description><![CDATA[ - file for generated XML documentation - ]]></description> - </attribute> - <attribute name="extraoptions" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Any extra options which are not explicitly supported - by this task.]]></short-description> - <description><![CDATA[ - Any extra options which are not explicitly supported - by this task. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, fail on compilation errors.]]></short-description> - <description><![CDATA[ - If true, fail on compilation errors. - ]]></description> - </attribute> - <attribute name="filealign" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[File alignment.]]></short-description> - <description><![CDATA[ - Set the file alignment. - Valid values are 0,512, 1024, 2048, 4096, 8192, - and 16384, 0 means 'leave to the compiler' - ]]></description> - </attribute> - <attribute name="fullpaths" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, print the full path of files on errors.]]></short-description> - <description><![CDATA[ - If true, print the full path of files on errors. - ]]></description> - </attribute> - <attribute name="includedefaultreferences" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, automatically includes the common assemblies - in dotnet, and tells the compiler to link in mscore.dll. - - set the automatic reference inclusion flag on or off this flag controls - the string of references and the /nostdlib option in CSC.]]></short-description> - <description><![CDATA[ - If true, automatically includes the common assemblies - in dotnet, and tells the compiler to link in mscore.dll. - - set the automatic reference inclusion flag on or off this flag controls - the string of references and the /nostdlib option in CSC - ]]></description> - </attribute> - <attribute name="incremental" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Incremental compilation flag on or off.]]></short-description> - <description><![CDATA[ - set the incremental compilation flag on or off. - ]]></description> - </attribute> - <attribute name="mainclass" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of main class for executables.]]></short-description> - <description><![CDATA[ - Sets the name of main class for executables. - ]]></description> - </attribute> - <attribute name="noconfig" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[A flag that tells the compiler not to read in the compiler - settings files 'csc.rsp' in its bin directory and then the local directory.]]></short-description> - <description><![CDATA[ - A flag that tells the compiler not to read in the compiler - settings files 'csc.rsp' in its bin directory and then the local directory - ]]></description> - </attribute> - <attribute name="optimize" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables optimization flag.]]></short-description> - <description><![CDATA[ - If true, enables optimization flag. - ]]></description> - </attribute> - <attribute name="outputfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output file.]]></short-description> - <description><![CDATA[ - Set the output file - ]]></description> - </attribute> - <attribute name="referencefiles" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Path of references to include.]]></short-description> - <description><![CDATA[ - Path of references to include. - Wildcards should work. - ]]></description> - </attribute> - <attribute name="references" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Semicolon separated list of DLLs to refer to.]]></short-description> - <description><![CDATA[ - Semicolon separated list of DLLs to refer to. - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source directory of the files to be compiled.]]></short-description> - <description><![CDATA[ - Set the source directory of the files to be compiled. - ]]></description> - </attribute> - <attribute name="targettype" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Type of target.]]></short-description> - <description><![CDATA[ - Set the type of target. - ]]></description> - </attribute> - <attribute name="unsafe" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables the unsafe keyword.]]></short-description> - <description><![CDATA[ - If true, enables the unsafe keyword. - ]]></description> - </attribute> - <attribute name="utf8output" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, require all compiler output to be in UTF8 format.]]></short-description> - <description><![CDATA[ - If true, require all compiler output to be in UTF8 format. - ]]></description> - </attribute> - <attribute name="warnlevel" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Level of warning currently between 1 and 4 - with 4 being the strictest.]]></short-description> - <description><![CDATA[ - Level of warning currently between 1 and 4 - with 4 being the strictest. - ]]></description> - </attribute> - <attribute name="win32icon" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Filename of icon to include.]]></short-description> - <description><![CDATA[ - Set the filename of icon to include. - ]]></description> - </attribute> - <attribute name="win32res" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Filename of a win32 resource (.RES) file to include.]]></short-description> - <description><![CDATA[ - Sets the filename of a win32 resource (.RES) file to include. - This is not a .NET resource, but what Windows is used to. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="cvs" category="scm" - classname="org.apache.tools.ant.taskdefs.Cvs" - > - - <short-description><![CDATA[Performs operations on a CVS repository. original 1.20 NOTE: This implementation has been moved to AbstractCvsTask with the addition of some accessors for extensibility.]]></short-description> - <description> - <![CDATA[Performs operations on a CVS repository. - - original 1.20 - - NOTE: This implementation has been moved to AbstractCvsTask with - the addition of some accessors for extensibility.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to append output/error when redirecting to a file.]]></short-description> - <description><![CDATA[ - Whether to append output/error when redirecting to a file. - ]]></description> - </attribute> - <attribute name="command" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The CVS command to execute.]]></short-description> - <description><![CDATA[ - The CVS command to execute. - ]]></description> - </attribute> - <attribute name="compression" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, this is the same as compressionlevel="3".]]></short-description> - <description><![CDATA[ - If true, this is the same as compressionlevel="3". - ]]></description> - </attribute> - <attribute name="compressionlevel" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression.]]></short-description> - <description><![CDATA[ - If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression. - ]]></description> - </attribute> - <attribute name="cvsroot" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The CVSROOT variable.]]></short-description> - <description><![CDATA[ - The CVSROOT variable. - ]]></description> - </attribute> - <attribute name="cvsrsh" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The CVS_RSH variable.]]></short-description> - <description><![CDATA[ - The CVS_RSH variable. - ]]></description> - </attribute> - <attribute name="date" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Use the most recent revision no later than the given date.]]></short-description> - <description><![CDATA[ - Use the most recent revision no later than the given date. - ]]></description> - </attribute> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory where the checked out files should be placed.]]></short-description> - <description><![CDATA[ - The directory where the checked out files should be placed. - ]]></description> - </attribute> - <attribute name="error" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to direct standard error from the command.]]></short-description> - <description><![CDATA[ - The file to direct standard error from the command. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Stop the build process if the command exits with - a return code other than 0.]]></short-description> - <description><![CDATA[ - Stop the build process if the command exits with - a return code other than 0. - Defaults to false. - ]]></description> - </attribute> - <attribute name="noexec" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, report only and don't change any files.]]></short-description> - <description><![CDATA[ - If true, report only and don't change any files. - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to direct standard output from the command.]]></short-description> - <description><![CDATA[ - The file to direct standard output from the command. - ]]></description> - </attribute> - <attribute name="package" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The package/module to operate upon.]]></short-description> - <description><![CDATA[ - The package/module to operate upon. - ]]></description> - </attribute> - <attribute name="passfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Password file to read passwords from.]]></short-description> - <description><![CDATA[ - Password file to read passwords from. - ]]></description> - </attribute> - <attribute name="port" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Port used by CVS to communicate with the server.]]></short-description> - <description><![CDATA[ - Port used by CVS to communicate with the server. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, suppress informational messages.]]></short-description> - <description><![CDATA[ - If true, suppress informational messages. - ]]></description> - </attribute> - <attribute name="tag" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The tag of the package/module to operate upon.]]></short-description> - <description><![CDATA[ - The tag of the package/module to operate upon. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="commandline" type="org.apache.tools.ant.types.Commandline" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds direct command-line to execute.]]></short-description> - <description> - <![CDATA[Adds direct command-line to execute.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="cvschangelog" category="other" - classname="org.apache.tools.ant.taskdefs.cvslib.ChangeLogTask" - > - - <short-description><![CDATA[Examines the output of cvs log and group related changes together.]]></short-description> - <description> - <![CDATA[Examines the output of cvs log and group related changes together. - - It produces an XML output representing the list of changes. - <PRE> - <FONT color=#0000ff><!-- Root element --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> changelog <FONT color=#ff00ff>(entry</FONT><FONT color=#ff00ff>+</FONT><FONT color=#ff00ff>)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- CVS Entry --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> entry <FONT color=#ff00ff>(date,author,file</FONT><FONT color=#ff00ff>+</FONT><FONT color=#ff00ff>,msg)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- Date of cvs entry --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> date <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- Author of change --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> author <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- List of files affected --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> msg <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- File changed --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> file <FONT color=#ff00ff>(name,revision,prevrevision</FONT><FONT color=#ff00ff>?</FONT><FONT color=#ff00ff>)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- Name of the file --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> name <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- Revision number --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> revision <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>></FONT> - <FONT color=#0000ff><!-- Previous revision number --></FONT> - <FONT color=#6a5acd><!ELEMENT</FONT> prevrevision <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>></FONT> - </PRE>]]> - </description> - - <structure> - - <attributes> - <attribute name="daysinpast" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Number of days worth of log entries to process.]]></short-description> - <description><![CDATA[ - Set the number of days worth of log entries to process. - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output file for the log.]]></short-description> - <description><![CDATA[ - Set the output file for the log. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Base dir for cvs.]]></short-description> - <description><![CDATA[ - Set the base dir for cvs. - ]]></description> - </attribute> - <attribute name="end" type="java.util.Date" - briefType="Date" required="NOTDEFINED"> - <short-description><![CDATA[Date at which the changelog should stop.]]></short-description> - <description><![CDATA[ - Set the date at which the changelog should stop. - ]]></description> - </attribute> - <attribute name="start" type="java.util.Date" - briefType="Date" required="NOTDEFINED"> - <short-description><![CDATA[Date at which the changelog should start.]]></short-description> - <description><![CDATA[ - Set the date at which the changelog should start. - ]]></description> - </attribute> - <attribute name="usersfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Lookup list of user names & addresses.]]></short-description> - <description><![CDATA[ - Set a lookup list of user names & addresses - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files about which cvs logs will be generated.]]></short-description> - <description> - <![CDATA[Adds a set of files about which cvs logs will be generated.]]> - </description> - </element> - - <element name="user" type="org.apache.tools.ant.taskdefs.cvslib.CvsUser" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a user to list changelog knows about.]]></short-description> - <description> - <![CDATA[Add a user to list changelog knows about.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="cvspass" category="scm" - classname="org.apache.tools.ant.taskdefs.CVSPass" - > - - <short-description><![CDATA[Adds an new entry to a CVS password file.]]></short-description> - <description> - <![CDATA[Adds an new entry to a CVS password file.]]> - </description> - - <structure> - - <attributes> - <attribute name="cvsroot" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The CVS repository to add an entry for.]]></short-description> - <description><![CDATA[ - The CVS repository to add an entry for. - ]]></description> - </attribute> - <attribute name="passfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Password file to add the entry to.]]></short-description> - <description><![CDATA[ - Password file to add the entry to. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password to be added to the password file.]]></short-description> - <description><![CDATA[ - Password to be added to the password file. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="cvstagdiff" category="other" - classname="org.apache.tools.ant.taskdefs.cvslib.CvsTagDiff" - > - - <short-description><![CDATA[Examines the output of cvs rdiff between two tags.]]></short-description> - <description> - <![CDATA[Examines the output of cvs rdiff between two tags. - - It produces an XML output representing the list of changes. - <PRE> - <!-- Root element --> - <!ELEMENT tagdiff ( entry+ ) > - <!-- Start tag of the report --> - <!ATTLIST tagdiff startTag NMTOKEN #IMPLIED > - <!-- End tag of the report --> - <!ATTLIST tagdiff endTag NMTOKEN #IMPLIED > - <!-- Start date of the report --> - <!ATTLIST tagdiff startDate NMTOKEN #IMPLIED > - <!-- End date of the report --> - <!ATTLIST tagdiff endDate NMTOKEN #IMPLIED > - - <!-- CVS tag entry --> - <!ELEMENT entry ( file ) > - <!-- File added, changed or removed --> - <!ELEMENT file ( name, revision?, prevrevision? ) > - <!-- Name of the file --> - <!ELEMENT name ( #PCDATA ) > - <!-- Revision number --> - <!ELEMENT revision ( #PCDATA ) > - <!-- Previous revision number --> - <!ELEMENT prevrevision ( #PCDATA ) > - </PRE>]]> - </description> - - <structure> - - <attributes> - <attribute name="compression" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, this is the same as compressionlevel="3".]]></short-description> - <description><![CDATA[ - If true, this is the same as compressionlevel="3". - ]]></description> - </attribute> - <attribute name="compressionlevel" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression.]]></short-description> - <description><![CDATA[ - If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression. - ]]></description> - </attribute> - <attribute name="cvsroot" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The CVSROOT variable.]]></short-description> - <description><![CDATA[ - The CVSROOT variable. - ]]></description> - </attribute> - <attribute name="cvsrsh" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The CVS_RSH variable.]]></short-description> - <description><![CDATA[ - The CVS_RSH variable. - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output file for the diff.]]></short-description> - <description><![CDATA[ - Set the output file for the diff. - ]]></description> - </attribute> - <attribute name="enddate" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[End date.]]></short-description> - <description><![CDATA[ - Set the end date. - ]]></description> - </attribute> - <attribute name="endtag" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[End tag.]]></short-description> - <description><![CDATA[ - Set the end tag. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Stop the build process if the command exits with - a return code other than 0.]]></short-description> - <description><![CDATA[ - Stop the build process if the command exits with - a return code other than 0. - Defaults to false. - ]]></description> - </attribute> - <attribute name="package" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The package/module to analyze.]]></short-description> - <description><![CDATA[ - The package/module to analyze. - ]]></description> - </attribute> - <attribute name="passfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Password file to read passwords from.]]></short-description> - <description><![CDATA[ - Password file to read passwords from. - ]]></description> - </attribute> - <attribute name="port" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Port used by CVS to communicate with the server.]]></short-description> - <description><![CDATA[ - Port used by CVS to communicate with the server. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, suppress informational messages.]]></short-description> - <description><![CDATA[ - If true, suppress informational messages. - ]]></description> - </attribute> - <attribute name="startdate" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Start date.]]></short-description> - <description><![CDATA[ - Set the start date. - ]]></description> - </attribute> - <attribute name="starttag" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Start tag.]]></short-description> - <description><![CDATA[ - Set the start tag. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ddcreator" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ejb.DDCreator" - matchingTask="true"> - - <short-description><![CDATA[Builds a serialized deployment descriptor given a text file description of the descriptor in the format supported by WebLogic.]]></short-description> - <description> - <![CDATA[Builds a serialized deployment descriptor given a text file description of the - descriptor in the format supported by WebLogic. - - This ant task is a front end for the weblogic DDCreator tool.]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="descriptors" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory from where the text descriptions of the deployment descriptors are - to be read.]]></short-description> - <description><![CDATA[ - Set the directory from where the text descriptions of the deployment descriptors are - to be read. - ]]></description> - </attribute> - <attribute name="dest" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory into which the serialized deployment descriptors are to - be written.]]></short-description> - <description><![CDATA[ - Set the directory into which the serialized deployment descriptors are to - be written. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="delete" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Delete" - matchingTask="true"> - - <short-description><![CDATA[Deletes a file or directory, or set of files defined by a fileset.]]></short-description> - <description> - <![CDATA[Deletes a file or directory, or set of files defined by a fileset. - The original delete task would delete a file, or a set of files - using the include/exclude syntax. The deltree task would delete a - directory tree. This task combines the functionality of these two - originally distinct tasks. - <p>Currently Delete extends MatchingTask. This is intend <i>only</i> - to provide backwards compatibility for a release. The future position - is to use nested filesets exclusively.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="defaultexcludes" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether default exclusions should be used or not.]]></short-description> - <description><![CDATA[ - Sets whether default exclusions should be used or not. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory from which files are to be deleted.]]></short-description> - <description><![CDATA[ - Set the directory from which files are to be deleted - ]]></description> - </attribute> - <attribute name="excludes" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set of exclude patterns.]]></short-description> - <description><![CDATA[ - Sets the set of exclude patterns. Patterns may be separated by a comma - or a space. - ]]></description> - </attribute> - <attribute name="excludesfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the file containing the includes patterns.]]></short-description> - <description><![CDATA[ - Sets the name of the file containing the includes patterns. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If false, note errors but continue.]]></short-description> - <description><![CDATA[ - If false, note errors but continue. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of a single file to be removed.]]></short-description> - <description><![CDATA[ - Set the name of a single file to be removed. - ]]></description> - </attribute> - <attribute name="includeemptydirs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, delete empty directories.]]></short-description> - <description><![CDATA[ - If true, delete empty directories. - ]]></description> - </attribute> - <attribute name="includes" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set of include patterns.]]></short-description> - <description><![CDATA[ - Sets the set of include patterns. Patterns may be separated by a comma - or a space. - ]]></description> - </attribute> - <attribute name="includesfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the file containing the includes patterns.]]></short-description> - <description><![CDATA[ - Sets the name of the file containing the includes patterns. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true and the file does not exist, do not display a diagnostic - message or modify the exit status to reflect an error.]]></short-description> - <description><![CDATA[ - If true and the file does not exist, do not display a diagnostic - message or modify the exit status to reflect an error. - This means that if a file or directory cannot be deleted, - then no error is reported. This setting emulates the - -f option to the Unix "rm" command. - Default is false meaning things are "noisy" - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, list all names of deleted files.]]></short-description> - <description><![CDATA[ - If true, list all names of deleted files. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files to be deleted.]]></short-description> - <description> - <![CDATA[Adds a set of files to be deleted.]]> - </description> - </element> - - <element name="exclude" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the exclude list.]]></short-description> - <description> - <![CDATA[add a name entry on the exclude list]]> - </description> - </element> - - <element name="excludesfile" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the include files list.]]></short-description> - <description> - <![CDATA[add a name entry on the include files list]]> - </description> - </element> - - <element name="include" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the include list.]]></short-description> - <description> - <![CDATA[add a name entry on the include list]]> - </description> - </element> - - <element name="includesfile" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the include files list.]]></short-description> - <description> - <![CDATA[add a name entry on the include files list]]> - </description> - </element> - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" - briefType="Patternset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a set of patterns.]]></short-description> - <description> - <![CDATA[add a set of patterns]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="deltree" category="other" - classname="org.apache.tools.ant.taskdefs.Deltree" - deprecated="true" - > - - <short-description><![CDATA[No Description.]]></short-description> - <description> - <![CDATA[]]> - </description> - - <structure> - - <attributes> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory to be deleted.]]></short-description> - <description><![CDATA[ - Set the directory to be deleted - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="depend" category="other" - classname="org.apache.tools.ant.taskdefs.optional.depend.Depend" - matchingTask="true"> - - <short-description><![CDATA[Generates a dependency file for a given set of classes.]]></short-description> - <description> - <![CDATA[Generates a dependency file for a given set of classes.]]> - </description> - - <structure> - - <attributes> - <attribute name="cache" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Dependency cache file.]]></short-description> - <description><![CDATA[ - Sets the dependency cache file. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this dependency check.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this dependency check. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="closure" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, transitive dependencies are followed until the - closure of the dependency set if reached.]]></short-description> - <description><![CDATA[ - If true, transitive dependencies are followed until the - closure of the dependency set if reached. - When not set, the depend task will only follow - direct dependencies between classes. - ]]></description> - </attribute> - <attribute name="destdir" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory where the compiled Java files exist.]]></short-description> - <description><![CDATA[ - Set the destination directory where the compiled Java files exist. - ]]></description> - </attribute> - <attribute name="dump" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, the dependency information will be written - to the debug level log.]]></short-description> - <description><![CDATA[ - If true, the dependency information will be written - to the debug level log. - ]]></description> - </attribute> - <attribute name="srcdir" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Directories path to find the Java source files.]]></short-description> - <description><![CDATA[ - Set the directories path to find the Java source files. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a classpath to be used for this dependency check.]]></short-description> - <description> - <![CDATA[Adds a classpath to be used for this dependency check.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="dependset" category="filesystem" - classname="org.apache.tools.ant.taskdefs.DependSet" - matchingTask="true"> - - <short-description><![CDATA[Examines and removes out of date target files.]]></short-description> - <description> - <![CDATA[Examines and removes out of date target files. If any of the target files - are out of date with respect to any of the source files, all target - files are removed. This is useful where dependencies cannot be - computed (for example, dynamically interpreted parameters or files - that need to stay in synch but are not directly linked) or where - the ant task in question could compute them but does not (for - example, the linked DTD for an XML file using the style task). - - nested arguments: - <ul> - <li>srcfileset (fileset describing the source files to examine) - <li>srcfilelist (filelist describing the source files to examine) - <li>targetfileset (fileset describing the target files to examine) - <li>targetfilelist (filelist describing the target files to examine) - </ul> - At least one instance of either a fileset or filelist for both source and - target are required. - <p> - This task will examine each of the source files against each of the target - files. If any target files are out of date with respect to any of the source - files, all targets are removed. If any files named in a (src or target) - filelist do not exist, all targets are removed. - Hint: If missing files should be ignored, specify them as include patterns - in filesets, rather than using filelists. - </p><p> - This task attempts to optimize speed of dependency checking. It will stop - after the first out of date file is found and remove all targets, rather - than exhaustively checking every source vs target combination unnecessarily. - </p><p> - Example uses: - <ul><li> - Record the fact that an XML file must be up to date - with respect to its XSD (Schema file), even though the XML file - itself includes no reference to its XSD. - </li><li> - Record the fact that an XSL stylesheet includes other - sub-stylesheets - </li><li> - Record the fact that java files must be recompiled if the ant build - file changes - </li></ul>]]> - </description> - - <structure> - - <attributes> - </attributes> - - <elements> - <element name="srcfilelist" type="org.apache.tools.ant.types.FileList" - briefType="Filelist" - required="NOTDEFINED"> - <short-description><![CDATA[Add a list of source files.]]></short-description> - <description> - <![CDATA[Add a list of source files.]]> - </description> - </element> - - <element name="srcfileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a set of source files.]]></short-description> - <description> - <![CDATA[Add a set of source files.]]> - </description> - </element> - - <element name="targetfilelist" type="org.apache.tools.ant.types.FileList" - briefType="Filelist" - required="NOTDEFINED"> - <short-description><![CDATA[Add a list of target files.]]></short-description> - <description> - <![CDATA[Add a list of target files.]]> - </description> - </element> - - <element name="targetfileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a set of target files.]]></short-description> - <description> - <![CDATA[Add a set of target files.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="dirname" category="property" - classname="org.apache.tools.ant.taskdefs.Dirname" - > - - <short-description><![CDATA[Determines the directory name of the specified file.]]></short-description> - <description> - <![CDATA[Determines the directory name of the specified file. - - This task can accept the following attributes: - <ul> - <li>file - <li>property - </ul> - Both <b>file</b> and <b>property</b> are required. - <p> - When this task executes, it will set the specified property to the - value of the specified file up to, but not including, the last path - element. If file is a file, the directory will be the current - directory.]]> - </description> - - <structure> - - <attributes> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to take the dirname of.]]></short-description> - <description><![CDATA[ - Path to take the dirname of. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the property to set.]]></short-description> - <description><![CDATA[ - The name of the property to set. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ear" category="packaging" - classname="org.apache.tools.ant.taskdefs.Ear" - matchingTask="true"> - - <short-description><![CDATA[Creates a EAR archive.]]></short-description> - <description> - <![CDATA[Creates a EAR archive. Based on WAR task]]> - </description> - - <structure> - - <attributes> - <attribute name="appxml" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File to incorporate as application.xml.]]></short-description> - <description><![CDATA[ - File to incorporate as application.xml. - ]]></description> - </attribute> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory from which to archive files; optional.]]></short-description> - <description><![CDATA[ - Directory from which to archive files; optional. - ]]></description> - </attribute> - <attribute name="compress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether we want to compress the files or only store them; - optional, default=true;.]]></short-description> - <description><![CDATA[ - Whether we want to compress the files or only store them; - optional, default=true; - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to create; required.]]></short-description> - <description><![CDATA[ - The file to create; required. - ]]></description> - </attribute> - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" - briefType=""add", "preserve", "fail"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.]]></short-description> - <description><![CDATA[ - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding to use for filenames, defaults to the platform's - default encoding.]]></short-description> - <description><![CDATA[ - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - ]]></description> - </attribute> - <attribute name="filesonly" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.]]></short-description> - <description><![CDATA[ - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - ]]></description> - </attribute> - <attribute name="index" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether or not to create an index list for classes.]]></short-description> - <description><![CDATA[ - Set whether or not to create an index list for classes. - This may speed up classloading in some cases. - ]]></description> - </attribute> - <attribute name="manifest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The manifest file to use.]]></short-description> - <description><![CDATA[ - The manifest file to use. This can be either the location of a manifest, - or the name of a jar added through a fileset. If its the name of an added - jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.MF. - ]]></description> - </attribute> - <attribute name="update" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.]]></short-description> - <description><![CDATA[ - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - ]]></description> - </attribute> - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" - briefType=""fail", "skip", "create"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior of the task when no files match.]]></short-description> - <description><![CDATA[ - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="archives" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds zipfileset.]]></short-description> - <description> - <![CDATA[Adds zipfileset.]]> - </description> - </element> - - <element name="manifest" type="org.apache.tools.ant.taskdefs.Manifest" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.]]></short-description> - <description> - <![CDATA[Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files.]]></short-description> - <description> - <![CDATA[Adds a set of files.]]> - </description> - </element> - - <element name="metainf" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a zipfileset to include in the META-INF directory.]]></short-description> - <description> - <![CDATA[Adds a zipfileset to include in the META-INF directory.]]> - </description> - </element> - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a group of zip files.]]></short-description> - <description> - <![CDATA[Adds a group of zip files.]]> - </description> - </element> - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]></short-description> - <description> - <![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="echo" category="utility" - classname="org.apache.tools.ant.taskdefs.Echo" - > - - <short-description><![CDATA[Writes a message to the Ant logging facilities.]]></short-description> - <description> - <![CDATA[Writes a message to the Ant logging facilities.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, append to existing file.]]></short-description> - <description><![CDATA[ - If true, append to existing file. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File to write to.]]></short-description> - <description><![CDATA[ - File to write to. - ]]></description> - </attribute> - <attribute name="level" type="org.apache.tools.ant.taskdefs.Echo.EchoLevel" - briefType=""error", "warning", "info", "verbose", "debug"" required="NOTDEFINED"> - <short-description><![CDATA[Logging level.]]></short-description> - <description><![CDATA[ - Set the logging level. Level should be one of - <ul> - <li>error</li> - <li>warning</li> - <li>info</li> - <li>verbose</li> - <li>debug</li> - </ul> - <p>The default is "warning" to ensure that messages are - displayed by default when using the -quiet command line option.</p> - ]]></description> - </attribute> - <attribute name="message" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Message to write.]]></short-description> - <description><![CDATA[ - Message to write. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - <body > - <description><![CDATA[ - Set a multiline message. - ]]></description> - </body> - - </structure> - -</task> - - -<task name="echoproperties" category="other" - classname="org.apache.tools.ant.taskdefs.optional.EchoProperties" - > - - <short-description><![CDATA[Displays all the current properties in the build.]]></short-description> - <description> - <![CDATA[Displays all the current properties in the build. The output can be sent to - a file if desired. <P> - - Attribute "destfile" defines a file to send the properties to. This can be - processed as a standard property file later. <P> - - Attribute "prefix" defines a prefix which is used to filter the properties - only those properties starting with this prefix will be echoed. <P> - - By default, the "failonerror" attribute is enabled. If an error occurs while - writing the properties to a file, and this attribute is enabled, then a - BuildException will be thrown. If disabled, then IO errors will be reported - as a log statement, but no error will be thrown. <P> - - Examples: <pre> - <echoproperties /> - </pre> Report the current properties to the log. <P> - - <pre> - <echoproperties destfile="my.properties" /> - </pre> Report the current properties to the file "my.properties", and will - fail the build if the file could not be created or written to. <P> - - <pre> - <echoproperties destfile="my.properties" failonerror="false" - prefix="ant" /> - </pre> Report all properties beginning with 'ant' to the file - "my.properties", and will log a message if the file could not be created or - written to, but will still allow the build to continue.]]> - </description> - - <structure> - - <attributes> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File to store the property output.]]></short-description> - <description><![CDATA[ - Set a file to store the property output. If this is never specified, - then the output will be sent to the Ant log. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, the task will fail if an error occurs writing the properties - file, otherwise errors are just logged.]]></short-description> - <description><![CDATA[ - If true, the task will fail if an error occurs writing the properties - file, otherwise errors are just logged. - ]]></description> - </attribute> - <attribute name="prefix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[If the prefix is set, then only properties which start with this - prefix string will be recorded.]]></short-description> - <description><![CDATA[ - If the prefix is set, then only properties which start with this - prefix string will be recorded. If this is never set, or it is set - to an empty string or <tt>null</tt>, then all properties will be - recorded. <P> - - For example, if the property is set as: - <PRE><echoproperties prefix="ant." /></PRE> - then the property "ant.home" will be recorded, but "ant-example" - will not. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ejbc" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ejb.Ejbc" - matchingTask="true"> - - <short-description><![CDATA[Builds EJB support classes using WebLogic's ejbc tool from a directory containing a set of deployment descriptors.]]></short-description> - <description> - <![CDATA[Builds EJB support classes using WebLogic's ejbc tool from a directory containing - a set of deployment descriptors.]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="descriptors" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory from where the serialized deployment descriptors are - to be read.]]></short-description> - <description><![CDATA[ - Set the directory from where the serialized deployment descriptors are - to be read. - ]]></description> - </attribute> - <attribute name="dest" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory into which the support classes, RMI stubs, etc are to be written.]]></short-description> - <description><![CDATA[ - Set the directory into which the support classes, RMI stubs, etc are to be written. - ]]></description> - </attribute> - <attribute name="keepgenerated" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[If true, ejbc will keep the - intermediate Java files used to build the class files.]]></short-description> - <description><![CDATA[ - If true, ejbc will keep the - intermediate Java files used to build the class files. - This can be useful when debugging. - ]]></description> - </attribute> - <attribute name="manifest" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the generated manifest file.]]></short-description> - <description><![CDATA[ - Set the name of the generated manifest file. - - For each EJB that is processed an entry is created in this file. This can then be used - to create a jar file for dploying the beans. - ]]></description> - </attribute> - <attribute name="src" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory containing the source code for the home interface, remote interface - and public key class definitions.]]></short-description> - <description><![CDATA[ - Set the directory containing the source code for the home interface, remote interface - and public key class definitions. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ejbjar" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ejb.EjbJar" - matchingTask="true"> - - <short-description><![CDATA[Provides automated EJB JAR file creation.]]></short-description> - <description> - <![CDATA[Provides automated EJB JAR file creation. - <p> - Extends the - MatchingTask class provided in the default ant distribution to provide a - directory scanning EJB jarfile generator. - </p> - - <p> - The task works by taking the deployment descriptors one at a time and - parsing them to locate the names of the classes which should be placed in - the jar. The classnames are translated to java.io.Files by replacing - periods with File.separatorChar and resolving the generated filename as a - relative path under the srcDir attribute. All necessary files are then - assembled into a jarfile. One jarfile is constructed for each deployment - descriptor found. - </p>]]> - </description> - - <structure> - - <attributes> - <attribute name="basejarname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Base name of the EJB JAR that is to be created if it is not - to be determined from the name of the deployment descriptor files.]]></short-description> - <description><![CDATA[ - Set the base name of the EJB JAR that is to be created if it is not - to be determined from the name of the deployment descriptor files. - ]]></description> - </attribute> - <attribute name="basenameterminator" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The string which terminates the bean name.]]></short-description> - <description><![CDATA[ - The string which terminates the bean name. - The convention used by this task is - that bean descriptors are named as the BeanName with some suffix. The - baseNameTerminator string separates the bean name and the suffix and - is used to determine the bean name. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to use when resolving classes for inclusion in the jar.]]></short-description> - <description><![CDATA[ - Set the classpath to use when resolving classes for inclusion in the jar. - ]]></description> - </attribute> - <attribute name="dependency" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Analyzer to use when adding in dependencies to the JAR.]]></short-description> - <description><![CDATA[ - Set the analyzer to use when adding in dependencies to the JAR. - ]]></description> - </attribute> - <attribute name="descriptordir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Descriptor directory.]]></short-description> - <description><![CDATA[ - Set the descriptor directory. The descriptor directory contains the - EJB deployment descriptors. These are XML files that declare the - properties of a bean in a particular deployment scenario. Such - properties include, for example, the transactional nature of the bean - and the security access control to the bean's methods. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory.]]></short-description> - <description><![CDATA[ - Set the destination directory. The EJB jar files will be written into - this directory. The jar files that exist in this directory are also - used when determining if the contents of the jar file have changed. - Note that this parameter is only used if no deployment tools are - specified. Typically each deployment tool will specify its own - destination directory. - ]]></description> - </attribute> - <attribute name="flatdestdir" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Controls whether the - destination JARs are written out in the destination directory with - the same hierarchical structure from which the deployment descriptors - have been read.]]></short-description> - <description><![CDATA[ - Controls whether the - destination JARs are written out in the destination directory with - the same hierarchical structure from which the deployment descriptors - have been read. If this is set to true the generated EJB jars are - written into the root of the destination directory, otherwise they - are written out in the same relative position as the deployment - descriptors in the descriptor directory. - ]]></description> - </attribute> - <attribute name="genericjarsuffix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Suffix for the generated jar file.]]></short-description> - <description><![CDATA[ - Set the suffix for the generated jar file. When generic jars are - generated, they have a suffix which is appended to the the bean name - to create the name of the jar file. Note that this suffix includes - the extension fo te jar file and should therefore end with an - appropriate extension such as .jar or .ear - ]]></description> - </attribute> - <attribute name="manifest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Manifest file to use when jarring.]]></short-description> - <description><![CDATA[ - Set the Manifest file to use when jarring. As of EJB 1.1, manifest - files are no longer used to configure the EJB. However, they still - have a vital importance if the EJB is intended to be packaged in an - EAR file. By adding "Class-Path" settings to a Manifest file, the EJB - can look for classes inside the EAR file itself, allowing for easier - deployment. This is outlined in the J2EE specification, and all J2EE - components are meant to support it. - ]]></description> - </attribute> - <attribute name="naming" type="org.apache.tools.ant.taskdefs.optional.ejb.EjbJar.NamingScheme" - briefType=""ejb-name", "directory", "descriptor", "basejarname"" required="NOTDEFINED"> - <short-description><![CDATA[Naming scheme used to determine the name of the generated jars - from the deployment descriptor.]]></short-description> - <description><![CDATA[ - Set the naming scheme used to determine the name of the generated jars - from the deployment descriptor - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source directory, which is the directory that - contains the classes that will be added to the EJB jar.]]></short-description> - <description><![CDATA[ - Sets the source directory, which is the directory that - contains the classes that will be added to the EJB jar. Typically - this will include the home and remote interfaces and the bean class. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="borland" type="org.apache.tools.ant.taskdefs.optional.ejb.BorlandDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for Borland server.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for Borland server.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds to the classpath used to locate the super classes and - interfaces of the classes that will make up the EJB JAR.]]></short-description> - <description> - <![CDATA[Adds to the classpath used to locate the super classes and - interfaces of the classes that will make up the EJB JAR.]]> - </description> - </element> - - <element name="dtd" type="org.apache.tools.ant.taskdefs.optional.ejb.EjbJar.DTDLocation" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create a DTD location record.]]></short-description> - <description> - <![CDATA[Create a DTD location record. This stores the location of a DTD. The - DTD is identified by its public Id. The location may either be a file - location or a resource location.]]> - </description> - </element> - - <element name="iplanet" type="org.apache.tools.ant.taskdefs.optional.ejb.IPlanetDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for iPlanet Application Server.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for iPlanet Application Server.]]> - </description> - </element> - - <element name="jboss" type="org.apache.tools.ant.taskdefs.optional.ejb.JbossDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for JBoss server.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for JBoss server.]]> - </description> - </element> - - <element name="jonas" type="org.apache.tools.ant.taskdefs.optional.ejb.JonasDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for JOnAS server.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for JOnAS server.]]> - </description> - </element> - - <element name="support" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a fileset for support elements.]]></short-description> - <description> - <![CDATA[Adds a fileset for support elements.]]> - </description> - </element> - - <element name="weblogic" type="org.apache.tools.ant.taskdefs.optional.ejb.WeblogicDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for Weblogic server.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for Weblogic server.]]> - </description> - </element> - - <element name="weblogictoplink" type="org.apache.tools.ant.taskdefs.optional.ejb.WeblogicTOPLinkDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for Weblogic when using the Toplink - Object-Relational mapping.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for Weblogic when using the Toplink - Object-Relational mapping.]]> - </description> - </element> - - <element name="websphere" type="org.apache.tools.ant.taskdefs.optional.ejb.WebsphereDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a deployment tool for Websphere 4.0 server.]]></short-description> - <description> - <![CDATA[Adds a deployment tool for Websphere 4.0 server.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="exec" category="control" - classname="org.apache.tools.ant.taskdefs.ExecTask" - > - - <short-description><![CDATA[Executes a given command if the os platform is appropriate.]]></short-description> - <description> - <![CDATA[Executes a given command if the os platform is appropriate.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether output should be appended to or overwrite an existing file.]]></short-description> - <description><![CDATA[ - Whether output should be appended to or overwrite an existing file. - Defaults to false. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The working directory of the process.]]></short-description> - <description><![CDATA[ - The working directory of the process. - ]]></description> - </attribute> - <attribute name="executable" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The command to execute.]]></short-description> - <description><![CDATA[ - The command to execute. - ]]></description> - </attribute> - <attribute name="failifexecutionfails" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Stop the build if program cannot be started.]]></short-description> - <description><![CDATA[ - Stop the build if program cannot be started. Defaults to true. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Fail if the command exits with a non-zero return code.]]></short-description> - <description><![CDATA[ - Fail if the command exits with a non-zero return code. - ]]></description> - </attribute> - <attribute name="newenvironment" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Do not propagate old environment when new environment variables are specified.]]></short-description> - <description><![CDATA[ - Do not propagate old environment when new environment variables are specified. - ]]></description> - </attribute> - <attribute name="os" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[List of operating systems on which the command may be executed.]]></short-description> - <description><![CDATA[ - List of operating systems on which the command may be executed. - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File the output of the process is redirected to.]]></short-description> - <description><![CDATA[ - File the output of the process is redirected to. - ]]></description> - </attribute> - <attribute name="outputproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property name whose value should be set to the output of - the process.]]></short-description> - <description><![CDATA[ - Property name whose value should be set to the output of - the process. - ]]></description> - </attribute> - <attribute name="resultproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of a property in which the return code of the - command should be stored.]]></short-description> - <description><![CDATA[ - The name of a property in which the return code of the - command should be stored. Only of interest if failonerror=false. - ]]></description> - </attribute> - <attribute name="vmlauncher" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, launch new process with VM, otherwise use the OS's shell.]]></short-description> - <description><![CDATA[ - If true, launch new process with VM, otherwise use the OS's shell. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an environment variable to the launched process.]]></short-description> - <description> - <![CDATA[Add an environment variable to the launched process.]]> - </description> - </element> - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a command-line argument.]]></short-description> - <description> - <![CDATA[Adds a command-line argument.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="fail" category="control" - classname="org.apache.tools.ant.taskdefs.Exit" - > - - <short-description><![CDATA[Exits the active build, giving an additional message if available.]]></short-description> - <description> - <![CDATA[Exits the active build, giving an additional message - if available.]]> - </description> - - <structure> - - <attributes> - <attribute name="if" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Only fail if a property of the given name exists in the current project.]]></short-description> - <description><![CDATA[ - Only fail if a property of the given name exists in the current project. - ]]></description> - </attribute> - <attribute name="message" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A message giving further information on why the build exited.]]></short-description> - <description><![CDATA[ - A message giving further information on why the build exited. - ]]></description> - </attribute> - <attribute name="unless" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Only fail if a property of the given name does not - exist in the current project.]]></short-description> - <description><![CDATA[ - Only fail if a property of the given name does not - exist in the current project. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - <body > - <description><![CDATA[ - Set a multiline message. - ]]></description> - </body> - - </structure> - -</task> - - -<task name="filter" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Filter" - > - - <short-description><![CDATA[Sets a token filter that is used by the file copy tasks to do token substitution.]]></short-description> - <description> - <![CDATA[Sets a token filter that is used by the file copy tasks - to do token substitution. Sets mutiple tokens by - reading these from a file.]]> - </description> - - <structure> - - <attributes> - <attribute name="filtersfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file from which the filters must be read.]]></short-description> - <description><![CDATA[ - The file from which the filters must be read. - This file must be a formatted as a property file. - ]]></description> - </attribute> - <attribute name="token" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The token string without @ delimiters.]]></short-description> - <description><![CDATA[ - The token string without @ delimiters. - ]]></description> - </attribute> - <attribute name="value" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The string that should replace the token during filtered copies.]]></short-description> - <description><![CDATA[ - The string that should replace the token during filtered copies. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="fixcrlf" category="filesystem" - classname="org.apache.tools.ant.taskdefs.FixCRLF" - matchingTask="true"> - - <short-description><![CDATA[Converts text source files to local OS formatting conventions, as well as repair text files damaged by misconfigured or misguided editors or file transfer programs.]]></short-description> - <description> - <![CDATA[Converts text source files to local OS formatting conventions, as - well as repair text files damaged by misconfigured or misguided editors or - file transfer programs. - <p> - This task can take the following arguments: - <ul> - <li>srcdir - <li>destdir - <li>include - <li>exclude - <li>cr - <li>eol - <li>tab - <li>eof - <li>encoding - </ul> - Of these arguments, only <b>sourcedir</b> is required. - <p> - When this task executes, it will scan the srcdir based on the include - and exclude properties. - <p> - This version generalises the handling of EOL characters, and allows - for CR-only line endings (which I suspect is the standard on Macs.) - Tab handling has also been generalised to accommodate any tabwidth - from 2 to 80, inclusive. Importantly, it will leave untouched any - literal TAB characters embedded within string or character constants. - <p> - <em>Warning:</em> do not run on binary files. - <em>Caution:</em> run with care on carefully formatted files. - This may sound obvious, but if you don't specify asis, presume that - your files are going to be modified. If "tabs" is "add" or "remove", - whitespace characters may be added or removed as necessary. Similarly, - for CR's - in fact "eol"="crlf" or cr="add" can result in cr - characters being removed in one special case accommodated, i.e., - CRCRLF is regarded as a single EOL to handle cases where other - programs have converted CRLF into CRCRLF.]]> - </description> - - <structure> - - <attributes> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination where the fixed files should be placed.]]></short-description> - <description><![CDATA[ - Set the destination where the fixed files should be placed. - Default is to replace the original file. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the encoding Ant expects the files to be in - - defaults to the platforms default encoding.]]></short-description> - <description><![CDATA[ - Specifies the encoding Ant expects the files to be in - - defaults to the platforms default encoding. - ]]></description> - </attribute> - <attribute name="eof" type="org.apache.tools.ant.taskdefs.FixCRLF.AddAsisRemove" - briefType=""add", "asis", "remove"" required="NOTDEFINED"> - <short-description><![CDATA[Specify how DOS EOF (control-z) characters are to be handled.]]></short-description> - <description><![CDATA[ - Specify how DOS EOF (control-z) characters are to be handled. - ]]></description> - </attribute> - <attribute name="eol" type="org.apache.tools.ant.taskdefs.FixCRLF.CrLf" - briefType=""asis", "cr", "lf", "crlf"" required="NOTDEFINED"> - <short-description><![CDATA[Specify how EndOfLine characters are to be handled.]]></short-description> - <description><![CDATA[ - Specify how EndOfLine characters are to be handled. - ]]></description> - </attribute> - <attribute name="javafiles" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set to true if modifying Java source files.]]></short-description> - <description><![CDATA[ - Set to true if modifying Java source files. - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source dir to find the source text files.]]></short-description> - <description><![CDATA[ - Set the source dir to find the source text files. - ]]></description> - </attribute> - <attribute name="tab" type="org.apache.tools.ant.taskdefs.FixCRLF.AddAsisRemove" - briefType=""add", "asis", "remove"" required="NOTDEFINED"> - <short-description><![CDATA[Specify how tab characters are to be handled.]]></short-description> - <description><![CDATA[ - Specify how tab characters are to be handled. - ]]></description> - </attribute> - <attribute name="tablength" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Specify tab length in characters.]]></short-description> - <description><![CDATA[ - Specify tab length in characters. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="ftp" category="other" - classname="org.apache.tools.ant.taskdefs.optional.net.FTP" - > - - <short-description><![CDATA[Basic FTP client.]]></short-description> - <description> - <![CDATA[Basic FTP client. Performs the following actions: - <ul> - <li> <strong>send</strong> - send files to a remote server. This is the - default action.</li> - <li> <strong>get</strong> - retrive files from a remote server.</li> - <li> <strong>del</strong> - delete files from a remote server.</li> - <li> <strong>list</strong> - create a file listing.</li> - <li> <strong>chmod</strong> - change unix file permissions.</li> - </ul> - <strong>Note:</strong> Some FTP servers - notably the Solaris server - seem - to hold data ports open after a "retr" operation, allowing them to timeout - instead of shutting them down cleanly. This happens in active or passive - mode, and the ports will remain open even after ending the FTP session. FTP - "send" operations seem to close ports immediately. This behavior may cause - problems on some systems when downloading large sets of files.]]> - </description> - - <structure> - - <attributes> - <attribute name="action" type="org.apache.tools.ant.taskdefs.optional.net.FTP.Action" - briefType=""send", "put", "recv", "get", "del", "delete", "list", "mkdir", "chmod"" required="NOTDEFINED"> - <short-description><![CDATA[FTP action to be taken.]]></short-description> - <description><![CDATA[ - Sets the FTP action to be taken. Currently accepts "put", "get", "del", - "mkdir", "chmod" and "list". - ]]></description> - </attribute> - <attribute name="binary" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, uses binary mode, otherwise text mode (default is binary).]]></short-description> - <description><![CDATA[ - If true, uses binary mode, otherwise text mode (default is binary). - ]]></description> - </attribute> - <attribute name="chmod" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[File permission mode (Unix only) for files sent to the server.]]></short-description> - <description><![CDATA[ - Sets the file permission mode (Unix only) for files sent to the server. - ]]></description> - </attribute> - <attribute name="depends" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set to true to transmit only files that are new or changed from their - remote counterparts.]]></short-description> - <description><![CDATA[ - Set to true to transmit only files that are new or changed from their - remote counterparts. The default is to transmit all files. - ]]></description> - </attribute> - <attribute name="ignorenoncriticalerrors" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to skip errors on directory creation. - (and maybe later other server specific errors).]]></short-description> - <description><![CDATA[ - set the flag to skip errors on directory creation. - (and maybe later other server specific errors) - ]]></description> - </attribute> - <attribute name="listing" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The output file for the "list" action.]]></short-description> - <description><![CDATA[ - The output file for the "list" action. This attribute is ignored for - any other actions. - ]]></description> - </attribute> - <attribute name="newer" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[A synonym for <tt>depends</tt>.]]></short-description> - <description><![CDATA[ - A synonym for <tt>depends</tt>. Set to true to transmit only new or changed - files. - ]]></description> - </attribute> - <attribute name="passive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Specifies whether to use passive mode.]]></short-description> - <description><![CDATA[ - Specifies whether to use passive mode. Set to true if you are behind a - firewall and cannot connect without it. Passive mode is disabled by - default. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Login password for the given user id.]]></short-description> - <description><![CDATA[ - Sets the login password for the given user id. - ]]></description> - </attribute> - <attribute name="port" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[FTP port used by the remote server.]]></short-description> - <description><![CDATA[ - Sets the FTP port used by the remote server. - ]]></description> - </attribute> - <attribute name="remotedir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Remote directory where files will be placed.]]></short-description> - <description><![CDATA[ - Sets the remote directory where files will be placed. This may be a - relative or absolute path, and must be in the path syntax expected by - the remote server. No correction of path syntax will be performed. - ]]></description> - </attribute> - <attribute name="separator" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Remote file separator character.]]></short-description> - <description><![CDATA[ - Sets the remote file separator character. This normally defaults to the - Unix standard forward slash, but can be manually overridden using this - call if the remote server requires some other separator. Only the first - character of the string is used. - ]]></description> - </attribute> - <attribute name="server" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[FTP server to send files to.]]></short-description> - <description><![CDATA[ - Sets the FTP server to send files to. - ]]></description> - </attribute> - <attribute name="skipfailedtransfers" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables unsuccessful file put, delete and get - operations to be skipped with a warning and the remainder - of the files still transferred.]]></short-description> - <description><![CDATA[ - If true, enables unsuccessful file put, delete and get - operations to be skipped with a warning and the remainder - of the files still transferred. - ]]></description> - </attribute> - <attribute name="umask" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Default mask for file creation on a unix server.]]></short-description> - <description><![CDATA[ - Sets the default mask for file creation on a unix server. - ]]></description> - </attribute> - <attribute name="userid" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Login user id to use on the specified server.]]></short-description> - <description><![CDATA[ - Sets the login user id to use on the specified server. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set to true to receive notification about each file as it is - transferred.]]></short-description> - <description><![CDATA[ - Set to true to receive notification about each file as it is - transferred. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[A set of files to upload or download.]]></short-description> - <description> - <![CDATA[A set of files to upload or download]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="genkey" category="java" - classname="org.apache.tools.ant.taskdefs.GenerateKey" - > - - <short-description><![CDATA[Generates a key in a keystore.]]></short-description> - <description> - <![CDATA[Generates a key in a keystore.]]> - </description> - - <structure> - - <attributes> - <attribute name="alias" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The alias to add under.]]></short-description> - <description><![CDATA[ - The alias to add under. - ]]></description> - </attribute> - <attribute name="dname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The distinguished name for entity.]]></short-description> - <description><![CDATA[ - The distinguished name for entity. - ]]></description> - </attribute> - <attribute name="keyalg" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The method to use when generating name-value pair.]]></short-description> - <description><![CDATA[ - The method to use when generating name-value pair. - ]]></description> - </attribute> - <attribute name="keypass" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password for private key (if different).]]></short-description> - <description><![CDATA[ - Password for private key (if different). - ]]></description> - </attribute> - <attribute name="keysize" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Indicates the size of key generated.]]></short-description> - <description><![CDATA[ - Indicates the size of key generated. - ]]></description> - </attribute> - <attribute name="keystore" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Keystore location.]]></short-description> - <description><![CDATA[ - Keystore location. - ]]></description> - </attribute> - <attribute name="sigalg" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The algorithm to use in signing.]]></short-description> - <description><![CDATA[ - The algorithm to use in signing. - ]]></description> - </attribute> - <attribute name="storepass" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password for keystore integrity.]]></short-description> - <description><![CDATA[ - Password for keystore integrity. - Must be at least 6 characters long. - ]]></description> - </attribute> - <attribute name="storetype" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Keystore type.]]></short-description> - <description><![CDATA[ - Keystore type. - ]]></description> - </attribute> - <attribute name="validity" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Indicates how many days certificate is valid.]]></short-description> - <description><![CDATA[ - Indicates how many days certificate is valid. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, verbose output when signing.]]></short-description> - <description><![CDATA[ - If true, verbose output when signing. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="dname" type="org.apache.tools.ant.taskdefs.GenerateKey.DistinguishedName" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Distinguished name list.]]></short-description> - <description> - <![CDATA[Distinguished name list.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="get" category="network" - classname="org.apache.tools.ant.taskdefs.Get" - > - - <short-description><![CDATA[Gets a particular file from a URL source.]]></short-description> - <description> - <![CDATA[Gets a particular file from a URL source. - Options include verbose reporting, timestamp based fetches and controlling - actions on failures. NB: access through a firewall only works if the whole - Java runtime is correctly configured.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Where to copy the source file.]]></short-description> - <description><![CDATA[ - Where to copy the source file. - ]]></description> - </attribute> - <attribute name="ignoreerrors" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, log errors but do not treat as fatal.]]></short-description> - <description><![CDATA[ - If true, log errors but do not treat as fatal. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password for the basic authentication.]]></short-description> - <description><![CDATA[ - password for the basic authentication. - ]]></description> - </attribute> - <attribute name="src" type="java.net.URL" - briefType="URL" required="NOTDEFINED"> - <short-description><![CDATA[URL to get.]]></short-description> - <description><![CDATA[ - Set the URL to get. - ]]></description> - </attribute> - <attribute name="usetimestamp" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, conditionally download a file based on the timestamp - of the local copy.]]></short-description> - <description><![CDATA[ - If true, conditionally download a file based on the timestamp - of the local copy. - - <p>In this situation, the if-modified-since header is set so - that the file is only fetched if it is newer than the local - file (or there is no local file) This flag is only valid on - HTTP connections, it is ignored in other cases. When the flag - is set, the local copy of the downloaded file will also have - its timestamp set to the remote file time.</p> - - <p>Note that remote files of date 1/1/1970 (GMT) are treated as - 'no timestamp', and web servers often serve files with a - timestamp in the future by replacing their timestamp with that - of the current time. Also, inter-computer clock differences can - cause no end of grief.</p> - ]]></description> - </attribute> - <attribute name="username" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Username for basic auth.]]></short-description> - <description><![CDATA[ - Username for basic auth. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, show verbose progress information.]]></short-description> - <description><![CDATA[ - If true, show verbose progress information. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="gunzip" category="packaging" - classname="org.apache.tools.ant.taskdefs.GUnzip" - > - - <short-description><![CDATA[Expands a file that has been compressed with the GZIP algorithm.]]></short-description> - <description> - <![CDATA[Expands a file that has been compressed with the GZIP - algorithm. Normally used to compress non-compressed archives such - as TAR files.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The destination file or directory; optional.]]></short-description> - <description><![CDATA[ - The destination file or directory; optional. - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to expand; required.]]></short-description> - <description><![CDATA[ - The file to expand; required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="gzip" category="packaging" - classname="org.apache.tools.ant.taskdefs.GZip" - > - - <short-description><![CDATA[Compresses a file with the GZIP algorithm.]]></short-description> - <description> - <![CDATA[Compresses a file with the GZIP algorithm. Normally used to compress - non-compressed archives such as TAR files.]]> - </description> - - <structure> - - <attributes> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to compress; required.]]></short-description> - <description><![CDATA[ - the file to compress; required. - ]]></description> - </attribute> - <attribute name="zipfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The required destination file.]]></short-description> - <description><![CDATA[ - the required destination file. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="icontract" category="other" - classname="org.apache.tools.ant.taskdefs.optional.IContract" - matchingTask="true"> - - <short-description><![CDATA[Instruments Java classes with iContract DBC preprocessor.]]></short-description> - <description> - <![CDATA[Instruments Java classes with iContract DBC preprocessor. - <br/> - The task can generate a properties file for <a href="http://hjem.sol.no/hellesoy/icontrol.html">iControl</a>, - a graphical user interface that lets you turn on/off assertions. iControl generates a control file that you can refer to - from this task using the controlfile attribute. - iContract is at <a href="http://www.reliable-systems.com/tools/">http://www.reliable-systems.com/tools/</a> - <p/> - Thanks to Rainer Schmitz for enhancements and comments.]]> - </description> - - <structure> - - <attributes> - <attribute name="builddir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Build directory for instrumented classes.]]></short-description> - <description><![CDATA[ - Sets the build directory for instrumented classes. - ]]></description> - </attribute> - <attribute name="classdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Class directory (uninstrumented classes).]]></short-description> - <description><![CDATA[ - Sets the class directory (uninstrumented classes). - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for invocation of iContract.]]></short-description> - <description><![CDATA[ - Sets the classpath to be used for invocation of iContract. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="controlfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Control file to pass to iContract.]]></short-description> - <description><![CDATA[ - Sets the control file to pass to iContract. - ]]></description> - </attribute> - <attribute name="failthrowable" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Throwable (Exception) to be thrown on assertion violation.]]></short-description> - <description><![CDATA[ - Sets the Throwable (Exception) to be thrown on assertion violation. - ]]></description> - </attribute> - <attribute name="instrumentdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Instrumentation directory.]]></short-description> - <description><![CDATA[ - Sets the instrumentation directory. - ]]></description> - </attribute> - <attribute name="invariant" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Turns on/off invariant instrumentation.]]></short-description> - <description><![CDATA[ - Turns on/off invariant instrumentation. - ]]></description> - </attribute> - <attribute name="post" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Turns on/off postcondition instrumentation.]]></short-description> - <description><![CDATA[ - Turns on/off postcondition instrumentation. - ]]></description> - </attribute> - <attribute name="pre" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Turns on/off precondition instrumentation.]]></short-description> - <description><![CDATA[ - Turns on/off precondition instrumentation. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Tells iContract to be quiet.]]></short-description> - <description><![CDATA[ - Tells iContract to be quiet. - ]]></description> - </attribute> - <attribute name="repbuilddir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Build directory for instrumented classes.]]></short-description> - <description><![CDATA[ - Sets the build directory for instrumented classes. - ]]></description> - </attribute> - <attribute name="repositorydir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Build directory for repository classes.]]></short-description> - <description><![CDATA[ - Sets the build directory for repository classes. - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source directory.]]></short-description> - <description><![CDATA[ - Sets the source directory. - ]]></description> - </attribute> - <attribute name="targets" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the file where targets will be written.]]></short-description> - <description><![CDATA[ - Sets the name of the file where targets will be written. That is the - file that tells iContract what files to process. - ]]></description> - </attribute> - <attribute name="updateicontrol" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, updates iControl properties file.]]></short-description> - <description><![CDATA[ - If true, updates iControl properties file - ]]></description> - </attribute> - <attribute name="verbosity" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Verbosity level of iContract.]]></short-description> - <description><![CDATA[ - Sets the verbosity level of iContract. Any combination of - error*,warning*,note*,info*,progress*,debug* (comma separated) can be - used. Defaults to error*,warning* - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Classpath.]]></short-description> - <description> - <![CDATA[Sets the classpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="ilasm" category="other" - classname="org.apache.tools.ant.taskdefs.optional.dotnet.Ilasm" - matchingTask="true"> - - <short-description><![CDATA[Assembles .NET Intermediate Language files.]]></short-description> - <description> - <![CDATA[Assembles .NET Intermediate Language files. The task will only work - on win2K until other platforms support csc.exe or an equivalent. ilasm.exe - must be on the execute path too. <p> - - <p> - - All parameters are optional: <il/> should suffice to produce a debug - build of all *.il files. The option set is roughly compatible with the - CSharp class; even though the command line options are only vaguely - equivalent. [The low level commands take things like /OUT=file, csc wants - /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] - It would be nice if someone made all the command line tools consistent (and - not as brittle as the java cmdline tools) <p> - - The task is a directory based task, so attributes like <b>includes="*.il" - </b> and <b>excludes="broken.il"</b> can be used to control the files pulled - in. Each file is built on its own, producing an appropriately named output - file unless manually specified with <b>outfile</b>]]> - </description> - - <structure> - - <attributes> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Debug flag on or off.]]></short-description> - <description><![CDATA[ - set the debug flag on or off. - ]]></description> - </attribute> - <attribute name="extraoptions" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Any extra options which are not explicitly - supported by this task.]]></short-description> - <description><![CDATA[ - Any extra options which are not explicitly - supported by this task. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, fails if ilasm tool fails.]]></short-description> - <description><![CDATA[ - If true, fails if ilasm tool fails. - ]]></description> - </attribute> - <attribute name="keyfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The name of a file containing a private key.]]></short-description> - <description><![CDATA[ - the name of a file containing a private key. - ]]></description> - </attribute> - <attribute name="listing" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, produce a listing (off by default).]]></short-description> - <description><![CDATA[ - If true, produce a listing (off by default). - ]]></description> - </attribute> - <attribute name="outputfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output file.]]></short-description> - <description><![CDATA[ - Set the output file. - ]]></description> - </attribute> - <attribute name="resourcefile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of resource file to include.]]></short-description> - <description><![CDATA[ - name of resource file to include. - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source directory containing the files to be compiled.]]></short-description> - <description><![CDATA[ - Set the source directory containing the files to be compiled. - ]]></description> - </attribute> - <attribute name="targettype" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Type of target, either "exe" or "library".]]></short-description> - <description><![CDATA[ - Sets the type of target, either "exe" or "library". - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enable verbose ILASM output.]]></short-description> - <description><![CDATA[ - If true, enable verbose ILASM output. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="input" category="control" - classname="org.apache.tools.ant.taskdefs.Input" - > - - <short-description><![CDATA[Reads an input line from the console.]]></short-description> - <description> - <![CDATA[Reads an input line from the console.]]> - </description> - - <structure> - - <attributes> - <attribute name="addproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Defines the name of a property to be created from input.]]></short-description> - <description><![CDATA[ - Defines the name of a property to be created from input. Behaviour is - according to property task which means that existing properties - cannot be overriden. - ]]></description> - </attribute> - <attribute name="message" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Message which gets displayed to the user during the build run.]]></short-description> - <description><![CDATA[ - Sets the Message which gets displayed to the user during the build run. - ]]></description> - </attribute> - <attribute name="validargs" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Defines valid input parameters as comma separated strings.]]></short-description> - <description><![CDATA[ - Defines valid input parameters as comma separated strings. If set, input - task will reject any input not defined as accepted and requires the user - to reenter it. Validargs are case sensitive. If you want 'a' and 'A' to - be accepted you need to define both values as accepted arguments. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - <body > - <description><![CDATA[ - Set a multiline message. - ]]></description> - </body> - - </structure> - -</task> - - -<task name="iplanet-ejbc" category="ejb" - classname="org.apache.tools.ant.taskdefs.optional.ejb.IPlanetEjbcTask" - > - - <short-description><![CDATA[Compiles EJB stubs and skeletons for the iPlanet Application Server.]]></short-description> - <description> - <![CDATA[Compiles EJB stubs and skeletons for the iPlanet Application Server. - The EJBs to be processed are specified by the EJB 1.1 standard XML - descriptor, and additional attributes are obtained from the iPlanet Application - Server-specific XML descriptor. Since the XML descriptors can include - multiple EJBs, this is a convenient way of specifying many EJBs in a single - Ant task. The following attributes are allowed: - <ul> - <li><i>ejbdescriptor</i> -- Standard EJB 1.1 XML descriptor (typically - titled "ejb-jar.xml"). This attribute is - required. - <li><i>iasdescriptor</i> -- EJB XML descriptor for iPlanet Application - Server (typically titled "ias-ejb-jar.xml). - This attribute is required. - <li><i>dest</i> -- The is the base directory where the RMI stubs and - skeletons are written. In addition, the class files - for each bean (home interface, remote interface, and - EJB implementation) must be found in this directory. - This attribute is required. - <li><i>classpath</i> -- The classpath used when generating EJB stubs and - skeletons. This is an optional attribute (if - omitted, the classpath specified when Ant was - started will be used). Nested "classpath" - elements may also be used. - <li><i>keepgenerated</i> -- Indicates whether or not the Java source - files which are generated by ejbc will be - saved or automatically deleted. If "yes", - the source files will be retained. This is - an optional attribute (if omitted, it - defaults to "no"). - <li><i>debug</i> -- Indicates whether or not the ejbc utility should - log additional debugging statements to the standard - output. If "yes", the additional debugging statements - will be generated (if omitted, it defaults to "no"). - <li><i>iashome</i> -- May be used to specify the "home" directory for - this iPlanet Application Server installation. This - is used to find the ejbc utility if it isn't - included in the user's system path. This is an - optional attribute (if specified, it should refer - to the <code>[install-location]/iplanet/ias6/ias - </code> directory). If omitted, the ejbc utility - must be on the user's system path. - </ul> - <p> - For each EJB specified, this task will locate the three classes that comprise - the EJB. If these class files cannot be located in the <code>dest</code> - directory, the task will fail. The task will also attempt to locate the EJB - stubs and skeletons in this directory. If found, the timestamps on the - stubs and skeletons will be checked to ensure they are up to date. Only if - these files cannot be found or if they are out of date will ejbc be called - to generate new stubs and skeletons.]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when compiling the EJB stubs and skeletons.]]></short-description> - <description><![CDATA[ - Sets the classpath to be used when compiling the EJB stubs and skeletons. - ]]></description> - </attribute> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, debugging output will be generated when ejbc is - executed.]]></short-description> - <description><![CDATA[ - If true, debugging output will be generated when ejbc is - executed. - ]]></description> - </attribute> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory where the EJB source classes must exist - and where the stubs and skeletons will be written.]]></short-description> - <description><![CDATA[ - Sets the destination directory where the EJB source classes must exist - and where the stubs and skeletons will be written. The destination - directory must exist before this task is executed. - ]]></description> - </attribute> - <attribute name="ejbdescriptor" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Location of the standard XML EJB descriptor.]]></short-description> - <description><![CDATA[ - Sets the location of the standard XML EJB descriptor. Typically, this - file is named "ejb-jar.xml". - ]]></description> - </attribute> - <attribute name="iasdescriptor" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Location of the iAS-specific XML EJB descriptor.]]></short-description> - <description><![CDATA[ - Sets the location of the iAS-specific XML EJB descriptor. Typically, - this file is named "ias-ejb-jar.xml". - ]]></description> - </attribute> - <attribute name="iashome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[May be used to specify the "home" directory for this iAS installation.]]></short-description> - <description><![CDATA[ - May be used to specify the "home" directory for this iAS installation. - The directory specified should typically be - <code>[install-location]/iplanet/ias6/ias</code>. - ]]></description> - </attribute> - <attribute name="keepgenerated" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, the Java source files which are generated by ejbc will be saved .]]></short-description> - <description><![CDATA[ - If true, the Java source files which are generated by ejbc will be saved . - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds to the classpath used when compiling the EJB stubs and skeletons.]]></short-description> - <description> - <![CDATA[Adds to the classpath used when compiling the EJB stubs and skeletons.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jar" category="packaging" - classname="org.apache.tools.ant.taskdefs.Jar" - matchingTask="true"> - - <short-description><![CDATA[Creates a JAR archive.]]></short-description> - <description> - <![CDATA[Creates a JAR archive.]]> - </description> - - <structure> - - <attributes> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory from which to archive files; optional.]]></short-description> - <description><![CDATA[ - Directory from which to archive files; optional. - ]]></description> - </attribute> - <attribute name="compress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether we want to compress the files or only store them; - optional, default=true;.]]></short-description> - <description><![CDATA[ - Whether we want to compress the files or only store them; - optional, default=true; - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to create; required.]]></short-description> - <description><![CDATA[ - The file to create; required. - ]]></description> - </attribute> - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" - briefType=""add", "preserve", "fail"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.]]></short-description> - <description><![CDATA[ - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding to use for filenames, defaults to the platform's - default encoding.]]></short-description> - <description><![CDATA[ - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - ]]></description> - </attribute> - <attribute name="filesonly" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.]]></short-description> - <description><![CDATA[ - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - ]]></description> - </attribute> - <attribute name="index" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether or not to create an index list for classes.]]></short-description> - <description><![CDATA[ - Set whether or not to create an index list for classes. - This may speed up classloading in some cases. - ]]></description> - </attribute> - <attribute name="manifest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The manifest file to use.]]></short-description> - <description><![CDATA[ - The manifest file to use. This can be either the location of a manifest, - or the name of a jar added through a fileset. If its the name of an added - jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.MF. - ]]></description> - </attribute> - <attribute name="update" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.]]></short-description> - <description><![CDATA[ - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - ]]></description> - </attribute> - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" - briefType=""fail", "skip", "create"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior of the task when no files match.]]></short-description> - <description><![CDATA[ - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="manifest" type="org.apache.tools.ant.taskdefs.Manifest" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.]]></short-description> - <description> - <![CDATA[Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files.]]></short-description> - <description> - <![CDATA[Adds a set of files.]]> - </description> - </element> - - <element name="metainf" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a zipfileset to include in the META-INF directory.]]></short-description> - <description> - <![CDATA[Adds a zipfileset to include in the META-INF directory.]]> - </description> - </element> - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a group of zip files.]]></short-description> - <description> - <![CDATA[Adds a group of zip files.]]> - </description> - </element> - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]></short-description> - <description> - <![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jarlib-available" category="other" - classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibAvailableTask" - > - - <short-description><![CDATA[Checks whether an extension is present in a fileset or an extensionSet.]]></short-description> - <description> - <![CDATA[Checks whether an extension is present in a fileset or an extensionSet.]]> - </description> - - <structure> - - <attributes> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The JAR library to check.]]></short-description> - <description><![CDATA[ - The JAR library to check. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of property to set if extensions are available.]]></short-description> - <description><![CDATA[ - The name of property to set if extensions are available. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="extension" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionAdapter" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Extension looking for.]]></short-description> - <description> - <![CDATA[Set the Extension looking for.]]> - </description> - </element> - - <element name="extensionset" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionSet" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of extensions to search in.]]></short-description> - <description> - <![CDATA[Adds a set of extensions to search in.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jarlib-display" category="other" - classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibDisplayTask" - > - - <short-description><![CDATA[Displays the "Optional Package" and "Package Specification" information contained within the specified JARs.]]></short-description> - <description> - <![CDATA[Displays the "Optional Package" and "Package Specification" information - contained within the specified JARs. - - <p>Prior to JDK1.3, an "Optional Package" was known as an Extension. - The specification for this mechanism is available in the JDK1.3 - documentation in the directory - $JDK_HOME/docs/guide/extensions/versioning.html. Alternatively it is - available online at <a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> - http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The JAR library to display information for.]]></short-description> - <description><![CDATA[ - The JAR library to display information for. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files about which library data will be displayed.]]></short-description> - <description> - <![CDATA[Adds a set of files about which library data will be displayed.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jarlib-manifest" category="other" - classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibManifestTask" - > - - <short-description><![CDATA[Generates a manifest that declares all the dependencies.]]></short-description> - <description> - <![CDATA[Generates a manifest that declares all the dependencies. - The dependencies are determined by looking in the - specified path and searching for Extension / "Optional Package" - specifications in the manifests of the jars. - - <p>Prior to JDK1.3, an "Optional Package" was known as an Extension. - The specification for this mechanism is available in the JDK1.3 - documentation in the directory - $JDK_HOME/docs/guide/extensions/versioning.html. Alternatively it is - available online at <a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> - http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The location where generated manifest is placed.]]></short-description> - <description><![CDATA[ - The location where generated manifest is placed. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="attribute" type="org.apache.tools.ant.taskdefs.optional.extension.ExtraAttribute" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an attribute that is to be put in main section of manifest.]]></short-description> - <description> - <![CDATA[Adds an attribute that is to be put in main section of manifest.]]> - </description> - </element> - - <element name="depends" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionSet" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of extensions that this library requires.]]></short-description> - <description> - <![CDATA[Adds a set of extensions that this library requires.]]> - </description> - </element> - - <element name="extension" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionAdapter" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an extension that this library implements.]]></short-description> - <description> - <![CDATA[Adds an extension that this library implements.]]> - </description> - </element> - - <element name="options" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionSet" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of extensions that this library optionally requires.]]></short-description> - <description> - <![CDATA[Adds a set of extensions that this library optionally requires.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jarlib-resolve" category="other" - classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibResolveTask" - > - - <short-description><![CDATA[Tries to locate a JAR to satisfy an extension and place location of JAR into property.]]></short-description> - <description> - <![CDATA[Tries to locate a JAR to satisfy an extension and place - location of JAR into property.]]> - </description> - - <structure> - - <attributes> - <attribute name="checkextension" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, libraries returned by nested resolvers should be - checked to see if they supply extension.]]></short-description> - <description><![CDATA[ - If true, libraries returned by nested resolvers should be - checked to see if they supply extension. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, failure to locate library should fail build.]]></short-description> - <description><![CDATA[ - If true, failure to locate library should fail build. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the property in which the location of - library is stored.]]></short-description> - <description><![CDATA[ - The name of the property in which the location of - library is stored. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="ant" type="org.apache.tools.ant.taskdefs.optional.extension.resolvers.AntResolver" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds Ant resolver to run an Ant buildfile to generate a library.]]></short-description> - <description> - <![CDATA[Adds Ant resolver to run an Ant buildfile to generate a library.]]> - </description> - </element> - - <element name="extension" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionAdapter" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Extension looking for.]]></short-description> - <description> - <![CDATA[Set the Extension looking for.]]> - </description> - </element> - - <element name="location" type="org.apache.tools.ant.taskdefs.optional.extension.resolvers.LocationResolver" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds location resolver to look for a library in a location - relative to project directory.]]></short-description> - <description> - <![CDATA[Adds location resolver to look for a library in a location - relative to project directory.]]> - </description> - </element> - - <element name="url" type="org.apache.tools.ant.taskdefs.optional.extension.resolvers.URLResolver" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a URL resolver to download a library from a URL - to a local file.]]></short-description> - <description> - <![CDATA[Adds a URL resolver to download a library from a URL - to a local file.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="java" category="java" - classname="org.apache.tools.ant.taskdefs.Java" - > - - <short-description><![CDATA[Launcher for Java applications.]]></short-description> - <description> - <![CDATA[Launcher for Java applications. Allows use of - the same JVM for the called application thus resulting in much - faster operation.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, append output to existing file.]]></short-description> - <description><![CDATA[ - If true, append output to existing file. - ]]></description> - </attribute> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Java class to execute.]]></short-description> - <description><![CDATA[ - Sets the Java class to execute. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when running the Java class.]]></short-description> - <description><![CDATA[ - Set the classpath to be used when running the Java class - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to use, by reference.]]></short-description> - <description><![CDATA[ - Classpath to use, by reference. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The working directory of the process.]]></short-description> - <description><![CDATA[ - The working directory of the process - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, then fail if the command exits with a - returncode other than 0.]]></short-description> - <description><![CDATA[ - If true, then fail if the command exits with a - returncode other than 0 - ]]></description> - </attribute> - <attribute name="fork" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, execute in a new VM.]]></short-description> - <description><![CDATA[ - If true, execute in a new VM. - ]]></description> - </attribute> - <attribute name="jvmversion" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[JVM version.]]></short-description> - <description><![CDATA[ - Sets the JVM version. - ]]></description> - </attribute> - <attribute name="jar" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The location of the JAR file to execute.]]></short-description> - <description><![CDATA[ - The location of the JAR file to execute. - ]]></description> - </attribute> - <attribute name="jvm" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Command used to start the VM (only if not forking).]]></short-description> - <description><![CDATA[ - Set the command used to start the VM (only if not forking). - ]]></description> - </attribute> - <attribute name="jvmargs" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Command line arguments for the JVM.]]></short-description> - <description><![CDATA[ - Set the command line arguments for the JVM. - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Corresponds to -mx or -Xmx depending on VM version.]]></short-description> - <description><![CDATA[ - Corresponds to -mx or -Xmx depending on VM version. - ]]></description> - </attribute> - <attribute name="newenvironment" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, use a completely new environment.]]></short-description> - <description><![CDATA[ - If true, use a completely new environment. - - <p>Will be ignored if we are not forking a new VM. - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File the output of the process is redirected to.]]></short-description> - <description><![CDATA[ - File the output of the process is redirected to. - ]]></description> - </attribute> - <attribute name="timeout" type="java.lang.Long" - briefType="long" required="NOTDEFINED"> - <short-description><![CDATA[Timeout in milliseconds after which the process will be killed.]]></short-description> - <description><![CDATA[ - Timeout in milliseconds after which the process will be killed. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an environment variable.]]></short-description> - <description> - <![CDATA[Adds an environment variable. - - <p>Will be ignored if we are not forking a new VM.]]> - </description> - </element> - - <element name="sysproperty" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a system property.]]></short-description> - <description> - <![CDATA[Adds a system property.]]> - </description> - </element> - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a command-line argument.]]></short-description> - <description> - <![CDATA[Adds a command-line argument.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to the classpath.]]></short-description> - <description> - <![CDATA[Adds a path to the classpath.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a JVM argument.]]></short-description> - <description> - <![CDATA[Adds a JVM argument.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="javac" category="java" - classname="org.apache.tools.ant.taskdefs.Javac" - matchingTask="true"> - - <!-- javac task --> -<external> -<description> - -<p>Compiles a Java source tree.</p> - -<p>The source and destination directory will be recursively scanned for Java -source files to compile. Only Java files that have no corresponding class file -or where the class file is older than the java file will be compiled.</p> - -<p>Note: Ant uses only the names of the source and class files to find -the classes that need a rebuild. It will not scan the source and therefor -will have no knowledge about nested classes, classes that are named different -from the source file and so on.</p> - -<p>The directory structure of the source tree should follow the package -hierarchy.</p> - -<p>It is possible to refine the set of files that are being compiled/copied. -This can be done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> -attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns.</p> - -<p>It is possible to use different compilers. This can be selected with the -"build.compiler" property or the compiler attribute. Here are the choices:-</p> -<ul> - <li>classic (the standard compiler of JDK 1.1/1.2) - javac1.1 and - javac1.2 can be used as aliases</li> - <li>modern (the standard compiler of JDK 1.3/1.4) - javac1.3 and - javac1.4 can be used as aliases</li> - <li>jikes (the <a - href="http://oss.software.ibm.com/developerworks/opensource/jikes/project" target="_top">Jikes</a> - compiler)</li> - <li>jvc (the Command-Line Compiler from Microsoft's SDK for Java / - Visual J++) - microsoft can be used as an alias</li> - <li>kjc (the <a href="http://www.dms.at/kopi/" target="_top">kopi</a> - compiler)</li> - <li>gcj (the gcj compiler from gcc)</li> - <li>sj (Symantec java compiler) - symantec can be used as an alias</li> - <li>extJavac (run either modern or classic in a JVM of its own)</li> -</ul> -<p>For JDK 1.1/1.2, classic is the default. For JDK 1.3/1.4, modern is the default. -If you wish to use a different compiler interface than those -supplied, write a class that implements the CompilerAdapter interface -(package org.apache.tools.ant.taskdefs.compilers). Supply the full -classname in the "build.compiler" property.</p> - -<p>The fork attribute overrides the build.compiler setting and expects -a JDK1.1 or higher to be set in java.home.</p> - -<p>This task will drop all entries that point to non-existent -files/directories from the CLASSPATH it passes to the compiler.</p> - -<p><strong>Windows Note:</strong>When the modern compiler is used -in unforked mode on Windows, it locks up the files present in the -classpath of the <javac> task, and does not release them. The side -effect of this is that you will not be able to delete or move -those files later on in the build. The workaround is to fork when -invoking the compiler.</p> - -</description> - -<section anchor="examples" name="Examples"> -<pre> <javac srcdir="${src}" - destdir="${build}" - classpath="xyz.jar" - debug="on" - /></pre> -<p>compiles all <code>.java</code> files under the <code>${src}</code> -directory, and stores -the <code>.class</code> files in the <code>${build}</code> directory. -The classpath used contains <code>xyz.jar</code>, and debug information is on.</p> - -<pre> <javac srcdir="${src}" - destdir="${build}" - fork="true" - /></pre> -<p>compiles all <code>.java</code> files under the <code>${src}</code> -directory, and stores the <code>.class</code> files in the -<code>${build}</code> directory. This will fork off the javac -compiler using the default javac executable.</p> - -<pre> <javac srcdir="${src}" - destdir="${build}" - fork="java$$javac.exe" - /></pre> -<p>compiles all <code>.java</code> files under the <code>${src}</code> -directory, and stores the <code>.class</code> files in the -<code>${build}</code> directory. This will fork off the javac -compiler using the executable named <code>java$javac.exe</code>. Note -that the <code>$</code> sign needs to be escaped by a second one.</p> - -<pre> <javac srcdir="${src}" - destdir="${build}" - includes="mypackage/p1/**,mypackage/p2/**" - excludes="mypackage/p1/testpackage/**" - classpath="xyz.jar" - debug="on" - /></pre> -<p>compiles <code>.java</code> files under the <code>${src}</code> -directory, and stores the -<code>.class</code> files in the <code>${build}</code> directory. -The classpath used contains <code>xyz.jar</code>, and debug information is on. -Only files under <code>mypackage/p1</code> and <code>mypackage/p2</code> are -used. Files in the <code>mypackage/p1/testpackage</code> directory are excluded -from compilation.</p> - -<pre> <javac srcdir="${src}:${src2}" - destdir="${build}" - includes="mypackage/p1/**,mypackage/p2/**" - excludes="mypackage/p1/testpackage/**" - classpath="xyz.jar" - debug="on" - /></pre> - -<p>is the same as the previous example, with the addition of a second -source path, defined by -the property <code>src2</code>. This can also be represented using nested -<code><src></code> elements as follows:</p> - -<pre> <javac destdir="${build}" - classpath="xyz.jar" - debug="on"> - <src path="${src}"/> - <src path="${src2}"/> - <include name="mypackage/p1/**"/> - <include name="mypackage/p2/**"/> - <exclude name="mypackage/p1/testpackage/**"/> - </javac></pre> - -<p><b>Note:</b> If you are using Ant on Windows and a new DOS window pops up -for every use of an external compiler, this may be a problem of the JDK you are using. -This problem may occur with all JDKs < 1.2.</p> - -<p><b>Note:</b> If you wish to compile only source-files located in some packages below a -common root you should not include these packages in the srcdir-attribute. Use include/exclude-attributes -or elements to filter for these packages. If you include part of your package-structure inside the srcdir-attribute -(or nested src-elements) Ant will start to recompile your sources every time you call it.</p> - -</section> - -<section anchor="jikes" name="Jikes Notes"> - -<p>Jikes supports some extra options, which can be set be defining -properties prior to invoking the task. The ant developers are aware that -this is ugly and inflexible -expect a better solution in the future. All -the options are boolean, and must be set to "true" or "yes" to be -interpreted as anything other than false; by default -build.compiler.warnings is "true" while all others are "false"</p> - -<table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"> - build.compiler.emacs - </td> - <td valign="top"> - Enable emacs compatible error messages - </td> - </tr> - <tr> - <td valign="top"> - build.compiler.warnings<br /> - <b>This property has been deprecated, use the nowarn attribute - instead</b> - </td> - <td valign="top"> - don't disable warning messages - </td> - </tr> - <tr> - <td valign="top"> - build.compiler.pedantic - </td> - <td valign="top"> - enable pedantic warnings - </td> - </tr> - <tr> - <td valign="top"> - build.compiler.fulldepend - </td> - <td valign="top"> - enable full dependency checking,<br /> - "+F" in the jikes manual. - </td> - </tr> -</table> - -</section> -</external> - - <short-description><![CDATA[Compiles Java source files.]]></short-description> - <description> - <![CDATA[Compiles Java source files. This task can take the following - arguments: - <ul> - <li>sourcedir - <li>destdir - <li>deprecation - <li>classpath - <li>bootclasspath - <li>extdirs - <li>optimize - <li>debug - <li>encoding - <li>target - <li>depend - <li>vebose - <li>failonerror - <li>includeantruntime - <li>includejavaruntime - <li>source - <li>compiler - </ul> - Of these arguments, the <b>sourcedir</b> and <b>destdir</b> are required. - <p> - When this task executes, it will recursively scan the sourcedir and - destdir looking for Java source files to compile. This task makes its - compile decision based on timestamp.]]> - </description> - - <structure> - - <attributes> - <attribute name="bootclasspathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="bootclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Bootclasspath that will be used to compile the classes - against.]]></short-description> - <description><![CDATA[ - Sets the bootclasspath that will be used to compile the classes - against. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="compiler" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Choose the implementation for this particular task.]]></short-description> - <description><![CDATA[ - Choose the implementation for this particular task. - ]]></description> - </attribute> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether source should be compiled - with debug information; defaults to off.]]></short-description> - <description><![CDATA[ - Indicates whether source should be compiled - with debug information; defaults to off. - ]]></description> - </attribute> - <attribute name="debuglevel" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Keyword list to be appended to the -g command-line switch.]]></short-description> - <description><![CDATA[ - Keyword list to be appended to the -g command-line switch. - - This will be ignored by all implementations except modern - and classic(ver >= 1.2). Legal values are none or a - comma-separated list of the following keywords: lines, vars, - and source. If debuglevel is not specified, by default, :none - will be appended to -g. If debug is not turned on, this attribute - will be ignored. - ]]></description> - </attribute> - <attribute name="depend" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Enables dependency-tracking for compilers - that support this (jikes and classic).]]></short-description> - <description><![CDATA[ - Enables dependency-tracking for compilers - that support this (jikes and classic). - ]]></description> - </attribute> - <attribute name="deprecation" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether source should be - compiled with deprecation information; defaults to off.]]></short-description> - <description><![CDATA[ - Indicates whether source should be - compiled with deprecation information; defaults to off. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory into which the Java source - files should be compiled.]]></short-description> - <description><![CDATA[ - Set the destination directory into which the Java source - files should be compiled. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Java source file encoding name.]]></short-description> - <description><![CDATA[ - Set the Java source file encoding name. - ]]></description> - </attribute> - <attribute name="executable" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the javac executable.]]></short-description> - <description><![CDATA[ - Sets the the name of the javac executable. - - <p>Ignored unless fork is true or extJavac has been specified - as the compiler.</p> - ]]></description> - </attribute> - <attribute name="extdirs" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Extension directories that will be used during the - compilation.]]></short-description> - <description><![CDATA[ - Sets the extension directories that will be used during the - compilation. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether the build will continue - even if there are compilation errors; defaults to true.]]></short-description> - <description><![CDATA[ - Indicates whether the build will continue - even if there are compilation errors; defaults to true. - ]]></description> - </attribute> - <attribute name="fork" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, forks the javac compiler.]]></short-description> - <description><![CDATA[ - If true, forks the javac compiler. - ]]></description> - </attribute> - <attribute name="includeantruntime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, includes Ant's own classpath in the classpath.]]></short-description> - <description><![CDATA[ - If true, includes Ant's own classpath in the classpath. - ]]></description> - </attribute> - <attribute name="includejavaruntime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, includes the Java runtime libraries in the classpath.]]></short-description> - <description><![CDATA[ - If true, includes the Java runtime libraries in the classpath. - ]]></description> - </attribute> - <attribute name="listfiles" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, list the source files being handed off to the compiler.]]></short-description> - <description><![CDATA[ - If true, list the source files being handed off to the compiler. - ]]></description> - </attribute> - <attribute name="memoryinitialsize" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The initial size of the memory for the underlying VM - if javac is run externally; ignored otherwise.]]></short-description> - <description><![CDATA[ - The initial size of the memory for the underlying VM - if javac is run externally; ignored otherwise. - Defaults to the standard VM memory setting. - (Examples: 83886080, 81920k, or 80m) - ]]></description> - </attribute> - <attribute name="memorymaximumsize" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The maximum size of the memory for the underlying VM - if javac is run externally; ignored otherwise.]]></short-description> - <description><![CDATA[ - The maximum size of the memory for the underlying VM - if javac is run externally; ignored otherwise. - Defaults to the standard VM memory setting. - (Examples: 83886080, 81920k, or 80m) - ]]></description> - </attribute> - <attribute name="nowarn" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables the -nowarn option.]]></short-description> - <description><![CDATA[ - If true, enables the -nowarn option. - ]]></description> - </attribute> - <attribute name="optimize" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, compiles with optimization enabled.]]></short-description> - <description><![CDATA[ - If true, compiles with optimization enabled. - ]]></description> - </attribute> - <attribute name="source" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Value of the -source command-line switch; will be ignored - by all implementations except modern and jikes.]]></short-description> - <description><![CDATA[ - Value of the -source command-line switch; will be ignored - by all implementations except modern and jikes. - - If you use this attribute together with jikes, you must - make sure that your version of jikes supports the -source switch. - Legal values are 1.3 and 1.4 - by default, no -source argument - will be used at all. - ]]></description> - </attribute> - <attribute name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Sourcepath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the sourcepath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="sourcepathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a source path defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a source path defined elsewhere. - ]]></description> - </attribute> - <attribute name="srcdir" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Source directories to find the source Java files.]]></short-description> - <description><![CDATA[ - Set the source directories to find the source Java files. - ]]></description> - </attribute> - <attribute name="target" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Target VM that the classes will be compiled for.]]></short-description> - <description><![CDATA[ - Sets the target VM that the classes will be compiled for. Valid - strings are "1.1", "1.2", and "1.3". - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, asks the compiler for verbose output.]]></short-description> - <description><![CDATA[ - If true, asks the compiler for verbose output. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="bootclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to the bootclasspath.]]></short-description> - <description> - <![CDATA[Adds a path to the bootclasspath.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to the classpath.]]></short-description> - <description> - <![CDATA[Adds a path to the classpath.]]> - </description> - </element> - - <element name="compilerarg" type="org.apache.tools.ant.taskdefs.Javac.ImplementationSpecificArgument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an implementation specific command-line argument.]]></short-description> - <description> - <![CDATA[Adds an implementation specific command-line argument.]]> - </description> - </element> - - <element name="extdirs" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to extdirs.]]></short-description> - <description> - <![CDATA[Adds a path to extdirs.]]> - </description> - </element> - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to sourcepath.]]></short-description> - <description> - <![CDATA[Adds a path to sourcepath.]]> - </description> - </element> - - <element name="src" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path for source compilation.]]></short-description> - <description> - <![CDATA[Adds a path for source compilation.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="javacc" category="other" - classname="org.apache.tools.ant.taskdefs.optional.javacc.JavaCC" - > - - <short-description><![CDATA[JavaCC compiler compiler task.]]></short-description> - <description> - <![CDATA[JavaCC compiler compiler task.]]> - </description> - - <structure> - - <attributes> - <attribute name="buildparser" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[BUILD_PARSER grammar option.]]></short-description> - <description><![CDATA[ - Sets the BUILD_PARSER grammar option. - ]]></description> - </attribute> - <attribute name="buildtokenmanager" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[BUILD_TOKEN_MANAGER grammar option.]]></short-description> - <description><![CDATA[ - Sets the BUILD_TOKEN_MANAGER grammar option. - ]]></description> - </attribute> - <attribute name="cachetokens" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[CACHE_TOKENS grammar option.]]></short-description> - <description><![CDATA[ - Sets the CACHE_TOKENS grammar option. - ]]></description> - </attribute> - <attribute name="choiceambiguitycheck" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[CHOICE_AMBIGUITY_CHECK grammar option.]]></short-description> - <description><![CDATA[ - Sets the CHOICE_AMBIGUITY_CHECK grammar option. - ]]></description> - </attribute> - <attribute name="commontokenaction" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[COMMON_TOKEN_ACTION grammar option.]]></short-description> - <description><![CDATA[ - Sets the COMMON_TOKEN_ACTION grammar option. - ]]></description> - </attribute> - <attribute name="debuglookahead" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[DEBUG_LOOKAHEAD grammar option.]]></short-description> - <description><![CDATA[ - Sets the DEBUG_LOOKAHEAD grammar option. - ]]></description> - </attribute> - <attribute name="debugparser" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[DEBUG_PARSER grammar option.]]></short-description> - <description><![CDATA[ - Sets the DEBUG_PARSER grammar option. - ]]></description> - </attribute> - <attribute name="debugtokenmanager" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[DEBUG_TOKEN_MANAGER grammar option.]]></short-description> - <description><![CDATA[ - Sets the DEBUG_TOKEN_MANAGER grammar option. - ]]></description> - </attribute> - <attribute name="errorreporting" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[ERROR_REPORTING grammar option.]]></short-description> - <description><![CDATA[ - Sets the ERROR_REPORTING grammar option. - ]]></description> - </attribute> - <attribute name="forcelacheck" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[FORCE_LA_CHECK grammar option.]]></short-description> - <description><![CDATA[ - Sets the FORCE_LA_CHECK grammar option. - ]]></description> - </attribute> - <attribute name="ignorecase" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[IGNORE_CASE grammar option.]]></short-description> - <description><![CDATA[ - Sets the IGNORE_CASE grammar option. - ]]></description> - </attribute> - <attribute name="javacchome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory containing the JavaCC distribution.]]></short-description> - <description><![CDATA[ - The directory containing the JavaCC distribution. - ]]></description> - </attribute> - <attribute name="javaunicodeescape" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[JAVA_UNICODE_ESCAPE grammar option.]]></short-description> - <description><![CDATA[ - Sets the JAVA_UNICODE_ESCAPE grammar option. - ]]></description> - </attribute> - <attribute name="lookahead" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[LOOKAHEAD grammar option.]]></short-description> - <description><![CDATA[ - Sets the LOOKAHEAD grammar option. - ]]></description> - </attribute> - <attribute name="optimizetokenmanager" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[OPTIMIZE_TOKEN_MANAGER grammar option.]]></short-description> - <description><![CDATA[ - Sets the OPTIMIZE_TOKEN_MANAGER grammar option. - ]]></description> - </attribute> - <attribute name="otherambiguitycheck" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[OTHER_AMBIGUITY_CHECK grammar option.]]></short-description> - <description><![CDATA[ - Sets the OTHER_AMBIGUITY_CHECK grammar option. - ]]></description> - </attribute> - <attribute name="outputdirectory" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to write the generated files to.]]></short-description> - <description><![CDATA[ - The directory to write the generated files to. - If not set, the files are written to the directory - containing the grammar file. - ]]></description> - </attribute> - <attribute name="sanitycheck" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[SANITY_CHECK grammar option.]]></short-description> - <description><![CDATA[ - Sets the SANITY_CHECK grammar option. - ]]></description> - </attribute> - <attribute name="static" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[STATIC grammar option.]]></short-description> - <description><![CDATA[ - Sets the STATIC grammar option. - ]]></description> - </attribute> - <attribute name="target" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The grammar file to process.]]></short-description> - <description><![CDATA[ - The grammar file to process. - ]]></description> - </attribute> - <attribute name="unicodeinput" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[UNICODE_INPUT grammar option.]]></short-description> - <description><![CDATA[ - Sets the UNICODE_INPUT grammar option. - ]]></description> - </attribute> - <attribute name="usercharstream" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[USER_CHAR_STREAM grammar option.]]></short-description> - <description><![CDATA[ - Sets the USER_CHAR_STREAM grammar option. - ]]></description> - </attribute> - <attribute name="usertokenmanager" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[USER_TOKEN_MANAGER grammar option.]]></short-description> - <description><![CDATA[ - Sets the USER_TOKEN_MANAGER grammar option. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="javadoc" category="java" - classname="org.apache.tools.ant.taskdefs.Javadoc" - > - - <!-- javadoc task --> -<external> -<description> - -<p>Generates code documentation using the javadoc tool.</p> - -<p>The source directory will be recursively scanned for Java source files to process -but only those matching the inclusion rules, and not matching the exclusions rules -will be passed to the javadoc tool. This -allows wildcards to be used to choose between package names, reducing verbosity -and management costs over time. This task, however, has no notion of -"changed" files, unlike the <a href="javac.html">javac</a> task. This means -all packages will be processed each time this task is run. In general, however, -this task is used much less frequently.</p> - -<p>This task works seamlessly between different javadoc versions (1.1 and 1.2), -with the obvious restriction that the 1.2 attributes will be ignored if run in a -1.1 VM.</p> - -<p>NOTE: since javadoc calls System.exit(), javadoc cannot be run inside the -same VM as ant without breaking functionality. For this reason, this task -always forks the VM. This overhead is not significant since javadoc is normally a heavy -application and will be called infrequently.</p> - -<p>NOTE: the packagelist attribute allows you to specify the list of packages to -document outside of the Ant file. It's a much better practice to include everything -inside the build.xml file. This option was added in order to make it easier to -migrate from regular makefiles, where you would use this option of javadoc. -The packages listed in packagelist are not checked, so the task performs even -if some packages are missing or broken. Use this option if you wish to convert from -an existing makefile. Once things are running you should then switch to the regular -notation. </p> - -<p><i><b>DEPRECATION:</b> the javadoc2 task simply points to the javadoc task and it's -there for back compatibility reasons. Since this task will be removed in future -versions, you are strongly encouraged to use <a href="javadoc.html">javadoc</a> -instead.</i></p> -</description> - -<section anchor="examples" name="Example"> -<pre> <javadoc packagenames="com.dummy.test.*" - sourcepath="src" - excludepackagenames="com.dummy.test.doc-files.*" - defaultexcludes="yes" - destdir="docs/api" - author="true" - version="true" - use="true" - windowtitle="Test API"> - <doctitle><![CDATA[<h1>Test</h1>]]></doctitle> - <bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom> - <tag name="todo" scope="all" description="To do:" /> - <group title="Group 1 Packages" packages="com.dummy.test.a*"/> - <group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> - <link offline="true" href="http://java.sun.com/products/jdk/1.2/docs/api/" packagelistLoc="C:\tmp"/> - <link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> - </javadoc></pre> -</section> -</external> - - <short-description><![CDATA[Generates Javadoc documentation for a collection of source code.]]></short-description> - <description> - <![CDATA[Generates Javadoc documentation for a collection - of source code. - - <P>Current known limitations are: - - <P><UL> - <LI>patterns must be of the form "xxx.*", every other pattern doesn't - work. - <LI>there is no control on arguments sanity since they are left - to the javadoc implementation. - <LI>argument J in javadoc1 is not supported (what is that for anyway?) - </UL> - - <P>If no <CODE>doclet</CODE> is set, then the <CODE>version</CODE> and - <CODE>author</CODE> are by default <CODE>"yes"</CODE>. - - <P>Note: This task is run on another VM because the Javadoc code calls - <CODE>System.exit()</CODE> which would break Ant functionality.]]> - </description> - - <structure> - - <attributes> - <attribute name="access" type="org.apache.tools.ant.taskdefs.Javadoc.AccessType" - briefType=""protected", "public", "package", "private"" required="NOTDEFINED"> - <short-description><![CDATA[Scope to be processed.]]></short-description> - <description><![CDATA[ - Set the scope to be processed. This is an alternative to the - use of the setPublic, setPrivate, etc methods. It gives better build - file control over what scope is processed. - ]]></description> - </attribute> - <attribute name="additionalparam" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set an additional parameter on the command line.]]></short-description> - <description><![CDATA[ - Set an additional parameter on the command line - ]]></description> - </attribute> - <attribute name="author" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Include the author tag in the generated documentation.]]></short-description> - <description><![CDATA[ - Include the author tag in the generated documentation. - ]]></description> - </attribute> - <attribute name="bootclasspathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a CLASSPATH defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a CLASSPATH defined elsewhere. - ]]></description> - </attribute> - <attribute name="bootclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Boot classpath to use.]]></short-description> - <description><![CDATA[ - Set the boot classpath to use. - ]]></description> - </attribute> - <attribute name="bottom" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Text to be placed at the bottom of each output file.]]></short-description> - <description><![CDATA[ - Set the text to be placed at the bottom of each output file. - ]]></description> - </attribute> - <attribute name="charset" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Charset for cross-platform viewing of generated documentation.]]></short-description> - <description><![CDATA[ - Charset for cross-platform viewing of generated documentation. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this javadoc run.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this javadoc run. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a CLASSPATH defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a CLASSPATH defined elsewhere. - ]]></description> - </attribute> - <attribute name="defaultexcludes" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether default exclusions should be used or not.]]></short-description> - <description><![CDATA[ - Sets whether default exclusions should be used or not. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory where the Javadoc output will be generated.]]></short-description> - <description><![CDATA[ - Set the directory where the Javadoc output will be generated. - ]]></description> - </attribute> - <attribute name="docencoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Output file encoding name.]]></short-description> - <description><![CDATA[ - Output file encoding name. - ]]></description> - </attribute> - <attribute name="doclet" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Class that starts the doclet used in generating the - documentation.]]></short-description> - <description><![CDATA[ - Set the class that starts the doclet used in generating the - documentation. - ]]></description> - </attribute> - <attribute name="docletpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath used to find the doclet class.]]></short-description> - <description><![CDATA[ - Set the classpath used to find the doclet class. - ]]></description> - </attribute> - <attribute name="docletpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Classpath used to find the doclet class by reference.]]></short-description> - <description><![CDATA[ - Set the classpath used to find the doclet class by reference. - ]]></description> - </attribute> - <attribute name="doctitle" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Title of the generated overview page.]]></short-description> - <description><![CDATA[ - Set the title of the generated overview page. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding name of the source files,.]]></short-description> - <description><![CDATA[ - Set the encoding name of the source files, - ]]></description> - </attribute> - <attribute name="excludepackagenames" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[List of packages to be excluded.]]></short-description> - <description><![CDATA[ - Set the list of packages to be excluded. - ]]></description> - </attribute> - <attribute name="extdirs" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Location of the extensions directories.]]></short-description> - <description><![CDATA[ - Set the location of the extensions directories. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Should the build process fail if javadoc fails (as indicated by - a non zero return code)?.]]></short-description> - <description><![CDATA[ - Should the build process fail if javadoc fails (as indicated by - a non zero return code)? - - <p>Default is false.</p> - ]]></description> - </attribute> - <attribute name="footer" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Footer text to be placed at the bottom of each output file.]]></short-description> - <description><![CDATA[ - Set the footer text to be placed at the bottom of each output file. - ]]></description> - </attribute> - <attribute name="group" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Group specified packages together in overview page.]]></short-description> - <description><![CDATA[ - Group specified packages together in overview page. - ]]></description> - </attribute> - <attribute name="header" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Header text to be placed at the top of each output file.]]></short-description> - <description><![CDATA[ - Set the header text to be placed at the top of each output file. - ]]></description> - </attribute> - <attribute name="helpfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the HTML help file to use.]]></short-description> - <description><![CDATA[ - Specifies the HTML help file to use. - ]]></description> - </attribute> - <attribute name="link" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Create links to javadoc output at the given URL.]]></short-description> - <description><![CDATA[ - Create links to javadoc output at the given URL. - ]]></description> - </attribute> - <attribute name="linkoffline" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Link to docs at "url" using package list at "url2" - - separate the URLs by using a space character.]]></short-description> - <description><![CDATA[ - Link to docs at "url" using package list at "url2" - - separate the URLs by using a space character. - ]]></description> - </attribute> - <attribute name="locale" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Local to use in documentation generation.]]></short-description> - <description><![CDATA[ - Set the local to use in documentation generation. - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Maximum memory to be used by the javadoc process.]]></short-description> - <description><![CDATA[ - Set the maximum memory to be used by the javadoc process - ]]></description> - </attribute> - <attribute name="nodeprecated" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do not include @deprecated information.]]></short-description> - <description><![CDATA[ - If true, do not include @deprecated information. - ]]></description> - </attribute> - <attribute name="nodeprecatedlist" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do not generate deprecated list.]]></short-description> - <description><![CDATA[ - If true, do not generate deprecated list. - ]]></description> - </attribute> - <attribute name="nohelp" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do not generate help link.]]></short-description> - <description><![CDATA[ - If true, do not generate help link - ]]></description> - </attribute> - <attribute name="noindex" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do not generate index.]]></short-description> - <description><![CDATA[ - If true, do not generate index. - ]]></description> - </attribute> - <attribute name="nonavbar" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do not generate navigation bar.]]></short-description> - <description><![CDATA[ - If true, do not generate navigation bar. - ]]></description> - </attribute> - <attribute name="notree" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, do not generate class hierarchy.]]></short-description> - <description><![CDATA[ - If true, do not generate class hierarchy. - ]]></description> - </attribute> - <attribute name="old" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicate whether Javadoc should produce old style (JDK 1.1) - documentation.]]></short-description> - <description><![CDATA[ - Indicate whether Javadoc should produce old style (JDK 1.1) - documentation. - - This is not supported by JDK 1.1 and has been phased out in JDK 1.4 - ]]></description> - </attribute> - <attribute name="overview" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Specify the file containing the overview to be included in the generated - documentation.]]></short-description> - <description><![CDATA[ - Specify the file containing the overview to be included in the generated - documentation. - ]]></description> - </attribute> - <attribute name="package" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicate whether only package, protected and public classes and - members are to be included in the scope processed.]]></short-description> - <description><![CDATA[ - Indicate whether only package, protected and public classes and - members are to be included in the scope processed - ]]></description> - </attribute> - <attribute name="packagelist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of a file containing the packages to process.]]></short-description> - <description><![CDATA[ - The name of a file containing the packages to process. - ]]></description> - </attribute> - <attribute name="packagenames" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Package names to be processed.]]></short-description> - <description><![CDATA[ - Set the package names to be processed. - ]]></description> - </attribute> - <attribute name="private" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicate whether all classes and - members are to be included in the scope processed.]]></short-description> - <description><![CDATA[ - Indicate whether all classes and - members are to be included in the scope processed - ]]></description> - </attribute> - <attribute name="protected" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicate whether only protected and public classes and members are to - be included in the scope processed.]]></short-description> - <description><![CDATA[ - Indicate whether only protected and public classes and members are to - be included in the scope processed - ]]></description> - </attribute> - <attribute name="public" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicate whether only public classes and members are to be included in - the scope processed.]]></short-description> - <description><![CDATA[ - Indicate whether only public classes and members are to be included in - the scope processed - ]]></description> - </attribute> - <attribute name="serialwarn" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, generate warning about @serial tag.]]></short-description> - <description><![CDATA[ - If true, generate warning about @serial tag. - ]]></description> - </attribute> - <attribute name="source" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Enables the -source switch, will be ignored if javadoc is not - the 1.4 version or a different doclet than the standard doclet - is used.]]></short-description> - <description><![CDATA[ - Enables the -source switch, will be ignored if javadoc is not - the 1.4 version or a different doclet than the standard doclet - is used. - ]]></description> - </attribute> - <attribute name="sourcefiles" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[List of source files to process.]]></short-description> - <description><![CDATA[ - Set the list of source files to process. - ]]></description> - </attribute> - <attribute name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Specify where to find source file.]]></short-description> - <description><![CDATA[ - Specify where to find source file - ]]></description> - </attribute> - <attribute name="sourcepathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a CLASSPATH defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a CLASSPATH defined elsewhere. - ]]></description> - </attribute> - <attribute name="splitindex" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Generate a split index.]]></short-description> - <description><![CDATA[ - Generate a split index - ]]></description> - </attribute> - <attribute name="stylesheetfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the CSS stylesheet file to use.]]></short-description> - <description><![CDATA[ - Specifies the CSS stylesheet file to use. - ]]></description> - </attribute> - <attribute name="use" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Generate the "use" page for each package.]]></short-description> - <description><![CDATA[ - Generate the "use" page for each package. - ]]></description> - </attribute> - <attribute name="useexternalfile" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Work around command line length limit by using an external file - for the sourcefiles.]]></short-description> - <description><![CDATA[ - Work around command line length limit by using an external file - for the sourcefiles. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Run javadoc in verbose mode.]]></short-description> - <description><![CDATA[ - Run javadoc in verbose mode - ]]></description> - </attribute> - <attribute name="version" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Include the version tag in the generated documentation.]]></short-description> - <description><![CDATA[ - Include the version tag in the generated documentation. - ]]></description> - </attribute> - <attribute name="windowtitle" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Title to be placed in the HTML <title> tag of the - generated documentation.]]></short-description> - <description><![CDATA[ - Set the title to be placed in the HTML <title> tag of the - generated documentation. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="bottom" type="org.apache.tools.ant.taskdefs.Javadoc.Html" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Text to be placed at the bottom of each output file.]]></short-description> - <description> - <![CDATA[Set the text to be placed at the bottom of each output file.]]> - </description> - </element> - - <element name="doctitle" type="org.apache.tools.ant.taskdefs.Javadoc.Html" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a document title to use for the overview page.]]></short-description> - <description> - <![CDATA[Add a document title to use for the overview page.]]> - </description> - </element> - - <element name="excludepackage" type="org.apache.tools.ant.taskdefs.Javadoc.PackageName" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a package to be excluded from the javadoc run.]]></short-description> - <description> - <![CDATA[Add a package to be excluded from the javadoc run.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a fileset.]]></short-description> - <description> - <![CDATA[Adds a fileset. - - <p>All included files will be added as sourcefiles. The task - will automatically add - <code>includes="**/*.java"</code> to the - fileset.</p>]]> - </description> - </element> - - <element name="footer" type="org.apache.tools.ant.taskdefs.Javadoc.Html" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Footer text to be placed at the bottom of each output file.]]></short-description> - <description> - <![CDATA[Set the footer text to be placed at the bottom of each output file.]]> - </description> - </element> - - <element name="header" type="org.apache.tools.ant.taskdefs.Javadoc.Html" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Header text to be placed at the top of each output file.]]></short-description> - <description> - <![CDATA[Set the header text to be placed at the top of each output file.]]> - </description> - </element> - - <element name="package" type="org.apache.tools.ant.taskdefs.Javadoc.PackageName" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a single package to be processed.]]></short-description> - <description> - <![CDATA[Add a single package to be processed. - - If the package name ends with ".*" the Javadoc task - will find and process all subpackages.]]> - </description> - </element> - - <element name="packageset" type="org.apache.tools.ant.types.DirSet" - briefType="Dirset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a packageset.]]></short-description> - <description> - <![CDATA[Adds a packageset. - - <p>All included directories will be translated into package - names be converting the directory separator into dots.</p>]]> - </description> - </element> - - <element name="source" type="org.apache.tools.ant.taskdefs.Javadoc.SourceFile" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a single source file.]]></short-description> - <description> - <![CDATA[Add a single source file.]]> - </description> - </element> - - <element name="taglet" type="org.apache.tools.ant.taskdefs.Javadoc.ExtensionInfo" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a taglet.]]></short-description> - <description> - <![CDATA[Add a taglet]]> - </description> - </element> - - <element name="bootclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create a Path to be configured with the boot classpath.]]></short-description> - <description> - <![CDATA[Create a Path to be configured with the boot classpath]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create a Path to be configured with the classpath to use.]]></short-description> - <description> - <![CDATA[Create a Path to be configured with the classpath to use]]> - </description> - </element> - - <element name="doclet" type="org.apache.tools.ant.taskdefs.Javadoc.DocletInfo" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create a doclet to be used in the documentation generation.]]></short-description> - <description> - <![CDATA[Create a doclet to be used in the documentation generation.]]> - </description> - </element> - - <element name="group" type="org.apache.tools.ant.taskdefs.Javadoc.GroupArgument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Separates packages on the overview page into whatever - groups you specify, one group per table.]]></short-description> - <description> - <![CDATA[Separates packages on the overview page into whatever - groups you specify, one group per table.]]> - </description> - </element> - - <element name="link" type="org.apache.tools.ant.taskdefs.Javadoc.LinkArgument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create link to javadoc output at the given URL.]]></short-description> - <description> - <![CDATA[Create link to javadoc output at the given URL.]]> - </description> - </element> - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create a path to be configured with the locations of the source - files.]]></short-description> - <description> - <![CDATA[Create a path to be configured with the locations of the source - files.]]> - </description> - </element> - - <element name="tag" type="org.apache.tools.ant.taskdefs.Javadoc.TagArgument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Creates and adds a -tag argument.]]></short-description> - <description> - <![CDATA[Creates and adds a -tag argument. This is used to specify - custom tags. This argument is only available for JavaDoc 1.4, - and will generate a verbose message (and then be ignored) - when run on Java versions below 1.4.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="javah" category="other" - classname="org.apache.tools.ant.taskdefs.optional.Javah" - > - - <short-description><![CDATA[Generates JNI header files using javah.]]></short-description> - <description> - <![CDATA[Generates JNI header files using javah. - - This task can take the following arguments: - <ul> - <li>classname - the fully-qualified name of a class</li> - <li>outputFile - Concatenates the resulting header or source files for all - the classes listed into this file</li> - <li>destdir - Sets the directory where javah saves the header files or the - stub files</li> - <li>classpath</li> - <li>bootclasspath</li> - <li>force - Specifies that output files should always be written -(JDK1.2 only)</li> - <li>old - Specifies that old JDK1.0-style header files should be generated - (otherwise output file contain JNI-style native method - function prototypes) (JDK1.2 only)</li> - <li>stubs - generate C declarations from the Java object file (used with old)</li> - <li>verbose - causes javah to print a message to stdout concerning the status - of the generated files</li> - <li>extdirs - Override location of installed extensions</li> - </ul> - Of these arguments, either <b>outputFile</b> or <b>destdir</b> is required, - but not both. More than one classname may be specified, using a comma-separated - list or by using <code><class name="xxx"></code> elements within the task. - <p> - When this task executes, it will generate C header and source files that - are needed to implement native methods.]]> - </description> - - <structure> - - <attributes> - <attribute name="bootclasspathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="bootclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Location of bootstrap class files.]]></short-description> - <description><![CDATA[ - location of bootstrap class files. - ]]></description> - </attribute> - <attribute name="class" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The fully-qualified name of the class (or classes, separated by commas).]]></short-description> - <description><![CDATA[ - the fully-qualified name of the class (or classes, separated by commas). - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[The classpath to use.]]></short-description> - <description><![CDATA[ - the classpath to use. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory into which the Java source - files should be compiled.]]></short-description> - <description><![CDATA[ - Set the destination directory into which the Java source - files should be compiled. - ]]></description> - </attribute> - <attribute name="force" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, output files should always be written (JDK1.2 only).]]></short-description> - <description><![CDATA[ - If true, output files should always be written (JDK1.2 only). - ]]></description> - </attribute> - <attribute name="old" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, specifies that old JDK1.0-style header files should be - generated. - (otherwise output file contain JNI-style native method function prototypes) (JDK1.2 only).]]></short-description> - <description><![CDATA[ - If true, specifies that old JDK1.0-style header files should be - generated. - (otherwise output file contain JNI-style native method function prototypes) (JDK1.2 only) - ]]></description> - </attribute> - <attribute name="outputfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Concatenates the resulting header or source files for all - the classes listed into this file.]]></short-description> - <description><![CDATA[ - Concatenates the resulting header or source files for all - the classes listed into this file. - ]]></description> - </attribute> - <attribute name="stubs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, generate C declarations from the Java object file (used with old).]]></short-description> - <description><![CDATA[ - If true, generate C declarations from the Java object file (used with old). - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, causes Javah to print a message concerning - the status of the generated files.]]></short-description> - <description><![CDATA[ - If true, causes Javah to print a message concerning - the status of the generated files. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="bootclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds path to bootstrap class files.]]></short-description> - <description> - <![CDATA[Adds path to bootstrap class files.]]> - </description> - </element> - - <element name="class" type="org.apache.tools.ant.taskdefs.optional.Javah.ClassArgument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds class to process.]]></short-description> - <description> - <![CDATA[Adds class to process.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Path to use for classpath.]]></short-description> - <description> - <![CDATA[Path to use for classpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jdepend" category="other" - classname="org.apache.tools.ant.taskdefs.optional.jdepend.JDependTask" - > - - <short-description><![CDATA[Runs JDepend tests.]]></short-description> - <description> - <![CDATA[Runs JDepend tests. - - <p>JDepend is a tool to generate design quality metrics for each Java package. - It has been initially created by Mike Clark. JDepend can be found at <a - href="http://www.clarkware.com/software/JDepend.html">http://www.clarkware.com/software/JDepend.html</a>. - - The current implementation spawn a new Java VM.]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to invoke the VM in.]]></short-description> - <description><![CDATA[ - The directory to invoke the VM in. Ignored if no JVM is forked. - ]]></description> - </attribute> - <attribute name="fork" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, forks into a new JVM.]]></short-description> - <description><![CDATA[ - If true, forks into a new JVM. Default: false. - ]]></description> - </attribute> - <attribute name="format" type="org.apache.tools.ant.taskdefs.optional.jdepend.JDependTask.FormatAttribute" - briefType=""xml", "text"" required="NOTDEFINED"> - <short-description><![CDATA[The format to write the output in, "xml" or "text".]]></short-description> - <description><![CDATA[ - The format to write the output in, "xml" or "text". - ]]></description> - </attribute> - <attribute name="haltonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether or not to halt on failure.]]></short-description> - <description><![CDATA[ - Whether or not to halt on failure. Default: false. - ]]></description> - </attribute> - <attribute name="jvm" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The command used to invoke a forked Java Virtual Machine.]]></short-description> - <description><![CDATA[ - The command used to invoke a forked Java Virtual Machine. - - Default is <tt>java</tt>. Ignored if no JVM is forked. - ]]></description> - </attribute> - <attribute name="outputfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The output file name.]]></short-description> - <description><![CDATA[ - The output file name. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to the classpath.]]></short-description> - <description> - <![CDATA[Adds a path to the classpath.]]> - </description> - </element> - - <element name="sourcespath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to source code to analyze.]]></short-description> - <description> - <![CDATA[Adds a path to source code to analyze.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jjtree" category="other" - classname="org.apache.tools.ant.taskdefs.optional.javacc.JJTree" - > - - <short-description><![CDATA[Runs the JJTree compiler compiler.]]></short-description> - <description> - <![CDATA[Runs the JJTree compiler compiler.]]> - </description> - - <structure> - - <attributes> - <attribute name="buildnodefiles" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[BUILD_NODE_FILES grammar option.]]></short-description> - <description><![CDATA[ - Sets the BUILD_NODE_FILES grammar option. - ]]></description> - </attribute> - <attribute name="javacchome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory containing the JavaCC distribution.]]></short-description> - <description><![CDATA[ - The directory containing the JavaCC distribution. - ]]></description> - </attribute> - <attribute name="multi" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[MULTI grammar option.]]></short-description> - <description><![CDATA[ - Sets the MULTI grammar option. - ]]></description> - </attribute> - <attribute name="nodedefaultvoid" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[NODE_DEFAULT_VOID grammar option.]]></short-description> - <description><![CDATA[ - Sets the NODE_DEFAULT_VOID grammar option. - ]]></description> - </attribute> - <attribute name="nodefactory" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[NODE_FACTORY grammar option.]]></short-description> - <description><![CDATA[ - Sets the NODE_FACTORY grammar option. - ]]></description> - </attribute> - <attribute name="nodepackage" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[NODE_PACKAGE grammar option.]]></short-description> - <description><![CDATA[ - Sets the NODE_PACKAGE grammar option. - ]]></description> - </attribute> - <attribute name="nodeprefix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[NODE_PREFIX grammar option.]]></short-description> - <description><![CDATA[ - Sets the NODE_PREFIX grammar option. - ]]></description> - </attribute> - <attribute name="nodescopehook" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[NODE_SCOPE_HOOK grammar option.]]></short-description> - <description><![CDATA[ - Sets the NODE_SCOPE_HOOK grammar option. - ]]></description> - </attribute> - <attribute name="nodeusesparser" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[NODE_USES_PARSER grammar option.]]></short-description> - <description><![CDATA[ - Sets the NODE_USES_PARSER grammar option. - ]]></description> - </attribute> - <attribute name="outputdirectory" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to write the generated file to.]]></short-description> - <description><![CDATA[ - The directory to write the generated file to. - If not set, the files are written to the directory - containing the grammar file. - ]]></description> - </attribute> - <attribute name="static" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[STATIC grammar option.]]></short-description> - <description><![CDATA[ - Sets the STATIC grammar option. - ]]></description> - </attribute> - <attribute name="target" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The jjtree grammar file to process.]]></short-description> - <description><![CDATA[ - The jjtree grammar file to process. - ]]></description> - </attribute> - <attribute name="visitor" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[VISITOR grammar option.]]></short-description> - <description><![CDATA[ - Sets the VISITOR grammar option. - ]]></description> - </attribute> - <attribute name="visitorexception" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[VISITOR_EXCEPTION grammar option.]]></short-description> - <description><![CDATA[ - Sets the VISITOR_EXCEPTION grammar option. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="jpcoverage" category="metrics" - classname="org.apache.tools.ant.taskdefs.optional.sitraka.Coverage" - > - - <short-description><![CDATA[Runs Sitraka JProbe Coverage.]]></short-description> - <description> - <![CDATA[Runs Sitraka JProbe Coverage. - - Options are pretty numerous, you'd better check the manual for a full - descriptions of options. (not that simple since they differ from the online - help, from the usage command line and from the examples...) - <p> - For additional information, visit <a href="http://www.sitraka.com">www.sitraka.com</a>]]> - </description> - - <structure> - - <attributes> - <attribute name="applet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, run an applet.]]></short-description> - <description><![CDATA[ - If true, run an applet. - ]]></description> - </attribute> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Classname to run as standalone or runner for filesets.]]></short-description> - <description><![CDATA[ - classname to run as standalone or runner for filesets. - ]]></description> - </attribute> - <attribute name="exitprompt" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Toggles display of the console prompt: always, error, never.]]></short-description> - <description><![CDATA[ - Toggles display of the console prompt: always, error, never - ]]></description> - </attribute> - <attribute name="finalsnapshot" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Type of snapshot to send at program termination: none, coverage, all.]]></short-description> - <description><![CDATA[ - Type of snapshot to send at program termination: none, coverage, all. - Can be null, default to none - ]]></description> - </attribute> - <attribute name="home" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory where JProbe is installed.]]></short-description> - <description><![CDATA[ - The directory where JProbe is installed. - ]]></description> - </attribute> - <attribute name="javaexe" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to the java executable.]]></short-description> - <description><![CDATA[ - Path to the java executable. - ]]></description> - </attribute> - <attribute name="recordfromstart" type="org.apache.tools.ant.taskdefs.optional.sitraka.Coverage.Recordfromstart" - briefType=""coverage", "none", "all"" required="NOTDEFINED"> - <short-description><![CDATA["all", "coverage", or "none".]]></short-description> - <description><![CDATA[ - "all", "coverage", or "none". - ]]></description> - </attribute> - <attribute name="seedname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Seed name for snapshot file.]]></short-description> - <description><![CDATA[ - seed name for snapshot file. Can be null, default to snap - ]]></description> - </attribute> - <attribute name="snapshotdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The path to the directory where snapshot files are stored.]]></short-description> - <description><![CDATA[ - The path to the directory where snapshot files are stored. - Choose a directory that is reachable by both the remote - and local computers, and enter the same path on the command-line - and in the viewer. - ]]></description> - </attribute> - <attribute name="tracknatives" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, track native methods.]]></short-description> - <description><![CDATA[ - If true, track native methods. - ]]></description> - </attribute> - <attribute name="vm" type="org.apache.tools.ant.taskdefs.optional.sitraka.Coverage.Javavm" - briefType=""java2", "jdk118", "jdk117"" required="NOTDEFINED"> - <short-description><![CDATA[Indicates which virtual machine to run: "jdk117", "jdk118" or "java2".]]></short-description> - <description><![CDATA[ - Indicates which virtual machine to run: "jdk117", "jdk118" or "java2". - Can be null, default to "java2". - ]]></description> - </attribute> - <attribute name="warnlevel" type="java.lang.Integer" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Set warning level (0-3, where 0 is the least amount of warnings).]]></short-description> - <description><![CDATA[ - Set warning level (0-3, where 0 is the least amount of warnings). - ]]></description> - </attribute> - <attribute name="workingdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The physical path to the working directory for the VM.]]></short-description> - <description><![CDATA[ - The physical path to the working directory for the VM. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[The classnames to execute.]]></short-description> - <description> - <![CDATA[the classnames to execute.]]> - </description> - </element> - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a command argument.]]></short-description> - <description> - <![CDATA[Adds a command argument.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Classpath to run the files.]]></short-description> - <description> - <![CDATA[classpath to run the files.]]> - </description> - </element> - - <element name="filters" type="org.apache.tools.ant.taskdefs.optional.sitraka.Filters" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Defines class/method filters based on pattern matching.]]></short-description> - <description> - <![CDATA[Defines class/method filters based on pattern matching. - The syntax is filters is similar to a fileset.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a JVM argument.]]></short-description> - <description> - <![CDATA[Adds a JVM argument.]]> - </description> - </element> - - <element name="socket" type="org.apache.tools.ant.taskdefs.optional.sitraka.Socket" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Define a host and port to connect to if you want to do - remote viewing.]]></short-description> - <description> - <![CDATA[Define a host and port to connect to if you want to do - remote viewing.]]> - </description> - </element> - - <element name="triggers" type="org.apache.tools.ant.taskdefs.optional.sitraka.Triggers" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Defines events to use for interacting with the - collection of data performed during coverage.]]></short-description> - <description> - <![CDATA[Defines events to use for interacting with the - collection of data performed during coverage. - - For example you may run a whole application but only decide - to collect data once it reaches a certain method and once it - exits another one.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jpcovmerge" category="metrics" - classname="org.apache.tools.ant.taskdefs.optional.sitraka.CovMerge" - > - - <short-description><![CDATA[Runs the snapshot merge utility for JProbe Coverage.]]></short-description> - <description> - <![CDATA[Runs the snapshot merge utility for JProbe Coverage.]]> - </description> - - <structure> - - <attributes> - <attribute name="home" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory where JProbe is installed.]]></short-description> - <description><![CDATA[ - The directory where JProbe is installed. - ]]></description> - </attribute> - <attribute name="tofile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output snapshot file.]]></short-description> - <description><![CDATA[ - Set the output snapshot file. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, perform the merge in verbose mode giving details - about the snapshot processing.]]></short-description> - <description><![CDATA[ - If true, perform the merge in verbose mode giving details - about the snapshot processing. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a fileset containing the snapshots to include.]]></short-description> - <description> - <![CDATA[add a fileset containing the snapshots to include.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jpcovreport" category="metrics" - classname="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport" - > - - <short-description><![CDATA[Runs the JProbe Coverage 3.0 snapshot merge utility.]]></short-description> - <description> - <![CDATA[Runs the JProbe Coverage 3.0 snapshot merge utility.]]> - </description> - - <structure> - - <attributes> - <attribute name="format" type="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport.ReportFormat" - briefType=""html", "text", "xml"" required="NOTDEFINED"> - <short-description><![CDATA[Format of the report: "html", "text", or "xml".]]></short-description> - <description><![CDATA[ - set the format of the report: "html", "text", or "xml" - ]]></description> - </attribute> - <attribute name="home" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory where JProbe is installed.]]></short-description> - <description><![CDATA[ - The directory where JProbe is installed. - ]]></description> - </attribute> - <attribute name="includesource" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, include text of the source code lines.]]></short-description> - <description><![CDATA[ - If true, include text of the source code lines. - Only applies to format="xml" and type="verydetailed" - ]]></description> - </attribute> - <attribute name="percent" type="java.lang.Integer" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[A numeric value for the threshold for printing methods.]]></short-description> - <description><![CDATA[ - A numeric value for the threshold for printing methods. - Must be between 0 and 100. - ]]></description> - </attribute> - <attribute name="snapshot" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The name of the snapshot file that is the source to the report.]]></short-description> - <description><![CDATA[ - The name of the snapshot file that is the source to the report. - ]]></description> - </attribute> - <attribute name="tofile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The name of the generated output file.]]></short-description> - <description><![CDATA[ - The name of the generated output file. - ]]></description> - </attribute> - <attribute name="type" type="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport.ReportType" - briefType=""executive", "summary", "detailed", "verydetailed"" required="NOTDEFINED"> - <short-description><![CDATA[The type of report to be generated: "executive", "summary", - "detailed" or "verydetailed".]]></short-description> - <description><![CDATA[ - The type of report to be generated: "executive", "summary", - "detailed" or "verydetailed". - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="reference" type="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport.Reference" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of classes whose coverage information will be - checked against.]]></short-description> - <description> - <![CDATA[Adds a set of classes whose coverage information will be - checked against.]]> - </description> - </element> - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to source files.]]></short-description> - <description> - <![CDATA[Adds a path to source files.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="jspc" category="other" - classname="org.apache.tools.ant.taskdefs.optional.jsp.JspC" - matchingTask="true"> - - <short-description><![CDATA[Runs a JSP compiler.]]></short-description> - <description> - <![CDATA[Runs a JSP compiler. - - <p> This task takes the given jsp files and compiles them into java - files. It is then up to the user to compile the java files into classes. - - <p> The task requires the srcdir and destdir attributes to be - set. This Task is a MatchingTask, so the files to be compiled can be - specified using includes/excludes attributes or nested include/exclude - elements. Optional attributes are verbose (set the verbosity level passed - to jasper), package (name of the destination package for generated java - classes and classpath (the classpath to use when running the jsp - compiler). - <p> This task supports the nested elements classpath (A Path) and - classpathref (A Reference) which can be used in preference to the - attribute classpath, if the jsp compiler is not already in the ant - classpath. - - <p><h4>Usage</h4> - <pre> - <jspc srcdir="${basedir}/src/war" - destdir="${basedir}/gensrc" - package="com.i3sp.jsp" - verbose="9"> - <include name="**\/*.jsp" /> - </jspc> - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a classpath defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a classpath defined elsewhere - ]]></description> - </attribute> - <attribute name="compiler" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Class name of a JSP compiler adapter.]]></short-description> - <description><![CDATA[ - Class name of a JSP compiler adapter. - ]]></description> - </attribute> - <attribute name="compilerclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used to find this compiler adapter.]]></short-description> - <description><![CDATA[ - Set the classpath to be used to find this compiler adapter - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory into which the JSP source - files should be compiled.]]></short-description> - <description><![CDATA[ - Set the destination directory into which the JSP source - files should be compiled. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether or not the build should halt if compilation fails.]]></short-description> - <description><![CDATA[ - Whether or not the build should halt if compilation fails. - Defaults to <code>true</code>. - ]]></description> - </attribute> - <attribute name="ieplugin" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Java Plugin CLASSID for Internet Explorer.]]></short-description> - <description><![CDATA[ - Java Plugin CLASSID for Internet Explorer - ]]></description> - </attribute> - <attribute name="mapped" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, generate separate write() calls for each HTML line - in the JSP.]]></short-description> - <description><![CDATA[ - If true, generate separate write() calls for each HTML line - in the JSP. - ]]></description> - </attribute> - <attribute name="package" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the package the compiled jsp files should be in.]]></short-description> - <description><![CDATA[ - Set the name of the package the compiled jsp files should be in. - ]]></description> - </attribute> - <attribute name="srcdir" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Path for source JSP files.]]></short-description> - <description><![CDATA[ - Path for source JSP files. - ]]></description> - </attribute> - <attribute name="uribase" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The URI context of relative URI references in the JSP pages.]]></short-description> - <description><![CDATA[ - The URI context of relative URI references in the JSP pages. - If it does not exist then it is derived from the location - of the file relative to the declared or derived value of uriroot. - ]]></description> - </attribute> - <attribute name="uriroot" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The root directory that uri files should be resolved - against.]]></short-description> - <description><![CDATA[ - The root directory that uri files should be resolved - against. (Default is the directory jspc is invoked from) - ]]></description> - </attribute> - <attribute name="verbose" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Verbose level of the compiler.]]></short-description> - <description><![CDATA[ - Set the verbose level of the compiler - ]]></description> - </attribute> - <attribute name="webinc" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output filename for the fraction of web.xml that lists - servlets.]]></short-description> - <description><![CDATA[ - output filename for the fraction of web.xml that lists - servlets. - ]]></description> - </attribute> - <attribute name="webxml" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Filename for web.xml.]]></short-description> - <description><![CDATA[ - Filename for web.xml. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="webapp" type="org.apache.tools.ant.taskdefs.optional.jsp.JspC.WebAppParameter" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a single webapp.]]></short-description> - <description> - <![CDATA[Adds a single webapp.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to the classpath.]]></short-description> - <description> - <![CDATA[Adds a path to the classpath.]]> - </description> - </element> - - <element name="compilerclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Support nested compiler classpath, used to locate compiler adapter.]]></short-description> - <description> - <![CDATA[Support nested compiler classpath, used to locate compiler adapter]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="junit" category="other" - classname="org.apache.tools.ant.taskdefs.optional.junit.JUnitTask" - > - - <short-description><![CDATA[Runs JUnit tests.]]></short-description> - <description> - <![CDATA[Runs JUnit tests. - - <p> JUnit is a framework to create unit test. It has been initially - created by Erich Gamma and Kent Beck. JUnit can be found at <a - href="http://www.junit.org">http://www.junit.org</a>. - - <p> <code>JUnitTask</code> can run a single specific - <code>JUnitTest</code> using the <code>test</code> element.</p> - For example, the following target <code><pre> - <target name="test-int-chars" depends="jar-test"> - <echo message="testing international characters"/> - <junit printsummary="no" haltonfailure="yes" fork="false"> - <classpath refid="classpath"/> - <formatter type="plain" usefile="false" /> - <test name="org.apache.ecs.InternationalCharTest" /> - </junit> - </target> - </pre></code> - <p>runs a single junit test - (<code>org.apache.ecs.InternationalCharTest</code>) in the current - VM using the path with id <code>classpath</code> as classpath and - presents the results formatted using the standard - <code>plain</code> formatter on the command line.</p> - - <p> This task can also run batches of tests. The - <code>batchtest</code> element creates a <code>BatchTest</code> - based on a fileset. This allows, for example, all classes found in - directory to be run as testcases.</p> - - <p>For example,</p><code><pre> - <target name="run-tests" depends="dump-info,compile-tests" if="junit.present"> - <junit printsummary="no" haltonfailure="yes" fork="${junit.fork}"> - <jvmarg value="-classic"/> - <classpath refid="tests-classpath"/> - <sysproperty key="build.tests" value="${build.tests}"/> - <formatter type="brief" usefile="false" /> - <batchtest> - <fileset dir="${tests.dir}"> - <include name="**/*Test*" /> - </fileset> - </batchtest> - </junit> - </target> - </pre></code> - <p>this target finds any classes with a <code>test</code> directory - anywhere in their path (under the top <code>${tests.dir}</code>, of - course) and creates <code>JUnitTest</code>'s for each one.</p> - - <p> Of course, <code><junit></code> and - <code><batch></code> elements can be combined for more - complex tests. For an example, see the ant <code>build.xml</code> - target <code>run-tests</code> (the second example is an edited - version).</p> - - <p> To spawn a new Java VM to prevent interferences between - different testcases, you need to enable <code>fork</code>. A - number of attributes and elements allow you to set up how this JVM - runs.]]> - </description> - - <structure> - - <attributes> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to invoke the VM in.]]></short-description> - <description><![CDATA[ - The directory to invoke the VM in. Ignored if no JVM is forked. - ]]></description> - </attribute> - <attribute name="errorproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property to set to "true" if there is a error in a test.]]></short-description> - <description><![CDATA[ - Property to set to "true" if there is a error in a test. - - <p>This property is applied on all BatchTest (batchtest) and - JUnitTest (test), however, it can possibly be overriden by - their own properties.</p> - ]]></description> - </attribute> - <attribute name="failureproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property to set to "true" if there is a failure in a test.]]></short-description> - <description><![CDATA[ - Property to set to "true" if there is a failure in a test. - - <p>This property is applied on all BatchTest (batchtest) and - JUnitTest (test), however, it can possibly be overriden by - their own properties.</p> - ]]></description> - </attribute> - <attribute name="filtertrace" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, smartly filter the stack frames of - JUnit errors and failures before reporting them.]]></short-description> - <description><![CDATA[ - If true, smartly filter the stack frames of - JUnit errors and failures before reporting them. - - <p>This property is applied on all BatchTest (batchtest) and - JUnitTest (test) however it can possibly be overridden by their - own properties.</p> - ]]></description> - </attribute> - <attribute name="fork" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, JVM should be forked for each test.]]></short-description> - <description><![CDATA[ - If true, JVM should be forked for each test. - - <p>It avoids interference between testcases and possibly avoids - hanging the build. this property is applied on all BatchTest - (batchtest) and JUnitTest (test) however it can possibly be - overridden by their own properties.</p> - ]]></description> - </attribute> - <attribute name="haltonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, stop the build process when there is an error in a test.]]></short-description> - <description><![CDATA[ - If true, stop the build process when there is an error in a test. - This property is applied on all BatchTest (batchtest) and JUnitTest - (test) however it can possibly be overridden by their own - properties. - ]]></description> - </attribute> - <attribute name="haltonfailure" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, stop the build process if a test fails - (errors are considered failures as well).]]></short-description> - <description><![CDATA[ - If true, stop the build process if a test fails - (errors are considered failures as well). - This property is applied on all BatchTest (batchtest) and - JUnitTest (test) however it can possibly be overridden by their - own properties. - ]]></description> - </attribute> - <attribute name="includeantruntime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, include ant.jar, optional.jar and junit.jar in the forked VM.]]></short-description> - <description><![CDATA[ - If true, include ant.jar, optional.jar and junit.jar in the forked VM. - ]]></description> - </attribute> - <attribute name="jvm" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The command used to invoke the Java Virtual Machine, - default is 'java'.]]></short-description> - <description><![CDATA[ - The command used to invoke the Java Virtual Machine, - default is 'java'. The command is resolved by - java.lang.Runtime.exec(). Ignored if fork is disabled. - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Maximum memory to be used by all forked JVMs.]]></short-description> - <description><![CDATA[ - Set the maximum memory to be used by all forked JVMs. - ]]></description> - </attribute> - <attribute name="newenvironment" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, use a new environment when forked.]]></short-description> - <description><![CDATA[ - If true, use a new environment when forked. - - <p>Will be ignored if we are not forking a new VM.</p> - ]]></description> - </attribute> - <attribute name="printsummary" type="org.apache.tools.ant.taskdefs.optional.junit.JUnitTask.SummaryAttribute" - briefType=""true", "yes", "false", "no", "on", "off", "withOutAndErr"" required="NOTDEFINED"> - <short-description><![CDATA[If true, print one-line statistics for each test, or "withOutAndErr" - to also show standard output and error.]]></short-description> - <description><![CDATA[ - If true, print one-line statistics for each test, or "withOutAndErr" - to also show standard output and error. - - Can take the values on, off, and withOutAndErr. - ]]></description> - </attribute> - <attribute name="showoutput" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, send any output generated by tests to Ant's logging system - as well as to the formatters.]]></short-description> - <description><![CDATA[ - If true, send any output generated by tests to Ant's logging system - as well as to the formatters. - By default only the formatters receive the output. - - <p>Output will always be passed to the formatters and not by - shown by default. This option should for example be set for - tests that are interactive and prompt the user to do - something.</p> - ]]></description> - </attribute> - <attribute name="timeout" type="java.lang.Integer" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Timeout value (in milliseconds).]]></short-description> - <description><![CDATA[ - Set the timeout value (in milliseconds). - - <p>If the test is running for more than this value, the test - will be canceled. (works only when in 'fork' mode).</p> - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an environment variable; used when forking.]]></short-description> - <description> - <![CDATA[Adds an environment variable; used when forking. - - <p>Will be ignored if we are not forking a new VM.</p>]]> - </description> - </element> - - <element name="formatter" type="org.apache.tools.ant.taskdefs.optional.junit.FormatterElement" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a new formatter to all tests of this task.]]></short-description> - <description> - <![CDATA[Add a new formatter to all tests of this task.]]> - </description> - </element> - - <element name="sysproperty" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a system property that tests can access.]]></short-description> - <description> - <![CDATA[Adds a system property that tests can access. - This might be useful to tranfer Ant properties to the - testcases when JVM forking is not enabled.]]> - </description> - </element> - - <element name="test" type="org.apache.tools.ant.taskdefs.optional.junit.JUnitTest" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a new single testcase.]]></short-description> - <description> - <![CDATA[Add a new single testcase.]]> - </description> - </element> - - <element name="batchtest" type="org.apache.tools.ant.taskdefs.optional.junit.BatchTest" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of tests based on pattern matching.]]></short-description> - <description> - <![CDATA[Adds a set of tests based on pattern matching.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds path to classpath used for tests.]]></short-description> - <description> - <![CDATA[Adds path to classpath used for tests.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a JVM argument; ignored if not forking.]]></short-description> - <description> - <![CDATA[Adds a JVM argument; ignored if not forking.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="junitreport" category="testing" - classname="org.apache.tools.ant.taskdefs.optional.junit.XMLResultAggregator" - > - - <short-description><![CDATA[Aggregates all <junit> XML formatter testsuite data under a specific directory and transforms the results via XSLT.]]></short-description> - <description> - <![CDATA[Aggregates all <junit> XML formatter testsuite data under - a specific directory and transforms the results via XSLT. - It is not particulary clean but - should be helpful while I am thinking about another technique. - - <p> The main problem is due to the fact that a JVM can be forked for a testcase - thus making it impossible to aggregate all testcases since the listener is - (obviously) in the forked JVM. A solution could be to write a - TestListener that will receive events from the TestRunner via sockets. This - is IMHO the simplest way to do it to avoid this file hacking thing.]]> - </description> - - <structure> - - <attributes> - <attribute name="todir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory where the results should be written.]]></short-description> - <description><![CDATA[ - Set the destination directory where the results should be written. If not - set if will use {@link #DEFAULT_DIR}. When given a relative directory - it will resolve it from the project directory. - ]]></description> - </attribute> - <attribute name="tofile" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the aggregegated results file.]]></short-description> - <description><![CDATA[ - Set the name of the aggregegated results file. It must be relative - from the <tt>todir</tt> attribute. If not set it will use {@link #DEFAULT_FILENAME} - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a new fileset containing the XML results to aggregate.]]></short-description> - <description> - <![CDATA[Add a new fileset containing the XML results to aggregate]]> - </description> - </element> - - <element name="report" type="org.apache.tools.ant.taskdefs.optional.junit.AggregateTransformer" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Generate a report based on the document created by the merge.]]></short-description> - <description> - <![CDATA[Generate a report based on the document created by the merge.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="keysubst" category="other" - classname="org.apache.tools.ant.taskdefs.KeySubst" - deprecated="true" - > - - <short-description><![CDATA[Keyword substitution.]]></short-description> - <description> - <![CDATA[Keyword substitution. Input file is written to output file. - Do not make input file same as output file. - Keywords in input files look like this: @foo@. See the docs for the - setKeys method to understand how to do the substitutions.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination file.]]></short-description> - <description><![CDATA[ - Set the destination file. - ]]></description> - </attribute> - <attribute name="keys" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Keys.]]></short-description> - <description><![CDATA[ - Sets the keys. -Format string is like this: -<p> -name=value*name2=value -<p> -Names are case sensitive. -<p> -Use the setSep() method to change the * to something else -if you need to use * as a name or value. - ]]></description> - </attribute> - <attribute name="sep" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Seperator between name=value arguments -in setKeys().]]></short-description> - <description><![CDATA[ - Sets the seperator between name=value arguments -in setKeys(). By default it is "*". - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source file.]]></short-description> - <description><![CDATA[ - Set the source file. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="loadfile" category="utility" - classname="org.apache.tools.ant.taskdefs.LoadFile" - > - - <short-description><![CDATA[Load a file into a property]]></short-description> - <description> - <![CDATA[Load a file into a property]]> - </description> - - <structure> - - <attributes> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding to use for input, defaults to the platform's default - encoding.]]></short-description> - <description><![CDATA[ - Encoding to use for input, defaults to the platform's default - encoding. <p> - - For a list of possible values see <a href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html"> - http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html - </a>.</p> - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, fail on load error.]]></short-description> - <description><![CDATA[ - If true, fail on load error. - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Property name to save to.]]></short-description> - <description><![CDATA[ - Property name to save to. - ]]></description> - </attribute> - <attribute name="srcfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File to load.]]></short-description> - <description><![CDATA[ - Sets the file to load. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" - briefType="FilterChain" - required="NOTDEFINED"> - <short-description><![CDATA[Add the FilterChain element.]]></short-description> - <description> - <![CDATA[Add the FilterChain element.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="loadproperties" category="utility" - classname="org.apache.tools.ant.taskdefs.LoadProperties" - > - - <short-description><![CDATA[Load a file's contents as Ant properties.]]></short-description> - <description> - <![CDATA[Load a file's contents as Ant properties.]]> - </description> - - <structure> - - <attributes> - <attribute name="srcfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File to load.]]></short-description> - <description><![CDATA[ - Sets the file to load. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" - briefType="FilterChain" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a FilterChain.]]></short-description> - <description> - <![CDATA[Adds a FilterChain.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="mail" category="network" - classname="org.apache.tools.ant.taskdefs.email.EmailTask" - > - - <short-description><![CDATA[A task to send SMTP email.]]></short-description> - <description> - <![CDATA[A task to send SMTP email. This is a refactoring of the SendMail and - MimeMail tasks such that both are within a single task.]]> - </description> - - <structure> - - <attributes> - <attribute name="bcclist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds "bcc" address elements.]]></short-description> - <description><![CDATA[ - Adds "bcc" address elements - ]]></description> - </attribute> - <attribute name="cclist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds "cc" address elements.]]></short-description> - <description><![CDATA[ - Adds "cc" address elements - ]]></description> - </attribute> - <attribute name="encoding" type="org.apache.tools.ant.taskdefs.email.EmailTask.Encoding" - briefType=""auto", "mime", "uu", "plain"" required="NOTDEFINED"> - <short-description><![CDATA[Allows the build writer to choose the preferred encoding method.]]></short-description> - <description><![CDATA[ - Allows the build writer to choose the preferred encoding method - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether BuildExceptions should be passed back to the core.]]></short-description> - <description><![CDATA[ - Indicates whether BuildExceptions should be passed back to the core - ]]></description> - </attribute> - <attribute name="files" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds a list of files to be attached.]]></short-description> - <description><![CDATA[ - Adds a list of files to be attached - ]]></description> - </attribute> - <attribute name="from" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand to set the from address element.]]></short-description> - <description><![CDATA[ - Shorthand to set the from address element - ]]></description> - </attribute> - <attribute name="includefilenames" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets Includefilenames attribute.]]></short-description> - <description><![CDATA[ - Sets Includefilenames attribute - ]]></description> - </attribute> - <attribute name="mailhost" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Host.]]></short-description> - <description><![CDATA[ - Sets the host - ]]></description> - </attribute> - <attribute name="mailport" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Mail server port.]]></short-description> - <description><![CDATA[ - Sets the mail server port - ]]></description> - </attribute> - <attribute name="message" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand method to set the message.]]></short-description> - <description><![CDATA[ - Shorthand method to set the message - ]]></description> - </attribute> - <attribute name="messagefile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand method to set the message from a file.]]></short-description> - <description><![CDATA[ - Shorthand method to set the message from a file - ]]></description> - </attribute> - <attribute name="messagemimetype" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible.]]></short-description> - <description><![CDATA[ - Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible. - ]]></description> - </attribute> - <attribute name="subject" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Subject line of the email.]]></short-description> - <description><![CDATA[ - Sets the subject line of the email - ]]></description> - </attribute> - <attribute name="tolist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds "to" address elements.]]></short-description> - <description><![CDATA[ - Adds "to" address elements - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="bcc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds "bcc" address elements.]]></short-description> - <description> - <![CDATA[Adds "bcc" address elements]]> - </description> - </element> - - <element name="cc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds "cc" address element.]]></short-description> - <description> - <![CDATA[Adds "cc" address element]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files (nested fileset attribute).]]></short-description> - <description> - <![CDATA[Adds a set of files (nested fileset attribute).]]> - </description> - </element> - - <element name="from" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a from address element.]]></short-description> - <description> - <![CDATA[Adds a from address element]]> - </description> - </element> - - <element name="message" type="org.apache.tools.ant.taskdefs.email.Message" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a message elemnt.]]></short-description> - <description> - <![CDATA[Add a message elemnt]]> - </description> - </element> - - <element name="to" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a to address element.]]></short-description> - <description> - <![CDATA[Adds a to address element]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="manifest" category="java" - classname="org.apache.tools.ant.taskdefs.ManifestTask" - > - - <short-description><![CDATA[Creates a manifest file for inclusion in a JAR, Ant task wrapper around]]></short-description> - <description> - <![CDATA[Creates a manifest file for inclusion in a JAR, Ant task wrapper - around {@link Manifest Manifest}. This task can be used to write a - Manifest file, optionally replacing or updating an existing file.]]> - </description> - - <structure> - - <attributes> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The name of the manifest file to create/update.]]></short-description> - <description><![CDATA[ - The name of the manifest file to create/update. - Required if used as a task. - ]]></description> - </attribute> - <attribute name="mode" type="org.apache.tools.ant.taskdefs.ManifestTask.Mode" - briefType=""update", "replace"" required="NOTDEFINED"> - <short-description><![CDATA[Update policy: either "update" or "replace"; default is "replace".]]></short-description> - <description><![CDATA[ - Update policy: either "update" or "replace"; default is "replace". - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="attribute" type="org.apache.tools.ant.taskdefs.Manifest.Attribute" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an attribute to the manifest - it is added to the main section.]]></short-description> - <description> - <![CDATA[Add an attribute to the manifest - it is added to the main section.]]> - </description> - </element> - - <element name="section" type="org.apache.tools.ant.taskdefs.Manifest.Section" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a section to the manifest.]]></short-description> - <description> - <![CDATA[Add a section to the manifest]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="maudit" category="other" - classname="org.apache.tools.ant.taskdefs.optional.metamata.MAudit" - > - - <short-description><![CDATA[Invokes the Metamata Audit/ Webgain Quality Analyzer on a set of Java files.]]></short-description> - <description> - <![CDATA[Invokes the Metamata Audit/ Webgain Quality Analyzer on a set of Java files. - <p> - <i>maudit</i> performs static analysis of the Java source code and byte code files to find and report - errors of style and potential problems related to performance, maintenance and robustness. - As a convenience, a stylesheet is given in <tt>etc</tt> directory, so that an HTML report - can be generated from the XML file.]]> - </description> - - <structure> - - <attributes> - <attribute name="fix" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Automatically fix certain errors - (those marked as fixable in the manual); - optional, default=false.]]></short-description> - <description><![CDATA[ - Automatically fix certain errors - (those marked as fixable in the manual); - optional, default=false - ]]></description> - </attribute> - <attribute name="list" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Creates listing file for each audited file; optional, default false.]]></short-description> - <description><![CDATA[ - Creates listing file for each audited file; optional, default false. - When set, a .maudit file will be generated in the - same location as the source file. - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Maximum memory for the JVM; optional.]]></short-description> - <description><![CDATA[ - Set the maximum memory for the JVM; optional. - -mx or -Xmx depending on VM version - ]]></description> - </attribute> - <attribute name="metamatahome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The home directory containing the Metamata distribution; required.]]></short-description> - <description><![CDATA[ - The home directory containing the Metamata distribution; required - ]]></description> - </attribute> - <attribute name="tofile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The XML file to which the Audit result should be written to; required.]]></short-description> - <description><![CDATA[ - The XML file to which the Audit result should be written to; required - ]]></description> - </attribute> - <attribute name="unused" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Finds declarations unused in search paths; optional, default false.]]></short-description> - <description><![CDATA[ - Finds declarations unused in search paths; optional, default false. - It will look for unused global declarations - in the source code within a use domain specified by the - <tt>searchpath</tt> element. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[The java files or directory to audit.]]></short-description> - <description> - <![CDATA[The java files or directory to audit. - Whatever the filter is, only the files that end - with .java will be included for processing. - Note that the base directory used for the fileset - MUST be the root of the source files otherwise package names - deduced from the file path will be incorrect.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Class path (also source path unless one explicitly set).]]></short-description> - <description> - <![CDATA[Sets the class path (also source path unless one explicitly set). - Overrides METAPATH/CLASSPATH environment variables.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Additional optional parameters to pass to the JVM.]]></short-description> - <description> - <![CDATA[Additional optional parameters to pass to the JVM. - You can avoid using the <code><jvmarg></code> by adding these empty - entries to <code>metamata.properties</code> located at <code>${metamata.home}/bin</code> - - <pre>metamata.classpath= - metamata.sourcepath= - metamata.baseclasspath= - </pre>]]> - </description> - </element> - - <element name="rulespath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Classpath for additional audit rules - these must be placed before metamata.jar !!.]]></short-description> - <description> - <![CDATA[classpath for additional audit rules - these must be placed before metamata.jar !!]]> - </description> - </element> - - <element name="searchpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Search path to use for unused global declarations; - required when <tt>unused</tt> is set.]]></short-description> - <description> - <![CDATA[search path to use for unused global declarations; - required when <tt>unused</tt> is set.]]> - </description> - </element> - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Source path.]]></short-description> - <description> - <![CDATA[Sets the source path. - Overrides the SOURCEPATH environment variable.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="mimemail" category="other" - classname="org.apache.tools.ant.taskdefs.optional.net.MimeMail" - deprecated="true" - > - - <short-description><![CDATA[A task to send SMTP email; Use <tt>mail</tt> instead]]></short-description> - <description> - <![CDATA[A task to send SMTP email; Use <tt>mail</tt> instead]]> - </description> - - <structure> - - <attributes> - <attribute name="bcclist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds "bcc" address elements.]]></short-description> - <description><![CDATA[ - Adds "bcc" address elements - ]]></description> - </attribute> - <attribute name="cclist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds "cc" address elements.]]></short-description> - <description><![CDATA[ - Adds "cc" address elements - ]]></description> - </attribute> - <attribute name="encoding" type="org.apache.tools.ant.taskdefs.email.EmailTask.Encoding" - briefType=""auto", "mime", "uu", "plain"" required="NOTDEFINED"> - <short-description><![CDATA[Allows the build writer to choose the preferred encoding method.]]></short-description> - <description><![CDATA[ - Allows the build writer to choose the preferred encoding method - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether BuildExceptions should be passed back to the core.]]></short-description> - <description><![CDATA[ - Indicates whether BuildExceptions should be passed back to the core - ]]></description> - </attribute> - <attribute name="files" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds a list of files to be attached.]]></short-description> - <description><![CDATA[ - Adds a list of files to be attached - ]]></description> - </attribute> - <attribute name="from" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand to set the from address element.]]></short-description> - <description><![CDATA[ - Shorthand to set the from address element - ]]></description> - </attribute> - <attribute name="includefilenames" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets Includefilenames attribute.]]></short-description> - <description><![CDATA[ - Sets Includefilenames attribute - ]]></description> - </attribute> - <attribute name="mailhost" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Host.]]></short-description> - <description><![CDATA[ - Sets the host - ]]></description> - </attribute> - <attribute name="mailport" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Mail server port.]]></short-description> - <description><![CDATA[ - Sets the mail server port - ]]></description> - </attribute> - <attribute name="message" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand method to set the message.]]></short-description> - <description><![CDATA[ - Shorthand method to set the message - ]]></description> - </attribute> - <attribute name="messagefile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand method to set the message from a file.]]></short-description> - <description><![CDATA[ - Shorthand method to set the message from a file - ]]></description> - </attribute> - <attribute name="messagemimetype" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible.]]></short-description> - <description><![CDATA[ - Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible. - ]]></description> - </attribute> - <attribute name="subject" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Subject line of the email.]]></short-description> - <description><![CDATA[ - Sets the subject line of the email - ]]></description> - </attribute> - <attribute name="tolist" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Adds "to" address elements.]]></short-description> - <description><![CDATA[ - Adds "to" address elements - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="bcc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds "bcc" address elements.]]></short-description> - <description> - <![CDATA[Adds "bcc" address elements]]> - </description> - </element> - - <element name="cc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds "cc" address element.]]></short-description> - <description> - <![CDATA[Adds "cc" address element]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files (nested fileset attribute).]]></short-description> - <description> - <![CDATA[Adds a set of files (nested fileset attribute).]]> - </description> - </element> - - <element name="from" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a from address element.]]></short-description> - <description> - <![CDATA[Adds a from address element]]> - </description> - </element> - - <element name="message" type="org.apache.tools.ant.taskdefs.email.Message" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a message elemnt.]]></short-description> - <description> - <![CDATA[Add a message elemnt]]> - </description> - </element> - - <element name="to" type="org.apache.tools.ant.taskdefs.email.EmailAddress" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a to address element.]]></short-description> - <description> - <![CDATA[Adds a to address element]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="mkdir" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Mkdir" - > - - <short-description><![CDATA[Creates a given directory.]]></short-description> - <description> - <![CDATA[Creates a given directory. - Creates a directory and any non-existent parent directories, when - necessary]]> - </description> - - <structure> - - <attributes> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to create; required.]]></short-description> - <description><![CDATA[ - the directory to create; required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="mmetrics" category="other" - classname="org.apache.tools.ant.taskdefs.optional.metamata.MMetrics" - > - - <short-description><![CDATA[Computes the metrics of a set of Java files and write the results to an XML file.]]></short-description> - <description> - <![CDATA[Computes the metrics of a set of Java files and write the results to an XML - file. As a convenience, a stylesheet is given in <tt>etc</tt> directory, - so that an HTML report can be generated from the XML file. - <p> - You will not be able to use this task with the evaluation version since - as of Metamata 2.0, Metrics does not support command line :-(]]> - </description> - - <structure> - - <attributes> - <attribute name="granularity" type="org.apache.tools.ant.taskdefs.optional.metamata.MMetrics.GranularityAttribute" - briefType=""compilation-units", "files", "methods", "types", "packages"" required="NOTDEFINED"> - <short-description><![CDATA[Granularity of the audit.]]></short-description> - <description><![CDATA[ - set the granularity of the audit. Should be one of 'files', 'methods' - or 'types'. - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Maximum memory for the JVM; optional.]]></short-description> - <description><![CDATA[ - Set the maximum memory for the JVM; optional. - -mx or -Xmx depending on VM version - ]]></description> - </attribute> - <attribute name="metamatahome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The home directory containing the Metamata distribution; required.]]></short-description> - <description><![CDATA[ - The home directory containing the Metamata distribution; required - ]]></description> - </attribute> - <attribute name="tofile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output XML file.]]></short-description> - <description><![CDATA[ - Set the output XML file - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[The java files or directory to audit.]]></short-description> - <description> - <![CDATA[The java files or directory to audit. - Whatever the filter is, only the files that end - with .java will be included for processing. - Note that the base directory used for the fileset - MUST be the root of the source files otherwise package names - deduced from the file path will be incorrect.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Class path (also source path unless one explicitly set).]]></short-description> - <description> - <![CDATA[Sets the class path (also source path unless one explicitly set). - Overrides METAPATH/CLASSPATH environment variables.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Additional optional parameters to pass to the JVM.]]></short-description> - <description> - <![CDATA[Additional optional parameters to pass to the JVM. - You can avoid using the <code><jvmarg></code> by adding these empty - entries to <code>metamata.properties</code> located at <code>${metamata.home}/bin</code> - - <pre>metamata.classpath= - metamata.sourcepath= - metamata.baseclasspath= - </pre>]]> - </description> - </element> - - <element name="path" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[New path (directory) to measure metrics from.]]></short-description> - <description> - <![CDATA[Set a new path (directory) to measure metrics from.]]> - </description> - </element> - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Source path.]]></short-description> - <description> - <![CDATA[Sets the source path. - Overrides the SOURCEPATH environment variable.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="move" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Move" - > - - <short-description><![CDATA[Moves a file or directory to a new file or directory.]]></short-description> - <description> - <![CDATA[Moves a file or directory to a new file or directory. - By default, the - destination file is overwritten if it already exists. - When <i>overwrite</i> is - turned off, then files are only moved if the source file is - newer than the destination file, or when the destination file does - not exist. - - <p>Source files and directories are only deleted when the file or - directory has been copied to the destination successfully. Filtering - also works.</p> - - <p>This implementation is based on Arnout Kuiper's initial design - document, the following mailing list discussions, and the - copyfile/copydir tasks.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Character encoding.]]></short-description> - <description><![CDATA[ - Sets the character encoding - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If false, note errors to the output but keep going.]]></short-description> - <description><![CDATA[ - If false, note errors to the output but keep going. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Single source file to copy.]]></short-description> - <description><![CDATA[ - Sets a single source file to copy. - ]]></description> - </attribute> - <attribute name="filtering" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, enables filtering.]]></short-description> - <description><![CDATA[ - If true, enables filtering. - ]]></description> - </attribute> - <attribute name="flatten" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[When copying directory trees, the files can be "flattened" - into a single directory.]]></short-description> - <description><![CDATA[ - When copying directory trees, the files can be "flattened" - into a single directory. If there are multiple files with - the same name in the source directory tree, only the first - file will be copied into the "flattened" directory, unless - the forceoverwrite attribute is true. - ]]></description> - </attribute> - <attribute name="includeemptydirs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Used to copy empty directories.]]></short-description> - <description><![CDATA[ - Used to copy empty directories. - ]]></description> - </attribute> - <attribute name="overwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Overwrite any existing destination file(s).]]></short-description> - <description><![CDATA[ - Overwrite any existing destination file(s). - ]]></description> - </attribute> - <attribute name="preservelastmodified" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Give the copied files the same last modified time as the original files.]]></short-description> - <description><![CDATA[ - Give the copied files the same last modified time as the original files. - ]]></description> - </attribute> - <attribute name="todir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory.]]></short-description> - <description><![CDATA[ - Sets the destination directory. - ]]></description> - </attribute> - <attribute name="tofile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination file.]]></short-description> - <description><![CDATA[ - Sets the destination file. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Used to force listing of all names of copied files.]]></short-description> - <description><![CDATA[ - Used to force listing of all names of copied files. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files to copy.]]></short-description> - <description> - <![CDATA[Adds a set of files to copy.]]> - </description> - </element> - - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" - briefType="FilterChain" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a FilterChain.]]></short-description> - <description> - <![CDATA[Adds a FilterChain.]]> - </description> - </element> - - <element name="filterset" type="org.apache.tools.ant.types.FilterSet" - briefType="Filterset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a filterset.]]></short-description> - <description> - <![CDATA[Adds a filterset.]]> - </description> - </element> - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" - briefType="Mapper" - required="NOTDEFINED"> - <short-description><![CDATA[Defines the mapper to map source to destination files.]]></short-description> - <description> - <![CDATA[Defines the mapper to map source to destination files.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="mparse" category="other" - classname="org.apache.tools.ant.taskdefs.optional.metamata.MParse" - > - - <short-description><![CDATA[Simple Metamata MParse task.]]></short-description> - <description> - <![CDATA[Simple Metamata MParse task. - Based on the original written by - <a href="mailto:thomas.haas@softwired-inc.com">Thomas Haas</a>. - This version was written for Metamata 2.0 available at - <a href="http://www.metamata.com">http://www.metamata.com</a>]]> - </description> - - <structure> - - <attributes> - <attribute name="cleanup" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Remove the intermediate Sun JavaCC file - ; optional, default false.]]></short-description> - <description><![CDATA[ - Remove the intermediate Sun JavaCC file - ; optional, default false. - ]]></description> - </attribute> - <attribute name="debugparser" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set parser debug mode; optional, default false.]]></short-description> - <description><![CDATA[ - set parser debug mode; optional, default false - ]]></description> - </attribute> - <attribute name="debugscanner" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set scanner debug mode; optional, default false.]]></short-description> - <description><![CDATA[ - set scanner debug mode; optional, default false - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Maximum memory for the JVM; optional.]]></short-description> - <description><![CDATA[ - Set the maximum memory for the JVM; optional. - -mx or -Xmx depending on VM version - ]]></description> - </attribute> - <attribute name="metamatahome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The home directory containing the Metamata distribution; required.]]></short-description> - <description><![CDATA[ - The home directory containing the Metamata distribution; required - ]]></description> - </attribute> - <attribute name="target" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The .jj file to process; required.]]></short-description> - <description><![CDATA[ - The .jj file to process; required. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set verbose mode; optional, default false.]]></short-description> - <description><![CDATA[ - set verbose mode; optional, default false - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create a classpath entry.]]></short-description> - <description> - <![CDATA[create a classpath entry]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Additional optional parameters to pass to the JVM.]]></short-description> - <description> - <![CDATA[Additional optional parameters to pass to the JVM.]]> - </description> - </element> - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Creates a sourcepath entry.]]></short-description> - <description> - <![CDATA[creates a sourcepath entry]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="native2ascii" category="other" - classname="org.apache.tools.ant.taskdefs.optional.Native2Ascii" - matchingTask="true"> - - <short-description><![CDATA[Converts files from native encodings to ASCII.]]></short-description> - <description> - <![CDATA[Converts files from native encodings to ASCII.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory to place converted files into.]]></short-description> - <description><![CDATA[ - Set the destination directory to place converted files into. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding to translate to/from.]]></short-description> - <description><![CDATA[ - Set the encoding to translate to/from. - If unset, the default encoding for the JVM is used. - ]]></description> - </attribute> - <attribute name="ext" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Extension which converted files should have.]]></short-description> - <description><![CDATA[ - Set the extension which converted files should have. - If unset, files will not be renamed. - ]]></description> - </attribute> - <attribute name="reverse" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag the conversion to run in the reverse sense, - that is Ascii to Native encoding.]]></short-description> - <description><![CDATA[ - Flag the conversion to run in the reverse sense, - that is Ascii to Native encoding. - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source directory in which to find files to convert.]]></short-description> - <description><![CDATA[ - Set the source directory in which to find files to convert. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="mapper" type="org.apache.tools.ant.types.Mapper" - briefType="Mapper" - required="NOTDEFINED"> - <short-description><![CDATA[Defines the FileNameMapper to use (nested mapper element).]]></short-description> - <description> - <![CDATA[Defines the FileNameMapper to use (nested mapper element).]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="netrexxc" category="other" - classname="org.apache.tools.ant.taskdefs.optional.NetRexxC" - matchingTask="true"> - - <short-description><![CDATA[Compiles NetRexx source files.]]></short-description> - <description> - <![CDATA[Compiles NetRexx source files. - This task can take the following - arguments: - <ul> - <li>binary</li> - <li>classpath</li> - <li>comments</li> - <li>compile</li> - <li>console</li> - <li>crossref</li> - <li>decimal</li> - <li>destdir</li> - <li>diag</li> - <li>explicit</li> - <li>format</li> - <li>keep</li> - <li>logo</li> - <li>replace</li> - <li>savelog</li> - <li>srcdir</li> - <li>sourcedir</li> - <li>strictargs</li> - <li>strictassign</li> - <li>strictcase</li> - <li>strictimport</li> - <li>symbols</li> - <li>time</li> - <li>trace</li> - <li>utf8</li> - <li>verbose</li> - <li>suppressMethodArgumentNotUsed</li> - <li>suppressPrivatePropertyNotUsed</li> - <li>suppressVariableNotUsed</li> - <li>suppressExceptionNotSignalled</li> - <li>suppressDeprecation</li> - </ul> - Of these arguments, the <b>srcdir</b> argument is required. - - <p>When this task executes, it will recursively scan the srcdir - looking for NetRexx source files to compile. This task makes its - compile decision based on timestamp. - <p>Before files are compiled they and any other file in the - srcdir will be copied to the destdir allowing support files to be - located properly in the classpath. The reason for copying the source files - before the compile is that NetRexxC has only two destinations for classfiles: - <ol> - <li>The current directory, and,</li> - <li>The directory the source is in (see sourcedir option) - </ol>]]> - </description> - - <structure> - - <attributes> - <attribute name="binary" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether literals are treated as binary, rather than NetRexx types.]]></short-description> - <description><![CDATA[ - Set whether literals are treated as binary, rather than NetRexx types - ]]></description> - </attribute> - <attribute name="classpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Classpath used for NetRexx compilation.]]></short-description> - <description><![CDATA[ - Set the classpath used for NetRexx compilation - ]]></description> - </attribute> - <attribute name="comments" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether comments are passed through to the generated java source.]]></short-description> - <description><![CDATA[ - Set whether comments are passed through to the generated java source. - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false - ]]></description> - </attribute> - <attribute name="compact" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether error messages come out in compact or verbose format.]]></short-description> - <description><![CDATA[ - Set whether error messages come out in compact or verbose format. Valid - true values are "on" or "true". Anything else sets the flag to false. - The default value is false - ]]></description> - </attribute> - <attribute name="compile" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether the NetRexx compiler should compile the generated java code - Valid true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Set whether the NetRexx compiler should compile the generated java code - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is true. Setting this flag to false, will - automatically set the keep flag to true. - ]]></description> - </attribute> - <attribute name="console" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether or not messages should be displayed on the 'console' Valid - true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Set whether or not messages should be displayed on the 'console' Valid - true values are "on" or "true". Anything else sets the flag to false. - The default value is true. - ]]></description> - </attribute> - <attribute name="crossref" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether variable cross references are generated.]]></short-description> - <description><![CDATA[ - Whether variable cross references are generated - ]]></description> - </attribute> - <attribute name="decimal" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether decimal arithmetic should be used for the netrexx code.]]></short-description> - <description><![CDATA[ - Set whether decimal arithmetic should be used for the netrexx code. - Binary arithmetic is used when this flag is turned off. Valid true - values are "on" or "true". Anything else sets the flag to false. The - default value is true. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory into which the NetRexx source files - should be copied and then compiled.]]></short-description> - <description><![CDATA[ - Set the destination directory into which the NetRexx source files - should be copied and then compiled. - ]]></description> - </attribute> - <attribute name="diag" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether diagnostic information about the compile is generated.]]></short-description> - <description><![CDATA[ - Whether diagnostic information about the compile is generated - ]]></description> - </attribute> - <attribute name="explicit" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether variables must be declared explicitly before use.]]></short-description> - <description><![CDATA[ - Sets whether variables must be declared explicitly before use. Valid - true values are "on" or "true". Anything else sets the flag to false. - The default value is false. - ]]></description> - </attribute> - <attribute name="format" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the generated java code is formatted nicely or left to match - NetRexx line numbers for call stack debugging.]]></short-description> - <description><![CDATA[ - Whether the generated java code is formatted nicely or left to match - NetRexx line numbers for call stack debugging - ]]></description> - </attribute> - <attribute name="java" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the generated java code is produced Valid true values are "on" - or "true".]]></short-description> - <description><![CDATA[ - Whether the generated java code is produced Valid true values are "on" - or "true". Anything else sets the flag to false. The default value is - false. - ]]></description> - </attribute> - <attribute name="keep" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether the generated java source file should be kept after - compilation.]]></short-description> - <description><![CDATA[ - Sets whether the generated java source file should be kept after - compilation. The generated files will have an extension of .java.keep, - <b>not</b> .java Valid true values are "on" or "true". Anything else - sets the flag to false. The default value is false. - ]]></description> - </attribute> - <attribute name="logo" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the compiler text logo is displayed when compiling.]]></short-description> - <description><![CDATA[ - Whether the compiler text logo is displayed when compiling - ]]></description> - </attribute> - <attribute name="replace" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the generated .java file should be replaced when compiling - Valid true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Whether the generated .java file should be replaced when compiling - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false. - ]]></description> - </attribute> - <attribute name="savelog" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether the compiler messages will be written to NetRexxC.log as - well as to the console Valid true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Sets whether the compiler messages will be written to NetRexxC.log as - well as to the console Valid true values are "on" or "true". Anything - else sets the flag to false. The default value is false. - ]]></description> - </attribute> - <attribute name="sourcedir" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Tells the NetRexx compiler to store the class files in the same - directory as the source files.]]></short-description> - <description><![CDATA[ - Tells the NetRexx compiler to store the class files in the same - directory as the source files. The alternative is the working directory - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is true. - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source dir to find the source Java files.]]></short-description> - <description><![CDATA[ - Set the source dir to find the source Java files. - ]]></description> - </attribute> - <attribute name="strictargs" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Tells the NetRexx compiler that method calls always need parentheses, - even if no arguments are needed, e.g.]]></short-description> - <description><![CDATA[ - Tells the NetRexx compiler that method calls always need parentheses, - even if no arguments are needed, e.g. <code>aStringVar.getBytes</code> - vs. <code>aStringVar.getBytes()</code> Valid true values are "on" or - "true". Anything else sets the flag to false. The default value is - false. - ]]></description> - </attribute> - <attribute name="strictassign" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Tells the NetRexx compile that assignments must match exactly on type.]]></short-description> - <description><![CDATA[ - Tells the NetRexx compile that assignments must match exactly on type - ]]></description> - </attribute> - <attribute name="strictcase" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Specifies whether the NetRexx compiler should be case sensitive or not.]]></short-description> - <description><![CDATA[ - Specifies whether the NetRexx compiler should be case sensitive or not - ]]></description> - </attribute> - <attribute name="strictimport" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether classes need to be imported explicitly using an <code>import</code> - statement.]]></short-description> - <description><![CDATA[ - Sets whether classes need to be imported explicitly using an <code>import</code> - statement. By default the NetRexx compiler will import certain packages - automatically Valid true values are "on" or "true". Anything else sets - the flag to false. The default value is false. - ]]></description> - </attribute> - <attribute name="strictprops" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether local properties need to be qualified explicitly using - <code>this</code> Valid true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Sets whether local properties need to be qualified explicitly using - <code>this</code> Valid true values are "on" or "true". Anything else - sets the flag to false. The default value is false. - ]]></description> - </attribute> - <attribute name="strictsignal" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the compiler should force catching of exceptions by explicitly - named types.]]></short-description> - <description><![CDATA[ - Whether the compiler should force catching of exceptions by explicitly - named types - ]]></description> - </attribute> - <attribute name="suppressdeprecation" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Tells whether we should filter out any deprecation-messages - of the compiler out.]]></short-description> - <description><![CDATA[ - Tells whether we should filter out any deprecation-messages - of the compiler out. - ]]></description> - </attribute> - <attribute name="suppressexceptionnotsignalled" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the task should suppress the "FooException is in SIGNALS list - but is not signalled within the method", which is sometimes rather - useless.]]></short-description> - <description><![CDATA[ - Whether the task should suppress the "FooException is in SIGNALS list - but is not signalled within the method", which is sometimes rather - useless. The warning is logged as verbose message, though. - ]]></description> - </attribute> - <attribute name="suppressmethodargumentnotused" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the task should suppress the "Method argument is not used" in - strictargs-Mode, which can not be suppressed by the compiler itself.]]></short-description> - <description><![CDATA[ - Whether the task should suppress the "Method argument is not used" in - strictargs-Mode, which can not be suppressed by the compiler itself. - The warning is logged as verbose message, though. - ]]></description> - </attribute> - <attribute name="suppressprivatepropertynotused" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the task should suppress the "Private property is defined but - not used" in strictargs-Mode, which can be quite annoying while - developing.]]></short-description> - <description><![CDATA[ - Whether the task should suppress the "Private property is defined but - not used" in strictargs-Mode, which can be quite annoying while - developing. The warning is logged as verbose message, though. - ]]></description> - </attribute> - <attribute name="suppressvariablenotused" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether the task should suppress the "Variable is set but not used" in - strictargs-Mode.]]></short-description> - <description><![CDATA[ - Whether the task should suppress the "Variable is set but not used" in - strictargs-Mode. Be careful with this one! The warning is logged as - verbose message, though. - ]]></description> - </attribute> - <attribute name="symbols" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether debug symbols should be generated into the class file - Valid true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Sets whether debug symbols should be generated into the class file - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false. - ]]></description> - </attribute> - <attribute name="time" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Asks the NetRexx compiler to print compilation times to the console - Valid true values are "on" or "true".]]></short-description> - <description><![CDATA[ - Asks the NetRexx compiler to print compilation times to the console - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false. - ]]></description> - </attribute> - <attribute name="trace" type="org.apache.tools.ant.taskdefs.optional.NetRexxC.TraceAttr" - briefType=""trace", "trace1", "trace2", "notrace"" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="utf8" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Tells the NetRexx compiler that the source is in UTF8 Valid true values - are "on" or "true".]]></short-description> - <description><![CDATA[ - Tells the NetRexx compiler that the source is in UTF8 Valid true values - are "on" or "true". Anything else sets the flag to false. The default - value is false. - ]]></description> - </attribute> - <attribute name="verbose" type="org.apache.tools.ant.taskdefs.optional.NetRexxC.VerboseAttr" - briefType=""verbose", "verbose0", "verbose1", "verbose2", "verbose3", "verbose4", "verbose5", "noverbose"" required="NOTDEFINED"> - <short-description><![CDATA[Whether lots of warnings and error messages should be generated.]]></short-description> - <description><![CDATA[ - Whether lots of warnings and error messages should be generated - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4add" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Add" - > - - <short-description><![CDATA[Adds specified files to Perforce.]]></short-description> - <description> - <![CDATA[Adds specified files to Perforce. - - <b>Example Usage:</b> - <table border="1"> - <th>Function</th><th>Command</th> - <tr><td>Add files using P4USER, P4PORT and P4CLIENT settings specified</td><td><P4add <br>P4view="//projects/foo/main/source/..." <br>P4User="fbloggs" <br>P4Port="km01:1666" <br>P4Client="fbloggsclient"><br><fileset basedir="dir" includes="**/*.java"><br></p4add></td></tr> - <tr><td>Add files using P4USER, P4PORT and P4CLIENT settings defined in environment</td><td><P4add P4view="//projects/foo/main/source/..." /><br><fileset basedir="dir" includes="**/*.java"><br></p4add></td></tr> - <tr><td>Specify the length of command line arguments to pass to each invocation of p4</td><td><p4add Commandlength="450"></td></tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="changelist" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[If specified the open files are associated with the - specified pending changelist number; otherwise the open files are - associated with the default changelist.]]></short-description> - <description><![CDATA[ - If specified the open files are associated with the - specified pending changelist number; otherwise the open files are - associated with the default changelist. - ]]></description> - </attribute> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="commandlength" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Positive integer specifying the maximum length - of the commandline when calling Perforce to add the files.]]></short-description> - <description><![CDATA[ - positive integer specifying the maximum length - of the commandline when calling Perforce to add the files. - Defaults to 450, higher values mean faster execution, - but also possible failures. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Files to add.]]></short-description> - <description> - <![CDATA[files to add]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="p4change" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Change" - > - - <short-description><![CDATA[Requests a new changelist from the Perforce server.]]></short-description> - <description> - <![CDATA[Requests a new changelist from the Perforce server. - P4Change creates a new changelist in perforce. P4Change sets the property - ${p4.change} with the new changelist number. This should then be passed into - p4edit and p4submit.]]> - </description> - - <structure> - - <attributes> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="description" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Description for ChangeList;optional.]]></short-description> - <description><![CDATA[ - Description for ChangeList;optional. - If none is specified, it will default to "AutoSubmit By Ant" - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4counter" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Counter" - > - - <short-description><![CDATA[Obtains or sets the value of a counter.]]></short-description> - <description> - <![CDATA[Obtains or sets the value of a counter. - - <p> When used in its base form - (where only the counter name is provided), the counter value will be - printed to the output stream. When the value is provided, the counter - will be set to the value provided. When a property name is provided, - the property will be filled with the value of the counter. You may - not specify to both get and set the value of the counter in the same - Task. - </p> - <P> - The user performing this task must have Perforce "review" permissions - as defined by Perforce protections in order for this task to succeed. -</P> - - Example Usage:<br> - <p4counter name="${p4.counter}" property=${p4.change}"/>]]> - </description> - - <structure> - - <attributes> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the counter; required.]]></short-description> - <description><![CDATA[ - The name of the counter; required - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A property to be set with the value of the counter.]]></short-description> - <description><![CDATA[ - A property to be set with the value of the counter - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="value" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[The new value for the counter; optional.]]></short-description> - <description><![CDATA[ - The new value for the counter; optional. - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4delete" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Delete" - > - - <short-description><![CDATA[Checkout files for deletion.]]></short-description> - <description> - <![CDATA[Checkout files for deletion. - - Example Usage:<br> - <p4delete change="${p4.change}" view="//depot/project/foo.txt" /><br> - - Simple re-write of P4Edit changing 'edit' to 'delete'.<br>]]> - </description> - - <structure> - - <attributes> - <attribute name="change" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[An existing changelist number for the deletion; optional - but strongly recommended.]]></short-description> - <description><![CDATA[ - An existing changelist number for the deletion; optional - but strongly recommended. - ]]></description> - </attribute> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4edit" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Edit" - > - - <short-description><![CDATA[Open file(s) for edit.]]></short-description> - <description> - <![CDATA[Open file(s) for edit. - P4Change should be used to obtain a new changelist for P4Edit as, - although P4Edit can open files to the default change, - P4Submit cannot yet submit to it. - Example Usage:<br> - <p4edit change="${p4.change}" view="//depot/project/foo.txt" />]]> - </description> - - <structure> - - <attributes> - <attribute name="change" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[An existing changelist number to assign files to; optional - but strongly recommended.]]></short-description> - <description><![CDATA[ - An existing changelist number to assign files to; optional - but strongly recommended. - ]]></description> - </attribute> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4have" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Have" - > - - <short-description><![CDATA[Lists Perforce files currently on client.]]></short-description> - <description> - <![CDATA[Lists Perforce files currently on client. - - P4Have simply dumps the current file version info into - the Ant log (or stdout).]]> - </description> - - <structure> - - <attributes> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4label" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Label" - > - - <short-description><![CDATA[Creates a new Perforce label and set contents to reflect current client file revisions.]]></short-description> - <description> - <![CDATA[Creates a new Perforce label and set contents to reflect current - client file revisions. - - Label name defaults to AntLabel if none set. - - Example Usage: - <pre> - <P4Label name="MyLabel-${TSTAMP}-${DSTAMP}" desc="Auto Build Label" /> - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="desc" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Label Description; optional.]]></short-description> - <description><![CDATA[ - Label Description; optional - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="lock" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[When set to "locked", Perforce will lock the label once created; optional.]]></short-description> - <description><![CDATA[ - when set to "locked", Perforce will lock the label once created; optional. - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the label; optional, default "AntLabel".]]></short-description> - <description><![CDATA[ - The name of the label; optional, default "AntLabel" - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4reopen" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Reopen" - > - - <short-description><![CDATA[No Description.]]></short-description> - <description> - <![CDATA[]]> - </description> - - <structure> - - <attributes> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="tochange" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The changelist to move files to; required.]]></short-description> - <description><![CDATA[ - The changelist to move files to; required. - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4revert" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Revert" - > - - <short-description><![CDATA[Revert Perforce open files or files in a changelist]]></short-description> - <description> - <![CDATA[Revert Perforce open files or files in a changelist]]> - </description> - - <structure> - - <attributes> - <attribute name="change" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The changelist to revert; optional.]]></short-description> - <description><![CDATA[ - The changelist to revert; optional. - ]]></description> - </attribute> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="revertonlyunchanged" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to revert only unchanged files (p4 revert -a); optional, default false.]]></short-description> - <description><![CDATA[ - flag to revert only unchanged files (p4 revert -a); optional, default false. - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4submit" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Submit" - > - - <short-description><![CDATA[Submits a numbered changelist to Perforce.]]></short-description> - <description> - <![CDATA[Submits a numbered changelist to Perforce. - - <B>Note:</B> P4Submit cannot (yet) submit the default changelist. - This shouldn't be a problem with the ANT task as the usual flow is - P4Change to create a new numbered change followed by P4Edit then P4Submit. - - Example Usage:-<br> - <p4submit change="${p4.change}" />]]> - </description> - - <structure> - - <attributes> - <attribute name="change" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The changelist number to submit; required.]]></short-description> - <description><![CDATA[ - The changelist number to submit; required. - ]]></description> - </attribute> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="p4sync" category="other" - classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Sync" - > - - <short-description><![CDATA[Synchronize client space to a Perforce depot view.]]></short-description> - <description> - <![CDATA[Synchronize client space to a Perforce depot view. - - The API allows additional functionality of the "p4 sync" command - (such as "p4 sync -f //...#have" or other exotic invocations).</P> - - <b>Example Usage:</b> - <table border="1"> - <th>Function</th><th>Command</th> - <tr><td>Sync to head using P4USER, P4PORT and P4CLIENT settings specified</td><td><P4Sync <br>P4view="//projects/foo/main/source/..." <br>P4User="fbloggs" <br>P4Port="km01:1666" <br>P4Client="fbloggsclient" /></td></tr> - <tr><td>Sync to head using P4USER, P4PORT and P4CLIENT settings defined in environment</td><td><P4Sync P4view="//projects/foo/main/source/..." /></td></tr> - <tr><td>Force a re-sync to head, refreshing all files</td><td><P4Sync force="yes" P4view="//projects/foo/main/source/..." /></td></tr> - <tr><td>Sync to a label</td><td><P4Sync label="myPerforceLabel" /></td></tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="client" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 client spec to use; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 client spec to use; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="cmdopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set extra command options; only used on some - of the Perforce tasks.]]></short-description> - <description><![CDATA[ - Set extra command options; only used on some - of the Perforce tasks. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.]]></short-description> - <description><![CDATA[ - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - ]]></description> - </attribute> - <attribute name="force" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Force a refresh of files, if this attribute is set; false by default.]]></short-description> - <description><![CDATA[ - force a refresh of files, if this attribute is set; false by default. - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Label to sync client to; optional.]]></short-description> - <description><![CDATA[ - Label to sync client to; optional. - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4d server and port to connect to; - optional, default "perforce:1666".]]></short-description> - <description><![CDATA[ - The p4d server and port to connect to; - optional, default "perforce:1666" - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The p4 username; - optional, defaults to the current user.]]></short-description> - <description><![CDATA[ - The p4 username; - optional, defaults to the current user - ]]></description> - </attribute> - <attribute name="view" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The client, branch or label view to operate upon; - optional default "//...".]]></short-description> - <description><![CDATA[ - The client, branch or label view to operate upon; - optional default "//..." - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="parallel" category="control" - classname="org.apache.tools.ant.taskdefs.Parallel" - > - - <short-description><![CDATA[Executes the contained tasks in separate threads, continuing once all are completed.]]></short-description> - <description> - <![CDATA[Executes the contained tasks in separate threads, continuing - once all are completed. - <p>]]> - </description> - - <structure> - - <attributes> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="patch" category="utility" - classname="org.apache.tools.ant.taskdefs.Patch" - > - - <short-description><![CDATA[Patches a file by applying a 'diff' file to it; requires "patch" to be on the execution path.]]></short-description> - <description> - <![CDATA[Patches a file by applying a 'diff' file to it; requires "patch" to be - on the execution path.]]> - </description> - - <structure> - - <attributes> - <attribute name="backups" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to create backups; optional, default=false.]]></short-description> - <description><![CDATA[ - flag to create backups; optional, default=false - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory to run the patch command in, defaults to the - project's base directory.]]></short-description> - <description><![CDATA[ - The directory to run the patch command in, defaults to the - project's base directory. - ]]></description> - </attribute> - <attribute name="ignorewhitespace" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to ignore whitespace differences; default=false.]]></short-description> - <description><![CDATA[ - flag to ignore whitespace differences; default=false - ]]></description> - </attribute> - <attribute name="originalfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to patch; optional if it can be inferred from - the diff file.]]></short-description> - <description><![CDATA[ - The file to patch; optional if it can be inferred from - the diff file - ]]></description> - </attribute> - <attribute name="patchfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file containing the diff output; required.]]></short-description> - <description><![CDATA[ - The file containing the diff output; required. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Work silently unless an error occurs; optional, default=false.]]></short-description> - <description><![CDATA[ - Work silently unless an error occurs; optional, default=false - ]]></description> - </attribute> - <attribute name="reverse" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Assume patch was created with old and new files swapped; optional, - default=false.]]></short-description> - <description><![CDATA[ - Assume patch was created with old and new files swapped; optional, - default=false - ]]></description> - </attribute> - <attribute name="strip" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Strip the smallest prefix containing <i>num</i> leading slashes - from filenames.]]></short-description> - <description><![CDATA[ - Strip the smallest prefix containing <i>num</i> leading slashes - from filenames. - - <p>patch's <i>-p</i> option. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="pathconvert" category="utility" - classname="org.apache.tools.ant.taskdefs.PathConvert" - > - - <short-description><![CDATA[Converts path and classpath information to a specific target OS format.]]></short-description> - <description> - <![CDATA[Converts path and classpath information to a specific target OS - format. The resulting formatted path is placed into the specified property.]]> - </description> - - <structure> - - <attributes> - <attribute name="dirsep" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Default directory separator string; - defaults to current JVM.]]></short-description> - <description><![CDATA[ - Set the default directory separator string; - defaults to current JVM {@link java.io.File#separator File.separator} - ]]></description> - </attribute> - <attribute name="pathsep" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Default path separator string; - defaults to current JVM.]]></short-description> - <description><![CDATA[ - Set the default path separator string; - defaults to current JVM - {@link java.io.File#pathSeparator File.pathSeparator} - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The property into which the converted path will be placed.]]></short-description> - <description><![CDATA[ - The property into which the converted path will be placed. - ]]></description> - </attribute> - <attribute name="refid" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds a reference to a Path, FileSet, DirSet, or FileList defined - elsewhere.]]></short-description> - <description><![CDATA[ - Adds a reference to a Path, FileSet, DirSet, or FileList defined - elsewhere. - ]]></description> - </attribute> - <attribute name="setonempty" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set setonempty - - If false, don't set the new property if the result is the empty string.]]></short-description> - <description><![CDATA[ - Set setonempty - - If false, don't set the new property if the result is the empty string. - ]]></description> - </attribute> - <attribute name="targetos" type="org.apache.tools.ant.taskdefs.PathConvert.TargetOs" - briefType=""windows", "unix", "netware", "os/2"" required="NOTDEFINED"> - <short-description><![CDATA[Set targetos to a platform to one of - "windows", "unix", "netware", or "os/2"; required unless - unless pathsep and/or dirsep are specified.]]></short-description> - <description><![CDATA[ - Set targetos to a platform to one of - "windows", "unix", "netware", or "os/2"; required unless - unless pathsep and/or dirsep are specified. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="map" type="org.apache.tools.ant.taskdefs.PathConvert.MapEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create a nested MAP element.]]></short-description> - <description> - <![CDATA[Create a nested MAP element]]> - </description> - </element> - - <element name="path" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create a nested PATH element.]]></short-description> - <description> - <![CDATA[Create a nested PATH element]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="property" category="other" - classname="org.apache.tools.ant.taskdefs.Property" - > - - <short-description><![CDATA[Sets a property by name, or set of properties (from file or resource) in the project.]]></short-description> - <description> - <![CDATA[Sets a property by name, or set of properties (from file or - resource) in the project. </p> - Properties are immutable: whoever sets a property first freezes it for the - rest of the build; they are most definately not variable. - <p>There are five ways to set properties:</p> - <ul> - <li>By supplying both the <i>name</i> and <i>value</i> attribute.</li> - <li>By supplying both the <i>name</i> and <i>refid</i> attribute.</li> - <li>By setting the <i>file</i> attribute with the filename of the property - file to load. This property file has the format as defined by the file used - in the class java.util.Properties.</li> - <li>By setting the <i>resource</i> attribute with the resource name of the - property file to load. This property file has the format as defined by the - file used in the class java.util.Properties.</li> - <li>By setting the <i>environment</i> attribute with a prefix to use. - Properties will be defined for every environment variable by - prefixing the supplied name and a period to the name of the variable.</li> - </ul> - <p>Although combinations of these ways are possible, only one should be used - at a time. Problems might occur with the order in which properties are set, for - instance.</p> - <p>The value part of the properties being set, might contain references to other - properties. These references are resolved at the time these properties are set. - This also holds for properties loaded from a property file.</p> - Properties are case sensitive.]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[The classpath to use when looking up a resource.]]></short-description> - <description><![CDATA[ - The classpath to use when looking up a resource. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[The classpath to use when looking up a resource, - given as reference to a <path> defined elsewhere.]]></short-description> - <description><![CDATA[ - the classpath to use when looking up a resource, - given as reference to a <path> defined elsewhere - ]]></description> - </attribute> - <attribute name="environment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The prefix to use when retrieving environment variables.]]></short-description> - <description><![CDATA[ - the prefix to use when retrieving environment variables. - Thus if you specify environment="myenv" - you will be able to access OS-specific - environment variables via property names "myenv.PATH" or - "myenv.TERM". - <p> - Note that if you supply a property name with a final - "." it will not be doubled. ie environment="myenv." will still - allow access of environment variables through "myenv.PATH" and - "myenv.TERM". This functionality is currently only implemented - on select platforms. Feel free to send patches to increase the number of platforms - this functionality is supported on ;).<br> - Note also that properties are case sensitive, even if the - environment variables on your operating system are not, e.g. it - will be ${env.Path} not ${env.PATH} on Windows 2000. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The filename of a property file to load.]]></short-description> - <description><![CDATA[ - the filename of a property file to load. - ]]></description> - </attribute> - <attribute name="location" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Property to the absolute filename of the - given file.]]></short-description> - <description><![CDATA[ - Sets the property to the absolute filename of the - given file. If the value of this attribute is an absolute path, it - is left unchanged (with / and \ characters converted to the - current platforms conventions). Otherwise it is taken as a path - relative to the project's basedir and expanded. - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property to set.]]></short-description> - <description><![CDATA[ - sets the name of the property to set. - ]]></description> - </attribute> - <attribute name="prefix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Prefix to apply to properties loaded using <code>file</code> - or <code>resource</code>.]]></short-description> - <description><![CDATA[ - Prefix to apply to properties loaded using <code>file</code> - or <code>resource</code>. - A "." is appended to the prefix if not specified. - ]]></description> - </attribute> - <attribute name="refid" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Reference to an Ant datatype - declared elsewhere.]]></short-description> - <description><![CDATA[ - Sets a reference to an Ant datatype - declared elsewhere. - Only yields reasonable results for references - PATH like structures or properties. - ]]></description> - </attribute> - <attribute name="resource" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The resource name of a property file to load.]]></short-description> - <description><![CDATA[ - the resource name of a property file to load - ]]></description> - </attribute> - <attribute name="value" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Value of the property.]]></short-description> - <description><![CDATA[ - Sets the value of the property. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[The classpath to use when looking up a resource.]]></short-description> - <description> - <![CDATA[The classpath to use when looking up a resource.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="propertyfile" category="other" - classname="org.apache.tools.ant.taskdefs.optional.PropertyFile" - > - - <short-description><![CDATA[Modifies settings in a property file.]]></short-description> - <description> - <![CDATA[Modifies settings in a property file. - - <p> -The following is an example of its usage: - <ul><target name="setState"><br> - <ul><property<br> - <ul>name="header"<br> - value="##Generated file - do not modify!"/><br> - <propertyfile file="apropfile.properties" comment="${header}"><br> - <entry key="product.version.major" type="int" value="5"/><br> - <entry key="product.version.minor" type="int" value="0"/><br> - <entry key="product.build.major" type="int" value="0" /><br> - <entry key="product.build.minor" type="int" operation="+" /><br> - <entry key="product.build.date" type="date" value="now" /><br> - <entry key="intSet" type="int" operation="=" value="681"/><br> - <entry key="intDec" type="int" operation="-"/><br> - <entry key="StringEquals" type="string" value="testValue"/><br> - </propertyfile><br></ul> - </target></ul><p> - -The <propertyfile> task must have:<br> - <ul><li>file</li></ul> -Other parameters are:<br> - <ul><li>comment, key, operation, type and value (the final four being eliminated shortly)</li></ul> - -The <entry> task must have:<br> - <ul><li>key</li></ul> -Other parameters are:<br> - <ul><li>operation</li> - <li>type</li> - <li>value</li> - <li>default</li> - <li>unit</li> - </ul> - -If type is unspecified, it defaults to string - -Parameter values:<br> - <ul><li>operation:</li> - <ul><li>"=" (set -- default)</li> - <li>"-" (dec)</li> - <li>"+" (inc)</li> - - <li>type:</li> - <ul><li>"int"</li> - <li>"date"</li> - <li>"string"</li></ul></ul> - - <li>value:</li> - <ul><li>holds the default value, if the property - was not found in property file</li> - <li>"now" In case of type "date", the - value "now" will be replaced by the current - date/time and used even if a valid date was - found in the property file.</li></ul> - -String property types can only use the "=" operation. -Int property types can only use the "=", "-" or "+" operations.<p> - -The message property is used for the property file header, with "\\" being -a newline delimiter character.]]> - </description> - - <structure> - - <attributes> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Optional header comment for the file.]]></short-description> - <description><![CDATA[ - optional header comment for the file - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Location of the property file to be edited; required.]]></short-description> - <description><![CDATA[ - Location of the property file to be edited; required. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="entry" type="org.apache.tools.ant.taskdefs.optional.PropertyFile.Entry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description> - <![CDATA[]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="pvcs" category="other" - classname="org.apache.tools.ant.taskdefs.optional.pvcs.Pvcs" - > - - <short-description><![CDATA[Extracts the latest edition of the source code from a PVCS repository.]]></short-description> - <description> - <![CDATA[Extracts the latest edition of the source code from a PVCS repository. - PVCS is a version control system - developed by <a href="http://www.merant.com/products/pvcs">Merant</a>. - <br> - Before using this tag, the user running ant must have access to the commands - of PVCS (get and pcli) and must have access to the repository. Note that the way to specify - the repository is platform dependent so use property to specify location of repository. - <br> - This version has been tested agains PVCS version 6.5 and 6.6 under Windows and Solaris. - - <b>19-04-2001</b> <p>The task now has a more robust - parser. It allows for platform independant file paths - and supports file names with <i>()</i>. Thanks to Erik Husby for - bringing the bug to my attention. - - <b>27-04-2001</b> <p>UNC paths are now handled properly. - Fix provided by Don Jeffery. He also added an <i>UpdateOnly</i> flag - that, when true, conditions the PVCS get using the -U option to only - update those files that have a modification time (in PVCS) that is newer - than the existing workfile.]]> - </description> - - <structure> - - <attributes> - <attribute name="filenameformat" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The format of the folder names; optional.]]></short-description> - <description><![CDATA[ - The format of the folder names; optional. - This must be in a format suitable for - <code>java.text.MessageFormat</code>. - Index 1 of the format will be used as the file name. - Defaults to <code>{0}-arc({1})</code> - ]]></description> - </attribute> - <attribute name="force" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the value of the force argument; optional.]]></short-description> - <description><![CDATA[ - Specifies the value of the force argument; optional. - If set to <i>yes</i> all files that exists and are - writable are overwritten. Default <i>no</i> causes the files - that are writable to be ignored. This stops the PVCS command - <i>get</i> to stop asking questions! - ]]></description> - </attribute> - <attribute name="ignorereturncode" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If set to true the return value from executing the pvcs - commands are ignored; optional, default false.]]></short-description> - <description><![CDATA[ - If set to true the return value from executing the pvcs - commands are ignored; optional, default false. - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Only files marked with this label are extracted; optional.]]></short-description> - <description><![CDATA[ - Only files marked with this label are extracted; optional. - ]]></description> - </attribute> - <attribute name="linestart" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What a valid return value from PVCS looks like - when it describes a file.]]></short-description> - <description><![CDATA[ - What a valid return value from PVCS looks like - when it describes a file. Defaults to <code>"P:</code>. - If you are not using an UNC name for your repository and the - drive letter <code>P</code> is incorrect for your setup, you may - need to change this value, UNC names will always be - accepted. - ]]></description> - </attribute> - <attribute name="promotiongroup" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the name of the promotiongroup argument.]]></short-description> - <description><![CDATA[ - Specifies the name of the promotiongroup argument - ]]></description> - </attribute> - <attribute name="pvcsbin" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the location of the PVCS bin directory; optional if on the PATH.]]></short-description> - <description><![CDATA[ - Specifies the location of the PVCS bin directory; optional if on the PATH. - On some systems the PVCS executables <i>pcli</i> - and <i>get</i> are not found in the PATH. In such cases this attribute - should be set to the bin directory of the PVCS installation containing - the executables mentioned before. If this attribute isn't specified the - tag expects the executables to be found using the PATH environment variable. - ]]></description> - </attribute> - <attribute name="pvcsproject" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The project within the PVCS repository to extract files from; - optional, default "/".]]></short-description> - <description><![CDATA[ - The project within the PVCS repository to extract files from; - optional, default "/" - ]]></description> - </attribute> - <attribute name="repository" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The network name of the PVCS repository; required.]]></short-description> - <description><![CDATA[ - The network name of the PVCS repository; required. - ]]></description> - </attribute> - <attribute name="updateonly" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If set to <i>true</i> files are fetched only if - newer than existing local files; optional, default false.]]></short-description> - <description><![CDATA[ - If set to <i>true</i> files are fetched only if - newer than existing local files; optional, default false. - ]]></description> - </attribute> - <attribute name="workspace" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Workspace to use; optional.]]></short-description> - <description><![CDATA[ - Workspace to use; optional. - By specifying a workspace, the files are extracted to that location. - A PVCS workspace is a name for a location of the workfiles and - isn't as such the location itself. - You define the location for a workspace using the PVCS GUI clients. - If this isn't specified the default workspace for the current user is used. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="pvcsproject" type="org.apache.tools.ant.taskdefs.optional.pvcs.PvcsProject" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Specify a project within the PVCS repository to extract files from.]]></short-description> - <description> - <![CDATA[Specify a project within the PVCS repository to extract files from.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="record" category="utility" - classname="org.apache.tools.ant.taskdefs.Recorder" - > - - <short-description><![CDATA[Adds a listener to the current build process that records the output to a file.]]></short-description> - <description> - <![CDATA[Adds a listener to the current build process that records the - output to a file. - <p>Several recorders can exist at the same time. Each recorder is - associated with a file. The filename is used as a unique identifier for - the recorders. The first call to the recorder task with an unused filename - will create a recorder (using the parameters provided) and add it to the - listeners of the build. All subsequent calls to the recorder task using - this filename will modify that recorders state (recording or not) or other - properties (like logging level).</p> - <p>Some technical issues: the file's print stream is flushed for "finished" - events (buildFinished, targetFinished and taskFinished), and is closed on - a buildFinished event.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="action" type="org.apache.tools.ant.taskdefs.Recorder.ActionChoices" - briefType=""start", "stop"" required="NOTDEFINED"> - <short-description><![CDATA[Action for the associated recorder entry.]]></short-description> - <description><![CDATA[ - Sets the action for the associated recorder entry. - ]]></description> - </attribute> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether or not the logger should append to a previous file.]]></short-description> - <description><![CDATA[ - Whether or not the logger should append to a previous file. - ]]></description> - </attribute> - <attribute name="emacsmode" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description><![CDATA[ - ]]></description> - </attribute> - <attribute name="loglevel" type="org.apache.tools.ant.taskdefs.Recorder.VerbosityLevelChoices" - briefType=""error", "warn", "info", "verbose", "debug"" required="NOTDEFINED"> - <short-description><![CDATA[Level to which this recorder entry should log to.]]></short-description> - <description><![CDATA[ - Sets the level to which this recorder entry should log to. - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the file to log to, and the name of the recorder - entry.]]></short-description> - <description><![CDATA[ - Sets the name of the file to log to, and the name of the recorder - entry. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="rename" category="other" - classname="org.apache.tools.ant.taskdefs.Rename" - deprecated="true" - > - - <short-description><![CDATA[Renames a file.]]></short-description> - <description> - <![CDATA[Renames a file.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[New name of the file.]]></short-description> - <description><![CDATA[ - Sets the new name of the file. - ]]></description> - </attribute> - <attribute name="replace" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether an existing file should be replaced.]]></short-description> - <description><![CDATA[ - Sets whether an existing file should be replaced. - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File to be renamed.]]></short-description> - <description><![CDATA[ - Sets the file to be renamed. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="renameextensions" category="other" - classname="org.apache.tools.ant.taskdefs.optional.RenameExtensions" - deprecated="true" - matchingTask="true"> - - <short-description><![CDATA[No Description.]]></short-description> - <description> - <![CDATA[]]> - </description> - - <structure> - - <attributes> - <attribute name="fromextension" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The string that files must end in to be renamed.]]></short-description> - <description><![CDATA[ - The string that files must end in to be renamed - ]]></description> - </attribute> - <attribute name="replace" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Store replace attribute - this determines whether the target file - should be overwritten if present.]]></short-description> - <description><![CDATA[ - store replace attribute - this determines whether the target file - should be overwritten if present - ]]></description> - </attribute> - <attribute name="srcdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source dir to find the files to be renamed.]]></short-description> - <description><![CDATA[ - Set the source dir to find the files to be renamed. - ]]></description> - </attribute> - <attribute name="toextension" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The string that renamed files will end with on - completion.]]></short-description> - <description><![CDATA[ - The string that renamed files will end with on - completion - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="replace" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Replace" - matchingTask="true"> - - <short-description><![CDATA[Replaces all occurrences of one or more string tokens with given values in the indicated files.]]></short-description> - <description> - <![CDATA[Replaces all occurrences of one or more string tokens with given - values in the indicated files. Each value can be either a string - or the value of a property available in a designated property file. - If you want to replace a text that crosses line boundaries, you - must use a nested <code><replacetoken></code> element.]]> - </description> - - <structure> - - <attributes> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The base directory to use when replacing a token in multiple files; - required if <code>file</code> is not defined.]]></short-description> - <description><![CDATA[ - The base directory to use when replacing a token in multiple files; - required if <code>file</code> is not defined. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[File encoding to use on the files read and written by the task; - optional, defaults to default JVM encoding.]]></short-description> - <description><![CDATA[ - Set the file encoding to use on the files read and written by the task; - optional, defaults to default JVM encoding - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Source file; required unless <code>dir</code> is set.]]></short-description> - <description><![CDATA[ - Set the source file; required unless <code>dir</code> is set. - ]]></description> - </attribute> - <attribute name="propertyfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The name of a property file from which properties specified using - nested <code><replacefilter></code> elements are drawn; - Required only if <i>property</i> attribute of - <code><replacefilter></code> is used.]]></short-description> - <description><![CDATA[ - The name of a property file from which properties specified using - nested <code><replacefilter></code> elements are drawn; - Required only if <i>property</i> attribute of - <code><replacefilter></code> is used. - ]]></description> - </attribute> - <attribute name="replacefilterfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of a property file containing filters; optional.]]></short-description> - <description><![CDATA[ - Sets the name of a property file containing filters; optional. - Each property will be treated as a - replacefilter where token is the name of the property and value - is the value of the property. - ]]></description> - </attribute> - <attribute name="summary" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether a summary of the replace operation should be - produced, detailing how many token occurrences and files were - processed; optional, default=false.]]></short-description> - <description><![CDATA[ - Indicates whether a summary of the replace operation should be - produced, detailing how many token occurrences and files were - processed; optional, default=false - ]]></description> - </attribute> - <attribute name="token" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[String token to replace; - required unless a nested - <code>replacetoken</code> element or the <code>replacefilterfile</code> - attribute is used.]]></short-description> - <description><![CDATA[ - Set the string token to replace; - required unless a nested - <code>replacetoken</code> element or the <code>replacefilterfile</code> - attribute is used. - ]]></description> - </attribute> - <attribute name="value" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[String value to use as token replacement; - optional, default is the empty string "".]]></short-description> - <description><![CDATA[ - Set the string value to use as token replacement; - optional, default is the empty string "" - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="replacetoken" type="org.apache.tools.ant.taskdefs.Replace.NestedString" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[The token to filter as the text of a nested element.]]></short-description> - <description> - <![CDATA[the token to filter as the text of a nested element]]> - </description> - </element> - - <element name="replacevalue" type="org.apache.tools.ant.taskdefs.Replace.NestedString" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[The string to replace the token as the text of a nested element.]]></short-description> - <description> - <![CDATA[the string to replace the token as the text of a nested element]]> - </description> - </element> - - <element name="replacefilter" type="org.apache.tools.ant.taskdefs.Replace.Replacefilter" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a nested <replacefilter> element.]]></short-description> - <description> - <![CDATA[Add a nested <replacefilter> element.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="replaceregexp" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ReplaceRegExp" - > - - <short-description><![CDATA[Performs regular expression string replacements in a text file.]]></short-description> - <description> - <![CDATA[Performs regular expression string replacements in a text - file. The input file(s) must be able to be properly processed by - a Reader instance. That is, they must be text only, no binary. - - The syntax of the regular expression depends on the implemtation that - you choose to use. The system property <code>ant.regexp.regexpimpl</code> - will be the classname of the implementation that will be used (the default - is <code>org.apache.tools.ant.util.regexp.JakartaOroRegexp</code> and - requires the Jakarta Oro Package). - - <pre> - For jdk <= 1.3, there are two available implementations: - org.apache.tools.ant.util.regexp.JakartaOroRegexp (the default) - Requires the jakarta-oro package - - org.apache.tools.ant.util.regexp.JakartaRegexpRegexp - Requires the jakarta-regexp package - - For jdk >= 1.4 an additional implementation is available: - org.apache.tools.ant.util.regexp.Jdk14RegexpRegexp - Requires the jdk 1.4 built in regular expression package. - - Usage: - - Call Syntax: - - <replaceregexp file="file" - match="pattern" - replace="pattern" - flags="options"? - byline="true|false"? > - regexp? - substitution? - fileset* - </replaceregexp> - - NOTE: You must have either the file attribute specified, or at least one fileset subelement - to operation on. You may not have the file attribute specified if you nest fileset elements - inside this task. Also, you cannot specify both match and a regular expression subelement at - the same time, nor can you specify the replace attribute and the substitution subelement at - the same time. - - Attributes: - - file --> A single file to operation on (mutually exclusive with the fileset subelements) - match --> The Regular expression to match - replace --> The Expression replacement string - flags --> The options to give to the replacement - g = Substitute all occurrences. default is to replace only the first one - i = Case insensitive match - - byline --> Should this file be processed a single line at a time (default is false) - "true" indicates to perform replacement on a line by line basis - "false" indicates to perform replacement on the whole file at once. - - Example: - - The following call could be used to replace an old property name in a ".properties" - file with a new name. In the replace attribute, you can refer to any part of the - match expression in parenthesis using backslash followed by a number like '\1'. - - <replaceregexp file="test.properties" - match="MyProperty=(.*)" - replace="NewProperty=\1" - byline="true" /> - - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="byline" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Process the file(s) one line at a time, executing the replacement - on one line at a time.]]></short-description> - <description><![CDATA[ - Process the file(s) one line at a time, executing the replacement - on one line at a time. This is useful if you - want to only replace the first occurence of a regular expression on - each line, which is not easy to do when processing the file as a whole. - Defaults to <i>false</i>.</td> - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File for which the regular expression should be replaced; - required unless a nested fileset is supplied.]]></short-description> - <description><![CDATA[ - file for which the regular expression should be replaced; - required unless a nested fileset is supplied. - ]]></description> - </attribute> - <attribute name="flags" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The flags to use when matching the regular expression.]]></short-description> - <description><![CDATA[ - The flags to use when matching the regular expression. For more - information, consult the Perl5 syntax. - <ul> - <li>g : Global replacement. Replace all occurences found - <li>i : Case Insensitive. Do not consider case in the match - <li>m : Multiline. Treat the string as multiple lines of input, - using "^" and "$" as the start or end of any line, respectively, rather than start or end of string. - <li> s : Singleline. Treat the string as a single line of input, using - "." to match any character, including a newline, which normally, it would not match. -</ul> - ]]></description> - </attribute> - <attribute name="match" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The regular expression pattern to match in the file(s); - required if no nested <regexp> is used.]]></short-description> - <description><![CDATA[ - the regular expression pattern to match in the file(s); - required if no nested <regexp> is used - ]]></description> - </attribute> - <attribute name="replace" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The substitution pattern to place in the file(s) in place - of the regular expression.]]></short-description> - <description><![CDATA[ - The substitution pattern to place in the file(s) in place - of the regular expression. - Required if no nested <substitution> is used - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[List files to apply the replacement to.]]></short-description> - <description> - <![CDATA[list files to apply the replacement to]]> - </description> - </element> - - <element name="regexp" type="org.apache.tools.ant.types.RegularExpression" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[A regular expression.]]></short-description> - <description> - <![CDATA[A regular expression. - You can use this element to refer to a previously - defined regular expression datatype instance]]> - </description> - </element> - - <element name="substitution" type="org.apache.tools.ant.types.Substitution" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[A substitution pattern.]]></short-description> - <description> - <![CDATA[A substitution pattern. You can use this element to refer to a previously - defined substitution pattern datatype instance.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="rmic" category="java" - classname="org.apache.tools.ant.taskdefs.Rmic" - matchingTask="true"> - - <short-description><![CDATA[Runs the rmic compiler against classes.</p> <p>Rmic can be run on a single class (as specified with the classname attribute) or a number of classes at once (all classes below base that are neither _Stub nor _Skel classes).]]></short-description> - <description> - <![CDATA[Runs the rmic compiler against classes.</p> - <p>Rmic can be run on a single class (as specified with the classname - attribute) or a number of classes at once (all classes below base that - are neither _Stub nor _Skel classes). If you want to rmic a single - class and this class is a class nested into another class, you have to - specify the classname in the form <code>Outer$$Inner</code> instead of - <code>Outer.Inner</code>.</p> - <p>It is possible to refine the set of files that are being rmiced. This can be - done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, - <i>excludesfile</i> and <i>defaultexcludes</i> - attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to - have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify - the files you want to have excluded. This is also done with patterns. And - finally with the <i>defaultexcludes</i> attribute, you can specify whether you - want to use default exclusions or not. See the section on - directory based tasks</a>, on how the - inclusion/exclusion of files works, and how to write patterns.</p> - <p>This task forms an implicit FileSet and - supports all attributes of <code><fileset></code> - (<code>dir</code> becomes <code>base</code>) as well as the nested - <code><include></code>, <code><exclude></code> and - <code><patternset></code> elements.</p> - <p>It is possible to use different compilers. This can be selected - with the "build.rmic" property or the <code>compiler</code> - attribute. <a name="compilervalues">There are three choices</a>:</p> - <ul> - <li>sun (the standard compiler of the JDK)</li> - <li>kaffe (the standard compiler of - {@link <a href="http://www.kaffe.org">Kaffe</a>})</li> - <li>weblogic</li> - </ul> - <p> The <a href="http://dione.zcu.cz/~toman40/miniRMI/">miniRMI</a> - project contains a compiler implementation for this task as well, - please consult miniRMI's documentation to learn how to use it.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="base" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Location to store the compiled files; required.]]></short-description> - <description><![CDATA[ - Sets the location to store the compiled files; required - ]]></description> - </attribute> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The class to run <code>rmic</code> against; - optional.]]></short-description> - <description><![CDATA[ - Sets the the class to run <code>rmic</code> against; - optional - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Adds to the classpath a reference to - a <path> defined elsewhere.]]></short-description> - <description><![CDATA[ - Adds to the classpath a reference to - a <path> defined elsewhere. - ]]></description> - </attribute> - <attribute name="compiler" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Compiler implementation to use; optional, - defaults to the value of the <code>build.rmic</code> property, - or failing that, default compiler for the current VM.]]></short-description> - <description><![CDATA[ - Sets the compiler implementation to use; optional, - defaults to the value of the <code>build.rmic</code> property, - or failing that, default compiler for the current VM - ]]></description> - </attribute> - <attribute name="debug" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Generate debug info (passes -g to rmic); - optional, defaults to false.]]></short-description> - <description><![CDATA[ - generate debug info (passes -g to rmic); - optional, defaults to false - ]]></description> - </attribute> - <attribute name="extdirs" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Extension directories that will be used during the - compilation; optional.]]></short-description> - <description><![CDATA[ - Sets the extension directories that will be used during the - compilation; optional. - ]]></description> - </attribute> - <attribute name="filtering" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates whether token filtering should take place; - optional, default=false.]]></short-description> - <description><![CDATA[ - indicates whether token filtering should take place; - optional, default=false - ]]></description> - </attribute> - <attribute name="idl" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates that IDL output should be - generated.]]></short-description> - <description><![CDATA[ - Indicates that IDL output should be - generated. This defaults to false - if not set. - ]]></description> - </attribute> - <attribute name="idlopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Pass additional arguments for idl compile.]]></short-description> - <description><![CDATA[ - pass additional arguments for idl compile - ]]></description> - </attribute> - <attribute name="iiop" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Indicates that IIOP compatible stubs should - be generated; optional, defaults to false - if not set.]]></short-description> - <description><![CDATA[ - Indicates that IIOP compatible stubs should - be generated; optional, defaults to false - if not set. - ]]></description> - </attribute> - <attribute name="iiopopts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set additional arguments for iiop.]]></short-description> - <description><![CDATA[ - Set additional arguments for iiop - ]]></description> - </attribute> - <attribute name="includeantruntime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether or not to include ant's own classpath in this task's - classpath.]]></short-description> - <description><![CDATA[ - Sets whether or not to include ant's own classpath in this task's - classpath. - Optional; default is <code>true</code>. - ]]></description> - </attribute> - <attribute name="includejavaruntime" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Task's classpath.]]></short-description> - <description><![CDATA[ - task's classpath. - Enables or disables including the default run-time - libraries from the executing VM; optional, - defaults to false - ]]></description> - </attribute> - <attribute name="sourcebase" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Optional directory to save generated source files to.]]></short-description> - <description><![CDATA[ - optional directory to save generated source files to. - ]]></description> - </attribute> - <attribute name="stubversion" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specify the JDK version for the generated stub code.]]></short-description> - <description><![CDATA[ - Specify the JDK version for the generated stub code. - Specify "1.1" to pass the "-v1.1" option to rmic.</td> - ]]></description> - </attribute> - <attribute name="verify" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to enable verification so that the classes - found by the directory match are - checked to see if they implement java.rmi.Remote.]]></short-description> - <description><![CDATA[ - Flag to enable verification so that the classes - found by the directory match are - checked to see if they implement java.rmi.Remote. - Optional; his defaults to false if not set. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Creates a nested classpath element.]]></short-description> - <description> - <![CDATA[Creates a nested classpath element.]]> - </description> - </element> - - <element name="compilerarg" type="org.apache.tools.ant.taskdefs.Rmic.ImplementationSpecificArgument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an implementation specific command line argument.]]></short-description> - <description> - <![CDATA[Adds an implementation specific command line argument.]]> - </description> - </element> - - <element name="extdirs" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Maybe creates a nested extdirs element.]]></short-description> - <description> - <![CDATA[Maybe creates a nested extdirs element.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="rpm" category="other" - classname="org.apache.tools.ant.taskdefs.optional.Rpm" - > - - <short-description><![CDATA[Invokes the rpm tool to build a Linux installation file.]]></short-description> - <description> - <![CDATA[Invokes the rpm tool to build a Linux installation file.]]> - </description> - - <structure> - - <attributes> - <attribute name="cleanbuilddir" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag (optional, default=false) to remove - the generated files in the BUILD directory.]]></short-description> - <description><![CDATA[ - Flag (optional, default=false) to remove - the generated files in the BUILD directory - ]]></description> - </attribute> - <attribute name="command" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What command to issue to the rpm tool; optional.]]></short-description> - <description><![CDATA[ - What command to issue to the rpm tool; optional. - The default is "-bb" - ]]></description> - </attribute> - <attribute name="error" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Optional file to save stderr to.]]></short-description> - <description><![CDATA[ - Optional file to save stderr to - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Optional file to save stdout to.]]></short-description> - <description><![CDATA[ - Optional file to save stdout to. - ]]></description> - </attribute> - <attribute name="removesource" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag (optional, default=false) - to remove the sources after the build.]]></short-description> - <description><![CDATA[ - Flag (optional, default=false) - to remove the sources after the build. - See the the <tt>--rmsource</tt> option of rpmbuild. - ]]></description> - </attribute> - <attribute name="removespec" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag (optional, default=false) to remove the spec file from SPECS.]]></short-description> - <description><![CDATA[ - Flag (optional, default=false) to remove the spec file from SPECS - ]]></description> - </attribute> - <attribute name="specfile" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the spec File to use; required.]]></short-description> - <description><![CDATA[ - The name of the spec File to use; required. - ]]></description> - </attribute> - <attribute name="topdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory which will have the expected - subdirectories, SPECS, SOURCES, BUILD, SRPMS ; optional.]]></short-description> - <description><![CDATA[ - The directory which will have the expected - subdirectories, SPECS, SOURCES, BUILD, SRPMS ; optional. - If this isn't specified, - the <tt>baseDir</tt> value is used - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="script" category="other" - classname="org.apache.tools.ant.taskdefs.optional.Script" - > - - <short-description><![CDATA[Executes a script.]]></short-description> - <description> - <![CDATA[Executes a script.]]> - </description> - - <structure> - - <attributes> - <attribute name="language" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Defines the language (required).]]></short-description> - <description><![CDATA[ - Defines the language (required). - ]]></description> - </attribute> - <attribute name="src" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Load the script from an external file ; optional.]]></short-description> - <description><![CDATA[ - Load the script from an external file ; optional. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - <body > - <description><![CDATA[ - The script text. - ]]></description> - </body> - - </structure> - -</task> - - -<task name="sequential" category="control" - classname="org.apache.tools.ant.taskdefs.Sequential" - > - - <short-description><![CDATA[Sequential is a container task - it can contain other Ant tasks.]]></short-description> - <description> - <![CDATA[Sequential is a container task - it can contain other Ant tasks. The nested - tasks are simply executed in sequence. Sequential's primary use is to support - the sequential execution of a subset of tasks within the -{@link Parallel Parallel Task} - - <p> - The sequential task has no attributes and does not support any nested - elements apart from Ant tasks. Any valid Ant task may be embedded within the - sequential task.</p>]]> - </description> - - <structure> - - <attributes> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="serverdeploy" category="other" - classname="org.apache.tools.ant.taskdefs.optional.j2ee.ServerDeploy" - > - - <short-description><![CDATA[Controls hot deployment tools for J2EE servers.]]></short-description> - <description> - <![CDATA[Controls hot deployment tools for J2EE servers. - - This class is used as a framework for the creation of vendor specific - hot deployment tools.]]> - </description> - - <structure> - - <attributes> - <attribute name="action" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The action to be performed, usually "deploy"; required.]]></short-description> - <description><![CDATA[ - The action to be performed, usually "deploy"; required. - Some tools support additional actions, such as "delete", "list", "undeploy", "update"... - ]]></description> - </attribute> - <attribute name="source" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The filename of the component to be deployed; optional - depending upon the tool and the action.]]></short-description> - <description><![CDATA[ - The filename of the component to be deployed; optional - depending upon the tool and the action. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="generic" type="org.apache.tools.ant.taskdefs.optional.j2ee.GenericHotDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Creates a generic deployment tool.]]></short-description> - <description> - <![CDATA[Creates a generic deployment tool. - <p>Ant calls this method on creation to handle embedded "generic" elements - in the ServerDeploy task.]]> - </description> - </element> - - <element name="jonas" type="org.apache.tools.ant.taskdefs.optional.j2ee.JonasHotDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Creates a JOnAS deployment tool, for deployment to JOnAS servers.]]></short-description> - <description> - <![CDATA[Creates a JOnAS deployment tool, for deployment to JOnAS servers. - <p>Ant calls this method on creation to handle embedded "jonas" elements - in the ServerDeploy task.]]> - </description> - </element> - - <element name="weblogic" type="org.apache.tools.ant.taskdefs.optional.j2ee.WebLogicHotDeploymentTool" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Creates a WebLogic deployment tool, for deployment to WebLogic servers.]]></short-description> - <description> - <![CDATA[Creates a WebLogic deployment tool, for deployment to WebLogic servers. - <p>Ant calls this method on creation to handle embedded "weblogic" elements - in the ServerDeploy task.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="setproxy" category="other" - classname="org.apache.tools.ant.taskdefs.optional.net.SetProxy" - > - - <short-description><![CDATA[Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites.]]></short-description> - <description> - <![CDATA[Sets Java's web proxy properties, so that tasks and code run in - the same JVM can have through-the-firewall access to remote web sites, - and remote ftp sites. - You can nominate an http and ftp proxy, or a socks server, reset the server - settings, or do nothing at all. - <p> - Examples - <pre><setproxy/></pre> - do nothing - <pre><setproxy proxyhost="firewall"/></pre> - set the proxy to firewall:80 - <pre><setproxy proxyhost="firewall" proxyport="81"/></pre> - set the proxy to firewall:81 - <pre><setproxy proxyhost=""/></pre> - stop using the http proxy; don't change the socks settings - <pre><setproxy socksproxyhost="socksy"/></pre> - use socks via socksy:1080 - <pre><setproxy socksproxyhost=""/></pre> - stop using the socks server]]> - </description> - - <structure> - - <attributes> - <attribute name="nonproxyhosts" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A list of hosts to bypass the proxy on.]]></short-description> - <description><![CDATA[ - A list of hosts to bypass the proxy on. These should be separated - with the vertical bar character '|'. Only in Java 1.4 does ftp use - this list. - e.g. fozbot.corp.sun.com|*.eng.sun.com - ]]></description> - </attribute> - <attribute name="proxyhost" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The HTTP/ftp proxy host.]]></short-description> - <description><![CDATA[ - the HTTP/ftp proxy host. Set this to "" for the http proxy - option to be disabled - ]]></description> - </attribute> - <attribute name="proxyport" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[The HTTP/ftp proxy port number; default is 80.]]></short-description> - <description><![CDATA[ - the HTTP/ftp proxy port number; default is 80 - ]]></description> - </attribute> - <attribute name="socksproxyhost" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of a Socks server.]]></short-description> - <description><![CDATA[ - The name of a Socks server. Set to "" to turn socks - proxying off. - ]]></description> - </attribute> - <attribute name="socksproxyport" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[ProxyPort for socks connections.]]></short-description> - <description><![CDATA[ - Set the ProxyPort for socks connections. The default value is 1080 - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="signjar" category="java" - classname="org.apache.tools.ant.taskdefs.SignJar" - > - - <short-description><![CDATA[Signs jar or zip files with the javasign command line tool.]]></short-description> - <description> - <![CDATA[Signs jar or zip files with the javasign command line tool. The - tool detailed dependency checking: files are only signed if they - are not signed. The <tt>signjar</tt> attribute can point to the file to - generate; if this file exists then - its modification date is used as a cue as to whether to resign any JAR file. - <br> - <strong>Note:</strong> Requires Java 1.2 or later. </p>]]> - </description> - - <structure> - - <attributes> - <attribute name="alias" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The alias to sign under; required.]]></short-description> - <description><![CDATA[ - the alias to sign under; required - ]]></description> - </attribute> - <attribute name="internalsf" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to include the .SF file inside the signature; - optional; default false.]]></short-description> - <description><![CDATA[ - Flag to include the .SF file inside the signature; - optional; default false - ]]></description> - </attribute> - <attribute name="jar" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The jar file to sign; required.]]></short-description> - <description><![CDATA[ - the jar file to sign; required - ]]></description> - </attribute> - <attribute name="keypass" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password for private key (if different); optional.]]></short-description> - <description><![CDATA[ - password for private key (if different); optional - ]]></description> - </attribute> - <attribute name="keystore" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Keystore location; required.]]></short-description> - <description><![CDATA[ - keystore location; required - ]]></description> - </attribute> - <attribute name="lazy" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to control whether the presence of a signature - file means a JAR is signed; - optional, default false.]]></short-description> - <description><![CDATA[ - flag to control whether the presence of a signature - file means a JAR is signed; - optional, default false - ]]></description> - </attribute> - <attribute name="sectionsonly" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to compute hash of entire manifest; - optional, default false.]]></short-description> - <description><![CDATA[ - flag to compute hash of entire manifest; - optional, default false - ]]></description> - </attribute> - <attribute name="sigfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of .SF/.DSA file; optional.]]></short-description> - <description><![CDATA[ - name of .SF/.DSA file; optional - ]]></description> - </attribute> - <attribute name="signedjar" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of signed JAR file; optional.]]></short-description> - <description><![CDATA[ - name of signed JAR file; optional - ]]></description> - </attribute> - <attribute name="storepass" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password for keystore integrity; required.]]></short-description> - <description><![CDATA[ - password for keystore integrity; required - ]]></description> - </attribute> - <attribute name="storetype" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Keystore type; optional.]]></short-description> - <description><![CDATA[ - keystore type; optional - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Enable verbose output when signing - ; optional: default false.]]></short-description> - <description><![CDATA[ - Enable verbose output when signing - ; optional: default false - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files to sign.]]></short-description> - <description> - <![CDATA[Adds a set of files to sign]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="sleep" category="utility" - classname="org.apache.tools.ant.taskdefs.Sleep" - > - - <short-description><![CDATA[Sleep, or pause, for a period of time.]]></short-description> - <description> - <![CDATA[Sleep, or pause, for a period of time. - - A task for sleeping a short period of time, useful when a - build or deployment process requires an interval between tasks. -<p> - A negative value can be supplied to any of attributes provided the total sleep time - is positive, pending fundamental changes in physics and JVM - execution tims</p> - Note that sleep times are always hints to be interpred by the OS how it feels - small times may either be ignored or rounded up to a minimum timeslice. Note - also that the system clocks often have a fairly low granularity too, which complicates - measuring how long a sleep actually took.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag controlling whether to break the build on an error.]]></short-description> - <description><![CDATA[ - flag controlling whether to break the build on an error. - ]]></description> - </attribute> - <attribute name="hours" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Hours to add to the sleep time.]]></short-description> - <description><![CDATA[ - hours to add to the sleep time. - ]]></description> - </attribute> - <attribute name="milliseconds" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Milliseconds to add to the sleep time.]]></short-description> - <description><![CDATA[ - milliseconds to add to the sleep time - ]]></description> - </attribute> - <attribute name="minutes" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Minutes to add to the sleep time.]]></short-description> - <description><![CDATA[ - minutes to add to the sleep time - ]]></description> - </attribute> - <attribute name="seconds" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Seconds to add to the sleep time.]]></short-description> - <description><![CDATA[ - seconds to add to the sleep time - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="soscheckin" category="other" - classname="org.apache.tools.ant.taskdefs.optional.sos.SOSCheckin" - > - - <short-description><![CDATA[Commits and unlocks files in Visual SourceSafe via a SourceOffSite server.]]></short-description> - <description> - <![CDATA[Commits and unlocks files in Visual SourceSafe via a SourceOffSite server. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>file</td> - <td>Filename to act upon<br> If no file is specified then act upon the project</td> - <td>No</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>soshome</td> - <td>The path to the SourceOffSite home directory</td> - <td>No</td> - </tr> - <tr> - <td>nocompression</td> - <td>true or false - disable compression</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false - Only works with the CheckOutProject command</td> - <td>No</td> - </tr> - <tr> - <td>nocache</td> - <td>true or false - Only needed if SOSHOME is set as an enviroment variable</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - <td>comment</td> - <td>A comment to be applied to all files being checked in</td> - <td>No</td> - </tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply to all files being labelled; - optional, only valid in SOSLabel.]]></short-description> - <description><![CDATA[ - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - ]]></description> - </attribute> - <attribute name="file" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Filename to act upon; optional.]]></short-description> - <description><![CDATA[ - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Labeled version to operate on in SourceSafe.]]></short-description> - <description><![CDATA[ - Set the labeled version to operate on in SourceSafe - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Override the working directory and get to the specified path; optional.]]></short-description> - <description><![CDATA[ - Override the working directory and get to the specified path; optional. - ]]></description> - </attribute> - <attribute name="nocache" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.]]></short-description> - <description><![CDATA[ - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - ]]></description> - </attribute> - <attribute name="nocompress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag that disables compression when set; optional, default.]]></short-description> - <description><![CDATA[ - Flag that disables compression when set; optional, default - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe password; optional.]]></short-description> - <description><![CDATA[ - Set the SourceSafe password; optional. - ]]></description> - </attribute> - <attribute name="projectpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe project path without the "$" prefix; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe project path without the "$" prefix; required - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.]]></short-description> - <description><![CDATA[ - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - ]]></description> - </attribute> - <attribute name="soscmd" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.]]></short-description> - <description><![CDATA[ - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - ]]></description> - </attribute> - <attribute name="soshome" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The path to the SourceOffSite home directory.]]></short-description> - <description><![CDATA[ - The path to the SourceOffSite home directory - ]]></description> - </attribute> - <attribute name="sosserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.]]></short-description> - <description><![CDATA[ - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - ]]></description> - </attribute> - <attribute name="username" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe username; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe username; required. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Enable verbose output; optional, default false.]]></short-description> - <description><![CDATA[ - Enable verbose output; optional, default false - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A version number to get - - only works with the SOSGet on a file; optional.]]></short-description> - <description><![CDATA[ - Set the a version number to get - - only works with the SOSGet on a file; optional. - ]]></description> - </attribute> - <attribute name="vssserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the location of the ss.ini file; - required.]]></short-description> - <description><![CDATA[ - Set the path to the location of the ss.ini file; - required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="soscheckout" category="other" - classname="org.apache.tools.ant.taskdefs.optional.sos.SOSCheckout" - > - - <short-description><![CDATA[Retrieves and locks files in Visual SourceSafe via a SourceOffSite server.]]></short-description> - <description> - <![CDATA[Retrieves and locks files in Visual SourceSafe via a SourceOffSite server. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>file</td> - <td>Filename to act upon<br> If no file is specified then act upon the project</td> - <td>No</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>soshome</td> - <td>The path to the SourceOffSite home directory</td> - <td>No</td> - </tr> - <tr> - <td>nocompression</td> - <td>true or false - disable compression</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false - Only works with the CheckOutProject command</td> - <td>No</td> - </tr> - <tr> - <td>nocache</td> - <td>true or false - Only needed if SOSHOME is set as an enviroment variable</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply to all files being labelled; - optional, only valid in SOSLabel.]]></short-description> - <description><![CDATA[ - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - ]]></description> - </attribute> - <attribute name="file" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Filename to act upon; optional.]]></short-description> - <description><![CDATA[ - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Labeled version to operate on in SourceSafe.]]></short-description> - <description><![CDATA[ - Set the labeled version to operate on in SourceSafe - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Override the working directory and get to the specified path; optional.]]></short-description> - <description><![CDATA[ - Override the working directory and get to the specified path; optional. - ]]></description> - </attribute> - <attribute name="nocache" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.]]></short-description> - <description><![CDATA[ - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - ]]></description> - </attribute> - <attribute name="nocompress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag that disables compression when set; optional, default.]]></short-description> - <description><![CDATA[ - Flag that disables compression when set; optional, default - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe password; optional.]]></short-description> - <description><![CDATA[ - Set the SourceSafe password; optional. - ]]></description> - </attribute> - <attribute name="projectpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe project path without the "$" prefix; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe project path without the "$" prefix; required - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.]]></short-description> - <description><![CDATA[ - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - ]]></description> - </attribute> - <attribute name="soscmd" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.]]></short-description> - <description><![CDATA[ - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - ]]></description> - </attribute> - <attribute name="soshome" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The path to the SourceOffSite home directory.]]></short-description> - <description><![CDATA[ - The path to the SourceOffSite home directory - ]]></description> - </attribute> - <attribute name="sosserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.]]></short-description> - <description><![CDATA[ - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - ]]></description> - </attribute> - <attribute name="username" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe username; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe username; required. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Enable verbose output; optional, default false.]]></short-description> - <description><![CDATA[ - Enable verbose output; optional, default false - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A version number to get - - only works with the SOSGet on a file; optional.]]></short-description> - <description><![CDATA[ - Set the a version number to get - - only works with the SOSGet on a file; optional. - ]]></description> - </attribute> - <attribute name="vssserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the location of the ss.ini file; - required.]]></short-description> - <description><![CDATA[ - Set the path to the location of the ss.ini file; - required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="sosget" category="other" - classname="org.apache.tools.ant.taskdefs.optional.sos.SOSGet" - > - - <short-description><![CDATA[Retrieves a read-only copy of the specified project or file from Visual SourceSafe via a SourceOffSite server.]]></short-description> - <description> - <![CDATA[Retrieves a read-only copy of the specified project or file - from Visual SourceSafe via a SourceOffSite server. - <p> - The following attributes are interpretted: - <table border="1"> - <tbody> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>file</td> - <td>Filename to act upon<br> - If no file is specified then act upon the project</td> - <td>No</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>soshome</td> - <td>The path to the SourceOffSite home directory</td> - <td>No</td> - </tr> - <tr> - <td>nocompression</td> - <td>true or false - disable compression</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false - Only works with the GetProject command</td> - <td>No</td> - </tr> - <tr> - <td>version</td> - <td>a version number to get - Only works with the GetFile command</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>a label version to get - Only works with the GetProject command</td> - <td>No</td> - </tr> - <tr> - <td>nocache</td> - <td>true or false - Only needed if SOSHOME is set as an enviroment variable</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr>]]> - </description> - - <structure> - - <attributes> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply to all files being labelled; - optional, only valid in SOSLabel.]]></short-description> - <description><![CDATA[ - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - ]]></description> - </attribute> - <attribute name="file" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Filename to act upon; optional.]]></short-description> - <description><![CDATA[ - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Labeled version to operate on in SourceSafe.]]></short-description> - <description><![CDATA[ - Set the labeled version to operate on in SourceSafe - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Override the working directory and get to the specified path; optional.]]></short-description> - <description><![CDATA[ - Override the working directory and get to the specified path; optional. - ]]></description> - </attribute> - <attribute name="nocache" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.]]></short-description> - <description><![CDATA[ - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - ]]></description> - </attribute> - <attribute name="nocompress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag that disables compression when set; optional, default.]]></short-description> - <description><![CDATA[ - Flag that disables compression when set; optional, default - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe password; optional.]]></short-description> - <description><![CDATA[ - Set the SourceSafe password; optional. - ]]></description> - </attribute> - <attribute name="projectpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe project path without the "$" prefix; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe project path without the "$" prefix; required - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.]]></short-description> - <description><![CDATA[ - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - ]]></description> - </attribute> - <attribute name="soscmd" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.]]></short-description> - <description><![CDATA[ - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - ]]></description> - </attribute> - <attribute name="soshome" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The path to the SourceOffSite home directory.]]></short-description> - <description><![CDATA[ - The path to the SourceOffSite home directory - ]]></description> - </attribute> - <attribute name="sosserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.]]></short-description> - <description><![CDATA[ - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - ]]></description> - </attribute> - <attribute name="username" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe username; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe username; required. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Enable verbose output; optional, default false.]]></short-description> - <description><![CDATA[ - Enable verbose output; optional, default false - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A version number to get - - only works with the SOSGet on a file; optional.]]></short-description> - <description><![CDATA[ - Set the a version number to get - - only works with the SOSGet on a file; optional. - ]]></description> - </attribute> - <attribute name="vssserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the location of the ss.ini file; - required.]]></short-description> - <description><![CDATA[ - Set the path to the location of the ss.ini file; - required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="soslabel" category="other" - classname="org.apache.tools.ant.taskdefs.optional.sos.SOSLabel" - > - - <short-description><![CDATA[Labels Visual SourceSafe files via a SourceOffSite server.]]></short-description> - <description> - <![CDATA[Labels Visual SourceSafe files via a SourceOffSite server. - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>The label to apply to a project</td> - <td>Yes</td> - </tr> - <tr> - <td>comment</td> - <td>A comment to be applied to all files being labeled</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply to all files being labelled; - optional, only valid in SOSLabel.]]></short-description> - <description><![CDATA[ - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - ]]></description> - </attribute> - <attribute name="file" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Filename to act upon; optional.]]></short-description> - <description><![CDATA[ - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Labeled version to operate on in SourceSafe.]]></short-description> - <description><![CDATA[ - Set the labeled version to operate on in SourceSafe - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Override the working directory and get to the specified path; optional.]]></short-description> - <description><![CDATA[ - Override the working directory and get to the specified path; optional. - ]]></description> - </attribute> - <attribute name="nocache" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.]]></short-description> - <description><![CDATA[ - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - ]]></description> - </attribute> - <attribute name="nocompress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag that disables compression when set; optional, default.]]></short-description> - <description><![CDATA[ - Flag that disables compression when set; optional, default - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe password; optional.]]></short-description> - <description><![CDATA[ - Set the SourceSafe password; optional. - ]]></description> - </attribute> - <attribute name="projectpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe project path without the "$" prefix; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe project path without the "$" prefix; required - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.]]></short-description> - <description><![CDATA[ - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - ]]></description> - </attribute> - <attribute name="soscmd" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.]]></short-description> - <description><![CDATA[ - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - ]]></description> - </attribute> - <attribute name="soshome" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The path to the SourceOffSite home directory.]]></short-description> - <description><![CDATA[ - The path to the SourceOffSite home directory - ]]></description> - </attribute> - <attribute name="sosserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.]]></short-description> - <description><![CDATA[ - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - ]]></description> - </attribute> - <attribute name="username" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe username; required.]]></short-description> - <description><![CDATA[ - Set the SourceSafe username; required. - ]]></description> - </attribute> - <attribute name="verbose" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Enable verbose output; optional, default false.]]></short-description> - <description><![CDATA[ - Enable verbose output; optional, default false - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A version number to get - - only works with the SOSGet on a file; optional.]]></short-description> - <description><![CDATA[ - Set the a version number to get - - only works with the SOSGet on a file; optional. - ]]></description> - </attribute> - <attribute name="vssserverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Path to the location of the ss.ini file; - required.]]></short-description> - <description><![CDATA[ - Set the path to the location of the ss.ini file; - required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="sound" category="other" - classname="org.apache.tools.ant.taskdefs.optional.sound.SoundTask" - > - - <short-description><![CDATA[Plays a sound file at the end of the build, according to whether the build failed or succeeded.]]></short-description> - <description> - <![CDATA[Plays a sound file at the end of the build, according to whether the build failed or succeeded. - - There are three attributes to be set: - - <code>source</code>: the location of the audio file to be played - <code>duration</code>: play the sound file continuously until "duration" milliseconds has expired - <code>loops</code>: the number of times the sound file should be played until stopped - - I have only tested this with .WAV and .AIFF sound file formats. Both seem - to work fine. - - plans for the future: - - use the midi api to define sounds (or drum beat etc) in xml and have - Ant play them back]]> - </description> - - <structure> - - <attributes> - </attributes> - - <elements> - <element name="fail" type="org.apache.tools.ant.taskdefs.optional.sound.SoundTask.BuildAlert" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a sound when the build fails.]]></short-description> - <description> - <![CDATA[add a sound when the build fails]]> - </description> - </element> - - <element name="success" type="org.apache.tools.ant.taskdefs.optional.sound.SoundTask.BuildAlert" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a sound when the build succeeds.]]></short-description> - <description> - <![CDATA[add a sound when the build succeeds]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="splash" category="other" - classname="org.apache.tools.ant.taskdefs.optional.splash.SplashTask" - > - - <short-description><![CDATA[Creates a splash screen.]]></short-description> - <description> - <![CDATA[Creates a splash screen. The splash screen is displayed - for the duration of the build and includes a handy progress bar as - well. Use in conjunction with the sound task to provide interest - whilst waiting for your builds to complete...]]> - </description> - - <structure> - - <attributes> - <attribute name="imageurl" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A URL pointing to an image to display; optional, default antlogo.gif - from the classpath.]]></short-description> - <description><![CDATA[ - A URL pointing to an image to display; optional, default antlogo.gif - from the classpath. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Proxy password; required if <tt>user</tt> is set.]]></short-description> - <description><![CDATA[ - Proxy password; required if <tt>user</tt> is set. - ]]></description> - </attribute> - <attribute name="port" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Proxy port; optional, default 80.]]></short-description> - <description><![CDATA[ - Proxy port; optional, default 80. - ]]></description> - </attribute> - <attribute name="proxy" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of proxy; optional.]]></short-description> - <description><![CDATA[ - name of proxy; optional. - ]]></description> - </attribute> - <attribute name="showduration" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[How long to show the splash screen in milliseconds, - optional; default 5000 ms.]]></short-description> - <description><![CDATA[ - how long to show the splash screen in milliseconds, - optional; default 5000 ms. - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Proxy user; optional, default =none.]]></short-description> - <description><![CDATA[ - Proxy user; optional, default =none. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="sql" category="database" - classname="org.apache.tools.ant.taskdefs.SQLExec" - > - - <short-description><![CDATA[Executes a series of SQL statements on a database using JDBC.]]></short-description> - <description> - <![CDATA[Executes a series of SQL statements on a database using JDBC. - - <p>Statements can - either be read in from a text file using the <i>src</i> attribute or from - between the enclosing SQL tags.</p> - <p>Multiple statements can be provided, separated by semicolons (or the - defined <i>delimiter</i>). Individual lines within the statements can be - commented using either --, // or REM at the start of the line.</p> - <p>The <i>autocommit</i> attribute specifies whether auto-commit should be - turned on or off whilst executing the statements. If auto-commit is turned - on each statement will be executed and committed. If it is turned off the - statements will all be executed as one transaction.</p> - <p>The <i>onerror</i> attribute specifies how to proceed when an error occurs - during the execution of one of the statements. - The possible values are: <b>continue</b> execution, only show the error; - <b>stop</b> execution and commit transaction; - and <b>abort</b> execution and transaction and fail task.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether output should be appended to or overwrite - an existing file.]]></short-description> - <description><![CDATA[ - whether output should be appended to or overwrite - an existing file. Defaults to false. - ]]></description> - </attribute> - <attribute name="autocommit" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Auto commit flag for database connection; - optional, default false.]]></short-description> - <description><![CDATA[ - Auto commit flag for database connection; - optional, default false. - ]]></description> - </attribute> - <attribute name="caching" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Caching loaders / driver.]]></short-description> - <description><![CDATA[ - Caching loaders / driver. This is to avoid - getting an OutOfMemoryError when calling this task - multiple times in a row; default: true - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath for loading the driver.]]></short-description> - <description><![CDATA[ - Sets the classpath for loading the driver. - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Classpath for loading the driver - using the classpath reference.]]></short-description> - <description><![CDATA[ - Set the classpath for loading the driver - using the classpath reference. - ]]></description> - </attribute> - <attribute name="delimiter" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Delimiter that separates SQL statements; - optional, default ";" - - <p>For example, set this to "go" and delimitertype to "ROW" for - Sybase ASE or MS SQL Server.</p>.]]></short-description> - <description><![CDATA[ - Set the delimiter that separates SQL statements; - optional, default ";" - - <p>For example, set this to "go" and delimitertype to "ROW" for - Sybase ASE or MS SQL Server.</p> - ]]></description> - </attribute> - <attribute name="delimitertype" type="org.apache.tools.ant.taskdefs.SQLExec.DelimiterType" - briefType=""normal", "row"" required="NOTDEFINED"> - <short-description><![CDATA[Delimiter type: "normal" or "row" (default "normal").]]></short-description> - <description><![CDATA[ - Set the delimiter type: "normal" or "row" (default "normal"). - - <p>The delimiter type takes two values - normal and row. Normal - means that any occurence of the delimiter terminate the SQL - command whereas with row, only a line containing just the - delimiter is recognized as the end of the command.</p> - ]]></description> - </attribute> - <attribute name="driver" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Class name of the JDBC driver; required.]]></short-description> - <description><![CDATA[ - Class name of the JDBC driver; required. - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[File encoding to use on the SQL files read in.]]></short-description> - <description><![CDATA[ - Set the file encoding to use on the SQL files read in - ]]></description> - </attribute> - <attribute name="onerror" type="org.apache.tools.ant.taskdefs.SQLExec.OnError" - briefType=""continue", "stop", "abort"" required="NOTDEFINED"> - <short-description><![CDATA[Action to perform when statement fails: continue, stop, or abort - optional; default "abort".]]></short-description> - <description><![CDATA[ - Action to perform when statement fails: continue, stop, or abort - optional; default "abort" - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output file; - optional, defaults to the Ant log.]]></short-description> - <description><![CDATA[ - Set the output file; - optional, defaults to the Ant log. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Password; required.]]></short-description> - <description><![CDATA[ - Sets the password; required. - ]]></description> - </attribute> - <attribute name="print" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Print result sets from the statements; - optional, default false.]]></short-description> - <description><![CDATA[ - Print result sets from the statements; - optional, default false - ]]></description> - </attribute> - <attribute name="rdbms" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Execute task only if the lower case product name - of the DB matches this.]]></short-description> - <description><![CDATA[ - Execute task only if the lower case product name - of the DB matches this - ]]></description> - </attribute> - <attribute name="showheaders" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Print headers for result sets from the - statements; optional, default true.]]></short-description> - <description><![CDATA[ - Print headers for result sets from the - statements; optional, default true. - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the SQL file to be run.]]></short-description> - <description><![CDATA[ - Set the name of the SQL file to be run. - Required unless statements are enclosed in the buildfile - ]]></description> - </attribute> - <attribute name="url" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Database connection URL; required.]]></short-description> - <description><![CDATA[ - Sets the database connection URL; required. - ]]></description> - </attribute> - <attribute name="userid" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[User name for the connection; required.]]></short-description> - <description><![CDATA[ - Set the user name for the connection; required. - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Version string, execute task only if - rdbms version match; optional.]]></short-description> - <description><![CDATA[ - Sets the version string, execute task only if - rdbms version match; optional. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files (nested fileset attribute).]]></short-description> - <description> - <![CDATA[Adds a set of files (nested fileset attribute).]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Add a path to the classpath for loading the driver.]]></short-description> - <description> - <![CDATA[Add a path to the classpath for loading the driver.]]> - </description> - </element> - - <element name="transaction" type="org.apache.tools.ant.taskdefs.SQLExec.Transaction" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a SQL transaction to execute.]]></short-description> - <description> - <![CDATA[Add a SQL transaction to execute]]> - </description> - </element> - - </elements> - - <body > - <description><![CDATA[ - Set an inline SQL command to execute. - NB: Properties are not expanded in this text. - ]]></description> - </body> - - </structure> - -</task> - - -<task name="stylebook" category="other" - classname="org.apache.tools.ant.taskdefs.optional.StyleBook" - > - - <short-description><![CDATA[Executes the Apache Stylebook documentation generator.]]></short-description> - <description> - <![CDATA[Executes the Apache Stylebook documentation generator. - Unlike the commandline version of this tool, all three arguments - are required to run stylebook. - <p> - Being extended from <Java>, all the parent's attributes - and options are available. Do not set any apart from the <tt>classpath</tt> - as they are not guaranteed to be there in future.]]> - </description> - - <structure> - - <attributes> - <attribute name="append" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, append output to existing file.]]></short-description> - <description><![CDATA[ - If true, append output to existing file. - ]]></description> - </attribute> - <attribute name="book" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The book xml file that the documentation generation starts from; - required.]]></short-description> - <description><![CDATA[ - The book xml file that the documentation generation starts from; - required. - ]]></description> - </attribute> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Java class to execute.]]></short-description> - <description><![CDATA[ - Sets the Java class to execute. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when running the Java class.]]></short-description> - <description><![CDATA[ - Set the classpath to be used when running the Java class - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to use, by reference.]]></short-description> - <description><![CDATA[ - Classpath to use, by reference. - ]]></description> - </attribute> - <attribute name="dir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The working directory of the process.]]></short-description> - <description><![CDATA[ - The working directory of the process - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, then fail if the command exits with a - returncode other than 0.]]></short-description> - <description><![CDATA[ - If true, then fail if the command exits with a - returncode other than 0 - ]]></description> - </attribute> - <attribute name="fork" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, execute in a new VM.]]></short-description> - <description><![CDATA[ - If true, execute in a new VM. - ]]></description> - </attribute> - <attribute name="jvmversion" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[JVM version.]]></short-description> - <description><![CDATA[ - Sets the JVM version. - ]]></description> - </attribute> - <attribute name="jar" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The location of the JAR file to execute.]]></short-description> - <description><![CDATA[ - The location of the JAR file to execute. - ]]></description> - </attribute> - <attribute name="jvm" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Command used to start the VM (only if not forking).]]></short-description> - <description><![CDATA[ - Set the command used to start the VM (only if not forking). - ]]></description> - </attribute> - <attribute name="jvmargs" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Command line arguments for the JVM.]]></short-description> - <description><![CDATA[ - Set the command line arguments for the JVM. - ]]></description> - </attribute> - <attribute name="loaderconfig" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[A loader configuration to send to stylebook; optional.]]></short-description> - <description><![CDATA[ - A loader configuration to send to stylebook; optional. - ]]></description> - </attribute> - <attribute name="maxmemory" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Corresponds to -mx or -Xmx depending on VM version.]]></short-description> - <description><![CDATA[ - Corresponds to -mx or -Xmx depending on VM version. - ]]></description> - </attribute> - <attribute name="newenvironment" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, use a completely new environment.]]></short-description> - <description><![CDATA[ - If true, use a completely new environment. - - <p>Will be ignored if we are not forking a new VM. - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[File the output of the process is redirected to.]]></short-description> - <description><![CDATA[ - File the output of the process is redirected to. - ]]></description> - </attribute> - <attribute name="skindirectory" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The directory that contains the stylebook skin; - required.]]></short-description> - <description><![CDATA[ - the directory that contains the stylebook skin; - required. - ]]></description> - </attribute> - <attribute name="targetdirectory" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The destination directory where the documentation is generated; - required.]]></short-description> - <description><![CDATA[ - the destination directory where the documentation is generated; - required. - ]]></description> - </attribute> - <attribute name="timeout" type="java.lang.Long" - briefType="long" required="NOTDEFINED"> - <short-description><![CDATA[Timeout in milliseconds after which the process will be killed.]]></short-description> - <description><![CDATA[ - Timeout in milliseconds after which the process will be killed. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds an environment variable.]]></short-description> - <description> - <![CDATA[Adds an environment variable. - - <p>Will be ignored if we are not forking a new VM.]]> - </description> - </element> - - <element name="sysproperty" type="org.apache.tools.ant.types.Environment.Variable" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a system property.]]></short-description> - <description> - <![CDATA[Adds a system property.]]> - </description> - </element> - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a command-line argument.]]></short-description> - <description> - <![CDATA[Adds a command-line argument.]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a path to the classpath.]]></short-description> - <description> - <![CDATA[Adds a path to the classpath.]]> - </description> - </element> - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a JVM argument.]]></short-description> - <description> - <![CDATA[Adds a JVM argument.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="tar" category="packaging" - classname="org.apache.tools.ant.taskdefs.Tar" - matchingTask="true"> - - <!-- tar task --> -<external> -<description> -<p>Creates a tar archive.</p> - -<p>The <i>basedir</i> attribute is the reference directory from where to tar.</p> - -<p>This task is a <a href="../dirtasks.html#directorybasedtasks">directory based task</a> -and, as such, forms an implicit <a href="../CoreTypes/fileset.html">Fileset</a>. This -defines which files, relative to the <i>basedir</i>, will be included in the -archive. The tar task supports all the attributes of Fileset to refine the -set of files to be included in the implicit fileset.</p> - -<p>In addition to the implicit fileset, the tar task supports nested filesets. These -filesets are extended to allow control over the access mode, username and groupname -to be applied to the tar entries. This is useful, for example, when preparing archives for -Unix systems where some files need to have execute permission.</p> - -<p>Early versions of tar did not support path lengths greater than 100 -characters. Modern versions of tar do so, but in incompatible ways. -The behaviour of the tar task when it encounters such paths is -controlled by the <i>longfile</i> attribute. -If the longfile attribute is set to <code>fail</code>, any long paths will -cause the tar task to fail. If the longfile attribute is set to -<code>truncate</code>, any long paths will be truncated to the 100 character -maximum length prior to adding to the archive. If the value of the longfile -attribute is set to <code>omit</code> then files containing long paths will be -omitted from the archive. Either option ensures that the archive can be -untarred by any compliant version of tar. If the loss of path or file -information is not acceptable, and it rarely is, longfile may be set to the -value <code>gnu</code>. The tar task will then produce a GNU tar file which -can have arbitrary length paths. Note however, that the resulting archive will -only be able to be untarred with GNU tar. The default for the longfile -attribute is <code>warn</code> which behaves just like the gnu option except -that it produces a warning for each file path encountered that does not match -the limit.</p> - -<p>Note that this task does not perform compression. You might want to use the -<a href="gzip.html">GZip</a> task to prepare a .tar.gz package.</p> -</description> - -<section anchor="examples" name="Examples"> -<pre> <tar tarfile="${dist}/manual.tar" basedir="htdocs/manual"/> - <gzip zipfile="${dist}/manual.tar.gz" src="${dist}/manual.tar"/></pre> -<p>tars all files in the <code>htdocs/manual</code> directory into a file called <code>manual.tar</code> -in the <code>${dist}</code> directory, then applies the gzip task to compress -it.</p> -<pre> <tar destfile="${dist}/manual.tar" - basedir="htdocs/manual" - excludes="mydocs/**, **/todo.html" - /></pre> -<p>tars all files in the <code>htdocs/manual</code> directory into a file called <code>manual.tar</code> -in the <code>${dist}</code> directory. Files in the directory <code>mydocs</code>, -or files with the name <code>todo.html</code> are excluded.</p> - -<pre> -<tar destfile="${basedir}/docs.tar"> - <tarfileset dir="${dir.src}/docs" - fullpath="/usr/doc/ant/README" - preserveLeadingSlashes="true"> - <include name="readme.txt"/> - </tarfileset> - <tarfileset dir="${dir.src}/docs" - prefix="/usr/doc/ant" - preserveLeadingSlashes="true"> - <include name="*.html"/> - </tarfileset> -</tar></pre> - -<p> - Writes the file <code>docs/readme.txt</code> as - <code>/usr/doc/ant/README</code> into the archive. All - <code>*.html</code> files in the <code>docs</code> directory are - prefixed by <code>/usr/doc/ant</code>, so for example - <code>docs/index.html</code> is written as - <code>/usr/doc/ant/index.html</code> to the archive. -</p> - -<pre><tar longfile="gnu" - destfile="${dist.base}/${dist.name}-src.tar" > - <tarfileset dir="${dist.name}/.." mode="755" username="ant" group="ant"> - <include name="${dist.name}/bootstrap.sh"/> - <include name="${dist.name}/build.sh"/> - </tarfileset> - <tarfileset dir="${dist.name}/.." username="ant" group="ant"> - <include name="${dist.name}/**"/> - <exclude name="${dist.name}/bootstrap.sh"/> - <exclude name="${dist.name}/build.sh"/> - </tarfileset> -</tar> </pre> - -<p>This example shows building a tar which uses the GNU extensions for long paths and -where some files need to be marked as executable (mode 755) -and the rest are use the default mode (read-write by owner). The first -fileset selects just the executable files. The second fileset must exclude -the executable files and include all others. </p> - -<p><strong>Note: </strong> The tar task does not ensure that a file is only selected -by one fileset. If the same file is selected by more than one fileset, it will be included in the -tar file twice, with the same path.</p> - -<p><strong>Note:</strong> The patterns in the include and exclude -elements are considered to be relative to the corresponding dir -attribute as with all other filesets. In the example above, -<code>${dist.name}</code> is not an absolute path, but a simple name -of a directory, so <code>${dist.name}</code> is a valid path relative -to <code>${dist.name}/..</code>.</p> - -</section> -</external> - - <short-description><![CDATA[Creates a tar archive.]]></short-description> - <description> - <![CDATA[Creates a tar archive.]]> - </description> - - <structure> - - <attributes> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[This is the base directory to look in for things to tar.]]></short-description> - <description><![CDATA[ - This is the base directory to look in for things to tar. - ]]></description> - </attribute> - <attribute name="compression" type="org.apache.tools.ant.taskdefs.Tar.TarCompressionMethod" - briefType=""none", "gzip", "bzip2"" required="NOTDEFINED"> - <short-description><![CDATA[Set compression method.]]></short-description> - <description><![CDATA[ - Set compression method. - Allowable values are - <ul> - <li> none - no compression - <li> gzip - Gzip compression - <li> bzip2 - Bzip2 compression - </ul> - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Set is the name/location of where to create the tar file.]]></short-description> - <description><![CDATA[ - Set is the name/location of where to create the tar file. - ]]></description> - </attribute> - <attribute name="longfile" type="org.apache.tools.ant.taskdefs.Tar.TarLongFileMode" - briefType=""warn", "fail", "truncate", "gnu", "omit"" required="NOTDEFINED"> - <short-description><![CDATA[Set how to handle long files, those with a path>100 chars.]]></short-description> - <description><![CDATA[ - Set how to handle long files, those with a path>100 chars. - Optional, default=warn. - <p> - Allowable values are - <ul> - <li> truncate - paths are truncated to the maximum length - <li> fail - paths greater than the maximim cause a build exception - <li> warn - paths greater than the maximum cause a warning and GNU is used - <li> gnu - GNU extensions are used for any paths greater than the maximum. - <li> omit - paths greater than the maximum are omitted from the archive - </ul> - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="tarfileset" type="org.apache.tools.ant.taskdefs.Tar.TarFileSet" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a new fileset with the option to specify permissions.]]></short-description> - <description> - <![CDATA[Add a new fileset with the option to specify permissions]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="taskdef" category="internal" - classname="org.apache.tools.ant.taskdefs.Taskdef" - > - - <short-description><![CDATA[Adds a task definition to the current project, such that this new task can be used in the current project.]]></short-description> - <description> - <![CDATA[Adds a task definition to the current project, such that this new task can be - used in the current project. Two attributes are needed, the name that identifies - this task uniquely, and the full name of the class (including the packages) that - implements this task.</p> - <p>You can also define a group of tasks at once using the file or - resource attributes. These attributes point to files in the format of - Java property files. Each line defines a single task in the - format:</p> - <pre> - taskname=fully.qualified.java.classname - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The full class name of the object being defined.]]></short-description> - <description><![CDATA[ - the full class name of the object being defined. - Required, unless file or resource have - been specified. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when searching for component being defined.]]></short-description> - <description><![CDATA[ - Set the classpath to be used when searching for component being defined - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Reference to a classpath to use when loading the files.]]></short-description> - <description><![CDATA[ - reference to a classpath to use when loading the files. - To actually share the same loader, set loaderref as well - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property file to load - ant name/classname pairs from.]]></short-description> - <description><![CDATA[ - Name of the property file to load - ant name/classname pairs from. - ]]></description> - </attribute> - <attribute name="loaderref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Use the reference to locate the loader.]]></short-description> - <description><![CDATA[ - Use the reference to locate the loader. If the loader is not - found, taskdef will use the specified classpath and register it - with the specified name. - This allow multiple taskdef/typedef to use the same class loader, - so they can be used together. It eliminate the need to - put them in the CLASSPATH. - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property resource to load - ant name/classname pairs from.]]></short-description> - <description><![CDATA[ - Name of the property resource to load - ant name/classname pairs from. - ]]></description> - </attribute> - <attribute name="resource" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property resource to load - ant name/classname pairs from.]]></short-description> - <description><![CDATA[ - Name of the property resource to load - ant name/classname pairs from. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create the classpath to be used when searching for component being defined.]]></short-description> - <description> - <![CDATA[Create the classpath to be used when searching for component being defined]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="telnet" category="other" - classname="org.apache.tools.ant.taskdefs.optional.net.TelnetTask" - > - - <short-description><![CDATA[Automates the telnet protocol.]]></short-description> - <description> - <![CDATA[Automates the telnet protocol.]]> - </description> - - <structure> - - <attributes> - <attribute name="initialcr" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Send a carriage return after connecting; optional, defaults to false.]]></short-description> - <description><![CDATA[ - send a carriage return after connecting; optional, defaults to false. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login password to use - required if <tt>userid</tt> is set.]]></short-description> - <description><![CDATA[ - Set the the login password to use - required if <tt>userid</tt> is set. - ]]></description> - </attribute> - <attribute name="port" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Tcp port to connect to; default is 23.]]></short-description> - <description><![CDATA[ - Set the tcp port to connect to; default is 23. - ]]></description> - </attribute> - <attribute name="server" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Hostname or address of the remote server.]]></short-description> - <description><![CDATA[ - Set the hostname or address of the remote server. - ]]></description> - </attribute> - <attribute name="timeout" type="java.lang.Integer" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Default timeout in seconds to wait for a response, - zero means forever (the default).]]></short-description> - <description><![CDATA[ - set a default timeout in seconds to wait for a response, - zero means forever (the default) - ]]></description> - </attribute> - <attribute name="userid" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login id to use on the server; - required if <tt>password</tt> is set.]]></short-description> - <description><![CDATA[ - Set the the login id to use on the server; - required if <tt>password</tt> is set. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="read" type="org.apache.tools.ant.taskdefs.optional.net.TelnetTask.TelnetSubTask" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[A string to wait for from the server.]]></short-description> - <description> - <![CDATA[A string to wait for from the server. - A subTask <read> tag was found. Create the object, - Save it in our list, and return it.]]> - </description> - </element> - - <element name="write" type="org.apache.tools.ant.taskdefs.optional.net.TelnetTask.TelnetSubTask" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add text to send to the server - A subTask <write> tag was found.]]></short-description> - <description> - <![CDATA[Add text to send to the server - A subTask <write> tag was found. Create the object, - Save it in our list, and return it.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="tempfile" category="other" - classname="org.apache.tools.ant.taskdefs.TempFile" - > - - <short-description><![CDATA[This task sets a property to the name of a temporary file.]]></short-description> - <description> - <![CDATA[This task sets a property to the name of a temporary file. - Unlike the Java1.2 method to create a temporary file, this task - does work on Java1.1. Also, it does not actually create the - temporary file, but it does guarantee that the file did not - exist when the task was executed. - <p> - Examples - <pre><tempfile property="temp.file" /></pre> - create a temporary file - <pre><tempfile property="temp.file" suffix=".xml" /></pre> - create a temporary file with the .xml suffix. - <pre><tempfile property="temp.file" destDir="build"/></pre> - create a temp file in the build subdir]]> - </description> - - <structure> - - <attributes> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory.]]></short-description> - <description><![CDATA[ - destination directory. If null, -the parent directory is used instead - ]]></description> - </attribute> - <attribute name="prefix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Optional prefix string.]]></short-description> - <description><![CDATA[ - optional prefix string - ]]></description> - </attribute> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The property you wish to assign the temporary file to.]]></short-description> - <description><![CDATA[ - The property you wish to assign the temporary file to - ]]></description> - </attribute> - <attribute name="suffix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Suffix string for the temp file (optional).]]></short-description> - <description><![CDATA[ - Suffix string for the temp file (optional) - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="touch" category="filesystem" - classname="org.apache.tools.ant.taskdefs.Touch" - > - - <short-description><![CDATA[Touch a file and/or fileset(s); corresponds to the Unix touch command.]]></short-description> - <description> - <![CDATA[Touch a file and/or fileset(s); corresponds to the Unix touch command. - - <p>If the file to touch doesn't exist, an empty one is - created. </p> - - <p>Note: Setting the modification time of files is not supported in - JDK 1.1.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="datetime" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The new modification time of the file - in the format MM/DD/YYYY HH:MM AM <i>or</i> PM; - Optional, default=now.]]></short-description> - <description><![CDATA[ - the new modification time of the file - in the format MM/DD/YYYY HH:MM AM <i>or</i> PM; - Optional, default=now - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Single source file to touch.]]></short-description> - <description><![CDATA[ - Sets a single source file to touch. If the file does not exist - an empty file will be created. - ]]></description> - </attribute> - <attribute name="millis" type="long" - briefType="long" required="NOTDEFINED"> - <short-description><![CDATA[The new modification time of the file - in milliseconds since midnight Jan 1 1970.]]></short-description> - <description><![CDATA[ - the new modification time of the file - in milliseconds since midnight Jan 1 1970. - Optional, default=now - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a set of files to touch.]]></short-description> - <description> - <![CDATA[Add a set of files to touch]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="translate" category="other" - classname="org.apache.tools.ant.taskdefs.optional.i18n.Translate" - matchingTask="true"> - - <short-description><![CDATA[Translates text embedded in files using Resource Bundle files.]]></short-description> - <description> - <![CDATA[Translates text embedded in files using Resource Bundle files.]]> - </description> - - <structure> - - <attributes> - <attribute name="bundle" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets Family name of resource bundle; required.]]></short-description> - <description><![CDATA[ - Sets Family name of resource bundle; required. - ]]></description> - </attribute> - <attribute name="bundlecountry" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets locale specific country of resource bundle; optional.]]></short-description> - <description><![CDATA[ - Sets locale specific country of resource bundle; optional. - ]]></description> - </attribute> - <attribute name="bundleencoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets Resource Bundle file encoding scheme; optional.]]></short-description> - <description><![CDATA[ - Sets Resource Bundle file encoding scheme; optional. Defaults to source file - encoding - ]]></description> - </attribute> - <attribute name="bundlelanguage" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets locale specific language of resource bundle; optional.]]></short-description> - <description><![CDATA[ - Sets locale specific language of resource bundle; optional. - ]]></description> - </attribute> - <attribute name="bundlevariant" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets locale specific variant of resource bundle; optional.]]></short-description> - <description><![CDATA[ - Sets locale specific variant of resource bundle; optional. - ]]></description> - </attribute> - <attribute name="destencoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets destination file encoding scheme; optional.]]></short-description> - <description><![CDATA[ - Sets destination file encoding scheme; optional. Defaults to source file - encoding - ]]></description> - </attribute> - <attribute name="endtoken" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets ending token to identify keys; required.]]></short-description> - <description><![CDATA[ - Sets ending token to identify keys; required. - ]]></description> - </attribute> - <attribute name="forceoverwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether or not to overwrite existing file irrespective of - whether it is newer than the source file as well as the - resource bundle file.]]></short-description> - <description><![CDATA[ - Whether or not to overwrite existing file irrespective of - whether it is newer than the source file as well as the - resource bundle file. - Defaults to false. - ]]></description> - </attribute> - <attribute name="srcencoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets source file encoding scheme; optional, - defaults to encoding of local system.]]></short-description> - <description><![CDATA[ - Sets source file encoding scheme; optional, - defaults to encoding of local system. - ]]></description> - </attribute> - <attribute name="starttoken" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Sets starting token to identify keys; required.]]></short-description> - <description><![CDATA[ - Sets starting token to identify keys; required. - ]]></description> - </attribute> - <attribute name="todir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Sets Destination directory; required.]]></short-description> - <description><![CDATA[ - Sets Destination directory; required. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files to translate as a nested fileset element.]]></short-description> - <description> - <![CDATA[Adds a set of files to translate as a nested fileset element.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="tstamp" category="utility" - classname="org.apache.tools.ant.taskdefs.Tstamp" - > - - <short-description><![CDATA[Sets properties to the current time, or offsets from the current time.]]></short-description> - <description> - <![CDATA[Sets properties to the current time, or offsets from the current time. - The default properties are TSTAMP, DSTAMP and TODAY;]]> - </description> - - <structure> - - <attributes> - <attribute name="prefix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Prefix for the properties.]]></short-description> - <description><![CDATA[ - Set a prefix for the properties. If the prefix does not end with a "." - one is automatically added - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="format" type="org.apache.tools.ant.taskdefs.Tstamp.CustomFormat" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create a custom format with the the current prefix.]]></short-description> - <description> - <![CDATA[create a custom format with the the current prefix.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="typedef" category="internal" - classname="org.apache.tools.ant.taskdefs.Typedef" - > - - <short-description><![CDATA[Adds a data type definition to the current project.]]></short-description> - <description> - <![CDATA[Adds a data type definition to the current project. - Two attributes are - needed, the name that identifies this data type uniquely, and the full - name of the class (including the packages) that implements this - type. - <p>You can also define a group of data types at once using the file or - resource attributes. These attributes point to files in the format of - Java property files. Each line defines a single data type in the - format:</p> - <pre> - typename=fully.qualified.java.classname - </pre> - <p>Typedef should be used to add your own types to the system. Data - types are things likepaths or filesets that can be defined at - the project level and referenced via their ID attribute.</p> - <p>Custom data types usually need custom tasks to put them to good use.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The full class name of the object being defined.]]></short-description> - <description><![CDATA[ - the full class name of the object being defined. - Required, unless file or resource have - been specified. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used when searching for component being defined.]]></short-description> - <description><![CDATA[ - Set the classpath to be used when searching for component being defined - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Reference to a classpath to use when loading the files.]]></short-description> - <description><![CDATA[ - reference to a classpath to use when loading the files. - To actually share the same loader, set loaderref as well - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property file to load - ant name/classname pairs from.]]></short-description> - <description><![CDATA[ - Name of the property file to load - ant name/classname pairs from. - ]]></description> - </attribute> - <attribute name="loaderref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Use the reference to locate the loader.]]></short-description> - <description><![CDATA[ - Use the reference to locate the loader. If the loader is not - found, taskdef will use the specified classpath and register it - with the specified name. - This allow multiple taskdef/typedef to use the same class loader, - so they can be used together. It eliminate the need to - put them in the CLASSPATH. - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property resource to load - ant name/classname pairs from.]]></short-description> - <description><![CDATA[ - Name of the property resource to load - ant name/classname pairs from. - ]]></description> - </attribute> - <attribute name="resource" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the property resource to load - ant name/classname pairs from.]]></short-description> - <description><![CDATA[ - Name of the property resource to load - ant name/classname pairs from. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Create the classpath to be used when searching for component being defined.]]></short-description> - <description> - <![CDATA[Create the classpath to be used when searching for component being defined]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="untar" category="packaging" - classname="org.apache.tools.ant.taskdefs.Untar" - > - - <short-description><![CDATA[Untar a file.]]></short-description> - <description> - <![CDATA[Untar a file. - <p>For JDK 1.1 "last modified time" field is set to current time instead of being - carried from the archive file.</p> - <p>PatternSets are used to select files to extract - <I>from</I> the archive. If no patternset is used, all files are extracted. - </p> - <p>FileSet>s may be used used to select archived files - to perform unarchival upon. - </p> - <p>File permissions will not be restored on extracted files.</p> - <p>The untar task recognizes the long pathname entries used by GNU tar.<p>]]> - </description> - - <structure> - - <attributes> - <attribute name="compression" type="org.apache.tools.ant.taskdefs.Untar.UntarCompressionMethod" - briefType=""none", "gzip", "bzip2"" required="NOTDEFINED"> - <short-description><![CDATA[Set decompression algorithm to use; default=none.]]></short-description> - <description><![CDATA[ - Set decompression algorithm to use; default=none. - - Allowable values are - <ul> - <li>none - no compression - <li>gzip - Gzip compression - <li>bzip2 - Bzip2 compression - </ul> - ]]></description> - </attribute> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory.]]></short-description> - <description><![CDATA[ - Set the destination directory. File will be unzipped into the - destination directory. - ]]></description> - </attribute> - <attribute name="overwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive?.]]></short-description> - <description><![CDATA[ - Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive? - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to zip-file.]]></short-description> - <description><![CDATA[ - Set the path to zip-file. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a fileset.]]></short-description> - <description> - <![CDATA[Add a fileset]]> - </description> - </element> - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" - briefType="Patternset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a patternset.]]></short-description> - <description> - <![CDATA[Add a patternset]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="unzip" category="packaging" - classname="org.apache.tools.ant.taskdefs.Expand" - > - - <short-description><![CDATA[Unzip a file.]]></short-description> - <description> - <![CDATA[Unzip a file.]]> - </description> - - <structure> - - <attributes> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory.]]></short-description> - <description><![CDATA[ - Set the destination directory. File will be unzipped into the - destination directory. - ]]></description> - </attribute> - <attribute name="overwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive?.]]></short-description> - <description><![CDATA[ - Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive? - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Path to zip-file.]]></short-description> - <description><![CDATA[ - Set the path to zip-file. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a fileset.]]></short-description> - <description> - <![CDATA[Add a fileset]]> - </description> - </element> - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" - briefType="Patternset" - required="NOTDEFINED"> - <short-description><![CDATA[Add a patternset.]]></short-description> - <description> - <![CDATA[Add a patternset]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="uptodate" category="control" - classname="org.apache.tools.ant.taskdefs.UpToDate" - > - - <short-description><![CDATA[Sets the given property if the specified target has a timestamp greater than all of the source files.]]></short-description> - <description> - <![CDATA[Sets the given property if the specified target has a timestamp - greater than all of the source files.]]> - </description> - - <structure> - - <attributes> - <attribute name="property" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The property to set if the target file is more up-to-date than - (each of) the source file(s).]]></short-description> - <description><![CDATA[ - The property to set if the target file is more up-to-date than - (each of) the source file(s). - ]]></description> - </attribute> - <attribute name="srcfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file that must be older than the target file - if the property is to be set.]]></short-description> - <description><![CDATA[ - The file that must be older than the target file - if the property is to be set. - ]]></description> - </attribute> - <attribute name="targetfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file which must be more up-to-date than (each of) the source file(s) - if the property is to be set.]]></short-description> - <description><![CDATA[ - The file which must be more up-to-date than (each of) the source file(s) - if the property is to be set. - ]]></description> - </attribute> - <attribute name="value" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The value to set the named property to if the target file is more - up-to-date than (each of) the source file(s).]]></short-description> - <description><![CDATA[ - The value to set the named property to if the target file is more - up-to-date than (each of) the source file(s). Defaults to 'true'. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="srcfiles" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Nested <srcfiles> element.]]></short-description> - <description> - <![CDATA[Nested <srcfiles> element.]]> - </description> - </element> - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" - briefType="Mapper" - required="NOTDEFINED"> - <short-description><![CDATA[Defines the FileNameMapper to use (nested mapper element).]]></short-description> - <description> - <![CDATA[Defines the FileNameMapper to use (nested mapper element).]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="vajexport" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ide.VAJExport" - > - - <short-description><![CDATA[Export packages from the Visual Age for Java workspace.]]></short-description> - <description> - <![CDATA[Export packages from the Visual Age for Java workspace. - The packages are specified similar to all other MatchingTasks. - Since the VA Workspace is not file based, this task is simulating - a directory hierarchy for the workspace: - The 'root' contains all project 'dir's, and the projects contain - their respective package 'dir's. - Example: - <blockquote> - <vajexport destdir="C:/builddir/source"> - <include name="/MyVAProject/org/foo/subsystem1/**" /> - <exclude name="/MyVAProject/org/foo/subsystem1/test/**"/> - </vajexport> - </blockquote> - exports all packages in the project MyVAProject which start with - 'org.foo.subsystem1' except of these starting with - 'org.foo.subsystem1.test'. - - There are flags to choose which items to export: - exportSources: export Java sources - exportResources: export project resources - exportClasses: export class files - exportDebugInfo: export class files with debug info (use with exportClasses) - default is exporting Java files and resources.]]> - </description> - - <structure> - - <attributes> - <attribute name="defaultexcludes" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether default exclusions should be used or not; default true.]]></short-description> - <description><![CDATA[ - Sets whether default exclusions should be used or not; default true. - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory into which the selected - items should be exported; required.]]></short-description> - <description><![CDATA[ - Set the destination directory into which the selected - items should be exported; required. - ]]></description> - </attribute> - <attribute name="excludes" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set of exclude patterns.]]></short-description> - <description><![CDATA[ - Sets the set of exclude patterns. Patterns may be separated by a comma - or a space. Currently only patterns denoting packages are - supported - ]]></description> - </attribute> - <attribute name="exportclasses" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Optional flag to export the class files; default false.]]></short-description> - <description><![CDATA[ - optional flag to export the class files; default false. - ]]></description> - </attribute> - <attribute name="exportdebuginfo" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Optional flag to export the debug info; default false. - debug info.]]></short-description> - <description><![CDATA[ - optional flag to export the debug info; default false. - debug info - ]]></description> - </attribute> - <attribute name="exportresources" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Optional flag to export the resource file; default true.]]></short-description> - <description><![CDATA[ - optional flag to export the resource file; default true. - ]]></description> - </attribute> - <attribute name="exportsources" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Optional flag to export the Java files; default true.]]></short-description> - <description><![CDATA[ - optional flag to export the Java files; default true. - ]]></description> - </attribute> - <attribute name="includes" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Set of include patterns.]]></short-description> - <description><![CDATA[ - Sets the set of include patterns. Patterns may be separated by a comma - or a space. Currently only patterns denoting packages are - supported - ]]></description> - </attribute> - <attribute name="overwrite" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If Overwrite is set, files will be overwritten during export.]]></short-description> - <description><![CDATA[ - if Overwrite is set, files will be overwritten during export - ]]></description> - </attribute> - <attribute name="remote" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name and port of a remote tool server, optiona.]]></short-description> - <description><![CDATA[ - Name and port of a remote tool server, optiona. - Format: <servername>:<port no>. - If this attribute is set, the tasks will be executed on the specified tool - server. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="exclude" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the exclude list.]]></short-description> - <description> - <![CDATA[add a name entry on the exclude list]]> - </description> - </element> - - <element name="include" type="org.apache.tools.ant.types.PatternSet.NameEntry" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a name entry on the include list.]]></short-description> - <description> - <![CDATA[add a name entry on the include list]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="vajimport" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ide.VAJImport" - > - - <short-description><![CDATA[Import source, class files, and resources to the Visual Age for Java workspace.]]></short-description> - <description> - <![CDATA[Import source, class files, and resources to the Visual Age for Java - workspace. - <p> - Example: - <pre> - <vajimport project="MyVAProject"> - <fileset dir="src"> - <include name="org/foo/subsystem1/**" /> - <exclude name="/org/foo/subsystem1/test/**" /> - </fileset> - </vajexport> - </pre> - import all source and resource files from the "src" directory - which start with 'org.foo.subsystem1', except of these starting with - 'org.foo.subsystem1.test' into the project MyVAProject. - </p> - <p>If MyVAProject isn't loaded into the Workspace, a new edition is - created in the repository and automatically loaded into the Workspace. - There has to be at least one nested FileSet element. - </p> - <p>There are attributes to choose which items to export: - <table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"><b>Attribute</b></td> - <td valign="top"><b>Description</b></td> - <td align="center" valign="top"><b>Required</b></td> - </tr> - <tr> - <td valign="top">project</td> - <td valign="top">the name of the Project to import to</td> - <td align="center" valign="top">Yes</td> - </tr> - <tr> - <td valign="top">importSources</td> - <td valign="top">import Java sources, defaults to "yes"</td> - <td align="center" valign="top">No</td> - </tr> - <tr> - <td valign="top">importResources</td> - <td valign="top">import resource files (anything that doesn't - end with .java or .class), defaults to "yes"</td> - <td align="center" valign="top">No</td> - </tr> - <tr> - <td valign="top">importClasses</td> - <td valign="top">import class files, defaults to "no"</td> - <td align="center" valign="top">No</td> - </tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="defaultexcludes" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether default exclusions should be used or not.]]></short-description> - <description><![CDATA[ - Sets whether default exclusions should be used or not. - ]]></description> - </attribute> - <attribute name="importclasses" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to import .class files; optional, default false.]]></short-description> - <description><![CDATA[ - Flag to import .class files; optional, default false. - ]]></description> - </attribute> - <attribute name="importresources" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Import resource files (anything that doesn't end in - .class or .java); optional, default true.]]></short-description> - <description><![CDATA[ - Import resource files (anything that doesn't end in - .class or .java); optional, default true. - ]]></description> - </attribute> - <attribute name="importsources" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Import .java files; optional, default true.]]></short-description> - <description><![CDATA[ - Import .java files; optional, default true. - ]]></description> - </attribute> - <attribute name="project" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The VisualAge for Java Project name to import into.]]></short-description> - <description><![CDATA[ - The VisualAge for Java Project name to import into. - ]]></description> - </attribute> - <attribute name="remote" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name and port of a remote tool server, optiona.]]></short-description> - <description><![CDATA[ - Name and port of a remote tool server, optiona. - Format: <servername>:<port no>. - If this attribute is set, the tasks will be executed on the specified tool - server. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files (nested fileset attribute).]]></short-description> - <description> - <![CDATA[Adds a set of files (nested fileset attribute).]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="vajload" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ide.VAJLoad" - > - - <short-description><![CDATA[Load specific project versions into the Visual Age for Java workspace.]]></short-description> - <description> - <![CDATA[Load specific project versions into the Visual Age for Java workspace. - Each project and version name has to be specified completely. - Example: - <blockquote> - <vajload> - <project name="MyVAProject" version="2.1"/> - <project name="Apache Xerces" version="1.2.0"/> - </vajload> - </blockquote>]]> - </description> - - <structure> - - <attributes> - <attribute name="remote" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name and port of a remote tool server, optiona.]]></short-description> - <description><![CDATA[ - Name and port of a remote tool server, optiona. - Format: <servername>:<port no>. - If this attribute is set, the tasks will be executed on the specified tool - server. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="vajproject" type="org.apache.tools.ant.taskdefs.optional.ide.VAJProjectDescription" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a project description entry on the project list.]]></short-description> - <description> - <![CDATA[Add a project description entry on the project list.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="vssadd" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSADD" - > - - <short-description><![CDATA[Performs Add commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Performs Add commands to Microsoft Visual SourceSafe. - Based on the VSS Checkin code by Martin Poeschl]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply; optional.]]></short-description> - <description><![CDATA[ - Sets the comment to apply; optional. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Local path.]]></short-description> - <description><![CDATA[ - Set the local path. - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set behaviour recursive or non-recursive.]]></short-description> - <description><![CDATA[ - Set behaviour recursive or non-recursive - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - <attribute name="writable" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Leave added files writable?.]]></short-description> - <description><![CDATA[ - Leave added files writable? Default: false. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vsscheckin" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCHECKIN" - > - - <short-description><![CDATA[Performs CheckIn commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Performs CheckIn commands to Microsoft Visual SourceSafe.]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply; optional.]]></short-description> - <description><![CDATA[ - Set the comment to apply; optional. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Local path.]]></short-description> - <description><![CDATA[ - Set the local path. - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to tell the task to recurse down the tree; - optional, default false.]]></short-description> - <description><![CDATA[ - Flag to tell the task to recurse down the tree; - optional, default false. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - <attribute name="writable" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Leave checked in files writable?.]]></short-description> - <description><![CDATA[ - Leave checked in files writable? Default: false. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vsscheckout" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCHECKOUT" - > - - <short-description><![CDATA[Performs CheckOut commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Performs CheckOut commands to Microsoft Visual SourceSafe. - <p>If you specify two or more attributes from version, date and - label only one will be used in the order version, date, label.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="date" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.]]></short-description> - <description><![CDATA[ - Set the date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.]]></short-description> - <description><![CDATA[ - Set the label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Local path.]]></short-description> - <description><![CDATA[ - Set the local path. - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to tell the task to recurse down the tree; - optional, default false.]]></short-description> - <description><![CDATA[ - Flag to tell the task to recurse down the tree; - optional, default false. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Version to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.]]></short-description> - <description><![CDATA[ - Set the version to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vsscp" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCP" - > - - <short-description><![CDATA[Performs CP (Change Project) commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Performs CP (Change Project) commands to Microsoft Visual SourceSafe. - <p>This task is typically used before a VssAdd in order to set the target project</p> - Based on the VSS Checkin code by Martin Poeschl]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vsscreate" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCREATE" - > - - <short-description><![CDATA[Creates a new project in Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Creates a new project in Microsoft Visual SourceSafe. - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>login</td> - <td>username,password</td> - <td>No</td> - </tr> - <tr> - <td>vsspath</td> - <td>SourceSafe path of project to be created</td> - <td>Yes</td> - </tr> - <tr> - <td>ssdir</td> - <td>directory where <code>ss.exe</code> resides. By default the task - expects it to be in the PATH.</td> - <td>No</td> - </tr> - <tr> - <td>quiet</td> - <td>suppress output (off by default)</td> - <td>No</td> - </tr> - <tr> - <td>failOnError</td> - <td>fail if there is an error creating the project (true by default)</td> - <td>No</td> - </tr> - <tr> - <td>autoresponse</td> - <td>What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this.</td> - <td>No</td> - </tr> - <tr> - <td>comment</td> - <td>The comment to use for this label. Empty or '-' for no comment.</td> - <td>No</td> - </tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Comment to apply in SourceSafe.]]></short-description> - <description><![CDATA[ - Sets the comment to apply in SourceSafe. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets whether task should fail if there is an error creating the project; - optional, default true.]]></short-description> - <description><![CDATA[ - Sets whether task should fail if there is an error creating the project; - optional, default true. - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Sets/clears quiet mode; optional, default false.]]></short-description> - <description><![CDATA[ - Sets/clears quiet mode; optional, default false. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vssget" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSGET" - > - - <short-description><![CDATA[Perform Get commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Perform Get commands to Microsoft Visual SourceSafe. - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>login</td> - <td>username,password</td> - <td>No</td> - </tr> - <tr> - <td>vsspath</td> - <td>SourceSafe path</td> - <td>Yes</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>writable</td> - <td>true or false</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false</td> - <td>No</td> - </tr> - <tr> - <td>version</td> - <td>a version number to get</td> - <td>No</td> - </tr> - <tr> - <td>date</td> - <td>a date stamp to get at</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>a label to get for</td> - <td>No</td> - </tr> - <tr> - <td>quiet</td> - <td>suppress output (off by default)</td> - <td>No</td> - </tr> - <tr> - <td>autoresponse</td> - <td>What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this.</td> - <td>No</td> - </tr> - </table> - <p>Note that only one of version, date or label should be specified</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="date" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.]]></short-description> - <description><![CDATA[ - Set the date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - <p> - ORIGINAL COMMENT THAT DOES NOT SEEM AT ALL VALID: - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. date="${date}" when date - has not been defined to ant! - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.]]></short-description> - <description><![CDATA[ - Set the label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - <p> - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. label="${label_server}" when label_server - has not been defined to ant! - ]]></description> - </attribute> - <attribute name="localpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Override the working directory and get to the specified path; optional.]]></short-description> - <description><![CDATA[ - Override the working directory and get to the specified path; optional. - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="quiet" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to suppress output when true ; false by default.]]></short-description> - <description><![CDATA[ - Flag to suppress output when true ; false by default. - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to tell the task to recurse down the tree; - optional, default false.]]></short-description> - <description><![CDATA[ - Flag to tell the task to recurse down the tree; - optional, default false. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Version number to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.]]></short-description> - <description><![CDATA[ - Set a version number to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - <p> - ORIGINAL COMMENT THAT DOES NOT SEEM AT ALL VALID: - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. version="${ver_server}" when ver_server - has not been defined to ant! - NO, in this case the version string is "${ver_server}". - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - <attribute name="writable" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Make fetched files writable; optional, default false.]]></short-description> - <description><![CDATA[ - make fetched files writable; optional, default false. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vsshistory" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSHISTORY" - > - - <short-description><![CDATA[Performs History commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Performs History commands to Microsoft Visual SourceSafe.]]> - </description> - - <structure> - - <attributes> - <attribute name="dateformat" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Format of dates in fromDate and toDate; optional.]]></short-description> - <description><![CDATA[ - Format of dates in fromDate and toDate; optional. - Used when calculating dates with - the numdays attribute. - This string uses the formatting rules of SimpleDateFormat. - Defaults to DateFormat.SHORT. - ]]></description> - </attribute> - <attribute name="fromdate" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Start Date for the Comparison of two versions; optional.]]></short-description> - <description><![CDATA[ - Set the Start Date for the Comparison of two versions; optional. - ]]></description> - </attribute> - <attribute name="fromlabel" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Start Label; optional.]]></short-description> - <description><![CDATA[ - Set the Start Label; optional - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="numdays" type="int" - briefType="int" required="NOTDEFINED"> - <short-description><![CDATA[Number of days for comparison; - optional.]]></short-description> - <description><![CDATA[ - Set the number of days for comparison; - optional. - <p> - The default value is 2 days. (maybe) - ]]></description> - </attribute> - <attribute name="output" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Output file name for the history; optional.]]></short-description> - <description><![CDATA[ - Set the output file name for the history; optional. - ]]></description> - </attribute> - <attribute name="recursive" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to tell the task to recurse down the tree; - optional, default false.]]></short-description> - <description><![CDATA[ - Flag to tell the task to recurse down the tree; - optional, default false. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="style" type="org.apache.tools.ant.taskdefs.optional.vss.MSVSSHISTORY.BriefCodediffNofile" - briefType=""brief", "codediff", "nofile", "default"" required="NOTDEFINED"> - <short-description><![CDATA[Specify the output style; optional.]]></short-description> - <description><![CDATA[ - Specify the output style; optional. - ]]></description> - </attribute> - <attribute name="todate" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[End Date for the Comparison of two versions; optional.]]></short-description> - <description><![CDATA[ - Set the End Date for the Comparison of two versions; optional. - ]]></description> - </attribute> - <attribute name="tolabel" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[End Label ; optional.]]></short-description> - <description><![CDATA[ - Set the End Label ; optional - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name the user whose changes we would like to see; optional.]]></short-description> - <description><![CDATA[ - Name the user whose changes we would like to see; optional - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="vsslabel" category="scm" - classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSLABEL" - > - - <short-description><![CDATA[Performs Label commands to Microsoft Visual SourceSafe.]]></short-description> - <description> - <![CDATA[Performs Label commands to Microsoft Visual SourceSafe. - - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>login</td> - <td>username,password</td> - <td>No</td> - </tr> - <tr> - <td>vsspath</td> - <td>SourceSafe path</td> - <td>Yes</td> - </tr> - <tr> - <td>ssdir</td> - <td>directory where <code>ss.exe</code> resides. By default the task - expects it to be in the PATH.</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>A label to apply to the hierarchy</td> - <td>Yes</td> - </tr> - <tr> - <td>version</td> - <td>An existing file or project version to label</td> - <td>No</td> - </tr> - <tr> - <td>autoresponse</td> - <td>What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this.</td> - <td>No</td> - </tr> - <tr> - <td>comment</td> - <td>The comment to use for this label. Empty or '-' for no comment.</td> - <td>No</td> - </tr> - </table>]]> - </description> - - <structure> - - <attributes> - <attribute name="autoresponse" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[What to respond with (sets the -I option).]]></short-description> - <description><![CDATA[ - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - ]]></description> - </attribute> - <attribute name="comment" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The comment to use for this label; optional.]]></short-description> - <description><![CDATA[ - The comment to use for this label; optional. - Empty or '-' for no comment. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - ]]></description> - </attribute> - <attribute name="label" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Label to apply; required.]]></short-description> - <description><![CDATA[ - Set the label to apply; required. - <p> - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. label="${label_server}" when label_server - has not been defined to ant! - ]]></description> - </attribute> - <attribute name="login" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The login to use when accessing VSS, formatted as "username,password"; - optional.]]></short-description> - <description><![CDATA[ - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - ]]></description> - </attribute> - <attribute name="serverpath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>srssafe.ini</code> resides; optional.]]></short-description> - <description><![CDATA[ - Set the directory where <code>srssafe.ini</code> resides; optional. - ]]></description> - </attribute> - <attribute name="ssdir" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Directory where <code>ss.exe</code> resides; optional.]]></short-description> - <description><![CDATA[ - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - ]]></description> - </attribute> - <attribute name="version" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name an existing file or project version to label; optional.]]></short-description> - <description><![CDATA[ - Name an existing file or project version to label; optional. - By default the current version is labelled. - <p> - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. version="${ver_server}" when ver_server - has not been defined to ant! - ]]></description> - </attribute> - <attribute name="vsspath" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.]]></short-description> - <description><![CDATA[ - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="waitfor" category="control" - classname="org.apache.tools.ant.taskdefs.WaitFor" - > - - <short-description><![CDATA[Wait for an external event to occur.]]></short-description> - <description> - <![CDATA[Wait for an external event to occur. - - Wait for an external process to start or to complete some - task. This is useful with the <code>parallel</code> task to - syncronize the execution of tests with server startup. - - The following attributes can be specified on a waitfor task: - <ul> - <li>maxwait - maximum length of time to wait before giving up</li> - <li>maxwaitunit - The unit to be used to interpret maxwait attribute</li> - <li>checkevery - amount of time to sleep between each check</li> - <li>checkeveryunit - The unit to be used to interpret checkevery attribute</li> - <li>timeoutproperty - name of a property to set if maxwait has been exceeded.</li> - </ul> - - The maxwaitunit and checkeveryunit are allowed to have the following values: - millesond, second, minute, hour, day and week. The default is millisecond.]]> - </description> - - <structure> - - <attributes> - <attribute name="checkevery" type="long" - briefType="long" required="NOTDEFINED"> - <short-description><![CDATA[Time between each check.]]></short-description> - <description><![CDATA[ - Set the time between each check - ]]></description> - </attribute> - <attribute name="checkeveryunit" type="org.apache.tools.ant.taskdefs.WaitFor.Unit" - briefType=""millisecond", "second", "minute", "hour", "day", "week"" required="NOTDEFINED"> - <short-description><![CDATA[Check every time unit.]]></short-description> - <description><![CDATA[ - Set the check every time unit - ]]></description> - </attribute> - <attribute name="maxwait" type="long" - briefType="long" required="NOTDEFINED"> - <short-description><![CDATA[Maximum length of time to wait.]]></short-description> - <description><![CDATA[ - Set the maximum length of time to wait - ]]></description> - </attribute> - <attribute name="maxwaitunit" type="org.apache.tools.ant.taskdefs.WaitFor.Unit" - briefType=""millisecond", "second", "minute", "hour", "day", "week"" required="NOTDEFINED"> - <short-description><![CDATA[Max wait time unit.]]></short-description> - <description><![CDATA[ - Set the max wait time unit - ]]></description> - </attribute> - <attribute name="timeoutproperty" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name the property to set after a timeout.]]></short-description> - <description><![CDATA[ - Name the property to set after a timeout. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="and" type="org.apache.tools.ant.taskdefs.condition.And" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <and> condition "container".]]></short-description> - <description> - <![CDATA[Add an <and> condition "container".]]> - </description> - </element> - - <element name="available" type="org.apache.tools.ant.taskdefs.Available" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <available> condition.]]></short-description> - <description> - <![CDATA[Add an <available> condition.]]> - </description> - </element> - - <element name="checksum" type="org.apache.tools.ant.taskdefs.Checksum" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <checksum> condition.]]></short-description> - <description> - <![CDATA[Add an <checksum> condition.]]> - </description> - </element> - - <element name="contains" type="org.apache.tools.ant.taskdefs.condition.Contains" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <contains> condition.]]></short-description> - <description> - <![CDATA[Add a <contains> condition.]]> - </description> - </element> - - <element name="equals" type="org.apache.tools.ant.taskdefs.condition.Equals" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <equals> condition.]]></short-description> - <description> - <![CDATA[Add an <equals> condition.]]> - </description> - </element> - - <element name="filesmatch" type="org.apache.tools.ant.taskdefs.condition.FilesMatch" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <filesmatch> condition.]]></short-description> - <description> - <![CDATA[Add a <filesmatch> condition.]]> - </description> - </element> - - <element name="http" type="org.apache.tools.ant.taskdefs.condition.Http" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <http> condition.]]></short-description> - <description> - <![CDATA[Add an <http> condition.]]> - </description> - </element> - - <element name="isfalse" type="org.apache.tools.ant.taskdefs.condition.IsFalse" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <isfalse> condition.]]></short-description> - <description> - <![CDATA[Add a <isfalse> condition.]]> - </description> - </element> - - <element name="isset" type="org.apache.tools.ant.taskdefs.condition.IsSet" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <isset> condition.]]></short-description> - <description> - <![CDATA[Add an <isset> condition.]]> - </description> - </element> - - <element name="istrue" type="org.apache.tools.ant.taskdefs.condition.IsTrue" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <istrue> condition.]]></short-description> - <description> - <![CDATA[Add a <istrue> condition.]]> - </description> - </element> - - <element name="not" type="org.apache.tools.ant.taskdefs.condition.Not" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <not> condition "container".]]></short-description> - <description> - <![CDATA[Add an <not> condition "container".]]> - </description> - </element> - - <element name="or" type="org.apache.tools.ant.taskdefs.condition.Or" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <or> condition "container".]]></short-description> - <description> - <![CDATA[Add an <or> condition "container".]]> - </description> - </element> - - <element name="os" type="org.apache.tools.ant.taskdefs.condition.Os" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <os> condition.]]></short-description> - <description> - <![CDATA[Add an <os> condition.]]> - </description> - </element> - - <element name="socket" type="org.apache.tools.ant.taskdefs.condition.Socket" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add a <socket> condition.]]></short-description> - <description> - <![CDATA[Add a <socket> condition.]]> - </description> - </element> - - <element name="uptodate" type="org.apache.tools.ant.taskdefs.UpToDate" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Add an <uptodate> condition.]]></short-description> - <description> - <![CDATA[Add an <uptodate> condition.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="war" category="packaging" - classname="org.apache.tools.ant.taskdefs.War" - matchingTask="true"> - - <short-description><![CDATA[An extension of <jar> to create a WAR archive.]]></short-description> - <description> - <![CDATA[An extension of <jar> to create a WAR archive. - Contains special treatment for files that should end up in the - <code>WEB-INF/lib</code>, <code>WEB-INF/classes</code> or - <code>WEB-INF</code> directories of the Web Application Archive.</p> - <p>(The War task is a shortcut for specifying the particular layout of a WAR file. - The same thing can be accomplished by using the <i>prefix</i> and <i>fullpath</i> - attributes of zipfilesets in a Zip or Jar task.)</p> - <p>The extended zipfileset element from the zip task (with attributes <i>prefix</i>, <i>fullpath</i>, and <i>src</i>) is available in the War task.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory from which to archive files; optional.]]></short-description> - <description><![CDATA[ - Directory from which to archive files; optional. - ]]></description> - </attribute> - <attribute name="compress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether we want to compress the files or only store them; - optional, default=true;.]]></short-description> - <description><![CDATA[ - Whether we want to compress the files or only store them; - optional, default=true; - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to create; required.]]></short-description> - <description><![CDATA[ - The file to create; required. - ]]></description> - </attribute> - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" - briefType=""add", "preserve", "fail"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.]]></short-description> - <description><![CDATA[ - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding to use for filenames, defaults to the platform's - default encoding.]]></short-description> - <description><![CDATA[ - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - ]]></description> - </attribute> - <attribute name="filesonly" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.]]></short-description> - <description><![CDATA[ - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - ]]></description> - </attribute> - <attribute name="index" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether or not to create an index list for classes.]]></short-description> - <description><![CDATA[ - Set whether or not to create an index list for classes. - This may speed up classloading in some cases. - ]]></description> - </attribute> - <attribute name="manifest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The manifest file to use.]]></short-description> - <description><![CDATA[ - The manifest file to use. This can be either the location of a manifest, - or the name of a jar added through a fileset. If its the name of an added - jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.MF. - ]]></description> - </attribute> - <attribute name="update" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.]]></short-description> - <description><![CDATA[ - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - ]]></description> - </attribute> - <attribute name="webxml" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Deployment descriptor to use (WEB-INF/web.xml); - required unless <tt>update=true</tt>.]]></short-description> - <description><![CDATA[ - set the deployment descriptor to use (WEB-INF/web.xml); - required unless <tt>update=true</tt> - ]]></description> - </attribute> - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" - briefType=""fail", "skip", "create"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior of the task when no files match.]]></short-description> - <description><![CDATA[ - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classes" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add files under WEB-INF/classes.]]></short-description> - <description> - <![CDATA[add files under WEB-INF/classes]]> - </description> - </element> - - <element name="manifest" type="org.apache.tools.ant.taskdefs.Manifest" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.]]></short-description> - <description> - <![CDATA[Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files.]]></short-description> - <description> - <![CDATA[Adds a set of files.]]> - </description> - </element> - - <element name="lib" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Add files under WEB-INF/lib/.]]></short-description> - <description> - <![CDATA[add files under WEB-INF/lib/]]> - </description> - </element> - - <element name="metainf" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a zipfileset to include in the META-INF directory.]]></short-description> - <description> - <![CDATA[Adds a zipfileset to include in the META-INF directory.]]> - </description> - </element> - - <element name="webinf" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Files to add under WEB-INF;.]]></short-description> - <description> - <![CDATA[files to add under WEB-INF;]]> - </description> - </element> - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a group of zip files.]]></short-description> - <description> - <![CDATA[Adds a group of zip files.]]> - </description> - </element> - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]></short-description> - <description> - <![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="wljspc" category="other" - classname="org.apache.tools.ant.taskdefs.optional.jsp.WLJspc" - matchingTask="true"> - - <short-description><![CDATA[Precompiles JSP's using WebLogic's JSP compiler (weblogic.jspc).]]></short-description> - <description> - <![CDATA[Precompiles JSP's using WebLogic's JSP compiler (weblogic.jspc).]]> - </description> - - <structure> - - <attributes> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Classpath to be used for this compilation.]]></short-description> - <description><![CDATA[ - Set the classpath to be used for this compilation. - ]]></description> - </attribute> - <attribute name="dest" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory containing the source jsp's.]]></short-description> - <description><![CDATA[ - Set the directory containing the source jsp's - ]]></description> - </attribute> - <attribute name="package" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Package under which the compiled classes go.]]></short-description> - <description><![CDATA[ - Set the package under which the compiled classes go - ]]></description> - </attribute> - <attribute name="src" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory containing the source jsp's.]]></short-description> - <description><![CDATA[ - Set the directory containing the source jsp's - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Maybe creates a nested classpath element.]]></short-description> - <description> - <![CDATA[Maybe creates a nested classpath element.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="wlrun" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ejb.WLRun" - > - - <short-description><![CDATA[Starts a WebLogic server.]]></short-description> - <description> - <![CDATA[Starts a WebLogic server. - A number of parameters are used to control the operation of the weblogic instance. Note that the task, - and hence ant, will not complete until the weblogic instance is stopped.</p>]]> - </description> - - <structure> - - <attributes> - <attribute name="args" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Additional argument string passed to the Weblogic instance; - optional.]]></short-description> - <description><![CDATA[ - Additional argument string passed to the Weblogic instance; - optional. - ]]></description> - </attribute> - <attribute name="beahome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The location of the BEA Home; implicitly - selects Weblogic 6.0; optional.]]></short-description> - <description><![CDATA[ - The location of the BEA Home; implicitly - selects Weblogic 6.0; optional. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[The classpath to be used with the Java Virtual Machine that runs the Weblogic - Server; required.]]></short-description> - <description><![CDATA[ - The classpath to be used with the Java Virtual Machine that runs the Weblogic - Server; required. Prior to Weblogic 6.0, this is typically set to the Weblogic - boot classpath. Under Weblogic 6.0 this should include all the - weblogic jars - ]]></description> - </attribute> - <attribute name="domain" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Domain to run in; required for WL6.0.]]></short-description> - <description><![CDATA[ - Set the Domain to run in; required for WL6.0 - ]]></description> - </attribute> - <attribute name="home" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The location where weblogic lives.]]></short-description> - <description><![CDATA[ - The location where weblogic lives. - Required. This is the absolute location, not relative to - BEA home. - ]]></description> - </attribute> - <attribute name="jvmargs" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Additional arguments to pass to the weblogic JVM.]]></short-description> - <description><![CDATA[ - Set the additional arguments to pass to the weblogic JVM - ]]></description> - </attribute> - <attribute name="name" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the weblogic server within the weblogic home which is to be run.]]></short-description> - <description><![CDATA[ - The name of the weblogic server within the weblogic home which is to be run. - Optiona, defaults to "myserver" - ]]></description> - </attribute> - <attribute name="pkpassword" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Private key password so the server can decrypt the SSL private key file; - optional and only applicable to WL6.0.]]></short-description> - <description><![CDATA[ - Set the private key password so the server can decrypt the SSL private key file; - optional and only applicable to WL6.0. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Management password of the server; - optional and only applicable to WL6.0.]]></short-description> - <description><![CDATA[ - Set the management password of the server; - optional and only applicable to WL6.0. - ]]></description> - </attribute> - <attribute name="policy" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the security policy file within the weblogic home directory that - is to be used.]]></short-description> - <description><![CDATA[ - The name of the security policy file within the weblogic home directory that - is to be used. If not specified, the default policy file <code>weblogic.policy</code> - is used. - ]]></description> - </attribute> - <attribute name="properties" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The name of the server's properties file within the weblogic home directory - used to control the weblogic instance; - required for WL4.5.1.]]></short-description> - <description><![CDATA[ - The name of the server's properties file within the weblogic home directory - used to control the weblogic instance; - required for WL4.5.1 - ]]></description> - </attribute> - <attribute name="username" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Management username to run the server; - optional and only applicable to WL6.0.]]></short-description> - <description><![CDATA[ - Set the management username to run the server; - optional and only applicable to WL6.0. - ]]></description> - </attribute> - <attribute name="weblogicmainclass" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the main class for weblogic; optional.]]></short-description> - <description><![CDATA[ - name of the main class for weblogic; optional. - ]]></description> - </attribute> - <attribute name="wlclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Weblogic classpath used by the Weblogic Server; - optional, and only applicable to WL4.5.1 - - The weblogic classpath is used by weblogic to support dynamic class loading.]]></short-description> - <description><![CDATA[ - Set the weblogic classpath used by the Weblogic Server; - optional, and only applicable to WL4.5.1 - - The weblogic classpath is used by weblogic to support dynamic class loading. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Add the classpath for the user classes.]]></short-description> - <description> - <![CDATA[Add the classpath for the user classes]]> - </description> - </element> - - <element name="wlclasspath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Get the classpath to the weblogic classpaths.]]></short-description> - <description> - <![CDATA[Get the classpath to the weblogic classpaths]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="wlstop" category="other" - classname="org.apache.tools.ant.taskdefs.optional.ejb.WLStop" - > - - <short-description><![CDATA[Shuts down a WebLogic server.]]></short-description> - <description> - <![CDATA[Shuts down a WebLogic server. - To shut down an instance you must supply both a username and - a password.]]> - </description> - - <structure> - - <attributes> - <attribute name="beahome" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The location of the BEA Home; implicitly - selects Weblogic 6.0 shutdown; optional.]]></short-description> - <description><![CDATA[ - The location of the BEA Home; implicitly - selects Weblogic 6.0 shutdown; optional. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command;.]]></short-description> - <description><![CDATA[ - The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command; - ]]></description> - </attribute> - <attribute name="delay" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Delay (in seconds) before shutting down the server; - optional.]]></short-description> - <description><![CDATA[ - Set the delay (in seconds) before shutting down the server; - optional. - ]]></description> - </attribute> - <attribute name="password" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The password for the account specified in the - user parameter; required.]]></short-description> - <description><![CDATA[ - The password for the account specified in the - user parameter; required - ]]></description> - </attribute> - <attribute name="url" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[URL to which the weblogic server is listening - for T3 connections; required.]]></short-description> - <description><![CDATA[ - Set the URL to which the weblogic server is listening - for T3 connections; required. - ]]></description> - </attribute> - <attribute name="user" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The username of the account which will be used to shutdown the server; - required.]]></short-description> - <description><![CDATA[ - The username of the account which will be used to shutdown the server; - required. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command;.]]></short-description> - <description> - <![CDATA[The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command;]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="wsdltodotnet" category="dotnet" - classname="org.apache.tools.ant.taskdefs.optional.dotnet.WsdlToDotnet" - > - - <short-description><![CDATA[Converts a WSDL file or URL resource into a .NET language.]]></short-description> - <description> - <![CDATA[Converts a WSDL file or URL resource into a .NET language. - - See "Creating an XML Web Service Proxy", "wsdl.exe" docs in - the framework SDK documentation]]> - </description> - - <structure> - - <attributes> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Name of the file to generate.]]></short-description> - <description><![CDATA[ - Name of the file to generate. Required - ]]></description> - </attribute> - <attribute name="extraoptions" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Any extra WSDL.EXE options which aren't explicitly - supported by the ant wrapper task; optional.]]></short-description> - <description><![CDATA[ - Any extra WSDL.EXE options which aren't explicitly - supported by the ant wrapper task; optional - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Should failure halt the build?.]]></short-description> - <description><![CDATA[ - Should failure halt the build? optional, default=true - ]]></description> - </attribute> - <attribute name="language" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Language; one of "CS", "JS", or "VB" - optional, default is CS for C# source.]]></short-description> - <description><![CDATA[ - set the language; one of "CS", "JS", or "VB" - optional, default is CS for C# source - ]]></description> - </attribute> - <attribute name="namespace" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Namespace to place the source in. - optional; default "".]]></short-description> - <description><![CDATA[ - namespace to place the source in. - optional; default "" - ]]></description> - </attribute> - <attribute name="server" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to enable server side code generation; - optional, default=false.]]></short-description> - <description><![CDATA[ - flag to enable server side code generation; - optional, default=false - ]]></description> - </attribute> - <attribute name="srcfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The local WSDL file to parse; either url or srcFile is required.]]></short-description> - <description><![CDATA[ - The local WSDL file to parse; either url or srcFile is required. - ]]></description> - </attribute> - <attribute name="url" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[URL to fetch.]]></short-description> - <description><![CDATA[ - Sets the URL to fetch. Fetching is by wsdl.exe; Ant proxy settings - are ignored; either url or srcFile is required. - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="xmlproperty" category="xml" - classname="org.apache.tools.ant.taskdefs.XmlProperty" - > - - <short-description><![CDATA[Loads property values from a valid XML file, generating the property names from the file's element and attribute names.]]></short-description> - <description> - <![CDATA[Loads property values from a valid XML file, - generating the property names from the file's element and attribute names. - - Example: - <pre> - <root-tag myattr="true"> - <inner-tag someattr="val">Text</inner-tag> - <a2><a3><a4>false</a4></a3></a2> - </root-tag> -</pre> - this generates - <pre> - root-tag(myattr)=true - root-tag.inner-tag=Text - root-tag.inner-tag(someattr)=val - root-tag.a2.a3.a4=false - </pre>]]> - </description> - - <structure> - - <attributes> - <attribute name="collapseattributes" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to treat attributes as nested elements; - optional, default false.]]></short-description> - <description><![CDATA[ - flag to treat attributes as nested elements; - optional, default false - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The XML file to parse; required.]]></short-description> - <description><![CDATA[ - The XML file to parse; required. - ]]></description> - </attribute> - <attribute name="keeproot" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to include the xml root tag as a - first value in the property name; optional, - default is true.]]></short-description> - <description><![CDATA[ - flag to include the xml root tag as a - first value in the property name; optional, - default is true - ]]></description> - </attribute> - <attribute name="prefix" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[The prefix to prepend to each property.]]></short-description> - <description><![CDATA[ - the prefix to prepend to each property - ]]></description> - </attribute> - <attribute name="validate" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Flag to validate the XML file; optional, default false.]]></short-description> - <description><![CDATA[ - flag to validate the XML file; optional, default false - ]]></description> - </attribute> - </attributes> - - <elements> - </elements> - - </structure> - -</task> - - -<task name="xmlvalidate" category="other" - classname="org.apache.tools.ant.taskdefs.optional.XMLValidateTask" - > - - <short-description><![CDATA[Checks XML files are valid (or only well formed).]]></short-description> - <description> - <![CDATA[Checks XML files are valid (or only well formed). The - task uses the SAX2 parser implementation provided by JAXP by default - (probably the one that is used by Ant itself), but one can specify any - SAX1/2 parser if needed]]> - </description> - - <structure> - - <attributes> - <attribute name="classname" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Specify the class name of the SAX parser to be used. (optional).]]></short-description> - <description><![CDATA[ - Specify the class name of the SAX parser to be used. (optional) - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Specify the classpath to be searched to load the parser (optional).]]></short-description> - <description><![CDATA[ - Specify the classpath to be searched to load the parser (optional) - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Where to find the parser class; optional.]]></short-description> - <description><![CDATA[ - Where to find the parser class; optional. - ]]></description> - </attribute> - <attribute name="failonerror" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Specify how parser error are to be handled; - optional, default=true - <p> - If set to <code>true</code> (default), throw a buildException if the parser yields an error.]]></short-description> - <description><![CDATA[ - Specify how parser error are to be handled; - optional, default=true - <p> - If set to <code>true</code> (default), throw a buildException if the parser yields an error. - ]]></description> - </attribute> - <attribute name="file" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Specify the file to be checked; optional.]]></short-description> - <description><![CDATA[ - specify the file to be checked; optional. - ]]></description> - </attribute> - <attribute name="lenient" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Specify whether the parser should be validating.]]></short-description> - <description><![CDATA[ - Specify whether the parser should be validating. Default is <code>true</code>. - <p> - If set to false, the validation will fail only if the parsed document is not well formed XML. - <p> - this option is ignored if the specified class with {@link #setClassName(String)} is not a SAX2 - XMLReader. - ]]></description> - </attribute> - <attribute name="warn" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Specify how parser error are to be handled.]]></short-description> - <description><![CDATA[ - Specify how parser error are to be handled. - <p> - If set to <code>true</true> (default), log a warn message for each SAX warn event. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="xmlcatalog" type="org.apache.tools.ant.types.XMLCatalog" - briefType="XMLCatalog" - required="NOTDEFINED"> - <short-description><![CDATA[Add an XMLCatalog as a nested element; optional.]]></short-description> - <description> - <![CDATA[add an XMLCatalog as a nested element; optional.]]> - </description> - </element> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Specify a set of file to be checked.]]></short-description> - <description> - <![CDATA[specify a set of file to be checked]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[No description.]]></short-description> - <description> - <![CDATA[]]> - </description> - </element> - - <element name="dtd" type="org.apache.tools.ant.types.DTDLocation" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create a DTD location record; optional.]]></short-description> - <description> - <![CDATA[Create a DTD location record; optional. - This stores the location of a DTD. The DTD is identified - by its public Id.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="xslt" category="xml" - classname="org.apache.tools.ant.taskdefs.XSLTProcess" - matchingTask="true"> - - <short-description><![CDATA[Processes a set of XML documents via XSLT.]]></short-description> - <description> - <![CDATA[Processes a set of XML documents via XSLT. This is - useful for building views of XML based documentation.]]> - </description> - - <structure> - - <attributes> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Base directory; - optional, default is the project's basedir.]]></short-description> - <description><![CDATA[ - Set the base directory; - optional, default is the project's basedir. - ]]></description> - </attribute> - <attribute name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" required="NOTDEFINED"> - <short-description><![CDATA[Optional classpath to the XSL processor.]]></short-description> - <description><![CDATA[ - Set the optional classpath to the XSL processor - ]]></description> - </attribute> - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" - briefType="Reference" required="NOTDEFINED"> - <short-description><![CDATA[Reference to an optional classpath to the XSL processor.]]></short-description> - <description><![CDATA[ - Set the reference to an optional classpath to the XSL processor - ]]></description> - </attribute> - <attribute name="destdir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Destination directory into which the XSL result - files should be copied to; - required, unless <tt>in</tt> and <tt>out</tt> are - specified.]]></short-description> - <description><![CDATA[ - Set the destination directory into which the XSL result - files should be copied to; - required, unless <tt>in</tt> and <tt>out</tt> are - specified. - ]]></description> - </attribute> - <attribute name="extension" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Desired file extension to be used for the target; - optional, default is html.]]></short-description> - <description><![CDATA[ - Set the desired file extension to be used for the target; - optional, default is html. - ]]></description> - </attribute> - <attribute name="force" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Set whether to check dependencies, or always generate; - optional, default is false.]]></short-description> - <description><![CDATA[ - Set whether to check dependencies, or always generate; - optional, default is false. - ]]></description> - </attribute> - <attribute name="in" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Specifies a single XML document to be styled.]]></short-description> - <description><![CDATA[ - specifies a single XML document to be styled. Should be used - with the <tt>out</tt> attribute; ; required if <tt>out</tt> is set - ]]></description> - </attribute> - <attribute name="out" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Specifies the output name for the styled result from the - <tt>in</tt> attribute; required if <tt>in</tt> is set.]]></short-description> - <description><![CDATA[ - Specifies the output name for the styled result from the - <tt>in</tt> attribute; required if <tt>in</tt> is set - ]]></description> - </attribute> - <attribute name="processor" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the XSL processor to use; optional, default trax.]]></short-description> - <description><![CDATA[ - Set the name of the XSL processor to use; optional, default trax. - Other values are "xalan" for Xalan1 and "xslp" for XSL:P, though the - later is strongly deprecated. - ]]></description> - </attribute> - <attribute name="scanincludeddirectories" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether to style all files in the included directories as well; - optional, default is true.]]></short-description> - <description><![CDATA[ - Whether to style all files in the included directories as well; - optional, default is true. - ]]></description> - </attribute> - <attribute name="style" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Name of the stylesheet to use - given either relative - to the project's basedir or as an absolute path; required.]]></short-description> - <description><![CDATA[ - Name of the stylesheet to use - given either relative - to the project's basedir or as an absolute path; required. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="xmlcatalog" type="org.apache.tools.ant.types.XMLCatalog" - briefType="XMLCatalog" - required="NOTDEFINED"> - <short-description><![CDATA[Add the catalog to our internal catalog.]]></short-description> - <description> - <![CDATA[Add the catalog to our internal catalog]]> - </description> - </element> - - <element name="classpath" type="org.apache.tools.ant.types.Path" - briefType="Path" - required="NOTDEFINED"> - <short-description><![CDATA[Optional classpath to the XSL processor.]]></short-description> - <description> - <![CDATA[Set the optional classpath to the XSL processor]]> - </description> - </element> - - <element name="outputproperty" type="org.apache.tools.ant.taskdefs.XSLTProcess.OutputProperty" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create an instance of an output property to be configured.]]></short-description> - <description> - <![CDATA[Create an instance of an output property to be configured.]]> - </description> - </element> - - <element name="param" type="org.apache.tools.ant.taskdefs.XSLTProcess.Param" - briefType="" - required="NOTDEFINED"> - <short-description><![CDATA[Create an instance of an XSL parameter for configuration by Ant.]]></short-description> - <description> - <![CDATA[Create an instance of an XSL parameter for configuration by Ant.]]> - </description> - </element> - - </elements> - - </structure> - -</task> - - -<task name="zip" category="packaging" - classname="org.apache.tools.ant.taskdefs.Zip" - matchingTask="true"> - - <short-description><![CDATA[Create a Zip file.]]></short-description> - <description> - <![CDATA[Create a Zip file.]]> - </description> - - <structure> - - <attributes> - <attribute name="basedir" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[Directory from which to archive files; optional.]]></short-description> - <description><![CDATA[ - Directory from which to archive files; optional. - ]]></description> - </attribute> - <attribute name="compress" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[Whether we want to compress the files or only store them; - optional, default=true;.]]></short-description> - <description><![CDATA[ - Whether we want to compress the files or only store them; - optional, default=true; - ]]></description> - </attribute> - <attribute name="destfile" type="java.io.File" - briefType="File" required="NOTDEFINED"> - <short-description><![CDATA[The file to create; required.]]></short-description> - <description><![CDATA[ - The file to create; required. - ]]></description> - </attribute> - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" - briefType=""add", "preserve", "fail"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.]]></short-description> - <description><![CDATA[ - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - ]]></description> - </attribute> - <attribute name="encoding" type="java.lang.String" - briefType="String" required="NOTDEFINED"> - <short-description><![CDATA[Encoding to use for filenames, defaults to the platform's - default encoding.]]></short-description> - <description><![CDATA[ - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - ]]></description> - </attribute> - <attribute name="filesonly" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.]]></short-description> - <description><![CDATA[ - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - ]]></description> - </attribute> - <attribute name="update" type="boolean" - briefType="boolean" required="NOTDEFINED"> - <short-description><![CDATA[If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.]]></short-description> - <description><![CDATA[ - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - ]]></description> - </attribute> - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" - briefType=""fail", "skip", "create"" required="NOTDEFINED"> - <short-description><![CDATA[Sets behavior of the task when no files match.]]></short-description> - <description><![CDATA[ - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - ]]></description> - </attribute> - </attributes> - - <elements> - <element name="fileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files.]]></short-description> - <description> - <![CDATA[Adds a set of files.]]> - </description> - </element> - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" - briefType="Fileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a group of zip files.]]></short-description> - <description> - <![CDATA[Adds a group of zip files.]]> - </description> - </element> - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" - briefType="ZipFileset" - required="NOTDEFINED"> - <short-description><![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]></short-description> - <description> - <![CDATA[Adds a set of files that can be - read from an archive and be given a prefix/fullpath.]]> - </description> - </element> - - </elements> - - </structure> - -</task> -</tasks> diff --git a/org.eclipse.ui.externaltools/Ant Editor/ant1.5b.dtd b/org.eclipse.ui.externaltools/Ant Editor/ant1.5b.dtd deleted file mode 100644 index 063acdacc..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/ant1.5b.dtd +++ /dev/null @@ -1,3903 +0,0 @@ -<?xml version="1.0" encoding="UTF-8" ?>
-<!ENTITY % boolean "(true|false|on|off|yes|no)">
-<!ENTITY % tasks "propertyfile | vsscheckin | sql | cvspass | p4reopen | csc | dirname | wlrun | p4label | p4revert | replaceregexp | get | jjtree | sleep | jarlib-display | dependset | zip | patch | jspc | style | test | tstamp | unwar | vsshistory | icontract | cvschangelog | p4submit | ccmcheckin | p4change | bzip2 | p4delete | vssadd | javadoc | translate | signjar | vajload | jarlib-available | WsdlToDotnet | buildnumber | jpcovmerge | ejbjar | war | rename | sequential | serverdeploy | property | move | copydir | cccheckin | wljspc | fixcrlf | sosget | pathconvert | record | p4sync | exec | p4edit | manifest | maudit | antlr | netrexxc | jpcovreport | execon | ccmcheckout | ant | xmlvalidate | xslt | iplanet-ejbc | ccmcheckintask | gzip | native2ascii | starteam | ear | input | rmic | checksum | mail | loadfile | vsscheckout | stylebook | soscheckin | mimemail | stlabel | gunzip | concat | cab | touch | parallel | splash | antcall | cccheckout | typedef | p4have | filter | xmlproperty | copy | antstructure | ccmcreatetask | rpm | delete | replace | mmetrics | waitfor | untar | loadproperties | available | echoproperties | junit | vajexport | stcheckout | bunzip2 | copyfile | vsscreate | ejbc | unjar | wsdltodotnet | mkdir | condition | cvs | tempfile | junitreport | taskdef | echo | ccupdate | java | renameext | vsslabel | basename | javadoc2 | vsscp | tar | vajimport | setproxy | wlstop | p4counter | ilasm | soscheckout | apply | ccuncheckout | jarlib-resolve | cvstagdiff | jlink | javacc | jarlib-manifest | pvcs | chmod | jar | sound | mparse | blgenclient | uptodate | genkey | javah | ccmreconfigure | fail | unzip | javac | p4add | soslabel | jpcoverage | depend | vssget | deltree | ddcreator">
-<!ENTITY % types "patternset | filterset | libfileset | filterreader | extension | fileset | dirset | filelist | filterchain | path | classfileset | description | xmlcatalog | selector | mapper | substitution | extensionSet | regexp">
-
-<!ELEMENT project (target | property | taskdef | typedef | %types;)*>
-<!ATTLIST project
- name CDATA #IMPLIED
- default CDATA #REQUIRED
- basedir CDATA #IMPLIED>
-
-<!ELEMENT target (%tasks; | %types;)*>
-
-<!ATTLIST target
- id ID #IMPLIED
- name CDATA #REQUIRED
- if CDATA #IMPLIED
- unless CDATA #IMPLIED
- depends CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT patternset (include | patternset | exclude | excludesfile | includesfile)*>
-<!ATTLIST patternset
- id ID #IMPLIED
- includes CDATA #IMPLIED
- refid IDREF #IMPLIED
- excludesfile CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludes CDATA #IMPLIED>
-
-<!ELEMENT include EMPTY>
-<!ATTLIST include
- id ID #IMPLIED
- name CDATA #IMPLIED
- unless CDATA #IMPLIED
- if CDATA #IMPLIED>
-
-<!ELEMENT exclude EMPTY>
-<!ATTLIST exclude
- id ID #IMPLIED
- name CDATA #IMPLIED
- unless CDATA #IMPLIED
- if CDATA #IMPLIED>
-
-<!ELEMENT excludesfile EMPTY>
-<!ATTLIST excludesfile
- id ID #IMPLIED
- name CDATA #IMPLIED
- unless CDATA #IMPLIED
- if CDATA #IMPLIED>
-
-<!ELEMENT includesfile EMPTY>
-<!ATTLIST includesfile
- id ID #IMPLIED
- name CDATA #IMPLIED
- unless CDATA #IMPLIED
- if CDATA #IMPLIED>
-
-<!ELEMENT filterset (filterset | filter | filtersfile)*>
-<!ATTLIST filterset
- id ID #IMPLIED
- begintoken CDATA #IMPLIED
- endtoken CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- filtersfile CDATA #IMPLIED>
-
-<!ELEMENT filter EMPTY>
-<!ATTLIST filter
- id ID #IMPLIED
- token CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT filtersfile EMPTY>
-<!ATTLIST filtersfile
- id ID #IMPLIED
- file CDATA #IMPLIED>
-
-<!ELEMENT libfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST libfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- urlbase CDATA #IMPLIED
- includeimpl %boolean; #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- includeurl %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT custom (classpath | param)*>
-<!ATTLIST custom
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- error CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- classname CDATA #IMPLIED>
-
-<!ELEMENT classpath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST classpath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT fileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST fileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT none (depend | filename | custom | not | date | contains | selector | depth | or | and | present | majority | none | size)*>
-<!ATTLIST none
- id ID #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT depend (mapper)*>
-<!ATTLIST depend
- id ID #IMPLIED
- targetdir CDATA #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- granularity CDATA #IMPLIED>
-
-<!ELEMENT mapper (classpath)*>
-<!ATTLIST mapper
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- type (identity | flatten | glob | merge | regexp | package) #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- classname CDATA #IMPLIED
- from CDATA #IMPLIED
- to CDATA #IMPLIED>
-
-<!ELEMENT filename EMPTY>
-<!ATTLIST filename
- id ID #IMPLIED
- casesensitive %boolean; #IMPLIED
- name CDATA #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- negate %boolean; #IMPLIED>
-
-<!ELEMENT not (depend | filename | custom | not | date | contains | selector | depth | or | and | present | majority | none | size)*>
-<!ATTLIST not
- id ID #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT date EMPTY>
-<!ATTLIST date
- id ID #IMPLIED
- when (before | after | equal) #IMPLIED
- error CDATA #IMPLIED
- millis CDATA #IMPLIED
- refid IDREF #IMPLIED
- checkdirs %boolean; #IMPLIED
- description CDATA #IMPLIED
- granularity CDATA #IMPLIED
- datetime CDATA #IMPLIED>
-
-<!ELEMENT contains EMPTY>
-<!ATTLIST contains
- id ID #IMPLIED
- casesensitive %boolean; #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- text CDATA #IMPLIED>
-
-<!ELEMENT selector (depend | filename | custom | not | date | contains | selector | depth | or | and | present | majority | none | size)*>
-<!ATTLIST selector
- id ID #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT depth EMPTY>
-<!ATTLIST depth
- id ID #IMPLIED
- max CDATA #IMPLIED
- error CDATA #IMPLIED
- min CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT or (depend | filename | custom | not | date | contains | selector | depth | or | and | present | majority | none | size)*>
-<!ATTLIST or
- id ID #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT and (depend | filename | custom | not | date | contains | selector | depth | or | and | present | majority | none | size)*>
-<!ATTLIST and
- id ID #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT present (mapper)*>
-<!ATTLIST present
- id ID #IMPLIED
- targetdir CDATA #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- present (srconly | both) #IMPLIED>
-
-<!ELEMENT majority (depend | filename | custom | not | date | contains | selector | depth | or | and | present | majority | none | size)*>
-<!ATTLIST majority
- id ID #IMPLIED
- error CDATA #IMPLIED
- allowtie %boolean; #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT size EMPTY>
-<!ATTLIST size
- id ID #IMPLIED
- when (less | more | equal) #IMPLIED
- units (K | k | kilo | KILO | Ki | KI | ki | kibi | KIBI | M | m | mega | MEGA | Mi | MI | mi | mebi | MEBI | G | g | giga | GIGA | Gi | GI | gi | gibi | GIBI | T | t | tera | TERA | Ti | TI | ti | tebi | TEBI) #IMPLIED
- error CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT dirset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST dirset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT filelist EMPTY>
-<!ATTLIST filelist
- id ID #IMPLIED
- dir CDATA #IMPLIED
- refid IDREF #IMPLIED
- files CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT pathelement EMPTY>
-<!ATTLIST pathelement
- id ID #IMPLIED
- location CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT path (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST path
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT param EMPTY>
-<!ATTLIST param
- id ID #IMPLIED
- name CDATA #IMPLIED
- type CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT filterreader (classpath | param)*>
-<!ATTLIST filterreader
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- classname CDATA #IMPLIED>
-
-<!ELEMENT extension EMPTY>
-<!ATTLIST extension
- id ID #IMPLIED
- refid IDREF #IMPLIED
- implementationversion CDATA #IMPLIED
- specificationversion CDATA #IMPLIED
- extensionname CDATA #IMPLIED
- implementationvendorid CDATA #IMPLIED
- specificationvendor CDATA #IMPLIED
- implementationurl CDATA #IMPLIED
- description CDATA #IMPLIED
- implementationvendor CDATA #IMPLIED>
-
-<!ELEMENT filterchain (linecontainsregexp | classconstants | headfilter | tabstospaces | striplinebreaks | tailfilter | stripjavacomments | expandproperties | linecontains | replacetokens | striplinecomments | prefixlines | filterreader)*>
-<!ATTLIST filterchain
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT linecontainsregexp (regexp)*>
-<!ATTLIST linecontainsregexp
- id ID #IMPLIED>
-
-<!ELEMENT regexp EMPTY>
-<!ATTLIST regexp
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- pattern CDATA #IMPLIED>
-
-<!ELEMENT classconstants EMPTY>
-<!ATTLIST classconstants
- id ID #IMPLIED>
-
-<!ELEMENT headfilter EMPTY>
-<!ATTLIST headfilter
- id ID #IMPLIED
- lines CDATA #IMPLIED>
-
-<!ELEMENT tabstospaces EMPTY>
-<!ATTLIST tabstospaces
- id ID #IMPLIED
- tablength CDATA #IMPLIED>
-
-<!ELEMENT striplinebreaks EMPTY>
-<!ATTLIST striplinebreaks
- id ID #IMPLIED
- linebreaks CDATA #IMPLIED>
-
-<!ELEMENT tailfilter EMPTY>
-<!ATTLIST tailfilter
- id ID #IMPLIED
- lines CDATA #IMPLIED>
-
-<!ELEMENT stripjavacomments EMPTY>
-<!ATTLIST stripjavacomments
- id ID #IMPLIED>
-
-<!ELEMENT expandproperties EMPTY>
-<!ATTLIST expandproperties
- id ID #IMPLIED>
-
-<!ELEMENT linecontains (contains)*>
-<!ATTLIST linecontains
- id ID #IMPLIED>
-
-<!ELEMENT replacetokens (token)*>
-<!ATTLIST replacetokens
- id ID #IMPLIED
- begintoken CDATA #IMPLIED
- endtoken CDATA #IMPLIED>
-
-<!ELEMENT token EMPTY>
-<!ATTLIST token
- id ID #IMPLIED
- key CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT striplinecomments (comment)*>
-<!ATTLIST striplinecomments
- id ID #IMPLIED>
-
-<!ELEMENT comment EMPTY>
-<!ATTLIST comment
- id ID #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT prefixlines EMPTY>
-<!ATTLIST prefixlines
- id ID #IMPLIED
- prefix CDATA #IMPLIED>
-
-<!ELEMENT classfileset (patternset | exclude | include | custom | rootfileset | none | present | not | or | contains | depend | size | majority | root | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST classfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- rootclass CDATA #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT rootfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST rootfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT root EMPTY>
-<!ATTLIST root
- id ID #IMPLIED
- classname CDATA #IMPLIED>
-
-<!ELEMENT description (#PCDATA)>
-<!ATTLIST description
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT xmlcatalog (entity | classpath | dtd | xmlcatalog)*>
-<!ATTLIST xmlcatalog
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT entity EMPTY>
-<!ATTLIST entity
- id ID #IMPLIED
- location CDATA #IMPLIED
- publicid CDATA #IMPLIED>
-
-<!ELEMENT dtd EMPTY>
-<!ATTLIST dtd
- id ID #IMPLIED
- location CDATA #IMPLIED
- publicid CDATA #IMPLIED>
-
-<!ELEMENT substitution EMPTY>
-<!ATTLIST substitution
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- expression CDATA #IMPLIED>
-
-<!ELEMENT extensionSet (fileset | libfileset | extension)*>
-<!ATTLIST extensionSet
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT propertyfile (entry)*>
-<!ATTLIST propertyfile
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- comment CDATA #IMPLIED>
-
-<!ELEMENT entry EMPTY>
-<!ATTLIST entry
- id ID #IMPLIED
- operation CDATA #IMPLIED
- default CDATA #IMPLIED
- key CDATA #IMPLIED
- type (int | date | string) #IMPLIED
- unit (millisecond | second | minute | hour | day | week | month | year) #IMPLIED
- pattern CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT vsscheckin EMPTY>
-<!ATTLIST vsscheckin
- id ID #IMPLIED
- recursive %boolean; #IMPLIED
- ssdir CDATA #IMPLIED
- autoresponse CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- comment CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- writable %boolean; #IMPLIED
- login CDATA #IMPLIED
- taskname CDATA #IMPLIED
- localpath CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT sql (#PCDATA | fileset | classpath | transaction)*>
-<!ATTLIST sql
- id ID #IMPLIED
- onerror (continue | stop | abort) #IMPLIED
- password CDATA #IMPLIED
- userid CDATA #IMPLIED
- autocommit %boolean; #IMPLIED
- rdbms CDATA #IMPLIED
- print %boolean; #IMPLIED
- classpathref IDREF #IMPLIED
- encoding CDATA #IMPLIED
- version CDATA #IMPLIED
- url CDATA #IMPLIED
- src CDATA #IMPLIED
- output CDATA #IMPLIED
- driver CDATA #IMPLIED
- showheaders %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- delimitertype (normal | row) #IMPLIED
- description CDATA #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- caching %boolean; #IMPLIED
- delimiter CDATA #IMPLIED>
-
-<!ELEMENT transaction (#PCDATA)>
-<!ATTLIST transaction
- id ID #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT cvspass EMPTY>
-<!ATTLIST cvspass
- id ID #IMPLIED
- password CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- cvsroot CDATA #IMPLIED
- passfile CDATA #IMPLIED>
-
-<!ELEMENT p4reopen EMPTY>
-<!ATTLIST p4reopen
- id ID #IMPLIED
- tochange CDATA #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT csc (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST csc
- id ID #IMPLIED
- references CDATA #IMPLIED
- filealign CDATA #IMPLIED
- mainclass CDATA #IMPLIED
- excludes CDATA #IMPLIED
- noconfig %boolean; #IMPLIED
- extraoptions CDATA #IMPLIED
- additionalmodules CDATA #IMPLIED
- win32icon CDATA #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- utf8output %boolean; #IMPLIED
- includedefaultreferences %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- optimize %boolean; #IMPLIED
- targettype CDATA #IMPLIED
- destfile CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- win32res CDATA #IMPLIED
- debug %boolean; #IMPLIED
- unsafe %boolean; #IMPLIED
- docfile CDATA #IMPLIED
- incremental %boolean; #IMPLIED
- outputfile CDATA #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- warnlevel CDATA #IMPLIED
- taskname CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- fullpaths %boolean; #IMPLIED
- excludesfile CDATA #IMPLIED
- definitions CDATA #IMPLIED
- referencefiles CDATA #IMPLIED>
-
-<!ELEMENT dirname EMPTY>
-<!ATTLIST dirname
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- property CDATA #IMPLIED>
-
-<!ELEMENT wlrun (classpath | wlclasspath)*>
-<!ATTLIST wlrun
- id ID #IMPLIED
- name CDATA #IMPLIED
- classpath CDATA #IMPLIED
- pkpassword CDATA #IMPLIED
- beahome CDATA #IMPLIED
- domain CDATA #IMPLIED
- username CDATA #IMPLIED
- weblogicmainclass CDATA #IMPLIED
- wlclasspath CDATA #IMPLIED
- policy CDATA #IMPLIED
- properties CDATA #IMPLIED
- args CDATA #IMPLIED
- home CDATA #IMPLIED
- taskname CDATA #IMPLIED
- password CDATA #IMPLIED
- description CDATA #IMPLIED
- jvmargs CDATA #IMPLIED>
-
-<!ELEMENT wlclasspath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST wlclasspath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT p4label EMPTY>
-<!ATTLIST p4label
- id ID #IMPLIED
- name CDATA #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- desc CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- lock CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT p4revert EMPTY>
-<!ATTLIST p4revert
- id ID #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- revertonlyunchanged %boolean; #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- change CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT replaceregexp (fileset | substitution | regexp)*>
-<!ATTLIST replaceregexp
- id ID #IMPLIED
- flags CDATA #IMPLIED
- match CDATA #IMPLIED
- taskname CDATA #IMPLIED
- byline CDATA #IMPLIED
- replace CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT get EMPTY>
-<!ATTLIST get
- id ID #IMPLIED
- src CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- ignoreerrors %boolean; #IMPLIED
- usetimestamp %boolean; #IMPLIED
- username CDATA #IMPLIED
- taskname CDATA #IMPLIED
- dest CDATA #IMPLIED
- description CDATA #IMPLIED
- password CDATA #IMPLIED>
-
-<!ELEMENT jjtree EMPTY>
-<!ATTLIST jjtree
- id ID #IMPLIED
- nodedefaultvoid %boolean; #IMPLIED
- buildnodefiles %boolean; #IMPLIED
- outputdirectory CDATA #IMPLIED
- static %boolean; #IMPLIED
- javacchome CDATA #IMPLIED
- nodeprefix CDATA #IMPLIED
- nodefactory %boolean; #IMPLIED
- visitor %boolean; #IMPLIED
- multi %boolean; #IMPLIED
- target CDATA #IMPLIED
- nodeusesparser %boolean; #IMPLIED
- visitorexception CDATA #IMPLIED
- nodescopehook %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- nodepackage CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT sleep EMPTY>
-<!ATTLIST sleep
- id ID #IMPLIED
- hours CDATA #IMPLIED
- milliseconds CDATA #IMPLIED
- taskname CDATA #IMPLIED
- minutes CDATA #IMPLIED
- description CDATA #IMPLIED
- seconds CDATA #IMPLIED
- failonerror %boolean; #IMPLIED>
-
-<!ELEMENT jarlib-display (fileset)*>
-<!ATTLIST jarlib-display
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT dependset (patternset | exclude | include | custom | none | present | not | targetfileset | srcfileset | or | contains | depend | size | majority | filename | selector | includesfile | srcfilelist | date | excludesfile | depth | and | targetfilelist)*>
-<!ATTLIST dependset
- id ID #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT targetfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST targetfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT srcfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST srcfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT srcfilelist EMPTY>
-<!ATTLIST srcfilelist
- id ID #IMPLIED
- dir CDATA #IMPLIED
- refid IDREF #IMPLIED
- files CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT targetfilelist EMPTY>
-<!ATTLIST targetfilelist
- id ID #IMPLIED
- dir CDATA #IMPLIED
- refid IDREF #IMPLIED
- files CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT zip (patternset | exclude | include | custom | none | present | not | or | contains | depend | fileset | size | majority | filename | selector | includesfile | zipgroupfileset | zipfileset | date | excludesfile | depth | and)*>
-<!ATTLIST zip
- id ID #IMPLIED
- whenempty (fail | skip | create) #IMPLIED
- duplicate (add | preserve | fail) #IMPLIED
- excludes CDATA #IMPLIED
- basedir CDATA #IMPLIED
- encoding CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- update %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- destfile CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- compress %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- filesonly %boolean; #IMPLIED
- file CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- zipfile CDATA #IMPLIED>
-
-<!ELEMENT zipgroupfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST zipgroupfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT zipfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST zipfileset
- id ID #IMPLIED
- src CDATA #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT patch EMPTY>
-<!ATTLIST patch
- id ID #IMPLIED
- strip CDATA #IMPLIED
- dir CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- originalfile CDATA #IMPLIED
- patchfile CDATA #IMPLIED
- reverse %boolean; #IMPLIED
- backups %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- ignorewhitespace %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT jspc (patternset | exclude | include | custom | none | present | not | or | contains | depend | classpath | size | majority | filename | selector | includesfile | date | excludesfile | webapp | depth | and)*>
-<!ATTLIST jspc
- id ID #IMPLIED
- mapped %boolean; #IMPLIED
- ieplugin CDATA #IMPLIED
- excludes CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- package CDATA #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- uribase CDATA #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- verbose CDATA #IMPLIED
- compiler CDATA #IMPLIED
- includes CDATA #IMPLIED
- webxml CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- uriroot CDATA #IMPLIED
- webinc CDATA #IMPLIED>
-
-<!ELEMENT webapp EMPTY>
-<!ATTLIST webapp
- id ID #IMPLIED
- basedir CDATA #IMPLIED>
-
-<!ELEMENT style (patternset | exclude | include | custom | none | present | not | param | or | contains | depend | classpath | size | majority | filename | xmlcatalog | selector | outputproperty | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST style
- id ID #IMPLIED
- force %boolean; #IMPLIED
- excludes CDATA #IMPLIED
- processor CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- basedir CDATA #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- scanincludeddirectories %boolean; #IMPLIED
- extension CDATA #IMPLIED
- in CDATA #IMPLIED
- followsymlinks %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- out CDATA #IMPLIED
- style CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- excludesfile CDATA #IMPLIED>
-
-<!ELEMENT outputproperty EMPTY>
-<!ATTLIST outputproperty
- id ID #IMPLIED
- name CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT test (arg | jvmarg | classpath | sysproperty | testlet | env)*>
-<!ATTLIST test
- id ID #IMPLIED
- jvmargs CDATA #IMPLIED
- args CDATA #IMPLIED
- fork %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- jar CDATA #IMPLIED
- forceshowtrace %boolean; #IMPLIED
- output CDATA #IMPLIED
- timeout CDATA #IMPLIED
- jvm CDATA #IMPLIED
- classpath CDATA #IMPLIED
- dir CDATA #IMPLIED
- showsuccess %boolean; #IMPLIED
- description CDATA #IMPLIED
- jvmversion CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- showbanner CDATA #IMPLIED
- taskname CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED
- classname CDATA #IMPLIED
- showtrace %boolean; #IMPLIED>
-
-<!ELEMENT arg EMPTY>
-<!ATTLIST arg
- id ID #IMPLIED
- line CDATA #IMPLIED
- file CDATA #IMPLIED
- value CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT jvmarg EMPTY>
-<!ATTLIST jvmarg
- id ID #IMPLIED
- line CDATA #IMPLIED
- file CDATA #IMPLIED
- value CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT sysproperty EMPTY>
-<!ATTLIST sysproperty
- id ID #IMPLIED
- key CDATA #IMPLIED
- file CDATA #IMPLIED
- value CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT testlet (#PCDATA)>
-<!ATTLIST testlet
- id ID #IMPLIED>
-
-<!ELEMENT env EMPTY>
-<!ATTLIST env
- id ID #IMPLIED
- key CDATA #IMPLIED
- file CDATA #IMPLIED
- value CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT tstamp (format)*>
-<!ATTLIST tstamp
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- prefix CDATA #IMPLIED>
-
-<!ELEMENT format EMPTY>
-<!ATTLIST format
- id ID #IMPLIED
- locale CDATA #IMPLIED
- timezone CDATA #IMPLIED
- unit (millisecond | second | minute | hour | day | week | month | year) #IMPLIED
- pattern CDATA #IMPLIED
- property CDATA #IMPLIED
- offset CDATA #IMPLIED>
-
-<!ELEMENT unwar (fileset | patternset)*>
-<!ATTLIST unwar
- id ID #IMPLIED
- overwrite %boolean; #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT vsshistory EMPTY>
-<!ATTLIST vsshistory
- id ID #IMPLIED
- style (brief | codediff | nofile | default) #IMPLIED
- numdays CDATA #IMPLIED
- todate CDATA #IMPLIED
- fromlabel CDATA #IMPLIED
- output CDATA #IMPLIED
- ssdir CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- vsspath CDATA #IMPLIED
- fromdate CDATA #IMPLIED
- user CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- login CDATA #IMPLIED
- tolabel CDATA #IMPLIED
- taskname CDATA #IMPLIED
- dateformat CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT icontract (patternset | exclude | include | custom | none | present | not | or | contains | depend | classpath | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST icontract
- id ID #IMPLIED
- classdir CDATA #IMPLIED
- excludes CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- classpathref IDREF #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- repositorydir CDATA #IMPLIED
- instrumentdir CDATA #IMPLIED
- updateicontrol %boolean; #IMPLIED
- builddir CDATA #IMPLIED
- followsymlinks %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- controlfile CDATA #IMPLIED
- pre %boolean; #IMPLIED
- includes CDATA #IMPLIED
- invariant %boolean; #IMPLIED
- description CDATA #IMPLIED
- post %boolean; #IMPLIED
- includesfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- failthrowable CDATA #IMPLIED
- verbosity CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- targets CDATA #IMPLIED
- repbuilddir CDATA #IMPLIED>
-
-<!ELEMENT cvschangelog (fileset | user)*>
-<!ATTLIST cvschangelog
- id ID #IMPLIED
- end CDATA #IMPLIED
- dir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- usersfile CDATA #IMPLIED
- daysinpast CDATA #IMPLIED
- start CDATA #IMPLIED
- destfile CDATA #IMPLIED>
-
-<!ELEMENT user EMPTY>
-<!ATTLIST user
- id ID #IMPLIED
- userid CDATA #IMPLIED
- displayname CDATA #IMPLIED>
-
-<!ELEMENT p4submit EMPTY>
-<!ATTLIST p4submit
- id ID #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- change CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT ccmcheckin EMPTY>
-<!ATTLIST ccmcheckin
- id ID #IMPLIED
- ccmaction CDATA #IMPLIED
- task CDATA #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- ccmdir CDATA #IMPLIED
- comment CDATA #IMPLIED>
-
-<!ELEMENT p4change EMPTY>
-<!ATTLIST p4change
- id ID #IMPLIED
- view CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- port CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- failonerror %boolean; #IMPLIED>
-
-<!ELEMENT bzip2 EMPTY>
-<!ATTLIST bzip2
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- zipfile CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT p4delete EMPTY>
-<!ATTLIST p4delete
- id ID #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- change CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT vssadd EMPTY>
-<!ATTLIST vssadd
- id ID #IMPLIED
- recursive %boolean; #IMPLIED
- ssdir CDATA #IMPLIED
- autoresponse CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- comment CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- writable %boolean; #IMPLIED
- login CDATA #IMPLIED
- taskname CDATA #IMPLIED
- localpath CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT javadoc (bottom | source | classpath | doctitle | header | excludepackage | bootclasspath | doclet | taglet | fileset | packageset | sourcepath | link | footer | package | group | tag)*>
-<!ATTLIST javadoc
- id ID #IMPLIED
- bottom CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- bootclasspathref IDREF #IMPLIED
- header CDATA #IMPLIED
- link CDATA #IMPLIED
- noindex %boolean; #IMPLIED
- access (protected | public | package | private) #IMPLIED
- doclet CDATA #IMPLIED
- public %boolean; #IMPLIED
- author %boolean; #IMPLIED
- footer CDATA #IMPLIED
- docletpath CDATA #IMPLIED
- package %boolean; #IMPLIED
- useexternalfile %boolean; #IMPLIED
- sourcepathref IDREF #IMPLIED
- description CDATA #IMPLIED
- protected %boolean; #IMPLIED
- nonavbar %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- group CDATA #IMPLIED
- source CDATA #IMPLIED
- linkoffline CDATA #IMPLIED
- additionalparam CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- locale CDATA #IMPLIED
- destdir CDATA #IMPLIED
- classpath CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- bootclasspath CDATA #IMPLIED
- private %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- charset CDATA #IMPLIED
- nodeprecatedlist %boolean; #IMPLIED
- classpathref IDREF #IMPLIED
- stylesheetfile CDATA #IMPLIED
- docencoding CDATA #IMPLIED
- excludepackagenames CDATA #IMPLIED
- docletpathref IDREF #IMPLIED
- packagenames CDATA #IMPLIED
- windowtitle CDATA #IMPLIED
- notree %boolean; #IMPLIED
- splitindex %boolean; #IMPLIED
- packagelist CDATA #IMPLIED
- encoding CDATA #IMPLIED
- doctitle CDATA #IMPLIED
- serialwarn %boolean; #IMPLIED
- old %boolean; #IMPLIED
- use %boolean; #IMPLIED
- sourcepath CDATA #IMPLIED
- helpfile CDATA #IMPLIED
- version %boolean; #IMPLIED
- sourcefiles CDATA #IMPLIED
- extdirs CDATA #IMPLIED
- nohelp %boolean; #IMPLIED
- nodeprecated %boolean; #IMPLIED
- overview CDATA #IMPLIED>
-
-<!ELEMENT bottom (#PCDATA)>
-<!ATTLIST bottom
- id ID #IMPLIED>
-
-<!ELEMENT source EMPTY>
-<!ATTLIST source
- id ID #IMPLIED
- file CDATA #IMPLIED>
-
-<!ELEMENT doctitle (#PCDATA)>
-<!ATTLIST doctitle
- id ID #IMPLIED>
-
-<!ELEMENT header (#PCDATA)>
-<!ATTLIST header
- id ID #IMPLIED>
-
-<!ELEMENT excludepackage EMPTY>
-<!ATTLIST excludepackage
- id ID #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT bootclasspath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST bootclasspath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT doclet (path | param)*>
-<!ATTLIST doclet
- id ID #IMPLIED
- name CDATA #IMPLIED
- pathref IDREF #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT taglet (path)*>
-<!ATTLIST taglet
- id ID #IMPLIED
- name CDATA #IMPLIED
- pathref IDREF #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT packageset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST packageset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT sourcepath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST sourcepath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT link EMPTY>
-<!ATTLIST link
- id ID #IMPLIED
- href CDATA #IMPLIED
- offline %boolean; #IMPLIED
- packagelistloc CDATA #IMPLIED>
-
-<!ELEMENT footer (#PCDATA)>
-<!ATTLIST footer
- id ID #IMPLIED>
-
-<!ELEMENT package EMPTY>
-<!ATTLIST package
- id ID #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT group (package | title)*>
-<!ATTLIST group
- id ID #IMPLIED
- packages CDATA #IMPLIED
- title CDATA #IMPLIED>
-
-<!ELEMENT title (#PCDATA)>
-<!ATTLIST title
- id ID #IMPLIED>
-
-<!ELEMENT tag EMPTY>
-<!ATTLIST tag
- id ID #IMPLIED
- enabled %boolean; #IMPLIED
- name CDATA #IMPLIED
- scope CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT translate (patternset | exclude | include | custom | none | present | not | or | contains | depend | fileset | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST translate
- id ID #IMPLIED
- bundlecountry CDATA #IMPLIED
- bundlelanguage CDATA #IMPLIED
- excludes CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- srcencoding CDATA #IMPLIED
- bundle CDATA #IMPLIED
- bundleencoding CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- destencoding CDATA #IMPLIED
- bundlevariant CDATA #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- todir CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- endtoken CDATA #IMPLIED
- forceoverwrite %boolean; #IMPLIED
- starttoken CDATA #IMPLIED>
-
-<!ELEMENT signjar (fileset)*>
-<!ATTLIST signjar
- id ID #IMPLIED
- storepass CDATA #IMPLIED
- lazy %boolean; #IMPLIED
- keypass CDATA #IMPLIED
- jar CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- alias CDATA #IMPLIED
- sectionsonly %boolean; #IMPLIED
- keystore CDATA #IMPLIED
- sigfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- internalsf %boolean; #IMPLIED
- storetype CDATA #IMPLIED
- signedjar CDATA #IMPLIED>
-
-<!ELEMENT vajload (vajproject)*>
-<!ATTLIST vajload
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- remote CDATA #IMPLIED>
-
-<!ELEMENT vajproject EMPTY>
-<!ATTLIST vajproject
- id ID #IMPLIED
- version CDATA #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT jarlib-available (extensionset | extension)*>
-<!ATTLIST jarlib-available
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- property CDATA #IMPLIED>
-
-<!ELEMENT extensionset (fileset | libfileset | extension)*>
-<!ATTLIST extensionset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT WsdlToDotnet EMPTY>
-<!ATTLIST WsdlToDotnet
- id ID #IMPLIED
- url CDATA #IMPLIED
- srcfile CDATA #IMPLIED
- namespace CDATA #IMPLIED
- server %boolean; #IMPLIED
- destfile CDATA #IMPLIED
- language CDATA #IMPLIED
- extraoptions CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT buildnumber EMPTY>
-<!ATTLIST buildnumber
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT jpcovmerge (fileset)*>
-<!ATTLIST jpcovmerge
- id ID #IMPLIED
- verbose %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- tofile CDATA #IMPLIED
- description CDATA #IMPLIED
- home CDATA #IMPLIED>
-
-<!ELEMENT ejbjar (patternset | exclude | include | weblogictoplink | custom | none | present | jboss | borland | weblogic | not | iplanet | jonas | or | contains | depend | support | classpath | size | majority | websphere | dtd | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST ejbjar
- id ID #IMPLIED
- descriptordir CDATA #IMPLIED
- excludes CDATA #IMPLIED
- manifest CDATA #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- basenameterminator CDATA #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- dependency CDATA #IMPLIED
- basejarname CDATA #IMPLIED
- flatdestdir %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- naming (ejb-name | directory | descriptor | basejarname) #IMPLIED
- excludesfile CDATA #IMPLIED
- genericjarsuffix CDATA #IMPLIED>
-
-<!ELEMENT weblogictoplink (classpath | wlclasspath | sysproperty)*>
-<!ATTLIST weblogictoplink
- id ID #IMPLIED
- newcmp %boolean; #IMPLIED
- ejbdtd CDATA #IMPLIED
- jvmargs CDATA #IMPLIED
- rebuild %boolean; #IMPLIED
- suffix CDATA #IMPLIED
- args CDATA #IMPLIED
- outputdir CDATA #IMPLIED
- toplinkdtd CDATA #IMPLIED
- wldtd CDATA #IMPLIED
- destdir CDATA #IMPLIED
- weblogicdtd CDATA #IMPLIED
- wlclasspath CDATA #IMPLIED
- jvmdebuglevel CDATA #IMPLIED
- classpath CDATA #IMPLIED
- keepgenerated CDATA #IMPLIED
- compiler CDATA #IMPLIED
- oldcmp %boolean; #IMPLIED
- keepgeneric %boolean; #IMPLIED
- ejbcclass CDATA #IMPLIED
- toplinkdescriptor CDATA #IMPLIED
- noejbc %boolean; #IMPLIED
- genericjarsuffix CDATA #IMPLIED>
-
-<!ELEMENT jboss (classpath)*>
-<!ATTLIST jboss
- id ID #IMPLIED
- destdir CDATA #IMPLIED
- genericjarsuffix CDATA #IMPLIED
- classpath CDATA #IMPLIED>
-
-<!ELEMENT borland (classpath)*>
-<!ATTLIST borland
- id ID #IMPLIED
- verifyargs CDATA #IMPLIED
- debug %boolean; #IMPLIED
- destdir CDATA #IMPLIED
- classpath CDATA #IMPLIED
- genericjarsuffix CDATA #IMPLIED
- version CDATA #IMPLIED
- basdtd CDATA #IMPLIED
- verify %boolean; #IMPLIED
- suffix CDATA #IMPLIED
- generateclient %boolean; #IMPLIED>
-
-<!ELEMENT weblogic (classpath | wlclasspath | sysproperty)*>
-<!ATTLIST weblogic
- id ID #IMPLIED
- newcmp %boolean; #IMPLIED
- ejbdtd CDATA #IMPLIED
- jvmargs CDATA #IMPLIED
- rebuild %boolean; #IMPLIED
- suffix CDATA #IMPLIED
- args CDATA #IMPLIED
- outputdir CDATA #IMPLIED
- wldtd CDATA #IMPLIED
- destdir CDATA #IMPLIED
- weblogicdtd CDATA #IMPLIED
- wlclasspath CDATA #IMPLIED
- jvmdebuglevel CDATA #IMPLIED
- classpath CDATA #IMPLIED
- keepgenerated CDATA #IMPLIED
- compiler CDATA #IMPLIED
- oldcmp %boolean; #IMPLIED
- keepgeneric %boolean; #IMPLIED
- ejbcclass CDATA #IMPLIED
- noejbc %boolean; #IMPLIED
- genericjarsuffix CDATA #IMPLIED>
-
-<!ELEMENT iplanet (classpath)*>
-<!ATTLIST iplanet
- id ID #IMPLIED
- destdir CDATA #IMPLIED
- genericjarsuffix CDATA #IMPLIED
- keepgenerated %boolean; #IMPLIED
- debug %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- suffix CDATA #IMPLIED
- iashome CDATA #IMPLIED>
-
-<!ELEMENT jonas (classpath)*>
-<!ATTLIST jonas
- id ID #IMPLIED
- jonasroot CDATA #IMPLIED
- additionalargs CDATA #IMPLIED
- keepgeneric %boolean; #IMPLIED
- javac CDATA #IMPLIED
- destdir CDATA #IMPLIED
- orb CDATA #IMPLIED
- classpath CDATA #IMPLIED
- jarsuffix CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- nogenic %boolean; #IMPLIED
- genericjarsuffix CDATA #IMPLIED
- rmicopts CDATA #IMPLIED
- javacopts CDATA #IMPLIED
- novalidation %boolean; #IMPLIED
- nocompil %boolean; #IMPLIED
- keepgenerated %boolean; #IMPLIED
- secpropag %boolean; #IMPLIED>
-
-<!ELEMENT support (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST support
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT websphere (classpath | wasclasspath)*>
-<!ATTLIST websphere
- id ID #IMPLIED
- newcmp %boolean; #IMPLIED
- ejbdtd CDATA #IMPLIED
- noinform %boolean; #IMPLIED
- rebuild %boolean; #IMPLIED
- suffix CDATA #IMPLIED
- args CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- dbschema CDATA #IMPLIED
- destdir CDATA #IMPLIED
- ejbdeploy %boolean; #IMPLIED
- tempdir CDATA #IMPLIED
- use35 %boolean; #IMPLIED
- novalidate %boolean; #IMPLIED
- codegen %boolean; #IMPLIED
- dbvendor (SQL92 | SQL99 | DB2UDBWIN_V71 | DB2UDBOS390_V6 | DB2UDBAS400_V4R5 | ORACLE_V8 | INFORMIX_V92 | SYBASE_V1192 | MSSQLSERVER_V7 | MYSQL_V323) #IMPLIED
- classpath CDATA #IMPLIED
- keepgenerated CDATA #IMPLIED
- compiler CDATA #IMPLIED
- wasclasspath CDATA #IMPLIED
- oldcmp %boolean; #IMPLIED
- dbname CDATA #IMPLIED
- keepgeneric %boolean; #IMPLIED
- trace %boolean; #IMPLIED
- nowarn %boolean; #IMPLIED
- genericjarsuffix CDATA #IMPLIED>
-
-<!ELEMENT wasclasspath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST wasclasspath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT war (patternset | exclude | include | custom | none | present | manifest | not | metainf | or | contains | lib | depend | fileset | size | majority | filename | selector | includesfile | zipgroupfileset | zipfileset | classes | date | webinf | excludesfile | depth | and)*>
-<!ATTLIST war
- id ID #IMPLIED
- whenempty (fail | skip | create) #IMPLIED
- duplicate (add | preserve | fail) #IMPLIED
- excludes CDATA #IMPLIED
- manifest CDATA #IMPLIED
- basedir CDATA #IMPLIED
- encoding CDATA #IMPLIED
- jarfile CDATA #IMPLIED
- index %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- update %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- destfile CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- includes CDATA #IMPLIED
- webxml CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- compress %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- warfile CDATA #IMPLIED
- filesonly %boolean; #IMPLIED
- file CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- zipfile CDATA #IMPLIED>
-
-<!ELEMENT manifest (attribute | section)*>
-<!ATTLIST manifest
- id ID #IMPLIED>
-
-<!ELEMENT attribute EMPTY>
-<!ATTLIST attribute
- id ID #IMPLIED
- name CDATA #IMPLIED
- value CDATA #IMPLIED>
-
-<!ELEMENT section (attribute)*>
-<!ATTLIST section
- id ID #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT metainf (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST metainf
- id ID #IMPLIED
- src CDATA #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT lib (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST lib
- id ID #IMPLIED
- src CDATA #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT classes (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST classes
- id ID #IMPLIED
- src CDATA #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT webinf (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST webinf
- id ID #IMPLIED
- src CDATA #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT rename EMPTY>
-<!ATTLIST rename
- id ID #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- replace CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT sequential (%tasks;)*>
-<!ATTLIST sequential
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT serverdeploy (weblogic | generic | jonas)*>
-<!ATTLIST serverdeploy
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- action CDATA #IMPLIED
- source CDATA #IMPLIED>
-
-<!ELEMENT generic (arg | jvmarg | classpath)*>
-<!ATTLIST generic
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- password CDATA #IMPLIED
- classname CDATA #IMPLIED
- server CDATA #IMPLIED
- username CDATA #IMPLIED>
-
-<!ELEMENT property (classpath)*>
-<!ATTLIST property
- id ID #IMPLIED
- refid IDREF #IMPLIED
- name CDATA #IMPLIED
- classpath CDATA #IMPLIED
- file CDATA #IMPLIED
- userproperty %boolean; #IMPLIED
- resource CDATA #IMPLIED
- environment CDATA #IMPLIED
- prefix CDATA #IMPLIED
- taskname CDATA #IMPLIED
- value CDATA #IMPLIED
- location CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT move (filterchain | fileset | filterset | mapper)*>
-<!ATTLIST move
- id ID #IMPLIED
- flatten %boolean; #IMPLIED
- encoding CDATA #IMPLIED
- tofile CDATA #IMPLIED
- todir CDATA #IMPLIED
- file CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- includeemptydirs %boolean; #IMPLIED
- overwrite %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- preservelastmodified %boolean; #IMPLIED
- filtering %boolean; #IMPLIED>
-
-<!ELEMENT copydir (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST copydir
- id ID #IMPLIED
- flatten %boolean; #IMPLIED
- src CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- dest CDATA #IMPLIED
- forceoverwrite %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- filtering %boolean; #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT cccheckin EMPTY>
-<!ATTLIST cccheckin
- id ID #IMPLIED
- preservetime %boolean; #IMPLIED
- viewpath CDATA #IMPLIED
- comment CDATA #IMPLIED
- nowarn %boolean; #IMPLIED
- identical %boolean; #IMPLIED
- cleartooldir CDATA #IMPLIED
- keepcopy %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- commentfile CDATA #IMPLIED>
-
-<!ELEMENT wljspc (patternset | exclude | include | custom | none | present | not | or | contains | depend | classpath | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST wljspc
- id ID #IMPLIED
- src CDATA #IMPLIED
- classpath CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- package CDATA #IMPLIED
- dest CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT fixcrlf (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST fixcrlf
- id ID #IMPLIED
- tab (add | asis | remove) #IMPLIED
- excludes CDATA #IMPLIED
- encoding CDATA #IMPLIED
- cr (add | asis | remove) #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- eol (asis | cr | lf | crlf) #IMPLIED
- followsymlinks %boolean; #IMPLIED
- javafiles %boolean; #IMPLIED
- eof (add | asis | remove) #IMPLIED
- casesensitive %boolean; #IMPLIED
- tablength CDATA #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- excludesfile CDATA #IMPLIED>
-
-<!ELEMENT sosget EMPTY>
-<!ATTLIST sosget
- id ID #IMPLIED
- password CDATA #IMPLIED
- comment CDATA #IMPLIED
- nocompress %boolean; #IMPLIED
- version CDATA #IMPLIED
- username CDATA #IMPLIED
- sosserverpath CDATA #IMPLIED
- label CDATA #IMPLIED
- vssserverpath CDATA #IMPLIED
- soscmd CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- localpath CDATA #IMPLIED
- nocache %boolean; #IMPLIED
- projectpath CDATA #IMPLIED
- description CDATA #IMPLIED
- taskname CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- file CDATA #IMPLIED
- soshome CDATA #IMPLIED>
-
-<!ELEMENT pathconvert (map | path)*>
-<!ATTLIST pathconvert
- id ID #IMPLIED
- pathsep CDATA #IMPLIED
- taskname CDATA #IMPLIED
- refid IDREF #IMPLIED
- dirsep CDATA #IMPLIED
- setonempty %boolean; #IMPLIED
- description CDATA #IMPLIED
- property CDATA #IMPLIED
- targetos CDATA #IMPLIED>
-
-<!ELEMENT map EMPTY>
-<!ATTLIST map
- id ID #IMPLIED
- from CDATA #IMPLIED
- to CDATA #IMPLIED>
-
-<!ELEMENT record EMPTY>
-<!ATTLIST record
- id ID #IMPLIED
- append %boolean; #IMPLIED
- name CDATA #IMPLIED
- taskname CDATA #IMPLIED
- loglevel (error | warn | info | verbose | debug) #IMPLIED
- emacsmode %boolean; #IMPLIED
- description CDATA #IMPLIED
- action (start | stop) #IMPLIED>
-
-<!ELEMENT p4sync EMPTY>
-<!ATTLIST p4sync
- id ID #IMPLIED
- force CDATA #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- view CDATA #IMPLIED
- label CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT exec (arg | env)*>
-<!ATTLIST exec
- id ID #IMPLIED
- append %boolean; #IMPLIED
- output CDATA #IMPLIED
- dir CDATA #IMPLIED
- command CDATA #IMPLIED
- outputproperty CDATA #IMPLIED
- os CDATA #IMPLIED
- resultproperty CDATA #IMPLIED
- failifexecutionfails %boolean; #IMPLIED
- timeout CDATA #IMPLIED
- taskname CDATA #IMPLIED
- vmlauncher %boolean; #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- executable CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED>
-
-<!ELEMENT p4edit EMPTY>
-<!ATTLIST p4edit
- id ID #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- change CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT maudit (fileset | rulespath | jvmarg | classpath | searchpath | sourcepath)*>
-<!ATTLIST maudit
- id ID #IMPLIED
- exit %boolean; #IMPLIED
- tofile CDATA #IMPLIED
- offsets %boolean; #IMPLIED
- unused %boolean; #IMPLIED
- quiet %boolean; #IMPLIED
- verbose %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- fix %boolean; #IMPLIED
- metamatahome CDATA #IMPLIED
- list %boolean; #IMPLIED
- fullsemanticize %boolean; #IMPLIED
- home CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT rulespath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST rulespath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT searchpath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST searchpath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT antlr (jvmarg | classpath)*>
-<!ATTLIST antlr
- id ID #IMPLIED
- debug %boolean; #IMPLIED
- outputdirectory CDATA #IMPLIED
- fork %boolean; #IMPLIED
- dir CDATA #IMPLIED
- trace %boolean; #IMPLIED
- tracetreewalker %boolean; #IMPLIED
- html %boolean; #IMPLIED
- tracelexer %boolean; #IMPLIED
- diagnostic %boolean; #IMPLIED
- traceparser %boolean; #IMPLIED
- target CDATA #IMPLIED
- taskname CDATA #IMPLIED
- glib CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT netrexxc (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST netrexxc
- id ID #IMPLIED
- excludes CDATA #IMPLIED
- verbose (verbose | verbose0 | verbose1 | verbose2 | verbose3 | verbose4 | verbose5 | noverbose) #IMPLIED
- keep %boolean; #IMPLIED
- comments %boolean; #IMPLIED
- strictimport %boolean; #IMPLIED
- sourcedir %boolean; #IMPLIED
- diag %boolean; #IMPLIED
- compile %boolean; #IMPLIED
- binary %boolean; #IMPLIED
- description CDATA #IMPLIED
- includes CDATA #IMPLIED
- suppressmethodargumentnotused %boolean; #IMPLIED
- suppressvariablenotused %boolean; #IMPLIED
- strictsignal %boolean; #IMPLIED
- trace (trace | trace1 | trace2 | notrace) #IMPLIED
- destdir CDATA #IMPLIED
- console %boolean; #IMPLIED
- replace %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- format %boolean; #IMPLIED
- explicit %boolean; #IMPLIED
- suppressprivatepropertynotused %boolean; #IMPLIED
- includesfile CDATA #IMPLIED
- strictargs %boolean; #IMPLIED
- suppressdeprecation %boolean; #IMPLIED
- strictcase %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- savelog %boolean; #IMPLIED
- logo %boolean; #IMPLIED
- utf8 %boolean; #IMPLIED
- strictprops %boolean; #IMPLIED
- srcdir CDATA #IMPLIED
- java %boolean; #IMPLIED
- suppressexceptionnotsignalled %boolean; #IMPLIED
- crossref %boolean; #IMPLIED
- time %boolean; #IMPLIED
- symbols %boolean; #IMPLIED
- excludesfile CDATA #IMPLIED
- strictassign %boolean; #IMPLIED
- compact %boolean; #IMPLIED
- decimal %boolean; #IMPLIED>
-
-<!ELEMENT jpcovreport (reference | coveragepath | sourcepath)*>
-<!ATTLIST jpcovreport
- id ID #IMPLIED
- snapshot CDATA #IMPLIED
- filters CDATA #IMPLIED
- tofile CDATA #IMPLIED
- percent CDATA #IMPLIED
- home CDATA #IMPLIED
- type (executive | summary | detailed | verydetailed) #IMPLIED
- taskname CDATA #IMPLIED
- format (html | text | xml) #IMPLIED
- includesource %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT reference (classpath | filters)*>
-<!ATTLIST reference
- id ID #IMPLIED>
-
-<!ELEMENT filters (include | exclude)*>
-<!ATTLIST filters
- id ID #IMPLIED>
-
-<!ELEMENT coveragepath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST coveragepath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT execon (arg | fileset | env | targetfile | srcfile | mapper)*>
-<!ATTLIST execon
- id ID #IMPLIED
- resultproperty CDATA #IMPLIED
- skipemptyfilesets %boolean; #IMPLIED
- type (file | dir | both) #IMPLIED
- failifexecutionfails %boolean; #IMPLIED
- command CDATA #IMPLIED
- executable CDATA #IMPLIED
- os CDATA #IMPLIED
- output CDATA #IMPLIED
- timeout CDATA #IMPLIED
- dest CDATA #IMPLIED
- dir CDATA #IMPLIED
- description CDATA #IMPLIED
- outputproperty CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED
- vmlauncher %boolean; #IMPLIED
- relative %boolean; #IMPLIED
- parallel %boolean; #IMPLIED>
-
-<!ELEMENT targetfile EMPTY>
-<!ATTLIST targetfile
- id ID #IMPLIED>
-
-<!ELEMENT srcfile EMPTY>
-<!ATTLIST srcfile
- id ID #IMPLIED>
-
-<!ELEMENT ccmcheckout EMPTY>
-<!ATTLIST ccmcheckout
- id ID #IMPLIED
- ccmaction CDATA #IMPLIED
- task CDATA #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- ccmdir CDATA #IMPLIED
- comment CDATA #IMPLIED>
-
-<!ELEMENT ant (reference | property)*>
-<!ATTLIST ant
- id ID #IMPLIED
- output CDATA #IMPLIED
- inheritall %boolean; #IMPLIED
- dir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- inheritrefs %boolean; #IMPLIED
- description CDATA #IMPLIED
- antfile CDATA #IMPLIED
- target CDATA #IMPLIED>
-
-<!ELEMENT xmlvalidate (fileset | classpath | dtd | xmlcatalog)*>
-<!ATTLIST xmlvalidate
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- file CDATA #IMPLIED
- classname CDATA #IMPLIED
- lenient %boolean; #IMPLIED
- warn %boolean; #IMPLIED
- classpathref IDREF #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT xslt (patternset | exclude | include | custom | none | present | not | param | or | contains | depend | classpath | size | majority | filename | xmlcatalog | selector | outputproperty | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST xslt
- id ID #IMPLIED
- force %boolean; #IMPLIED
- excludes CDATA #IMPLIED
- processor CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- basedir CDATA #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- scanincludeddirectories %boolean; #IMPLIED
- extension CDATA #IMPLIED
- in CDATA #IMPLIED
- followsymlinks %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- out CDATA #IMPLIED
- style CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- excludesfile CDATA #IMPLIED>
-
-<!ELEMENT iplanet-ejbc (classpath)*>
-<!ATTLIST iplanet-ejbc
- id ID #IMPLIED
- ejbdescriptor CDATA #IMPLIED
- debug %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- iasdescriptor CDATA #IMPLIED
- iashome CDATA #IMPLIED
- taskname CDATA #IMPLIED
- dest CDATA #IMPLIED
- description CDATA #IMPLIED
- keepgenerated %boolean; #IMPLIED>
-
-<!ELEMENT ccmcheckintask EMPTY>
-<!ATTLIST ccmcheckintask
- id ID #IMPLIED
- ccmaction CDATA #IMPLIED
- task CDATA #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- ccmdir CDATA #IMPLIED
- comment CDATA #IMPLIED>
-
-<!ELEMENT gzip EMPTY>
-<!ATTLIST gzip
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- zipfile CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT native2ascii (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | mapper | date | excludesfile | depth | and)*>
-<!ATTLIST native2ascii
- id ID #IMPLIED
- src CDATA #IMPLIED
- ext CDATA #IMPLIED
- encoding CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- reverse %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- dest CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT starteam EMPTY>
-<!ATTLIST starteam
- id ID #IMPLIED
- targetfolderabsolute %boolean; #IMPLIED
- force %boolean; #IMPLIED
- recursion %boolean; #IMPLIED
- verbose %boolean; #IMPLIED
- username CDATA #IMPLIED
- targetfolder CDATA #IMPLIED
- viewname CDATA #IMPLIED
- projectname CDATA #IMPLIED
- servername CDATA #IMPLIED
- taskname CDATA #IMPLIED
- serverport CDATA #IMPLIED
- description CDATA #IMPLIED
- password CDATA #IMPLIED
- foldername CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT ear (patternset | exclude | include | custom | none | present | manifest | not | metainf | or | contains | depend | fileset | size | majority | archives | filename | selector | includesfile | zipgroupfileset | zipfileset | date | excludesfile | depth | and)*>
-<!ATTLIST ear
- id ID #IMPLIED
- whenempty (fail | skip | create) #IMPLIED
- duplicate (add | preserve | fail) #IMPLIED
- excludes CDATA #IMPLIED
- manifest CDATA #IMPLIED
- basedir CDATA #IMPLIED
- encoding CDATA #IMPLIED
- jarfile CDATA #IMPLIED
- index %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- update %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- destfile CDATA #IMPLIED
- earfile CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- appxml CDATA #IMPLIED
- compress %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- filesonly %boolean; #IMPLIED
- file CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- zipfile CDATA #IMPLIED>
-
-<!ELEMENT archives (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST archives
- id ID #IMPLIED
- src CDATA #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT input (#PCDATA)>
-<!ATTLIST input
- id ID #IMPLIED
- addproperty CDATA #IMPLIED
- taskname CDATA #IMPLIED
- validargs CDATA #IMPLIED
- message CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT rmic (patternset | exclude | include | custom | none | present | extdirs | not | or | contains | depend | classpath | size | majority | filename | selector | includesfile | compilerarg | date | excludesfile | depth | and)*>
-<!ATTLIST rmic
- id ID #IMPLIED
- verify %boolean; #IMPLIED
- idlopts CDATA #IMPLIED
- iiop %boolean; #IMPLIED
- excludes CDATA #IMPLIED
- extdirs CDATA #IMPLIED
- sourcebase CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- base CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- includejavaruntime %boolean; #IMPLIED
- includeantruntime %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- debug %boolean; #IMPLIED
- compiler CDATA #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- idl %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- iiopopts CDATA #IMPLIED
- classname CDATA #IMPLIED
- stubversion CDATA #IMPLIED
- filtering %boolean; #IMPLIED
- excludesfile CDATA #IMPLIED>
-
-<!ELEMENT extdirs (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST extdirs
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT compilerarg EMPTY>
-<!ATTLIST compilerarg
- id ID #IMPLIED
- implementation CDATA #IMPLIED
- line CDATA #IMPLIED
- file CDATA #IMPLIED
- compiler CDATA #IMPLIED
- value CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT checksum (patternset | exclude | include | custom | none | present | not | or | contains | depend | fileset | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST checksum
- id ID #IMPLIED
- file CDATA #IMPLIED
- verifyproperty CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- readbuffersize CDATA #IMPLIED
- algorithm CDATA #IMPLIED
- provider CDATA #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- forceoverwrite %boolean; #IMPLIED
- property CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- fileext CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT mail (fileset | bcc | message | cc | to | from)*>
-<!ATTLIST mail
- id ID #IMPLIED
- includefilenames %boolean; #IMPLIED
- files CDATA #IMPLIED
- encoding (auto | mime | uu | plain) #IMPLIED
- cclist CDATA #IMPLIED
- bcclist CDATA #IMPLIED
- tolist CDATA #IMPLIED
- subject CDATA #IMPLIED
- mailhost CDATA #IMPLIED
- messagefile CDATA #IMPLIED
- messagemimetype CDATA #IMPLIED
- taskname CDATA #IMPLIED
- from CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- mailport CDATA #IMPLIED
- message CDATA #IMPLIED>
-
-<!ELEMENT bcc EMPTY>
-<!ATTLIST bcc
- id ID #IMPLIED
- address CDATA #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT message (#PCDATA)>
-<!ATTLIST message
- id ID #IMPLIED
- mimetype CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT cc EMPTY>
-<!ATTLIST cc
- id ID #IMPLIED
- address CDATA #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT to EMPTY>
-<!ATTLIST to
- id ID #IMPLIED
- address CDATA #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT from EMPTY>
-<!ATTLIST from
- id ID #IMPLIED
- address CDATA #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT loadfile (filterchain)*>
-<!ATTLIST loadfile
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- encoding CDATA #IMPLIED
- description CDATA #IMPLIED
- property CDATA #IMPLIED
- srcfile CDATA #IMPLIED
- failonerror %boolean; #IMPLIED>
-
-<!ELEMENT vsscheckout EMPTY>
-<!ATTLIST vsscheckout
- id ID #IMPLIED
- date CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- ssdir CDATA #IMPLIED
- autoresponse CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- version CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- login CDATA #IMPLIED
- label CDATA #IMPLIED
- taskname CDATA #IMPLIED
- localpath CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT stylebook (arg | jvmarg | classpath | sysproperty | env)*>
-<!ATTLIST stylebook
- id ID #IMPLIED
- jvmargs CDATA #IMPLIED
- loaderconfig CDATA #IMPLIED
- args CDATA #IMPLIED
- fork %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- jar CDATA #IMPLIED
- targetdirectory CDATA #IMPLIED
- output CDATA #IMPLIED
- timeout CDATA #IMPLIED
- skindirectory CDATA #IMPLIED
- jvm CDATA #IMPLIED
- book CDATA #IMPLIED
- classpath CDATA #IMPLIED
- dir CDATA #IMPLIED
- description CDATA #IMPLIED
- jvmversion CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED
- classname CDATA #IMPLIED>
-
-<!ELEMENT soscheckin EMPTY>
-<!ATTLIST soscheckin
- id ID #IMPLIED
- password CDATA #IMPLIED
- comment CDATA #IMPLIED
- nocompress %boolean; #IMPLIED
- version CDATA #IMPLIED
- username CDATA #IMPLIED
- sosserverpath CDATA #IMPLIED
- label CDATA #IMPLIED
- vssserverpath CDATA #IMPLIED
- soscmd CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- localpath CDATA #IMPLIED
- nocache %boolean; #IMPLIED
- projectpath CDATA #IMPLIED
- description CDATA #IMPLIED
- taskname CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- file CDATA #IMPLIED
- soshome CDATA #IMPLIED>
-
-<!ELEMENT mimemail (fileset | bcc | message | cc | to | from)*>
-<!ATTLIST mimemail
- id ID #IMPLIED
- includefilenames %boolean; #IMPLIED
- files CDATA #IMPLIED
- encoding (auto | mime | uu | plain) #IMPLIED
- cclist CDATA #IMPLIED
- bcclist CDATA #IMPLIED
- tolist CDATA #IMPLIED
- subject CDATA #IMPLIED
- mailhost CDATA #IMPLIED
- messagefile CDATA #IMPLIED
- messagemimetype CDATA #IMPLIED
- taskname CDATA #IMPLIED
- from CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- mailport CDATA #IMPLIED
- message CDATA #IMPLIED>
-
-<!ELEMENT stlabel EMPTY>
-<!ATTLIST stlabel
- id ID #IMPLIED
- lastbuild CDATA #IMPLIED
- url CDATA #IMPLIED
- username CDATA #IMPLIED
- viewname CDATA #IMPLIED
- projectname CDATA #IMPLIED
- servername CDATA #IMPLIED
- label CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- password CDATA #IMPLIED
- serverport CDATA #IMPLIED>
-
-<!ELEMENT gunzip EMPTY>
-<!ATTLIST gunzip
- id ID #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT concat (#PCDATA | fileset | filelist)*>
-<!ATTLIST concat
- id ID #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- encoding CDATA #IMPLIED
- description CDATA #IMPLIED
- destfile CDATA #IMPLIED>
-
-<!ELEMENT cab (patternset | exclude | include | custom | none | present | not | or | contains | depend | fileset | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST cab
- id ID #IMPLIED
- cabfile CDATA #IMPLIED
- compress %boolean; #IMPLIED
- verbose %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- basedir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- options CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT touch (fileset)*>
-<!ATTLIST touch
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- millis CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- datetime CDATA #IMPLIED>
-
-<!ELEMENT parallel (%tasks;)*>
-<!ATTLIST parallel
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT splash EMPTY>
-<!ATTLIST splash
- id ID #IMPLIED
- port CDATA #IMPLIED
- user CDATA #IMPLIED
- proxy CDATA #IMPLIED
- imageurl CDATA #IMPLIED
- taskname CDATA #IMPLIED
- showduration CDATA #IMPLIED
- description CDATA #IMPLIED
- password CDATA #IMPLIED
- useproxy %boolean; #IMPLIED>
-
-<!ELEMENT antcall (reference | param)*>
-<!ATTLIST antcall
- id ID #IMPLIED
- inheritall %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- inheritrefs %boolean; #IMPLIED
- description CDATA #IMPLIED
- target CDATA #IMPLIED>
-
-<!ELEMENT cccheckout EMPTY>
-<!ATTLIST cccheckout
- id ID #IMPLIED
- reserved %boolean; #IMPLIED
- viewpath CDATA #IMPLIED
- out CDATA #IMPLIED
- nodata %boolean; #IMPLIED
- comment CDATA #IMPLIED
- version %boolean; #IMPLIED
- nowarn %boolean; #IMPLIED
- cleartooldir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- branch CDATA #IMPLIED
- description CDATA #IMPLIED
- commentfile CDATA #IMPLIED>
-
-<!ELEMENT typedef (classpath)*>
-<!ATTLIST typedef
- id ID #IMPLIED
- name CDATA #IMPLIED
- classpath CDATA #IMPLIED
- file CDATA #IMPLIED
- classname CDATA #IMPLIED
- resource CDATA #IMPLIED
- loaderref IDREF #IMPLIED
- classpathref IDREF #IMPLIED
- taskname CDATA #IMPLIED
- reverseloader %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT p4have EMPTY>
-<!ATTLIST p4have
- id ID #IMPLIED
- view CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- port CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- failonerror %boolean; #IMPLIED>
-
-<!ELEMENT xmlproperty EMPTY>
-<!ATTLIST xmlproperty
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- collapseattributes %boolean; #IMPLIED
- keeproot %boolean; #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- prefix CDATA #IMPLIED
- validate %boolean; #IMPLIED>
-
-<!ELEMENT copy (filterchain | fileset | filterset | mapper)*>
-<!ATTLIST copy
- id ID #IMPLIED
- flatten %boolean; #IMPLIED
- encoding CDATA #IMPLIED
- tofile CDATA #IMPLIED
- todir CDATA #IMPLIED
- file CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- includeemptydirs %boolean; #IMPLIED
- overwrite %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- preservelastmodified %boolean; #IMPLIED
- filtering %boolean; #IMPLIED>
-
-<!ELEMENT antstructure EMPTY>
-<!ATTLIST antstructure
- id ID #IMPLIED
- output CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT ccmcreatetask EMPTY>
-<!ATTLIST ccmcreatetask
- id ID #IMPLIED
- subsystem CDATA #IMPLIED
- task CDATA #IMPLIED
- platform CDATA #IMPLIED
- resolver CDATA #IMPLIED
- comment CDATA #IMPLIED
- ccmaction CDATA #IMPLIED
- ccmdir CDATA #IMPLIED
- release CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT rpm EMPTY>
-<!ATTLIST rpm
- id ID #IMPLIED
- removesource %boolean; #IMPLIED
- output CDATA #IMPLIED
- command CDATA #IMPLIED
- cleanbuilddir %boolean; #IMPLIED
- removespec %boolean; #IMPLIED
- error CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- specfile CDATA #IMPLIED
- topdir CDATA #IMPLIED>
-
-<!ELEMENT delete (exclude | patternset | include | custom | none | present | not | or | contains | depend | fileset | size | majority | filename | selector | includesfile | date | excludesfile | and | depth)*>
-<!ATTLIST delete
- id ID #IMPLIED
- file CDATA #IMPLIED
- dir CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- verbose %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- includeemptydirs %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT replace (patternset | exclude | include | custom | none | present | not | replacefilter | or | contains | depend | replacetoken | size | majority | filename | selector | includesfile | replacevalue | date | excludesfile | depth | and)*>
-<!ATTLIST replace
- id ID #IMPLIED
- encoding CDATA #IMPLIED
- file CDATA #IMPLIED
- dir CDATA #IMPLIED
- token CDATA #IMPLIED
- propertyfile CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- summary %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- value CDATA #IMPLIED
- description CDATA #IMPLIED
- replacefilterfile CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT replacefilter EMPTY>
-<!ATTLIST replacefilter
- id ID #IMPLIED
- token CDATA #IMPLIED
- value CDATA #IMPLIED
- property CDATA #IMPLIED>
-
-<!ELEMENT replacetoken (#PCDATA)>
-<!ATTLIST replacetoken
- id ID #IMPLIED>
-
-<!ELEMENT replacevalue (#PCDATA)>
-<!ATTLIST replacevalue
- id ID #IMPLIED>
-
-<!ELEMENT mmetrics (fileset | jvmarg | classpath | path | sourcepath)*>
-<!ATTLIST mmetrics
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- metamatahome CDATA #IMPLIED
- tofile CDATA #IMPLIED
- description CDATA #IMPLIED
- maxmemory CDATA #IMPLIED
- granularity (compilation-units | files | methods | types | packages) #IMPLIED
- home CDATA #IMPLIED>
-
-<!ELEMENT waitfor (isfalse | equals | available | not | contains | os | or | and | filesmatch | checksum | istrue | isset | socket | http | uptodate)*>
-<!ATTLIST waitfor
- id ID #IMPLIED
- checkeveryunit (millisecond | second | minute | hour | day | week) #IMPLIED
- checkevery CDATA #IMPLIED
- maxwaitunit (millisecond | second | minute | hour | day | week) #IMPLIED
- maxwait CDATA #IMPLIED
- timeoutproperty CDATA #IMPLIED>
-
-<!ELEMENT isfalse EMPTY>
-<!ATTLIST isfalse
- id ID #IMPLIED
- value %boolean; #IMPLIED>
-
-<!ELEMENT equals EMPTY>
-<!ATTLIST equals
- id ID #IMPLIED
- trim %boolean; #IMPLIED
- arg2 CDATA #IMPLIED
- arg1 CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED>
-
-<!ELEMENT available (classpath | filepath)*>
-<!ATTLIST available
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- file CDATA #IMPLIED
- resource CDATA #IMPLIED
- classname CDATA #IMPLIED
- ignoresystemclasses %boolean; #IMPLIED
- type (file | dir) #IMPLIED
- classpathref IDREF #IMPLIED
- taskname CDATA #IMPLIED
- value CDATA #IMPLIED
- property CDATA #IMPLIED
- description CDATA #IMPLIED
- filepath CDATA #IMPLIED>
-
-<!ELEMENT filepath (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST filepath
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT os EMPTY>
-<!ATTLIST os
- id ID #IMPLIED
- version CDATA #IMPLIED
- name CDATA #IMPLIED
- family CDATA #IMPLIED
- arch CDATA #IMPLIED>
-
-<!ELEMENT filesmatch EMPTY>
-<!ATTLIST filesmatch
- id ID #IMPLIED
- file2 CDATA #IMPLIED
- file1 CDATA #IMPLIED>
-
-<!ELEMENT istrue EMPTY>
-<!ATTLIST istrue
- id ID #IMPLIED
- value %boolean; #IMPLIED>
-
-<!ELEMENT isset EMPTY>
-<!ATTLIST isset
- id ID #IMPLIED
- property CDATA #IMPLIED>
-
-<!ELEMENT socket EMPTY>
-<!ATTLIST socket
- id ID #IMPLIED
- port CDATA #IMPLIED
- server CDATA #IMPLIED>
-
-<!ELEMENT http EMPTY>
-<!ATTLIST http
- id ID #IMPLIED
- url CDATA #IMPLIED>
-
-<!ELEMENT uptodate (srcfiles | mapper)*>
-<!ATTLIST uptodate
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- value CDATA #IMPLIED
- property CDATA #IMPLIED
- srcfile CDATA #IMPLIED
- targetfile CDATA #IMPLIED>
-
-<!ELEMENT srcfiles (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST srcfiles
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT untar (fileset | patternset)*>
-<!ATTLIST untar
- id ID #IMPLIED
- compression (none | gzip | bzip2) #IMPLIED
- overwrite %boolean; #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT loadproperties (filterchain)*>
-<!ATTLIST loadproperties
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- srcfile CDATA #IMPLIED>
-
-<!ELEMENT echoproperties EMPTY>
-<!ATTLIST echoproperties
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- prefix CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- destfile CDATA #IMPLIED>
-
-<!ELEMENT junit (batchtest | jvmarg | classpath | sysproperty | formatter | env | test)*>
-<!ATTLIST junit
- id ID #IMPLIED
- showoutput %boolean; #IMPLIED
- haltonerror %boolean; #IMPLIED
- fork %boolean; #IMPLIED
- jvm CDATA #IMPLIED
- dir CDATA #IMPLIED
- failureproperty CDATA #IMPLIED
- maxmemory CDATA #IMPLIED
- filtertrace %boolean; #IMPLIED
- includeantruntime %boolean; #IMPLIED
- haltonfailure %boolean; #IMPLIED
- errorproperty CDATA #IMPLIED
- timeout CDATA #IMPLIED
- printsummary (true | yes | false | no | on | off | withOutAndErr) #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED>
-
-<!ELEMENT batchtest (fileset | formatter)*>
-<!ATTLIST batchtest
- id ID #IMPLIED
- if CDATA #IMPLIED
- unless CDATA #IMPLIED
- haltonerror %boolean; #IMPLIED
- fork %boolean; #IMPLIED
- todir CDATA #IMPLIED
- failureproperty CDATA #IMPLIED
- filtertrace %boolean; #IMPLIED
- haltonfailure %boolean; #IMPLIED
- errorproperty CDATA #IMPLIED>
-
-<!ELEMENT formatter EMPTY>
-<!ATTLIST formatter
- id ID #IMPLIED
- usefile %boolean; #IMPLIED
- type (plain | xml | brief) #IMPLIED
- classname CDATA #IMPLIED
- extension CDATA #IMPLIED>
-
-<!ELEMENT vajexport (include | exclude)*>
-<!ATTLIST vajexport
- id ID #IMPLIED
- exportclasses %boolean; #IMPLIED
- remote CDATA #IMPLIED
- destdir CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- exportresources %boolean; #IMPLIED
- exportsources %boolean; #IMPLIED
- overwrite %boolean; #IMPLIED
- exportdebuginfo %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT stcheckout EMPTY>
-<!ATTLIST stcheckout
- id ID #IMPLIED
- password CDATA #IMPLIED
- projectname CDATA #IMPLIED
- servername CDATA #IMPLIED
- excludes CDATA #IMPLIED
- username CDATA #IMPLIED
- url CDATA #IMPLIED
- rootstarteamfolder CDATA #IMPLIED
- label CDATA #IMPLIED
- viewname CDATA #IMPLIED
- rootlocalfolder CDATA #IMPLIED
- serverport CDATA #IMPLIED
- deleteuncontrolled %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- unlocked %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- locked %boolean; #IMPLIED
- createworkingdirs %boolean; #IMPLIED
- forced %boolean; #IMPLIED>
-
-<!ELEMENT bunzip2 EMPTY>
-<!ATTLIST bunzip2
- id ID #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT copyfile EMPTY>
-<!ATTLIST copyfile
- id ID #IMPLIED
- forceoverwrite %boolean; #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- filtering CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT vsscreate EMPTY>
-<!ATTLIST vsscreate
- id ID #IMPLIED
- ssdir CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- autoresponse CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- comment CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- login CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT ejbc (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST ejbc
- id ID #IMPLIED
- src CDATA #IMPLIED
- manifest CDATA #IMPLIED
- classpath CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- dest CDATA #IMPLIED
- keepgenerated CDATA #IMPLIED
- description CDATA #IMPLIED
- descriptors CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT unjar (fileset | patternset)*>
-<!ATTLIST unjar
- id ID #IMPLIED
- overwrite %boolean; #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT wsdltodotnet EMPTY>
-<!ATTLIST wsdltodotnet
- id ID #IMPLIED
- url CDATA #IMPLIED
- srcfile CDATA #IMPLIED
- namespace CDATA #IMPLIED
- server %boolean; #IMPLIED
- destfile CDATA #IMPLIED
- language CDATA #IMPLIED
- extraoptions CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT mkdir EMPTY>
-<!ATTLIST mkdir
- id ID #IMPLIED
- dir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT condition (isfalse | equals | available | not | contains | os | or | and | filesmatch | checksum | istrue | isset | socket | http | uptodate)*>
-<!ATTLIST condition
- id ID #IMPLIED
- value CDATA #IMPLIED
- property CDATA #IMPLIED>
-
-<!ELEMENT cvs (commandline)*>
-<!ATTLIST cvs
- id ID #IMPLIED
- cvsrsh CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- passfile CDATA #IMPLIED
- command CDATA #IMPLIED
- package CDATA #IMPLIED
- cvsroot CDATA #IMPLIED
- output CDATA #IMPLIED
- port CDATA #IMPLIED
- compressionlevel CDATA #IMPLIED
- dest CDATA #IMPLIED
- noexec %boolean; #IMPLIED
- error CDATA #IMPLIED
- description CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- date CDATA #IMPLIED
- compression %boolean; #IMPLIED
- tag CDATA #IMPLIED>
-
-<!ELEMENT commandline (marker | argument)*>
-<!ATTLIST commandline
- id ID #IMPLIED
- executable CDATA #IMPLIED>
-
-<!ELEMENT marker EMPTY>
-<!ATTLIST marker
- id ID #IMPLIED>
-
-<!ELEMENT argument EMPTY>
-<!ATTLIST argument
- id ID #IMPLIED
- line CDATA #IMPLIED
- file CDATA #IMPLIED
- value CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT tempfile EMPTY>
-<!ATTLIST tempfile
- id ID #IMPLIED
- destdir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- prefix CDATA #IMPLIED
- property CDATA #IMPLIED
- suffix CDATA #IMPLIED>
-
-<!ELEMENT junitreport (report | fileset)*>
-<!ATTLIST junitreport
- id ID #IMPLIED
- todir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- tofile CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT report EMPTY>
-<!ATTLIST report
- id ID #IMPLIED
- todir CDATA #IMPLIED
- styledir CDATA #IMPLIED
- format (frames | noframes) #IMPLIED
- extension CDATA #IMPLIED>
-
-<!ELEMENT taskdef (classpath)*>
-<!ATTLIST taskdef
- id ID #IMPLIED
- name CDATA #IMPLIED
- classpath CDATA #IMPLIED
- file CDATA #IMPLIED
- classname CDATA #IMPLIED
- resource CDATA #IMPLIED
- loaderref IDREF #IMPLIED
- classpathref IDREF #IMPLIED
- taskname CDATA #IMPLIED
- reverseloader %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT echo (#PCDATA)>
-<!ATTLIST echo
- id ID #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- message CDATA #IMPLIED
- description CDATA #IMPLIED
- level (error | warning | info | verbose | debug) #IMPLIED>
-
-<!ELEMENT ccupdate EMPTY>
-<!ATTLIST ccupdate
- id ID #IMPLIED
- preservetime %boolean; #IMPLIED
- rename %boolean; #IMPLIED
- log CDATA #IMPLIED
- viewpath CDATA #IMPLIED
- overwrite %boolean; #IMPLIED
- cleartooldir CDATA #IMPLIED
- graphical %boolean; #IMPLIED
- currenttime %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT java (arg | jvmarg | classpath | sysproperty | env)*>
-<!ATTLIST java
- id ID #IMPLIED
- jvmargs CDATA #IMPLIED
- args CDATA #IMPLIED
- fork %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- jar CDATA #IMPLIED
- output CDATA #IMPLIED
- timeout CDATA #IMPLIED
- jvm CDATA #IMPLIED
- classpath CDATA #IMPLIED
- dir CDATA #IMPLIED
- description CDATA #IMPLIED
- jvmversion CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED
- classname CDATA #IMPLIED>
-
-<!ELEMENT renameext (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST renameext
- id ID #IMPLIED
- toextension CDATA #IMPLIED
- replace %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- fromextension CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT vsslabel EMPTY>
-<!ATTLIST vsslabel
- id ID #IMPLIED
- ssdir CDATA #IMPLIED
- autoresponse CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- comment CDATA #IMPLIED
- version CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- login CDATA #IMPLIED
- label CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT basename EMPTY>
-<!ATTLIST basename
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- file CDATA #IMPLIED
- description CDATA #IMPLIED
- property CDATA #IMPLIED
- suffix CDATA #IMPLIED>
-
-<!ELEMENT javadoc2 (bottom | source | classpath | doctitle | header | excludepackage | bootclasspath | doclet | taglet | fileset | packageset | sourcepath | link | footer | package | group | tag)*>
-<!ATTLIST javadoc2
- id ID #IMPLIED
- bottom CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- bootclasspathref IDREF #IMPLIED
- header CDATA #IMPLIED
- link CDATA #IMPLIED
- noindex %boolean; #IMPLIED
- access (protected | public | package | private) #IMPLIED
- doclet CDATA #IMPLIED
- public %boolean; #IMPLIED
- author %boolean; #IMPLIED
- footer CDATA #IMPLIED
- docletpath CDATA #IMPLIED
- package %boolean; #IMPLIED
- useexternalfile %boolean; #IMPLIED
- sourcepathref IDREF #IMPLIED
- description CDATA #IMPLIED
- protected %boolean; #IMPLIED
- nonavbar %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- group CDATA #IMPLIED
- source CDATA #IMPLIED
- linkoffline CDATA #IMPLIED
- additionalparam CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- locale CDATA #IMPLIED
- destdir CDATA #IMPLIED
- classpath CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- bootclasspath CDATA #IMPLIED
- private %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- charset CDATA #IMPLIED
- nodeprecatedlist %boolean; #IMPLIED
- classpathref IDREF #IMPLIED
- stylesheetfile CDATA #IMPLIED
- docencoding CDATA #IMPLIED
- excludepackagenames CDATA #IMPLIED
- docletpathref IDREF #IMPLIED
- packagenames CDATA #IMPLIED
- windowtitle CDATA #IMPLIED
- notree %boolean; #IMPLIED
- splitindex %boolean; #IMPLIED
- packagelist CDATA #IMPLIED
- encoding CDATA #IMPLIED
- doctitle CDATA #IMPLIED
- serialwarn %boolean; #IMPLIED
- old %boolean; #IMPLIED
- use %boolean; #IMPLIED
- sourcepath CDATA #IMPLIED
- helpfile CDATA #IMPLIED
- version %boolean; #IMPLIED
- sourcefiles CDATA #IMPLIED
- extdirs CDATA #IMPLIED
- nohelp %boolean; #IMPLIED
- nodeprecated %boolean; #IMPLIED
- overview CDATA #IMPLIED>
-
-<!ELEMENT vsscp EMPTY>
-<!ATTLIST vsscp
- id ID #IMPLIED
- login CDATA #IMPLIED
- taskname CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- description CDATA #IMPLIED
- autoresponse CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- ssdir CDATA #IMPLIED>
-
-<!ELEMENT tar (patternset | exclude | include | tarfileset | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST tar
- id ID #IMPLIED
- tarfile CDATA #IMPLIED
- destfile CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- basedir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- compression (none | gzip | bzip2) #IMPLIED
- longfile (warn | fail | truncate | gnu | omit) #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT tarfileset (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST tarfileset
- id ID #IMPLIED
- refid IDREF #IMPLIED
- dir CDATA #IMPLIED
- username CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- mode CDATA #IMPLIED
- prefix CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- preserveleadingslashes %boolean; #IMPLIED
- group CDATA #IMPLIED
- fullpath CDATA #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT vajimport (fileset)*>
-<!ATTLIST vajimport
- id ID #IMPLIED
- importsources %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- importclasses %boolean; #IMPLIED
- description CDATA #IMPLIED
- remote CDATA #IMPLIED
- importresources %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- project CDATA #IMPLIED>
-
-<!ELEMENT setproxy EMPTY>
-<!ATTLIST setproxy
- id ID #IMPLIED
- socksproxyport CDATA #IMPLIED
- proxyport CDATA #IMPLIED
- taskname CDATA #IMPLIED
- socksproxyhost CDATA #IMPLIED
- proxyhost CDATA #IMPLIED
- description CDATA #IMPLIED
- nonproxyhosts CDATA #IMPLIED>
-
-<!ELEMENT wlstop (classpath)*>
-<!ATTLIST wlstop
- id ID #IMPLIED
- user CDATA #IMPLIED
- classpath CDATA #IMPLIED
- delay CDATA #IMPLIED
- password CDATA #IMPLIED
- url CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- beahome CDATA #IMPLIED>
-
-<!ELEMENT p4counter EMPTY>
-<!ATTLIST p4counter
- id ID #IMPLIED
- name CDATA #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- value CDATA #IMPLIED
- property CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT ilasm (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST ilasm
- id ID #IMPLIED
- owner CDATA #IMPLIED
- excludes CDATA #IMPLIED
- extraoptions CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- targettype CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- verbose %boolean; #IMPLIED
- debug %boolean; #IMPLIED
- includes CDATA #IMPLIED
- outputfile CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- resourcefile CDATA #IMPLIED
- taskname CDATA #IMPLIED
- srcdir CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- listing %boolean; #IMPLIED
- keyfile CDATA #IMPLIED>
-
-<!ELEMENT soscheckout EMPTY>
-<!ATTLIST soscheckout
- id ID #IMPLIED
- password CDATA #IMPLIED
- comment CDATA #IMPLIED
- nocompress %boolean; #IMPLIED
- version CDATA #IMPLIED
- username CDATA #IMPLIED
- sosserverpath CDATA #IMPLIED
- label CDATA #IMPLIED
- vssserverpath CDATA #IMPLIED
- soscmd CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- localpath CDATA #IMPLIED
- nocache %boolean; #IMPLIED
- projectpath CDATA #IMPLIED
- description CDATA #IMPLIED
- taskname CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- file CDATA #IMPLIED
- soshome CDATA #IMPLIED>
-
-<!ELEMENT apply (arg | fileset | env | targetfile | srcfile | mapper)*>
-<!ATTLIST apply
- id ID #IMPLIED
- resultproperty CDATA #IMPLIED
- skipemptyfilesets %boolean; #IMPLIED
- type (file | dir | both) #IMPLIED
- failifexecutionfails %boolean; #IMPLIED
- command CDATA #IMPLIED
- executable CDATA #IMPLIED
- os CDATA #IMPLIED
- output CDATA #IMPLIED
- timeout CDATA #IMPLIED
- dest CDATA #IMPLIED
- dir CDATA #IMPLIED
- description CDATA #IMPLIED
- outputproperty CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED
- vmlauncher %boolean; #IMPLIED
- relative %boolean; #IMPLIED
- parallel %boolean; #IMPLIED>
-
-<!ELEMENT ccuncheckout EMPTY>
-<!ATTLIST ccuncheckout
- id ID #IMPLIED
- keepcopy %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- cleartooldir CDATA #IMPLIED
- viewpath CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT jarlib-resolve (ant | location | url | extension)*>
-<!ATTLIST jarlib-resolve
- id ID #IMPLIED
- checkextension %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- property CDATA #IMPLIED
- failonerror %boolean; #IMPLIED>
-
-<!ELEMENT location EMPTY>
-<!ATTLIST location
- id ID #IMPLIED
- location CDATA #IMPLIED>
-
-<!ELEMENT url EMPTY>
-<!ATTLIST url
- id ID #IMPLIED
- destdir CDATA #IMPLIED
- url CDATA #IMPLIED
- destfile CDATA #IMPLIED>
-
-<!ELEMENT cvstagdiff EMPTY>
-<!ATTLIST cvstagdiff
- id ID #IMPLIED
- passfile CDATA #IMPLIED
- enddate CDATA #IMPLIED
- port CDATA #IMPLIED
- destfile CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- endtag CDATA #IMPLIED
- compressionlevel CDATA #IMPLIED
- cvsrsh CDATA #IMPLIED
- cvsroot CDATA #IMPLIED
- taskname CDATA #IMPLIED
- startdate CDATA #IMPLIED
- starttag CDATA #IMPLIED
- package CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- compression %boolean; #IMPLIED>
-
-<!ELEMENT jlink (patternset | exclude | include | custom | none | present | not | or | contains | depend | mergefiles | size | majority | filename | selector | includesfile | date | excludesfile | addfiles | depth | and)*>
-<!ATTLIST jlink
- id ID #IMPLIED
- outfile CDATA #IMPLIED
- compress %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- addfiles CDATA #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- description CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- mergefiles CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
-<!ELEMENT mergefiles (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST mergefiles
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT addfiles (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST addfiles
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT javacc EMPTY>
-<!ATTLIST javacc
- id ID #IMPLIED
- debugparser %boolean; #IMPLIED
- javacchome CDATA #IMPLIED
- forcelacheck %boolean; #IMPLIED
- commontokenaction %boolean; #IMPLIED
- optimizetokenmanager %boolean; #IMPLIED
- buildtokenmanager %boolean; #IMPLIED
- sanitycheck %boolean; #IMPLIED
- buildparser %boolean; #IMPLIED
- otherambiguitycheck CDATA #IMPLIED
- lookahead CDATA #IMPLIED
- debuglookahead %boolean; #IMPLIED
- choiceambiguitycheck CDATA #IMPLIED
- unicodeinput %boolean; #IMPLIED
- usercharstream %boolean; #IMPLIED
- debugtokenmanager %boolean; #IMPLIED
- description CDATA #IMPLIED
- taskname CDATA #IMPLIED
- outputdirectory CDATA #IMPLIED
- cachetokens %boolean; #IMPLIED
- javaunicodeescape %boolean; #IMPLIED
- static %boolean; #IMPLIED
- usertokenmanager %boolean; #IMPLIED
- target CDATA #IMPLIED
- ignorecase %boolean; #IMPLIED
- errorreporting %boolean; #IMPLIED>
-
-<!ELEMENT jarlib-manifest (options | attribute | depends | extension)*>
-<!ATTLIST jarlib-manifest
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- destfile CDATA #IMPLIED>
-
-<!ELEMENT options (fileset | libfileset | extension)*>
-<!ATTLIST options
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT depends (fileset | libfileset | extension)*>
-<!ATTLIST depends
- id ID #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT pvcs (pvcsproject)*>
-<!ATTLIST pvcs
- id ID #IMPLIED
- updateonly %boolean; #IMPLIED
- force CDATA #IMPLIED
- pvcsbin CDATA #IMPLIED
- workspace CDATA #IMPLIED
- pvcsproject CDATA #IMPLIED
- filenameformat CDATA #IMPLIED
- userid CDATA #IMPLIED
- repository CDATA #IMPLIED
- ignorereturncode %boolean; #IMPLIED
- linestart CDATA #IMPLIED
- promotiongroup CDATA #IMPLIED
- taskname CDATA #IMPLIED
- label CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT pvcsproject EMPTY>
-<!ATTLIST pvcsproject
- id ID #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT chmod (mapper | include | exclude | srcfile | targetfile | patternset | env | fileset | arg)*>
-<!ATTLIST chmod
- id ID #IMPLIED
- resultproperty CDATA #IMPLIED
- perm CDATA #IMPLIED
- skipemptyfilesets %boolean; #IMPLIED
- excludes CDATA #IMPLIED
- command CDATA #IMPLIED
- type (file | dir | both) #IMPLIED
- failifexecutionfails %boolean; #IMPLIED
- executable CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- os CDATA #IMPLIED
- output CDATA #IMPLIED
- timeout CDATA #IMPLIED
- dest CDATA #IMPLIED
- dir CDATA #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- outputproperty CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- append %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- newenvironment %boolean; #IMPLIED
- vmlauncher %boolean; #IMPLIED
- file CDATA #IMPLIED
- relative %boolean; #IMPLIED
- parallel %boolean; #IMPLIED>
-
-<!ELEMENT jar (patternset | exclude | include | custom | none | present | manifest | not | metainf | or | contains | depend | fileset | size | majority | filename | selector | includesfile | zipgroupfileset | zipfileset | date | excludesfile | depth | and)*>
-<!ATTLIST jar
- id ID #IMPLIED
- whenempty (fail | skip | create) #IMPLIED
- duplicate (add | preserve | fail) #IMPLIED
- excludes CDATA #IMPLIED
- manifest CDATA #IMPLIED
- basedir CDATA #IMPLIED
- encoding CDATA #IMPLIED
- jarfile CDATA #IMPLIED
- index %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- update %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- destfile CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- includes CDATA #IMPLIED
- description CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- compress %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- filesonly %boolean; #IMPLIED
- file CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- zipfile CDATA #IMPLIED>
-
-<!ELEMENT sound (fail | success)*>
-<!ATTLIST sound
- id ID #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT fail EMPTY>
-<!ATTLIST fail
- id ID #IMPLIED
- loops CDATA #IMPLIED
- source CDATA #IMPLIED
- duration CDATA #IMPLIED>
-
-<!ELEMENT success EMPTY>
-<!ATTLIST success
- id ID #IMPLIED
- loops CDATA #IMPLIED
- source CDATA #IMPLIED
- duration CDATA #IMPLIED>
-
-<!ELEMENT mparse (jvmarg | classpath | sourcepath)*>
-<!ATTLIST mparse
- id ID #IMPLIED
- cleanup %boolean; #IMPLIED
- verbose %boolean; #IMPLIED
- maxmemory CDATA #IMPLIED
- metamatahome CDATA #IMPLIED
- target CDATA #IMPLIED
- debugparser %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- debugscanner %boolean; #IMPLIED>
-
-<!ELEMENT blgenclient (classpath)*>
-<!ATTLIST blgenclient
- id ID #IMPLIED
- debug %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- mode CDATA #IMPLIED
- ejbjar CDATA #IMPLIED
- version CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- clientjar CDATA #IMPLIED>
-
-<!ELEMENT genkey (dname)*>
-<!ATTLIST genkey
- id ID #IMPLIED
- storepass CDATA #IMPLIED
- sigalg CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- keypass CDATA #IMPLIED
- dname CDATA #IMPLIED
- keysize CDATA #IMPLIED
- alias CDATA #IMPLIED
- keyalg CDATA #IMPLIED
- validity CDATA #IMPLIED
- keystore CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- storetype CDATA #IMPLIED>
-
-<!ELEMENT dname (param)*>
-<!ATTLIST dname
- id ID #IMPLIED>
-
-<!ELEMENT javah (classpath | class | bootclasspath)*>
-<!ATTLIST javah
- id ID #IMPLIED
- stubs %boolean; #IMPLIED
- force %boolean; #IMPLIED
- destdir CDATA #IMPLIED
- old %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- outputfile CDATA #IMPLIED
- class CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- bootclasspath CDATA #IMPLIED
- bootclasspathref IDREF #IMPLIED
- classpathref IDREF #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT class EMPTY>
-<!ATTLIST class
- id ID #IMPLIED
- name CDATA #IMPLIED>
-
-<!ELEMENT ccmreconfigure EMPTY>
-<!ATTLIST ccmreconfigure
- id ID #IMPLIED
- verbose %boolean; #IMPLIED
- ccmaction CDATA #IMPLIED
- ccmproject CDATA #IMPLIED
- taskname CDATA #IMPLIED
- recurse %boolean; #IMPLIED
- description CDATA #IMPLIED
- ccmdir CDATA #IMPLIED>
-
-<!ELEMENT unzip (fileset | patternset)*>
-<!ATTLIST unzip
- id ID #IMPLIED
- overwrite %boolean; #IMPLIED
- dest CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED
- src CDATA #IMPLIED>
-
-<!ELEMENT javac (patternset | exclude | include | custom | none | present | extdirs | not | src | or | contains | depend | classpath | sourcepath | size | majority | bootclasspath | filename | selector | includesfile | compilerarg | date | excludesfile | depth | and)*>
-<!ATTLIST javac
- id ID #IMPLIED
- target CDATA #IMPLIED
- excludes CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- bootclasspathref IDREF #IMPLIED
- compiler CDATA #IMPLIED
- executable CDATA #IMPLIED
- debuglevel CDATA #IMPLIED
- memoryinitialsize CDATA #IMPLIED
- deprecation %boolean; #IMPLIED
- includeantruntime %boolean; #IMPLIED
- depend %boolean; #IMPLIED
- sourcepathref IDREF #IMPLIED
- description CDATA #IMPLIED
- includes CDATA #IMPLIED
- source CDATA #IMPLIED
- includejavaruntime %boolean; #IMPLIED
- failonerror %boolean; #IMPLIED
- destdir CDATA #IMPLIED
- debug %boolean; #IMPLIED
- classpath CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- bootclasspath CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- nowarn %boolean; #IMPLIED
- proceed %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- classpathref IDREF #IMPLIED
- fork %boolean; #IMPLIED
- srcdir CDATA #IMPLIED
- memorymaximumsize CDATA #IMPLIED
- optimize %boolean; #IMPLIED
- encoding CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- sourcepath CDATA #IMPLIED
- listfiles %boolean; #IMPLIED
- extdirs CDATA #IMPLIED>
-
-<!ELEMENT src (fileset | dirset | filelist | pathelement | path)*>
-<!ATTLIST src
- id ID #IMPLIED
- location CDATA #IMPLIED
- refid IDREF #IMPLIED
- description CDATA #IMPLIED
- path CDATA #IMPLIED>
-
-<!ELEMENT p4add (fileset)*>
-<!ATTLIST p4add
- id ID #IMPLIED
- port CDATA #IMPLIED
- client CDATA #IMPLIED
- user CDATA #IMPLIED
- changelist CDATA #IMPLIED
- cmdopts CDATA #IMPLIED
- view CDATA #IMPLIED
- taskname CDATA #IMPLIED
- failonerror %boolean; #IMPLIED
- description CDATA #IMPLIED
- commandlength CDATA #IMPLIED>
-
-<!ELEMENT soslabel EMPTY>
-<!ATTLIST soslabel
- id ID #IMPLIED
- password CDATA #IMPLIED
- comment CDATA #IMPLIED
- nocompress %boolean; #IMPLIED
- version CDATA #IMPLIED
- username CDATA #IMPLIED
- sosserverpath CDATA #IMPLIED
- label CDATA #IMPLIED
- vssserverpath CDATA #IMPLIED
- soscmd CDATA #IMPLIED
- verbose %boolean; #IMPLIED
- localpath CDATA #IMPLIED
- nocache %boolean; #IMPLIED
- projectpath CDATA #IMPLIED
- description CDATA #IMPLIED
- taskname CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- file CDATA #IMPLIED
- soshome CDATA #IMPLIED>
-
-<!ELEMENT jpcoverage (arg | socket | fileset | jvmarg | classpath | triggers | filters)*>
-<!ATTLIST jpcoverage
- id ID #IMPLIED
- applet %boolean; #IMPLIED
- recordfromstart (coverage | none | all) #IMPLIED
- vm (java2 | jdk118 | jdk117) #IMPLIED
- classname CDATA #IMPLIED
- workingdir CDATA #IMPLIED
- inputfile CDATA #IMPLIED
- snapshotdir CDATA #IMPLIED
- seedname CDATA #IMPLIED
- javaexe CDATA #IMPLIED
- exitprompt CDATA #IMPLIED
- home CDATA #IMPLIED
- taskname CDATA #IMPLIED
- warnlevel CDATA #IMPLIED
- finalsnapshot CDATA #IMPLIED
- description CDATA #IMPLIED
- tracknatives %boolean; #IMPLIED>
-
-<!ELEMENT triggers (method)*>
-<!ATTLIST triggers
- id ID #IMPLIED>
-
-<!ELEMENT method EMPTY>
-<!ATTLIST method
- id ID #IMPLIED
- name CDATA #IMPLIED
- event CDATA #IMPLIED
- action CDATA #IMPLIED
- param CDATA #IMPLIED>
-
-<!ELEMENT vssget EMPTY>
-<!ATTLIST vssget
- id ID #IMPLIED
- date CDATA #IMPLIED
- recursive %boolean; #IMPLIED
- ssdir CDATA #IMPLIED
- quiet %boolean; #IMPLIED
- autoresponse CDATA #IMPLIED
- vsspath CDATA #IMPLIED
- version CDATA #IMPLIED
- serverpath CDATA #IMPLIED
- writable %boolean; #IMPLIED
- login CDATA #IMPLIED
- label CDATA #IMPLIED
- taskname CDATA #IMPLIED
- localpath CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT deltree EMPTY>
-<!ATTLIST deltree
- id ID #IMPLIED
- dir CDATA #IMPLIED
- taskname CDATA #IMPLIED
- description CDATA #IMPLIED>
-
-<!ELEMENT ddcreator (patternset | exclude | include | custom | none | present | not | or | contains | depend | size | majority | filename | selector | includesfile | date | excludesfile | depth | and)*>
-<!ATTLIST ddcreator
- id ID #IMPLIED
- classpath CDATA #IMPLIED
- defaultexcludes %boolean; #IMPLIED
- followsymlinks %boolean; #IMPLIED
- taskname CDATA #IMPLIED
- casesensitive %boolean; #IMPLIED
- dest CDATA #IMPLIED
- description CDATA #IMPLIED
- descriptors CDATA #IMPLIED
- excludes CDATA #IMPLIED
- includesfile CDATA #IMPLIED
- excludesfile CDATA #IMPLIED
- includes CDATA #IMPLIED>
-
diff --git a/org.eclipse.ui.externaltools/Ant Editor/anttasks_1.5b.xml b/org.eclipse.ui.externaltools/Ant Editor/anttasks_1.5b.xml deleted file mode 100644 index 28c372d2b..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/anttasks_1.5b.xml +++ /dev/null @@ -1,24428 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<tasks> - - <task name="ant" category="control" classname="org.apache.tools.ant.taskdefs.Ant"> - - - <short-description>Build a sub-project.</short-description> - - <description> - Build a sub-project. - - <pre> - &lt;target name=&quot;foo&quot; depends=&quot;init&quot;&gt; - &lt;ant antfile=&quot;build.xml&quot; target=&quot;bar&quot; &gt; - &lt;property name=&quot;property1&quot; value=&quot;aaaaa&quot; /&gt; - &lt;property name=&quot;foo&quot; value=&quot;baz&quot; /&gt; - &lt;/ant&gt;</SPAN> - &lt;/target&gt;</SPAN> - - &lt;target name=&quot;bar&quot; depends=&quot;init&quot;&gt; - &lt;echo message=&quot;prop is ${property1} ${foo}&quot; /&gt; - &lt;/target&gt; - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="antfile" type="java.lang.String" briefType="String" required="no"> - - <short-description>The buildfile to use.</short-description> - - <description> - The buildfile to use. - Defaults to "build.xml". This file is expected to be a filename relative - to the dir attribute given. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory to use as a base directory for the new Ant project.</short-description> - - <description> - The directory to use as a base directory for the new Ant project. - Defaults to the current project's basedir, unless inheritall - has been set to false, in which case it doesn't have a default - value. This will override the basedir setting of the called project. - </description> - - </attribute> - - <attribute name="inheritall" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, pass all properties to the new Ant project.</short-description> - - <description> - If true, pass all properties to the new Ant project. - Defaults to true. - </description> - - </attribute> - - <attribute name="inheritrefs" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, pass all references to the new Ant project.</short-description> - - <description> - If true, pass all references to the new Ant project. - Defaults to false. - </description> - - </attribute> - - <attribute name="output" type="java.lang.String" briefType="String" required="no"> - - <short-description>Filename to write the output to.</short-description> - - <description> - Filename to write the output to. - This is relative to the value of the dir attribute - if it has been set or to the base directory of the - current project otherwise. - </description> - - </attribute> - - <attribute name="target" type="java.lang.String" briefType="String" required="no"> - - <short-description>The target of the new Ant project to execute.</short-description> - - <description> - The target of the new Ant project to execute. - Defaults to the new project's default target. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="reference" type="org.apache.tools.ant.taskdefs.Ant.Reference" briefType="" required="NOTDEFINED"> - - <short-description>Reference element identifying a data type to carry - over to the new project.</short-description> - - <description> - Reference element identifying a data type to carry - over to the new project. - </description> - - </element> - - - <element name="property" type="org.apache.tools.ant.taskdefs.Property" briefType="see <property>" required="NOTDEFINED"> - - <short-description>Property to pass to the new project.</short-description> - - <description> - Property to pass to the new project. - The property is passed as a 'user property' - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="antcall" category="control" classname="org.apache.tools.ant.taskdefs.CallTarget"> - - - <short-description>Call another target in the same project.</short-description> - - <description> - Call another target in the same project. - - <pre> - &lt;target name="foo"&gt; - &lt;antcall target="bar"&gt; - &lt;param name="property1" value="aaaaa" /&gt; - &lt;param name="foo" value="baz" /&gt; - &lt;/antcall&gt; - &lt;/target&gt; - - &lt;target name="bar" depends="init"&gt; - &lt;echo message="prop is ${property1} ${foo}" /&gt; - &lt;/target&gt; - </pre> - - <p>This only works as expected if neither property1 nor foo are - defined in the project itself. - </description> - - - <structure> - - - <attributes> - - <attribute name="inheritall" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, pass all properties to the new Ant project.</short-description> - - <description> - If true, pass all properties to the new Ant project. - Defaults to true. - </description> - - </attribute> - - <attribute name="inheritrefs" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, pass all references to the new Ant project.</short-description> - - <description> - If true, pass all references to the new Ant project. - Defaults to false - </description> - - </attribute> - - <attribute name="target" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Target to execute, required.</short-description> - - <description> - Target to execute, required. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="reference" type="org.apache.tools.ant.taskdefs.Ant.Reference" briefType="" required="NOTDEFINED"> - - <short-description>Reference element identifying a data type to carry - over to the invoked target.</short-description> - - <description> - Reference element identifying a data type to carry - over to the invoked target. - </description> - - </element> - - - <element name="param" type="org.apache.tools.ant.taskdefs.Property" briefType="see <property>" required="NOTDEFINED"> - - <short-description>Property to pass to the invoked target.</short-description> - - <description> - Property to pass to the invoked target. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="antlr" category="other" classname="org.apache.tools.ant.taskdefs.optional.ANTLR"> - - - <short-description>Invokes the ANTLR Translator generator on a grammar file.</short-description> - - <description> - Invokes the ANTLR Translator generator on a grammar file. - </description> - - - <structure> - - - <attributes> - - <attribute name="debug" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to enable ParseView debugging.</short-description> - - <description> - Sets a flag to enable ParseView debugging - </description> - - </attribute> - - <attribute name="diagnostic" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to emit diagnostic text.</short-description> - - <description> - Sets a flag to emit diagnostic text - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The working directory of the process.</short-description> - - <description> - The working directory of the process - </description> - - </attribute> - - <attribute name="glib" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets an optional super grammar file.</short-description> - - <description> - Sets an optional super grammar file. - </description> - - </attribute> - - <attribute name="html" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, emit html.</short-description> - - <description> - If true, emit html - </description> - - </attribute> - - <attribute name="outputdirectory" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory to write the generated files to.</short-description> - - <description> - The directory to write the generated files to. - </description> - - </attribute> - - <attribute name="target" type="java.io.File" briefType="File" required="yes"> - - <short-description>The grammar file to process.</short-description> - - <description> - The grammar file to process. - </description> - - </attribute> - - <attribute name="trace" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, enables all tracing.</short-description> - - <description> - If true, enables all tracing. - </description> - - </attribute> - - <attribute name="tracelexer" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, enables lexer tracing.</short-description> - - <description> - If true, enables lexer tracing. - </description> - - </attribute> - - <attribute name="traceparser" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, enables parser tracing.</short-description> - - <description> - If true, enables parser tracing. - </description> - - </attribute> - - <attribute name="tracetreewalker" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to allow the user to enable tree walker tracing.</short-description> - - <description> - Sets a flag to allow the user to enable tree walker tracing - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a classpath to be set - because a directory might be given for Antlr debug.</short-description> - - <description> - Adds a classpath to be set - because a directory might be given for Antlr debug. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a new JVM argument.</short-description> - - <description> - Adds a new JVM argument. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="antstructure" category="xml" classname="org.apache.tools.ant.taskdefs.AntStructure"> - - - <short-description>Creates a partial DTD for Ant from the currently known tasks.</short-description> - - <description> - Creates a partial DTD for Ant from the currently known tasks. - </description> - - - <structure> - - - <attributes> - - <attribute name="output" type="java.io.File" briefType="File" required="yes"> - - <short-description>The output file.</short-description> - - <description> - The output file. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="apply" category="control" classname="org.apache.tools.ant.taskdefs.ExecuteOn"> - - - <short-description>Executes a given command, supplying a set of files as arguments.</short-description> - - <description> - Executes a given command, supplying a set of files as arguments. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether output should be appended to or overwrite an existing file.</short-description> - - <description> - Whether output should be appended to or overwrite an existing file. - Defaults to false. - </description> - - </attribute> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes, if you specify a nested mapper"> - - <short-description>The directory where target files are to be placed.</short-description> - - <description> - The directory where target files are to be placed. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The working directory of the process.</short-description> - - <description> - The working directory of the process. - </description> - - </attribute> - - <attribute name="executable" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The command to execute.</short-description> - - <description> - The command to execute. - </description> - - </attribute> - - <attribute name="failifexecutionfails" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Stop the build if program cannot be started.</short-description> - - <description> - Stop the build if program cannot be started. Defaults to true. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Fail if the command exits with a non-zero return code.</short-description> - - <description> - Fail if the command exits with a non-zero return code. - </description> - - </attribute> - - <attribute name="newenvironment" type="boolean" briefType="boolean" required="no, default is false"> - - <short-description>Do not propagate old environment when new environment variables are specified.</short-description> - - <description> - Do not propagate old environment when new environment variables are specified. - </description> - - </attribute> - - <attribute name="os" type="java.lang.String" briefType="String" required="no"> - - <short-description>List of operating systems on which the command may be executed.</short-description> - - <description> - List of operating systems on which the command may be executed. - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="no"> - - <short-description>File the output of the process is redirected to.</short-description> - - <description> - File the output of the process is redirected to. - </description> - - </attribute> - - <attribute name="outputproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>Property name whose value should be set to the output of - the process.</short-description> - - <description> - Property name whose value should be set to the output of - the process. - </description> - - </attribute> - - <attribute name="parallel" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, run the command only once, appending all files as arguments.</short-description> - - <description> - If true, run the command only once, appending all files as arguments. - If false, command will be executed once for every file. Defaults to false. - </description> - - </attribute> - - <attribute name="relative" type="boolean" briefType="boolean" required="no, default is false"> - - <short-description>Whether the filenames should be passed on the command line as - absolute or relative pathnames.</short-description> - - <description> - Whether the filenames should be passed on the command line as - absolute or relative pathnames. Paths are relative to the base - directory of the corresponding fileset for source files or the - dest attribute for target files. - </description> - - </attribute> - - <attribute name="resultproperty" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of a property in which the return code of the - command should be stored.</short-description> - - <description> - The name of a property in which the return code of the - command should be stored. Only of interest if failonerror=false. - </description> - - </attribute> - - <attribute name="skipemptyfilesets" type="boolean" briefType="boolean" required="no, default is false"> - - <short-description>If no source files have been found or are newer than their - corresponding target files, do not run the command.</short-description> - - <description> - If no source files have been found or are newer than their - corresponding target files, do not run the command. - </description> - - </attribute> - - <attribute name="type" type="org.apache.tools.ant.taskdefs.ExecuteOn.FileDirBoth" briefType=""file", "dir", "both"" required="no, default is file"> - - <short-description>Whether the command works only on files, directories or both?.</short-description> - - <description> - Whether the command works only on files, directories or both? - </description> - - </attribute> - - <attribute name="vmlauncher" type="boolean" briefType="boolean" required="no, default is true"> - - <short-description>If true, launch new process with VM, otherwise use the OS's shell.</short-description> - - <description> - If true, launch new process with VM, otherwise use the OS's shell. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Add an environment variable to the launched process.</short-description> - - <description> - Add an environment variable to the launched process. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Source files to operate upon.</short-description> - - <description> - Source files to operate upon. - </description> - - </element> - - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a command-line argument.</short-description> - - <description> - Adds a command-line argument. - </description> - - </element> - - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" briefType="Mapper" required="NOTDEFINED"> - - <short-description>Mapper to use for mapping source files to target files.</short-description> - - <description> - Mapper to use for mapping source files to target files. - </description> - - </element> - - - <element name="srcfile" type="org.apache.tools.ant.types.Commandline.Marker" briefType="" required="NOTDEFINED"> - - <short-description>Marker that indicates where the name of the source file should - be put on the command line.</short-description> - - <description> - Marker that indicates where the name of the source file should - be put on the command line. - </description> - - </element> - - - <element name="targetfile" type="org.apache.tools.ant.types.Commandline.Marker" briefType="" required="NOTDEFINED"> - - <short-description>Marker that indicates where the name of the target file should - be put on the command line.</short-description> - - <description> - Marker that indicates where the name of the target file should - be put on the command line. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="available" category="control" classname="org.apache.tools.ant.taskdefs.Available"> - - - <short-description>Will set the given property if the requested resource is available at runtime.</short-description> - - <description> - Will set the given property if the requested resource is available at - runtime. This task may also be used as a condition by the condition task. - </description> - - - <structure> - - - <attributes> - - <attribute name="classname" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Classname of a class which must be available to set the given - property.</short-description> - - <description> - Set a classname of a class which must be available to set the given - property. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used when searching for classes and resources.</short-description> - - <description> - Set the classpath to be used when searching for classes and resources. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Classpath by reference.</short-description> - - <description> - Set the classpath by reference. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required=""> - - <short-description>File which must be present in the file system to set the given - property.</short-description> - - <description> - Set the file which must be present in the file system to set the given - property. - </description> - - </attribute> - - <attribute name="filepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Path to use when looking for a file.</short-description> - - <description> - Set the path to use when looking for a file. - </description> - - </attribute> - - <attribute name="ignoresystemclasses" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether the search for classes should ignore the runtime classes and - just use the given classpath.</short-description> - - <description> - Set whether the search for classes should ignore the runtime classes and - just use the given classpath. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Name of the property which will be set if the particular resource - is available.</short-description> - - <description> - Set the name of the property which will be set if the particular resource - is available. - </description> - - </attribute> - - <attribute name="resource" type="java.lang.String" briefType="String" required=""> - - <short-description>Name of a Java resource which is required to set the property.</short-description> - - <description> - Set the name of a Java resource which is required to set the property. - </description> - - </attribute> - - <attribute name="type" type="org.apache.tools.ant.taskdefs.Available.FileDir" briefType=""file", "dir"" required="no"> - - <short-description>Set what type of file is required - either directory or file.</short-description> - - <description> - Set what type of file is required - either directory or file. - </description> - - </attribute> - - <attribute name="value" type="java.lang.String" briefType="String" required="no"> - - <short-description>Value to be given to the property if the desired resource is - available.</short-description> - - <description> - Set the value to be given to the property if the desired resource is - available. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to be used when searching for classes and resources.</short-description> - - <description> - Classpath to be used when searching for classes and resources. - </description> - - </element> - - - <element name="filepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Path to search for file resources.</short-description> - - <description> - Path to search for file resources. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="basename" category="property" classname="org.apache.tools.ant.taskdefs.Basename"> - - - <short-description>Sets a property to the base name of a specified file, optionally minus a suffix.</short-description> - - <description> - Sets a property to the base name of a specified file, optionally minus a - suffix. - - This task can accept the following attributes: - <ul> - <li>file - <li>property - <li>suffix - </ul> - The <b>file</b> and <b>property</b> attributes are required. The - <b>suffix</b> attribute can be specified either with or without - the &quot;.&quot;, and the result will be the same (ie., the - returned file name will be minus the .suffix). - <p> - When this task executes, it will set the specified property to the - value of the last element in the specified file. If file is a - directory, the basename will be the last directory element. If file - is a full-path filename, the basename will be the simple file name. - If a suffix is specified, and the specified file ends in that suffix, - the basename will be the simple file name without the suffix. - </description> - - - <structure> - - - <attributes> - - <attribute name="file" type="java.io.File" briefType="File" required="yes"> - - <short-description>File or directory to get base name from.</short-description> - - <description> - File or directory to get base name from. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Property to set base name to.</short-description> - - <description> - Property to set base name to. - </description> - - </attribute> - - <attribute name="suffix" type="java.lang.String" briefType="String" required="no"> - - <short-description>Optional suffix to remove from base name.</short-description> - - <description> - Optional suffix to remove from base name. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="blgenclient" category="ejb" classname="org.apache.tools.ant.taskdefs.optional.ejb.BorlandGenerateClient"> - - - <short-description>Generates a Borland Application Server 4.5 client JAR using as input the EJB JAR file.</short-description> - - <description> - Generates a Borland Application Server 4.5 client JAR using as - input the EJB JAR file. - - Two mode are available: java mode (default) and fork mode. With the fork mode, - it is impossible to add classpath to the commmand line. - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Path to use for classpath.</short-description> - - <description> - Path to use for classpath. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Reference to existing path, to use as a classpath.</short-description> - - <description> - Reference to existing path, to use as a classpath. - </description> - - </attribute> - - <attribute name="clientjar" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Client JAR file name.</short-description> - - <description> - Client JAR file name. - </description> - - </attribute> - - <attribute name="debug" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, turn on the debug mode for each of the Borland tools launched.</short-description> - - <description> - If true, turn on the debug mode for each of the Borland tools launched. - </description> - - </attribute> - - <attribute name="ejbjar" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>EJB JAR file.</short-description> - - <description> - EJB JAR file. - </description> - - </attribute> - - <attribute name="mode" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Command launching mode: java or fork.</short-description> - - <description> - Command launching mode: java or fork. - </description> - - </attribute> - - <attribute name="version" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds path to the classpath.</short-description> - - <description> - Adds path to the classpath. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="buildnumber" category="other" classname="org.apache.tools.ant.taskdefs.BuildNumber"> - - - <short-description>Read, increment, and write a build number in a file It will first attempt to read a build number from a file, then set the property "build.number" to the value that was read in (or 0 if no such value).</short-description> - - <description> - Read, increment, and write a build number in a file - It will first - attempt to read a build number from a file, then set the property - "build.number" to the value that was read in (or 0 if no such value). Then - it will increment the build number by one and write it back out into the - file. - </description> - - - <structure> - - - <attributes> - - <attribute name="file" type="java.io.File" briefType="File" required="no; defaults to "build.number""> - - <short-description>The file in which the build number is stored.</short-description> - - <description> - The file in which the build number is stored. Defaults to - "build.number" if not specified. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="bunzip2" category="packaging" classname="org.apache.tools.ant.taskdefs.BUnzip2"> - - - <short-description>Expands a file that has been compressed with the BZIP2 algorithm.</short-description> - - <description> - Expands a file that has been compressed with the BZIP2 - algorithm. Normally used to compress non-compressed archives such - as TAR files. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The destination file or directory; optional.</short-description> - - <description> - The destination file or directory; optional. - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The file to expand; required.</short-description> - - <description> - The file to expand; required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="bzip2" category="packaging" classname="org.apache.tools.ant.taskdefs.BZip2"> - - - <short-description>Compresses a file with the BZIP2 algorithm.</short-description> - - <description> - Compresses a file with the BZIP2 algorithm. Normally used to compress - non-compressed archives such as TAR files. - </description> - - - <structure> - - - <attributes> - - <attribute name="src" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The file to compress; required.</short-description> - - <description> - the file to compress; required. - </description> - - </attribute> - - <attribute name="zipfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The required destination file.</short-description> - - <description> - the required destination file. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="cab" category="other" classname="org.apache.tools.ant.taskdefs.optional.Cab" matchingTask="true"> - - - <short-description>Create a CAB archive.</short-description> - - <description> - Create a CAB archive. - </description> - - - <structure> - - - <attributes> - - <attribute name="basedir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Base directory to look in for files to CAB.</short-description> - - <description> - Base directory to look in for files to CAB. - </description> - - </attribute> - - <attribute name="cabfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The name/location of where to create the .cab file.</short-description> - - <description> - The name/location of where to create the .cab file. - </description> - - </attribute> - - <attribute name="compress" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, compress the files otherwise only store them.</short-description> - - <description> - If true, compress the files otherwise only store them. - </description> - - </attribute> - - <attribute name="options" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets additional cabarc options that are not supported directly.</short-description> - - <description> - Sets additional cabarc options that are not supported directly. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, display cabarc output.</short-description> - - <description> - If true, display cabarc output. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files to archive.</short-description> - - <description> - Adds a set of files to archive. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="cccheckin" category="other" classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCCheckin"> - - - <short-description>Performs ClearCase checkin.</short-description> - - <description> - Performs ClearCase checkin. - - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>comment</td> - <td>Specify a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - <tr> - <td>commentfile</td> - <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - <tr> - <td>nowarn</td> - <td>Suppress warning messages</td> - <td>No</td> - <tr> - <tr> - <td>preservetime</td> - <td>Preserve the modification time</td> - <td>No</td> - <tr> - <tr> - <td>keepcopy</td> - <td>Keeps a copy of the file with a .keep extension</td> - <td>No</td> - <tr> - <tr> - <td>identical</td> - <td>Allows the file to be checked in even if it is identical to the original</td> - <td>No</td> - <tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="cleartooldir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the cleartool executable is located.</short-description> - - <description> - Set the directory where the cleartool executable is located. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment string.</short-description> - - <description> - Sets the comment string. - </description> - - </attribute> - - <attribute name="commentfile" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies a file containing a comment.</short-description> - - <description> - Specifies a file containing a comment. - </description> - - </attribute> - - <attribute name="identical" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, allows the file to be checked in even - if it is identical to the original.</short-description> - - <description> - If true, allows the file to be checked in even - if it is identical to the original. - </description> - - </attribute> - - <attribute name="keepcopy" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, keeps a copy of the file with a .keep extension.</short-description> - - <description> - If true, keeps a copy of the file with a .keep extension. - </description> - - </attribute> - - <attribute name="nowarn" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, suppress warning messages.</short-description> - - <description> - If true, suppress warning messages. - </description> - - </attribute> - - <attribute name="preservetime" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, preserve the modification time.</short-description> - - <description> - If true, preserve the modification time. - </description> - - </attribute> - - <attribute name="viewpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the item in a ClearCase view to operate on.</short-description> - - <description> - Set the path to the item in a ClearCase view to operate on. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="cccheckout" category="other" classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCCheckout"> - - - <short-description>Performs ClearCase checkout.</short-description> - - <description> - Performs ClearCase checkout. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>reserved</td> - <td>Specifies whether to check out the file as reserved or not</td> - <td>Yes</td> - <tr> - <tr> - <td>out</td> - <td>Creates a writable file under a different filename</td> - <td>No</td> - <tr> - <tr> - <td>nodata</td> - <td>Checks out the file but does not create an editable file containing its data</td> - <td>No</td> - <tr> - <tr> - <td>branch</td> - <td>Specify a branch to check out the file to</td> - <td>No</td> - <tr> - <tr> - <td>version</td> - <td>Allows checkout of a version other than main latest</td> - <td>No</td> - <tr> - <tr> - <td>nowarn</td> - <td>Suppress warning messages</td> - <td>No</td> - <tr> - <tr> - <td>comment</td> - <td>Specify a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - <tr> - <td>commentfile</td> - <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td> - <td>No</td> - <tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="branch" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specify a branch to check out the file to.</short-description> - - <description> - Specify a branch to check out the file to. - </description> - - </attribute> - - <attribute name="cleartooldir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the cleartool executable is located.</short-description> - - <description> - Set the directory where the cleartool executable is located. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment string.</short-description> - - <description> - Sets the comment string. - </description> - - </attribute> - - <attribute name="commentfile" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies a file containing a comment.</short-description> - - <description> - Specifies a file containing a comment. - </description> - - </attribute> - - <attribute name="nodata" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, checks out the file but does not create an - editable file containing its data.</short-description> - - <description> - If true, checks out the file but does not create an - editable file containing its data. - </description> - - </attribute> - - <attribute name="nowarn" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, warning messages are suppressed.</short-description> - - <description> - If true, warning messages are suppressed. - </description> - - </attribute> - - <attribute name="out" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Creates a writable file under a different filename.</short-description> - - <description> - Creates a writable file under a different filename. - </description> - - </attribute> - - <attribute name="reserved" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, checks out the file as reserved.</short-description> - - <description> - If true, checks out the file as reserved. - </description> - - </attribute> - - <attribute name="version" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, allows checkout of a version other than main latest.</short-description> - - <description> - If true, allows checkout of a version other than main latest. - </description> - - </attribute> - - <attribute name="viewpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the item in a ClearCase view to operate on.</short-description> - - <description> - Set the path to the item in a ClearCase view to operate on. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccmcheckin" category="other" classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCheckin"> - - - <short-description>Performs Continuus checkin command.</short-description> - - <description> - Performs Continuus checkin command. - </description> - - - <structure> - - - <attributes> - - <attribute name="ccmdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the ccm executable is located.</short-description> - - <description> - Set the directory where the ccm executable is located. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies a comment.</short-description> - - <description> - Specifies a comment. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Path to the file that the command will operate on.</short-description> - - <description> - Sets the path to the file that the command will operate on. - </description> - - </attribute> - - <attribute name="task" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the task number used to check - in the file (may use 'default').</short-description> - - <description> - Specifies the task number used to check - in the file (may use 'default'). - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccmcheckintask" category="scm" classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCheckinDefault"> - - - <short-description>Performs Continuus Checkin Default task command.</short-description> - - <description> - Performs Continuus Checkin Default task command. - </description> - - - <structure> - - - <attributes> - - <attribute name="ccmdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the ccm executable is located.</short-description> - - <description> - Set the directory where the ccm executable is located. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies a comment.</short-description> - - <description> - Specifies a comment. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Path to the file that the command will operate on.</short-description> - - <description> - Sets the path to the file that the command will operate on. - </description> - - </attribute> - - <attribute name="task" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the task number used to check - in the file (may use 'default').</short-description> - - <description> - Specifies the task number used to check - in the file (may use 'default'). - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccmcheckout" category="other" classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCheckout"> - - - <short-description>Performs Continuus checkout command.</short-description> - - <description> - Performs Continuus checkout command. - </description> - - - <structure> - - - <attributes> - - <attribute name="ccmdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the ccm executable is located.</short-description> - - <description> - Set the directory where the ccm executable is located. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies a comment.</short-description> - - <description> - Specifies a comment. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Path to the file that the command will operate on.</short-description> - - <description> - Sets the path to the file that the command will operate on. - </description> - - </attribute> - - <attribute name="task" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the task number used to check - in the file (may use 'default').</short-description> - - <description> - Specifies the task number used to check - in the file (may use 'default'). - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccmcreatetask" category="scm" classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMCreateTask"> - - - <short-description>Creates new Continuus ccm task and sets it as the default.</short-description> - - <description> - Creates new Continuus ccm task and sets it as the default. - </description> - - - <structure> - - - <attributes> - - <attribute name="ccmdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the ccm executable is located.</short-description> - - <description> - Set the directory where the ccm executable is located. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies a comment.</short-description> - - <description> - Specifies a comment. - </description> - - </attribute> - - <attribute name="platform" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the target platform.</short-description> - - <description> - Specifies the target platform. - </description> - - </attribute> - - <attribute name="release" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specify the CCM release.</short-description> - - <description> - Specify the CCM release. - </description> - - </attribute> - - <attribute name="resolver" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the resolver.</short-description> - - <description> - Specifies the resolver. - </description> - - </attribute> - - <attribute name="subsystem" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the subsystem.</short-description> - - <description> - Specifies the subsystem. - </description> - - </attribute> - - <attribute name="task" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Specifies the task number used to checkin - the file (may use 'default').</short-description> - - <description> - Specifies the task number used to checkin - the file (may use 'default'). - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccmreconfigure" category="other" classname="org.apache.tools.ant.taskdefs.optional.ccm.CCMReconfigure"> - - - <short-description>Task allows to reconfigure a project, recurcively or not</short-description> - - <description> - Task allows to reconfigure a project, recurcively or not - </description> - - - <structure> - - - <attributes> - - <attribute name="ccmdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the ccm executable is located.</short-description> - - <description> - Set the directory where the ccm executable is located. - </description> - - </attribute> - - <attribute name="ccmproject" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Ccm project on which the operation is applied.</short-description> - - <description> - Sets the ccm project on which the operation is applied. - </description> - - </attribute> - - <attribute name="recurse" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, recurse on subproject (default false).</short-description> - - <description> - If true, recurse on subproject (default false). - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, do a verbose reconfigure operation (default false).</short-description> - - <description> - If true, do a verbose reconfigure operation (default false). - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccuncheckout" category="other" classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCUnCheckout"> - - - <short-description>Performs ClearCase UnCheckout command.</short-description> - - <description> - Performs ClearCase UnCheckout command. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>keepcopy</td> - <td>Specifies whether to keep a copy of the file with a .keep extension or not</td> - <td>No</td> - <tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="cleartooldir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the cleartool executable is located.</short-description> - - <description> - Set the directory where the cleartool executable is located. - </description> - - </attribute> - - <attribute name="keepcopy" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, keep a copy of the file with a .keep extension.</short-description> - - <description> - If true, keep a copy of the file with a .keep extension. - </description> - - </attribute> - - <attribute name="viewpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the item in a ClearCase view to operate on.</short-description> - - <description> - Set the path to the item in a ClearCase view to operate on. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ccupdate" category="other" classname="org.apache.tools.ant.taskdefs.optional.clearcase.CCUpdate"> - - - <short-description>Performs a ClearCase Update command.</short-description> - - <description> - Performs a ClearCase Update command. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>viewpath</td> - <td>Path to the ClearCase view file or directory that the command will operate on</td> - <td>No</td> - <tr> - <tr> - <td>graphical</td> - <td>Displays a graphical dialog during the update</td> - <td>No</td> - <tr> - <tr> - <td>log</td> - <td>Specifies a log file for ClearCase to write to</td> - <td>No</td> - <tr> - <tr> - <td>overwrite</td> - <td>Specifies whether to overwrite hijacked files or not</td> - <td>No</td> - <tr> - <tr> - <td>rename</td> - <td>Specifies that hijacked files should be renamed with a .keep extension</td> - <td>No</td> - <tr> - <tr> - <td>currenttime</td> - <td>Specifies that modification time should be written as the current time. Either currenttime or preservetime can be specified.</td> - <td>No</td> - <tr> - <tr> - <td>preservetime</td> - <td>Specifies that modification time should preserved from the VOB time. Either currenttime or preservetime can be specified.</td> - <td>No</td> - <tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="cleartooldir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where the cleartool executable is located.</short-description> - - <description> - Set the directory where the cleartool executable is located. - </description> - - </attribute> - - <attribute name="currenttime" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, modification time should be written as the current time.</short-description> - - <description> - If true, modification time should be written as the current time. - Either currenttime or preservetime can be specified. - </description> - - </attribute> - - <attribute name="graphical" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, displays a graphical dialog during the update.</short-description> - - <description> - If true, displays a graphical dialog during the update. - </description> - - </attribute> - - <attribute name="log" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Log file where cleartool records - the status of the command.</short-description> - - <description> - Sets the log file where cleartool records - the status of the command. - </description> - - </attribute> - - <attribute name="overwrite" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, overwrite hijacked files.</short-description> - - <description> - If true, overwrite hijacked files. - </description> - - </attribute> - - <attribute name="preservetime" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, modification time should be preserved from the VOB time.</short-description> - - <description> - If true, modification time should be preserved from the VOB time. - Either currenttime or preservetime can be specified. - </description> - - </attribute> - - <attribute name="rename" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, hijacked files are renamed with a .keep extension.</short-description> - - <description> - If true, hijacked files are renamed with a .keep extension. - </description> - - </attribute> - - <attribute name="viewpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the item in a ClearCase view to operate on.</short-description> - - <description> - Set the path to the item in a ClearCase view to operate on. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="checksum" category="control" classname="org.apache.tools.ant.taskdefs.Checksum" matchingTask="true"> - - - <short-description>Used to create or verify file checksums.</short-description> - - <description> - Used to create or verify file checksums. - </description> - - - <structure> - - - <attributes> - - <attribute name="algorithm" type="java.lang.String" briefType="String" required="no"> - - <short-description>Specifies the algorithm to be used to compute the checksum.</short-description> - - <description> - Specifies the algorithm to be used to compute the checksum. - Defaults to "MD5". Other popular algorithms like "SHA" may be used as well. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="one of either file or at least one nested fileset element."> - - <short-description>File for which the checksum is to be calculated.</short-description> - - <description> - Sets the file for which the checksum is to be calculated. - </description> - - </attribute> - - <attribute name="fileext" type="java.lang.String" briefType="String" required="no"> - - <short-description>File extension that is be to used to - create or identify destination file.</short-description> - - <description> - Sets the file extension that is be to used to - create or identify destination file. - </description> - - </attribute> - - <attribute name="forceoverwrite" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether or not to overwrite existing file irrespective of - whether it is newer than - the source file.</short-description> - - <description> - Whether or not to overwrite existing file irrespective of - whether it is newer than - the source file. Defaults to false. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="no"> - - <short-description>Property to hold the generated checksum.</short-description> - - <description> - Sets the property to hold the generated checksum. - </description> - - </attribute> - - <attribute name="provider" type="java.lang.String" briefType="String" required="no"> - - <short-description>MessageDigest algorithm provider to be used - to calculate the checksum.</short-description> - - <description> - Sets the MessageDigest algorithm provider to be used - to calculate the checksum. - </description> - - </attribute> - - <attribute name="readbuffersize" type="int" briefType="int" required="no"> - - <short-description>The size of the read buffer to use.</short-description> - - <description> - The size of the read buffer to use. - </description> - - </attribute> - - <attribute name="verifyproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>Verify property.</short-description> - - <description> - Sets the verify property. This project property holds - the result of a checksum verification - "true" or "false" - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Files to generate checksums for.</short-description> - - <description> - Files to generate checksums for. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="chmod" category="filesystem" classname="org.apache.tools.ant.taskdefs.Chmod"> - - - <short-description>Chmod equivalent for unix-like environments.</short-description> - - <description> - Chmod equivalent for unix-like environments. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether output should be appended to or overwrite an existing file.</short-description> - - <description> - Whether output should be appended to or overwrite an existing file. - Defaults to false. - </description> - - </attribute> - - <attribute name="defaultexcludes" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether default exclusions should be used or not.</short-description> - - <description> - Sets whether default exclusions should be used or not. - </description> - - </attribute> - - <attribute name="dest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The directory where target files are to be placed.</short-description> - - <description> - The directory where target files are to be placed. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required=""> - - <short-description>The directory which holds the files whose permissions must be changed.</short-description> - - <description> - The directory which holds the files whose permissions must be changed. - </description> - - </attribute> - - <attribute name="excludes" type="java.lang.String" briefType="String" required="no"> - - <short-description>Set of exclude patterns.</short-description> - - <description> - Sets the set of exclude patterns. Patterns may be separated by a comma - or a space. - </description> - - </attribute> - - <attribute name="executable" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The command to execute.</short-description> - - <description> - The command to execute. - </description> - - </attribute> - - <attribute name="failifexecutionfails" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Stop the build if program cannot be started.</short-description> - - <description> - Stop the build if program cannot be started. Defaults to true. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Fail if the command exits with a non-zero return code.</short-description> - - <description> - Fail if the command exits with a non-zero return code. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="exactly one of the two or nested <fileset> elements."> - - <short-description>The file or single directory of which the permissions must be changed.</short-description> - - <description> - The file or single directory of which the permissions must be changed. - </description> - - </attribute> - - <attribute name="includes" type="java.lang.String" briefType="String" required="no"> - - <short-description>Set of include patterns.</short-description> - - <description> - Sets the set of include patterns. Patterns may be separated by a comma - or a space. - </description> - - </attribute> - - <attribute name="newenvironment" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Do not propagate old environment when new environment variables are specified.</short-description> - - <description> - Do not propagate old environment when new environment variables are specified. - </description> - - </attribute> - - <attribute name="os" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>List of operating systems on which the command may be executed.</short-description> - - <description> - List of operating systems on which the command may be executed. - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>File the output of the process is redirected to.</short-description> - - <description> - File the output of the process is redirected to. - </description> - - </attribute> - - <attribute name="outputproperty" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Property name whose value should be set to the output of - the process.</short-description> - - <description> - Property name whose value should be set to the output of - the process. - </description> - - </attribute> - - <attribute name="parallel" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, run the command only once, appending all files as arguments.</short-description> - - <description> - If true, run the command only once, appending all files as arguments. - If false, command will be executed once for every file. Defaults to false. - </description> - - </attribute> - - <attribute name="perm" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The new permissions.</short-description> - - <description> - The new permissions. - </description> - - </attribute> - - <attribute name="relative" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether the filenames should be passed on the command line as - absolute or relative pathnames.</short-description> - - <description> - Whether the filenames should be passed on the command line as - absolute or relative pathnames. Paths are relative to the base - directory of the corresponding fileset for source files or the - dest attribute for target files. - </description> - - </attribute> - - <attribute name="resultproperty" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of a property in which the return code of the - command should be stored.</short-description> - - <description> - The name of a property in which the return code of the - command should be stored. Only of interest if failonerror=false. - </description> - - </attribute> - - <attribute name="skipemptyfilesets" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If no source files have been found or are newer than their - corresponding target files, do not run the command.</short-description> - - <description> - If no source files have been found or are newer than their - corresponding target files, do not run the command. - </description> - - </attribute> - - <attribute name="type" type="org.apache.tools.ant.taskdefs.ExecuteOn.FileDirBoth" briefType=""file", "dir", "both"" required="no, default is file"> - - <short-description>Whether the command works only on files, directories or both?.</short-description> - - <description> - Whether the command works only on files, directories or both? - </description> - - </attribute> - - <attribute name="vmlauncher" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, launch new process with VM, otherwise use the OS's shell.</short-description> - - <description> - If true, launch new process with VM, otherwise use the OS's shell. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Add an environment variable to the launched process.</short-description> - - <description> - Add an environment variable to the launched process. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Source files to operate upon.</short-description> - - <description> - Source files to operate upon. - </description> - - </element> - - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a command-line argument.</short-description> - - <description> - Adds a command-line argument. - </description> - - </element> - - - <element name="exclude" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the exclude list.</short-description> - - <description> - Add a name entry on the exclude list. - </description> - - </element> - - - <element name="include" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the include list.</short-description> - - <description> - Add a name entry on the include list. - </description> - - </element> - - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" briefType="Mapper" required="NOTDEFINED"> - - <short-description>Mapper to use for mapping source files to target files.</short-description> - - <description> - Mapper to use for mapping source files to target files. - </description> - - </element> - - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" briefType="Patternset" required="NOTDEFINED"> - - <short-description>Add a set of patterns.</short-description> - - <description> - Add a set of patterns. - </description> - - </element> - - - <element name="srcfile" type="org.apache.tools.ant.types.Commandline.Marker" briefType="" required="NOTDEFINED"> - - <short-description>Marker that indicates where the name of the source file should - be put on the command line.</short-description> - - <description> - Marker that indicates where the name of the source file should - be put on the command line. - </description> - - </element> - - - <element name="targetfile" type="org.apache.tools.ant.types.Commandline.Marker" briefType="" required="NOTDEFINED"> - - <short-description>Marker that indicates where the name of the target file should - be put on the command line.</short-description> - - <description> - Marker that indicates where the name of the target file should - be put on the command line. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="concat" category="other" classname="org.apache.tools.ant.taskdefs.Concat"> - - - <short-description>This class contains the 'concat' task, used to concatenate a series of files into a single stream.</short-description> - - <description> - This class contains the 'concat' task, used to concatenate a series - of files into a single stream. The destination of this stream may - be the system console, or a file. The following is a sample - invocation: - - <pre> - &lt;concat destfile=&quot;${build.dir}/index.xml&quot; - append=&quot;false&quot;&gt; - - &lt;fileset dir=&quot;${xml.root.dir}&quot; - includes=&quot;*.xml&quot; /&gt; - - &lt;/concat&gt; - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="no"> - - <short-description>Behavior when the destination file exists.</short-description> - - <description> - Sets the behavior when the destination file exists. If set to - <code>true</code> the stream data will be appended to the - existing file, otherwise the existing file will be - overwritten. Defaults to <code>false</code>. - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="no "> - - <short-description>Destination file, or uses the console if not specified.</short-description> - - <description> - Sets the destination file, or uses the console if not specified. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding for the input files, used when displaying the - data via the console.</short-description> - - <description> - Sets the encoding for the input files, used when displaying the - data via the console. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="filelist" type="org.apache.tools.ant.types.FileList" briefType="Filelist" required="NOTDEFINED"> - - <short-description>List of files to concatenate.</short-description> - - <description> - List of files to concatenate. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Set of files to concatenate.</short-description> - - <description> - Set of files to concatenate. - </description> - - </element> - - - </elements> - - - <body> - - <description> - This method adds text which appears in the 'concat' element. - </description> - - </body> - - - </structure> - - - </task> - - - - <task name="condition" category="control" classname="org.apache.tools.ant.taskdefs.ConditionTask"> - - - <short-description>Task to set a property conditionally using &lt;uptodate&gt;, &lt;available&gt;, and many other supported conditions.</short-description> - - <description> - Task to set a property conditionally using &lt;uptodate&gt;, &lt;available&gt;, - and many other supported conditions. - - <p>This task supports boolean logic as well as pluggable conditions - to decide, whether a property should be set.</p> - - <p>This task does not extend Task to take advantage of - ConditionBase.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The name of the property to set.</short-description> - - <description> - The name of the property to set. Required. - </description> - - </attribute> - - <attribute name="value" type="java.lang.String" briefType="String" required="no"> - - <short-description>The value for the property to set, if condition evaluates to true.</short-description> - - <description> - The value for the property to set, if condition evaluates to true. - Defaults to "true". - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="and" type="org.apache.tools.ant.taskdefs.condition.And" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;and&gt; condition "container".</short-description> - - <description> - Add an &lt;and&gt; condition "container". - </description> - - </element> - - - <element name="available" type="org.apache.tools.ant.taskdefs.Available" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;available&gt; condition.</short-description> - - <description> - Add an &lt;available&gt; condition. - </description> - - </element> - - - <element name="checksum" type="org.apache.tools.ant.taskdefs.Checksum" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;checksum&gt; condition.</short-description> - - <description> - Add an &lt;checksum&gt; condition. - </description> - - </element> - - - <element name="contains" type="org.apache.tools.ant.taskdefs.condition.Contains" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;contains&gt; condition.</short-description> - - <description> - Add a &lt;contains&gt; condition. - </description> - - </element> - - - <element name="equals" type="org.apache.tools.ant.taskdefs.condition.Equals" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;equals&gt; condition.</short-description> - - <description> - Add an &lt;equals&gt; condition. - </description> - - </element> - - - <element name="filesmatch" type="org.apache.tools.ant.taskdefs.condition.FilesMatch" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;filesmatch&gt; condition.</short-description> - - <description> - Add a &lt;filesmatch&gt; condition. - </description> - - </element> - - - <element name="http" type="org.apache.tools.ant.taskdefs.condition.Http" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;http&gt; condition.</short-description> - - <description> - Add an &lt;http&gt; condition. - </description> - - </element> - - - <element name="isfalse" type="org.apache.tools.ant.taskdefs.condition.IsFalse" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;isfalse&gt; condition.</short-description> - - <description> - Add a &lt;isfalse&gt; condition. - </description> - - </element> - - - <element name="isset" type="org.apache.tools.ant.taskdefs.condition.IsSet" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;isset&gt; condition.</short-description> - - <description> - Add an &lt;isset&gt; condition. - </description> - - </element> - - - <element name="istrue" type="org.apache.tools.ant.taskdefs.condition.IsTrue" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;istrue&gt; condition.</short-description> - - <description> - Add a &lt;istrue&gt; condition. - </description> - - </element> - - - <element name="not" type="org.apache.tools.ant.taskdefs.condition.Not" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;not&gt; condition "container".</short-description> - - <description> - Add an &lt;not&gt; condition "container". - </description> - - </element> - - - <element name="or" type="org.apache.tools.ant.taskdefs.condition.Or" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;or&gt; condition "container".</short-description> - - <description> - Add an &lt;or&gt; condition "container". - </description> - - </element> - - - <element name="os" type="org.apache.tools.ant.taskdefs.condition.Os" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;os&gt; condition.</short-description> - - <description> - Add an &lt;os&gt; condition. - </description> - - </element> - - - <element name="socket" type="org.apache.tools.ant.taskdefs.condition.Socket" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;socket&gt; condition.</short-description> - - <description> - Add a &lt;socket&gt; condition. - </description> - - </element> - - - <element name="uptodate" type="org.apache.tools.ant.taskdefs.UpToDate" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;uptodate&gt; condition.</short-description> - - <description> - Add an &lt;uptodate&gt; condition. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="copy" category="filesystem" classname="org.apache.tools.ant.taskdefs.Copy"> - - - <short-description>Copies a file or directory to a new file or directory.</short-description> - - <description> - Copies a file or directory to a new file - or directory. Files are only copied if the source file is newer - than the destination file, or when the destination file does not - exist. It is possible to explicitly overwrite existing files.</p> - - <p>This implementation is based on Arnout Kuiper's initial design - document, the following mailing list discussions, and the - copyfile/copydir tasks.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Character encoding.</short-description> - - <description> - Sets the character encoding - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no; defaults to true."> - - <short-description>If false, note errors to the output but keep going.</short-description> - - <description> - If false, note errors to the output but keep going. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="yes, unless a nested <fileset> element is used."> - - <short-description>Single source file to copy.</short-description> - - <description> - Sets a single source file to copy. - </description> - - </attribute> - - <attribute name="filtering" type="boolean" briefType="boolean" required="no; defaults to false."> - - <short-description>If true, enables filtering.</short-description> - - <description> - If true, enables filtering. - </description> - - </attribute> - - <attribute name="flatten" type="boolean" briefType="boolean" required="no; defaults to false."> - - <short-description>When copying directory trees, the files can be "flattened" - into a single directory.</short-description> - - <description> - When copying directory trees, the files can be "flattened" - into a single directory. If there are multiple files with - the same name in the source directory tree, only the first - file will be copied into the "flattened" directory, unless - the forceoverwrite attribute is true. - </description> - - </attribute> - - <attribute name="includeemptydirs" type="boolean" briefType="boolean" required="no; defaults to true."> - - <short-description>Used to copy empty directories.</short-description> - - <description> - Used to copy empty directories. - </description> - - </attribute> - - <attribute name="overwrite" type="boolean" briefType="boolean" required="no; defaults to false."> - - <short-description>Overwrite any existing destination file(s).</short-description> - - <description> - Overwrite any existing destination file(s). - </description> - - </attribute> - - <attribute name="preservelastmodified" type="boolean" briefType="boolean" required="no; defaults to false."> - - <short-description>Give the copied files the same last modified time as the original files.</short-description> - - <description> - Give the copied files the same last modified time as the original files. - </description> - - </attribute> - - <attribute name="todir" type="java.io.File" briefType="File" required=""> - - <short-description>Destination directory.</short-description> - - <description> - Sets the destination directory. - </description> - - </attribute> - - <attribute name="tofile" type="java.io.File" briefType="File" required="with the file attribute, either tofile or todir can be used. with nested <fileset> elements, if the set of files is greater than 1, or if only the dir attribute is specified in the <fileset>, or if the file attribute is also specified, then only todir is allowed."> - - <short-description>Destination file.</short-description> - - <description> - Sets the destination file. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no; defaults to false."> - - <short-description>Used to force listing of all names of copied files.</short-description> - - <description> - Used to force listing of all names of copied files. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files to copy.</short-description> - - <description> - Adds a set of files to copy. - </description> - - </element> - - - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" briefType="FilterChain" required="NOTDEFINED"> - - <short-description>Adds a FilterChain.</short-description> - - <description> - Adds a FilterChain. - </description> - - </element> - - - <element name="filterset" type="org.apache.tools.ant.types.FilterSet" briefType="Filterset" required="NOTDEFINED"> - - <short-description>Adds a filterset.</short-description> - - <description> - Adds a filterset. - </description> - - </element> - - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" briefType="Mapper" required="NOTDEFINED"> - - <short-description>Defines the mapper to map source to destination files.</short-description> - - <description> - Defines the mapper to map source to destination files. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="copydir" category="other" classname="org.apache.tools.ant.taskdefs.Copydir" deprecated="true" matchingTask="true"> - - - <short-description>Copies a directory.</short-description> - - <description> - Copies a directory. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="filtering" type="boolean" briefType="boolean" required="no"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="flatten" type="boolean" briefType="boolean" required="no"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="forceoverwrite" type="boolean" briefType="boolean" required="no"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="yes"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="copyfile" category="other" classname="org.apache.tools.ant.taskdefs.Copyfile" deprecated="true"> - - - <short-description>Copies a file.</short-description> - - <description> - Copies a file. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="filtering" type="java.lang.String" briefType="String" required="no"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="forceoverwrite" type="boolean" briefType="boolean" required="no"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="yes"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="csc" category="dotnet" classname="org.apache.tools.ant.taskdefs.optional.dotnet.CSharp" matchingTask="true"> - - - <short-description>Compiles C# source into executables or modules.</short-description> - - <description> - Compiles C# source into executables or modules. - - The task will only work on win2K until other platforms support - csc.exe or an equivalent. CSC.exe must be on the execute path too. <p> - - All parameters are optional: &lt;csc/&gt; should suffice to produce a debug - build of all *.cs files. References to external files do require explicit - enumeration, so are one of the first attributes to consider adding. <p> - - The task is a directory based task, so attributes like <b>includes="*.cs" - </b> and <b>excludes="broken.cs"</b> can be used to control the files pulled - in. By default, all *.cs files from the project folder down are included in - the command. When this happens the output file -if not specified- is taken - as the first file in the list, which may be somewhat hard to control. - Specifying the output file with <b>'outfile'</b> seems prudent. <p> - - <p> - - TODO - <ol> - <li> is incremental build still broken in beta-1? - <li> is Win32Icon broken? - <li> all the missing options - </ol> - <p> - - History - <Table> - - <tr> - - <td> - 0.3 - </td> - - <td> - Beta 1 edition - </td> - - <td> - To avoid having to remember which assemblies to include, the task - automatically refers to the main dotnet libraries in Beta1. - </tr> - - <tr> - - <td> - 0.2 - </td> - - <td> - Slightly different - </td> - - <td> - Split command execution to a separate class; - </tr> - - <tr> - - <td> - 0.1 - </td> - - <td> - "I can't believe it's so rudimentary" - </td> - - <td> - First pass; minimal builds only support; - </tr> - - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="additionalmodules" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Semicolon separated list of modules to refer to.</short-description> - - <description> - Semicolon separated list of modules to refer to. - </description> - - </attribute> - - <attribute name="debug" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Debug flag on or off.</short-description> - - <description> - set the debug flag on or off. - </description> - - </attribute> - - <attribute name="definitions" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Semicolon separated list of defined constants.</short-description> - - <description> - Semicolon separated list of defined constants. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory of files to be compiled.</short-description> - - <description> - Set the destination directory of files to be compiled. - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Name of exe/library to create.</short-description> - - <description> - Set the name of exe/library to create. - </description> - - </attribute> - - <attribute name="docfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>File for generated XML documentation.</short-description> - - <description> - file for generated XML documentation - </description> - - </attribute> - - <attribute name="extraoptions" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Any extra options which are not explicitly supported - by this task.</short-description> - - <description> - Any extra options which are not explicitly supported - by this task. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, fail on compilation errors.</short-description> - - <description> - If true, fail on compilation errors. - </description> - - </attribute> - - <attribute name="filealign" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>File alignment.</short-description> - - <description> - Set the file alignment. - Valid values are 0,512, 1024, 2048, 4096, 8192, - and 16384, 0 means 'leave to the compiler' - </description> - - </attribute> - - <attribute name="fullpaths" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, print the full path of files on errors.</short-description> - - <description> - If true, print the full path of files on errors. - </description> - - </attribute> - - <attribute name="includedefaultreferences" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, automatically includes the common assemblies - in dotnet, and tells the compiler to link in mscore.dll. - - set the automatic reference inclusion flag on or off this flag controls - the string of references and the /nostdlib option in CSC.</short-description> - - <description> - If true, automatically includes the common assemblies - in dotnet, and tells the compiler to link in mscore.dll. - - set the automatic reference inclusion flag on or off this flag controls - the string of references and the /nostdlib option in CSC - </description> - - </attribute> - - <attribute name="incremental" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Incremental compilation flag on or off.</short-description> - - <description> - set the incremental compilation flag on or off. - </description> - - </attribute> - - <attribute name="mainclass" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name of main class for executables.</short-description> - - <description> - Sets the name of main class for executables. - </description> - - </attribute> - - <attribute name="noconfig" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>A flag that tells the compiler not to read in the compiler - settings files 'csc.rsp' in its bin directory and then the local directory.</short-description> - - <description> - A flag that tells the compiler not to read in the compiler - settings files 'csc.rsp' in its bin directory and then the local directory - </description> - - </attribute> - - <attribute name="optimize" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, enables optimization flag.</short-description> - - <description> - If true, enables optimization flag. - </description> - - </attribute> - - <attribute name="outputfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Output file.</short-description> - - <description> - Set the output file - </description> - - </attribute> - - <attribute name="referencefiles" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Path of references to include.</short-description> - - <description> - Path of references to include. - Wildcards should work. - </description> - - </attribute> - - <attribute name="references" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Semicolon separated list of DLLs to refer to.</short-description> - - <description> - Semicolon separated list of DLLs to refer to. - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Source directory of the files to be compiled.</short-description> - - <description> - Set the source directory of the files to be compiled. - </description> - - </attribute> - - <attribute name="targettype" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Type of target.</short-description> - - <description> - Set the type of target. - </description> - - </attribute> - - <attribute name="unsafe" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, enables the unsafe keyword.</short-description> - - <description> - If true, enables the unsafe keyword. - </description> - - </attribute> - - <attribute name="utf8output" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, require all compiler output to be in UTF8 format.</short-description> - - <description> - If true, require all compiler output to be in UTF8 format. - </description> - - </attribute> - - <attribute name="warnlevel" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>Level of warning currently between 1 and 4 - with 4 being the strictest.</short-description> - - <description> - Level of warning currently between 1 and 4 - with 4 being the strictest. - </description> - - </attribute> - - <attribute name="win32icon" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Filename of icon to include.</short-description> - - <description> - Set the filename of icon to include. - </description> - - </attribute> - - <attribute name="win32res" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Filename of a win32 resource (.RES) file to include.</short-description> - - <description> - Sets the filename of a win32 resource (.RES) file to include. - This is not a .NET resource, but what Windows is used to. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="cvs" category="scm" classname="org.apache.tools.ant.taskdefs.Cvs"> - - - <short-description>Performs operations on a CVS repository. original 1.20 NOTE: This implementation has been moved to AbstractCvsTask with the addition of some accessors for extensibility.</short-description> - - <description> - Performs operations on a CVS repository. - - original 1.20 - - NOTE: This implementation has been moved to AbstractCvsTask with - the addition of some accessors for extensibility. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="no, default to "false"."> - - <short-description>Whether to append output/error when redirecting to a file.</short-description> - - <description> - Whether to append output/error when redirecting to a file. - </description> - - </attribute> - - <attribute name="command" type="java.lang.String" briefType="String" required="no, default "checkout"."> - - <short-description>The CVS command to execute.</short-description> - - <description> - The CVS command to execute. - </description> - - </attribute> - - <attribute name="compression" type="boolean" briefType="boolean" required="no. defaults to false."> - - <short-description>If true, this is the same as compressionlevel="3".</short-description> - - <description> - If true, this is the same as compressionlevel="3". - </description> - - </attribute> - - <attribute name="compressionlevel" type="int" briefType="int" required="no. defaults to no compression."> - - <short-description>If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression.</short-description> - - <description> - If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression. - </description> - - </attribute> - - <attribute name="cvsroot" type="java.lang.String" briefType="String" required="no"> - - <short-description>The CVSROOT variable.</short-description> - - <description> - The CVSROOT variable. - </description> - - </attribute> - - <attribute name="cvsrsh" type="java.lang.String" briefType="String" required="no"> - - <short-description>The CVS_RSH variable.</short-description> - - <description> - The CVS_RSH variable. - </description> - - </attribute> - - <attribute name="date" type="java.lang.String" briefType="String" required="no"> - - <short-description>Use the most recent revision no later than the given date.</short-description> - - <description> - Use the most recent revision no later than the given date. - </description> - - </attribute> - - <attribute name="dest" type="java.io.File" briefType="File" required="no, default is project's basedir."> - - <short-description>The directory where the checked out files should be placed.</short-description> - - <description> - The directory where the checked out files should be placed. - </description> - - </attribute> - - <attribute name="error" type="java.io.File" briefType="File" required="no, default error to ant log as msg_warn."> - - <short-description>The file to direct standard error from the command.</short-description> - - <description> - The file to direct standard error from the command. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Stop the build process if the command exits with - a return code other than 0.</short-description> - - <description> - Stop the build process if the command exits with - a return code other than 0. - Defaults to false. - </description> - - </attribute> - - <attribute name="noexec" type="boolean" briefType="boolean" required="no, default to "false""> - - <short-description>If true, report only and don't change any files.</short-description> - - <description> - If true, report only and don't change any files. - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="no, default output to ant log as msg_info."> - - <short-description>The file to direct standard output from the command.</short-description> - - <description> - The file to direct standard output from the command. - </description> - - </attribute> - - <attribute name="package" type="java.lang.String" briefType="String" required="no"> - - <short-description>The package/module to operate upon.</short-description> - - <description> - The package/module to operate upon. - </description> - - </attribute> - - <attribute name="passfile" type="java.io.File" briefType="File" required="no, default file ~/.cvspass."> - - <short-description>Password file to read passwords from.</short-description> - - <description> - Password file to read passwords from. - </description> - - </attribute> - - <attribute name="port" type="int" briefType="int" required="no, default port 2401."> - - <short-description>Port used by CVS to communicate with the server.</short-description> - - <description> - Port used by CVS to communicate with the server. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="no, default "false""> - - <short-description>If true, suppress informational messages.</short-description> - - <description> - If true, suppress informational messages. - </description> - - </attribute> - - <attribute name="tag" type="java.lang.String" briefType="String" required="no"> - - <short-description>The tag of the package/module to operate upon.</short-description> - - <description> - The tag of the package/module to operate upon. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="commandline" type="org.apache.tools.ant.types.Commandline" briefType="" required="NOTDEFINED"> - - <short-description>Adds direct command-line to execute.</short-description> - - <description> - Adds direct command-line to execute. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="cvschangelog" category="other" classname="org.apache.tools.ant.taskdefs.cvslib.ChangeLogTask"> - - - <short-description>Examines the output of cvs log and group related changes together.</short-description> - - <description> - Examines the output of cvs log and group related changes together. - - It produces an XML output representing the list of changes. - <PRE> - <FONT color=#0000ff>&lt;!-- Root element --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> changelog <FONT color=#ff00ff>(entry</FONT><FONT color=#ff00ff>+</FONT><FONT color=#ff00ff>)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- CVS Entry --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> entry <FONT color=#ff00ff>(date,author,file</FONT><FONT color=#ff00ff>+</FONT><FONT color=#ff00ff>,msg)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- Date of cvs entry --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> date <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- Author of change --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> author <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- List of files affected --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> msg <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- File changed --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> file <FONT color=#ff00ff>(name,revision,prevrevision</FONT><FONT color=#ff00ff>?</FONT><FONT color=#ff00ff>)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- Name of the file --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> name <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- Revision number --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> revision <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>&gt;</FONT> - <FONT color=#0000ff>&lt;!-- Previous revision number --&gt;</FONT> - <FONT color=#6a5acd>&lt;!ELEMENT</FONT> prevrevision <FONT color=#ff00ff>(#PCDATA)</FONT><FONT color=#6a5acd>&gt;</FONT> - </PRE> - </description> - - - <structure> - - - <attributes> - - <attribute name="daysinpast" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>Number of days worth of log entries to process.</short-description> - - <description> - Set the number of days worth of log entries to process. - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Output file for the log.</short-description> - - <description> - Set the output file for the log. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Base dir for cvs.</short-description> - - <description> - Set the base dir for cvs. - </description> - - </attribute> - - <attribute name="end" type="java.util.Date" briefType="Date" required="NOTDEFINED"> - - <short-description>Date at which the changelog should stop.</short-description> - - <description> - Set the date at which the changelog should stop. - </description> - - </attribute> - - <attribute name="start" type="java.util.Date" briefType="Date" required="NOTDEFINED"> - - <short-description>Date at which the changelog should start.</short-description> - - <description> - Set the date at which the changelog should start. - </description> - - </attribute> - - <attribute name="usersfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Lookup list of user names & addresses.</short-description> - - <description> - Set a lookup list of user names & addresses - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files about which cvs logs will be generated.</short-description> - - <description> - Adds a set of files about which cvs logs will be generated. - </description> - - </element> - - - <element name="user" type="org.apache.tools.ant.taskdefs.cvslib.CvsUser" briefType="" required="NOTDEFINED"> - - <short-description>Add a user to list changelog knows about.</short-description> - - <description> - Add a user to list changelog knows about. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="cvspass" category="scm" classname="org.apache.tools.ant.taskdefs.CVSPass"> - - - <short-description>Adds an new entry to a CVS password file.</short-description> - - <description> - Adds an new entry to a CVS password file. - </description> - - - <structure> - - - <attributes> - - <attribute name="cvsroot" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The CVS repository to add an entry for.</short-description> - - <description> - The CVS repository to add an entry for. - </description> - - </attribute> - - <attribute name="passfile" type="java.io.File" briefType="File" required="no, default is ~/.cvspass."> - - <short-description>Password file to add the entry to.</short-description> - - <description> - Password file to add the entry to. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Password to be added to the password file.</short-description> - - <description> - Password to be added to the password file. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="cvstagdiff" category="other" classname="org.apache.tools.ant.taskdefs.cvslib.CvsTagDiff"> - - - <short-description>Examines the output of cvs rdiff between two tags.</short-description> - - <description> - Examines the output of cvs rdiff between two tags. - - It produces an XML output representing the list of changes. - <PRE> - &lt;!-- Root element --&gt; - &lt;!ELEMENT tagdiff ( entry+ ) &gt; - &lt;!-- Start tag of the report --&gt; - &lt;!ATTLIST tagdiff startTag NMTOKEN #IMPLIED &gt; - &lt;!-- End tag of the report --&gt; - &lt;!ATTLIST tagdiff endTag NMTOKEN #IMPLIED &gt; - &lt;!-- Start date of the report --&gt; - &lt;!ATTLIST tagdiff startDate NMTOKEN #IMPLIED &gt; - &lt;!-- End date of the report --&gt; - &lt;!ATTLIST tagdiff endDate NMTOKEN #IMPLIED &gt; - - &lt;!-- CVS tag entry --&gt; - &lt;!ELEMENT entry ( file ) &gt; - &lt;!-- File added, changed or removed --&gt; - &lt;!ELEMENT file ( name, revision?, prevrevision? ) &gt; - &lt;!-- Name of the file --&gt; - &lt;!ELEMENT name ( #PCDATA ) &gt; - &lt;!-- Revision number --&gt; - &lt;!ELEMENT revision ( #PCDATA ) &gt; - &lt;!-- Previous revision number --&gt; - &lt;!ELEMENT prevrevision ( #PCDATA ) &gt; - </PRE> - </description> - - - <structure> - - - <attributes> - - <attribute name="compression" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, this is the same as compressionlevel="3".</short-description> - - <description> - If true, this is the same as compressionlevel="3". - </description> - - </attribute> - - <attribute name="compressionlevel" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression.</short-description> - - <description> - If set to a value 1-9 it adds -zN to the cvs command line, else - it disables compression. - </description> - - </attribute> - - <attribute name="cvsroot" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The CVSROOT variable.</short-description> - - <description> - The CVSROOT variable. - </description> - - </attribute> - - <attribute name="cvsrsh" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The CVS_RSH variable.</short-description> - - <description> - The CVS_RSH variable. - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>Output file for the diff.</short-description> - - <description> - Set the output file for the diff. - </description> - - </attribute> - - <attribute name="enddate" type="java.lang.String" briefType="String" required=""> - - <short-description>End date.</short-description> - - <description> - Set the end date. - </description> - - </attribute> - - <attribute name="endtag" type="java.lang.String" briefType="String" required="exactly one of the two."> - - <short-description>End tag.</short-description> - - <description> - Set the end tag. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Stop the build process if the command exits with - a return code other than 0.</short-description> - - <description> - Stop the build process if the command exits with - a return code other than 0. - Defaults to false. - </description> - - </attribute> - - <attribute name="package" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The package/module to analyze.</short-description> - - <description> - The package/module to analyze. - </description> - - </attribute> - - <attribute name="passfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Password file to read passwords from.</short-description> - - <description> - Password file to read passwords from. - </description> - - </attribute> - - <attribute name="port" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>Port used by CVS to communicate with the server.</short-description> - - <description> - Port used by CVS to communicate with the server. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, suppress informational messages.</short-description> - - <description> - If true, suppress informational messages. - </description> - - </attribute> - - <attribute name="startdate" type="java.lang.String" briefType="String" required=""> - - <short-description>Start date.</short-description> - - <description> - Set the start date. - </description> - - </attribute> - - <attribute name="starttag" type="java.lang.String" briefType="String" required="exactly one of the two."> - - <short-description>Start tag.</short-description> - - <description> - Set the start tag. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ddcreator" category="other" classname="org.apache.tools.ant.taskdefs.optional.ejb.DDCreator" matchingTask="true"> - - - <short-description>Builds a serialized deployment descriptor given a text file description of the descriptor in the format supported by WebLogic.</short-description> - - <description> - Builds a serialized deployment descriptor given a text file description of the - descriptor in the format supported by WebLogic. - - This ant task is a front end for the weblogic DDCreator tool. - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="descriptors" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory from where the text descriptions of the deployment descriptors are - to be read.</short-description> - - <description> - Set the directory from where the text descriptions of the deployment descriptors are - to be read. - </description> - - </attribute> - - <attribute name="dest" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory into which the serialized deployment descriptors are to - be written.</short-description> - - <description> - Set the directory into which the serialized deployment descriptors are to - be written. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="delete" category="filesystem" classname="org.apache.tools.ant.taskdefs.Delete" matchingTask="true"> - - - <short-description>Deletes a file or directory, or set of files defined by a fileset.</short-description> - - <description> - Deletes a file or directory, or set of files defined by a fileset. - The original delete task would delete a file, or a set of files - using the include/exclude syntax. The deltree task would delete a - directory tree. This task combines the functionality of these two - originally distinct tasks. - <p>Currently Delete extends MatchingTask. This is intend <i>only</i> - to provide backwards compatibility for a release. The future position - is to use nested filesets exclusively.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="defaultexcludes" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether default exclusions should be used or not.</short-description> - - <description> - Sets whether default exclusions should be used or not. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required=""> - - <short-description>Directory from which files are to be deleted.</short-description> - - <description> - Set the directory from which files are to be deleted - </description> - - </attribute> - - <attribute name="excludes" type="java.lang.String" briefType="String" required="no"> - - <short-description>Set of exclude patterns.</short-description> - - <description> - Sets the set of exclude patterns. Patterns may be separated by a comma - or a space. - </description> - - </attribute> - - <attribute name="excludesfile" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of the file containing the includes patterns.</short-description> - - <description> - Sets the name of the file containing the includes patterns. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>If false, note errors but continue.</short-description> - - <description> - If false, note errors but continue. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="at least one of the two, unless a <fileset> is specified."> - - <short-description>Name of a single file to be removed.</short-description> - - <description> - Set the name of a single file to be removed. - </description> - - </attribute> - - <attribute name="includeemptydirs" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, delete empty directories.</short-description> - - <description> - If true, delete empty directories. - </description> - - </attribute> - - <attribute name="includes" type="java.lang.String" briefType="String" required="no"> - - <short-description>Set of include patterns.</short-description> - - <description> - Sets the set of include patterns. Patterns may be separated by a comma - or a space. - </description> - - </attribute> - - <attribute name="includesfile" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of the file containing the includes patterns.</short-description> - - <description> - Sets the name of the file containing the includes patterns. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="no"> - - <short-description>If true and the file does not exist, do not display a diagnostic - message or modify the exit status to reflect an error.</short-description> - - <description> - If true and the file does not exist, do not display a diagnostic - message or modify the exit status to reflect an error. - This means that if a file or directory cannot be deleted, - then no error is reported. This setting emulates the - -f option to the Unix &quot;rm&quot; command. - Default is false meaning things are &quot;noisy&quot; - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, list all names of deleted files.</short-description> - - <description> - If true, list all names of deleted files. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files to be deleted.</short-description> - - <description> - Adds a set of files to be deleted. - </description> - - </element> - - - <element name="exclude" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the exclude list.</short-description> - - <description> - add a name entry on the exclude list - </description> - - </element> - - - <element name="excludesfile" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the include files list.</short-description> - - <description> - add a name entry on the include files list - </description> - - </element> - - - <element name="include" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the include list.</short-description> - - <description> - add a name entry on the include list - </description> - - </element> - - - <element name="includesfile" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the include files list.</short-description> - - <description> - add a name entry on the include files list - </description> - - </element> - - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" briefType="Patternset" required="NOTDEFINED"> - - <short-description>Add a set of patterns.</short-description> - - <description> - add a set of patterns - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="deltree" category="other" classname="org.apache.tools.ant.taskdefs.Deltree" deprecated="true"> - - - <short-description>No Description.</short-description> - - <description> - - </description> - - - <structure> - - - <attributes> - - <attribute name="dir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Directory to be deleted.</short-description> - - <description> - Set the directory to be deleted - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="depend" category="other" classname="org.apache.tools.ant.taskdefs.optional.depend.Depend" matchingTask="true"> - - - <short-description>Generates a dependency file for a given set of classes.</short-description> - - <description> - Generates a dependency file for a given set of classes. - </description> - - - <structure> - - - <attributes> - - <attribute name="cache" type="java.io.File" briefType="File" required="no"> - - <short-description>Dependency cache file.</short-description> - - <description> - Sets the dependency cache file. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used for this dependency check.</short-description> - - <description> - Set the classpath to be used for this dependency check. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="closure" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, transitive dependencies are followed until the - closure of the dependency set if reached.</short-description> - - <description> - If true, transitive dependencies are followed until the - closure of the dependency set if reached. - When not set, the depend task will only follow - direct dependencies between classes. - </description> - - </attribute> - - <attribute name="destdir" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Destination directory where the compiled Java files exist.</short-description> - - <description> - Set the destination directory where the compiled Java files exist. - </description> - - </attribute> - - <attribute name="dump" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, the dependency information will be written - to the debug level log.</short-description> - - <description> - If true, the dependency information will be written - to the debug level log. - </description> - - </attribute> - - <attribute name="srcdir" type="org.apache.tools.ant.types.Path" briefType="Path" required="yes"> - - <short-description>Directories path to find the Java source files.</short-description> - - <description> - Set the directories path to find the Java source files. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a classpath to be used for this dependency check.</short-description> - - <description> - Adds a classpath to be used for this dependency check. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="dependset" category="filesystem" classname="org.apache.tools.ant.taskdefs.DependSet" matchingTask="true"> - - - <short-description>Examines and removes out of date target files.</short-description> - - <description> - Examines and removes out of date target files. If any of the target files - are out of date with respect to any of the source files, all target - files are removed. This is useful where dependencies cannot be - computed (for example, dynamically interpreted parameters or files - that need to stay in synch but are not directly linked) or where - the ant task in question could compute them but does not (for - example, the linked DTD for an XML file using the style task). - - nested arguments: - <ul> - <li>srcfileset (fileset describing the source files to examine) - <li>srcfilelist (filelist describing the source files to examine) - <li>targetfileset (fileset describing the target files to examine) - <li>targetfilelist (filelist describing the target files to examine) - </ul> - At least one instance of either a fileset or filelist for both source and - target are required. - <p> - This task will examine each of the source files against each of the target - files. If any target files are out of date with respect to any of the source - files, all targets are removed. If any files named in a (src or target) - filelist do not exist, all targets are removed. - Hint: If missing files should be ignored, specify them as include patterns - in filesets, rather than using filelists. - </p><p> - This task attempts to optimize speed of dependency checking. It will stop - after the first out of date file is found and remove all targets, rather - than exhaustively checking every source vs target combination unnecessarily. - </p><p> - Example uses: - <ul><li> - Record the fact that an XML file must be up to date - with respect to its XSD (Schema file), even though the XML file - itself includes no reference to its XSD. - </li><li> - Record the fact that an XSL stylesheet includes other - sub-stylesheets - </li><li> - Record the fact that java files must be recompiled if the ant build - file changes - </li></ul> - </description> - - - <structure> - - - <attributes> - </attributes> - - - <elements> - - <element name="srcfilelist" type="org.apache.tools.ant.types.FileList" briefType="Filelist" required="NOTDEFINED"> - - <short-description>Add a list of source files.</short-description> - - <description> - Add a list of source files. - </description> - - </element> - - - <element name="srcfileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a set of source files.</short-description> - - <description> - Add a set of source files. - </description> - - </element> - - - <element name="targetfilelist" type="org.apache.tools.ant.types.FileList" briefType="Filelist" required="NOTDEFINED"> - - <short-description>Add a list of target files.</short-description> - - <description> - Add a list of target files. - </description> - - </element> - - - <element name="targetfileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a set of target files.</short-description> - - <description> - Add a set of target files. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="dirname" category="property" classname="org.apache.tools.ant.taskdefs.Dirname"> - - - <short-description>Determines the directory name of the specified file.</short-description> - - <description> - Determines the directory name of the specified file. - - This task can accept the following attributes: - <ul> - <li>file - <li>property - </ul> - Both <b>file</b> and <b>property</b> are required. - <p> - When this task executes, it will set the specified property to the - value of the specified file up to, but not including, the last path - element. If file is a file, the directory will be the current - directory. - </description> - - - <structure> - - - <attributes> - - <attribute name="file" type="java.io.File" briefType="File" required="yes"> - - <short-description>Path to take the dirname of.</short-description> - - <description> - Path to take the dirname of. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The name of the property to set.</short-description> - - <description> - The name of the property to set. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ear" category="packaging" classname="org.apache.tools.ant.taskdefs.Ear" matchingTask="true"> - - - <short-description>Creates a EAR archive.</short-description> - - <description> - Creates a EAR archive. Based on WAR task - </description> - - - <structure> - - - <attributes> - - <attribute name="appxml" type="java.io.File" briefType="File" required="yes, unless update is set to true"> - - <short-description>File to incorporate as application.xml.</short-description> - - <description> - File to incorporate as application.xml. - </description> - - </attribute> - - <attribute name="basedir" type="java.io.File" briefType="File" required="no"> - - <short-description>Directory from which to archive files; optional.</short-description> - - <description> - Directory from which to archive files; optional. - </description> - - </attribute> - - <attribute name="compress" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether we want to compress the files or only store them; - optional, default=true;.</short-description> - - <description> - Whether we want to compress the files or only store them; - optional, default=true; - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The file to create; required.</short-description> - - <description> - The file to create; required. - </description> - - </attribute> - - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" briefType=""add", "preserve", "fail"" required="no"> - - <short-description>Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.</short-description> - - <description> - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding to use for filenames, defaults to the platform's - default encoding.</short-description> - - <description> - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - </description> - - </attribute> - - <attribute name="filesonly" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.</short-description> - - <description> - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - </description> - - </attribute> - - <attribute name="index" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Set whether or not to create an index list for classes.</short-description> - - <description> - Set whether or not to create an index list for classes. - This may speed up classloading in some cases. - </description> - - </attribute> - - <attribute name="manifest" type="java.io.File" briefType="File" required="no"> - - <short-description>The manifest file to use.</short-description> - - <description> - The manifest file to use. This can be either the location of a manifest, - or the name of a jar added through a fileset. If its the name of an added - jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.MF. - </description> - - </attribute> - - <attribute name="update" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.</short-description> - - <description> - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - </description> - - </attribute> - - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" briefType=""fail", "skip", "create"" required="NOTDEFINED"> - - <short-description>Sets behavior of the task when no files match.</short-description> - - <description> - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="archives" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds zipfileset.</short-description> - - <description> - Adds zipfileset. - </description> - - </element> - - - <element name="manifest" type="org.apache.tools.ant.taskdefs.Manifest" briefType="" required="NOTDEFINED"> - - <short-description>Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.</short-description> - - <description> - Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files.</short-description> - - <description> - Adds a set of files. - </description> - - </element> - - - <element name="metainf" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a zipfileset to include in the META-INF directory.</short-description> - - <description> - Adds a zipfileset to include in the META-INF directory. - </description> - - </element> - - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a group of zip files.</short-description> - - <description> - Adds a group of zip files. - </description> - - </element> - - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a set of files that can be - read from an archive and be given a prefix/fullpath.</short-description> - - <description> - Adds a set of files that can be - read from an archive and be given a prefix/fullpath. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="echo" category="utility" classname="org.apache.tools.ant.taskdefs.Echo"> - - - <short-description>Writes a message to the Ant logging facilities.</short-description> - - <description> - Writes a message to the Ant logging facilities. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="no - default is false."> - - <short-description>If true, append to existing file.</short-description> - - <description> - If true, append to existing file. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="no"> - - <short-description>File to write to.</short-description> - - <description> - File to write to. - </description> - - </attribute> - - <attribute name="level" type="org.apache.tools.ant.taskdefs.Echo.EchoLevel" briefType=""error", "warning", "info", "verbose", "debug"" required="no - default is "warning"."> - - <short-description>Logging level.</short-description> - - <description> - Set the logging level. Level should be one of - <ul> - <li>error</li> - <li>warning</li> - <li>info</li> - <li>verbose</li> - <li>debug</li> - </ul> - <p>The default is &quot;warning&quot; to ensure that messages are - displayed by default when using the -quiet command line option.</p> - </description> - - </attribute> - - <attribute name="message" type="java.lang.String" briefType="String" required="yes, unless data is included in a character section within this element."> - - <short-description>Message to write.</short-description> - - <description> - Message to write. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - <body> - - <description> - Set a multiline message. - </description> - - </body> - - - </structure> - - - </task> - - - - <task name="echoproperties" category="other" classname="org.apache.tools.ant.taskdefs.optional.EchoProperties"> - - - <short-description>Displays all the current properties in the build.</short-description> - - <description> - Displays all the current properties in the build. The output can be sent to - a file if desired. <P> - - Attribute "destfile" defines a file to send the properties to. This can be - processed as a standard property file later. <P> - - Attribute "prefix" defines a prefix which is used to filter the properties - only those properties starting with this prefix will be echoed. <P> - - By default, the "failonerror" attribute is enabled. If an error occurs while - writing the properties to a file, and this attribute is enabled, then a - BuildException will be thrown. If disabled, then IO errors will be reported - as a log statement, but no error will be thrown. <P> - - Examples: <pre> - &lt;echoproperties /&gt; - </pre> Report the current properties to the log. <P> - - <pre> - &lt;echoproperties destfile="my.properties" /&gt; - </pre> Report the current properties to the file "my.properties", and will - fail the build if the file could not be created or written to. <P> - - <pre> - &lt;echoproperties destfile="my.properties" failonerror="false" - prefix="ant" /&gt; - </pre> Report all properties beginning with 'ant' to the file - "my.properties", and will log a message if the file could not be created or - written to, but will still allow the build to continue. - </description> - - - <structure> - - - <attributes> - - <attribute name="destfile" type="java.io.File" briefType="File" required="no"> - - <short-description>File to store the property output.</short-description> - - <description> - Set a file to store the property output. If this is never specified, - then the output will be sent to the Ant log. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, the task will fail if an error occurs writing the properties - file, otherwise errors are just logged.</short-description> - - <description> - If true, the task will fail if an error occurs writing the properties - file, otherwise errors are just logged. - </description> - - </attribute> - - <attribute name="prefix" type="java.lang.String" briefType="String" required="no"> - - <short-description>If the prefix is set, then only properties which start with this - prefix string will be recorded.</short-description> - - <description> - If the prefix is set, then only properties which start with this - prefix string will be recorded. If this is never set, or it is set - to an empty string or <tt>null</tt>, then all properties will be - recorded. <P> - - For example, if the property is set as: - <PRE>&lt;echoproperties prefix="ant." /&gt;</PRE> - then the property "ant.home" will be recorded, but "ant-example" - will not. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ejbc" category="other" classname="org.apache.tools.ant.taskdefs.optional.ejb.Ejbc" matchingTask="true"> - - - <short-description>Builds EJB support classes using WebLogic's ejbc tool from a directory containing a set of deployment descriptors.</short-description> - - <description> - Builds EJB support classes using WebLogic's ejbc tool from a directory containing - a set of deployment descriptors. - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="descriptors" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory from where the serialized deployment descriptors are - to be read.</short-description> - - <description> - Set the directory from where the serialized deployment descriptors are - to be read. - </description> - - </attribute> - - <attribute name="dest" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory into which the support classes, RMI stubs, etc are to be written.</short-description> - - <description> - Set the directory into which the support classes, RMI stubs, etc are to be written. - </description> - - </attribute> - - <attribute name="keepgenerated" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>If true, ejbc will keep the - intermediate Java files used to build the class files.</short-description> - - <description> - If true, ejbc will keep the - intermediate Java files used to build the class files. - This can be useful when debugging. - </description> - - </attribute> - - <attribute name="manifest" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name of the generated manifest file.</short-description> - - <description> - Set the name of the generated manifest file. - - For each EJB that is processed an entry is created in this file. This can then be used - to create a jar file for dploying the beans. - </description> - - </attribute> - - <attribute name="src" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory containing the source code for the home interface, remote interface - and public key class definitions.</short-description> - - <description> - Set the directory containing the source code for the home interface, remote interface - and public key class definitions. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ejbjar" category="other" classname="org.apache.tools.ant.taskdefs.optional.ejb.EjbJar" matchingTask="true"> - - - <short-description>Provides automated EJB JAR file creation.</short-description> - - <description> - Provides automated EJB JAR file creation. - <p> - Extends the - MatchingTask class provided in the default ant distribution to provide a - directory scanning EJB jarfile generator. - </p> - - <p> - The task works by taking the deployment descriptors one at a time and - parsing them to locate the names of the classes which should be placed in - the jar. The classnames are translated to java.io.Files by replacing - periods with File.separatorChar and resolving the generated filename as a - relative path under the srcDir attribute. All necessary files are then - assembled into a jarfile. One jarfile is constructed for each deployment - descriptor found. - </p> - </description> - - - <structure> - - - <attributes> - - <attribute name="basejarname" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Base name of the EJB JAR that is to be created if it is not - to be determined from the name of the deployment descriptor files.</short-description> - - <description> - Set the base name of the EJB JAR that is to be created if it is not - to be determined from the name of the deployment descriptor files. - </description> - - </attribute> - - <attribute name="basenameterminator" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The string which terminates the bean name.</short-description> - - <description> - The string which terminates the bean name. - The convention used by this task is - that bean descriptors are named as the BeanName with some suffix. The - baseNameTerminator string separates the bean name and the suffix and - is used to determine the bean name. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to use when resolving classes for inclusion in the jar.</short-description> - - <description> - Set the classpath to use when resolving classes for inclusion in the jar. - </description> - - </attribute> - - <attribute name="dependency" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Analyzer to use when adding in dependencies to the JAR.</short-description> - - <description> - Set the analyzer to use when adding in dependencies to the JAR. - </description> - - </attribute> - - <attribute name="descriptordir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Descriptor directory.</short-description> - - <description> - Set the descriptor directory. The descriptor directory contains the - EJB deployment descriptors. These are XML files that declare the - properties of a bean in a particular deployment scenario. Such - properties include, for example, the transactional nature of the bean - and the security access control to the bean's methods. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory.</short-description> - - <description> - Set the destination directory. The EJB jar files will be written into - this directory. The jar files that exist in this directory are also - used when determining if the contents of the jar file have changed. - Note that this parameter is only used if no deployment tools are - specified. Typically each deployment tool will specify its own - destination directory. - </description> - - </attribute> - - <attribute name="flatdestdir" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Controls whether the - destination JARs are written out in the destination directory with - the same hierarchical structure from which the deployment descriptors - have been read.</short-description> - - <description> - Controls whether the - destination JARs are written out in the destination directory with - the same hierarchical structure from which the deployment descriptors - have been read. If this is set to true the generated EJB jars are - written into the root of the destination directory, otherwise they - are written out in the same relative position as the deployment - descriptors in the descriptor directory. - </description> - - </attribute> - - <attribute name="genericjarsuffix" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Suffix for the generated jar file.</short-description> - - <description> - Set the suffix for the generated jar file. When generic jars are - generated, they have a suffix which is appended to the the bean name - to create the name of the jar file. Note that this suffix includes - the extension fo te jar file and should therefore end with an - appropriate extension such as .jar or .ear - </description> - - </attribute> - - <attribute name="manifest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Manifest file to use when jarring.</short-description> - - <description> - Set the Manifest file to use when jarring. As of EJB 1.1, manifest - files are no longer used to configure the EJB. However, they still - have a vital importance if the EJB is intended to be packaged in an - EAR file. By adding "Class-Path" settings to a Manifest file, the EJB - can look for classes inside the EAR file itself, allowing for easier - deployment. This is outlined in the J2EE specification, and all J2EE - components are meant to support it. - </description> - - </attribute> - - <attribute name="naming" type="org.apache.tools.ant.taskdefs.optional.ejb.EjbJar.NamingScheme" briefType=""ejb-name", "directory", "descriptor", "basejarname"" required="NOTDEFINED"> - - <short-description>Naming scheme used to determine the name of the generated jars - from the deployment descriptor.</short-description> - - <description> - Set the naming scheme used to determine the name of the generated jars - from the deployment descriptor - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Source directory, which is the directory that - contains the classes that will be added to the EJB jar.</short-description> - - <description> - Sets the source directory, which is the directory that - contains the classes that will be added to the EJB jar. Typically - this will include the home and remote interfaces and the bean class. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="borland" type="org.apache.tools.ant.taskdefs.optional.ejb.BorlandDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for Borland server.</short-description> - - <description> - Adds a deployment tool for Borland server. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds to the classpath used to locate the super classes and - interfaces of the classes that will make up the EJB JAR.</short-description> - - <description> - Adds to the classpath used to locate the super classes and - interfaces of the classes that will make up the EJB JAR. - </description> - - </element> - - - <element name="dtd" type="org.apache.tools.ant.taskdefs.optional.ejb.EjbJar.DTDLocation" briefType="" required="NOTDEFINED"> - - <short-description>Create a DTD location record.</short-description> - - <description> - Create a DTD location record. This stores the location of a DTD. The - DTD is identified by its public Id. The location may either be a file - location or a resource location. - </description> - - </element> - - - <element name="iplanet" type="org.apache.tools.ant.taskdefs.optional.ejb.IPlanetDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for iPlanet Application Server.</short-description> - - <description> - Adds a deployment tool for iPlanet Application Server. - </description> - - </element> - - - <element name="jboss" type="org.apache.tools.ant.taskdefs.optional.ejb.JbossDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for JBoss server.</short-description> - - <description> - Adds a deployment tool for JBoss server. - </description> - - </element> - - - <element name="jonas" type="org.apache.tools.ant.taskdefs.optional.ejb.JonasDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for JOnAS server.</short-description> - - <description> - Adds a deployment tool for JOnAS server. - </description> - - </element> - - - <element name="support" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a fileset for support elements.</short-description> - - <description> - Adds a fileset for support elements. - </description> - - </element> - - - <element name="weblogic" type="org.apache.tools.ant.taskdefs.optional.ejb.WeblogicDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for Weblogic server.</short-description> - - <description> - Adds a deployment tool for Weblogic server. - </description> - - </element> - - - <element name="weblogictoplink" type="org.apache.tools.ant.taskdefs.optional.ejb.WeblogicTOPLinkDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for Weblogic when using the Toplink - Object-Relational mapping.</short-description> - - <description> - Adds a deployment tool for Weblogic when using the Toplink - Object-Relational mapping. - </description> - - </element> - - - <element name="websphere" type="org.apache.tools.ant.taskdefs.optional.ejb.WebsphereDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Adds a deployment tool for Websphere 4.0 server.</short-description> - - <description> - Adds a deployment tool for Websphere 4.0 server. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="exec" category="control" classname="org.apache.tools.ant.taskdefs.ExecTask"> - - - <short-description>Executes a given command if the os platform is appropriate.</short-description> - - <description> - Executes a given command if the os platform is appropriate. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether output should be appended to or overwrite an existing file.</short-description> - - <description> - Whether output should be appended to or overwrite an existing file. - Defaults to false. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The working directory of the process.</short-description> - - <description> - The working directory of the process. - </description> - - </attribute> - - <attribute name="executable" type="java.lang.String" briefType="String" required=""> - - <short-description>The command to execute.</short-description> - - <description> - The command to execute. - </description> - - </attribute> - - <attribute name="failifexecutionfails" type="boolean" briefType="boolean" required="no"> - - <short-description>Stop the build if program cannot be started.</short-description> - - <description> - Stop the build if program cannot be started. Defaults to true. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Fail if the command exits with a non-zero return code.</short-description> - - <description> - Fail if the command exits with a non-zero return code. - </description> - - </attribute> - - <attribute name="newenvironment" type="boolean" briefType="boolean" required="no, default is false"> - - <short-description>Do not propagate old environment when new environment variables are specified.</short-description> - - <description> - Do not propagate old environment when new environment variables are specified. - </description> - - </attribute> - - <attribute name="os" type="java.lang.String" briefType="String" required="no"> - - <short-description>List of operating systems on which the command may be executed.</short-description> - - <description> - List of operating systems on which the command may be executed. - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="no"> - - <short-description>File the output of the process is redirected to.</short-description> - - <description> - File the output of the process is redirected to. - </description> - - </attribute> - - <attribute name="outputproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>Property name whose value should be set to the output of - the process.</short-description> - - <description> - Property name whose value should be set to the output of - the process. - </description> - - </attribute> - - <attribute name="resultproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>The name of a property in which the return code of the - command should be stored.</short-description> - - <description> - The name of a property in which the return code of the - command should be stored. Only of interest if failonerror=false. - </description> - - </attribute> - - <attribute name="vmlauncher" type="boolean" briefType="boolean" required="no, default is true"> - - <short-description>If true, launch new process with VM, otherwise use the OS's shell.</short-description> - - <description> - If true, launch new process with VM, otherwise use the OS's shell. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Add an environment variable to the launched process.</short-description> - - <description> - Add an environment variable to the launched process. - </description> - - </element> - - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a command-line argument.</short-description> - - <description> - Adds a command-line argument. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="fail" category="control" classname="org.apache.tools.ant.taskdefs.Exit"> - - - <short-description>Exits the active build, giving an additional message if available.</short-description> - - <description> - Exits the active build, giving an additional message - if available. - </description> - - - <structure> - - - <attributes> - - <attribute name="if" type="java.lang.String" briefType="String" required="no"> - - <short-description>Only fail if a property of the given name exists in the current project.</short-description> - - <description> - Only fail if a property of the given name exists in the current project. - </description> - - </attribute> - - <attribute name="message" type="java.lang.String" briefType="String" required="no"> - - <short-description>A message giving further information on why the build exited.</short-description> - - <description> - A message giving further information on why the build exited. - </description> - - </attribute> - - <attribute name="unless" type="java.lang.String" briefType="String" required="no"> - - <short-description>Only fail if a property of the given name does not - exist in the current project.</short-description> - - <description> - Only fail if a property of the given name does not - exist in the current project. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - <body> - - <description> - Set a multiline message. - </description> - - </body> - - - </structure> - - - </task> - - - - <task name="filter" category="filesystem" classname="org.apache.tools.ant.taskdefs.Filter"> - - - <short-description>Sets a token filter that is used by the file copy tasks to do token substitution.</short-description> - - <description> - Sets a token filter that is used by the file copy tasks - to do token substitution. Sets mutiple tokens by - reading these from a file. - </description> - - - <structure> - - - <attributes> - - <attribute name="filtersfile" type="java.io.File" briefType="File" required="yes*"> - - <short-description>The file from which the filters must be read.</short-description> - - <description> - The file from which the filters must be read. - This file must be a formatted as a property file. - </description> - - </attribute> - - <attribute name="token" type="java.lang.String" briefType="String" required="yes*"> - - <short-description>The token string without @ delimiters.</short-description> - - <description> - The token string without @ delimiters. - </description> - - </attribute> - - <attribute name="value" type="java.lang.String" briefType="String" required="yes*"> - - <short-description>The string that should replace the token during filtered copies.</short-description> - - <description> - The string that should replace the token during filtered copies. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="fixcrlf" category="filesystem" classname="org.apache.tools.ant.taskdefs.FixCRLF" matchingTask="true"> - - - <short-description>Converts text source files to local OS formatting conventions, as well as repair text files damaged by misconfigured or misguided editors or file transfer programs.</short-description> - - <description> - Converts text source files to local OS formatting conventions, as - well as repair text files damaged by misconfigured or misguided editors or - file transfer programs. - <p> - This task can take the following arguments: - <ul> - <li>srcdir - <li>destdir - <li>include - <li>exclude - <li>cr - <li>eol - <li>tab - <li>eof - <li>encoding - </ul> - Of these arguments, only <b>sourcedir</b> is required. - <p> - When this task executes, it will scan the srcdir based on the include - and exclude properties. - <p> - This version generalises the handling of EOL characters, and allows - for CR-only line endings (which I suspect is the standard on Macs.) - Tab handling has also been generalised to accommodate any tabwidth - from 2 to 80, inclusive. Importantly, it will leave untouched any - literal TAB characters embedded within string or character constants. - <p> - <em>Warning:</em> do not run on binary files. - <em>Caution:</em> run with care on carefully formatted files. - This may sound obvious, but if you don't specify asis, presume that - your files are going to be modified. If "tabs" is "add" or "remove", - whitespace characters may be added or removed as necessary. Similarly, - for CR's - in fact "eol"="crlf" or cr="add" can result in cr - characters being removed in one special case accommodated, i.e., - CRCRLF is regarded as a single EOL to handle cases where other - programs have converted CRLF into CRCRLF. - </description> - - - <structure> - - - <attributes> - - <attribute name="destdir" type="java.io.File" briefType="File" required="no"> - - <short-description>Destination where the fixed files should be placed.</short-description> - - <description> - Set the destination where the fixed files should be placed. - Default is to replace the original file. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no - defaults to default jvm encoding"> - - <short-description>Specifies the encoding Ant expects the files to be in - - defaults to the platforms default encoding.</short-description> - - <description> - Specifies the encoding Ant expects the files to be in - - defaults to the platforms default encoding. - </description> - - </attribute> - - <attribute name="eof" type="org.apache.tools.ant.taskdefs.FixCRLF.AddAsisRemove" briefType=""add", "asis", "remove"" required="no"> - - <short-description>Specify how DOS EOF (control-z) characters are to be handled.</short-description> - - <description> - Specify how DOS EOF (control-z) characters are to be handled. - </description> - - </attribute> - - <attribute name="eol" type="org.apache.tools.ant.taskdefs.FixCRLF.CrLf" briefType=""asis", "cr", "lf", "crlf"" required="no"> - - <short-description>Specify how EndOfLine characters are to be handled.</short-description> - - <description> - Specify how EndOfLine characters are to be handled. - </description> - - </attribute> - - <attribute name="javafiles" type="boolean" briefType="boolean" required="no"> - - <short-description>Set to true if modifying Java source files.</short-description> - - <description> - Set to true if modifying Java source files. - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Source dir to find the source text files.</short-description> - - <description> - Set the source dir to find the source text files. - </description> - - </attribute> - - <attribute name="tab" type="org.apache.tools.ant.taskdefs.FixCRLF.AddAsisRemove" briefType=""add", "asis", "remove"" required="no"> - - <short-description>Specify how tab characters are to be handled.</short-description> - - <description> - Specify how tab characters are to be handled. - </description> - - </attribute> - - <attribute name="tablength" type="int" briefType="int" required="no"> - - <short-description>Specify tab length in characters.</short-description> - - <description> - Specify tab length in characters. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="ftp" category="other" classname="org.apache.tools.ant.taskdefs.optional.net.FTP"> - - - <short-description>Basic FTP client.</short-description> - - <description> - Basic FTP client. Performs the following actions: - <ul> - <li> <strong>send</strong> - send files to a remote server. This is the - default action.</li> - <li> <strong>get</strong> - retrive files from a remote server.</li> - <li> <strong>del</strong> - delete files from a remote server.</li> - <li> <strong>list</strong> - create a file listing.</li> - <li> <strong>chmod</strong> - change unix file permissions.</li> - </ul> - <strong>Note:</strong> Some FTP servers - notably the Solaris server - seem - to hold data ports open after a "retr" operation, allowing them to timeout - instead of shutting them down cleanly. This happens in active or passive - mode, and the ports will remain open even after ending the FTP session. FTP - "send" operations seem to close ports immediately. This behavior may cause - problems on some systems when downloading large sets of files. - </description> - - - <structure> - - - <attributes> - - <attribute name="action" type="org.apache.tools.ant.taskdefs.optional.net.FTP.Action" briefType=""send", "put", "recv", "get", "del", "delete", "list", "mkdir", "chmod"" required="no"> - - <short-description>FTP action to be taken.</short-description> - - <description> - Sets the FTP action to be taken. Currently accepts "put", "get", "del", - "mkdir", "chmod" and "list". - </description> - - </attribute> - - <attribute name="binary" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, uses binary mode, otherwise text mode (default is binary).</short-description> - - <description> - If true, uses binary mode, otherwise text mode (default is binary). - </description> - - </attribute> - - <attribute name="chmod" type="java.lang.String" briefType="String" required="no"> - - <short-description>File permission mode (Unix only) for files sent to the server.</short-description> - - <description> - Sets the file permission mode (Unix only) for files sent to the server. - </description> - - </attribute> - - <attribute name="depends" type="boolean" briefType="boolean" required="no"> - - <short-description>Set to true to transmit only files that are new or changed from their - remote counterparts.</short-description> - - <description> - Set to true to transmit only files that are new or changed from their - remote counterparts. The default is to transmit all files. - </description> - - </attribute> - - <attribute name="ignorenoncriticalerrors" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to skip errors on directory creation. - (and maybe later other server specific errors).</short-description> - - <description> - set the flag to skip errors on directory creation. - (and maybe later other server specific errors) - </description> - - </attribute> - - <attribute name="listing" type="java.io.File" briefType="File" required="no"> - - <short-description>The output file for the "list" action.</short-description> - - <description> - The output file for the "list" action. This attribute is ignored for - any other actions. - </description> - - </attribute> - - <attribute name="newer" type="boolean" briefType="boolean" required="no"> - - <short-description>A synonym for <tt>depends</tt>.</short-description> - - <description> - A synonym for <tt>depends</tt>. Set to true to transmit only new or changed - files. - </description> - - </attribute> - - <attribute name="passive" type="boolean" briefType="boolean" required="no"> - - <short-description>Specifies whether to use passive mode.</short-description> - - <description> - Specifies whether to use passive mode. Set to true if you are behind a - firewall and cannot connect without it. Passive mode is disabled by - default. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Login password for the given user id.</short-description> - - <description> - Sets the login password for the given user id. - </description> - - </attribute> - - <attribute name="port" type="int" briefType="int" required="no"> - - <short-description>FTP port used by the remote server.</short-description> - - <description> - Sets the FTP port used by the remote server. - </description> - - </attribute> - - <attribute name="remotedir" type="java.lang.String" briefType="String" required="no"> - - <short-description>Remote directory where files will be placed.</short-description> - - <description> - Sets the remote directory where files will be placed. This may be a - relative or absolute path, and must be in the path syntax expected by - the remote server. No correction of path syntax will be performed. - </description> - - </attribute> - - <attribute name="separator" type="java.lang.String" briefType="String" required="no"> - - <short-description>Remote file separator character.</short-description> - - <description> - Sets the remote file separator character. This normally defaults to the - Unix standard forward slash, but can be manually overridden using this - call if the remote server requires some other separator. Only the first - character of the string is used. - </description> - - </attribute> - - <attribute name="server" type="java.lang.String" briefType="String" required="yes"> - - <short-description>FTP server to send files to.</short-description> - - <description> - Sets the FTP server to send files to. - </description> - - </attribute> - - <attribute name="skipfailedtransfers" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, enables unsuccessful file put, delete and get - operations to be skipped with a warning and the remainder - of the files still transferred.</short-description> - - <description> - If true, enables unsuccessful file put, delete and get - operations to be skipped with a warning and the remainder - of the files still transferred. - </description> - - </attribute> - - <attribute name="umask" type="java.lang.String" briefType="String" required="no"> - - <short-description>Default mask for file creation on a unix server.</short-description> - - <description> - Sets the default mask for file creation on a unix server. - </description> - - </attribute> - - <attribute name="userid" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Login user id to use on the specified server.</short-description> - - <description> - Sets the login user id to use on the specified server. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>Set to true to receive notification about each file as it is - transferred.</short-description> - - <description> - Set to true to receive notification about each file as it is - transferred. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>A set of files to upload or download.</short-description> - - <description> - A set of files to upload or download - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="genkey" category="java" classname="org.apache.tools.ant.taskdefs.GenerateKey"> - - - <short-description>Generates a key in a keystore.</short-description> - - <description> - Generates a key in a keystore. - </description> - - - <structure> - - - <attributes> - - <attribute name="alias" type="java.lang.String" briefType="String" required="yes."> - - <short-description>The alias to add under.</short-description> - - <description> - The alias to add under. - </description> - - </attribute> - - <attribute name="dname" type="java.lang.String" briefType="String" required="yes if dname element unspecified"> - - <short-description>The distinguished name for entity.</short-description> - - <description> - The distinguished name for entity. - </description> - - </attribute> - - <attribute name="keyalg" type="java.lang.String" briefType="String" required="no"> - - <short-description>The method to use when generating name-value pair.</short-description> - - <description> - The method to use when generating name-value pair. - </description> - - </attribute> - - <attribute name="keypass" type="java.lang.String" briefType="String" required="no"> - - <short-description>Password for private key (if different).</short-description> - - <description> - Password for private key (if different). - </description> - - </attribute> - - <attribute name="keysize" type="java.lang.String" briefType="String" required="no"> - - <short-description>Indicates the size of key generated.</short-description> - - <description> - Indicates the size of key generated. - </description> - - </attribute> - - <attribute name="keystore" type="java.lang.String" briefType="String" required="no"> - - <short-description>Keystore location.</short-description> - - <description> - Keystore location. - </description> - - </attribute> - - <attribute name="sigalg" type="java.lang.String" briefType="String" required="no"> - - <short-description>The algorithm to use in signing.</short-description> - - <description> - The algorithm to use in signing. - </description> - - </attribute> - - <attribute name="storepass" type="java.lang.String" briefType="String" required="yes."> - - <short-description>Password for keystore integrity.</short-description> - - <description> - Password for keystore integrity. - Must be at least 6 characters long. - </description> - - </attribute> - - <attribute name="storetype" type="java.lang.String" briefType="String" required="no"> - - <short-description>Keystore type.</short-description> - - <description> - Keystore type. - </description> - - </attribute> - - <attribute name="validity" type="java.lang.String" briefType="String" required="no"> - - <short-description>Indicates how many days certificate is valid.</short-description> - - <description> - Indicates how many days certificate is valid. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, verbose output when signing.</short-description> - - <description> - If true, verbose output when signing. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="dname" type="org.apache.tools.ant.taskdefs.GenerateKey.DistinguishedName" briefType="" required="NOTDEFINED"> - - <short-description>Distinguished name list.</short-description> - - <description> - Distinguished name list. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="get" category="network" classname="org.apache.tools.ant.taskdefs.Get"> - - - <short-description>Gets a particular file from a URL source.</short-description> - - <description> - Gets a particular file from a URL source. - Options include verbose reporting, timestamp based fetches and controlling - actions on failures. NB: access through a firewall only works if the whole - Java runtime is correctly configured. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>Where to copy the source file.</short-description> - - <description> - Where to copy the source file. - </description> - - </attribute> - - <attribute name="ignoreerrors" type="boolean" briefType="boolean" required="no; default "false""> - - <short-description>If true, log errors but do not treat as fatal.</short-description> - - <description> - If true, log errors but do not treat as fatal. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="if username is set"> - - <short-description>Password for the basic authentication.</short-description> - - <description> - password for the basic authentication. - </description> - - </attribute> - - <attribute name="src" type="java.net.URL" briefType="URL" required="yes"> - - <short-description>URL to get.</short-description> - - <description> - Set the URL to get. - </description> - - </attribute> - - <attribute name="usetimestamp" type="boolean" briefType="boolean" required="no; default "false""> - - <short-description>If true, conditionally download a file based on the timestamp - of the local copy.</short-description> - - <description> - If true, conditionally download a file based on the timestamp - of the local copy. - - <p>In this situation, the if-modified-since header is set so - that the file is only fetched if it is newer than the local - file (or there is no local file) This flag is only valid on - HTTP connections, it is ignored in other cases. When the flag - is set, the local copy of the downloaded file will also have - its timestamp set to the remote file time.</p> - - <p>Note that remote files of date 1/1/1970 (GMT) are treated as - 'no timestamp', and web servers often serve files with a - timestamp in the future by replacing their timestamp with that - of the current time. Also, inter-computer clock differences can - cause no end of grief.</p> - </description> - - </attribute> - - <attribute name="username" type="java.lang.String" briefType="String" required="if password is set"> - - <short-description>Username for basic auth.</short-description> - - <description> - Username for basic auth. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no; default "false""> - - <short-description>If true, show verbose progress information.</short-description> - - <description> - If true, show verbose progress information. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="gunzip" category="packaging" classname="org.apache.tools.ant.taskdefs.GUnzip"> - - - <short-description>Expands a file that has been compressed with the GZIP algorithm.</short-description> - - <description> - Expands a file that has been compressed with the GZIP - algorithm. Normally used to compress non-compressed archives such - as TAR files. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The destination file or directory; optional.</short-description> - - <description> - The destination file or directory; optional. - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The file to expand; required.</short-description> - - <description> - The file to expand; required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="gzip" category="packaging" classname="org.apache.tools.ant.taskdefs.GZip"> - - - <short-description>Compresses a file with the GZIP algorithm.</short-description> - - <description> - Compresses a file with the GZIP algorithm. Normally used to compress - non-compressed archives such as TAR files. - </description> - - - <structure> - - - <attributes> - - <attribute name="src" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The file to compress; required.</short-description> - - <description> - the file to compress; required. - </description> - - </attribute> - - <attribute name="zipfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The required destination file.</short-description> - - <description> - the required destination file. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="icontract" category="other" classname="org.apache.tools.ant.taskdefs.optional.IContract" matchingTask="true"> - - - <short-description>Instruments Java classes with iContract DBC preprocessor.</short-description> - - <description> - Instruments Java classes with iContract DBC preprocessor. - <br/> - The task can generate a properties file for <a href="http://hjem.sol.no/hellesoy/icontrol.html">iControl</a>, - a graphical user interface that lets you turn on/off assertions. iControl generates a control file that you can refer to - from this task using the controlfile attribute. - iContract is at <a href="http://www.reliable-systems.com/tools/">http://www.reliable-systems.com/tools/</a> - <p/> - Thanks to Rainer Schmitz for enhancements and comments. - </description> - - - <structure> - - - <attributes> - - <attribute name="builddir" type="java.io.File" briefType="File" required="no"> - - <short-description>Build directory for instrumented classes.</short-description> - - <description> - Sets the build directory for instrumented classes. - </description> - - </attribute> - - <attribute name="classdir" type="java.io.File" briefType="File" required="only if updateicontrol=true"> - - <short-description>Class directory (uninstrumented classes).</short-description> - - <description> - Sets the class directory (uninstrumented classes). - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to be used for invocation of iContract.</short-description> - - <description> - Sets the classpath to be used for invocation of iContract. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="controlfile" type="java.io.File" briefType="File" required="only if updateicontrol=true"> - - <short-description>Control file to pass to iContract.</short-description> - - <description> - Sets the control file to pass to iContract. - </description> - - </attribute> - - <attribute name="failthrowable" type="java.lang.String" briefType="String" required="no"> - - <short-description>Throwable (Exception) to be thrown on assertion violation.</short-description> - - <description> - Sets the Throwable (Exception) to be thrown on assertion violation. - </description> - - </attribute> - - <attribute name="instrumentdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Instrumentation directory.</short-description> - - <description> - Sets the instrumentation directory. - </description> - - </attribute> - - <attribute name="invariant" type="boolean" briefType="boolean" required="no"> - - <short-description>Turns on/off invariant instrumentation.</short-description> - - <description> - Turns on/off invariant instrumentation. - </description> - - </attribute> - - <attribute name="post" type="boolean" briefType="boolean" required="no"> - - <short-description>Turns on/off postcondition instrumentation.</short-description> - - <description> - Turns on/off postcondition instrumentation. - </description> - - </attribute> - - <attribute name="pre" type="boolean" briefType="boolean" required="no"> - - <short-description>Turns on/off precondition instrumentation.</short-description> - - <description> - Turns on/off precondition instrumentation. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="no"> - - <short-description>Tells iContract to be quiet.</short-description> - - <description> - Tells iContract to be quiet. - </description> - - </attribute> - - <attribute name="repbuilddir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Build directory for instrumented classes.</short-description> - - <description> - Sets the build directory for instrumented classes. - </description> - - </attribute> - - <attribute name="repositorydir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Build directory for repository classes.</short-description> - - <description> - Sets the build directory for repository classes. - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Source directory.</short-description> - - <description> - Sets the source directory. - </description> - - </attribute> - - <attribute name="targets" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of the file where targets will be written.</short-description> - - <description> - Sets the name of the file where targets will be written. That is the - file that tells iContract what files to process. - </description> - - </attribute> - - <attribute name="updateicontrol" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, updates iControl properties file.</short-description> - - <description> - If true, updates iControl properties file - </description> - - </attribute> - - <attribute name="verbosity" type="java.lang.String" briefType="String" required="no"> - - <short-description>Verbosity level of iContract.</short-description> - - <description> - Sets the verbosity level of iContract. Any combination of - error*,warning*,note*,info*,progress*,debug* (comma separated) can be - used. Defaults to error*,warning* - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath.</short-description> - - <description> - Sets the classpath. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="ilasm" category="other" classname="org.apache.tools.ant.taskdefs.optional.dotnet.Ilasm" matchingTask="true"> - - - <short-description>Assembles .NET Intermediate Language files.</short-description> - - <description> - Assembles .NET Intermediate Language files. The task will only work - on win2K until other platforms support csc.exe or an equivalent. ilasm.exe - must be on the execute path too. <p> - - <p> - - All parameters are optional: &lt;il/&gt; should suffice to produce a debug - build of all *.il files. The option set is roughly compatible with the - CSharp class; even though the command line options are only vaguely - equivalent. [The low level commands take things like /OUT=file, csc wants - /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] - It would be nice if someone made all the command line tools consistent (and - not as brittle as the java cmdline tools) <p> - - The task is a directory based task, so attributes like <b>includes="*.il" - </b> and <b>excludes="broken.il"</b> can be used to control the files pulled - in. Each file is built on its own, producing an appropriately named output - file unless manually specified with <b>outfile</b> - </description> - - - <structure> - - - <attributes> - - <attribute name="debug" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Debug flag on or off.</short-description> - - <description> - set the debug flag on or off. - </description> - - </attribute> - - <attribute name="extraoptions" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Any extra options which are not explicitly - supported by this task.</short-description> - - <description> - Any extra options which are not explicitly - supported by this task. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, fails if ilasm tool fails.</short-description> - - <description> - If true, fails if ilasm tool fails. - </description> - - </attribute> - - <attribute name="keyfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The name of a file containing a private key.</short-description> - - <description> - the name of a file containing a private key. - </description> - - </attribute> - - <attribute name="listing" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, produce a listing (off by default).</short-description> - - <description> - If true, produce a listing (off by default). - </description> - - </attribute> - - <attribute name="outputfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Output file.</short-description> - - <description> - Set the output file. - </description> - - </attribute> - - <attribute name="resourcefile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Name of resource file to include.</short-description> - - <description> - name of resource file to include. - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Source directory containing the files to be compiled.</short-description> - - <description> - Set the source directory containing the files to be compiled. - </description> - - </attribute> - - <attribute name="targettype" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Type of target, either "exe" or "library".</short-description> - - <description> - Sets the type of target, either "exe" or "library". - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, enable verbose ILASM output.</short-description> - - <description> - If true, enable verbose ILASM output. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="input" category="control" classname="org.apache.tools.ant.taskdefs.Input"> - - - <short-description>Reads an input line from the console.</short-description> - - <description> - Reads an input line from the console. - </description> - - - <structure> - - - <attributes> - - <attribute name="addproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>Defines the name of a property to be created from input.</short-description> - - <description> - Defines the name of a property to be created from input. Behaviour is - according to property task which means that existing properties - cannot be overriden. - </description> - - </attribute> - - <attribute name="message" type="java.lang.String" briefType="String" required="no"> - - <short-description>Message which gets displayed to the user during the build run.</short-description> - - <description> - Sets the Message which gets displayed to the user during the build run. - </description> - - </attribute> - - <attribute name="validargs" type="java.lang.String" briefType="String" required="no"> - - <short-description>Defines valid input parameters as comma separated strings.</short-description> - - <description> - Defines valid input parameters as comma separated strings. If set, input - task will reject any input not defined as accepted and requires the user - to reenter it. Validargs are case sensitive. If you want 'a' and 'A' to - be accepted you need to define both values as accepted arguments. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - <body> - - <description> - Set a multiline message. - </description> - - </body> - - - </structure> - - - </task> - - - - <task name="iplanet-ejbc" category="ejb" classname="org.apache.tools.ant.taskdefs.optional.ejb.IPlanetEjbcTask"> - - - <short-description>Compiles EJB stubs and skeletons for the iPlanet Application Server.</short-description> - - <description> - Compiles EJB stubs and skeletons for the iPlanet Application Server. - The EJBs to be processed are specified by the EJB 1.1 standard XML - descriptor, and additional attributes are obtained from the iPlanet Application - Server-specific XML descriptor. Since the XML descriptors can include - multiple EJBs, this is a convenient way of specifying many EJBs in a single - Ant task. The following attributes are allowed: - <ul> - <li><i>ejbdescriptor</i> -- Standard EJB 1.1 XML descriptor (typically - titled "ejb-jar.xml"). This attribute is - required. - <li><i>iasdescriptor</i> -- EJB XML descriptor for iPlanet Application - Server (typically titled "ias-ejb-jar.xml). - This attribute is required. - <li><i>dest</i> -- The is the base directory where the RMI stubs and - skeletons are written. In addition, the class files - for each bean (home interface, remote interface, and - EJB implementation) must be found in this directory. - This attribute is required. - <li><i>classpath</i> -- The classpath used when generating EJB stubs and - skeletons. This is an optional attribute (if - omitted, the classpath specified when Ant was - started will be used). Nested "classpath" - elements may also be used. - <li><i>keepgenerated</i> -- Indicates whether or not the Java source - files which are generated by ejbc will be - saved or automatically deleted. If "yes", - the source files will be retained. This is - an optional attribute (if omitted, it - defaults to "no"). - <li><i>debug</i> -- Indicates whether or not the ejbc utility should - log additional debugging statements to the standard - output. If "yes", the additional debugging statements - will be generated (if omitted, it defaults to "no"). - <li><i>iashome</i> -- May be used to specify the "home" directory for - this iPlanet Application Server installation. This - is used to find the ejbc utility if it isn't - included in the user's system path. This is an - optional attribute (if specified, it should refer - to the <code>[install-location]/iplanet/ias6/ias - </code> directory). If omitted, the ejbc utility - must be on the user's system path. - </ul> - <p> - For each EJB specified, this task will locate the three classes that comprise - the EJB. If these class files cannot be located in the <code>dest</code> - directory, the task will fail. The task will also attempt to locate the EJB - stubs and skeletons in this directory. If found, the timestamps on the - stubs and skeletons will be checked to ensure they are up to date. Only if - these files cannot be found or if they are out of date will ejbc be called - to generate new stubs and skeletons. - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to be used when compiling the EJB stubs and skeletons.</short-description> - - <description> - Sets the classpath to be used when compiling the EJB stubs and skeletons. - </description> - - </attribute> - - <attribute name="debug" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, debugging output will be generated when ejbc is - executed.</short-description> - - <description> - If true, debugging output will be generated when ejbc is - executed. - </description> - - </attribute> - - <attribute name="dest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory where the EJB source classes must exist - and where the stubs and skeletons will be written.</short-description> - - <description> - Sets the destination directory where the EJB source classes must exist - and where the stubs and skeletons will be written. The destination - directory must exist before this task is executed. - </description> - - </attribute> - - <attribute name="ejbdescriptor" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Location of the standard XML EJB descriptor.</short-description> - - <description> - Sets the location of the standard XML EJB descriptor. Typically, this - file is named "ejb-jar.xml". - </description> - - </attribute> - - <attribute name="iasdescriptor" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Location of the iAS-specific XML EJB descriptor.</short-description> - - <description> - Sets the location of the iAS-specific XML EJB descriptor. Typically, - this file is named "ias-ejb-jar.xml". - </description> - - </attribute> - - <attribute name="iashome" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>May be used to specify the "home" directory for this iAS installation.</short-description> - - <description> - May be used to specify the "home" directory for this iAS installation. - The directory specified should typically be - <code>[install-location]/iplanet/ias6/ias</code>. - </description> - - </attribute> - - <attribute name="keepgenerated" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, the Java source files which are generated by ejbc will be saved .</short-description> - - <description> - If true, the Java source files which are generated by ejbc will be saved . - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds to the classpath used when compiling the EJB stubs and skeletons.</short-description> - - <description> - Adds to the classpath used when compiling the EJB stubs and skeletons. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jar" category="packaging" classname="org.apache.tools.ant.taskdefs.Jar" matchingTask="true"> - - - <short-description>Creates a JAR archive.</short-description> - - <description> - Creates a JAR archive. - </description> - - - <structure> - - - <attributes> - - <attribute name="basedir" type="java.io.File" briefType="File" required="no"> - - <short-description>Directory from which to archive files; optional.</short-description> - - <description> - Directory from which to archive files; optional. - </description> - - </attribute> - - <attribute name="compress" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether we want to compress the files or only store them; - optional, default=true;.</short-description> - - <description> - Whether we want to compress the files or only store them; - optional, default=true; - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The file to create; required.</short-description> - - <description> - The file to create; required. - </description> - - </attribute> - - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" briefType=""add", "preserve", "fail"" required="no"> - - <short-description>Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.</short-description> - - <description> - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding to use for filenames, defaults to the platform's - default encoding.</short-description> - - <description> - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - </description> - - </attribute> - - <attribute name="filesonly" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.</short-description> - - <description> - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - </description> - - </attribute> - - <attribute name="index" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether or not to create an index list for classes.</short-description> - - <description> - Set whether or not to create an index list for classes. - This may speed up classloading in some cases. - </description> - - </attribute> - - <attribute name="manifest" type="java.io.File" briefType="File" required="no"> - - <short-description>The manifest file to use.</short-description> - - <description> - The manifest file to use. This can be either the location of a manifest, - or the name of a jar added through a fileset. If its the name of an added - jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.MF. - </description> - - </attribute> - - <attribute name="update" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.</short-description> - - <description> - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - </description> - - </attribute> - - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" briefType=""fail", "skip", "create"" required="no"> - - <short-description>Sets behavior of the task when no files match.</short-description> - - <description> - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="manifest" type="org.apache.tools.ant.taskdefs.Manifest" briefType="" required="NOTDEFINED"> - - <short-description>Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.</short-description> - - <description> - Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files.</short-description> - - <description> - Adds a set of files. - </description> - - </element> - - - <element name="metainf" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a zipfileset to include in the META-INF directory.</short-description> - - <description> - Adds a zipfileset to include in the META-INF directory. - </description> - - </element> - - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a group of zip files.</short-description> - - <description> - Adds a group of zip files. - </description> - - </element> - - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a set of files that can be - read from an archive and be given a prefix/fullpath.</short-description> - - <description> - Adds a set of files that can be - read from an archive and be given a prefix/fullpath. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jarlib-available" category="other" classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibAvailableTask"> - - - <short-description>Checks whether an extension is present in a fileset or an extensionSet.</short-description> - - <description> - Checks whether an extension is present in a fileset or an extensionSet. - </description> - - - <structure> - - - <attributes> - - <attribute name="file" type="java.io.File" briefType="File" required="no, one of file, nested extensionset or nested fileset must be present."> - - <short-description>The JAR library to check.</short-description> - - <description> - The JAR library to check. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The name of property to set if extensions are available.</short-description> - - <description> - The name of property to set if extensions are available. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="extension" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionAdapter" briefType="" required="NOTDEFINED"> - - <short-description>Extension looking for.</short-description> - - <description> - Set the Extension looking for. - </description> - - </element> - - - <element name="extensionset" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionSet" briefType="" required="NOTDEFINED"> - - <short-description>Adds a set of extensions to search in.</short-description> - - <description> - Adds a set of extensions to search in. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jarlib-display" category="other" classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibDisplayTask"> - - - <short-description>Displays the "Optional Package" and "Package Specification" information contained within the specified JARs.</short-description> - - <description> - Displays the "Optional Package" and "Package Specification" information - contained within the specified JARs. - - <p>Prior to JDK1.3, an "Optional Package" was known as an Extension. - The specification for this mechanism is available in the JDK1.3 - documentation in the directory - $JDK_HOME/docs/guide/extensions/versioning.html. Alternatively it is - available online at <a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> - http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="file" type="java.io.File" briefType="File" required="no, but one of file or fileset must be present."> - - <short-description>The JAR library to display information for.</short-description> - - <description> - The JAR library to display information for. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files about which library data will be displayed.</short-description> - - <description> - Adds a set of files about which library data will be displayed. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jarlib-manifest" category="other" classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibManifestTask"> - - - <short-description>Generates a manifest that declares all the dependencies.</short-description> - - <description> - Generates a manifest that declares all the dependencies. - The dependencies are determined by looking in the - specified path and searching for Extension / "Optional Package" - specifications in the manifests of the jars. - - <p>Prior to JDK1.3, an "Optional Package" was known as an Extension. - The specification for this mechanism is available in the JDK1.3 - documentation in the directory - $JDK_HOME/docs/guide/extensions/versioning.html. Alternatively it is - available online at <a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> - http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes."> - - <short-description>The location where generated manifest is placed.</short-description> - - <description> - The location where generated manifest is placed. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="attribute" type="org.apache.tools.ant.taskdefs.optional.extension.ExtraAttribute" briefType="" required="NOTDEFINED"> - - <short-description>Adds an attribute that is to be put in main section of manifest.</short-description> - - <description> - Adds an attribute that is to be put in main section of manifest. - </description> - - </element> - - - <element name="depends" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionSet" briefType="" required="NOTDEFINED"> - - <short-description>Adds a set of extensions that this library requires.</short-description> - - <description> - Adds a set of extensions that this library requires. - </description> - - </element> - - - <element name="extension" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionAdapter" briefType="" required="NOTDEFINED"> - - <short-description>Adds an extension that this library implements.</short-description> - - <description> - Adds an extension that this library implements. - </description> - - </element> - - - <element name="options" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionSet" briefType="" required="NOTDEFINED"> - - <short-description>Adds a set of extensions that this library optionally requires.</short-description> - - <description> - Adds a set of extensions that this library optionally requires. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jarlib-resolve" category="other" classname="org.apache.tools.ant.taskdefs.optional.extension.JarLibResolveTask"> - - - <short-description>Tries to locate a JAR to satisfy an extension and place location of JAR into property.</short-description> - - <description> - Tries to locate a JAR to satisfy an extension and place - location of JAR into property. - </description> - - - <structure> - - - <attributes> - - <attribute name="checkextension" type="boolean" briefType="boolean" required="no, defaults to true."> - - <short-description>If true, libraries returned by nested resolvers should be - checked to see if they supply extension.</short-description> - - <description> - If true, libraries returned by nested resolvers should be - checked to see if they supply extension. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no, defaults to true."> - - <short-description>If true, failure to locate library should fail build.</short-description> - - <description> - If true, failure to locate library should fail build. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The name of the property in which the location of - library is stored.</short-description> - - <description> - The name of the property in which the location of - library is stored. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="ant" type="org.apache.tools.ant.taskdefs.optional.extension.resolvers.AntResolver" briefType="" required="NOTDEFINED"> - - <short-description>Adds Ant resolver to run an Ant buildfile to generate a library.</short-description> - - <description> - Adds Ant resolver to run an Ant buildfile to generate a library. - </description> - - </element> - - - <element name="extension" type="org.apache.tools.ant.taskdefs.optional.extension.ExtensionAdapter" briefType="" required="NOTDEFINED"> - - <short-description>Extension looking for.</short-description> - - <description> - Set the Extension looking for. - </description> - - </element> - - - <element name="location" type="org.apache.tools.ant.taskdefs.optional.extension.resolvers.LocationResolver" briefType="" required="NOTDEFINED"> - - <short-description>Adds location resolver to look for a library in a location - relative to project directory.</short-description> - - <description> - Adds location resolver to look for a library in a location - relative to project directory. - </description> - - </element> - - - <element name="url" type="org.apache.tools.ant.taskdefs.optional.extension.resolvers.URLResolver" briefType="" required="NOTDEFINED"> - - <short-description>Adds a URL resolver to download a library from a URL - to a local file.</short-description> - - <description> - Adds a URL resolver to download a library from a URL - to a local file. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="java" category="java" classname="org.apache.tools.ant.taskdefs.Java"> - - - <short-description>Launcher for Java applications.</short-description> - - <description> - Launcher for Java applications. Allows use of - the same JVM for the called application thus resulting in much - faster operation. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, append output to existing file.</short-description> - - <description> - If true, append output to existing file. - </description> - - </attribute> - - <attribute name="classname" type="java.lang.String" briefType="String" required="either jar or classname"> - - <short-description>Java class to execute.</short-description> - - <description> - Sets the Java class to execute. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used when running the Java class.</short-description> - - <description> - Set the classpath to be used when running the Java class - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Classpath to use, by reference.</short-description> - - <description> - Classpath to use, by reference. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The working directory of the process.</short-description> - - <description> - The working directory of the process - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, then fail if the command exits with a - returncode other than 0.</short-description> - - <description> - If true, then fail if the command exits with a - returncode other than 0 - </description> - - </attribute> - - <attribute name="fork" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, execute in a new VM.</short-description> - - <description> - If true, execute in a new VM. - </description> - - </attribute> - - <attribute name="jvmversion" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>JVM version.</short-description> - - <description> - Sets the JVM version. - </description> - - </attribute> - - <attribute name="jar" type="java.io.File" briefType="File" required="either jar or classname"> - - <short-description>The location of the JAR file to execute.</short-description> - - <description> - The location of the JAR file to execute. - </description> - - </attribute> - - <attribute name="jvm" type="java.lang.String" briefType="String" required="no"> - - <short-description>Command used to start the VM (only if not forking).</short-description> - - <description> - Set the command used to start the VM (only if not forking). - </description> - - </attribute> - - <attribute name="jvmargs" type="java.lang.String" briefType="String" required="no"> - - <short-description>Command line arguments for the JVM.</short-description> - - <description> - Set the command line arguments for the JVM. - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="no"> - - <short-description>Corresponds to -mx or -Xmx depending on VM version.</short-description> - - <description> - Corresponds to -mx or -Xmx depending on VM version. - </description> - - </attribute> - - <attribute name="newenvironment" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, use a completely new environment.</short-description> - - <description> - If true, use a completely new environment. - - <p>Will be ignored if we are not forking a new VM. - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="no"> - - <short-description>File the output of the process is redirected to.</short-description> - - <description> - File the output of the process is redirected to. - </description> - - </attribute> - - <attribute name="timeout" type="java.lang.Long" briefType="long" required="no"> - - <short-description>Timeout in milliseconds after which the process will be killed.</short-description> - - <description> - Timeout in milliseconds after which the process will be killed. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Adds an environment variable.</short-description> - - <description> - Adds an environment variable. - - <p>Will be ignored if we are not forking a new VM. - </description> - - </element> - - - <element name="sysproperty" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Adds a system property.</short-description> - - <description> - Adds a system property. - </description> - - </element> - - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a command-line argument.</short-description> - - <description> - Adds a command-line argument. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to the classpath.</short-description> - - <description> - Adds a path to the classpath. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a JVM argument.</short-description> - - <description> - Adds a JVM argument. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="javac" category="java" classname="org.apache.tools.ant.taskdefs.Javac" matchingTask="true"> - - - - <external> - - <description> - - - <p>Compiles a Java source tree.</p> - - - <p>The source and destination directory will be recursively scanned for Java -source files to compile. Only Java files that have no corresponding class file -or where the class file is older than the java file will be compiled.</p> - - - <p>Note: Ant uses only the names of the source and class files to find -the classes that need a rebuild. It will not scan the source and therefor -will have no knowledge about nested classes, classes that are named different -from the source file and so on.</p> - - - <p>The directory structure of the source tree should follow the package -hierarchy.</p> - - - <p>It is possible to refine the set of files that are being compiled/copied. -This can be done with the - <i>includes</i>, - <i>includesfile</i>, - <i>excludes</i>, - <i>excludesfile</i> and - <i>defaultexcludes</i> -attributes. With the - <i>includes</i> or - <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The - <i>exclude</i> or - <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the - <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on - <a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns. - </p> - - - <p>It is possible to use different compilers. This can be selected with the -"build.compiler" property or the compiler attribute. Here are the choices:-</p> - - <ul> - - <li>classic (the standard compiler of JDK 1.1/1.2) - javac1.1 and - javac1.2 can be used as aliases</li> - - <li>modern (the standard compiler of JDK 1.3/1.4) - javac1.3 and - javac1.4 can be used as aliases</li> - - <li>jikes (the - <a href="http://oss.software.ibm.com/developerworks/opensource/jikes/project" target="_top">Jikes</a> - compiler) - </li> - - <li>jvc (the Command-Line Compiler from Microsoft's SDK for Java / - Visual J++) - microsoft can be used as an alias</li> - - <li>kjc (the - <a href="http://www.dms.at/kopi/" target="_top">kopi</a> - compiler) - </li> - - <li>gcj (the gcj compiler from gcc)</li> - - <li>sj (Symantec java compiler) - symantec can be used as an alias</li> - - <li>extJavac (run either modern or classic in a JVM of its own)</li> - - </ul> - - <p>For JDK 1.1/1.2, classic is the default. For JDK 1.3/1.4, modern is the default. -If you wish to use a different compiler interface than those -supplied, write a class that implements the CompilerAdapter interface -(package org.apache.tools.ant.taskdefs.compilers). Supply the full -classname in the "build.compiler" property.</p> - - - <p>The fork attribute overrides the build.compiler setting and expects -a JDK1.1 or higher to be set in java.home.</p> - - - <p>This task will drop all entries that point to non-existent -files/directories from the CLASSPATH it passes to the compiler.</p> - - - <p> - <strong>Windows Note:</strong>When the modern compiler is used -in unforked mode on Windows, it locks up the files present in the -classpath of the <javac> task, and does not release them. The side -effect of this is that you will not be able to delete or move -those files later on in the build. The workaround is to fork when -invoking the compiler. - </p> - - - </description> - - - <section anchor="examples" name="Examples"> - - <pre> <javac srcdir="${src}" - destdir="${build}" - classpath="xyz.jar" - debug="on" - /></pre> - - <p>compiles all - <code>.java</code> files under the - <code>${src}</code> -directory, and stores -the - <code>.class</code> files in the - <code>${build}</code> directory. -The classpath used contains - <code>xyz.jar</code>, and debug information is on. - </p> - - - <pre> <javac srcdir="${src}" - destdir="${build}" - fork="true" - /></pre> - - <p>compiles all - <code>.java</code> files under the - <code>${src}</code> -directory, and stores the - <code>.class</code> files in the - - <code>${build}</code> directory. This will fork off the javac -compiler using the default javac executable. - </p> - - - <pre> <javac srcdir="${src}" - destdir="${build}" - fork="java$$javac.exe" - /></pre> - - <p>compiles all - <code>.java</code> files under the - <code>${src}</code> -directory, and stores the - <code>.class</code> files in the - - <code>${build}</code> directory. This will fork off the javac -compiler using the executable named - <code>java$javac.exe</code>. Note -that the - <code>$</code> sign needs to be escaped by a second one. - </p> - - - <pre> <javac srcdir="${src}" - destdir="${build}" - includes="mypackage/p1/**,mypackage/p2/**" - excludes="mypackage/p1/testpackage/**" - classpath="xyz.jar" - debug="on" - /></pre> - - <p>compiles - <code>.java</code> files under the - <code>${src}</code> -directory, and stores the - - <code>.class</code> files in the - <code>${build}</code> directory. -The classpath used contains - <code>xyz.jar</code>, and debug information is on. -Only files under - <code>mypackage/p1</code> and - <code>mypackage/p2</code> are -used. Files in the - <code>mypackage/p1/testpackage</code> directory are excluded -from compilation. - </p> - - - <pre> <javac srcdir="${src}:${src2}" - destdir="${build}" - includes="mypackage/p1/**,mypackage/p2/**" - excludes="mypackage/p1/testpackage/**" - classpath="xyz.jar" - debug="on" - /></pre> - - - <p>is the same as the previous example, with the addition of a second -source path, defined by -the property - <code>src2</code>. This can also be represented using nested - - <code><src></code> elements as follows: - </p> - - - <pre> <javac destdir="${build}" - classpath="xyz.jar" - debug="on"> - <src path="${src}"/> - <src path="${src2}"/> - <include name="mypackage/p1/**"/> - <include name="mypackage/p2/**"/> - <exclude name="mypackage/p1/testpackage/**"/> - </javac></pre> - - - <p> - <b>Note:</b> If you are using Ant on Windows and a new DOS window pops up -for every use of an external compiler, this may be a problem of the JDK you are using. -This problem may occur with all JDKs < 1.2. - </p> - - - <p> - <b>Note:</b> If you wish to compile only source-files located in some packages below a -common root you should not include these packages in the srcdir-attribute. Use include/exclude-attributes -or elements to filter for these packages. If you include part of your package-structure inside the srcdir-attribute -(or nested src-elements) Ant will start to recompile your sources every time you call it. - </p> - - - </section> - - - <section anchor="jikes" name="Jikes Notes"> - - - <p>Jikes supports some extra options, which can be set be defining -properties prior to invoking the task. The ant developers are aware that -this is ugly and inflexible -expect a better solution in the future. All -the options are boolean, and must be set to "true" or "yes" to be -interpreted as anything other than false; by default -build.compiler.warnings is "true" while all others are "false"</p> - - - <table border="1" cellpadding="2" cellspacing="0"> - - <tr> - - <td valign="top"> - build.compiler.emacs - </td> - - <td valign="top"> - Enable emacs compatible error messages - </td> - - </tr> - - <tr> - - <td valign="top"> - build.compiler.warnings - <br /> - - <b>This property has been deprecated, use the nowarn attribute - instead</b> - - </td> - - <td valign="top"> - don't disable warning messages - </td> - - </tr> - - <tr> - - <td valign="top"> - build.compiler.pedantic - </td> - - <td valign="top"> - enable pedantic warnings - </td> - - </tr> - - <tr> - - <td valign="top"> - build.compiler.fulldepend - </td> - - <td valign="top"> - enable full dependency checking, - <br /> - "+F" in the jikes manual. - - </td> - - </tr> - - </table> - - - </section> - - </external> - - - <short-description>Compiles Java source files.</short-description> - - <description> - Compiles Java source files. This task can take the following - arguments: - <ul> - <li>sourcedir - <li>destdir - <li>deprecation - <li>classpath - <li>bootclasspath - <li>extdirs - <li>optimize - <li>debug - <li>encoding - <li>target - <li>depend - <li>vebose - <li>failonerror - <li>includeantruntime - <li>includejavaruntime - <li>source - <li>compiler - </ul> - Of these arguments, the <b>sourcedir</b> and <b>destdir</b> are required. - <p> - When this task executes, it will recursively scan the sourcedir and - destdir looking for Java source files to compile. This task makes its - compile decision based on timestamp. - </description> - - - <structure> - - - <attributes> - - <attribute name="bootclasspathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="bootclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Bootclasspath that will be used to compile the classes - against.</short-description> - - <description> - Sets the bootclasspath that will be used to compile the classes - against. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="compiler" type="java.lang.String" briefType="String" required="no"> - - <short-description>Choose the implementation for this particular task.</short-description> - - <description> - Choose the implementation for this particular task. - </description> - - </attribute> - - <attribute name="debug" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicates whether source should be compiled - with debug information; defaults to off.</short-description> - - <description> - Indicates whether source should be compiled - with debug information; defaults to off. - </description> - - </attribute> - - <attribute name="debuglevel" type="java.lang.String" briefType="String" required="no"> - - <short-description>Keyword list to be appended to the -g command-line switch.</short-description> - - <description> - Keyword list to be appended to the -g command-line switch. - - This will be ignored by all implementations except modern - and classic(ver >= 1.2). Legal values are none or a - comma-separated list of the following keywords: lines, vars, - and source. If debuglevel is not specified, by default, :none - will be appended to -g. If debug is not turned on, this attribute - will be ignored. - </description> - - </attribute> - - <attribute name="depend" type="boolean" briefType="boolean" required="no"> - - <short-description>Enables dependency-tracking for compilers - that support this (jikes and classic).</short-description> - - <description> - Enables dependency-tracking for compilers - that support this (jikes and classic). - </description> - - </attribute> - - <attribute name="deprecation" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicates whether source should be - compiled with deprecation information; defaults to off.</short-description> - - <description> - Indicates whether source should be - compiled with deprecation information; defaults to off. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="no"> - - <short-description>Destination directory into which the Java source - files should be compiled.</short-description> - - <description> - Set the destination directory into which the Java source - files should be compiled. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Java source file encoding name.</short-description> - - <description> - Set the Java source file encoding name. - </description> - - </attribute> - - <attribute name="executable" type="java.lang.String" briefType="String" required="no"> - - <short-description>The name of the javac executable.</short-description> - - <description> - Sets the the name of the javac executable. - - <p>Ignored unless fork is true or extJavac has been specified - as the compiler.</p> - </description> - - </attribute> - - <attribute name="extdirs" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Extension directories that will be used during the - compilation.</short-description> - - <description> - Sets the extension directories that will be used during the - compilation. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicates whether the build will continue - even if there are compilation errors; defaults to true.</short-description> - - <description> - Indicates whether the build will continue - even if there are compilation errors; defaults to true. - </description> - - </attribute> - - <attribute name="fork" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, forks the javac compiler.</short-description> - - <description> - If true, forks the javac compiler. - </description> - - </attribute> - - <attribute name="includeantruntime" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, includes Ant's own classpath in the classpath.</short-description> - - <description> - If true, includes Ant's own classpath in the classpath. - </description> - - </attribute> - - <attribute name="includejavaruntime" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, includes the Java runtime libraries in the classpath.</short-description> - - <description> - If true, includes the Java runtime libraries in the classpath. - </description> - - </attribute> - - <attribute name="listfiles" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, list the source files being handed off to the compiler.</short-description> - - <description> - If true, list the source files being handed off to the compiler. - </description> - - </attribute> - - <attribute name="memoryinitialsize" type="java.lang.String" briefType="String" required="no"> - - <short-description>The initial size of the memory for the underlying VM - if javac is run externally; ignored otherwise.</short-description> - - <description> - The initial size of the memory for the underlying VM - if javac is run externally; ignored otherwise. - Defaults to the standard VM memory setting. - (Examples: 83886080, 81920k, or 80m) - </description> - - </attribute> - - <attribute name="memorymaximumsize" type="java.lang.String" briefType="String" required="no"> - - <short-description>The maximum size of the memory for the underlying VM - if javac is run externally; ignored otherwise.</short-description> - - <description> - The maximum size of the memory for the underlying VM - if javac is run externally; ignored otherwise. - Defaults to the standard VM memory setting. - (Examples: 83886080, 81920k, or 80m) - </description> - - </attribute> - - <attribute name="nowarn" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, enables the -nowarn option.</short-description> - - <description> - If true, enables the -nowarn option. - </description> - - </attribute> - - <attribute name="optimize" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, compiles with optimization enabled.</short-description> - - <description> - If true, compiles with optimization enabled. - </description> - - </attribute> - - <attribute name="source" type="java.lang.String" briefType="String" required="no"> - - <short-description>Value of the -source command-line switch; will be ignored - by all implementations except modern and jikes.</short-description> - - <description> - Value of the -source command-line switch; will be ignored - by all implementations except modern and jikes. - - If you use this attribute together with jikes, you must - make sure that your version of jikes supports the -source switch. - Legal values are 1.3 and 1.4 - by default, no -source argument - will be used at all. - </description> - - </attribute> - - <attribute name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Sourcepath to be used for this compilation.</short-description> - - <description> - Set the sourcepath to be used for this compilation. - </description> - - </attribute> - - <attribute name="sourcepathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a source path defined elsewhere.</short-description> - - <description> - Adds a reference to a source path defined elsewhere. - </description> - - </attribute> - - <attribute name="srcdir" type="org.apache.tools.ant.types.Path" briefType="Path" required="yes, unless nested <src> elements are present."> - - <short-description>Source directories to find the source Java files.</short-description> - - <description> - Set the source directories to find the source Java files. - </description> - - </attribute> - - <attribute name="target" type="java.lang.String" briefType="String" required="no"> - - <short-description>Target VM that the classes will be compiled for.</short-description> - - <description> - Sets the target VM that the classes will be compiled for. Valid - strings are "1.1", "1.2", and "1.3". - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, asks the compiler for verbose output.</short-description> - - <description> - If true, asks the compiler for verbose output. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="bootclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to the bootclasspath.</short-description> - - <description> - Adds a path to the bootclasspath. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to the classpath.</short-description> - - <description> - Adds a path to the classpath. - </description> - - </element> - - - <element name="compilerarg" type="org.apache.tools.ant.taskdefs.Javac.ImplementationSpecificArgument" briefType="" required="NOTDEFINED"> - - <short-description>Adds an implementation specific command-line argument.</short-description> - - <description> - Adds an implementation specific command-line argument. - </description> - - </element> - - - <element name="extdirs" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to extdirs.</short-description> - - <description> - Adds a path to extdirs. - </description> - - </element> - - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to sourcepath.</short-description> - - <description> - Adds a path to sourcepath. - </description> - - </element> - - - <element name="src" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path for source compilation.</short-description> - - <description> - Adds a path for source compilation. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="javacc" category="other" classname="org.apache.tools.ant.taskdefs.optional.javacc.JavaCC"> - - - <short-description>JavaCC compiler compiler task.</short-description> - - <description> - JavaCC compiler compiler task. - </description> - - - <structure> - - - <attributes> - - <attribute name="buildparser" type="boolean" briefType="boolean" required="no"> - - <short-description>BUILD_PARSER grammar option.</short-description> - - <description> - Sets the BUILD_PARSER grammar option. - </description> - - </attribute> - - <attribute name="buildtokenmanager" type="boolean" briefType="boolean" required="no"> - - <short-description>BUILD_TOKEN_MANAGER grammar option.</short-description> - - <description> - Sets the BUILD_TOKEN_MANAGER grammar option. - </description> - - </attribute> - - <attribute name="cachetokens" type="boolean" briefType="boolean" required="no"> - - <short-description>CACHE_TOKENS grammar option.</short-description> - - <description> - Sets the CACHE_TOKENS grammar option. - </description> - - </attribute> - - <attribute name="choiceambiguitycheck" type="int" briefType="int" required="no"> - - <short-description>CHOICE_AMBIGUITY_CHECK grammar option.</short-description> - - <description> - Sets the CHOICE_AMBIGUITY_CHECK grammar option. - </description> - - </attribute> - - <attribute name="commontokenaction" type="boolean" briefType="boolean" required="no"> - - <short-description>COMMON_TOKEN_ACTION grammar option.</short-description> - - <description> - Sets the COMMON_TOKEN_ACTION grammar option. - </description> - - </attribute> - - <attribute name="debuglookahead" type="boolean" briefType="boolean" required="no"> - - <short-description>DEBUG_LOOKAHEAD grammar option.</short-description> - - <description> - Sets the DEBUG_LOOKAHEAD grammar option. - </description> - - </attribute> - - <attribute name="debugparser" type="boolean" briefType="boolean" required="no"> - - <short-description>DEBUG_PARSER grammar option.</short-description> - - <description> - Sets the DEBUG_PARSER grammar option. - </description> - - </attribute> - - <attribute name="debugtokenmanager" type="boolean" briefType="boolean" required="no"> - - <short-description>DEBUG_TOKEN_MANAGER grammar option.</short-description> - - <description> - Sets the DEBUG_TOKEN_MANAGER grammar option. - </description> - - </attribute> - - <attribute name="errorreporting" type="boolean" briefType="boolean" required="no"> - - <short-description>ERROR_REPORTING grammar option.</short-description> - - <description> - Sets the ERROR_REPORTING grammar option. - </description> - - </attribute> - - <attribute name="forcelacheck" type="boolean" briefType="boolean" required="no"> - - <short-description>FORCE_LA_CHECK grammar option.</short-description> - - <description> - Sets the FORCE_LA_CHECK grammar option. - </description> - - </attribute> - - <attribute name="ignorecase" type="boolean" briefType="boolean" required="no"> - - <short-description>IGNORE_CASE grammar option.</short-description> - - <description> - Sets the IGNORE_CASE grammar option. - </description> - - </attribute> - - <attribute name="javacchome" type="java.io.File" briefType="File" required="yes"> - - <short-description>The directory containing the JavaCC distribution.</short-description> - - <description> - The directory containing the JavaCC distribution. - </description> - - </attribute> - - <attribute name="javaunicodeescape" type="boolean" briefType="boolean" required="no"> - - <short-description>JAVA_UNICODE_ESCAPE grammar option.</short-description> - - <description> - Sets the JAVA_UNICODE_ESCAPE grammar option. - </description> - - </attribute> - - <attribute name="lookahead" type="int" briefType="int" required="no"> - - <short-description>LOOKAHEAD grammar option.</short-description> - - <description> - Sets the LOOKAHEAD grammar option. - </description> - - </attribute> - - <attribute name="optimizetokenmanager" type="boolean" briefType="boolean" required="no"> - - <short-description>OPTIMIZE_TOKEN_MANAGER grammar option.</short-description> - - <description> - Sets the OPTIMIZE_TOKEN_MANAGER grammar option. - </description> - - </attribute> - - <attribute name="otherambiguitycheck" type="int" briefType="int" required="no"> - - <short-description>OTHER_AMBIGUITY_CHECK grammar option.</short-description> - - <description> - Sets the OTHER_AMBIGUITY_CHECK grammar option. - </description> - - </attribute> - - <attribute name="outputdirectory" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory to write the generated files to.</short-description> - - <description> - The directory to write the generated files to. - If not set, the files are written to the directory - containing the grammar file. - </description> - - </attribute> - - <attribute name="sanitycheck" type="boolean" briefType="boolean" required="no"> - - <short-description>SANITY_CHECK grammar option.</short-description> - - <description> - Sets the SANITY_CHECK grammar option. - </description> - - </attribute> - - <attribute name="static" type="boolean" briefType="boolean" required="no"> - - <short-description>STATIC grammar option.</short-description> - - <description> - Sets the STATIC grammar option. - </description> - - </attribute> - - <attribute name="target" type="java.io.File" briefType="File" required="yes"> - - <short-description>The grammar file to process.</short-description> - - <description> - The grammar file to process. - </description> - - </attribute> - - <attribute name="unicodeinput" type="boolean" briefType="boolean" required="no"> - - <short-description>UNICODE_INPUT grammar option.</short-description> - - <description> - Sets the UNICODE_INPUT grammar option. - </description> - - </attribute> - - <attribute name="usercharstream" type="boolean" briefType="boolean" required="no"> - - <short-description>USER_CHAR_STREAM grammar option.</short-description> - - <description> - Sets the USER_CHAR_STREAM grammar option. - </description> - - </attribute> - - <attribute name="usertokenmanager" type="boolean" briefType="boolean" required="no"> - - <short-description>USER_TOKEN_MANAGER grammar option.</short-description> - - <description> - Sets the USER_TOKEN_MANAGER grammar option. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="javadoc" category="java" classname="org.apache.tools.ant.taskdefs.Javadoc"> - - - - <external> - - <description> - - - <p>Generates code documentation using the javadoc tool.</p> - - - <p>The source directory will be recursively scanned for Java source files to process -but only those matching the inclusion rules, and not matching the exclusions rules -will be passed to the javadoc tool. This -allows wildcards to be used to choose between package names, reducing verbosity -and management costs over time. This task, however, has no notion of -"changed" files, unlike the - <a href="javac.html">javac</a> task. This means -all packages will be processed each time this task is run. In general, however, -this task is used much less frequently. - </p> - - - <p>This task works seamlessly between different javadoc versions (1.1 and 1.2), -with the obvious restriction that the 1.2 attributes will be ignored if run in a -1.1 VM.</p> - - - <p>NOTE: since javadoc calls System.exit(), javadoc cannot be run inside the -same VM as ant without breaking functionality. For this reason, this task -always forks the VM. This overhead is not significant since javadoc is normally a heavy -application and will be called infrequently.</p> - - - <p>NOTE: the packagelist attribute allows you to specify the list of packages to -document outside of the Ant file. It's a much better practice to include everything -inside the build.xml file. This option was added in order to make it easier to -migrate from regular makefiles, where you would use this option of javadoc. -The packages listed in packagelist are not checked, so the task performs even -if some packages are missing or broken. Use this option if you wish to convert from -an existing makefile. Once things are running you should then switch to the regular -notation. </p> - - - <p> - <i> - <b>DEPRECATION:</b> the javadoc2 task simply points to the javadoc task and it's -there for back compatibility reasons. Since this task will be removed in future -versions, you are strongly encouraged to use - <a href="javadoc.html">javadoc</a> -instead. - </i> - </p> - - </description> - - - <section anchor="examples" name="Example"> - - <pre> <javadoc packagenames="com.dummy.test.*" - sourcepath="src" - excludepackagenames="com.dummy.test.doc-files.*" - defaultexcludes="yes" - destdir="docs/api" - author="true" - version="true" - use="true" - windowtitle="Test API"> - <doctitle><![CDATA[<h1>Test</h1>]]></doctitle> - <bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom> - <tag name="todo" scope="all" description="To do:" /> - <group title="Group 1 Packages" packages="com.dummy.test.a*"/> - <group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> - <link offline="true" href="http://java.sun.com/products/jdk/1.2/docs/api/" packagelistLoc="C:\tmp"/> - <link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> - </javadoc></pre> - - </section> - - </external> - - - <short-description>Generates Javadoc documentation for a collection of source code.</short-description> - - <description> - Generates Javadoc documentation for a collection - of source code. - - <P>Current known limitations are: - - <P><UL> - <LI>patterns must be of the form "xxx.*", every other pattern doesn't - work. - <LI>there is no control on arguments sanity since they are left - to the javadoc implementation. - <LI>argument J in javadoc1 is not supported (what is that for anyway?) - </UL> - - <P>If no <CODE>doclet</CODE> is set, then the <CODE>version</CODE> and - <CODE>author</CODE> are by default <CODE>"yes"</CODE>. - - <P>Note: This task is run on another VM because the Javadoc code calls - <CODE>System.exit()</CODE> which would break Ant functionality. - </description> - - - <structure> - - - <attributes> - - <attribute name="access" type="org.apache.tools.ant.taskdefs.Javadoc.AccessType" briefType=""protected", "public", "package", "private"" required="no (default protected)"> - - <short-description>Scope to be processed.</short-description> - - <description> - Set the scope to be processed. This is an alternative to the - use of the setPublic, setPrivate, etc methods. It gives better build - file control over what scope is processed. - </description> - - </attribute> - - <attribute name="additionalparam" type="java.lang.String" briefType="String" required="no"> - - <short-description>Set an additional parameter on the command line.</short-description> - - <description> - Set an additional parameter on the command line - </description> - - </attribute> - - <attribute name="author" type="boolean" briefType="boolean" required="no"> - - <short-description>Include the author tag in the generated documentation.</short-description> - - <description> - Include the author tag in the generated documentation. - </description> - - </attribute> - - <attribute name="bootclasspathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a CLASSPATH defined elsewhere.</short-description> - - <description> - Adds a reference to a CLASSPATH defined elsewhere. - </description> - - </attribute> - - <attribute name="bootclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Boot classpath to use.</short-description> - - <description> - Set the boot classpath to use. - </description> - - </attribute> - - <attribute name="bottom" type="java.lang.String" briefType="String" required="no"> - - <short-description>Text to be placed at the bottom of each output file.</short-description> - - <description> - Set the text to be placed at the bottom of each output file. - </description> - - </attribute> - - <attribute name="charset" type="java.lang.String" briefType="String" required="no"> - - <short-description>Charset for cross-platform viewing of generated documentation.</short-description> - - <description> - Charset for cross-platform viewing of generated documentation. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used for this javadoc run.</short-description> - - <description> - Set the classpath to be used for this javadoc run. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a CLASSPATH defined elsewhere.</short-description> - - <description> - Adds a reference to a CLASSPATH defined elsewhere. - </description> - - </attribute> - - <attribute name="defaultexcludes" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether default exclusions should be used or not.</short-description> - - <description> - Sets whether default exclusions should be used or not. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="yes, unless a doclet has been specified."> - - <short-description>Directory where the Javadoc output will be generated.</short-description> - - <description> - Set the directory where the Javadoc output will be generated. - </description> - - </attribute> - - <attribute name="docencoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Output file encoding name.</short-description> - - <description> - Output file encoding name. - </description> - - </attribute> - - <attribute name="doclet" type="java.lang.String" briefType="String" required="no"> - - <short-description>Class that starts the doclet used in generating the - documentation.</short-description> - - <description> - Set the class that starts the doclet used in generating the - documentation. - </description> - - </attribute> - - <attribute name="docletpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath used to find the doclet class.</short-description> - - <description> - Set the classpath used to find the doclet class. - </description> - - </attribute> - - <attribute name="docletpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Classpath used to find the doclet class by reference.</short-description> - - <description> - Set the classpath used to find the doclet class by reference. - </description> - - </attribute> - - <attribute name="doctitle" type="java.lang.String" briefType="String" required="no"> - - <short-description>Title of the generated overview page.</short-description> - - <description> - Set the title of the generated overview page. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding name of the source files,.</short-description> - - <description> - Set the encoding name of the source files, - </description> - - </attribute> - - <attribute name="excludepackagenames" type="java.lang.String" briefType="String" required="no"> - - <short-description>List of packages to be excluded.</short-description> - - <description> - Set the list of packages to be excluded. - </description> - - </attribute> - - <attribute name="extdirs" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Location of the extensions directories.</short-description> - - <description> - Set the location of the extensions directories. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Should the build process fail if javadoc fails (as indicated by - a non zero return code)?.</short-description> - - <description> - Should the build process fail if javadoc fails (as indicated by - a non zero return code)? - - <p>Default is false.</p> - </description> - - </attribute> - - <attribute name="footer" type="java.lang.String" briefType="String" required="no"> - - <short-description>Footer text to be placed at the bottom of each output file.</short-description> - - <description> - Set the footer text to be placed at the bottom of each output file. - </description> - - </attribute> - - <attribute name="group" type="java.lang.String" briefType="String" required="no"> - - <short-description>Group specified packages together in overview page.</short-description> - - <description> - Group specified packages together in overview page. - </description> - - </attribute> - - <attribute name="header" type="java.lang.String" briefType="String" required="no"> - - <short-description>Header text to be placed at the top of each output file.</short-description> - - <description> - Set the header text to be placed at the top of each output file. - </description> - - </attribute> - - <attribute name="helpfile" type="java.io.File" briefType="File" required="no"> - - <short-description>Specifies the HTML help file to use.</short-description> - - <description> - Specifies the HTML help file to use. - </description> - - </attribute> - - <attribute name="link" type="java.lang.String" briefType="String" required="no"> - - <short-description>Create links to javadoc output at the given URL.</short-description> - - <description> - Create links to javadoc output at the given URL. - </description> - - </attribute> - - <attribute name="linkoffline" type="java.lang.String" briefType="String" required="no"> - - <short-description>Link to docs at "url" using package list at "url2" - - separate the URLs by using a space character.</short-description> - - <description> - Link to docs at "url" using package list at "url2" - - separate the URLs by using a space character. - </description> - - </attribute> - - <attribute name="locale" type="java.lang.String" briefType="String" required="no"> - - <short-description>Local to use in documentation generation.</short-description> - - <description> - Set the local to use in documentation generation. - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="no"> - - <short-description>Maximum memory to be used by the javadoc process.</short-description> - - <description> - Set the maximum memory to be used by the javadoc process - </description> - - </attribute> - - <attribute name="nodeprecated" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, do not include @deprecated information.</short-description> - - <description> - If true, do not include @deprecated information. - </description> - - </attribute> - - <attribute name="nodeprecatedlist" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, do not generate deprecated list.</short-description> - - <description> - If true, do not generate deprecated list. - </description> - - </attribute> - - <attribute name="nohelp" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, do not generate help link.</short-description> - - <description> - If true, do not generate help link - </description> - - </attribute> - - <attribute name="noindex" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, do not generate index.</short-description> - - <description> - If true, do not generate index. - </description> - - </attribute> - - <attribute name="nonavbar" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, do not generate navigation bar.</short-description> - - <description> - If true, do not generate navigation bar. - </description> - - </attribute> - - <attribute name="notree" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, do not generate class hierarchy.</short-description> - - <description> - If true, do not generate class hierarchy. - </description> - - </attribute> - - <attribute name="old" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicate whether Javadoc should produce old style (JDK 1.1) - documentation.</short-description> - - <description> - Indicate whether Javadoc should produce old style (JDK 1.1) - documentation. - - This is not supported by JDK 1.1 and has been phased out in JDK 1.4 - </description> - - </attribute> - - <attribute name="overview" type="java.io.File" briefType="File" required="no"> - - <short-description>Specify the file containing the overview to be included in the generated - documentation.</short-description> - - <description> - Specify the file containing the overview to be included in the generated - documentation. - </description> - - </attribute> - - <attribute name="package" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicate whether only package, protected and public classes and - members are to be included in the scope processed.</short-description> - - <description> - Indicate whether only package, protected and public classes and - members are to be included in the scope processed - </description> - - </attribute> - - <attribute name="packagelist" type="java.lang.String" briefType="String" required="no"> - - <short-description>The name of a file containing the packages to process.</short-description> - - <description> - The name of a file containing the packages to process. - </description> - - </attribute> - - <attribute name="packagenames" type="java.lang.String" briefType="String" required="no"> - - <short-description>Package names to be processed.</short-description> - - <description> - Set the package names to be processed. - </description> - - </attribute> - - <attribute name="private" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicate whether all classes and - members are to be included in the scope processed.</short-description> - - <description> - Indicate whether all classes and - members are to be included in the scope processed - </description> - - </attribute> - - <attribute name="protected" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicate whether only protected and public classes and members are to - be included in the scope processed.</short-description> - - <description> - Indicate whether only protected and public classes and members are to - be included in the scope processed - </description> - - </attribute> - - <attribute name="public" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicate whether only public classes and members are to be included in - the scope processed.</short-description> - - <description> - Indicate whether only public classes and members are to be included in - the scope processed - </description> - - </attribute> - - <attribute name="serialwarn" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, generate warning about @serial tag.</short-description> - - <description> - If true, generate warning about @serial tag. - </description> - - </attribute> - - <attribute name="source" type="java.lang.String" briefType="String" required="no"> - - <short-description>Enables the -source switch, will be ignored if javadoc is not - the 1.4 version or a different doclet than the standard doclet - is used.</short-description> - - <description> - Enables the -source switch, will be ignored if javadoc is not - the 1.4 version or a different doclet than the standard doclet - is used. - </description> - - </attribute> - - <attribute name="sourcefiles" type="java.lang.String" briefType="String" required=""> - - <short-description>List of source files to process.</short-description> - - <description> - Set the list of source files to process. - </description> - - </attribute> - - <attribute name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="at least one of the three or nested <sourcepath>, <fileset> or <packageset>"> - - <short-description>Specify where to find source file.</short-description> - - <description> - Specify where to find source file - </description> - - </attribute> - - <attribute name="sourcepathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required=""> - - <short-description>Adds a reference to a CLASSPATH defined elsewhere.</short-description> - - <description> - Adds a reference to a CLASSPATH defined elsewhere. - </description> - - </attribute> - - <attribute name="splitindex" type="boolean" briefType="boolean" required="no"> - - <short-description>Generate a split index.</short-description> - - <description> - Generate a split index - </description> - - </attribute> - - <attribute name="stylesheetfile" type="java.io.File" briefType="File" required="no"> - - <short-description>Specifies the CSS stylesheet file to use.</short-description> - - <description> - Specifies the CSS stylesheet file to use. - </description> - - </attribute> - - <attribute name="use" type="boolean" briefType="boolean" required="no"> - - <short-description>Generate the &quot;use&quot page for each package.</short-description> - - <description> - Generate the &quot;use&quot page for each package. - </description> - - </attribute> - - <attribute name="useexternalfile" type="boolean" briefType="boolean" required="no"> - - <short-description>Work around command line length limit by using an external file - for the sourcefiles.</short-description> - - <description> - Work around command line length limit by using an external file - for the sourcefiles. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>Run javadoc in verbose mode.</short-description> - - <description> - Run javadoc in verbose mode - </description> - - </attribute> - - <attribute name="version" type="boolean" briefType="boolean" required="no"> - - <short-description>Include the version tag in the generated documentation.</short-description> - - <description> - Include the version tag in the generated documentation. - </description> - - </attribute> - - <attribute name="windowtitle" type="java.lang.String" briefType="String" required="no"> - - <short-description>Title to be placed in the HTML &lt;title&gt; tag of the - generated documentation.</short-description> - - <description> - Set the title to be placed in the HTML &lt;title&gt; tag of the - generated documentation. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="bottom" type="org.apache.tools.ant.taskdefs.Javadoc.Html" briefType="" required="NOTDEFINED"> - - <short-description>Text to be placed at the bottom of each output file.</short-description> - - <description> - Set the text to be placed at the bottom of each output file. - </description> - - </element> - - - <element name="doctitle" type="org.apache.tools.ant.taskdefs.Javadoc.Html" briefType="" required="NOTDEFINED"> - - <short-description>Add a document title to use for the overview page.</short-description> - - <description> - Add a document title to use for the overview page. - </description> - - </element> - - - <element name="excludepackage" type="org.apache.tools.ant.taskdefs.Javadoc.PackageName" briefType="" required="NOTDEFINED"> - - <short-description>Add a package to be excluded from the javadoc run.</short-description> - - <description> - Add a package to be excluded from the javadoc run. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a fileset.</short-description> - - <description> - Adds a fileset. - - <p>All included files will be added as sourcefiles. The task - will automatically add - <code>includes=&quot;**&#47;*.java&quot;</code> to the - fileset.</p> - </description> - - </element> - - - <element name="footer" type="org.apache.tools.ant.taskdefs.Javadoc.Html" briefType="" required="NOTDEFINED"> - - <short-description>Footer text to be placed at the bottom of each output file.</short-description> - - <description> - Set the footer text to be placed at the bottom of each output file. - </description> - - </element> - - - <element name="header" type="org.apache.tools.ant.taskdefs.Javadoc.Html" briefType="" required="NOTDEFINED"> - - <short-description>Header text to be placed at the top of each output file.</short-description> - - <description> - Set the header text to be placed at the top of each output file. - </description> - - </element> - - - <element name="package" type="org.apache.tools.ant.taskdefs.Javadoc.PackageName" briefType="" required="NOTDEFINED"> - - <short-description>Add a single package to be processed.</short-description> - - <description> - Add a single package to be processed. - - If the package name ends with &quot;.*&quot; the Javadoc task - will find and process all subpackages. - </description> - - </element> - - - <element name="packageset" type="org.apache.tools.ant.types.DirSet" briefType="Dirset" required="NOTDEFINED"> - - <short-description>Adds a packageset.</short-description> - - <description> - Adds a packageset. - - <p>All included directories will be translated into package - names be converting the directory separator into dots.</p> - </description> - - </element> - - - <element name="source" type="org.apache.tools.ant.taskdefs.Javadoc.SourceFile" briefType="" required="NOTDEFINED"> - - <short-description>Add a single source file.</short-description> - - <description> - Add a single source file. - </description> - - </element> - - - <element name="taglet" type="org.apache.tools.ant.taskdefs.Javadoc.ExtensionInfo" briefType="" required="NOTDEFINED"> - - <short-description>Add a taglet.</short-description> - - <description> - Add a taglet - </description> - - </element> - - - <element name="bootclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create a Path to be configured with the boot classpath.</short-description> - - <description> - Create a Path to be configured with the boot classpath - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create a Path to be configured with the classpath to use.</short-description> - - <description> - Create a Path to be configured with the classpath to use - </description> - - </element> - - - <element name="doclet" type="org.apache.tools.ant.taskdefs.Javadoc.DocletInfo" briefType="" required="NOTDEFINED"> - - <short-description>Create a doclet to be used in the documentation generation.</short-description> - - <description> - Create a doclet to be used in the documentation generation. - </description> - - </element> - - - <element name="group" type="org.apache.tools.ant.taskdefs.Javadoc.GroupArgument" briefType="" required="NOTDEFINED"> - - <short-description>Separates packages on the overview page into whatever - groups you specify, one group per table.</short-description> - - <description> - Separates packages on the overview page into whatever - groups you specify, one group per table. - </description> - - </element> - - - <element name="link" type="org.apache.tools.ant.taskdefs.Javadoc.LinkArgument" briefType="" required="NOTDEFINED"> - - <short-description>Create link to javadoc output at the given URL.</short-description> - - <description> - Create link to javadoc output at the given URL. - </description> - - </element> - - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create a path to be configured with the locations of the source - files.</short-description> - - <description> - Create a path to be configured with the locations of the source - files. - </description> - - </element> - - - <element name="tag" type="org.apache.tools.ant.taskdefs.Javadoc.TagArgument" briefType="" required="NOTDEFINED"> - - <short-description>Creates and adds a -tag argument.</short-description> - - <description> - Creates and adds a -tag argument. This is used to specify - custom tags. This argument is only available for JavaDoc 1.4, - and will generate a verbose message (and then be ignored) - when run on Java versions below 1.4. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="javah" category="other" classname="org.apache.tools.ant.taskdefs.optional.Javah"> - - - <short-description>Generates JNI header files using javah.</short-description> - - <description> - Generates JNI header files using javah. - - This task can take the following arguments: - <ul> - <li>classname - the fully-qualified name of a class</li> - <li>outputFile - Concatenates the resulting header or source files for all - the classes listed into this file</li> - <li>destdir - Sets the directory where javah saves the header files or the - stub files</li> - <li>classpath</li> - <li>bootclasspath</li> - <li>force - Specifies that output files should always be written -(JDK1.2 only)</li> - <li>old - Specifies that old JDK1.0-style header files should be generated - (otherwise output file contain JNI-style native method - function prototypes) (JDK1.2 only)</li> - <li>stubs - generate C declarations from the Java object file (used with old)</li> - <li>verbose - causes javah to print a message to stdout concerning the status - of the generated files</li> - <li>extdirs - Override location of installed extensions</li> - </ul> - Of these arguments, either <b>outputFile</b> or <b>destdir</b> is required, - but not both. More than one classname may be specified, using a comma-separated - list or by using <code>&lt;class name="xxx"&gt;</code> elements within the task. - <p> - When this task executes, it will generate C header and source files that - are needed to implement native methods. - </description> - - - <structure> - - - <attributes> - - <attribute name="bootclasspathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="bootclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Location of bootstrap class files.</short-description> - - <description> - location of bootstrap class files. - </description> - - </attribute> - - <attribute name="class" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The fully-qualified name of the class (or classes, separated by commas).</short-description> - - <description> - the fully-qualified name of the class (or classes, separated by commas). - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>The classpath to use.</short-description> - - <description> - the classpath to use. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required=""> - - <short-description>Destination directory into which the Java source - files should be compiled.</short-description> - - <description> - Set the destination directory into which the Java source - files should be compiled. - </description> - - </attribute> - - <attribute name="force" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, output files should always be written (JDK1.2 only).</short-description> - - <description> - If true, output files should always be written (JDK1.2 only). - </description> - - </attribute> - - <attribute name="old" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, specifies that old JDK1.0-style header files should be - generated. - (otherwise output file contain JNI-style native method function prototypes) (JDK1.2 only).</short-description> - - <description> - If true, specifies that old JDK1.0-style header files should be - generated. - (otherwise output file contain JNI-style native method function prototypes) (JDK1.2 only) - </description> - - </attribute> - - <attribute name="outputfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>Concatenates the resulting header or source files for all - the classes listed into this file.</short-description> - - <description> - Concatenates the resulting header or source files for all - the classes listed into this file. - </description> - - </attribute> - - <attribute name="stubs" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, generate C declarations from the Java object file (used with old).</short-description> - - <description> - If true, generate C declarations from the Java object file (used with old). - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, causes Javah to print a message concerning - the status of the generated files.</short-description> - - <description> - If true, causes Javah to print a message concerning - the status of the generated files. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="bootclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds path to bootstrap class files.</short-description> - - <description> - Adds path to bootstrap class files. - </description> - - </element> - - - <element name="class" type="org.apache.tools.ant.taskdefs.optional.Javah.ClassArgument" briefType="" required="NOTDEFINED"> - - <short-description>Adds class to process.</short-description> - - <description> - Adds class to process. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Path to use for classpath.</short-description> - - <description> - Path to use for classpath. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jdepend" category="other" classname="org.apache.tools.ant.taskdefs.optional.jdepend.JDependTask"> - - - <short-description>Runs JDepend tests.</short-description> - - <description> - Runs JDepend tests. - - <p>JDepend is a tool to generate design quality metrics for each Java package. - It has been initially created by Mike Clark. JDepend can be found at <a - href="http://www.clarkware.com/software/JDepend.html">http://www.clarkware.com/software/JDepend.html</a>. - - The current implementation spawn a new Java VM. - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory to invoke the VM in.</short-description> - - <description> - The directory to invoke the VM in. Ignored if no JVM is forked. - </description> - - </attribute> - - <attribute name="fork" type="boolean" briefType="boolean" required="no, default is "off""> - - <short-description>If true, forks into a new JVM.</short-description> - - <description> - If true, forks into a new JVM. Default: false. - </description> - - </attribute> - - <attribute name="format" type="org.apache.tools.ant.taskdefs.optional.jdepend.JDependTask.FormatAttribute" briefType=""xml", "text"" required="no"> - - <short-description>The format to write the output in, "xml" or "text".</short-description> - - <description> - The format to write the output in, "xml" or "text". - </description> - - </attribute> - - <attribute name="haltonerror" type="boolean" briefType="boolean" required="no, default is "off""> - - <short-description>Whether or not to halt on failure.</short-description> - - <description> - Whether or not to halt on failure. Default: false. - </description> - - </attribute> - - <attribute name="jvm" type="java.lang.String" briefType="String" required="no, default "java""> - - <short-description>The command used to invoke a forked Java Virtual Machine.</short-description> - - <description> - The command used to invoke a forked Java Virtual Machine. - - Default is <tt>java</tt>. Ignored if no JVM is forked. - </description> - - </attribute> - - <attribute name="outputfile" type="java.io.File" briefType="File" required="no"> - - <short-description>The output file name.</short-description> - - <description> - The output file name. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to the classpath.</short-description> - - <description> - Adds a path to the classpath. - </description> - - </element> - - - <element name="sourcespath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to source code to analyze.</short-description> - - <description> - Adds a path to source code to analyze. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jjtree" category="other" classname="org.apache.tools.ant.taskdefs.optional.javacc.JJTree"> - - - <short-description>Runs the JJTree compiler compiler.</short-description> - - <description> - Runs the JJTree compiler compiler. - </description> - - - <structure> - - - <attributes> - - <attribute name="buildnodefiles" type="boolean" briefType="boolean" required="no"> - - <short-description>BUILD_NODE_FILES grammar option.</short-description> - - <description> - Sets the BUILD_NODE_FILES grammar option. - </description> - - </attribute> - - <attribute name="javacchome" type="java.io.File" briefType="File" required="yes"> - - <short-description>The directory containing the JavaCC distribution.</short-description> - - <description> - The directory containing the JavaCC distribution. - </description> - - </attribute> - - <attribute name="multi" type="boolean" briefType="boolean" required="no"> - - <short-description>MULTI grammar option.</short-description> - - <description> - Sets the MULTI grammar option. - </description> - - </attribute> - - <attribute name="nodedefaultvoid" type="boolean" briefType="boolean" required="no"> - - <short-description>NODE_DEFAULT_VOID grammar option.</short-description> - - <description> - Sets the NODE_DEFAULT_VOID grammar option. - </description> - - </attribute> - - <attribute name="nodefactory" type="boolean" briefType="boolean" required="no"> - - <short-description>NODE_FACTORY grammar option.</short-description> - - <description> - Sets the NODE_FACTORY grammar option. - </description> - - </attribute> - - <attribute name="nodepackage" type="java.lang.String" briefType="String" required="no"> - - <short-description>NODE_PACKAGE grammar option.</short-description> - - <description> - Sets the NODE_PACKAGE grammar option. - </description> - - </attribute> - - <attribute name="nodeprefix" type="java.lang.String" briefType="String" required="no"> - - <short-description>NODE_PREFIX grammar option.</short-description> - - <description> - Sets the NODE_PREFIX grammar option. - </description> - - </attribute> - - <attribute name="nodescopehook" type="boolean" briefType="boolean" required="no"> - - <short-description>NODE_SCOPE_HOOK grammar option.</short-description> - - <description> - Sets the NODE_SCOPE_HOOK grammar option. - </description> - - </attribute> - - <attribute name="nodeusesparser" type="boolean" briefType="boolean" required="no"> - - <short-description>NODE_USES_PARSER grammar option.</short-description> - - <description> - Sets the NODE_USES_PARSER grammar option. - </description> - - </attribute> - - <attribute name="outputdirectory" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory to write the generated file to.</short-description> - - <description> - The directory to write the generated file to. - If not set, the files are written to the directory - containing the grammar file. - </description> - - </attribute> - - <attribute name="static" type="boolean" briefType="boolean" required="no"> - - <short-description>STATIC grammar option.</short-description> - - <description> - Sets the STATIC grammar option. - </description> - - </attribute> - - <attribute name="target" type="java.io.File" briefType="File" required="yes"> - - <short-description>The jjtree grammar file to process.</short-description> - - <description> - The jjtree grammar file to process. - </description> - - </attribute> - - <attribute name="visitor" type="boolean" briefType="boolean" required="no"> - - <short-description>VISITOR grammar option.</short-description> - - <description> - Sets the VISITOR grammar option. - </description> - - </attribute> - - <attribute name="visitorexception" type="java.lang.String" briefType="String" required="no"> - - <short-description>VISITOR_EXCEPTION grammar option.</short-description> - - <description> - Sets the VISITOR_EXCEPTION grammar option. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="jpcoverage" category="metrics" classname="org.apache.tools.ant.taskdefs.optional.sitraka.Coverage"> - - - <short-description>Runs Sitraka JProbe Coverage.</short-description> - - <description> - Runs Sitraka JProbe Coverage. - - Options are pretty numerous, you'd better check the manual for a full - descriptions of options. (not that simple since they differ from the online - help, from the usage command line and from the examples...) - <p> - For additional information, visit <a href="http://www.sitraka.com">www.sitraka.com</a> - </description> - - - <structure> - - - <attributes> - - <attribute name="applet" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, run an applet.</short-description> - - <description> - If true, run an applet. - </description> - - </attribute> - - <attribute name="classname" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Classname to run as standalone or runner for filesets.</short-description> - - <description> - classname to run as standalone or runner for filesets. - </description> - - </attribute> - - <attribute name="exitprompt" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Toggles display of the console prompt: always, error, never.</short-description> - - <description> - Toggles display of the console prompt: always, error, never - </description> - - </attribute> - - <attribute name="finalsnapshot" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Type of snapshot to send at program termination: none, coverage, all.</short-description> - - <description> - Type of snapshot to send at program termination: none, coverage, all. - Can be null, default to none - </description> - - </attribute> - - <attribute name="home" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The directory where JProbe is installed.</short-description> - - <description> - The directory where JProbe is installed. - </description> - - </attribute> - - <attribute name="javaexe" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Path to the java executable.</short-description> - - <description> - Path to the java executable. - </description> - - </attribute> - - <attribute name="recordfromstart" type="org.apache.tools.ant.taskdefs.optional.sitraka.Coverage.Recordfromstart" briefType=""coverage", "none", "all"" required="NOTDEFINED"> - - <short-description>"all", "coverage", or "none".</short-description> - - <description> - "all", "coverage", or "none". - </description> - - </attribute> - - <attribute name="seedname" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Seed name for snapshot file.</short-description> - - <description> - seed name for snapshot file. Can be null, default to snap - </description> - - </attribute> - - <attribute name="snapshotdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The path to the directory where snapshot files are stored.</short-description> - - <description> - The path to the directory where snapshot files are stored. - Choose a directory that is reachable by both the remote - and local computers, and enter the same path on the command-line - and in the viewer. - </description> - - </attribute> - - <attribute name="tracknatives" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, track native methods.</short-description> - - <description> - If true, track native methods. - </description> - - </attribute> - - <attribute name="vm" type="org.apache.tools.ant.taskdefs.optional.sitraka.Coverage.Javavm" briefType=""java2", "jdk118", "jdk117"" required="NOTDEFINED"> - - <short-description>Indicates which virtual machine to run: "jdk117", "jdk118" or "java2".</short-description> - - <description> - Indicates which virtual machine to run: "jdk117", "jdk118" or "java2". - Can be null, default to "java2". - </description> - - </attribute> - - <attribute name="warnlevel" type="java.lang.Integer" briefType="int" required="NOTDEFINED"> - - <short-description>Set warning level (0-3, where 0 is the least amount of warnings).</short-description> - - <description> - Set warning level (0-3, where 0 is the least amount of warnings). - </description> - - </attribute> - - <attribute name="workingdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The physical path to the working directory for the VM.</short-description> - - <description> - The physical path to the working directory for the VM. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>The classnames to execute.</short-description> - - <description> - the classnames to execute. - </description> - - </element> - - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a command argument.</short-description> - - <description> - Adds a command argument. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to run the files.</short-description> - - <description> - classpath to run the files. - </description> - - </element> - - - <element name="filters" type="org.apache.tools.ant.taskdefs.optional.sitraka.Filters" briefType="" required="NOTDEFINED"> - - <short-description>Defines class/method filters based on pattern matching.</short-description> - - <description> - Defines class/method filters based on pattern matching. - The syntax is filters is similar to a fileset. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a JVM argument.</short-description> - - <description> - Adds a JVM argument. - </description> - - </element> - - - <element name="socket" type="org.apache.tools.ant.taskdefs.optional.sitraka.Socket" briefType="" required="NOTDEFINED"> - - <short-description>Define a host and port to connect to if you want to do - remote viewing.</short-description> - - <description> - Define a host and port to connect to if you want to do - remote viewing. - </description> - - </element> - - - <element name="triggers" type="org.apache.tools.ant.taskdefs.optional.sitraka.Triggers" briefType="" required="NOTDEFINED"> - - <short-description>Defines events to use for interacting with the - collection of data performed during coverage.</short-description> - - <description> - Defines events to use for interacting with the - collection of data performed during coverage. - - For example you may run a whole application but only decide - to collect data once it reaches a certain method and once it - exits another one. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jpcovmerge" category="metrics" classname="org.apache.tools.ant.taskdefs.optional.sitraka.CovMerge"> - - - <short-description>Runs the snapshot merge utility for JProbe Coverage.</short-description> - - <description> - Runs the snapshot merge utility for JProbe Coverage. - </description> - - - <structure> - - - <attributes> - - <attribute name="home" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The directory where JProbe is installed.</short-description> - - <description> - The directory where JProbe is installed. - </description> - - </attribute> - - <attribute name="tofile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Output snapshot file.</short-description> - - <description> - Set the output snapshot file. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, perform the merge in verbose mode giving details - about the snapshot processing.</short-description> - - <description> - If true, perform the merge in verbose mode giving details - about the snapshot processing. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a fileset containing the snapshots to include.</short-description> - - <description> - add a fileset containing the snapshots to include. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jpcovreport" category="metrics" classname="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport"> - - - <short-description>Runs the JProbe Coverage 3.0 snapshot merge utility.</short-description> - - <description> - Runs the JProbe Coverage 3.0 snapshot merge utility. - </description> - - - <structure> - - - <attributes> - - <attribute name="format" type="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport.ReportFormat" briefType=""html", "text", "xml"" required="NOTDEFINED"> - - <short-description>Format of the report: "html", "text", or "xml".</short-description> - - <description> - set the format of the report: "html", "text", or "xml" - </description> - - </attribute> - - <attribute name="home" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The directory where JProbe is installed.</short-description> - - <description> - The directory where JProbe is installed. - </description> - - </attribute> - - <attribute name="includesource" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, include text of the source code lines.</short-description> - - <description> - If true, include text of the source code lines. - Only applies to format="xml" and type="verydetailed" - </description> - - </attribute> - - <attribute name="percent" type="java.lang.Integer" briefType="int" required="NOTDEFINED"> - - <short-description>A numeric value for the threshold for printing methods.</short-description> - - <description> - A numeric value for the threshold for printing methods. - Must be between 0 and 100. - </description> - - </attribute> - - <attribute name="snapshot" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The name of the snapshot file that is the source to the report.</short-description> - - <description> - The name of the snapshot file that is the source to the report. - </description> - - </attribute> - - <attribute name="tofile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The name of the generated output file.</short-description> - - <description> - The name of the generated output file. - </description> - - </attribute> - - <attribute name="type" type="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport.ReportType" briefType=""executive", "summary", "detailed", "verydetailed"" required="NOTDEFINED"> - - <short-description>The type of report to be generated: "executive", "summary", - "detailed" or "verydetailed".</short-description> - - <description> - The type of report to be generated: "executive", "summary", - "detailed" or "verydetailed". - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="reference" type="org.apache.tools.ant.taskdefs.optional.sitraka.CovReport.Reference" briefType="" required="NOTDEFINED"> - - <short-description>Adds a set of classes whose coverage information will be - checked against.</short-description> - - <description> - Adds a set of classes whose coverage information will be - checked against. - </description> - - </element> - - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to source files.</short-description> - - <description> - Adds a path to source files. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="jspc" category="other" classname="org.apache.tools.ant.taskdefs.optional.jsp.JspC" matchingTask="true"> - - - <short-description>Runs a JSP compiler.</short-description> - - <description> - Runs a JSP compiler. - - <p> This task takes the given jsp files and compiles them into java - files. It is then up to the user to compile the java files into classes. - - <p> The task requires the srcdir and destdir attributes to be - set. This Task is a MatchingTask, so the files to be compiled can be - specified using includes/excludes attributes or nested include/exclude - elements. Optional attributes are verbose (set the verbosity level passed - to jasper), package (name of the destination package for generated java - classes and classpath (the classpath to use when running the jsp - compiler). - <p> This task supports the nested elements classpath (A Path) and - classpathref (A Reference) which can be used in preference to the - attribute classpath, if the jsp compiler is not already in the ant - classpath. - - <p><h4>Usage</h4> - <pre> - &lt;jspc srcdir="${basedir}/src/war" - destdir="${basedir}/gensrc" - package="com.i3sp.jsp" - verbose="9"&gt; - &lt;include name="**\/*.jsp" /&gt; - &lt;/jspc&gt; - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds a reference to a classpath defined elsewhere.</short-description> - - <description> - Adds a reference to a classpath defined elsewhere - </description> - - </attribute> - - <attribute name="compiler" type="java.lang.String" briefType="String" required="no"> - - <short-description>Class name of a JSP compiler adapter.</short-description> - - <description> - Class name of a JSP compiler adapter. - </description> - - </attribute> - - <attribute name="compilerclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used to find this compiler adapter.</short-description> - - <description> - Set the classpath to be used to find this compiler adapter - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Destination directory into which the JSP source - files should be compiled.</short-description> - - <description> - Set the destination directory into which the JSP source - files should be compiled. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether or not the build should halt if compilation fails.</short-description> - - <description> - Whether or not the build should halt if compilation fails. - Defaults to <code>true</code>. - </description> - - </attribute> - - <attribute name="ieplugin" type="java.lang.String" briefType="String" required="no"> - - <short-description>Java Plugin CLASSID for Internet Explorer.</short-description> - - <description> - Java Plugin CLASSID for Internet Explorer - </description> - - </attribute> - - <attribute name="mapped" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, generate separate write() calls for each HTML line - in the JSP.</short-description> - - <description> - If true, generate separate write() calls for each HTML line - in the JSP. - </description> - - </attribute> - - <attribute name="package" type="java.lang.String" briefType="String" required="no"> - - <short-description>Name of the package the compiled jsp files should be in.</short-description> - - <description> - Set the name of the package the compiled jsp files should be in. - </description> - - </attribute> - - <attribute name="srcdir" type="org.apache.tools.ant.types.Path" briefType="Path" required="yes"> - - <short-description>Path for source JSP files.</short-description> - - <description> - Path for source JSP files. - </description> - - </attribute> - - <attribute name="uribase" type="java.io.File" briefType="File" required="no"> - - <short-description>The URI context of relative URI references in the JSP pages.</short-description> - - <description> - The URI context of relative URI references in the JSP pages. - If it does not exist then it is derived from the location - of the file relative to the declared or derived value of uriroot. - </description> - - </attribute> - - <attribute name="uriroot" type="java.io.File" briefType="File" required="no"> - - <short-description>The root directory that uri files should be resolved - against.</short-description> - - <description> - The root directory that uri files should be resolved - against. (Default is the directory jspc is invoked from) - </description> - - </attribute> - - <attribute name="verbose" type="int" briefType="int" required="no"> - - <short-description>Verbose level of the compiler.</short-description> - - <description> - Set the verbose level of the compiler - </description> - - </attribute> - - <attribute name="webinc" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Output filename for the fraction of web.xml that lists - servlets.</short-description> - - <description> - output filename for the fraction of web.xml that lists - servlets. - </description> - - </attribute> - - <attribute name="webxml" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Filename for web.xml.</short-description> - - <description> - Filename for web.xml. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="webapp" type="org.apache.tools.ant.taskdefs.optional.jsp.JspC.WebAppParameter" briefType="" required="NOTDEFINED"> - - <short-description>Adds a single webapp.</short-description> - - <description> - Adds a single webapp. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to the classpath.</short-description> - - <description> - Adds a path to the classpath. - </description> - - </element> - - - <element name="compilerclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Support nested compiler classpath, used to locate compiler adapter.</short-description> - - <description> - Support nested compiler classpath, used to locate compiler adapter - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="junit" category="other" classname="org.apache.tools.ant.taskdefs.optional.junit.JUnitTask"> - - - <short-description>Runs JUnit tests.</short-description> - - <description> - Runs JUnit tests. - - <p> JUnit is a framework to create unit test. It has been initially - created by Erich Gamma and Kent Beck. JUnit can be found at <a - href="http://www.junit.org">http://www.junit.org</a>. - - <p> <code>JUnitTask</code> can run a single specific - <code>JUnitTest</code> using the <code>test</code> element.</p> - For example, the following target <code><pre> - &lt;target name="test-int-chars" depends="jar-test"&gt; - &lt;echo message="testing international characters"/&gt; - &lt;junit printsummary="no" haltonfailure="yes" fork="false"&gt; - &lt;classpath refid="classpath"/&gt; - &lt;formatter type="plain" usefile="false" /&gt; - &lt;test name="org.apache.ecs.InternationalCharTest" /&gt; - &lt;/junit&gt; - &lt;/target&gt; - </pre></code> - <p>runs a single junit test - (<code>org.apache.ecs.InternationalCharTest</code>) in the current - VM using the path with id <code>classpath</code> as classpath and - presents the results formatted using the standard - <code>plain</code> formatter on the command line.</p> - - <p> This task can also run batches of tests. The - <code>batchtest</code> element creates a <code>BatchTest</code> - based on a fileset. This allows, for example, all classes found in - directory to be run as testcases.</p> - - <p>For example,</p><code><pre> - &lt;target name="run-tests" depends="dump-info,compile-tests" if="junit.present"&gt; - &lt;junit printsummary="no" haltonfailure="yes" fork="${junit.fork}"&gt; - &lt;jvmarg value="-classic"/&gt; - &lt;classpath refid="tests-classpath"/&gt; - &lt;sysproperty key="build.tests" value="${build.tests}"/&gt; - &lt;formatter type="brief" usefile="false" /&gt; - &lt;batchtest&gt; - &lt;fileset dir="${tests.dir}"&gt; - &lt;include name="**&#047;*Test*" /&gt; - &lt;/fileset&gt; - &lt;/batchtest&gt; - &lt;/junit&gt; - &lt;/target&gt; - </pre></code> - <p>this target finds any classes with a <code>test</code> directory - anywhere in their path (under the top <code>${tests.dir}</code>, of - course) and creates <code>JUnitTest</code>'s for each one.</p> - - <p> Of course, <code>&lt;junit&gt;</code> and - <code>&lt;batch&gt;</code> elements can be combined for more - complex tests. For an example, see the ant <code>build.xml</code> - target <code>run-tests</code> (the second example is an edited - version).</p> - - <p> To spawn a new Java VM to prevent interferences between - different testcases, you need to enable <code>fork</code>. A - number of attributes and elements allow you to set up how this JVM - runs. - </description> - - - <structure> - - - <attributes> - - <attribute name="dir" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory to invoke the VM in.</short-description> - - <description> - The directory to invoke the VM in. Ignored if no JVM is forked. - </description> - - </attribute> - - <attribute name="errorproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>Property to set to "true" if there is a error in a test.</short-description> - - <description> - Property to set to "true" if there is a error in a test. - - <p>This property is applied on all BatchTest (batchtest) and - JUnitTest (test), however, it can possibly be overriden by - their own properties.</p> - </description> - - </attribute> - - <attribute name="failureproperty" type="java.lang.String" briefType="String" required="no."> - - <short-description>Property to set to "true" if there is a failure in a test.</short-description> - - <description> - Property to set to "true" if there is a failure in a test. - - <p>This property is applied on all BatchTest (batchtest) and - JUnitTest (test), however, it can possibly be overriden by - their own properties.</p> - </description> - - </attribute> - - <attribute name="filtertrace" type="boolean" briefType="boolean" required="no; default is on."> - - <short-description>If true, smartly filter the stack frames of - JUnit errors and failures before reporting them.</short-description> - - <description> - If true, smartly filter the stack frames of - JUnit errors and failures before reporting them. - - <p>This property is applied on all BatchTest (batchtest) and - JUnitTest (test) however it can possibly be overridden by their - own properties.</p> - </description> - - </attribute> - - <attribute name="fork" type="boolean" briefType="boolean" required="no; default is off."> - - <short-description>If true, JVM should be forked for each test.</short-description> - - <description> - If true, JVM should be forked for each test. - - <p>It avoids interference between testcases and possibly avoids - hanging the build. this property is applied on all BatchTest - (batchtest) and JUnitTest (test) however it can possibly be - overridden by their own properties.</p> - </description> - - </attribute> - - <attribute name="haltonerror" type="boolean" briefType="boolean" required="no; default is off."> - - <short-description>If true, stop the build process when there is an error in a test.</short-description> - - <description> - If true, stop the build process when there is an error in a test. - This property is applied on all BatchTest (batchtest) and JUnitTest - (test) however it can possibly be overridden by their own - properties. - </description> - - </attribute> - - <attribute name="haltonfailure" type="boolean" briefType="boolean" required="no; default is off."> - - <short-description>If true, stop the build process if a test fails - (errors are considered failures as well).</short-description> - - <description> - If true, stop the build process if a test fails - (errors are considered failures as well). - This property is applied on all BatchTest (batchtest) and - JUnitTest (test) however it can possibly be overridden by their - own properties. - </description> - - </attribute> - - <attribute name="includeantruntime" type="boolean" briefType="boolean" required="no; default is true."> - - <short-description>If true, include ant.jar, optional.jar and junit.jar in the forked VM.</short-description> - - <description> - If true, include ant.jar, optional.jar and junit.jar in the forked VM. - </description> - - </attribute> - - <attribute name="jvm" type="java.lang.String" briefType="String" required="no; default is java."> - - <short-description>The command used to invoke the Java Virtual Machine, - default is 'java'.</short-description> - - <description> - The command used to invoke the Java Virtual Machine, - default is 'java'. The command is resolved by - java.lang.Runtime.exec(). Ignored if fork is disabled. - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="no"> - - <short-description>Maximum memory to be used by all forked JVMs.</short-description> - - <description> - Set the maximum memory to be used by all forked JVMs. - </description> - - </attribute> - - <attribute name="newenvironment" type="boolean" briefType="boolean" required="no; default is false."> - - <short-description>If true, use a new environment when forked.</short-description> - - <description> - If true, use a new environment when forked. - - <p>Will be ignored if we are not forking a new VM.</p> - </description> - - </attribute> - - <attribute name="printsummary" type="org.apache.tools.ant.taskdefs.optional.junit.JUnitTask.SummaryAttribute" briefType=""true", "yes", "false", "no", "on", "off", "withOutAndErr"" required="no; default is off."> - - <short-description>If true, print one-line statistics for each test, or "withOutAndErr" - to also show standard output and error.</short-description> - - <description> - If true, print one-line statistics for each test, or "withOutAndErr" - to also show standard output and error. - - Can take the values on, off, and withOutAndErr. - </description> - - </attribute> - - <attribute name="showoutput" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, send any output generated by tests to Ant's logging system - as well as to the formatters.</short-description> - - <description> - If true, send any output generated by tests to Ant's logging system - as well as to the formatters. - By default only the formatters receive the output. - - <p>Output will always be passed to the formatters and not by - shown by default. This option should for example be set for - tests that are interactive and prompt the user to do - something.</p> - </description> - - </attribute> - - <attribute name="timeout" type="java.lang.Integer" briefType="int" required="no"> - - <short-description>Timeout value (in milliseconds).</short-description> - - <description> - Set the timeout value (in milliseconds). - - <p>If the test is running for more than this value, the test - will be canceled. (works only when in 'fork' mode).</p> - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Adds an environment variable; used when forking.</short-description> - - <description> - Adds an environment variable; used when forking. - - <p>Will be ignored if we are not forking a new VM.</p> - </description> - - </element> - - - <element name="formatter" type="org.apache.tools.ant.taskdefs.optional.junit.FormatterElement" briefType="" required="NOTDEFINED"> - - <short-description>Add a new formatter to all tests of this task.</short-description> - - <description> - Add a new formatter to all tests of this task. - </description> - - </element> - - - <element name="sysproperty" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Adds a system property that tests can access.</short-description> - - <description> - Adds a system property that tests can access. - This might be useful to tranfer Ant properties to the - testcases when JVM forking is not enabled. - </description> - - </element> - - - <element name="test" type="org.apache.tools.ant.taskdefs.optional.junit.JUnitTest" briefType="" required="NOTDEFINED"> - - <short-description>Add a new single testcase.</short-description> - - <description> - Add a new single testcase. - </description> - - </element> - - - <element name="batchtest" type="org.apache.tools.ant.taskdefs.optional.junit.BatchTest" briefType="" required="NOTDEFINED"> - - <short-description>Adds a set of tests based on pattern matching.</short-description> - - <description> - Adds a set of tests based on pattern matching. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds path to classpath used for tests.</short-description> - - <description> - Adds path to classpath used for tests. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a JVM argument; ignored if not forking.</short-description> - - <description> - Adds a JVM argument; ignored if not forking. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="junitreport" category="testing" classname="org.apache.tools.ant.taskdefs.optional.junit.XMLResultAggregator"> - - - <short-description>Aggregates all &lt;junit&gt; XML formatter testsuite data under a specific directory and transforms the results via XSLT.</short-description> - - <description> - Aggregates all &lt;junit&gt; XML formatter testsuite data under - a specific directory and transforms the results via XSLT. - It is not particulary clean but - should be helpful while I am thinking about another technique. - - <p> The main problem is due to the fact that a JVM can be forked for a testcase - thus making it impossible to aggregate all testcases since the listener is - (obviously) in the forked JVM. A solution could be to write a - TestListener that will receive events from the TestRunner via sockets. This - is IMHO the simplest way to do it to avoid this file hacking thing. - </description> - - - <structure> - - - <attributes> - - <attribute name="todir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory where the results should be written.</short-description> - - <description> - Set the destination directory where the results should be written. If not - set if will use {@link #DEFAULT_DIR}. When given a relative directory - it will resolve it from the project directory. - </description> - - </attribute> - - <attribute name="tofile" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name of the aggregegated results file.</short-description> - - <description> - Set the name of the aggregegated results file. It must be relative - from the <tt>todir</tt> attribute. If not set it will use {@link #DEFAULT_FILENAME} - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a new fileset containing the XML results to aggregate.</short-description> - - <description> - Add a new fileset containing the XML results to aggregate - </description> - - </element> - - - <element name="report" type="org.apache.tools.ant.taskdefs.optional.junit.AggregateTransformer" briefType="" required="NOTDEFINED"> - - <short-description>Generate a report based on the document created by the merge.</short-description> - - <description> - Generate a report based on the document created by the merge. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="keysubst" category="other" classname="org.apache.tools.ant.taskdefs.KeySubst" deprecated="true"> - - - <short-description>Keyword substitution.</short-description> - - <description> - Keyword substitution. Input file is written to output file. - Do not make input file same as output file. - Keywords in input files look like this: @foo@. See the docs for the - setKeys method to understand how to do the substitutions. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination file.</short-description> - - <description> - Set the destination file. - </description> - - </attribute> - - <attribute name="keys" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Keys.</short-description> - - <description> - Sets the keys. -Format string is like this: -<p> -name=value*name2=value -<p> -Names are case sensitive. -<p> -Use the setSep() method to change the * to something else -if you need to use * as a name or value. - </description> - - </attribute> - - <attribute name="sep" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Seperator between name=value arguments -in setKeys().</short-description> - - <description> - Sets the seperator between name=value arguments -in setKeys(). By default it is "*". - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Source file.</short-description> - - <description> - Set the source file. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="loadfile" category="utility" classname="org.apache.tools.ant.taskdefs.LoadFile"> - - - <short-description>Load a file into a property</short-description> - - <description> - Load a file into a property - </description> - - - <structure> - - - <attributes> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding to use for input, defaults to the platform's default - encoding.</short-description> - - <description> - Encoding to use for input, defaults to the platform's default - encoding. <p> - - For a list of possible values see <a href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html"> - http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html - </a>.</p> - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no, default "true""> - - <short-description>If true, fail on load error.</short-description> - - <description> - If true, fail on load error. - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Property name to save to.</short-description> - - <description> - Property name to save to. - </description> - - </attribute> - - <attribute name="srcfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>File to load.</short-description> - - <description> - Sets the file to load. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" briefType="FilterChain" required="NOTDEFINED"> - - <short-description>Add the FilterChain element.</short-description> - - <description> - Add the FilterChain element. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="loadproperties" category="utility" classname="org.apache.tools.ant.taskdefs.LoadProperties"> - - - <short-description>Load a file's contents as Ant properties.</short-description> - - <description> - Load a file's contents as Ant properties. - </description> - - - <structure> - - - <attributes> - - <attribute name="srcfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>File to load.</short-description> - - <description> - Sets the file to load. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" briefType="FilterChain" required="NOTDEFINED"> - - <short-description>Adds a FilterChain.</short-description> - - <description> - Adds a FilterChain. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="mail" category="network" classname="org.apache.tools.ant.taskdefs.email.EmailTask"> - - - <short-description>A task to send SMTP email.</short-description> - - <description> - A task to send SMTP email. This is a refactoring of the SendMail and - MimeMail tasks such that both are within a single task. - </description> - - - <structure> - - - <attributes> - - <attribute name="bcclist" type="java.lang.String" briefType="String" required=""> - - <short-description>Adds "bcc" address elements.</short-description> - - <description> - Adds "bcc" address elements - </description> - - </attribute> - - <attribute name="cclist" type="java.lang.String" briefType="String" required=""> - - <short-description>Adds "cc" address elements.</short-description> - - <description> - Adds "cc" address elements - </description> - - </attribute> - - <attribute name="encoding" type="org.apache.tools.ant.taskdefs.email.EmailTask.Encoding" briefType=""auto", "mime", "uu", "plain"" required="no"> - - <short-description>Allows the build writer to choose the preferred encoding method.</short-description> - - <description> - Allows the build writer to choose the preferred encoding method - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no."> - - <short-description>Indicates whether BuildExceptions should be passed back to the core.</short-description> - - <description> - Indicates whether BuildExceptions should be passed back to the core - </description> - - </attribute> - - <attribute name="files" type="java.lang.String" briefType="String" required="no"> - - <short-description>Adds a list of files to be attached.</short-description> - - <description> - Adds a list of files to be attached - </description> - - </attribute> - - <attribute name="from" type="java.lang.String" briefType="String" required="either a from attribute, or a <from> element."> - - <short-description>Shorthand to set the from address element.</short-description> - - <description> - Shorthand to set the from address element - </description> - - </attribute> - - <attribute name="includefilenames" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets Includefilenames attribute.</short-description> - - <description> - Sets Includefilenames attribute - </description> - - </attribute> - - <attribute name="mailhost" type="java.lang.String" briefType="String" required="no"> - - <short-description>Host.</short-description> - - <description> - Sets the host - </description> - - </attribute> - - <attribute name="mailport" type="int" briefType="int" required="no"> - - <short-description>Mail server port.</short-description> - - <description> - Sets the mail server port - </description> - - </attribute> - - <attribute name="message" type="java.lang.String" briefType="String" required="one of these or a <message> element."> - - <short-description>Shorthand method to set the message.</short-description> - - <description> - Shorthand method to set the message - </description> - - </attribute> - - <attribute name="messagefile" type="java.io.File" briefType="File" required=""> - - <short-description>Shorthand method to set the message from a file.</short-description> - - <description> - Shorthand method to set the message from a file - </description> - - </attribute> - - <attribute name="messagemimetype" type="java.lang.String" briefType="String" required="no"> - - <short-description>Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible.</short-description> - - <description> - Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible. - </description> - - </attribute> - - <attribute name="subject" type="java.lang.String" briefType="String" required="no"> - - <short-description>Subject line of the email.</short-description> - - <description> - Sets the subject line of the email - </description> - - </attribute> - - <attribute name="tolist" type="java.lang.String" briefType="String" required="at least one of these, or the equivalent elements."> - - <short-description>Adds "to" address elements.</short-description> - - <description> - Adds "to" address elements - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="bcc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds "bcc" address elements.</short-description> - - <description> - Adds "bcc" address elements - </description> - - </element> - - - <element name="cc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds "cc" address element.</short-description> - - <description> - Adds "cc" address element - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files (nested fileset attribute).</short-description> - - <description> - Adds a set of files (nested fileset attribute). - </description> - - </element> - - - <element name="from" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds a from address element.</short-description> - - <description> - Adds a from address element - </description> - - </element> - - - <element name="message" type="org.apache.tools.ant.taskdefs.email.Message" briefType="" required="NOTDEFINED"> - - <short-description>Add a message elemnt.</short-description> - - <description> - Add a message elemnt - </description> - - </element> - - - <element name="to" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds a to address element.</short-description> - - <description> - Adds a to address element - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="manifest" category="java" classname="org.apache.tools.ant.taskdefs.ManifestTask"> - - - <short-description>Creates a manifest file for inclusion in a JAR, Ant task wrapper around</short-description> - - <description> - Creates a manifest file for inclusion in a JAR, Ant task wrapper - around {@link Manifest Manifest}. This task can be used to write a - Manifest file, optionally replacing or updating an existing file. - </description> - - - <structure> - - - <attributes> - - <attribute name="file" type="java.io.File" briefType="File" required="yes"> - - <short-description>The name of the manifest file to create/update.</short-description> - - <description> - The name of the manifest file to create/update. - Required if used as a task. - </description> - - </attribute> - - <attribute name="mode" type="org.apache.tools.ant.taskdefs.ManifestTask.Mode" briefType=""update", "replace"" required="no"> - - <short-description>Update policy: either "update" or "replace"; default is "replace".</short-description> - - <description> - Update policy: either "update" or "replace"; default is "replace". - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="attribute" type="org.apache.tools.ant.taskdefs.Manifest.Attribute" briefType="" required="NOTDEFINED"> - - <short-description>Add an attribute to the manifest - it is added to the main section.</short-description> - - <description> - Add an attribute to the manifest - it is added to the main section. - </description> - - </element> - - - <element name="section" type="org.apache.tools.ant.taskdefs.Manifest.Section" briefType="" required="NOTDEFINED"> - - <short-description>Add a section to the manifest.</short-description> - - <description> - Add a section to the manifest - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="maudit" category="other" classname="org.apache.tools.ant.taskdefs.optional.metamata.MAudit"> - - - <short-description>Invokes the Metamata Audit/ Webgain Quality Analyzer on a set of Java files.</short-description> - - <description> - Invokes the Metamata Audit/ Webgain Quality Analyzer on a set of Java files. - <p> - <i>maudit</i> performs static analysis of the Java source code and byte code files to find and report - errors of style and potential problems related to performance, maintenance and robustness. - As a convenience, a stylesheet is given in <tt>etc</tt> directory, so that an HTML report - can be generated from the XML file. - </description> - - - <structure> - - - <attributes> - - <attribute name="fix" type="boolean" briefType="boolean" required="no.default to false."> - - <short-description>Automatically fix certain errors - (those marked as fixable in the manual); - optional, default=false.</short-description> - - <description> - Automatically fix certain errors - (those marked as fixable in the manual); - optional, default=false - </description> - - </attribute> - - <attribute name="list" type="boolean" briefType="boolean" required="no. default to false."> - - <short-description>Creates listing file for each audited file; optional, default false.</short-description> - - <description> - Creates listing file for each audited file; optional, default false. - When set, a .maudit file will be generated in the - same location as the source file. - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="no"> - - <short-description>Maximum memory for the JVM; optional.</short-description> - - <description> - Set the maximum memory for the JVM; optional. - -mx or -Xmx depending on VM version - </description> - - </attribute> - - <attribute name="metamatahome" type="java.io.File" briefType="File" required="yes"> - - <short-description>The home directory containing the Metamata distribution; required.</short-description> - - <description> - The home directory containing the Metamata distribution; required - </description> - - </attribute> - - <attribute name="tofile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The XML file to which the Audit result should be written to; required.</short-description> - - <description> - The XML file to which the Audit result should be written to; required - </description> - - </attribute> - - <attribute name="unused" type="boolean" briefType="boolean" required="no. default to false."> - - <short-description>Finds declarations unused in search paths; optional, default false.</short-description> - - <description> - Finds declarations unused in search paths; optional, default false. - It will look for unused global declarations - in the source code within a use domain specified by the - <tt>searchpath</tt> element. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>The java files or directory to audit.</short-description> - - <description> - The java files or directory to audit. - Whatever the filter is, only the files that end - with .java will be included for processing. - Note that the base directory used for the fileset - MUST be the root of the source files otherwise package names - deduced from the file path will be incorrect. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Class path (also source path unless one explicitly set).</short-description> - - <description> - Sets the class path (also source path unless one explicitly set). - Overrides METAPATH/CLASSPATH environment variables. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Additional optional parameters to pass to the JVM.</short-description> - - <description> - Additional optional parameters to pass to the JVM. - You can avoid using the <code>&lt;jvmarg&gt;</code> by adding these empty - entries to <code>metamata.properties</code> located at <code>${metamata.home}/bin</code> - - <pre>metamata.classpath= - metamata.sourcepath= - metamata.baseclasspath= - </pre> - </description> - - </element> - - - <element name="rulespath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath for additional audit rules - these must be placed before metamata.jar !!.</short-description> - - <description> - classpath for additional audit rules - these must be placed before metamata.jar !! - </description> - - </element> - - - <element name="searchpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Search path to use for unused global declarations; - required when <tt>unused</tt> is set.</short-description> - - <description> - search path to use for unused global declarations; - required when <tt>unused</tt> is set. - </description> - - </element> - - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Source path.</short-description> - - <description> - Sets the source path. - Overrides the SOURCEPATH environment variable. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="mimemail" category="other" classname="org.apache.tools.ant.taskdefs.optional.net.MimeMail" deprecated="true"> - - - <short-description>A task to send SMTP email; Use <tt>mail</tt> instead</short-description> - - <description> - A task to send SMTP email; Use <tt>mail</tt> instead - </description> - - - <structure> - - - <attributes> - - <attribute name="bcclist" type="java.lang.String" briefType="String" required=""> - - <short-description>Adds "bcc" address elements.</short-description> - - <description> - Adds "bcc" address elements - </description> - - </attribute> - - <attribute name="cclist" type="java.lang.String" briefType="String" required=""> - - <short-description>Adds "cc" address elements.</short-description> - - <description> - Adds "cc" address elements - </description> - - </attribute> - - <attribute name="encoding" type="org.apache.tools.ant.taskdefs.email.EmailTask.Encoding" briefType=""auto", "mime", "uu", "plain"" required="NOTDEFINED"> - - <short-description>Allows the build writer to choose the preferred encoding method.</short-description> - - <description> - Allows the build writer to choose the preferred encoding method - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no, default to "true""> - - <short-description>Indicates whether BuildExceptions should be passed back to the core.</short-description> - - <description> - Indicates whether BuildExceptions should be passed back to the core - </description> - - </attribute> - - <attribute name="files" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Adds a list of files to be attached.</short-description> - - <description> - Adds a list of files to be attached - </description> - - </attribute> - - <attribute name="from" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Shorthand to set the from address element.</short-description> - - <description> - Shorthand to set the from address element - </description> - - </attribute> - - <attribute name="includefilenames" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Sets Includefilenames attribute.</short-description> - - <description> - Sets Includefilenames attribute - </description> - - </attribute> - - <attribute name="mailhost" type="java.lang.String" briefType="String" required="no, default to "localhost""> - - <short-description>Host.</short-description> - - <description> - Sets the host - </description> - - </attribute> - - <attribute name="mailport" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>Mail server port.</short-description> - - <description> - Sets the mail server port - </description> - - </attribute> - - <attribute name="message" type="java.lang.String" briefType="String" required="no, but only one of of 'message' or 'messagefile' may be specified. if not specified, a fileset must be provided."> - - <short-description>Shorthand method to set the message.</short-description> - - <description> - Shorthand method to set the message - </description> - - </attribute> - - <attribute name="messagefile" type="java.io.File" briefType="File" required=""> - - <short-description>Shorthand method to set the message from a file.</short-description> - - <description> - Shorthand method to set the message from a file - </description> - - </attribute> - - <attribute name="messagemimetype" type="java.lang.String" briefType="String" required="no, defaults to "text/plain""> - - <short-description>Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible.</short-description> - - <description> - Shorthand method to set type of the text message, text/plain by default - but text/html or text/xml is quite feasible. - </description> - - </attribute> - - <attribute name="subject" type="java.lang.String" briefType="String" required="no"> - - <short-description>Subject line of the email.</short-description> - - <description> - Sets the subject line of the email - </description> - - </attribute> - - <attribute name="tolist" type="java.lang.String" briefType="String" required="yes, at least one of 'tolist', 'cclist', or 'bcclist' must be specified."> - - <short-description>Adds "to" address elements.</short-description> - - <description> - Adds "to" address elements - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="bcc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds "bcc" address elements.</short-description> - - <description> - Adds "bcc" address elements - </description> - - </element> - - - <element name="cc" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds "cc" address element.</short-description> - - <description> - Adds "cc" address element - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files (nested fileset attribute).</short-description> - - <description> - Adds a set of files (nested fileset attribute). - </description> - - </element> - - - <element name="from" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds a from address element.</short-description> - - <description> - Adds a from address element - </description> - - </element> - - - <element name="message" type="org.apache.tools.ant.taskdefs.email.Message" briefType="" required="NOTDEFINED"> - - <short-description>Add a message elemnt.</short-description> - - <description> - Add a message elemnt - </description> - - </element> - - - <element name="to" type="org.apache.tools.ant.taskdefs.email.EmailAddress" briefType="" required="NOTDEFINED"> - - <short-description>Adds a to address element.</short-description> - - <description> - Adds a to address element - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="mkdir" category="filesystem" classname="org.apache.tools.ant.taskdefs.Mkdir"> - - - <short-description>Creates a given directory.</short-description> - - <description> - Creates a given directory. - Creates a directory and any non-existent parent directories, when - necessary - </description> - - - <structure> - - - <attributes> - - <attribute name="dir" type="java.io.File" briefType="File" required="yes"> - - <short-description>The directory to create; required.</short-description> - - <description> - the directory to create; required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="mmetrics" category="other" classname="org.apache.tools.ant.taskdefs.optional.metamata.MMetrics"> - - - <short-description>Computes the metrics of a set of Java files and write the results to an XML file.</short-description> - - <description> - Computes the metrics of a set of Java files and write the results to an XML - file. As a convenience, a stylesheet is given in <tt>etc</tt> directory, - so that an HTML report can be generated from the XML file. - <p> - You will not be able to use this task with the evaluation version since - as of Metamata 2.0, Metrics does not support command line :-( - </description> - - - <structure> - - - <attributes> - - <attribute name="granularity" type="org.apache.tools.ant.taskdefs.optional.metamata.MMetrics.GranularityAttribute" briefType=""compilation-units", "files", "methods", "types", "packages"" required="yes"> - - <short-description>Granularity of the audit.</short-description> - - <description> - set the granularity of the audit. Should be one of 'files', 'methods' - or 'types'. - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="no"> - - <short-description>Maximum memory for the JVM; optional.</short-description> - - <description> - Set the maximum memory for the JVM; optional. - -mx or -Xmx depending on VM version - </description> - - </attribute> - - <attribute name="metamatahome" type="java.io.File" briefType="File" required="yes"> - - <short-description>The home directory containing the Metamata distribution; required.</short-description> - - <description> - The home directory containing the Metamata distribution; required - </description> - - </attribute> - - <attribute name="tofile" type="java.io.File" briefType="File" required="yes"> - - <short-description>Output XML file.</short-description> - - <description> - Set the output XML file - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>The java files or directory to audit.</short-description> - - <description> - The java files or directory to audit. - Whatever the filter is, only the files that end - with .java will be included for processing. - Note that the base directory used for the fileset - MUST be the root of the source files otherwise package names - deduced from the file path will be incorrect. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Class path (also source path unless one explicitly set).</short-description> - - <description> - Sets the class path (also source path unless one explicitly set). - Overrides METAPATH/CLASSPATH environment variables. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Additional optional parameters to pass to the JVM.</short-description> - - <description> - Additional optional parameters to pass to the JVM. - You can avoid using the <code>&lt;jvmarg&gt;</code> by adding these empty - entries to <code>metamata.properties</code> located at <code>${metamata.home}/bin</code> - - <pre>metamata.classpath= - metamata.sourcepath= - metamata.baseclasspath= - </pre> - </description> - - </element> - - - <element name="path" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>New path (directory) to measure metrics from.</short-description> - - <description> - Set a new path (directory) to measure metrics from. - </description> - - </element> - - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Source path.</short-description> - - <description> - Sets the source path. - Overrides the SOURCEPATH environment variable. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="move" category="filesystem" classname="org.apache.tools.ant.taskdefs.Move"> - - - <short-description>Moves a file or directory to a new file or directory.</short-description> - - <description> - Moves a file or directory to a new file or directory. - By default, the - destination file is overwritten if it already exists. - When <i>overwrite</i> is - turned off, then files are only moved if the source file is - newer than the destination file, or when the destination file does - not exist. - - <p>Source files and directories are only deleted when the file or - directory has been copied to the destination successfully. Filtering - also works.</p> - - <p>This implementation is based on Arnout Kuiper's initial design - document, the following mailing list discussions, and the - copyfile/copydir tasks.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Character encoding.</short-description> - - <description> - Sets the character encoding - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If false, note errors to the output but keep going.</short-description> - - <description> - If false, note errors to the output but keep going. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="one of file or at least one nested fileset element"> - - <short-description>Single source file to copy.</short-description> - - <description> - Sets a single source file to copy. - </description> - - </attribute> - - <attribute name="filtering" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, enables filtering.</short-description> - - <description> - If true, enables filtering. - </description> - - </attribute> - - <attribute name="flatten" type="boolean" briefType="boolean" required="no"> - - <short-description>When copying directory trees, the files can be "flattened" - into a single directory.</short-description> - - <description> - When copying directory trees, the files can be "flattened" - into a single directory. If there are multiple files with - the same name in the source directory tree, only the first - file will be copied into the "flattened" directory, unless - the forceoverwrite attribute is true. - </description> - - </attribute> - - <attribute name="includeemptydirs" type="boolean" briefType="boolean" required="no"> - - <short-description>Used to copy empty directories.</short-description> - - <description> - Used to copy empty directories. - </description> - - </attribute> - - <attribute name="overwrite" type="boolean" briefType="boolean" required="no"> - - <short-description>Overwrite any existing destination file(s).</short-description> - - <description> - Overwrite any existing destination file(s). - </description> - - </attribute> - - <attribute name="preservelastmodified" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Give the copied files the same last modified time as the original files.</short-description> - - <description> - Give the copied files the same last modified time as the original files. - </description> - - </attribute> - - <attribute name="todir" type="java.io.File" briefType="File" required=""> - - <short-description>Destination directory.</short-description> - - <description> - Sets the destination directory. - </description> - - </attribute> - - <attribute name="tofile" type="java.io.File" briefType="File" required="with the file attribute, either tofile or todir can be used. with nested filesets, if the fileset size is greater than 1 or if the only entry in the fileset is a directory or if the file attribute is already specified, only todir is allowed"> - - <short-description>Destination file.</short-description> - - <description> - Sets the destination file. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Used to force listing of all names of copied files.</short-description> - - <description> - Used to force listing of all names of copied files. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files to copy.</short-description> - - <description> - Adds a set of files to copy. - </description> - - </element> - - - <element name="filterchain" type="org.apache.tools.ant.types.FilterChain" briefType="FilterChain" required="NOTDEFINED"> - - <short-description>Adds a FilterChain.</short-description> - - <description> - Adds a FilterChain. - </description> - - </element> - - - <element name="filterset" type="org.apache.tools.ant.types.FilterSet" briefType="Filterset" required="NOTDEFINED"> - - <short-description>Adds a filterset.</short-description> - - <description> - Adds a filterset. - </description> - - </element> - - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" briefType="Mapper" required="NOTDEFINED"> - - <short-description>Defines the mapper to map source to destination files.</short-description> - - <description> - Defines the mapper to map source to destination files. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="mparse" category="other" classname="org.apache.tools.ant.taskdefs.optional.metamata.MParse"> - - - <short-description>Simple Metamata MParse task.</short-description> - - <description> - Simple Metamata MParse task. - Based on the original written by - <a href="mailto:thomas.haas@softwired-inc.com">Thomas Haas</a>. - This version was written for Metamata 2.0 available at - <a href="http://www.metamata.com">http://www.metamata.com</a> - </description> - - - <structure> - - - <attributes> - - <attribute name="cleanup" type="boolean" briefType="boolean" required="no. default to false"> - - <short-description>Remove the intermediate Sun JavaCC file - ; optional, default false.</short-description> - - <description> - Remove the intermediate Sun JavaCC file - ; optional, default false. - </description> - - </attribute> - - <attribute name="debugparser" type="boolean" briefType="boolean" required="no"> - - <short-description>Set parser debug mode; optional, default false.</short-description> - - <description> - set parser debug mode; optional, default false - </description> - - </attribute> - - <attribute name="debugscanner" type="boolean" briefType="boolean" required="no"> - - <short-description>Set scanner debug mode; optional, default false.</short-description> - - <description> - set scanner debug mode; optional, default false - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="no"> - - <short-description>Maximum memory for the JVM; optional.</short-description> - - <description> - Set the maximum memory for the JVM; optional. - -mx or -Xmx depending on VM version - </description> - - </attribute> - - <attribute name="metamatahome" type="java.io.File" briefType="File" required="yes"> - - <short-description>The home directory containing the Metamata distribution; required.</short-description> - - <description> - The home directory containing the Metamata distribution; required - </description> - - </attribute> - - <attribute name="target" type="java.io.File" briefType="File" required="yes"> - - <short-description>The .jj file to process; required.</short-description> - - <description> - The .jj file to process; required. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no"> - - <short-description>Set verbose mode; optional, default false.</short-description> - - <description> - set verbose mode; optional, default false - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create a classpath entry.</short-description> - - <description> - create a classpath entry - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Additional optional parameters to pass to the JVM.</short-description> - - <description> - Additional optional parameters to pass to the JVM. - </description> - - </element> - - - <element name="sourcepath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Creates a sourcepath entry.</short-description> - - <description> - creates a sourcepath entry - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="native2ascii" category="other" classname="org.apache.tools.ant.taskdefs.optional.Native2Ascii" matchingTask="true"> - - - <short-description>Converts files from native encodings to ASCII.</short-description> - - <description> - Converts files from native encodings to ASCII. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>Destination directory to place converted files into.</short-description> - - <description> - Set the destination directory to place converted files into. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding to translate to/from.</short-description> - - <description> - Set the encoding to translate to/from. - If unset, the default encoding for the JVM is used. - </description> - - </attribute> - - <attribute name="ext" type="java.lang.String" briefType="String" required="no"> - - <short-description>Extension which converted files should have.</short-description> - - <description> - Set the extension which converted files should have. - If unset, files will not be renamed. - </description> - - </attribute> - - <attribute name="reverse" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag the conversion to run in the reverse sense, - that is Ascii to Native encoding.</short-description> - - <description> - Flag the conversion to run in the reverse sense, - that is Ascii to Native encoding. - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="no"> - - <short-description>Source directory in which to find files to convert.</short-description> - - <description> - Set the source directory in which to find files to convert. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" briefType="Mapper" required="NOTDEFINED"> - - <short-description>Defines the FileNameMapper to use (nested mapper element).</short-description> - - <description> - Defines the FileNameMapper to use (nested mapper element). - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="netrexxc" category="other" classname="org.apache.tools.ant.taskdefs.optional.NetRexxC" matchingTask="true"> - - - <short-description>Compiles NetRexx source files.</short-description> - - <description> - Compiles NetRexx source files. - This task can take the following - arguments: - <ul> - <li>binary</li> - <li>classpath</li> - <li>comments</li> - <li>compile</li> - <li>console</li> - <li>crossref</li> - <li>decimal</li> - <li>destdir</li> - <li>diag</li> - <li>explicit</li> - <li>format</li> - <li>keep</li> - <li>logo</li> - <li>replace</li> - <li>savelog</li> - <li>srcdir</li> - <li>sourcedir</li> - <li>strictargs</li> - <li>strictassign</li> - <li>strictcase</li> - <li>strictimport</li> - <li>symbols</li> - <li>time</li> - <li>trace</li> - <li>utf8</li> - <li>verbose</li> - <li>suppressMethodArgumentNotUsed</li> - <li>suppressPrivatePropertyNotUsed</li> - <li>suppressVariableNotUsed</li> - <li>suppressExceptionNotSignalled</li> - <li>suppressDeprecation</li> - </ul> - Of these arguments, the <b>srcdir</b> argument is required. - - <p>When this task executes, it will recursively scan the srcdir - looking for NetRexx source files to compile. This task makes its - compile decision based on timestamp. - <p>Before files are compiled they and any other file in the - srcdir will be copied to the destdir allowing support files to be - located properly in the classpath. The reason for copying the source files - before the compile is that NetRexxC has only two destinations for classfiles: - <ol> - <li>The current directory, and,</li> - <li>The directory the source is in (see sourcedir option) - </ol> - </description> - - - <structure> - - - <attributes> - - <attribute name="binary" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether literals are treated as binary, rather than NetRexx types.</short-description> - - <description> - Set whether literals are treated as binary, rather than NetRexx types - </description> - - </attribute> - - <attribute name="classpath" type="java.lang.String" briefType="String" required="no"> - - <short-description>Classpath used for NetRexx compilation.</short-description> - - <description> - Set the classpath used for NetRexx compilation - </description> - - </attribute> - - <attribute name="comments" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether comments are passed through to the generated java source.</short-description> - - <description> - Set whether comments are passed through to the generated java source. - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false - </description> - - </attribute> - - <attribute name="compact" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether error messages come out in compact or verbose format.</short-description> - - <description> - Set whether error messages come out in compact or verbose format. Valid - true values are "on" or "true". Anything else sets the flag to false. - The default value is false - </description> - - </attribute> - - <attribute name="compile" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether the NetRexx compiler should compile the generated java code - Valid true values are "on" or "true".</short-description> - - <description> - Set whether the NetRexx compiler should compile the generated java code - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is true. Setting this flag to false, will - automatically set the keep flag to true. - </description> - - </attribute> - - <attribute name="console" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether or not messages should be displayed on the 'console' Valid - true values are "on" or "true".</short-description> - - <description> - Set whether or not messages should be displayed on the 'console' Valid - true values are "on" or "true". Anything else sets the flag to false. - The default value is true. - </description> - - </attribute> - - <attribute name="crossref" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether variable cross references are generated.</short-description> - - <description> - Whether variable cross references are generated - </description> - - </attribute> - - <attribute name="decimal" type="boolean" briefType="boolean" required="no"> - - <short-description>Set whether decimal arithmetic should be used for the netrexx code.</short-description> - - <description> - Set whether decimal arithmetic should be used for the netrexx code. - Binary arithmetic is used when this flag is turned off. Valid true - values are "on" or "true". Anything else sets the flag to false. The - default value is true. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Destination directory into which the NetRexx source files - should be copied and then compiled.</short-description> - - <description> - Set the destination directory into which the NetRexx source files - should be copied and then compiled. - </description> - - </attribute> - - <attribute name="diag" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether diagnostic information about the compile is generated.</short-description> - - <description> - Whether diagnostic information about the compile is generated - </description> - - </attribute> - - <attribute name="explicit" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether variables must be declared explicitly before use.</short-description> - - <description> - Sets whether variables must be declared explicitly before use. Valid - true values are "on" or "true". Anything else sets the flag to false. - The default value is false. - </description> - - </attribute> - - <attribute name="format" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the generated java code is formatted nicely or left to match - NetRexx line numbers for call stack debugging.</short-description> - - <description> - Whether the generated java code is formatted nicely or left to match - NetRexx line numbers for call stack debugging - </description> - - </attribute> - - <attribute name="java" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the generated java code is produced Valid true values are "on" - or "true".</short-description> - - <description> - Whether the generated java code is produced Valid true values are "on" - or "true". Anything else sets the flag to false. The default value is - false. - </description> - - </attribute> - - <attribute name="keep" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether the generated java source file should be kept after - compilation.</short-description> - - <description> - Sets whether the generated java source file should be kept after - compilation. The generated files will have an extension of .java.keep, - <b>not</b> .java Valid true values are "on" or "true". Anything else - sets the flag to false. The default value is false. - </description> - - </attribute> - - <attribute name="logo" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the compiler text logo is displayed when compiling.</short-description> - - <description> - Whether the compiler text logo is displayed when compiling - </description> - - </attribute> - - <attribute name="replace" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the generated .java file should be replaced when compiling - Valid true values are "on" or "true".</short-description> - - <description> - Whether the generated .java file should be replaced when compiling - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false. - </description> - - </attribute> - - <attribute name="savelog" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether the compiler messages will be written to NetRexxC.log as - well as to the console Valid true values are "on" or "true".</short-description> - - <description> - Sets whether the compiler messages will be written to NetRexxC.log as - well as to the console Valid true values are "on" or "true". Anything - else sets the flag to false. The default value is false. - </description> - - </attribute> - - <attribute name="sourcedir" type="boolean" briefType="boolean" required="no"> - - <short-description>Tells the NetRexx compiler to store the class files in the same - directory as the source files.</short-description> - - <description> - Tells the NetRexx compiler to store the class files in the same - directory as the source files. The alternative is the working directory - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is true. - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Source dir to find the source Java files.</short-description> - - <description> - Set the source dir to find the source Java files. - </description> - - </attribute> - - <attribute name="strictargs" type="boolean" briefType="boolean" required="no"> - - <short-description>Tells the NetRexx compiler that method calls always need parentheses, - even if no arguments are needed, e.g.</short-description> - - <description> - Tells the NetRexx compiler that method calls always need parentheses, - even if no arguments are needed, e.g. <code>aStringVar.getBytes</code> - vs. <code>aStringVar.getBytes()</code> Valid true values are "on" or - "true". Anything else sets the flag to false. The default value is - false. - </description> - - </attribute> - - <attribute name="strictassign" type="boolean" briefType="boolean" required="no"> - - <short-description>Tells the NetRexx compile that assignments must match exactly on type.</short-description> - - <description> - Tells the NetRexx compile that assignments must match exactly on type - </description> - - </attribute> - - <attribute name="strictcase" type="boolean" briefType="boolean" required="no"> - - <short-description>Specifies whether the NetRexx compiler should be case sensitive or not.</short-description> - - <description> - Specifies whether the NetRexx compiler should be case sensitive or not - </description> - - </attribute> - - <attribute name="strictimport" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether classes need to be imported explicitly using an <code>import</code> - statement.</short-description> - - <description> - Sets whether classes need to be imported explicitly using an <code>import</code> - statement. By default the NetRexx compiler will import certain packages - automatically Valid true values are "on" or "true". Anything else sets - the flag to false. The default value is false. - </description> - - </attribute> - - <attribute name="strictprops" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether local properties need to be qualified explicitly using - <code>this</code> Valid true values are "on" or "true".</short-description> - - <description> - Sets whether local properties need to be qualified explicitly using - <code>this</code> Valid true values are "on" or "true". Anything else - sets the flag to false. The default value is false. - </description> - - </attribute> - - <attribute name="strictsignal" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the compiler should force catching of exceptions by explicitly - named types.</short-description> - - <description> - Whether the compiler should force catching of exceptions by explicitly - named types - </description> - - </attribute> - - <attribute name="suppressdeprecation" type="boolean" briefType="boolean" required="no"> - - <short-description>Tells whether we should filter out any deprecation-messages - of the compiler out.</short-description> - - <description> - Tells whether we should filter out any deprecation-messages - of the compiler out. - </description> - - </attribute> - - <attribute name="suppressexceptionnotsignalled" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the task should suppress the "FooException is in SIGNALS list - but is not signalled within the method", which is sometimes rather - useless.</short-description> - - <description> - Whether the task should suppress the "FooException is in SIGNALS list - but is not signalled within the method", which is sometimes rather - useless. The warning is logged as verbose message, though. - </description> - - </attribute> - - <attribute name="suppressmethodargumentnotused" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the task should suppress the "Method argument is not used" in - strictargs-Mode, which can not be suppressed by the compiler itself.</short-description> - - <description> - Whether the task should suppress the "Method argument is not used" in - strictargs-Mode, which can not be suppressed by the compiler itself. - The warning is logged as verbose message, though. - </description> - - </attribute> - - <attribute name="suppressprivatepropertynotused" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the task should suppress the "Private property is defined but - not used" in strictargs-Mode, which can be quite annoying while - developing.</short-description> - - <description> - Whether the task should suppress the "Private property is defined but - not used" in strictargs-Mode, which can be quite annoying while - developing. The warning is logged as verbose message, though. - </description> - - </attribute> - - <attribute name="suppressvariablenotused" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether the task should suppress the "Variable is set but not used" in - strictargs-Mode.</short-description> - - <description> - Whether the task should suppress the "Variable is set but not used" in - strictargs-Mode. Be careful with this one! The warning is logged as - verbose message, though. - </description> - - </attribute> - - <attribute name="symbols" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether debug symbols should be generated into the class file - Valid true values are "on" or "true".</short-description> - - <description> - Sets whether debug symbols should be generated into the class file - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false. - </description> - - </attribute> - - <attribute name="time" type="boolean" briefType="boolean" required="no"> - - <short-description>Asks the NetRexx compiler to print compilation times to the console - Valid true values are "on" or "true".</short-description> - - <description> - Asks the NetRexx compiler to print compilation times to the console - Valid true values are "on" or "true". Anything else sets the flag to - false. The default value is false. - </description> - - </attribute> - - <attribute name="trace" type="org.apache.tools.ant.taskdefs.optional.NetRexxC.TraceAttr" briefType=""trace", "trace1", "trace2", "notrace"" required="no"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="utf8" type="boolean" briefType="boolean" required="no"> - - <short-description>Tells the NetRexx compiler that the source is in UTF8 Valid true values - are "on" or "true".</short-description> - - <description> - Tells the NetRexx compiler that the source is in UTF8 Valid true values - are "on" or "true". Anything else sets the flag to false. The default - value is false. - </description> - - </attribute> - - <attribute name="verbose" type="org.apache.tools.ant.taskdefs.optional.NetRexxC.VerboseAttr" briefType=""verbose", "verbose0", "verbose1", "verbose2", "verbose3", "verbose4", "verbose5", "noverbose"" required="no"> - - <short-description>Whether lots of warnings and error messages should be generated.</short-description> - - <description> - Whether lots of warnings and error messages should be generated - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4add" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Add"> - - - <short-description>Adds specified files to Perforce.</short-description> - - <description> - Adds specified files to Perforce. - - <b>Example Usage:</b> - <table border="1"> - <th>Function</th><th>Command</th> - <tr><td>Add files using P4USER, P4PORT and P4CLIENT settings specified</td><td>&lt;P4add <br>P4view="//projects/foo/main/source/..." <br>P4User="fbloggs" <br>P4Port="km01:1666" <br>P4Client="fbloggsclient"&gt;<br>&lt;fileset basedir="dir" includes="**&#47;*.java"&gt;<br>&lt;/p4add&gt;</td></tr> - <tr><td>Add files using P4USER, P4PORT and P4CLIENT settings defined in environment</td><td>&lt;P4add P4view="//projects/foo/main/source/..." /&gt;<br>&lt;fileset basedir="dir" includes="**&#47;*.java"&gt;<br>&lt;/p4add&gt;</td></tr> - <tr><td>Specify the length of command line arguments to pass to each invocation of p4</td><td>&lt;p4add Commandlength="450"&gt;</td></tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="changelist" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>If specified the open files are associated with the - specified pending changelist number; otherwise the open files are - associated with the default changelist.</short-description> - - <description> - If specified the open files are associated with the - specified pending changelist number; otherwise the open files are - associated with the default changelist. - </description> - - </attribute> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="commandlength" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>Positive integer specifying the maximum length - of the commandline when calling Perforce to add the files.</short-description> - - <description> - positive integer specifying the maximum length - of the commandline when calling Perforce to add the files. - Defaults to 450, higher values mean faster execution, - but also possible failures. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Files to add.</short-description> - - <description> - files to add - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="p4change" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Change"> - - - <short-description>Requests a new changelist from the Perforce server.</short-description> - - <description> - Requests a new changelist from the Perforce server. - P4Change creates a new changelist in perforce. P4Change sets the property - ${p4.change} with the new changelist number. This should then be passed into - p4edit and p4submit. - </description> - - - <structure> - - - <attributes> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="description" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Description for ChangeList;optional.</short-description> - - <description> - Description for ChangeList;optional. - If none is specified, it will default to "AutoSubmit By Ant" - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4counter" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Counter"> - - - <short-description>Obtains or sets the value of a counter.</short-description> - - <description> - Obtains or sets the value of a counter. - - <p> When used in its base form - (where only the counter name is provided), the counter value will be - printed to the output stream. When the value is provided, the counter - will be set to the value provided. When a property name is provided, - the property will be filled with the value of the counter. You may - not specify to both get and set the value of the counter in the same - Task. - </p> - <P> - The user performing this task must have Perforce &quot;review&quot; permissions - as defined by Perforce protections in order for this task to succeed. -</P> - - Example Usage:<br> - &lt;p4counter name="${p4.counter}" property=${p4.change}"/&gt; - </description> - - - <structure> - - - <attributes> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of the counter; required.</short-description> - - <description> - The name of the counter; required - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A property to be set with the value of the counter.</short-description> - - <description> - A property to be set with the value of the counter - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="value" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>The new value for the counter; optional.</short-description> - - <description> - The new value for the counter; optional. - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4delete" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Delete"> - - - <short-description>Checkout files for deletion.</short-description> - - <description> - Checkout files for deletion. - - Example Usage:<br> - &lt;p4delete change="${p4.change}" view="//depot/project/foo.txt" /&gt;<br> - - Simple re-write of P4Edit changing 'edit' to 'delete'.<br> - </description> - - - <structure> - - - <attributes> - - <attribute name="change" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>An existing changelist number for the deletion; optional - but strongly recommended.</short-description> - - <description> - An existing changelist number for the deletion; optional - but strongly recommended. - </description> - - </attribute> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4edit" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Edit"> - - - <short-description>Open file(s) for edit.</short-description> - - <description> - Open file(s) for edit. - P4Change should be used to obtain a new changelist for P4Edit as, - although P4Edit can open files to the default change, - P4Submit cannot yet submit to it. - Example Usage:<br> - &lt;p4edit change="${p4.change}" view="//depot/project/foo.txt" /&gt; - </description> - - - <structure> - - - <attributes> - - <attribute name="change" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>An existing changelist number to assign files to; optional - but strongly recommended.</short-description> - - <description> - An existing changelist number to assign files to; optional - but strongly recommended. - </description> - - </attribute> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4have" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Have"> - - - <short-description>Lists Perforce files currently on client.</short-description> - - <description> - Lists Perforce files currently on client. - - P4Have simply dumps the current file version info into - the Ant log (or stdout). - </description> - - - <structure> - - - <attributes> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4label" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Label"> - - - <short-description>Creates a new Perforce label and set contents to reflect current client file revisions.</short-description> - - <description> - Creates a new Perforce label and set contents to reflect current - client file revisions. - - Label name defaults to AntLabel if none set. - - Example Usage: - <pre> - &lt;P4Label name="MyLabel-${TSTAMP}-${DSTAMP}" desc="Auto Build Label" /&gt; - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="desc" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Label Description; optional.</short-description> - - <description> - Label Description; optional - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="lock" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>When set to "locked", Perforce will lock the label once created; optional.</short-description> - - <description> - when set to "locked", Perforce will lock the label once created; optional. - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of the label; optional, default "AntLabel".</short-description> - - <description> - The name of the label; optional, default "AntLabel" - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4reopen" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Reopen"> - - - <short-description>No Description.</short-description> - - <description> - - </description> - - - <structure> - - - <attributes> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="tochange" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The changelist to move files to; required.</short-description> - - <description> - The changelist to move files to; required. - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4revert" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Revert"> - - - <short-description>Revert Perforce open files or files in a changelist</short-description> - - <description> - Revert Perforce open files or files in a changelist - </description> - - - <structure> - - - <attributes> - - <attribute name="change" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The changelist to revert; optional.</short-description> - - <description> - The changelist to revert; optional. - </description> - - </attribute> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="revertonlyunchanged" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to revert only unchanged files (p4 revert -a); optional, default false.</short-description> - - <description> - flag to revert only unchanged files (p4 revert -a); optional, default false. - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4submit" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Submit"> - - - <short-description>Submits a numbered changelist to Perforce.</short-description> - - <description> - Submits a numbered changelist to Perforce. - - <B>Note:</B> P4Submit cannot (yet) submit the default changelist. - This shouldn't be a problem with the ANT task as the usual flow is - P4Change to create a new numbered change followed by P4Edit then P4Submit. - - Example Usage:-<br> - &lt;p4submit change="${p4.change}" /&gt; - </description> - - - <structure> - - - <attributes> - - <attribute name="change" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The changelist number to submit; required.</short-description> - - <description> - The changelist number to submit; required. - </description> - - </attribute> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="p4sync" category="other" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Sync"> - - - <short-description>Synchronize client space to a Perforce depot view.</short-description> - - <description> - Synchronize client space to a Perforce depot view. - - The API allows additional functionality of the "p4 sync" command - (such as "p4 sync -f //...#have" or other exotic invocations).</P> - - <b>Example Usage:</b> - <table border="1"> - <th>Function</th><th>Command</th> - <tr><td>Sync to head using P4USER, P4PORT and P4CLIENT settings specified</td><td>&lt;P4Sync <br>P4view="//projects/foo/main/source/..." <br>P4User="fbloggs" <br>P4Port="km01:1666" <br>P4Client="fbloggsclient" /&gt;</td></tr> - <tr><td>Sync to head using P4USER, P4PORT and P4CLIENT settings defined in environment</td><td>&lt;P4Sync P4view="//projects/foo/main/source/..." /&gt;</td></tr> - <tr><td>Force a re-sync to head, refreshing all files</td><td>&lt;P4Sync force="yes" P4view="//projects/foo/main/source/..." /&gt;</td></tr> - <tr><td>Sync to a label</td><td>&lt;P4Sync label="myPerforceLabel" /&gt;</td></tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="client" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 client spec to use; - optional, defaults to the current user.</short-description> - - <description> - The p4 client spec to use; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="cmdopts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set extra command options; only used on some - of the Perforce tasks.</short-description> - - <description> - Set extra command options; only used on some - of the Perforce tasks. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether to stop the build (true, default) - or keep going if an error is returned from the p4 command.</short-description> - - <description> - whether to stop the build (true, default) - or keep going if an error is returned from the p4 command - </description> - - </attribute> - - <attribute name="force" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Force a refresh of files, if this attribute is set; false by default.</short-description> - - <description> - force a refresh of files, if this attribute is set; false by default. - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Label to sync client to; optional.</short-description> - - <description> - Label to sync client to; optional. - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4d server and port to connect to; - optional, default "perforce:1666".</short-description> - - <description> - The p4d server and port to connect to; - optional, default "perforce:1666" - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The p4 username; - optional, defaults to the current user.</short-description> - - <description> - The p4 username; - optional, defaults to the current user - </description> - - </attribute> - - <attribute name="view" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The client, branch or label view to operate upon; - optional default "//...".</short-description> - - <description> - The client, branch or label view to operate upon; - optional default "//..." - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="parallel" category="control" classname="org.apache.tools.ant.taskdefs.Parallel"> - - - <short-description>Executes the contained tasks in separate threads, continuing once all are completed.</short-description> - - <description> - Executes the contained tasks in separate threads, continuing - once all are completed. - <p> - </description> - - - <structure> - - - <attributes> - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="patch" category="utility" classname="org.apache.tools.ant.taskdefs.Patch"> - - - <short-description>Patches a file by applying a 'diff' file to it; requires "patch" to be on the execution path.</short-description> - - <description> - Patches a file by applying a 'diff' file to it; requires "patch" to be - on the execution path. - </description> - - - <structure> - - - <attributes> - - <attribute name="backups" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to create backups; optional, default=false.</short-description> - - <description> - flag to create backups; optional, default=false - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="no, default is the project's basedir."> - - <short-description>The directory to run the patch command in, defaults to the - project's base directory.</short-description> - - <description> - The directory to run the patch command in, defaults to the - project's base directory. - </description> - - </attribute> - - <attribute name="ignorewhitespace" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to ignore whitespace differences; default=false.</short-description> - - <description> - flag to ignore whitespace differences; default=false - </description> - - </attribute> - - <attribute name="originalfile" type="java.io.File" briefType="File" required="no, tries to guess it from the diff file"> - - <short-description>The file to patch; optional if it can be inferred from - the diff file.</short-description> - - <description> - The file to patch; optional if it can be inferred from - the diff file - </description> - - </attribute> - - <attribute name="patchfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The file containing the diff output; required.</short-description> - - <description> - The file containing the diff output; required. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="no"> - - <short-description>Work silently unless an error occurs; optional, default=false.</short-description> - - <description> - Work silently unless an error occurs; optional, default=false - </description> - - </attribute> - - <attribute name="reverse" type="boolean" briefType="boolean" required="no"> - - <short-description>Assume patch was created with old and new files swapped; optional, - default=false.</short-description> - - <description> - Assume patch was created with old and new files swapped; optional, - default=false - </description> - - </attribute> - - <attribute name="strip" type="int" briefType="int" required="no"> - - <short-description>Strip the smallest prefix containing <i>num</i> leading slashes - from filenames.</short-description> - - <description> - Strip the smallest prefix containing <i>num</i> leading slashes - from filenames. - - <p>patch's <i>-p</i> option. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="pathconvert" category="utility" classname="org.apache.tools.ant.taskdefs.PathConvert"> - - - <short-description>Converts path and classpath information to a specific target OS format.</short-description> - - <description> - Converts path and classpath information to a specific target OS - format. The resulting formatted path is placed into the specified property. - </description> - - - <structure> - - - <attributes> - - <attribute name="dirsep" type="java.lang.String" briefType="String" required="no, defaults to current jvm file.separator"> - - <short-description>Default directory separator string; - defaults to current JVM.</short-description> - - <description> - Set the default directory separator string; - defaults to current JVM {@link java.io.File#separator File.separator} - </description> - - </attribute> - - <attribute name="pathsep" type="java.lang.String" briefType="String" required="no, defaults to current jvm file.pathseparator"> - - <short-description>Default path separator string; - defaults to current JVM.</short-description> - - <description> - Set the default path separator string; - defaults to current JVM - {@link java.io.File#pathSeparator File.pathSeparator} - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The property into which the converted path will be placed.</short-description> - - <description> - The property into which the converted path will be placed. - </description> - - </attribute> - - <attribute name="refid" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no; if omitted, a nested <path> element must be supplied."> - - <short-description>Adds a reference to a Path, FileSet, DirSet, or FileList defined - elsewhere.</short-description> - - <description> - Adds a reference to a Path, FileSet, DirSet, or FileList defined - elsewhere. - </description> - - </attribute> - - <attribute name="setonempty" type="boolean" briefType="boolean" required="no; default is "true". "> - - <short-description>Set setonempty - - If false, don't set the new property if the result is the empty string.</short-description> - - <description> - Set setonempty - - If false, don't set the new property if the result is the empty string. - </description> - - </attribute> - - <attribute name="targetos" type="org.apache.tools.ant.taskdefs.PathConvert.TargetOs" briefType=""windows", "unix", "netware", "os/2"" required="yes, unless pathsep and/or dirsep are specified. "> - - <short-description>Set targetos to a platform to one of - "windows", "unix", "netware", or "os/2"; required unless - unless pathsep and/or dirsep are specified.</short-description> - - <description> - Set targetos to a platform to one of - "windows", "unix", "netware", or "os/2"; required unless - unless pathsep and/or dirsep are specified. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="map" type="org.apache.tools.ant.taskdefs.PathConvert.MapEntry" briefType="" required="NOTDEFINED"> - - <short-description>Create a nested MAP element.</short-description> - - <description> - Create a nested MAP element - </description> - - </element> - - - <element name="path" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create a nested PATH element.</short-description> - - <description> - Create a nested PATH element - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="property" category="other" classname="org.apache.tools.ant.taskdefs.Property"> - - - <short-description>Sets a property by name, or set of properties (from file or resource) in the project.</short-description> - - <description> - Sets a property by name, or set of properties (from file or - resource) in the project. </p> - Properties are immutable: whoever sets a property first freezes it for the - rest of the build; they are most definately not variable. - <p>There are five ways to set properties:</p> - <ul> - <li>By supplying both the <i>name</i> and <i>value</i> attribute.</li> - <li>By supplying both the <i>name</i> and <i>refid</i> attribute.</li> - <li>By setting the <i>file</i> attribute with the filename of the property - file to load. This property file has the format as defined by the file used - in the class java.util.Properties.</li> - <li>By setting the <i>resource</i> attribute with the resource name of the - property file to load. This property file has the format as defined by the - file used in the class java.util.Properties.</li> - <li>By setting the <i>environment</i> attribute with a prefix to use. - Properties will be defined for every environment variable by - prefixing the supplied name and a period to the name of the variable.</li> - </ul> - <p>Although combinations of these ways are possible, only one should be used - at a time. Problems might occur with the order in which properties are set, for - instance.</p> - <p>The value part of the properties being set, might contain references to other - properties. These references are resolved at the time these properties are set. - This also holds for properties loaded from a property file.</p> - Properties are case sensitive. - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>The classpath to use when looking up a resource.</short-description> - - <description> - The classpath to use when looking up a resource. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>The classpath to use when looking up a resource, - given as reference to a &lt;path&gt; defined elsewhere.</short-description> - - <description> - the classpath to use when looking up a resource, - given as reference to a &lt;path&gt; defined elsewhere - </description> - - </attribute> - - <attribute name="environment" type="java.lang.String" briefType="String" required=""> - - <short-description>The prefix to use when retrieving environment variables.</short-description> - - <description> - the prefix to use when retrieving environment variables. - Thus if you specify environment=&quot;myenv&quot; - you will be able to access OS-specific - environment variables via property names &quot;myenv.PATH&quot; or - &quot;myenv.TERM&quot;. - <p> - Note that if you supply a property name with a final - &quot;.&quot; it will not be doubled. ie environment=&quot;myenv.&quot; will still - allow access of environment variables through &quot;myenv.PATH&quot; and - &quot;myenv.TERM&quot;. This functionality is currently only implemented - on select platforms. Feel free to send patches to increase the number of platforms - this functionality is supported on ;).<br> - Note also that properties are case sensitive, even if the - environment variables on your operating system are not, e.g. it - will be ${env.Path} not ${env.PATH} on Windows 2000. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required=""> - - <short-description>The filename of a property file to load.</short-description> - - <description> - the filename of a property file to load. - </description> - - </attribute> - - <attribute name="location" type="java.io.File" briefType="File" required=""> - - <short-description>Property to the absolute filename of the - given file.</short-description> - - <description> - Sets the property to the absolute filename of the - given file. If the value of this attribute is an absolute path, it - is left unchanged (with / and \ characters converted to the - current platforms conventions). Otherwise it is taken as a path - relative to the project's basedir and expanded. - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="no"> - - <short-description>Name of the property to set.</short-description> - - <description> - sets the name of the property to set. - </description> - - </attribute> - - <attribute name="prefix" type="java.lang.String" briefType="String" required="no"> - - <short-description>Prefix to apply to properties loaded using <code>file</code> - or <code>resource</code>.</short-description> - - <description> - Prefix to apply to properties loaded using <code>file</code> - or <code>resource</code>. - A "." is appended to the prefix if not specified. - </description> - - </attribute> - - <attribute name="refid" type="org.apache.tools.ant.types.Reference" briefType="Reference" required=""> - - <short-description>Reference to an Ant datatype - declared elsewhere.</short-description> - - <description> - Sets a reference to an Ant datatype - declared elsewhere. - Only yields reasonable results for references - PATH like structures or properties. - </description> - - </attribute> - - <attribute name="resource" type="java.lang.String" briefType="String" required="one of these, when not using the name attribute"> - - <short-description>The resource name of a property file to load.</short-description> - - <description> - the resource name of a property file to load - </description> - - </attribute> - - <attribute name="value" type="java.lang.String" briefType="String" required="one of these, when using the name attribute"> - - <short-description>Value of the property.</short-description> - - <description> - Sets the value of the property. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>The classpath to use when looking up a resource.</short-description> - - <description> - The classpath to use when looking up a resource. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="propertyfile" category="other" classname="org.apache.tools.ant.taskdefs.optional.PropertyFile"> - - - <short-description>Modifies settings in a property file.</short-description> - - <description> - Modifies settings in a property file. - - <p> -The following is an example of its usage: - <ul>&lt;target name="setState"&gt;<br> - <ul>&lt;property<br> - <ul>name="header"<br> - value="##Generated file - do not modify!"/&gt;<br> - &lt;propertyfile file="apropfile.properties" comment="${header}"&gt;<br> - &lt;entry key="product.version.major" type="int" value="5"/&gt;<br> - &lt;entry key="product.version.minor" type="int" value="0"/&gt;<br> - &lt;entry key="product.build.major" type="int" value="0" /&gt;<br> - &lt;entry key="product.build.minor" type="int" operation="+" /&gt;<br> - &lt;entry key="product.build.date" type="date" value="now" /&gt;<br> - &lt;entry key="intSet" type="int" operation="=" value="681"/&gt;<br> - &lt;entry key="intDec" type="int" operation="-"/&gt;<br> - &lt;entry key="StringEquals" type="string" value="testValue"/&gt;<br> - &lt;/propertyfile&gt;<br></ul> - &lt;/target&gt;</ul><p> - -The &lt;propertyfile&gt; task must have:<br> - <ul><li>file</li></ul> -Other parameters are:<br> - <ul><li>comment, key, operation, type and value (the final four being eliminated shortly)</li></ul> - -The &lt;entry&gt; task must have:<br> - <ul><li>key</li></ul> -Other parameters are:<br> - <ul><li>operation</li> - <li>type</li> - <li>value</li> - <li>default</li> - <li>unit</li> - </ul> - -If type is unspecified, it defaults to string - -Parameter values:<br> - <ul><li>operation:</li> - <ul><li>"=" (set -- default)</li> - <li>"-" (dec)</li> - <li>"+" (inc)</li> - - <li>type:</li> - <ul><li>"int"</li> - <li>"date"</li> - <li>"string"</li></ul></ul> - - <li>value:</li> - <ul><li>holds the default value, if the property - was not found in property file</li> - <li>"now" In case of type "date", the - value "now" will be replaced by the current - date/time and used even if a valid date was - found in the property file.</li></ul> - -String property types can only use the "=" operation. -Int property types can only use the "=", "-" or "+" operations.<p> - -The message property is used for the property file header, with "\\" being -a newline delimiter character. - </description> - - - <structure> - - - <attributes> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Optional header comment for the file.</short-description> - - <description> - optional header comment for the file - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Location of the property file to be edited; required.</short-description> - - <description> - Location of the property file to be edited; required. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="entry" type="org.apache.tools.ant.taskdefs.optional.PropertyFile.Entry" briefType="" required="NOTDEFINED"> - - <short-description>No description.</short-description> - - <description> - - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="pvcs" category="other" classname="org.apache.tools.ant.taskdefs.optional.pvcs.Pvcs"> - - - <short-description>Extracts the latest edition of the source code from a PVCS repository.</short-description> - - <description> - Extracts the latest edition of the source code from a PVCS repository. - PVCS is a version control system - developed by <a href="http://www.merant.com/products/pvcs">Merant</a>. - <br> - Before using this tag, the user running ant must have access to the commands - of PVCS (get and pcli) and must have access to the repository. Note that the way to specify - the repository is platform dependent so use property to specify location of repository. - <br> - This version has been tested agains PVCS version 6.5 and 6.6 under Windows and Solaris. - - <b>19-04-2001</b> <p>The task now has a more robust - parser. It allows for platform independant file paths - and supports file names with <i>()</i>. Thanks to Erik Husby for - bringing the bug to my attention. - - <b>27-04-2001</b> <p>UNC paths are now handled properly. - Fix provided by Don Jeffery. He also added an <i>UpdateOnly</i> flag - that, when true, conditions the PVCS get using the -U option to only - update those files that have a modification time (in PVCS) that is newer - than the existing workfile. - </description> - - - <structure> - - - <attributes> - - <attribute name="filenameformat" type="java.lang.String" briefType="String" required="no"> - - <short-description>The format of the folder names; optional.</short-description> - - <description> - The format of the folder names; optional. - This must be in a format suitable for - <code>java.text.MessageFormat</code>. - Index 1 of the format will be used as the file name. - Defaults to <code>{0}-arc({1})</code> - </description> - - </attribute> - - <attribute name="force" type="java.lang.String" briefType="String" required="no"> - - <short-description>Specifies the value of the force argument; optional.</short-description> - - <description> - Specifies the value of the force argument; optional. - If set to <i>yes</i> all files that exists and are - writable are overwritten. Default <i>no</i> causes the files - that are writable to be ignored. This stops the PVCS command - <i>get</i> to stop asking questions! - </description> - - </attribute> - - <attribute name="ignorereturncode" type="boolean" briefType="boolean" required="no"> - - <short-description>If set to true the return value from executing the pvcs - commands are ignored; optional, default false.</short-description> - - <description> - If set to true the return value from executing the pvcs - commands are ignored; optional, default false. - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="no"> - - <short-description>Only files marked with this label are extracted; optional.</short-description> - - <description> - Only files marked with this label are extracted; optional. - </description> - - </attribute> - - <attribute name="linestart" type="java.lang.String" briefType="String" required="no"> - - <short-description>What a valid return value from PVCS looks like - when it describes a file.</short-description> - - <description> - What a valid return value from PVCS looks like - when it describes a file. Defaults to <code>&quot;P:</code>. - If you are not using an UNC name for your repository and the - drive letter <code>P</code> is incorrect for your setup, you may - need to change this value, UNC names will always be - accepted. - </description> - - </attribute> - - <attribute name="promotiongroup" type="java.lang.String" briefType="String" required="no"> - - <short-description>Specifies the name of the promotiongroup argument.</short-description> - - <description> - Specifies the name of the promotiongroup argument - </description> - - </attribute> - - <attribute name="pvcsbin" type="java.lang.String" briefType="String" required="no"> - - <short-description>Specifies the location of the PVCS bin directory; optional if on the PATH.</short-description> - - <description> - Specifies the location of the PVCS bin directory; optional if on the PATH. - On some systems the PVCS executables <i>pcli</i> - and <i>get</i> are not found in the PATH. In such cases this attribute - should be set to the bin directory of the PVCS installation containing - the executables mentioned before. If this attribute isn't specified the - tag expects the executables to be found using the PATH environment variable. - </description> - - </attribute> - - <attribute name="pvcsproject" type="java.lang.String" briefType="String" required="no"> - - <short-description>The project within the PVCS repository to extract files from; - optional, default &quot;/&quot;.</short-description> - - <description> - The project within the PVCS repository to extract files from; - optional, default &quot;/&quot; - </description> - - </attribute> - - <attribute name="repository" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The network name of the PVCS repository; required.</short-description> - - <description> - The network name of the PVCS repository; required. - </description> - - </attribute> - - <attribute name="updateonly" type="boolean" briefType="boolean" required="no"> - - <short-description>If set to <i>true</i> files are fetched only if - newer than existing local files; optional, default false.</short-description> - - <description> - If set to <i>true</i> files are fetched only if - newer than existing local files; optional, default false. - </description> - - </attribute> - - <attribute name="workspace" type="java.lang.String" briefType="String" required="no"> - - <short-description>Workspace to use; optional.</short-description> - - <description> - Workspace to use; optional. - By specifying a workspace, the files are extracted to that location. - A PVCS workspace is a name for a location of the workfiles and - isn't as such the location itself. - You define the location for a workspace using the PVCS GUI clients. - If this isn't specified the default workspace for the current user is used. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="pvcsproject" type="org.apache.tools.ant.taskdefs.optional.pvcs.PvcsProject" briefType="" required="NOTDEFINED"> - - <short-description>Specify a project within the PVCS repository to extract files from.</short-description> - - <description> - Specify a project within the PVCS repository to extract files from. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="record" category="utility" classname="org.apache.tools.ant.taskdefs.Recorder"> - - - <short-description>Adds a listener to the current build process that records the output to a file.</short-description> - - <description> - Adds a listener to the current build process that records the - output to a file. - <p>Several recorders can exist at the same time. Each recorder is - associated with a file. The filename is used as a unique identifier for - the recorders. The first call to the recorder task with an unused filename - will create a recorder (using the parameters provided) and add it to the - listeners of the build. All subsequent calls to the recorder task using - this filename will modify that recorders state (recording or not) or other - properties (like logging level).</p> - <p>Some technical issues: the file's print stream is flushed for &quot;finished&quot; - events (buildFinished, targetFinished and taskFinished), and is closed on - a buildFinished event.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="action" type="org.apache.tools.ant.taskdefs.Recorder.ActionChoices" briefType=""start", "stop"" required="NOTDEFINED"> - - <short-description>Action for the associated recorder entry.</short-description> - - <description> - Sets the action for the associated recorder entry. - </description> - - </attribute> - - <attribute name="append" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Whether or not the logger should append to a previous file.</short-description> - - <description> - Whether or not the logger should append to a previous file. - </description> - - </attribute> - - <attribute name="emacsmode" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>No description.</short-description> - - <description> - </description> - - </attribute> - - <attribute name="loglevel" type="org.apache.tools.ant.taskdefs.Recorder.VerbosityLevelChoices" briefType=""error", "warn", "info", "verbose", "debug"" required="NOTDEFINED"> - - <short-description>Level to which this recorder entry should log to.</short-description> - - <description> - Sets the level to which this recorder entry should log to. - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name of the file to log to, and the name of the recorder - entry.</short-description> - - <description> - Sets the name of the file to log to, and the name of the recorder - entry. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="rename" category="other" classname="org.apache.tools.ant.taskdefs.Rename" deprecated="true"> - - - <short-description>Renames a file.</short-description> - - <description> - Renames a file. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>New name of the file.</short-description> - - <description> - Sets the new name of the file. - </description> - - </attribute> - - <attribute name="replace" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets whether an existing file should be replaced.</short-description> - - <description> - Sets whether an existing file should be replaced. - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="yes"> - - <short-description>File to be renamed.</short-description> - - <description> - Sets the file to be renamed. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="renameextensions" category="other" classname="org.apache.tools.ant.taskdefs.optional.RenameExtensions" deprecated="true" matchingTask="true"> - - - <short-description>No Description.</short-description> - - <description> - - </description> - - - <structure> - - - <attributes> - - <attribute name="fromextension" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The string that files must end in to be renamed.</short-description> - - <description> - The string that files must end in to be renamed - </description> - - </attribute> - - <attribute name="replace" type="boolean" briefType="boolean" required="no"> - - <short-description>Store replace attribute - this determines whether the target file - should be overwritten if present.</short-description> - - <description> - store replace attribute - this determines whether the target file - should be overwritten if present - </description> - - </attribute> - - <attribute name="srcdir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Source dir to find the files to be renamed.</short-description> - - <description> - Set the source dir to find the files to be renamed. - </description> - - </attribute> - - <attribute name="toextension" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The string that renamed files will end with on - completion.</short-description> - - <description> - The string that renamed files will end with on - completion - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="replace" category="filesystem" classname="org.apache.tools.ant.taskdefs.Replace" matchingTask="true"> - - - <short-description>Replaces all occurrences of one or more string tokens with given values in the indicated files.</short-description> - - <description> - Replaces all occurrences of one or more string tokens with given - values in the indicated files. Each value can be either a string - or the value of a property available in a designated property file. - If you want to replace a text that crosses line boundaries, you - must use a nested <code>&lt;replacetoken&gt;</code> element. - </description> - - - <structure> - - - <attributes> - - <attribute name="dir" type="java.io.File" briefType="File" required=""> - - <short-description>The base directory to use when replacing a token in multiple files; - required if <code>file</code> is not defined.</short-description> - - <description> - The base directory to use when replacing a token in multiple files; - required if <code>file</code> is not defined. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no - defaults to default jvm encoding"> - - <short-description>File encoding to use on the files read and written by the task; - optional, defaults to default JVM encoding.</short-description> - - <description> - Set the file encoding to use on the files read and written by the task; - optional, defaults to default JVM encoding - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="exactly one of the two."> - - <short-description>Source file; required unless <code>dir</code> is set.</short-description> - - <description> - Set the source file; required unless <code>dir</code> is set. - </description> - - </attribute> - - <attribute name="propertyfile" type="java.io.File" briefType="File" required="yes only if property attribute of <replacefilter> is used."> - - <short-description>The name of a property file from which properties specified using - nested <code>&lt;replacefilter&gt;</code> elements are drawn; - Required only if <i>property</i> attribute of - <code>&lt;replacefilter&gt;</code> is used.</short-description> - - <description> - The name of a property file from which properties specified using - nested <code>&lt;replacefilter&gt;</code> elements are drawn; - Required only if <i>property</i> attribute of - <code>&lt;replacefilter&gt;</code> is used. - </description> - - </attribute> - - <attribute name="replacefilterfile" type="java.io.File" briefType="File" required="no."> - - <short-description>Name of a property file containing filters; optional.</short-description> - - <description> - Sets the name of a property file containing filters; optional. - Each property will be treated as a - replacefilter where token is the name of the property and value - is the value of the property. - </description> - - </attribute> - - <attribute name="summary" type="boolean" briefType="boolean" required="no, by default no summary is produced"> - - <short-description>Indicates whether a summary of the replace operation should be - produced, detailing how many token occurrences and files were - processed; optional, default=false.</short-description> - - <description> - Indicates whether a summary of the replace operation should be - produced, detailing how many token occurrences and files were - processed; optional, default=false - </description> - - </attribute> - - <attribute name="token" type="java.lang.String" briefType="String" required="yes, unless a nested replacetoken element or the replacefilterfile attribute is used."> - - <short-description>String token to replace; - required unless a nested - <code>replacetoken</code> element or the <code>replacefilterfile</code> - attribute is used.</short-description> - - <description> - Set the string token to replace; - required unless a nested - <code>replacetoken</code> element or the <code>replacefilterfile</code> - attribute is used. - </description> - - </attribute> - - <attribute name="value" type="java.lang.String" briefType="String" required="no"> - - <short-description>String value to use as token replacement; - optional, default is the empty string "".</short-description> - - <description> - Set the string value to use as token replacement; - optional, default is the empty string "" - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="replacetoken" type="org.apache.tools.ant.taskdefs.Replace.NestedString" briefType="" required="NOTDEFINED"> - - <short-description>The token to filter as the text of a nested element.</short-description> - - <description> - the token to filter as the text of a nested element - </description> - - </element> - - - <element name="replacevalue" type="org.apache.tools.ant.taskdefs.Replace.NestedString" briefType="" required="NOTDEFINED"> - - <short-description>The string to replace the token as the text of a nested element.</short-description> - - <description> - the string to replace the token as the text of a nested element - </description> - - </element> - - - <element name="replacefilter" type="org.apache.tools.ant.taskdefs.Replace.Replacefilter" briefType="" required="NOTDEFINED"> - - <short-description>Add a nested &lt;replacefilter&gt; element.</short-description> - - <description> - Add a nested &lt;replacefilter&gt; element. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="replaceregexp" category="other" classname="org.apache.tools.ant.taskdefs.optional.ReplaceRegExp"> - - - <short-description>Performs regular expression string replacements in a text file.</short-description> - - <description> - Performs regular expression string replacements in a text - file. The input file(s) must be able to be properly processed by - a Reader instance. That is, they must be text only, no binary. - - The syntax of the regular expression depends on the implemtation that - you choose to use. The system property <code>ant.regexp.regexpimpl</code> - will be the classname of the implementation that will be used (the default - is <code>org.apache.tools.ant.util.regexp.JakartaOroRegexp</code> and - requires the Jakarta Oro Package). - - <pre> - For jdk &lt;= 1.3, there are two available implementations: - org.apache.tools.ant.util.regexp.JakartaOroRegexp (the default) - Requires the jakarta-oro package - - org.apache.tools.ant.util.regexp.JakartaRegexpRegexp - Requires the jakarta-regexp package - - For jdk &gt;= 1.4 an additional implementation is available: - org.apache.tools.ant.util.regexp.Jdk14RegexpRegexp - Requires the jdk 1.4 built in regular expression package. - - Usage: - - Call Syntax: - - &lt;replaceregexp file="file" - match="pattern" - replace="pattern" - flags="options"? - byline="true|false"? &gt; - regexp? - substitution? - fileset* - &lt;/replaceregexp&gt; - - NOTE: You must have either the file attribute specified, or at least one fileset subelement - to operation on. You may not have the file attribute specified if you nest fileset elements - inside this task. Also, you cannot specify both match and a regular expression subelement at - the same time, nor can you specify the replace attribute and the substitution subelement at - the same time. - - Attributes: - - file --&gt; A single file to operation on (mutually exclusive with the fileset subelements) - match --&gt; The Regular expression to match - replace --&gt; The Expression replacement string - flags --&gt; The options to give to the replacement - g = Substitute all occurrences. default is to replace only the first one - i = Case insensitive match - - byline --&gt; Should this file be processed a single line at a time (default is false) - "true" indicates to perform replacement on a line by line basis - "false" indicates to perform replacement on the whole file at once. - - Example: - - The following call could be used to replace an old property name in a ".properties" - file with a new name. In the replace attribute, you can refer to any part of the - match expression in parenthesis using backslash followed by a number like '\1'. - - &lt;replaceregexp file="test.properties" - match="MyProperty=(.*)" - replace="NewProperty=\1" - byline="true" /&gt; - - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="byline" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Process the file(s) one line at a time, executing the replacement - on one line at a time.</short-description> - - <description> - Process the file(s) one line at a time, executing the replacement - on one line at a time. This is useful if you - want to only replace the first occurence of a regular expression on - each line, which is not easy to do when processing the file as a whole. - Defaults to <i>false</i>.</td> - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>File for which the regular expression should be replaced; - required unless a nested fileset is supplied.</short-description> - - <description> - file for which the regular expression should be replaced; - required unless a nested fileset is supplied. - </description> - - </attribute> - - <attribute name="flags" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The flags to use when matching the regular expression.</short-description> - - <description> - The flags to use when matching the regular expression. For more - information, consult the Perl5 syntax. - <ul> - <li>g : Global replacement. Replace all occurences found - <li>i : Case Insensitive. Do not consider case in the match - <li>m : Multiline. Treat the string as multiple lines of input, - using "^" and "$" as the start or end of any line, respectively, rather than start or end of string. - <li> s : Singleline. Treat the string as a single line of input, using - "." to match any character, including a newline, which normally, it would not match. -</ul> - </description> - - </attribute> - - <attribute name="match" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The regular expression pattern to match in the file(s); - required if no nested &lt;regexp&gt; is used.</short-description> - - <description> - the regular expression pattern to match in the file(s); - required if no nested &lt;regexp&gt; is used - </description> - - </attribute> - - <attribute name="replace" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The substitution pattern to place in the file(s) in place - of the regular expression.</short-description> - - <description> - The substitution pattern to place in the file(s) in place - of the regular expression. - Required if no nested &lt;substitution&gt; is used - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>List files to apply the replacement to.</short-description> - - <description> - list files to apply the replacement to - </description> - - </element> - - - <element name="regexp" type="org.apache.tools.ant.types.RegularExpression" briefType="" required="NOTDEFINED"> - - <short-description>A regular expression.</short-description> - - <description> - A regular expression. - You can use this element to refer to a previously - defined regular expression datatype instance - </description> - - </element> - - - <element name="substitution" type="org.apache.tools.ant.types.Substitution" briefType="" required="NOTDEFINED"> - - <short-description>A substitution pattern.</short-description> - - <description> - A substitution pattern. You can use this element to refer to a previously - defined substitution pattern datatype instance. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="rmic" category="java" classname="org.apache.tools.ant.taskdefs.Rmic" matchingTask="true"> - - - <short-description>Runs the rmic compiler against classes.</p> <p>Rmic can be run on a single class (as specified with the classname attribute) or a number of classes at once (all classes below base that are neither _Stub nor _Skel classes).</short-description> - - <description> - Runs the rmic compiler against classes.</p> - <p>Rmic can be run on a single class (as specified with the classname - attribute) or a number of classes at once (all classes below base that - are neither _Stub nor _Skel classes). If you want to rmic a single - class and this class is a class nested into another class, you have to - specify the classname in the form <code>Outer$$Inner</code> instead of - <code>Outer.Inner</code>.</p> - <p>It is possible to refine the set of files that are being rmiced. This can be - done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, - <i>excludesfile</i> and <i>defaultexcludes</i> - attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to - have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify - the files you want to have excluded. This is also done with patterns. And - finally with the <i>defaultexcludes</i> attribute, you can specify whether you - want to use default exclusions or not. See the section on - directory based tasks</a>, on how the - inclusion/exclusion of files works, and how to write patterns.</p> - <p>This task forms an implicit FileSet and - supports all attributes of <code>&lt;fileset&gt;</code> - (<code>dir</code> becomes <code>base</code>) as well as the nested - <code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and - <code>&lt;patternset&gt;</code> elements.</p> - <p>It is possible to use different compilers. This can be selected - with the &quot;build.rmic&quot; property or the <code>compiler</code> - attribute. <a name="compilervalues">There are three choices</a>:</p> - <ul> - <li>sun (the standard compiler of the JDK)</li> - <li>kaffe (the standard compiler of - {@link <a href="http://www.kaffe.org">Kaffe</a>})</li> - <li>weblogic</li> - </ul> - <p> The <a href="http://dione.zcu.cz/~toman40/miniRMI/">miniRMI</a> - project contains a compiler implementation for this task as well, - please consult miniRMI's documentation to learn how to use it.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="base" type="java.io.File" briefType="File" required="yes"> - - <short-description>Location to store the compiled files; required.</short-description> - - <description> - Sets the location to store the compiled files; required - </description> - - </attribute> - - <attribute name="classname" type="java.lang.String" briefType="String" required="no"> - - <short-description>The class to run <code>rmic</code> against; - optional.</short-description> - - <description> - Sets the the class to run <code>rmic</code> against; - optional - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Adds to the classpath a reference to - a &lt;path&gt; defined elsewhere.</short-description> - - <description> - Adds to the classpath a reference to - a &lt;path&gt; defined elsewhere. - </description> - - </attribute> - - <attribute name="compiler" type="java.lang.String" briefType="String" required="no"> - - <short-description>Compiler implementation to use; optional, - defaults to the value of the <code>build.rmic</code> property, - or failing that, default compiler for the current VM.</short-description> - - <description> - Sets the compiler implementation to use; optional, - defaults to the value of the <code>build.rmic</code> property, - or failing that, default compiler for the current VM - </description> - - </attribute> - - <attribute name="debug" type="boolean" briefType="boolean" required="no"> - - <short-description>Generate debug info (passes -g to rmic); - optional, defaults to false.</short-description> - - <description> - generate debug info (passes -g to rmic); - optional, defaults to false - </description> - - </attribute> - - <attribute name="extdirs" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Extension directories that will be used during the - compilation; optional.</short-description> - - <description> - Sets the extension directories that will be used during the - compilation; optional. - </description> - - </attribute> - - <attribute name="filtering" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicates whether token filtering should take place; - optional, default=false.</short-description> - - <description> - indicates whether token filtering should take place; - optional, default=false - </description> - - </attribute> - - <attribute name="idl" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicates that IDL output should be - generated.</short-description> - - <description> - Indicates that IDL output should be - generated. This defaults to false - if not set. - </description> - - </attribute> - - <attribute name="idlopts" type="java.lang.String" briefType="String" required="no"> - - <short-description>Pass additional arguments for idl compile.</short-description> - - <description> - pass additional arguments for idl compile - </description> - - </attribute> - - <attribute name="iiop" type="boolean" briefType="boolean" required="no"> - - <short-description>Indicates that IIOP compatible stubs should - be generated; optional, defaults to false - if not set.</short-description> - - <description> - Indicates that IIOP compatible stubs should - be generated; optional, defaults to false - if not set. - </description> - - </attribute> - - <attribute name="iiopopts" type="java.lang.String" briefType="String" required="no"> - - <short-description>Set additional arguments for iiop.</short-description> - - <description> - Set additional arguments for iiop - </description> - - </attribute> - - <attribute name="includeantruntime" type="boolean" briefType="boolean" required="no"> - - <short-description>Sets whether or not to include ant's own classpath in this task's - classpath.</short-description> - - <description> - Sets whether or not to include ant's own classpath in this task's - classpath. - Optional; default is <code>true</code>. - </description> - - </attribute> - - <attribute name="includejavaruntime" type="boolean" briefType="boolean" required="no"> - - <short-description>Task's classpath.</short-description> - - <description> - task's classpath. - Enables or disables including the default run-time - libraries from the executing VM; optional, - defaults to false - </description> - - </attribute> - - <attribute name="sourcebase" type="java.io.File" briefType="File" required="no"> - - <short-description>Optional directory to save generated source files to.</short-description> - - <description> - optional directory to save generated source files to. - </description> - - </attribute> - - <attribute name="stubversion" type="java.lang.String" briefType="String" required="no"> - - <short-description>Specify the JDK version for the generated stub code.</short-description> - - <description> - Specify the JDK version for the generated stub code. - Specify &quot;1.1&quot; to pass the &quot;-v1.1&quot; option to rmic.</td> - </description> - - </attribute> - - <attribute name="verify" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag to enable verification so that the classes - found by the directory match are - checked to see if they implement java.rmi.Remote.</short-description> - - <description> - Flag to enable verification so that the classes - found by the directory match are - checked to see if they implement java.rmi.Remote. - Optional; his defaults to false if not set. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Creates a nested classpath element.</short-description> - - <description> - Creates a nested classpath element. - </description> - - </element> - - - <element name="compilerarg" type="org.apache.tools.ant.taskdefs.Rmic.ImplementationSpecificArgument" briefType="" required="NOTDEFINED"> - - <short-description>Adds an implementation specific command line argument.</short-description> - - <description> - Adds an implementation specific command line argument. - </description> - - </element> - - - <element name="extdirs" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Maybe creates a nested extdirs element.</short-description> - - <description> - Maybe creates a nested extdirs element. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="rpm" category="other" classname="org.apache.tools.ant.taskdefs.optional.Rpm"> - - - <short-description>Invokes the rpm tool to build a Linux installation file.</short-description> - - <description> - Invokes the rpm tool to build a Linux installation file. - </description> - - - <structure> - - - <attributes> - - <attribute name="cleanbuilddir" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag (optional, default=false) to remove - the generated files in the BUILD directory.</short-description> - - <description> - Flag (optional, default=false) to remove - the generated files in the BUILD directory - </description> - - </attribute> - - <attribute name="command" type="java.lang.String" briefType="String" required="no"> - - <short-description>What command to issue to the rpm tool; optional.</short-description> - - <description> - What command to issue to the rpm tool; optional. - The default is "-bb" - </description> - - </attribute> - - <attribute name="error" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Optional file to save stderr to.</short-description> - - <description> - Optional file to save stderr to - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Optional file to save stdout to.</short-description> - - <description> - Optional file to save stdout to. - </description> - - </attribute> - - <attribute name="removesource" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag (optional, default=false) - to remove the sources after the build.</short-description> - - <description> - Flag (optional, default=false) - to remove the sources after the build. - See the the <tt>--rmsource</tt> option of rpmbuild. - </description> - - </attribute> - - <attribute name="removespec" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag (optional, default=false) to remove the spec file from SPECS.</short-description> - - <description> - Flag (optional, default=false) to remove the spec file from SPECS - </description> - - </attribute> - - <attribute name="specfile" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The name of the spec File to use; required.</short-description> - - <description> - The name of the spec File to use; required. - </description> - - </attribute> - - <attribute name="topdir" type="java.io.File" briefType="File" required="no"> - - <short-description>The directory which will have the expected - subdirectories, SPECS, SOURCES, BUILD, SRPMS ; optional.</short-description> - - <description> - The directory which will have the expected - subdirectories, SPECS, SOURCES, BUILD, SRPMS ; optional. - If this isn't specified, - the <tt>baseDir</tt> value is used - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="script" category="other" classname="org.apache.tools.ant.taskdefs.optional.Script"> - - - <short-description>Executes a script.</short-description> - - <description> - Executes a script. - </description> - - - <structure> - - - <attributes> - - <attribute name="language" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Defines the language (required).</short-description> - - <description> - Defines the language (required). - </description> - - </attribute> - - <attribute name="src" type="java.lang.String" briefType="String" required="no"> - - <short-description>Load the script from an external file ; optional.</short-description> - - <description> - Load the script from an external file ; optional. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - <body> - - <description> - The script text. - </description> - - </body> - - - </structure> - - - </task> - - - - <task name="sequential" category="control" classname="org.apache.tools.ant.taskdefs.Sequential"> - - - <short-description>Sequential is a container task - it can contain other Ant tasks.</short-description> - - <description> - Sequential is a container task - it can contain other Ant tasks. The nested - tasks are simply executed in sequence. Sequential's primary use is to support - the sequential execution of a subset of tasks within the -{@link Parallel Parallel Task} - - <p> - The sequential task has no attributes and does not support any nested - elements apart from Ant tasks. Any valid Ant task may be embedded within the - sequential task.</p> - </description> - - - <structure> - - - <attributes> - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="serverdeploy" category="other" classname="org.apache.tools.ant.taskdefs.optional.j2ee.ServerDeploy"> - - - <short-description>Controls hot deployment tools for J2EE servers.</short-description> - - <description> - Controls hot deployment tools for J2EE servers. - - This class is used as a framework for the creation of vendor specific - hot deployment tools. - </description> - - - <structure> - - - <attributes> - - <attribute name="action" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The action to be performed, usually "deploy"; required.</short-description> - - <description> - The action to be performed, usually "deploy"; required. - Some tools support additional actions, such as "delete", "list", "undeploy", "update"... - </description> - - </attribute> - - <attribute name="source" type="java.io.File" briefType="File" required="tool dependant"> - - <short-description>The filename of the component to be deployed; optional - depending upon the tool and the action.</short-description> - - <description> - The filename of the component to be deployed; optional - depending upon the tool and the action. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="generic" type="org.apache.tools.ant.taskdefs.optional.j2ee.GenericHotDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Creates a generic deployment tool.</short-description> - - <description> - Creates a generic deployment tool. - <p>Ant calls this method on creation to handle embedded "generic" elements - in the ServerDeploy task. - </description> - - </element> - - - <element name="jonas" type="org.apache.tools.ant.taskdefs.optional.j2ee.JonasHotDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Creates a JOnAS deployment tool, for deployment to JOnAS servers.</short-description> - - <description> - Creates a JOnAS deployment tool, for deployment to JOnAS servers. - <p>Ant calls this method on creation to handle embedded "jonas" elements - in the ServerDeploy task. - </description> - - </element> - - - <element name="weblogic" type="org.apache.tools.ant.taskdefs.optional.j2ee.WebLogicHotDeploymentTool" briefType="" required="NOTDEFINED"> - - <short-description>Creates a WebLogic deployment tool, for deployment to WebLogic servers.</short-description> - - <description> - Creates a WebLogic deployment tool, for deployment to WebLogic servers. - <p>Ant calls this method on creation to handle embedded "weblogic" elements - in the ServerDeploy task. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="setproxy" category="other" classname="org.apache.tools.ant.taskdefs.optional.net.SetProxy"> - - - <short-description>Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites.</short-description> - - <description> - Sets Java's web proxy properties, so that tasks and code run in - the same JVM can have through-the-firewall access to remote web sites, - and remote ftp sites. - You can nominate an http and ftp proxy, or a socks server, reset the server - settings, or do nothing at all. - <p> - Examples - <pre>&lt;setproxy/&gt;</pre> - do nothing - <pre>&lt;setproxy proxyhost="firewall"/&gt;</pre> - set the proxy to firewall:80 - <pre>&lt;setproxy proxyhost="firewall" proxyport="81"/&gt;</pre> - set the proxy to firewall:81 - <pre>&lt;setproxy proxyhost=""/&gt;</pre> - stop using the http proxy; don't change the socks settings - <pre>&lt;setproxy socksproxyhost="socksy"/&gt;</pre> - use socks via socksy:1080 - <pre>&lt;setproxy socksproxyhost=""/&gt;</pre> - stop using the socks server - </description> - - - <structure> - - - <attributes> - - <attribute name="nonproxyhosts" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A list of hosts to bypass the proxy on.</short-description> - - <description> - A list of hosts to bypass the proxy on. These should be separated - with the vertical bar character '|'. Only in Java 1.4 does ftp use - this list. - e.g. fozbot.corp.sun.com|*.eng.sun.com - </description> - - </attribute> - - <attribute name="proxyhost" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The HTTP/ftp proxy host.</short-description> - - <description> - the HTTP/ftp proxy host. Set this to "" for the http proxy - option to be disabled - </description> - - </attribute> - - <attribute name="proxyport" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>The HTTP/ftp proxy port number; default is 80.</short-description> - - <description> - the HTTP/ftp proxy port number; default is 80 - </description> - - </attribute> - - <attribute name="socksproxyhost" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of a Socks server.</short-description> - - <description> - The name of a Socks server. Set to "" to turn socks - proxying off. - </description> - - </attribute> - - <attribute name="socksproxyport" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>ProxyPort for socks connections.</short-description> - - <description> - Set the ProxyPort for socks connections. The default value is 1080 - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="signjar" category="java" classname="org.apache.tools.ant.taskdefs.SignJar"> - - - <short-description>Signs jar or zip files with the javasign command line tool.</short-description> - - <description> - Signs jar or zip files with the javasign command line tool. The - tool detailed dependency checking: files are only signed if they - are not signed. The <tt>signjar</tt> attribute can point to the file to - generate; if this file exists then - its modification date is used as a cue as to whether to resign any JAR file. - <br> - <strong>Note:</strong> Requires Java 1.2 or later. </p> - </description> - - - <structure> - - - <attributes> - - <attribute name="alias" type="java.lang.String" briefType="String" required="yes."> - - <short-description>The alias to sign under; required.</short-description> - - <description> - the alias to sign under; required - </description> - - </attribute> - - <attribute name="internalsf" type="boolean" briefType="boolean" required="no; default false"> - - <short-description>Flag to include the .SF file inside the signature; - optional; default false.</short-description> - - <description> - Flag to include the .SF file inside the signature; - optional; default false - </description> - - </attribute> - - <attribute name="jar" type="java.io.File" briefType="File" required="yes."> - - <short-description>The jar file to sign; required.</short-description> - - <description> - the jar file to sign; required - </description> - - </attribute> - - <attribute name="keypass" type="java.lang.String" briefType="String" required="no"> - - <short-description>Password for private key (if different); optional.</short-description> - - <description> - password for private key (if different); optional - </description> - - </attribute> - - <attribute name="keystore" type="java.io.File" briefType="File" required="no"> - - <short-description>Keystore location; required.</short-description> - - <description> - keystore location; required - </description> - - </attribute> - - <attribute name="lazy" type="boolean" briefType="boolean" required="no; default false"> - - <short-description>Flag to control whether the presence of a signature - file means a JAR is signed; - optional, default false.</short-description> - - <description> - flag to control whether the presence of a signature - file means a JAR is signed; - optional, default false - </description> - - </attribute> - - <attribute name="sectionsonly" type="boolean" briefType="boolean" required="no; default false"> - - <short-description>Flag to compute hash of entire manifest; - optional, default false.</short-description> - - <description> - flag to compute hash of entire manifest; - optional, default false - </description> - - </attribute> - - <attribute name="sigfile" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of .SF/.DSA file; optional.</short-description> - - <description> - name of .SF/.DSA file; optional - </description> - - </attribute> - - <attribute name="signedjar" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of signed JAR file; optional.</short-description> - - <description> - name of signed JAR file; optional - </description> - - </attribute> - - <attribute name="storepass" type="java.lang.String" briefType="String" required="yes."> - - <short-description>Password for keystore integrity; required.</short-description> - - <description> - password for keystore integrity; required - </description> - - </attribute> - - <attribute name="storetype" type="java.lang.String" briefType="String" required="no"> - - <short-description>Keystore type; optional.</short-description> - - <description> - keystore type; optional - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="no; default false"> - - <short-description>Enable verbose output when signing - ; optional: default false.</short-description> - - <description> - Enable verbose output when signing - ; optional: default false - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files to sign.</short-description> - - <description> - Adds a set of files to sign - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="sleep" category="utility" classname="org.apache.tools.ant.taskdefs.Sleep"> - - - <short-description>Sleep, or pause, for a period of time.</short-description> - - <description> - Sleep, or pause, for a period of time. - - A task for sleeping a short period of time, useful when a - build or deployment process requires an interval between tasks. -<p> - A negative value can be supplied to any of attributes provided the total sleep time - is positive, pending fundamental changes in physics and JVM - execution tims</p> - Note that sleep times are always hints to be interpred by the OS how it feels - small times may either be ignored or rounded up to a minimum timeslice. Note - also that the system clocks often have a fairly low granularity too, which complicates - measuring how long a sleep actually took.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Flag controlling whether to break the build on an error.</short-description> - - <description> - flag controlling whether to break the build on an error. - </description> - - </attribute> - - <attribute name="hours" type="int" briefType="int" required="no"> - - <short-description>Hours to add to the sleep time.</short-description> - - <description> - hours to add to the sleep time. - </description> - - </attribute> - - <attribute name="milliseconds" type="int" briefType="int" required="no"> - - <short-description>Milliseconds to add to the sleep time.</short-description> - - <description> - milliseconds to add to the sleep time - </description> - - </attribute> - - <attribute name="minutes" type="int" briefType="int" required="no"> - - <short-description>Minutes to add to the sleep time.</short-description> - - <description> - minutes to add to the sleep time - </description> - - </attribute> - - <attribute name="seconds" type="int" briefType="int" required="no"> - - <short-description>Seconds to add to the sleep time.</short-description> - - <description> - seconds to add to the sleep time - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="soscheckin" category="other" classname="org.apache.tools.ant.taskdefs.optional.sos.SOSCheckin"> - - - <short-description>Commits and unlocks files in Visual SourceSafe via a SourceOffSite server.</short-description> - - <description> - Commits and unlocks files in Visual SourceSafe via a SourceOffSite server. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>file</td> - <td>Filename to act upon<br> If no file is specified then act upon the project</td> - <td>No</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>soshome</td> - <td>The path to the SourceOffSite home directory</td> - <td>No</td> - </tr> - <tr> - <td>nocompression</td> - <td>true or false - disable compression</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false - Only works with the CheckOutProject command</td> - <td>No</td> - </tr> - <tr> - <td>nocache</td> - <td>true or false - Only needed if SOSHOME is set as an enviroment variable</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - <td>comment</td> - <td>A comment to be applied to all files being checked in</td> - <td>No</td> - </tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply to all files being labelled; - optional, only valid in SOSLabel.</short-description> - - <description> - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - </description> - - </attribute> - - <attribute name="file" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Filename to act upon; optional.</short-description> - - <description> - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Labeled version to operate on in SourceSafe.</short-description> - - <description> - Set the labeled version to operate on in SourceSafe - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Override the working directory and get to the specified path; optional.</short-description> - - <description> - Override the working directory and get to the specified path; optional. - </description> - - </attribute> - - <attribute name="nocache" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.</short-description> - - <description> - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - </description> - - </attribute> - - <attribute name="nocompress" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag that disables compression when set; optional, default.</short-description> - - <description> - Flag that disables compression when set; optional, default - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe password; optional.</short-description> - - <description> - Set the SourceSafe password; optional. - </description> - - </attribute> - - <attribute name="projectpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe project path without the "$" prefix; required.</short-description> - - <description> - Set the SourceSafe project path without the "$" prefix; required - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.</short-description> - - <description> - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - </description> - - </attribute> - - <attribute name="soscmd" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.</short-description> - - <description> - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - </description> - - </attribute> - - <attribute name="soshome" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The path to the SourceOffSite home directory.</short-description> - - <description> - The path to the SourceOffSite home directory - </description> - - </attribute> - - <attribute name="sosserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.</short-description> - - <description> - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - </description> - - </attribute> - - <attribute name="username" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe username; required.</short-description> - - <description> - Set the SourceSafe username; required. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Enable verbose output; optional, default false.</short-description> - - <description> - Enable verbose output; optional, default false - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A version number to get - - only works with the SOSGet on a file; optional.</short-description> - - <description> - Set the a version number to get - - only works with the SOSGet on a file; optional. - </description> - - </attribute> - - <attribute name="vssserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the location of the ss.ini file; - required.</short-description> - - <description> - Set the path to the location of the ss.ini file; - required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="soscheckout" category="other" classname="org.apache.tools.ant.taskdefs.optional.sos.SOSCheckout"> - - - <short-description>Retrieves and locks files in Visual SourceSafe via a SourceOffSite server.</short-description> - - <description> - Retrieves and locks files in Visual SourceSafe via a SourceOffSite server. - - <p> - The following attributes are interpretted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>file</td> - <td>Filename to act upon<br> If no file is specified then act upon the project</td> - <td>No</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>soshome</td> - <td>The path to the SourceOffSite home directory</td> - <td>No</td> - </tr> - <tr> - <td>nocompression</td> - <td>true or false - disable compression</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false - Only works with the CheckOutProject command</td> - <td>No</td> - </tr> - <tr> - <td>nocache</td> - <td>true or false - Only needed if SOSHOME is set as an enviroment variable</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply to all files being labelled; - optional, only valid in SOSLabel.</short-description> - - <description> - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - </description> - - </attribute> - - <attribute name="file" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Filename to act upon; optional.</short-description> - - <description> - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Labeled version to operate on in SourceSafe.</short-description> - - <description> - Set the labeled version to operate on in SourceSafe - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Override the working directory and get to the specified path; optional.</short-description> - - <description> - Override the working directory and get to the specified path; optional. - </description> - - </attribute> - - <attribute name="nocache" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.</short-description> - - <description> - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - </description> - - </attribute> - - <attribute name="nocompress" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag that disables compression when set; optional, default.</short-description> - - <description> - Flag that disables compression when set; optional, default - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe password; optional.</short-description> - - <description> - Set the SourceSafe password; optional. - </description> - - </attribute> - - <attribute name="projectpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe project path without the "$" prefix; required.</short-description> - - <description> - Set the SourceSafe project path without the "$" prefix; required - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.</short-description> - - <description> - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - </description> - - </attribute> - - <attribute name="soscmd" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.</short-description> - - <description> - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - </description> - - </attribute> - - <attribute name="soshome" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The path to the SourceOffSite home directory.</short-description> - - <description> - The path to the SourceOffSite home directory - </description> - - </attribute> - - <attribute name="sosserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.</short-description> - - <description> - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - </description> - - </attribute> - - <attribute name="username" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe username; required.</short-description> - - <description> - Set the SourceSafe username; required. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Enable verbose output; optional, default false.</short-description> - - <description> - Enable verbose output; optional, default false - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A version number to get - - only works with the SOSGet on a file; optional.</short-description> - - <description> - Set the a version number to get - - only works with the SOSGet on a file; optional. - </description> - - </attribute> - - <attribute name="vssserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the location of the ss.ini file; - required.</short-description> - - <description> - Set the path to the location of the ss.ini file; - required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="sosget" category="other" classname="org.apache.tools.ant.taskdefs.optional.sos.SOSGet"> - - - <short-description>Retrieves a read-only copy of the specified project or file from Visual SourceSafe via a SourceOffSite server.</short-description> - - <description> - Retrieves a read-only copy of the specified project or file - from Visual SourceSafe via a SourceOffSite server. - <p> - The following attributes are interpretted: - <table border="1"> - <tbody> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>file</td> - <td>Filename to act upon<br> - If no file is specified then act upon the project</td> - <td>No</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>soshome</td> - <td>The path to the SourceOffSite home directory</td> - <td>No</td> - </tr> - <tr> - <td>nocompression</td> - <td>true or false - disable compression</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false - Only works with the GetProject command</td> - <td>No</td> - </tr> - <tr> - <td>version</td> - <td>a version number to get - Only works with the GetFile command</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>a label version to get - Only works with the GetProject command</td> - <td>No</td> - </tr> - <tr> - <td>nocache</td> - <td>true or false - Only needed if SOSHOME is set as an enviroment variable</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - </description> - - - <structure> - - - <attributes> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply to all files being labelled; - optional, only valid in SOSLabel.</short-description> - - <description> - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - </description> - - </attribute> - - <attribute name="file" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Filename to act upon; optional.</short-description> - - <description> - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Labeled version to operate on in SourceSafe.</short-description> - - <description> - Set the labeled version to operate on in SourceSafe - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Override the working directory and get to the specified path; optional.</short-description> - - <description> - Override the working directory and get to the specified path; optional. - </description> - - </attribute> - - <attribute name="nocache" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.</short-description> - - <description> - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - </description> - - </attribute> - - <attribute name="nocompress" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag that disables compression when set; optional, default.</short-description> - - <description> - Flag that disables compression when set; optional, default - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe password; optional.</short-description> - - <description> - Set the SourceSafe password; optional. - </description> - - </attribute> - - <attribute name="projectpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe project path without the "$" prefix; required.</short-description> - - <description> - Set the SourceSafe project path without the "$" prefix; required - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.</short-description> - - <description> - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - </description> - - </attribute> - - <attribute name="soscmd" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.</short-description> - - <description> - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - </description> - - </attribute> - - <attribute name="soshome" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The path to the SourceOffSite home directory.</short-description> - - <description> - The path to the SourceOffSite home directory - </description> - - </attribute> - - <attribute name="sosserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.</short-description> - - <description> - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - </description> - - </attribute> - - <attribute name="username" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe username; required.</short-description> - - <description> - Set the SourceSafe username; required. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Enable verbose output; optional, default false.</short-description> - - <description> - Enable verbose output; optional, default false - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A version number to get - - only works with the SOSGet on a file; optional.</short-description> - - <description> - Set the a version number to get - - only works with the SOSGet on a file; optional. - </description> - - </attribute> - - <attribute name="vssserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the location of the ss.ini file; - required.</short-description> - - <description> - Set the path to the location of the ss.ini file; - required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="soslabel" category="other" classname="org.apache.tools.ant.taskdefs.optional.sos.SOSLabel"> - - - <short-description>Labels Visual SourceSafe files via a SourceOffSite server.</short-description> - - <description> - Labels Visual SourceSafe files via a SourceOffSite server. - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>soscmddir</td> - <td>Directory which contains soscmd(.exe) <br> - soscmd(.exe) must be in the path if this is not specified</td> - <td>No</td> - </tr> - <tr> - <td>vssserverpath</td> - <td>path to the srcsafe.ini - eg. \\server\vss\srcsafe.ini</td> - <td>Yes</td> - </tr> - <tr> - <td>sosserverpath</td> - <td>address and port of the SOS server - eg. 192.168.0.1:8888</td> - <td>Yes</td> - </tr> - <tr> - <td>projectpath</td> - <td>SourceSafe project path without the "$"</td> - <td>Yes</td> - </tr> - <tr> - <td>username</td> - <td>SourceSafe username</td> - <td>Yes</td> - </tr> - <tr> - <td>password</td> - <td>SourceSafe password</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>The label to apply to a project</td> - <td>Yes</td> - </tr> - <tr> - <td>comment</td> - <td>A comment to be applied to all files being labeled</td> - <td>No</td> - </tr> - <tr> - <td>verbose</td> - <td>true or false - Status messages are displayed</td> - <td>No</td> - </tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply to all files being labelled; - optional, only valid in SOSLabel.</short-description> - - <description> - Set the comment to apply to all files being labelled; - optional, only valid in SOSLabel - </description> - - </attribute> - - <attribute name="file" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Filename to act upon; optional.</short-description> - - <description> - Set the Filename to act upon; optional. - If no file is specified then the tasks - act upon the project - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Labeled version to operate on in SourceSafe.</short-description> - - <description> - Set the labeled version to operate on in SourceSafe - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Override the working directory and get to the specified path; optional.</short-description> - - <description> - Override the working directory and get to the specified path; optional. - </description> - - </attribute> - - <attribute name="nocache" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable.</short-description> - - <description> - flag to disable the cache when set; - optional needed if SOSHOME is set as an environment variable. - </description> - - </attribute> - - <attribute name="nocompress" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag that disables compression when set; optional, default.</short-description> - - <description> - Flag that disables compression when set; optional, default - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe password; optional.</short-description> - - <description> - Set the SourceSafe password; optional. - </description> - - </attribute> - - <attribute name="projectpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe project path without the "$" prefix; required.</short-description> - - <description> - Set the SourceSafe project path without the "$" prefix; required - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false.</short-description> - - <description> - Flag to recursively apply the action (not valid - on all SOS tasks ); optional, default false - </description> - - </attribute> - - <attribute name="soscmd" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted.</short-description> - - <description> - Set the directory where soscmd(.exe) is located; - optional, soscmd must be on the path if omitted. - </description> - - </attribute> - - <attribute name="soshome" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The path to the SourceOffSite home directory.</short-description> - - <description> - The path to the SourceOffSite home directory - </description> - - </attribute> - - <attribute name="sosserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required.</short-description> - - <description> - Set the address and port of SourceOffSite Server, - eg. 192.168.0.1:8888 ; required. - </description> - - </attribute> - - <attribute name="username" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe username; required.</short-description> - - <description> - Set the SourceSafe username; required. - </description> - - </attribute> - - <attribute name="verbose" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Enable verbose output; optional, default false.</short-description> - - <description> - Enable verbose output; optional, default false - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A version number to get - - only works with the SOSGet on a file; optional.</short-description> - - <description> - Set the a version number to get - - only works with the SOSGet on a file; optional. - </description> - - </attribute> - - <attribute name="vssserverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Path to the location of the ss.ini file; - required.</short-description> - - <description> - Set the path to the location of the ss.ini file; - required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="sound" category="other" classname="org.apache.tools.ant.taskdefs.optional.sound.SoundTask"> - - - <short-description>Plays a sound file at the end of the build, according to whether the build failed or succeeded.</short-description> - - <description> - Plays a sound file at the end of the build, according to whether the build failed or succeeded. - - There are three attributes to be set: - - <code>source</code>: the location of the audio file to be played - <code>duration</code>: play the sound file continuously until "duration" milliseconds has expired - <code>loops</code>: the number of times the sound file should be played until stopped - - I have only tested this with .WAV and .AIFF sound file formats. Both seem - to work fine. - - plans for the future: - - use the midi api to define sounds (or drum beat etc) in xml and have - Ant play them back - </description> - - - <structure> - - - <attributes> - </attributes> - - - <elements> - - <element name="fail" type="org.apache.tools.ant.taskdefs.optional.sound.SoundTask.BuildAlert" briefType="" required="NOTDEFINED"> - - <short-description>Add a sound when the build fails.</short-description> - - <description> - add a sound when the build fails - </description> - - </element> - - - <element name="success" type="org.apache.tools.ant.taskdefs.optional.sound.SoundTask.BuildAlert" briefType="" required="NOTDEFINED"> - - <short-description>Add a sound when the build succeeds.</short-description> - - <description> - add a sound when the build succeeds - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="splash" category="other" classname="org.apache.tools.ant.taskdefs.optional.splash.SplashTask"> - - - <short-description>Creates a splash screen.</short-description> - - <description> - Creates a splash screen. The splash screen is displayed - for the duration of the build and includes a handy progress bar as - well. Use in conjunction with the sound task to provide interest - whilst waiting for your builds to complete... - </description> - - - <structure> - - - <attributes> - - <attribute name="imageurl" type="java.lang.String" briefType="String" required="no"> - - <short-description>A URL pointing to an image to display; optional, default antlogo.gif - from the classpath.</short-description> - - <description> - A URL pointing to an image to display; optional, default antlogo.gif - from the classpath. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Proxy password; required if <tt>user</tt> is set.</short-description> - - <description> - Proxy password; required if <tt>user</tt> is set. - </description> - - </attribute> - - <attribute name="port" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Proxy port; optional, default 80.</short-description> - - <description> - Proxy port; optional, default 80. - </description> - - </attribute> - - <attribute name="proxy" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name of proxy; optional.</short-description> - - <description> - name of proxy; optional. - </description> - - </attribute> - - <attribute name="showduration" type="int" briefType="int" required="no"> - - <short-description>How long to show the splash screen in milliseconds, - optional; default 5000 ms.</short-description> - - <description> - how long to show the splash screen in milliseconds, - optional; default 5000 ms. - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Proxy user; optional, default =none.</short-description> - - <description> - Proxy user; optional, default =none. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="sql" category="database" classname="org.apache.tools.ant.taskdefs.SQLExec"> - - - <short-description>Executes a series of SQL statements on a database using JDBC.</short-description> - - <description> - Executes a series of SQL statements on a database using JDBC. - - <p>Statements can - either be read in from a text file using the <i>src</i> attribute or from - between the enclosing SQL tags.</p> - <p>Multiple statements can be provided, separated by semicolons (or the - defined <i>delimiter</i>). Individual lines within the statements can be - commented using either --, // or REM at the start of the line.</p> - <p>The <i>autocommit</i> attribute specifies whether auto-commit should be - turned on or off whilst executing the statements. If auto-commit is turned - on each statement will be executed and committed. If it is turned off the - statements will all be executed as one transaction.</p> - <p>The <i>onerror</i> attribute specifies how to proceed when an error occurs - during the execution of one of the statements. - The possible values are: <b>continue</b> execution, only show the error; - <b>stop</b> execution and commit transaction; - and <b>abort</b> execution and transaction and fail task.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether output should be appended to or overwrite - an existing file.</short-description> - - <description> - whether output should be appended to or overwrite - an existing file. Defaults to false. - </description> - - </attribute> - - <attribute name="autocommit" type="boolean" briefType="boolean" required="no, default "false""> - - <short-description>Auto commit flag for database connection; - optional, default false.</short-description> - - <description> - Auto commit flag for database connection; - optional, default false. - </description> - - </attribute> - - <attribute name="caching" type="boolean" briefType="boolean" required="no (default=true)"> - - <short-description>Caching loaders / driver.</short-description> - - <description> - Caching loaders / driver. This is to avoid - getting an OutOfMemoryError when calling this task - multiple times in a row; default: true - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no (use system classpath)"> - - <short-description>Classpath for loading the driver.</short-description> - - <description> - Sets the classpath for loading the driver. - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no (use system classpath)"> - - <short-description>Classpath for loading the driver - using the classpath reference.</short-description> - - <description> - Set the classpath for loading the driver - using the classpath reference. - </description> - - </attribute> - - <attribute name="delimiter" type="java.lang.String" briefType="String" required="no, default ";""> - - <short-description>Delimiter that separates SQL statements; - optional, default &quot;;&quot; - - <p>For example, set this to "go" and delimitertype to "ROW" for - Sybase ASE or MS SQL Server.</p>.</short-description> - - <description> - Set the delimiter that separates SQL statements; - optional, default &quot;;&quot; - - <p>For example, set this to "go" and delimitertype to "ROW" for - Sybase ASE or MS SQL Server.</p> - </description> - - </attribute> - - <attribute name="delimitertype" type="org.apache.tools.ant.taskdefs.SQLExec.DelimiterType" briefType=""normal", "row"" required="NOTDEFINED"> - - <short-description>Delimiter type: "normal" or "row" (default "normal").</short-description> - - <description> - Set the delimiter type: "normal" or "row" (default "normal"). - - <p>The delimiter type takes two values - normal and row. Normal - means that any occurence of the delimiter terminate the SQL - command whereas with row, only a line containing just the - delimiter is recognized as the end of the command.</p> - </description> - - </attribute> - - <attribute name="driver" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Class name of the JDBC driver; required.</short-description> - - <description> - Class name of the JDBC driver; required. - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no - defaults to default jvm encoding"> - - <short-description>File encoding to use on the SQL files read in.</short-description> - - <description> - Set the file encoding to use on the SQL files read in - </description> - - </attribute> - - <attribute name="onerror" type="org.apache.tools.ant.taskdefs.SQLExec.OnError" briefType=""continue", "stop", "abort"" required="no, default "abort""> - - <short-description>Action to perform when statement fails: continue, stop, or abort - optional; default &quot;abort&quot;.</short-description> - - <description> - Action to perform when statement fails: continue, stop, or abort - optional; default &quot;abort&quot; - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="no (print to system.out by default)"> - - <short-description>Output file; - optional, defaults to the Ant log.</short-description> - - <description> - Set the output file; - optional, defaults to the Ant log. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Password; required.</short-description> - - <description> - Sets the password; required. - </description> - - </attribute> - - <attribute name="print" type="boolean" briefType="boolean" required="no, default "false""> - - <short-description>Print result sets from the statements; - optional, default false.</short-description> - - <description> - Print result sets from the statements; - optional, default false - </description> - - </attribute> - - <attribute name="rdbms" type="java.lang.String" briefType="String" required="no (no restriction)"> - - <short-description>Execute task only if the lower case product name - of the DB matches this.</short-description> - - <description> - Execute task only if the lower case product name - of the DB matches this - </description> - - </attribute> - - <attribute name="showheaders" type="boolean" briefType="boolean" required="no, default "true""> - - <short-description>Print headers for result sets from the - statements; optional, default true.</short-description> - - <description> - Print headers for result sets from the - statements; optional, default true. - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="yes, unless statements enclosed within tags"> - - <short-description>Name of the SQL file to be run.</short-description> - - <description> - Set the name of the SQL file to be run. - Required unless statements are enclosed in the buildfile - </description> - - </attribute> - - <attribute name="url" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Database connection URL; required.</short-description> - - <description> - Sets the database connection URL; required. - </description> - - </attribute> - - <attribute name="userid" type="java.lang.String" briefType="String" required="yes"> - - <short-description>User name for the connection; required.</short-description> - - <description> - Set the user name for the connection; required. - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="no (no restriction)"> - - <short-description>Version string, execute task only if - rdbms version match; optional.</short-description> - - <description> - Sets the version string, execute task only if - rdbms version match; optional. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files (nested fileset attribute).</short-description> - - <description> - Adds a set of files (nested fileset attribute). - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Add a path to the classpath for loading the driver.</short-description> - - <description> - Add a path to the classpath for loading the driver. - </description> - - </element> - - - <element name="transaction" type="org.apache.tools.ant.taskdefs.SQLExec.Transaction" briefType="" required="NOTDEFINED"> - - <short-description>Add a SQL transaction to execute.</short-description> - - <description> - Add a SQL transaction to execute - </description> - - </element> - - - </elements> - - - <body> - - <description> - Set an inline SQL command to execute. - NB: Properties are not expanded in this text. - </description> - - </body> - - - </structure> - - - </task> - - - - <task name="stylebook" category="other" classname="org.apache.tools.ant.taskdefs.optional.StyleBook"> - - - <short-description>Executes the Apache Stylebook documentation generator.</short-description> - - <description> - Executes the Apache Stylebook documentation generator. - Unlike the commandline version of this tool, all three arguments - are required to run stylebook. - <p> - Being extended from &lt;Java&gt;, all the parent's attributes - and options are available. Do not set any apart from the <tt>classpath</tt> - as they are not guaranteed to be there in future. - </description> - - - <structure> - - - <attributes> - - <attribute name="append" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, append output to existing file.</short-description> - - <description> - If true, append output to existing file. - </description> - - </attribute> - - <attribute name="book" type="java.io.File" briefType="File" required="yes"> - - <short-description>The book xml file that the documentation generation starts from; - required.</short-description> - - <description> - The book xml file that the documentation generation starts from; - required. - </description> - - </attribute> - - <attribute name="classname" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Java class to execute.</short-description> - - <description> - Sets the Java class to execute. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Classpath to be used when running the Java class.</short-description> - - <description> - Set the classpath to be used when running the Java class - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Classpath to use, by reference.</short-description> - - <description> - Classpath to use, by reference. - </description> - - </attribute> - - <attribute name="dir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The working directory of the process.</short-description> - - <description> - The working directory of the process - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, then fail if the command exits with a - returncode other than 0.</short-description> - - <description> - If true, then fail if the command exits with a - returncode other than 0 - </description> - - </attribute> - - <attribute name="fork" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, execute in a new VM.</short-description> - - <description> - If true, execute in a new VM. - </description> - - </attribute> - - <attribute name="jvmversion" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>JVM version.</short-description> - - <description> - Sets the JVM version. - </description> - - </attribute> - - <attribute name="jar" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The location of the JAR file to execute.</short-description> - - <description> - The location of the JAR file to execute. - </description> - - </attribute> - - <attribute name="jvm" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Command used to start the VM (only if not forking).</short-description> - - <description> - Set the command used to start the VM (only if not forking). - </description> - - </attribute> - - <attribute name="jvmargs" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Command line arguments for the JVM.</short-description> - - <description> - Set the command line arguments for the JVM. - </description> - - </attribute> - - <attribute name="loaderconfig" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>A loader configuration to send to stylebook; optional.</short-description> - - <description> - A loader configuration to send to stylebook; optional. - </description> - - </attribute> - - <attribute name="maxmemory" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Corresponds to -mx or -Xmx depending on VM version.</short-description> - - <description> - Corresponds to -mx or -Xmx depending on VM version. - </description> - - </attribute> - - <attribute name="newenvironment" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If true, use a completely new environment.</short-description> - - <description> - If true, use a completely new environment. - - <p>Will be ignored if we are not forking a new VM. - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>File the output of the process is redirected to.</short-description> - - <description> - File the output of the process is redirected to. - </description> - - </attribute> - - <attribute name="skindirectory" type="java.io.File" briefType="File" required="yes"> - - <short-description>The directory that contains the stylebook skin; - required.</short-description> - - <description> - the directory that contains the stylebook skin; - required. - </description> - - </attribute> - - <attribute name="targetdirectory" type="java.io.File" briefType="File" required="yes"> - - <short-description>The destination directory where the documentation is generated; - required.</short-description> - - <description> - the destination directory where the documentation is generated; - required. - </description> - - </attribute> - - <attribute name="timeout" type="java.lang.Long" briefType="long" required="NOTDEFINED"> - - <short-description>Timeout in milliseconds after which the process will be killed.</short-description> - - <description> - Timeout in milliseconds after which the process will be killed. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="env" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Adds an environment variable.</short-description> - - <description> - Adds an environment variable. - - <p>Will be ignored if we are not forking a new VM. - </description> - - </element> - - - <element name="sysproperty" type="org.apache.tools.ant.types.Environment.Variable" briefType="" required="NOTDEFINED"> - - <short-description>Adds a system property.</short-description> - - <description> - Adds a system property. - </description> - - </element> - - - <element name="arg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a command-line argument.</short-description> - - <description> - Adds a command-line argument. - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Adds a path to the classpath.</short-description> - - <description> - Adds a path to the classpath. - </description> - - </element> - - - <element name="jvmarg" type="org.apache.tools.ant.types.Commandline.Argument" briefType="" required="NOTDEFINED"> - - <short-description>Adds a JVM argument.</short-description> - - <description> - Adds a JVM argument. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="tar" category="packaging" classname="org.apache.tools.ant.taskdefs.Tar" matchingTask="true"> - - - - <external> - - <description> - - <p>Creates a tar archive.</p> - - - <p>The - <i>basedir</i> attribute is the reference directory from where to tar. - </p> - - - <p>This task is a - <a href="../dirtasks.html#directorybasedtasks">directory based task</a> -and, as such, forms an implicit - <a href="../CoreTypes/fileset.html">Fileset</a>. This -defines which files, relative to the - <i>basedir</i>, will be included in the -archive. The tar task supports all the attributes of Fileset to refine the -set of files to be included in the implicit fileset. - </p> - - - <p>In addition to the implicit fileset, the tar task supports nested filesets. These -filesets are extended to allow control over the access mode, username and groupname -to be applied to the tar entries. This is useful, for example, when preparing archives for -Unix systems where some files need to have execute permission.</p> - - - <p>Early versions of tar did not support path lengths greater than 100 -characters. Modern versions of tar do so, but in incompatible ways. -The behaviour of the tar task when it encounters such paths is -controlled by the - <i>longfile</i> attribute. -If the longfile attribute is set to - <code>fail</code>, any long paths will -cause the tar task to fail. If the longfile attribute is set to - - <code>truncate</code>, any long paths will be truncated to the 100 character -maximum length prior to adding to the archive. If the value of the longfile -attribute is set to - <code>omit</code> then files containing long paths will be -omitted from the archive. Either option ensures that the archive can be -untarred by any compliant version of tar. If the loss of path or file -information is not acceptable, and it rarely is, longfile may be set to the -value - <code>gnu</code>. The tar task will then produce a GNU tar file which -can have arbitrary length paths. Note however, that the resulting archive will -only be able to be untarred with GNU tar. The default for the longfile -attribute is - <code>warn</code> which behaves just like the gnu option except -that it produces a warning for each file path encountered that does not match -the limit. - </p> - - - <p>Note that this task does not perform compression. You might want to use the - - <a href="gzip.html">GZip</a> task to prepare a .tar.gz package. - </p> - - </description> - - - <section anchor="examples" name="Examples"> - - <pre> <tar tarfile="${dist}/manual.tar" basedir="htdocs/manual"/> - <gzip zipfile="${dist}/manual.tar.gz" src="${dist}/manual.tar"/></pre> - - <p>tars all files in the - <code>htdocs/manual</code> directory into a file called - <code>manual.tar</code> -in the - <code>${dist}</code> directory, then applies the gzip task to compress -it. - </p> - - <pre> <tar destfile="${dist}/manual.tar" - basedir="htdocs/manual" - excludes="mydocs/**, **/todo.html" - /></pre> - - <p>tars all files in the - <code>htdocs/manual</code> directory into a file called - <code>manual.tar</code> -in the - <code>${dist}</code> directory. Files in the directory - <code>mydocs</code>, -or files with the name - <code>todo.html</code> are excluded. - </p> - - - <pre> -<tar destfile="${basedir}/docs.tar"> - <tarfileset dir="${dir.src}/docs" - fullpath="/usr/doc/ant/README" - preserveLeadingSlashes="true"> - <include name="readme.txt"/> - </tarfileset> - <tarfileset dir="${dir.src}/docs" - prefix="/usr/doc/ant" - preserveLeadingSlashes="true"> - <include name="*.html"/> - </tarfileset> -</tar></pre> - - - <p> - Writes the file - <code>docs/readme.txt</code> as - - <code>/usr/doc/ant/README</code> into the archive. All - - <code>*.html</code> files in the - <code>docs</code> directory are - prefixed by - <code>/usr/doc/ant</code>, so for example - - <code>docs/index.html</code> is written as - - <code>/usr/doc/ant/index.html</code> to the archive. - - </p> - - - <pre><tar longfile="gnu" - destfile="${dist.base}/${dist.name}-src.tar" > - <tarfileset dir="${dist.name}/.." mode="755" username="ant" group="ant"> - <include name="${dist.name}/bootstrap.sh"/> - <include name="${dist.name}/build.sh"/> - </tarfileset> - <tarfileset dir="${dist.name}/.." username="ant" group="ant"> - <include name="${dist.name}/**"/> - <exclude name="${dist.name}/bootstrap.sh"/> - <exclude name="${dist.name}/build.sh"/> - </tarfileset> -</tar> </pre> - - - <p>This example shows building a tar which uses the GNU extensions for long paths and -where some files need to be marked as executable (mode 755) -and the rest are use the default mode (read-write by owner). The first -fileset selects just the executable files. The second fileset must exclude -the executable files and include all others. </p> - - - <p> - <strong>Note: </strong> The tar task does not ensure that a file is only selected -by one fileset. If the same file is selected by more than one fileset, it will be included in the -tar file twice, with the same path. - </p> - - - <p> - <strong>Note:</strong> The patterns in the include and exclude -elements are considered to be relative to the corresponding dir -attribute as with all other filesets. In the example above, - - <code>${dist.name}</code> is not an absolute path, but a simple name -of a directory, so - <code>${dist.name}</code> is a valid path relative -to - <code>${dist.name}/..</code>. - </p> - - - </section> - - </external> - - - <short-description>Creates a tar archive.</short-description> - - <description> - Creates a tar archive. - </description> - - - <structure> - - - <attributes> - - <attribute name="basedir" type="java.io.File" briefType="File" required="no"> - - <short-description>This is the base directory to look in for things to tar.</short-description> - - <description> - This is the base directory to look in for things to tar. - </description> - - </attribute> - - <attribute name="compression" type="org.apache.tools.ant.taskdefs.Tar.TarCompressionMethod" briefType=""none", "gzip", "bzip2"" required="no"> - - <short-description>Set compression method.</short-description> - - <description> - Set compression method. - Allowable values are - <ul> - <li> none - no compression - <li> gzip - Gzip compression - <li> bzip2 - Bzip2 compression - </ul> - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>Set is the name/location of where to create the tar file.</short-description> - - <description> - Set is the name/location of where to create the tar file. - </description> - - </attribute> - - <attribute name="longfile" type="org.apache.tools.ant.taskdefs.Tar.TarLongFileMode" briefType=""warn", "fail", "truncate", "gnu", "omit"" required="no"> - - <short-description>Set how to handle long files, those with a path&gt;100 chars.</short-description> - - <description> - Set how to handle long files, those with a path&gt;100 chars. - Optional, default=warn. - <p> - Allowable values are - <ul> - <li> truncate - paths are truncated to the maximum length - <li> fail - paths greater than the maximim cause a build exception - <li> warn - paths greater than the maximum cause a warning and GNU is used - <li> gnu - GNU extensions are used for any paths greater than the maximum. - <li> omit - paths greater than the maximum are omitted from the archive - </ul> - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="tarfileset" type="org.apache.tools.ant.taskdefs.Tar.TarFileSet" briefType="" required="NOTDEFINED"> - - <short-description>Add a new fileset with the option to specify permissions.</short-description> - - <description> - Add a new fileset with the option to specify permissions - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="taskdef" category="internal" classname="org.apache.tools.ant.taskdefs.Taskdef"> - - - <short-description>Adds a task definition to the current project, such that this new task can be used in the current project.</short-description> - - <description> - Adds a task definition to the current project, such that this new task can be - used in the current project. Two attributes are needed, the name that identifies - this task uniquely, and the full name of the class (including the packages) that - implements this task.</p> - <p>You can also define a group of tasks at once using the file or - resource attributes. These attributes point to files in the format of - Java property files. Each line defines a single task in the - format:</p> - <pre> - taskname=fully.qualified.java.classname - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="classname" type="java.lang.String" briefType="String" required="yes, unless file or resource have been specified."> - - <short-description>The full class name of the object being defined.</short-description> - - <description> - the full class name of the object being defined. - Required, unless file or resource have - been specified. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used when searching for component being defined.</short-description> - - <description> - Set the classpath to be used when searching for component being defined - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Reference to a classpath to use when loading the files.</short-description> - - <description> - reference to a classpath to use when loading the files. - To actually share the same loader, set loaderref as well - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of the property file to load - ant name/classname pairs from.</short-description> - - <description> - Name of the property file to load - ant name/classname pairs from. - </description> - - </attribute> - - <attribute name="loaderref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Use the reference to locate the loader.</short-description> - - <description> - Use the reference to locate the loader. If the loader is not - found, taskdef will use the specified classpath and register it - with the specified name. - This allow multiple taskdef/typedef to use the same class loader, - so they can be used together. It eliminate the need to - put them in the CLASSPATH. - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="yes, unless file or resource have been specified."> - - <short-description>Name of the property resource to load - ant name/classname pairs from.</short-description> - - <description> - Name of the property resource to load - ant name/classname pairs from. - </description> - - </attribute> - - <attribute name="resource" type="java.lang.String" briefType="String" required="no"> - - <short-description>Name of the property resource to load - ant name/classname pairs from.</short-description> - - <description> - Name of the property resource to load - ant name/classname pairs from. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create the classpath to be used when searching for component being defined.</short-description> - - <description> - Create the classpath to be used when searching for component being defined - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="telnet" category="other" classname="org.apache.tools.ant.taskdefs.optional.net.TelnetTask"> - - - <short-description>Automates the telnet protocol.</short-description> - - <description> - Automates the telnet protocol. - </description> - - - <structure> - - - <attributes> - - <attribute name="initialcr" type="boolean" briefType="boolean" required="no"> - - <short-description>Send a carriage return after connecting; optional, defaults to false.</short-description> - - <description> - send a carriage return after connecting; optional, defaults to false. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="only if userid is specified"> - - <short-description>The login password to use - required if <tt>userid</tt> is set.</short-description> - - <description> - Set the the login password to use - required if <tt>userid</tt> is set. - </description> - - </attribute> - - <attribute name="port" type="int" briefType="int" required="no"> - - <short-description>Tcp port to connect to; default is 23.</short-description> - - <description> - Set the tcp port to connect to; default is 23. - </description> - - </attribute> - - <attribute name="server" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Hostname or address of the remote server.</short-description> - - <description> - Set the hostname or address of the remote server. - </description> - - </attribute> - - <attribute name="timeout" type="java.lang.Integer" briefType="int" required="no"> - - <short-description>Default timeout in seconds to wait for a response, - zero means forever (the default).</short-description> - - <description> - set a default timeout in seconds to wait for a response, - zero means forever (the default) - </description> - - </attribute> - - <attribute name="userid" type="java.lang.String" briefType="String" required="only if password is specified"> - - <short-description>The login id to use on the server; - required if <tt>password</tt> is set.</short-description> - - <description> - Set the the login id to use on the server; - required if <tt>password</tt> is set. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="read" type="org.apache.tools.ant.taskdefs.optional.net.TelnetTask.TelnetSubTask" briefType="" required="NOTDEFINED"> - - <short-description>A string to wait for from the server.</short-description> - - <description> - A string to wait for from the server. - A subTask &lt;read&gt; tag was found. Create the object, - Save it in our list, and return it. - </description> - - </element> - - - <element name="write" type="org.apache.tools.ant.taskdefs.optional.net.TelnetTask.TelnetSubTask" briefType="" required="NOTDEFINED"> - - <short-description>Add text to send to the server - A subTask &lt;write&gt; tag was found.</short-description> - - <description> - Add text to send to the server - A subTask &lt;write&gt; tag was found. Create the object, - Save it in our list, and return it. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="tempfile" category="other" classname="org.apache.tools.ant.taskdefs.TempFile"> - - - <short-description>This task sets a property to the name of a temporary file.</short-description> - - <description> - This task sets a property to the name of a temporary file. - Unlike the Java1.2 method to create a temporary file, this task - does work on Java1.1. Also, it does not actually create the - temporary file, but it does guarantee that the file did not - exist when the task was executed. - <p> - Examples - <pre>&lt;tempfile property="temp.file" /&gt;</pre> - create a temporary file - <pre>&lt;tempfile property="temp.file" suffix=".xml" /&gt;</pre> - create a temporary file with the .xml suffix. - <pre>&lt;tempfile property="temp.file" destDir="build"/&gt;</pre> - create a temp file in the build subdir - </description> - - - <structure> - - - <attributes> - - <attribute name="destdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory.</short-description> - - <description> - destination directory. If null, -the parent directory is used instead - </description> - - </attribute> - - <attribute name="prefix" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Optional prefix string.</short-description> - - <description> - optional prefix string - </description> - - </attribute> - - <attribute name="property" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The property you wish to assign the temporary file to.</short-description> - - <description> - The property you wish to assign the temporary file to - </description> - - </attribute> - - <attribute name="suffix" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Suffix string for the temp file (optional).</short-description> - - <description> - Suffix string for the temp file (optional) - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="touch" category="filesystem" classname="org.apache.tools.ant.taskdefs.Touch"> - - - <short-description>Touch a file and/or fileset(s); corresponds to the Unix touch command.</short-description> - - <description> - Touch a file and/or fileset(s); corresponds to the Unix touch command. - - <p>If the file to touch doesn't exist, an empty one is - created. </p> - - <p>Note: Setting the modification time of files is not supported in - JDK 1.1.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="datetime" type="java.lang.String" briefType="String" required="no"> - - <short-description>The new modification time of the file - in the format MM/DD/YYYY HH:MM AM <i>or</i> PM; - Optional, default=now.</short-description> - - <description> - the new modification time of the file - in the format MM/DD/YYYY HH:MM AM <i>or</i> PM; - Optional, default=now - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="unless a nested fileset element has been specified."> - - <short-description>Single source file to touch.</short-description> - - <description> - Sets a single source file to touch. If the file does not exist - an empty file will be created. - </description> - - </attribute> - - <attribute name="millis" type="long" briefType="long" required="no"> - - <short-description>The new modification time of the file - in milliseconds since midnight Jan 1 1970.</short-description> - - <description> - the new modification time of the file - in milliseconds since midnight Jan 1 1970. - Optional, default=now - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a set of files to touch.</short-description> - - <description> - Add a set of files to touch - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="translate" category="other" classname="org.apache.tools.ant.taskdefs.optional.i18n.Translate" matchingTask="true"> - - - <short-description>Translates text embedded in files using Resource Bundle files.</short-description> - - <description> - Translates text embedded in files using Resource Bundle files. - </description> - - - <structure> - - - <attributes> - - <attribute name="bundle" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Sets Family name of resource bundle; required.</short-description> - - <description> - Sets Family name of resource bundle; required. - </description> - - </attribute> - - <attribute name="bundlecountry" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets locale specific country of resource bundle; optional.</short-description> - - <description> - Sets locale specific country of resource bundle; optional. - </description> - - </attribute> - - <attribute name="bundleencoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets Resource Bundle file encoding scheme; optional.</short-description> - - <description> - Sets Resource Bundle file encoding scheme; optional. Defaults to source file - encoding - </description> - - </attribute> - - <attribute name="bundlelanguage" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets locale specific language of resource bundle; optional.</short-description> - - <description> - Sets locale specific language of resource bundle; optional. - </description> - - </attribute> - - <attribute name="bundlevariant" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets locale specific variant of resource bundle; optional.</short-description> - - <description> - Sets locale specific variant of resource bundle; optional. - </description> - - </attribute> - - <attribute name="destencoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets destination file encoding scheme; optional.</short-description> - - <description> - Sets destination file encoding scheme; optional. Defaults to source file - encoding - </description> - - </attribute> - - <attribute name="endtoken" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Sets ending token to identify keys; required.</short-description> - - <description> - Sets ending token to identify keys; required. - </description> - - </attribute> - - <attribute name="forceoverwrite" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether or not to overwrite existing file irrespective of - whether it is newer than the source file as well as the - resource bundle file.</short-description> - - <description> - Whether or not to overwrite existing file irrespective of - whether it is newer than the source file as well as the - resource bundle file. - Defaults to false. - </description> - - </attribute> - - <attribute name="srcencoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Sets source file encoding scheme; optional, - defaults to encoding of local system.</short-description> - - <description> - Sets source file encoding scheme; optional, - defaults to encoding of local system. - </description> - - </attribute> - - <attribute name="starttoken" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Sets starting token to identify keys; required.</short-description> - - <description> - Sets starting token to identify keys; required. - </description> - - </attribute> - - <attribute name="todir" type="java.io.File" briefType="File" required="yes"> - - <short-description>Sets Destination directory; required.</short-description> - - <description> - Sets Destination directory; required. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files to translate as a nested fileset element.</short-description> - - <description> - Adds a set of files to translate as a nested fileset element. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="tstamp" category="utility" classname="org.apache.tools.ant.taskdefs.Tstamp"> - - - <short-description>Sets properties to the current time, or offsets from the current time.</short-description> - - <description> - Sets properties to the current time, or offsets from the current time. - The default properties are TSTAMP, DSTAMP and TODAY; - </description> - - - <structure> - - - <attributes> - - <attribute name="prefix" type="java.lang.String" briefType="String" required="no"> - - <short-description>Prefix for the properties.</short-description> - - <description> - Set a prefix for the properties. If the prefix does not end with a "." - one is automatically added - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="format" type="org.apache.tools.ant.taskdefs.Tstamp.CustomFormat" briefType="" required="NOTDEFINED"> - - <short-description>Create a custom format with the the current prefix.</short-description> - - <description> - create a custom format with the the current prefix. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="typedef" category="internal" classname="org.apache.tools.ant.taskdefs.Typedef"> - - - <short-description>Adds a data type definition to the current project.</short-description> - - <description> - Adds a data type definition to the current project. - Two attributes are - needed, the name that identifies this data type uniquely, and the full - name of the class (including the packages) that implements this - type. - <p>You can also define a group of data types at once using the file or - resource attributes. These attributes point to files in the format of - Java property files. Each line defines a single data type in the - format:</p> - <pre> - typename=fully.qualified.java.classname - </pre> - <p>Typedef should be used to add your own types to the system. Data - types are things likepaths or filesets that can be defined at - the project level and referenced via their ID attribute.</p> - <p>Custom data types usually need custom tasks to put them to good use.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="classname" type="java.lang.String" briefType="String" required="yes, unless file or resource have been specified."> - - <short-description>The full class name of the object being defined.</short-description> - - <description> - the full class name of the object being defined. - Required, unless file or resource have - been specified. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Classpath to be used when searching for component being defined.</short-description> - - <description> - Set the classpath to be used when searching for component being defined - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="NOTDEFINED"> - - <short-description>Reference to a classpath to use when loading the files.</short-description> - - <description> - reference to a classpath to use when loading the files. - To actually share the same loader, set loaderref as well - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="no"> - - <short-description>Name of the property file to load - ant name/classname pairs from.</short-description> - - <description> - Name of the property file to load - ant name/classname pairs from. - </description> - - </attribute> - - <attribute name="loaderref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Use the reference to locate the loader.</short-description> - - <description> - Use the reference to locate the loader. If the loader is not - found, taskdef will use the specified classpath and register it - with the specified name. - This allow multiple taskdef/typedef to use the same class loader, - so they can be used together. It eliminate the need to - put them in the CLASSPATH. - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="yes, unless file or resource have been specified."> - - <short-description>Name of the property resource to load - ant name/classname pairs from.</short-description> - - <description> - Name of the property resource to load - ant name/classname pairs from. - </description> - - </attribute> - - <attribute name="resource" type="java.lang.String" briefType="String" required="no"> - - <short-description>Name of the property resource to load - ant name/classname pairs from.</short-description> - - <description> - Name of the property resource to load - ant name/classname pairs from. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Create the classpath to be used when searching for component being defined.</short-description> - - <description> - Create the classpath to be used when searching for component being defined - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="untar" category="packaging" classname="org.apache.tools.ant.taskdefs.Untar"> - - - <short-description>Untar a file.</short-description> - - <description> - Untar a file. - <p>For JDK 1.1 &quot;last modified time&quot; field is set to current time instead of being - carried from the archive file.</p> - <p>PatternSets are used to select files to extract - <I>from</I> the archive. If no patternset is used, all files are extracted. - </p> - <p>FileSet>s may be used used to select archived files - to perform unarchival upon. - </p> - <p>File permissions will not be restored on extracted files.</p> - <p>The untar task recognizes the long pathname entries used by GNU tar.<p> - </description> - - - <structure> - - - <attributes> - - <attribute name="compression" type="org.apache.tools.ant.taskdefs.Untar.UntarCompressionMethod" briefType=""none", "gzip", "bzip2"" required="NOTDEFINED"> - - <short-description>Set decompression algorithm to use; default=none.</short-description> - - <description> - Set decompression algorithm to use; default=none. - - Allowable values are - <ul> - <li>none - no compression - <li>gzip - Gzip compression - <li>bzip2 - Bzip2 compression - </ul> - </description> - - </attribute> - - <attribute name="dest" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory.</short-description> - - <description> - Set the destination directory. File will be unzipped into the - destination directory. - </description> - - </attribute> - - <attribute name="overwrite" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive?.</short-description> - - <description> - Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive? - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Path to zip-file.</short-description> - - <description> - Set the path to zip-file. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a fileset.</short-description> - - <description> - Add a fileset - </description> - - </element> - - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" briefType="Patternset" required="NOTDEFINED"> - - <short-description>Add a patternset.</short-description> - - <description> - Add a patternset - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="unzip" category="packaging" classname="org.apache.tools.ant.taskdefs.Expand"> - - - <short-description>Unzip a file.</short-description> - - <description> - Unzip a file. - </description> - - - <structure> - - - <attributes> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>Destination directory.</short-description> - - <description> - Set the destination directory. File will be unzipped into the - destination directory. - </description> - - </attribute> - - <attribute name="overwrite" type="boolean" briefType="boolean" required="no"> - - <short-description>Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive?.</short-description> - - <description> - Should we overwrite files in dest, even if they are newer than - the corresponding entries in the archive? - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="yes, if filesets are not used."> - - <short-description>Path to zip-file.</short-description> - - <description> - Set the path to zip-file. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Add a fileset.</short-description> - - <description> - Add a fileset - </description> - - </element> - - - <element name="patternset" type="org.apache.tools.ant.types.PatternSet" briefType="Patternset" required="NOTDEFINED"> - - <short-description>Add a patternset.</short-description> - - <description> - Add a patternset - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="uptodate" category="control" classname="org.apache.tools.ant.taskdefs.UpToDate"> - - - <short-description>Sets the given property if the specified target has a timestamp greater than all of the source files.</short-description> - - <description> - Sets the given property if the specified target has a timestamp - greater than all of the source files. - </description> - - - <structure> - - - <attributes> - - <attribute name="property" type="java.lang.String" briefType="String" required="yes"> - - <short-description>The property to set if the target file is more up-to-date than - (each of) the source file(s).</short-description> - - <description> - The property to set if the target file is more up-to-date than - (each of) the source file(s). - </description> - - </attribute> - - <attribute name="srcfile" type="java.io.File" briefType="File" required="yes, unless a nested <srcfiles> element is present."> - - <short-description>The file that must be older than the target file - if the property is to be set.</short-description> - - <description> - The file that must be older than the target file - if the property is to be set. - </description> - - </attribute> - - <attribute name="targetfile" type="java.io.File" briefType="File" required="yes, unless a nested <mapper> element is present."> - - <short-description>The file which must be more up-to-date than (each of) the source file(s) - if the property is to be set.</short-description> - - <description> - The file which must be more up-to-date than (each of) the source file(s) - if the property is to be set. - </description> - - </attribute> - - <attribute name="value" type="java.lang.String" briefType="String" required="no; defaults to true."> - - <short-description>The value to set the named property to if the target file is more - up-to-date than (each of) the source file(s).</short-description> - - <description> - The value to set the named property to if the target file is more - up-to-date than (each of) the source file(s). Defaults to 'true'. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="srcfiles" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Nested &lt;srcfiles&gt; element.</short-description> - - <description> - Nested &lt;srcfiles&gt; element. - </description> - - </element> - - - <element name="mapper" type="org.apache.tools.ant.types.Mapper" briefType="Mapper" required="NOTDEFINED"> - - <short-description>Defines the FileNameMapper to use (nested mapper element).</short-description> - - <description> - Defines the FileNameMapper to use (nested mapper element). - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="vajexport" category="other" classname="org.apache.tools.ant.taskdefs.optional.ide.VAJExport"> - - - <short-description>Export packages from the Visual Age for Java workspace.</short-description> - - <description> - Export packages from the Visual Age for Java workspace. - The packages are specified similar to all other MatchingTasks. - Since the VA Workspace is not file based, this task is simulating - a directory hierarchy for the workspace: - The 'root' contains all project 'dir's, and the projects contain - their respective package 'dir's. - Example: - <blockquote> - &lt;vajexport destdir="C:/builddir/source"> - &nbsp;&lt;include name="/MyVAProject/org/foo/subsystem1/**" /> - &nbsp;&lt;exclude name="/MyVAProject/org/foo/subsystem1/test/**"/> - &lt;/vajexport> - </blockquote> - exports all packages in the project MyVAProject which start with - 'org.foo.subsystem1' except of these starting with - 'org.foo.subsystem1.test'. - - There are flags to choose which items to export: - exportSources: export Java sources - exportResources: export project resources - exportClasses: export class files - exportDebugInfo: export class files with debug info (use with exportClasses) - default is exporting Java files and resources. - </description> - - - <structure> - - - <attributes> - - <attribute name="defaultexcludes" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Sets whether default exclusions should be used or not; default true.</short-description> - - <description> - Sets whether default exclusions should be used or not; default true. - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Destination directory into which the selected - items should be exported; required.</short-description> - - <description> - Set the destination directory into which the selected - items should be exported; required. - </description> - - </attribute> - - <attribute name="excludes" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set of exclude patterns.</short-description> - - <description> - Sets the set of exclude patterns. Patterns may be separated by a comma - or a space. Currently only patterns denoting packages are - supported - </description> - - </attribute> - - <attribute name="exportclasses" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Optional flag to export the class files; default false.</short-description> - - <description> - optional flag to export the class files; default false. - </description> - - </attribute> - - <attribute name="exportdebuginfo" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Optional flag to export the debug info; default false. - debug info.</short-description> - - <description> - optional flag to export the debug info; default false. - debug info - </description> - - </attribute> - - <attribute name="exportresources" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Optional flag to export the resource file; default true.</short-description> - - <description> - optional flag to export the resource file; default true. - </description> - - </attribute> - - <attribute name="exportsources" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Optional flag to export the Java files; default true.</short-description> - - <description> - optional flag to export the Java files; default true. - </description> - - </attribute> - - <attribute name="includes" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Set of include patterns.</short-description> - - <description> - Sets the set of include patterns. Patterns may be separated by a comma - or a space. Currently only patterns denoting packages are - supported - </description> - - </attribute> - - <attribute name="overwrite" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>If Overwrite is set, files will be overwritten during export.</short-description> - - <description> - if Overwrite is set, files will be overwritten during export - </description> - - </attribute> - - <attribute name="remote" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name and port of a remote tool server, optiona.</short-description> - - <description> - Name and port of a remote tool server, optiona. - Format: &lt;servername&gt;:&lt;port no&gt;. - If this attribute is set, the tasks will be executed on the specified tool - server. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="exclude" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the exclude list.</short-description> - - <description> - add a name entry on the exclude list - </description> - - </element> - - - <element name="include" type="org.apache.tools.ant.types.PatternSet.NameEntry" briefType="" required="NOTDEFINED"> - - <short-description>Add a name entry on the include list.</short-description> - - <description> - add a name entry on the include list - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="vajimport" category="other" classname="org.apache.tools.ant.taskdefs.optional.ide.VAJImport"> - - - <short-description>Import source, class files, and resources to the Visual Age for Java workspace.</short-description> - - <description> - Import source, class files, and resources to the Visual Age for Java - workspace. - <p> - Example: - <pre> - &lt;vajimport project="MyVAProject"&gt; - &lt;fileset dir="src"&gt; - &lt;include name="org/foo/subsystem1/**" /&gt; - &lt;exclude name="/org/foo/subsystem1/test/**" /&gt; - &lt;/fileset&gt; - &lt;/vajexport&gt; - </pre> - import all source and resource files from the "src" directory - which start with 'org.foo.subsystem1', except of these starting with - 'org.foo.subsystem1.test' into the project MyVAProject. - </p> - <p>If MyVAProject isn't loaded into the Workspace, a new edition is - created in the repository and automatically loaded into the Workspace. - There has to be at least one nested FileSet element. - </p> - <p>There are attributes to choose which items to export: - <table border="1" cellpadding="2" cellspacing="0"> - <tr> - <td valign="top"><b>Attribute</b></td> - <td valign="top"><b>Description</b></td> - <td align="center" valign="top"><b>Required</b></td> - </tr> - <tr> - <td valign="top">project</td> - <td valign="top">the name of the Project to import to</td> - <td align="center" valign="top">Yes</td> - </tr> - <tr> - <td valign="top">importSources</td> - <td valign="top">import Java sources, defaults to "yes"</td> - <td align="center" valign="top">No</td> - </tr> - <tr> - <td valign="top">importResources</td> - <td valign="top">import resource files (anything that doesn't - end with .java or .class), defaults to "yes"</td> - <td align="center" valign="top">No</td> - </tr> - <tr> - <td valign="top">importClasses</td> - <td valign="top">import class files, defaults to "no"</td> - <td align="center" valign="top">No</td> - </tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="defaultexcludes" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Sets whether default exclusions should be used or not.</short-description> - - <description> - Sets whether default exclusions should be used or not. - </description> - - </attribute> - - <attribute name="importclasses" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to import .class files; optional, default false.</short-description> - - <description> - Flag to import .class files; optional, default false. - </description> - - </attribute> - - <attribute name="importresources" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Import resource files (anything that doesn't end in - .class or .java); optional, default true.</short-description> - - <description> - Import resource files (anything that doesn't end in - .class or .java); optional, default true. - </description> - - </attribute> - - <attribute name="importsources" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Import .java files; optional, default true.</short-description> - - <description> - Import .java files; optional, default true. - </description> - - </attribute> - - <attribute name="project" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The VisualAge for Java Project name to import into.</short-description> - - <description> - The VisualAge for Java Project name to import into. - </description> - - </attribute> - - <attribute name="remote" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name and port of a remote tool server, optiona.</short-description> - - <description> - Name and port of a remote tool server, optiona. - Format: &lt;servername&gt;:&lt;port no&gt;. - If this attribute is set, the tasks will be executed on the specified tool - server. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files (nested fileset attribute).</short-description> - - <description> - Adds a set of files (nested fileset attribute). - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="vajload" category="other" classname="org.apache.tools.ant.taskdefs.optional.ide.VAJLoad"> - - - <short-description>Load specific project versions into the Visual Age for Java workspace.</short-description> - - <description> - Load specific project versions into the Visual Age for Java workspace. - Each project and version name has to be specified completely. - Example: - <blockquote> - &lt;vajload> - &nbsp;&lt;project name="MyVAProject" version="2.1"/> - &nbsp;&lt;project name="Apache Xerces" version="1.2.0"/> - &lt;/vajload> - </blockquote> - </description> - - - <structure> - - - <attributes> - - <attribute name="remote" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name and port of a remote tool server, optiona.</short-description> - - <description> - Name and port of a remote tool server, optiona. - Format: &lt;servername&gt;:&lt;port no&gt;. - If this attribute is set, the tasks will be executed on the specified tool - server. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="vajproject" type="org.apache.tools.ant.taskdefs.optional.ide.VAJProjectDescription" briefType="" required="NOTDEFINED"> - - <short-description>Add a project description entry on the project list.</short-description> - - <description> - Add a project description entry on the project list. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="vssadd" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSADD"> - - - <short-description>Performs Add commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Performs Add commands to Microsoft Visual SourceSafe. - Based on the VSS Checkin code by Martin Poeschl - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply; optional.</short-description> - - <description> - Sets the comment to apply; optional. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Local path.</short-description> - - <description> - Set the local path. - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Set behaviour recursive or non-recursive.</short-description> - - <description> - Set behaviour recursive or non-recursive - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - <attribute name="writable" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Leave added files writable?.</short-description> - - <description> - Leave added files writable? Default: false. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vsscheckin" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCHECKIN"> - - - <short-description>Performs CheckIn commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Performs CheckIn commands to Microsoft Visual SourceSafe. - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply; optional.</short-description> - - <description> - Set the comment to apply; optional. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Local path.</short-description> - - <description> - Set the local path. - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to tell the task to recurse down the tree; - optional, default false.</short-description> - - <description> - Flag to tell the task to recurse down the tree; - optional, default false. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - <attribute name="writable" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Leave checked in files writable?.</short-description> - - <description> - Leave checked in files writable? Default: false. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vsscheckout" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCHECKOUT"> - - - <short-description>Performs CheckOut commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Performs CheckOut commands to Microsoft Visual SourceSafe. - <p>If you specify two or more attributes from version, date and - label only one will be used in the order version, date, label.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="date" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.</short-description> - - <description> - Set the date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.</short-description> - - <description> - Set the label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Local path.</short-description> - - <description> - Set the local path. - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to tell the task to recurse down the tree; - optional, default false.</short-description> - - <description> - Flag to tell the task to recurse down the tree; - optional, default false. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Version to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.</short-description> - - <description> - Set the version to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vsscp" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCP"> - - - <short-description>Performs CP (Change Project) commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Performs CP (Change Project) commands to Microsoft Visual SourceSafe. - <p>This task is typically used before a VssAdd in order to set the target project</p> - Based on the VSS Checkin code by Martin Poeschl - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vsscreate" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSCREATE"> - - - <short-description>Creates a new project in Microsoft Visual SourceSafe.</short-description> - - <description> - Creates a new project in Microsoft Visual SourceSafe. - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>login</td> - <td>username,password</td> - <td>No</td> - </tr> - <tr> - <td>vsspath</td> - <td>SourceSafe path of project to be created</td> - <td>Yes</td> - </tr> - <tr> - <td>ssdir</td> - <td>directory where <code>ss.exe</code> resides. By default the task - expects it to be in the PATH.</td> - <td>No</td> - </tr> - <tr> - <td>quiet</td> - <td>suppress output (off by default)</td> - <td>No</td> - </tr> - <tr> - <td>failOnError</td> - <td>fail if there is an error creating the project (true by default)</td> - <td>No</td> - </tr> - <tr> - <td>autoresponse</td> - <td>What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this.</td> - <td>No</td> - </tr> - <tr> - <td>comment</td> - <td>The comment to use for this label. Empty or '-' for no comment.</td> - <td>No</td> - </tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Comment to apply in SourceSafe.</short-description> - - <description> - Sets the comment to apply in SourceSafe. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Sets whether task should fail if there is an error creating the project; - optional, default true.</short-description> - - <description> - Sets whether task should fail if there is an error creating the project; - optional, default true. - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Sets/clears quiet mode; optional, default false.</short-description> - - <description> - Sets/clears quiet mode; optional, default false. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vssget" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSGET"> - - - <short-description>Perform Get commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Perform Get commands to Microsoft Visual SourceSafe. - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>login</td> - <td>username,password</td> - <td>No</td> - </tr> - <tr> - <td>vsspath</td> - <td>SourceSafe path</td> - <td>Yes</td> - </tr> - <tr> - <td>localpath</td> - <td>Override the working directory and get to the specified path</td> - <td>No</td> - </tr> - <tr> - <td>writable</td> - <td>true or false</td> - <td>No</td> - </tr> - <tr> - <td>recursive</td> - <td>true or false</td> - <td>No</td> - </tr> - <tr> - <td>version</td> - <td>a version number to get</td> - <td>No</td> - </tr> - <tr> - <td>date</td> - <td>a date stamp to get at</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>a label to get for</td> - <td>No</td> - </tr> - <tr> - <td>quiet</td> - <td>suppress output (off by default)</td> - <td>No</td> - </tr> - <tr> - <td>autoresponse</td> - <td>What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this.</td> - <td>No</td> - </tr> - </table> - <p>Note that only one of version, date or label should be specified</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="date" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.</short-description> - - <description> - Set the date to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - <p> - ORIGINAL COMMENT THAT DOES NOT SEEM AT ALL VALID: - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. date="${date}" when date - has not been defined to ant! - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.</short-description> - - <description> - Set the label to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - <p> - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. label="${label_server}" when label_server - has not been defined to ant! - </description> - - </attribute> - - <attribute name="localpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Override the working directory and get to the specified path; optional.</short-description> - - <description> - Override the working directory and get to the specified path; optional. - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="quiet" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to suppress output when true ; false by default.</short-description> - - <description> - Flag to suppress output when true ; false by default. - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to tell the task to recurse down the tree; - optional, default false.</short-description> - - <description> - Flag to tell the task to recurse down the tree; - optional, default false. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Version number to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed.</short-description> - - <description> - Set a version number to get; - optional, only one of <tt>version</tt>, <tt>label</tt>, or <tt>date</tt> - allowed. - <p> - ORIGINAL COMMENT THAT DOES NOT SEEM AT ALL VALID: - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. version="${ver_server}" when ver_server - has not been defined to ant! - NO, in this case the version string is "${ver_server}". - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - <attribute name="writable" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Make fetched files writable; optional, default false.</short-description> - - <description> - make fetched files writable; optional, default false. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vsshistory" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSHISTORY"> - - - <short-description>Performs History commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Performs History commands to Microsoft Visual SourceSafe. - </description> - - - <structure> - - - <attributes> - - <attribute name="dateformat" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Format of dates in fromDate and toDate; optional.</short-description> - - <description> - Format of dates in fromDate and toDate; optional. - Used when calculating dates with - the numdays attribute. - This string uses the formatting rules of SimpleDateFormat. - Defaults to DateFormat.SHORT. - </description> - - </attribute> - - <attribute name="fromdate" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Start Date for the Comparison of two versions; optional.</short-description> - - <description> - Set the Start Date for the Comparison of two versions; optional. - </description> - - </attribute> - - <attribute name="fromlabel" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Start Label; optional.</short-description> - - <description> - Set the Start Label; optional - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="numdays" type="int" briefType="int" required="NOTDEFINED"> - - <short-description>Number of days for comparison; - optional.</short-description> - - <description> - Set the number of days for comparison; - optional. - <p> - The default value is 2 days. (maybe) - </description> - - </attribute> - - <attribute name="output" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Output file name for the history; optional.</short-description> - - <description> - Set the output file name for the history; optional. - </description> - - </attribute> - - <attribute name="recursive" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to tell the task to recurse down the tree; - optional, default false.</short-description> - - <description> - Flag to tell the task to recurse down the tree; - optional, default false. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="style" type="org.apache.tools.ant.taskdefs.optional.vss.MSVSSHISTORY.BriefCodediffNofile" briefType=""brief", "codediff", "nofile", "default"" required="NOTDEFINED"> - - <short-description>Specify the output style; optional.</short-description> - - <description> - Specify the output style; optional. - </description> - - </attribute> - - <attribute name="todate" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>End Date for the Comparison of two versions; optional.</short-description> - - <description> - Set the End Date for the Comparison of two versions; optional. - </description> - - </attribute> - - <attribute name="tolabel" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>End Label ; optional.</short-description> - - <description> - Set the End Label ; optional - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name the user whose changes we would like to see; optional.</short-description> - - <description> - Name the user whose changes we would like to see; optional - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="vsslabel" category="scm" classname="org.apache.tools.ant.taskdefs.optional.vss.MSVSSLABEL"> - - - <short-description>Performs Label commands to Microsoft Visual SourceSafe.</short-description> - - <description> - Performs Label commands to Microsoft Visual SourceSafe. - - <p> - The following attributes are interpreted: - <table border="1"> - <tr> - <th>Attribute</th> - <th>Values</th> - <th>Required</th> - </tr> - <tr> - <td>login</td> - <td>username,password</td> - <td>No</td> - </tr> - <tr> - <td>vsspath</td> - <td>SourceSafe path</td> - <td>Yes</td> - </tr> - <tr> - <td>ssdir</td> - <td>directory where <code>ss.exe</code> resides. By default the task - expects it to be in the PATH.</td> - <td>No</td> - </tr> - <tr> - <td>label</td> - <td>A label to apply to the hierarchy</td> - <td>Yes</td> - </tr> - <tr> - <td>version</td> - <td>An existing file or project version to label</td> - <td>No</td> - </tr> - <tr> - <td>autoresponse</td> - <td>What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this.</td> - <td>No</td> - </tr> - <tr> - <td>comment</td> - <td>The comment to use for this label. Empty or '-' for no comment.</td> - <td>No</td> - </tr> - </table> - </description> - - - <structure> - - - <attributes> - - <attribute name="autoresponse" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>What to respond with (sets the -I option).</short-description> - - <description> - What to respond with (sets the -I option). By default, -I- is - used; values of Y or N will be appended to this. - </description> - - </attribute> - - <attribute name="comment" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The comment to use for this label; optional.</short-description> - - <description> - The comment to use for this label; optional. - Empty or '-' for no comment. - <p> - If this is null or empty, it will be replaced with "-" which - is what SourceSafe uses for an empty comment. - </description> - - </attribute> - - <attribute name="label" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Label to apply; required.</short-description> - - <description> - Set the label to apply; required. - <p> - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. label="${label_server}" when label_server - has not been defined to ant! - </description> - - </attribute> - - <attribute name="login" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The login to use when accessing VSS, formatted as "username,password"; - optional.</short-description> - - <description> - The login to use when accessing VSS, formatted as "username,password"; - optional. - <p> - You can omit the password if your database is not password protected. - if you have a password and omit it, Ant/VSS will hang. - </description> - - </attribute> - - <attribute name="serverpath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>srssafe.ini</code> resides; optional.</short-description> - - <description> - Set the directory where <code>srssafe.ini</code> resides; optional. - </description> - - </attribute> - - <attribute name="ssdir" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Directory where <code>ss.exe</code> resides; optional.</short-description> - - <description> - directory where <code>ss.exe</code> resides; optional. - By default the task expects it to be in the PATH. - </description> - - </attribute> - - <attribute name="version" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name an existing file or project version to label; optional.</short-description> - - <description> - Name an existing file or project version to label; optional. - By default the current version is labelled. - <p> - Note we assume that if the supplied string has the value "null" that something - went wrong and that the string value got populated from a null object. This - happens if a ant variable is used e.g. version="${ver_server}" when ver_server - has not been defined to ant! - </description> - - </attribute> - - <attribute name="vsspath" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required.</short-description> - - <description> - SourceSafe path which specifies the project/file(s) you wish to - perform the action on; required. You should not specify the leading dollar-sign - - it is prepended by Ant automatically. - <p> - Ant can't cope with a '$' sign in an attribute so we have to add it here. - Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed! - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="waitfor" category="control" classname="org.apache.tools.ant.taskdefs.WaitFor"> - - - <short-description>Wait for an external event to occur.</short-description> - - <description> - Wait for an external event to occur. - - Wait for an external process to start or to complete some - task. This is useful with the <code>parallel</code> task to - syncronize the execution of tests with server startup. - - The following attributes can be specified on a waitfor task: - <ul> - <li>maxwait - maximum length of time to wait before giving up</li> - <li>maxwaitunit - The unit to be used to interpret maxwait attribute</li> - <li>checkevery - amount of time to sleep between each check</li> - <li>checkeveryunit - The unit to be used to interpret checkevery attribute</li> - <li>timeoutproperty - name of a property to set if maxwait has been exceeded.</li> - </ul> - - The maxwaitunit and checkeveryunit are allowed to have the following values: - millesond, second, minute, hour, day and week. The default is millisecond. - </description> - - - <structure> - - - <attributes> - - <attribute name="checkevery" type="long" briefType="long" required="no"> - - <short-description>Time between each check.</short-description> - - <description> - Set the time between each check - </description> - - </attribute> - - <attribute name="checkeveryunit" type="org.apache.tools.ant.taskdefs.WaitFor.Unit" briefType=""millisecond", "second", "minute", "hour", "day", "week"" required="no"> - - <short-description>Check every time unit.</short-description> - - <description> - Set the check every time unit - </description> - - </attribute> - - <attribute name="maxwait" type="long" briefType="long" required="no"> - - <short-description>Maximum length of time to wait.</short-description> - - <description> - Set the maximum length of time to wait - </description> - - </attribute> - - <attribute name="maxwaitunit" type="org.apache.tools.ant.taskdefs.WaitFor.Unit" briefType=""millisecond", "second", "minute", "hour", "day", "week"" required="no"> - - <short-description>Max wait time unit.</short-description> - - <description> - Set the max wait time unit - </description> - - </attribute> - - <attribute name="timeoutproperty" type="java.lang.String" briefType="String" required="no"> - - <short-description>Name the property to set after a timeout.</short-description> - - <description> - Name the property to set after a timeout. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="and" type="org.apache.tools.ant.taskdefs.condition.And" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;and&gt; condition "container".</short-description> - - <description> - Add an &lt;and&gt; condition "container". - </description> - - </element> - - - <element name="available" type="org.apache.tools.ant.taskdefs.Available" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;available&gt; condition.</short-description> - - <description> - Add an &lt;available&gt; condition. - </description> - - </element> - - - <element name="checksum" type="org.apache.tools.ant.taskdefs.Checksum" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;checksum&gt; condition.</short-description> - - <description> - Add an &lt;checksum&gt; condition. - </description> - - </element> - - - <element name="contains" type="org.apache.tools.ant.taskdefs.condition.Contains" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;contains&gt; condition.</short-description> - - <description> - Add a &lt;contains&gt; condition. - </description> - - </element> - - - <element name="equals" type="org.apache.tools.ant.taskdefs.condition.Equals" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;equals&gt; condition.</short-description> - - <description> - Add an &lt;equals&gt; condition. - </description> - - </element> - - - <element name="filesmatch" type="org.apache.tools.ant.taskdefs.condition.FilesMatch" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;filesmatch&gt; condition.</short-description> - - <description> - Add a &lt;filesmatch&gt; condition. - </description> - - </element> - - - <element name="http" type="org.apache.tools.ant.taskdefs.condition.Http" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;http&gt; condition.</short-description> - - <description> - Add an &lt;http&gt; condition. - </description> - - </element> - - - <element name="isfalse" type="org.apache.tools.ant.taskdefs.condition.IsFalse" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;isfalse&gt; condition.</short-description> - - <description> - Add a &lt;isfalse&gt; condition. - </description> - - </element> - - - <element name="isset" type="org.apache.tools.ant.taskdefs.condition.IsSet" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;isset&gt; condition.</short-description> - - <description> - Add an &lt;isset&gt; condition. - </description> - - </element> - - - <element name="istrue" type="org.apache.tools.ant.taskdefs.condition.IsTrue" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;istrue&gt; condition.</short-description> - - <description> - Add a &lt;istrue&gt; condition. - </description> - - </element> - - - <element name="not" type="org.apache.tools.ant.taskdefs.condition.Not" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;not&gt; condition "container".</short-description> - - <description> - Add an &lt;not&gt; condition "container". - </description> - - </element> - - - <element name="or" type="org.apache.tools.ant.taskdefs.condition.Or" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;or&gt; condition "container".</short-description> - - <description> - Add an &lt;or&gt; condition "container". - </description> - - </element> - - - <element name="os" type="org.apache.tools.ant.taskdefs.condition.Os" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;os&gt; condition.</short-description> - - <description> - Add an &lt;os&gt; condition. - </description> - - </element> - - - <element name="socket" type="org.apache.tools.ant.taskdefs.condition.Socket" briefType="" required="NOTDEFINED"> - - <short-description>Add a &lt;socket&gt; condition.</short-description> - - <description> - Add a &lt;socket&gt; condition. - </description> - - </element> - - - <element name="uptodate" type="org.apache.tools.ant.taskdefs.UpToDate" briefType="" required="NOTDEFINED"> - - <short-description>Add an &lt;uptodate&gt; condition.</short-description> - - <description> - Add an &lt;uptodate&gt; condition. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="war" category="packaging" classname="org.apache.tools.ant.taskdefs.War" matchingTask="true"> - - - <short-description>An extension of &lt;jar&gt; to create a WAR archive.</short-description> - - <description> - An extension of &lt;jar&gt; to create a WAR archive. - Contains special treatment for files that should end up in the - <code>WEB-INF/lib</code>, <code>WEB-INF/classes</code> or - <code>WEB-INF</code> directories of the Web Application Archive.</p> - <p>(The War task is a shortcut for specifying the particular layout of a WAR file. - The same thing can be accomplished by using the <i>prefix</i> and <i>fullpath</i> - attributes of zipfilesets in a Zip or Jar task.)</p> - <p>The extended zipfileset element from the zip task (with attributes <i>prefix</i>, <i>fullpath</i>, and <i>src</i>) is available in the War task.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="basedir" type="java.io.File" briefType="File" required="no"> - - <short-description>Directory from which to archive files; optional.</short-description> - - <description> - Directory from which to archive files; optional. - </description> - - </attribute> - - <attribute name="compress" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether we want to compress the files or only store them; - optional, default=true;.</short-description> - - <description> - Whether we want to compress the files or only store them; - optional, default=true; - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The file to create; required.</short-description> - - <description> - The file to create; required. - </description> - - </attribute> - - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" briefType=""add", "preserve", "fail"" required="no"> - - <short-description>Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.</short-description> - - <description> - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding to use for filenames, defaults to the platform's - default encoding.</short-description> - - <description> - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - </description> - - </attribute> - - <attribute name="filesonly" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.</short-description> - - <description> - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - </description> - - </attribute> - - <attribute name="index" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Set whether or not to create an index list for classes.</short-description> - - <description> - Set whether or not to create an index list for classes. - This may speed up classloading in some cases. - </description> - - </attribute> - - <attribute name="manifest" type="java.io.File" briefType="File" required="no"> - - <short-description>The manifest file to use.</short-description> - - <description> - The manifest file to use. This can be either the location of a manifest, - or the name of a jar added through a fileset. If its the name of an added - jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.MF. - </description> - - </attribute> - - <attribute name="update" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.</short-description> - - <description> - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - </description> - - </attribute> - - <attribute name="webxml" type="java.io.File" briefType="File" required="yes, unless update is set to true"> - - <short-description>Deployment descriptor to use (WEB-INF/web.xml); - required unless <tt>update=true</tt>.</short-description> - - <description> - set the deployment descriptor to use (WEB-INF/web.xml); - required unless <tt>update=true</tt> - </description> - - </attribute> - - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" briefType=""fail", "skip", "create"" required="NOTDEFINED"> - - <short-description>Sets behavior of the task when no files match.</short-description> - - <description> - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classes" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Add files under WEB-INF/classes.</short-description> - - <description> - add files under WEB-INF/classes - </description> - - </element> - - - <element name="manifest" type="org.apache.tools.ant.taskdefs.Manifest" briefType="" required="NOTDEFINED"> - - <short-description>Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file.</short-description> - - <description> - Allows the manifest for the archive file to be provided inline - in the buildfile rather than in an external file. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files.</short-description> - - <description> - Adds a set of files. - </description> - - </element> - - - <element name="lib" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Add files under WEB-INF/lib/.</short-description> - - <description> - add files under WEB-INF/lib/ - </description> - - </element> - - - <element name="metainf" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a zipfileset to include in the META-INF directory.</short-description> - - <description> - Adds a zipfileset to include in the META-INF directory. - </description> - - </element> - - - <element name="webinf" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Files to add under WEB-INF;.</short-description> - - <description> - files to add under WEB-INF; - </description> - - </element> - - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a group of zip files.</short-description> - - <description> - Adds a group of zip files. - </description> - - </element> - - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a set of files that can be - read from an archive and be given a prefix/fullpath.</short-description> - - <description> - Adds a set of files that can be - read from an archive and be given a prefix/fullpath. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="wljspc" category="other" classname="org.apache.tools.ant.taskdefs.optional.jsp.WLJspc" matchingTask="true"> - - - <short-description>Precompiles JSP's using WebLogic's JSP compiler (weblogic.jspc).</short-description> - - <description> - Precompiles JSP's using WebLogic's JSP compiler (weblogic.jspc). - </description> - - - <structure> - - - <attributes> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="yes"> - - <short-description>Classpath to be used for this compilation.</short-description> - - <description> - Set the classpath to be used for this compilation. - </description> - - </attribute> - - <attribute name="dest" type="java.io.File" briefType="File" required="yes"> - - <short-description>Directory containing the source jsp's.</short-description> - - <description> - Set the directory containing the source jsp's - </description> - - </attribute> - - <attribute name="package" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Package under which the compiled classes go.</short-description> - - <description> - Set the package under which the compiled classes go - </description> - - </attribute> - - <attribute name="src" type="java.io.File" briefType="File" required="yes"> - - <short-description>Directory containing the source jsp's.</short-description> - - <description> - Set the directory containing the source jsp's - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Maybe creates a nested classpath element.</short-description> - - <description> - Maybe creates a nested classpath element. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="wlrun" category="other" classname="org.apache.tools.ant.taskdefs.optional.ejb.WLRun"> - - - <short-description>Starts a WebLogic server.</short-description> - - <description> - Starts a WebLogic server. - A number of parameters are used to control the operation of the weblogic instance. Note that the task, - and hence ant, will not complete until the weblogic instance is stopped.</p> - </description> - - - <structure> - - - <attributes> - - <attribute name="args" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Additional argument string passed to the Weblogic instance; - optional.</short-description> - - <description> - Additional argument string passed to the Weblogic instance; - optional. - </description> - - </attribute> - - <attribute name="beahome" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The location of the BEA Home; implicitly - selects Weblogic 6.0; optional.</short-description> - - <description> - The location of the BEA Home; implicitly - selects Weblogic 6.0; optional. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>The classpath to be used with the Java Virtual Machine that runs the Weblogic - Server; required.</short-description> - - <description> - The classpath to be used with the Java Virtual Machine that runs the Weblogic - Server; required. Prior to Weblogic 6.0, this is typically set to the Weblogic - boot classpath. Under Weblogic 6.0 this should include all the - weblogic jars - </description> - - </attribute> - - <attribute name="domain" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Domain to run in; required for WL6.0.</short-description> - - <description> - Set the Domain to run in; required for WL6.0 - </description> - - </attribute> - - <attribute name="home" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The location where weblogic lives.</short-description> - - <description> - The location where weblogic lives. - Required. This is the absolute location, not relative to - BEA home. - </description> - - </attribute> - - <attribute name="jvmargs" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Additional arguments to pass to the weblogic JVM.</short-description> - - <description> - Set the additional arguments to pass to the weblogic JVM - </description> - - </attribute> - - <attribute name="name" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of the weblogic server within the weblogic home which is to be run.</short-description> - - <description> - The name of the weblogic server within the weblogic home which is to be run. - Optiona, defaults to &quot;myserver&quot; - </description> - - </attribute> - - <attribute name="pkpassword" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Private key password so the server can decrypt the SSL private key file; - optional and only applicable to WL6.0.</short-description> - - <description> - Set the private key password so the server can decrypt the SSL private key file; - optional and only applicable to WL6.0. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Management password of the server; - optional and only applicable to WL6.0.</short-description> - - <description> - Set the management password of the server; - optional and only applicable to WL6.0. - </description> - - </attribute> - - <attribute name="policy" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of the security policy file within the weblogic home directory that - is to be used.</short-description> - - <description> - The name of the security policy file within the weblogic home directory that - is to be used. If not specified, the default policy file <code>weblogic.policy</code> - is used. - </description> - - </attribute> - - <attribute name="properties" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The name of the server's properties file within the weblogic home directory - used to control the weblogic instance; - required for WL4.5.1.</short-description> - - <description> - The name of the server's properties file within the weblogic home directory - used to control the weblogic instance; - required for WL4.5.1 - </description> - - </attribute> - - <attribute name="username" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Management username to run the server; - optional and only applicable to WL6.0.</short-description> - - <description> - Set the management username to run the server; - optional and only applicable to WL6.0. - </description> - - </attribute> - - <attribute name="weblogicmainclass" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Name of the main class for weblogic; optional.</short-description> - - <description> - name of the main class for weblogic; optional. - </description> - - </attribute> - - <attribute name="wlclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Weblogic classpath used by the Weblogic Server; - optional, and only applicable to WL4.5.1 - - The weblogic classpath is used by weblogic to support dynamic class loading.</short-description> - - <description> - Set the weblogic classpath used by the Weblogic Server; - optional, and only applicable to WL4.5.1 - - The weblogic classpath is used by weblogic to support dynamic class loading. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Add the classpath for the user classes.</short-description> - - <description> - Add the classpath for the user classes - </description> - - </element> - - - <element name="wlclasspath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Get the classpath to the weblogic classpaths.</short-description> - - <description> - Get the classpath to the weblogic classpaths - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="wlstop" category="other" classname="org.apache.tools.ant.taskdefs.optional.ejb.WLStop"> - - - <short-description>Shuts down a WebLogic server.</short-description> - - <description> - Shuts down a WebLogic server. - To shut down an instance you must supply both a username and - a password. - </description> - - - <structure> - - - <attributes> - - <attribute name="beahome" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The location of the BEA Home; implicitly - selects Weblogic 6.0 shutdown; optional.</short-description> - - <description> - The location of the BEA Home; implicitly - selects Weblogic 6.0 shutdown; optional. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command;.</short-description> - - <description> - The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command; - </description> - - </attribute> - - <attribute name="delay" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Delay (in seconds) before shutting down the server; - optional.</short-description> - - <description> - Set the delay (in seconds) before shutting down the server; - optional. - </description> - - </attribute> - - <attribute name="password" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The password for the account specified in the - user parameter; required.</short-description> - - <description> - The password for the account specified in the - user parameter; required - </description> - - </attribute> - - <attribute name="url" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>URL to which the weblogic server is listening - for T3 connections; required.</short-description> - - <description> - Set the URL to which the weblogic server is listening - for T3 connections; required. - </description> - - </attribute> - - <attribute name="user" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>The username of the account which will be used to shutdown the server; - required.</short-description> - - <description> - The username of the account which will be used to shutdown the server; - required. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command;.</short-description> - - <description> - The classpath to be used with the Java Virtual Machine that runs the Weblogic - Shutdown command; - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="wsdltodotnet" category="dotnet" classname="org.apache.tools.ant.taskdefs.optional.dotnet.WsdlToDotnet"> - - - <short-description>Converts a WSDL file or URL resource into a .NET language.</short-description> - - <description> - Converts a WSDL file or URL resource into a .NET language. - - See "Creating an XML Web Service Proxy", "wsdl.exe" docs in - the framework SDK documentation - </description> - - - <structure> - - - <attributes> - - <attribute name="destfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>Name of the file to generate.</short-description> - - <description> - Name of the file to generate. Required - </description> - - </attribute> - - <attribute name="extraoptions" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Any extra WSDL.EXE options which aren't explicitly - supported by the ant wrapper task; optional.</short-description> - - <description> - Any extra WSDL.EXE options which aren't explicitly - supported by the ant wrapper task; optional - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Should failure halt the build?.</short-description> - - <description> - Should failure halt the build? optional, default=true - </description> - - </attribute> - - <attribute name="language" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Language; one of "CS", "JS", or "VB" - optional, default is CS for C# source.</short-description> - - <description> - set the language; one of "CS", "JS", or "VB" - optional, default is CS for C# source - </description> - - </attribute> - - <attribute name="namespace" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>Namespace to place the source in. - optional; default "".</short-description> - - <description> - namespace to place the source in. - optional; default "" - </description> - - </attribute> - - <attribute name="server" type="boolean" briefType="boolean" required="NOTDEFINED"> - - <short-description>Flag to enable server side code generation; - optional, default=false.</short-description> - - <description> - flag to enable server side code generation; - optional, default=false - </description> - - </attribute> - - <attribute name="srcfile" type="java.io.File" briefType="File" required="NOTDEFINED"> - - <short-description>The local WSDL file to parse; either url or srcFile is required.</short-description> - - <description> - The local WSDL file to parse; either url or srcFile is required. - </description> - - </attribute> - - <attribute name="url" type="java.lang.String" briefType="String" required="NOTDEFINED"> - - <short-description>URL to fetch.</short-description> - - <description> - Sets the URL to fetch. Fetching is by wsdl.exe; Ant proxy settings - are ignored; either url or srcFile is required. - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="xmlproperty" category="xml" classname="org.apache.tools.ant.taskdefs.XmlProperty"> - - - <short-description>Loads property values from a valid XML file, generating the property names from the file's element and attribute names.</short-description> - - <description> - Loads property values from a valid XML file, - generating the property names from the file's element and attribute names. - - Example: - <pre> - &lt;root-tag myattr="true"&gt; - &lt;inner-tag someattr="val"&gt;Text&lt;/inner-tag&gt; - &lt;a2&gt;&lt;a3&gt;&lt;a4&gt;false&lt;/a4&gt;&lt;/a3&gt;&lt;/a2&gt; - &lt;/root-tag&gt; -</pre> - this generates - <pre> - root-tag(myattr)=true - root-tag.inner-tag=Text - root-tag.inner-tag(someattr)=val - root-tag.a2.a3.a4=false - </pre> - </description> - - - <structure> - - - <attributes> - - <attribute name="collapseattributes" type="boolean" briefType="boolean" required="no, default is false."> - - <short-description>Flag to treat attributes as nested elements; - optional, default false.</short-description> - - <description> - flag to treat attributes as nested elements; - optional, default false - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="yes"> - - <short-description>The XML file to parse; required.</short-description> - - <description> - The XML file to parse; required. - </description> - - </attribute> - - <attribute name="keeproot" type="boolean" briefType="boolean" required="no, default is true."> - - <short-description>Flag to include the xml root tag as a - first value in the property name; optional, - default is true.</short-description> - - <description> - flag to include the xml root tag as a - first value in the property name; optional, - default is true - </description> - - </attribute> - - <attribute name="prefix" type="java.lang.String" briefType="String" required="no"> - - <short-description>The prefix to prepend to each property.</short-description> - - <description> - the prefix to prepend to each property - </description> - - </attribute> - - <attribute name="validate" type="boolean" briefType="boolean" required="no, default is false."> - - <short-description>Flag to validate the XML file; optional, default false.</short-description> - - <description> - flag to validate the XML file; optional, default false - </description> - - </attribute> - - </attributes> - - - <elements> - </elements> - - - </structure> - - - </task> - - - - <task name="xmlvalidate" category="other" classname="org.apache.tools.ant.taskdefs.optional.XMLValidateTask"> - - - <short-description>Checks XML files are valid (or only well formed).</short-description> - - <description> - Checks XML files are valid (or only well formed). The - task uses the SAX2 parser implementation provided by JAXP by default - (probably the one that is used by Ant itself), but one can specify any - SAX1/2 parser if needed - </description> - - - <structure> - - - <attributes> - - <attribute name="classname" type="java.lang.String" briefType="String" required="no"> - - <short-description>Specify the class name of the SAX parser to be used. (optional).</short-description> - - <description> - Specify the class name of the SAX parser to be used. (optional) - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Specify the classpath to be searched to load the parser (optional).</short-description> - - <description> - Specify the classpath to be searched to load the parser (optional) - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Where to find the parser class; optional.</short-description> - - <description> - Where to find the parser class; optional. - </description> - - </attribute> - - <attribute name="failonerror" type="boolean" briefType="boolean" required="no"> - - <short-description>Specify how parser error are to be handled; - optional, default=true - <p> - If set to <code>true</code> (default), throw a buildException if the parser yields an error.</short-description> - - <description> - Specify how parser error are to be handled; - optional, default=true - <p> - If set to <code>true</code> (default), throw a buildException if the parser yields an error. - </description> - - </attribute> - - <attribute name="file" type="java.io.File" briefType="File" required="no"> - - <short-description>Specify the file to be checked; optional.</short-description> - - <description> - specify the file to be checked; optional. - </description> - - </attribute> - - <attribute name="lenient" type="boolean" briefType="boolean" required="no"> - - <short-description>Specify whether the parser should be validating.</short-description> - - <description> - Specify whether the parser should be validating. Default is <code>true</code>. - <p> - If set to false, the validation will fail only if the parsed document is not well formed XML. - <p> - this option is ignored if the specified class with {@link #setClassName(String)} is not a SAX2 - XMLReader. - </description> - - </attribute> - - <attribute name="warn" type="boolean" briefType="boolean" required="no"> - - <short-description>Specify how parser error are to be handled.</short-description> - - <description> - Specify how parser error are to be handled. - <p> - If set to <code>true</true> (default), log a warn message for each SAX warn event. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="xmlcatalog" type="org.apache.tools.ant.types.XMLCatalog" briefType="XMLCatalog" required="NOTDEFINED"> - - <short-description>Add an XMLCatalog as a nested element; optional.</short-description> - - <description> - add an XMLCatalog as a nested element; optional. - </description> - - </element> - - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Specify a set of file to be checked.</short-description> - - <description> - specify a set of file to be checked - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>No description.</short-description> - - <description> - - </description> - - </element> - - - <element name="dtd" type="org.apache.tools.ant.types.DTDLocation" briefType="" required="NOTDEFINED"> - - <short-description>Create a DTD location record; optional.</short-description> - - <description> - Create a DTD location record; optional. - This stores the location of a DTD. The DTD is identified - by its public Id. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="xslt" category="xml" classname="org.apache.tools.ant.taskdefs.XSLTProcess" matchingTask="true"> - - - <short-description>Processes a set of XML documents via XSLT.</short-description> - - <description> - Processes a set of XML documents via XSLT. This is - useful for building views of XML based documentation. - </description> - - - <structure> - - - <attributes> - - <attribute name="basedir" type="java.io.File" briefType="File" required="no"> - - <short-description>Base directory; - optional, default is the project's basedir.</short-description> - - <description> - Set the base directory; - optional, default is the project's basedir. - </description> - - </attribute> - - <attribute name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="no"> - - <short-description>Optional classpath to the XSL processor.</short-description> - - <description> - Set the optional classpath to the XSL processor - </description> - - </attribute> - - <attribute name="classpathref" type="org.apache.tools.ant.types.Reference" briefType="Reference" required="no"> - - <short-description>Reference to an optional classpath to the XSL processor.</short-description> - - <description> - Set the reference to an optional classpath to the XSL processor - </description> - - </attribute> - - <attribute name="destdir" type="java.io.File" briefType="File" required="yes, unless in and out have been specified."> - - <short-description>Destination directory into which the XSL result - files should be copied to; - required, unless <tt>in</tt> and <tt>out</tt> are - specified.</short-description> - - <description> - Set the destination directory into which the XSL result - files should be copied to; - required, unless <tt>in</tt> and <tt>out</tt> are - specified. - </description> - - </attribute> - - <attribute name="extension" type="java.lang.String" briefType="String" required="no"> - - <short-description>Desired file extension to be used for the target; - optional, default is html.</short-description> - - <description> - Set the desired file extension to be used for the target; - optional, default is html. - </description> - - </attribute> - - <attribute name="force" type="boolean" briefType="boolean" required="no; default is false"> - - <short-description>Set whether to check dependencies, or always generate; - optional, default is false.</short-description> - - <description> - Set whether to check dependencies, or always generate; - optional, default is false. - </description> - - </attribute> - - <attribute name="in" type="java.io.File" briefType="File" required="no"> - - <short-description>Specifies a single XML document to be styled.</short-description> - - <description> - specifies a single XML document to be styled. Should be used - with the <tt>out</tt> attribute; ; required if <tt>out</tt> is set - </description> - - </attribute> - - <attribute name="out" type="java.io.File" briefType="File" required="no"> - - <short-description>Specifies the output name for the styled result from the - <tt>in</tt> attribute; required if <tt>in</tt> is set.</short-description> - - <description> - Specifies the output name for the styled result from the - <tt>in</tt> attribute; required if <tt>in</tt> is set - </description> - - </attribute> - - <attribute name="processor" type="java.lang.String" briefType="String" required="no"> - - <short-description>Name of the XSL processor to use; optional, default trax.</short-description> - - <description> - Set the name of the XSL processor to use; optional, default trax. - Other values are "xalan" for Xalan1 and "xslp" for XSL:P, though the - later is strongly deprecated. - </description> - - </attribute> - - <attribute name="scanincludeddirectories" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether to style all files in the included directories as well; - optional, default is true.</short-description> - - <description> - Whether to style all files in the included directories as well; - optional, default is true. - </description> - - </attribute> - - <attribute name="style" type="java.lang.String" briefType="String" required="yes"> - - <short-description>Name of the stylesheet to use - given either relative - to the project's basedir or as an absolute path; required.</short-description> - - <description> - Name of the stylesheet to use - given either relative - to the project's basedir or as an absolute path; required. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="xmlcatalog" type="org.apache.tools.ant.types.XMLCatalog" briefType="XMLCatalog" required="NOTDEFINED"> - - <short-description>Add the catalog to our internal catalog.</short-description> - - <description> - Add the catalog to our internal catalog - </description> - - </element> - - - <element name="classpath" type="org.apache.tools.ant.types.Path" briefType="Path" required="NOTDEFINED"> - - <short-description>Optional classpath to the XSL processor.</short-description> - - <description> - Set the optional classpath to the XSL processor - </description> - - </element> - - - <element name="outputproperty" type="org.apache.tools.ant.taskdefs.XSLTProcess.OutputProperty" briefType="" required="NOTDEFINED"> - - <short-description>Create an instance of an output property to be configured.</short-description> - - <description> - Create an instance of an output property to be configured. - </description> - - </element> - - - <element name="param" type="org.apache.tools.ant.taskdefs.XSLTProcess.Param" briefType="" required="NOTDEFINED"> - - <short-description>Create an instance of an XSL parameter for configuration by Ant.</short-description> - - <description> - Create an instance of an XSL parameter for configuration by Ant. - </description> - - </element> - - - </elements> - - - </structure> - - - </task> - - - - <task name="zip" category="packaging" classname="org.apache.tools.ant.taskdefs.Zip" matchingTask="true"> - <short-description>Create a Zip file.</short-description> - <description> - Create a Zip file. - </description> - <structure> - <attributes> - <attribute name="basedir" type="java.io.File" briefType="File" required="no"> - <short-description>Directory from which to archive files; optional.</short-description> - <description> - Directory from which to archive files; optional. - </description> - </attribute> - <attribute name="compress" type="boolean" briefType="boolean" required="no"> - - <short-description>Whether we want to compress the files or only store them; - optional, default=true;.</short-description> - - <description> - Whether we want to compress the files or only store them; - optional, default=true; - </description> - - </attribute> - - <attribute name="destfile" type="java.io.File" briefType="File" required="yes"> - - <short-description>The file to create; required.</short-description> - - <description> - The file to create; required. - </description> - - </attribute> - - <attribute name="duplicate" type="org.apache.tools.ant.taskdefs.Zip.Duplicate" briefType=""add", "preserve", "fail"" required="no"> - - <short-description>Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>.</short-description> - - <description> - Sets behavior for when a duplicate file is about to be added - - one of <code>keep</code>, <code>skip</code> or <code>overwrite</code>. - Possible values are: <code>keep</code> (keep both - of the files); <code>skip</code> (keep the first version - of the file found); <code>overwrite</code> overwrite the file - with the new file - Default for zip tasks is <code>keep</code> - </description> - - </attribute> - - <attribute name="encoding" type="java.lang.String" briefType="String" required="no"> - - <short-description>Encoding to use for filenames, defaults to the platform's - default encoding.</short-description> - - <description> - Encoding to use for filenames, defaults to the platform's - default encoding. - - <p>For a list of possible values see <a - href="http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html">http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html</a>.</p> - </description> - - </attribute> - - <attribute name="filesonly" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false.</short-description> - - <description> - If true, emulate Sun's jar utility by not adding parent directories; - optional, defaults to false. - </description> - - </attribute> - - <attribute name="update" type="boolean" briefType="boolean" required="no"> - - <short-description>If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false.</short-description> - - <description> - If true, updates an existing file, otherwise overwrite - any existing one; optional defaults to false. - </description> - - </attribute> - - <attribute name="whenempty" type="org.apache.tools.ant.taskdefs.Zip.WhenEmpty" briefType=""fail", "skip", "create"" required="no"> - - <short-description>Sets behavior of the task when no files match.</short-description> - - <description> - Sets behavior of the task when no files match. - Possible values are: <code>fail</code> (throw an exception - and halt the build); <code>skip</code> (do not create - any archive, but issue a warning); <code>create</code> - (make an archive with no entries). - Default for zip tasks is <code>skip</code>; - for jar tasks, <code>create</code>. - </description> - - </attribute> - - </attributes> - - - <elements> - - <element name="fileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a set of files.</short-description> - - <description> - Adds a set of files. - </description> - - </element> - - - <element name="zipgroupfileset" type="org.apache.tools.ant.types.FileSet" briefType="Fileset" required="NOTDEFINED"> - - <short-description>Adds a group of zip files.</short-description> - - <description> - Adds a group of zip files. - </description> - - </element> - - - <element name="zipfileset" type="org.apache.tools.ant.types.ZipFileSet" briefType="ZipFileset" required="NOTDEFINED"> - - <short-description>Adds a set of files that can be - read from an archive and be given a prefix/fullpath.</short-description> - - <description> - Adds a set of files that can be - read from an archive and be given a prefix/fullpath. - </description> - - </element> - - - </elements> - - - </structure> - </task> - - - <task name="target"> - <short-description>Ant target that is executable and may depend on other targets.</short-description> - <description> - Ant target that is executable and may depend on other targets. - </description> - <structure> - <attributes> - <attribute name="name" required="yes"> - <short-description>the name of the target.</short-description> - <description>the name of the target.</description> - </attribute> - <attribute name="depends" required="no"> - <short-description>a comma-separated list of names of targets on which this target depends.</short-description> - <description>a comma-separated list of names of targets on which this target depends.</description> - </attribute> - <attribute name="if" required="no"> - <short-description>the name of the property that must be set in order for this target to execute.</short-description> - <description>the name of the property that must be set in order for this target to execute.</description> - </attribute> - <attribute name="unless" required="no"> - <short-description>the name of the property that must not be set in order for this target to execute.</short-description> - <description>the name of the property that must not be set in order for this target to execute.</description> - </attribute> - <attribute name="description" required="no"> - <short-description>a short description of this target's function.</short-description> - <description>a short description of this target's function.</description> - </attribute> - </attributes> - </structure> - </task> - -</tasks> - diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/AntDTDMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/AntDTDMessages.java deleted file mode 100644 index 88c6a9d72..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/AntDTDMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntDTDMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.dtd.AntDTDMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntDTDMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/AntDTDMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/AntDTDMessages.properties deleted file mode 100644 index 0e5cf6936..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/AntDTDMessages.properties +++ /dev/null @@ -1,13 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -Parser.XML_parser_does_not_support_DeclHandler_1=XML parser does not support DeclHandler -Parser.Error_parsing_XML_document_or_DTD_2=Error parsing XML document or DTD diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IAtom.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IAtom.java deleted file mode 100644 index ca8ddf819..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IAtom.java +++ /dev/null @@ -1,31 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -/** - * Schema atom interface. - * @author Bob Foster - */ -public interface IAtom { - - public static final int ELEMENT = 0; - public static final int ATTRIBUTE = 1; - - /** - * Return the atom name. - */ - public String getName(); - - /** - * Return the atom name. - */ - public String toString(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IAttribute.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IAttribute.java deleted file mode 100644 index 91b5abc0b..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IAttribute.java +++ /dev/null @@ -1,64 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -/** - * Schema attribute interface. - * @author Bob Foster - */ -public interface IAttribute extends IAtom { - - public static final String CDATA = "CDATA"; //$NON-NLS-1$ - public static final String ID = "ID"; //$NON-NLS-1$ - public static final String IDREF = "IDREF"; //$NON-NLS-1$ - public static final String IDREFS = "IDREFS"; //$NON-NLS-1$ - public static final String NMTOKEN = "NMTOKEN"; //$NON-NLS-1$ - public static final String NMTOKENS = "NMTOKENS"; //$NON-NLS-1$ - public static final String ENTITY = "ENTITY"; //$NON-NLS-1$ - public static final String ENTITIES = "ENTITIES"; //$NON-NLS-1$ - public static final String NOTATION = "NOTATION"; //$NON-NLS-1$ - public static final String ENUMERATION = "enumeration"; //$NON-NLS-1$ - - /** - * @return the attribute type. This will be one of "CDATA", "ID", "IDREF", - * "IDREFS", "NMTOKEN", "NMTOKENS", "ENTITY", "ENTITIES", "NOTATION" or - * "enumeration". The type is interned and may be compared to a constant - * with ==. For "NOTATION" or "enumeration", <code>getEnum()</code> will - * return a list of values. - */ - public String getType(); - - /** - * - * @return String[] or null if type is not "NOTATION" or "enumeration". - */ - public String[] getEnum(); - - /** - * Return the element the attribute is defined in. - */ - public IElement getElement(); - - /** - * Return the default value or null if none. - */ - public String getDefault(); - - /** - * Return true if the default value is fixed. - */ - public boolean isFixed(); - - /** - * Return true if attribute is required, false if it is optional. - */ - public boolean isRequired(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IDfm.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IDfm.java deleted file mode 100644 index 5ad2b38c5..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IDfm.java +++ /dev/null @@ -1,86 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -/** - * A Dfm is an IModel converted to a form more appropriate for - * validation. The whole point of a Dfm is to run fast. - * @author Bob Foster - */ -public interface IDfm { - - /** - * Return true if no further symbols are required. - */ - boolean isAccepting(); - - /** - * If the symbol represented by name is acceptable, - * return the dfm to apply to the next (child) symbol. - * Otherwise, return null. - */ - IDfm advance(String name); - - /** - * If the symbol represented by the namespace,name pair is acceptable, - * return the dfm to apply to the next (child) symbol. Otherwise, return - * null. - */ - IDfm advance(String namespace, String localname); - - /** - * If the symbol represented by name is acceptable - * to <code>advance()</code> - * return the corresponding atom. - * Otherwise, return null. - */ - IAtom getAtom(String name); - - /** - * Return the symbols for which <code>advance()</code> - * will return a next dfm. If no symbols will - * advance this dfm or if any symbol will, returns - * an empty array. Use <code>isAny()</code> and - * <code>isEmpty()</code> to disambiguate the - * cases. - */ - String[] getAccepts(); - - /** - * Return the symbols for which <code>advance()</code> - * will return a next dfm. If no symbols will - * advance this dfm or if any symbol will, returns - * null. Use <code>isAny()</code> and - * <code>isEmpty()</code> to disambiguate the - * cases. - */ - Object[] getKeys(); - - /** - * Return true if dfm will accept any symbol - * and return itself; false otherwise. - * This interface keeps the dfm from needing - * schema knowledge, but a better way to - * process an ANY dfm for elements is use the - * schema to look up the element and use its - * dfm instead of this one. - */ - boolean isAny(); - - /** - * Return true if dfm will reject every symbol - * (<code>advance()</code> returns null); - * false otherwise. Included for completeness, - * so every element can have a dfm, regardless - * of its type. - */ - boolean isEmpty(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IElement.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IElement.java deleted file mode 100644 index 026f08c8a..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IElement.java +++ /dev/null @@ -1,70 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -import java.util.Map; - -/** - * IElement interface. - * @author Bob Foster - */ -public interface IElement extends IAtom { - - /** - * @return true if the element has been referenced in a schema but is not - * yet defined. - */ - public boolean isUndefined(); - - /** - * @return true if element model is <code>"(#PCDATA)"</code>. - */ - public boolean isText(); - - /** - * @return true if element model is mixed, i.e., - * <code>"(#PCDATA|...)*"</code>. - * @return String - */ - public boolean isMixed(); - - /** - * @return true if element model is EMPTY. - */ - public boolean isEmpty(); - - /** - * @return true if element model is ANY. - */ - public boolean isAny(); - - /** - * @return the element's content model. The content model will be empty - * if <code>isText()</code>, <code>isAny()</code> or <code>isEmpty()</code>. - * Note that the content model deals with child elements only; use - * <code>isMixed()</code> to see if text is also allowed. - */ - public IModel getContentModel(); - - /** - * @return the DFM corresponding to the content model. Every element - * has a DFM. - */ - public IDfm getDfm(); - - /** - * @return Map with attribute qname keys and IAttr values. - * If element has no attributes, the map is empty. - * Map must not be modified by caller; for performance reasons, - * it is not a copy. - */ - public Map getAttributes(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IModel.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IModel.java deleted file mode 100644 index 7814a6b26..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/IModel.java +++ /dev/null @@ -1,78 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -import org.eclipse.ui.externaltools.internal.ant.dtd.schema.Nfm; - - -/** - * Content model. - * This is the printable version of the model. - * The walkable version is the IDfm. - * @author Bob Foster - */ -public interface IModel { - - public static final int UNKNOWN = 0; - public static final int SEQUENCE = 1; - public static final int CHOICE = 2; - public static final int LEAF = 4; - - public static final int UNBOUNDED = Integer.MAX_VALUE; - - /** - * @return one of SEQUENCE, CHOICE, LEAF - */ - public int getKind(); - - /** - * @return one of 0 or 1. - */ - public int getMinOccurs(); - - /** - * @return one of 1 or UNBOUNDED. - */ - public int getMaxOccurs(); - - /** - * @return if SEQUENCE or CHOICE return array of sub-models; otherwise - * undefined. - */ - public IModel[] getContents(); - - /** - * @return if LEAF return atom; otherwise undefined. - */ - public IAtom getLeaf(); - - /** - * @return if SEQUENCE or CHOICE return "," and "|", respectively; otherwise - * undefined. Useful when printing model. - */ - public String getOperator(); - - /** - * @return one of "", "?", "*" or "+". Useful when printing model. - */ - public String getQualifier(); - - /** - * Convert content model to string representation. - */ - public String stringRep(); - - /** - * Convert the model to an Nfm on demand. - * @return Nfm - */ - public Nfm toNfm(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/ISchema.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/ISchema.java deleted file mode 100644 index b093605a6..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/ISchema.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -public interface ISchema { - - /** - * Find element by name. - * @param qname Element name. - * @return element or null if no such element. - */ - IElement getElement(String qname); - - /** - * @return IElement[] of all visible elements. - */ - IElement[] getElements(); - - /** - * @return Exception thrown by parser when schema was built or <code>null</code> if none. - * Note that the exception does not necessarily mean the schema is - * incomplete. - */ - Exception getErrorException(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/ParseError.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/ParseError.java deleted file mode 100644 index ad3bdcada..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/ParseError.java +++ /dev/null @@ -1,25 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -/** - * @author Bob Foster - */ -public class ParseError extends Exception { - - /** - * Constructor for ParseError. - * @param msg Message - */ - public ParseError(String msg) { - super(msg); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/Parser.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/Parser.java deleted file mode 100644 index 2b495f686..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/Parser.java +++ /dev/null @@ -1,185 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd; - -import java.io.IOException; -import java.io.Reader; -import java.io.StringReader; - -import org.apache.xerces.parsers.SAXParser; -import org.eclipse.ui.externaltools.internal.ant.dtd.schema.SchemaFactory; -import org.xml.sax.EntityResolver; -import org.xml.sax.InputSource; -import org.xml.sax.SAXException; -import org.xml.sax.SAXNotRecognizedException; -import org.xml.sax.SAXNotSupportedException; -import org.xml.sax.XMLReader; -import org.xml.sax.ext.DeclHandler; - -/** - * Simple parser for DTDs. Returns ISchema representing the DTD. - * - * To parse a DTD, you must parse an XML document. The <code>parseDTD()</code> - * method builds a temporary XML document in memory that refers to or includes - * the DTD. - * - * There is no dependency in this package on any code outside the package except - * XMLReader. - * - * To hide the underlying parser, XML parser exceptions are wrapped by a - * ParseError. Unless debugging, the two string constants are sufficient to - * determine the cause of the error. - * @author Bob Foster - */ -public class Parser { - - /** ParseError message when system parser doesn't do the job */ - public static final String NOT_SUPPORTED = AntDTDMessages.getString("Parser.XML_parser_does_not_support_DeclHandler_1"); //$NON-NLS-1$ - /** ParseError message for a well-formed or validation error in XML or DTD. - * Currently not returned. */ - public static final String PARSE_ERROR = AntDTDMessages.getString("Parser.Error_parsing_XML_document_or_DTD_2"); //$NON-NLS-1$ - - private static final String INTERNAL = "internal://usereader.objfac.com"; //$NON-NLS-1$ - - /** - * Parse the XML document at the input source and return a document walker - * that can be used to validate any document with the same DTD (internal and - * external) or provide user assistance for this document. - * @param inputSource Source for XML document to start DTD parse. Must - * contain a DOCTYPE declaration with internal or external subset, or both. - * @param entityResolver EntityResolver or null. - * @return schema for document. - * @throws ParseError for NOT_SUPPORTED or PARSE_ERROR. - * @throws IOException - */ - public ISchema parse(InputSource inputSource, EntityResolver entityResolver) throws ParseError, IOException { - XMLReader parser = null; - SchemaFactory factory = new SchemaFactory(); - try { - parser = new SAXParser(); - DeclHandler handler = factory; - parser.setProperty("http://xml.org/sax/properties/declaration-handler", //$NON-NLS-1$ - handler); - if (entityResolver != null) - parser.setEntityResolver(entityResolver); - parser.parse(inputSource); - } catch (SAXNotRecognizedException e) { - throw new ParseError(NOT_SUPPORTED); - } catch (SAXNotSupportedException e) { - throw new ParseError(NOT_SUPPORTED); - } catch (SAXException e) { - // Don't care about errors in XML, so just fall thru. - // If parse failed in DTD, may have incomplete schema, - // but this is better than no schema. - factory.setErrorException(e); - } - - return factory.getSchema(); - } - - /** - * Parse the XML document at the argument URL and return a document walker - * that can be used to validate any document with the same DTD (internal - * and external) or provide user assistance for this document. - * @param url Of XML document to start DTD parse. Must contain a DOCTYPE - * declaration with internal or external subset, or both. - * @return IWalker that can be used to traverse document. - * @throws ParseError for NOT_SUPPORTED or PARSE_ERROR. - * @throws IOException - */ - public ISchema parse(String url) throws ParseError, IOException { - return parse(new InputSource(url), null); - } - - /** - * Parse the XML document using the argument reader and return a document - * walker that can be used to validate any document with the same DTD - * (internal and external) or provide user assistance for this document. - * @param reader Reader for XML document to start DTD parse. Must contain a - * DOCTYPE declaration with internal or external subset, or both. - * @return IWalker that can be used to traverse document. - * @throws ParseError for NOT_SUPPORTED or PARSE_ERROR. - * @throws IOException - */ - public ISchema parse(Reader reader) throws ParseError, IOException { - return parse(new InputSource(reader), null); - } - - /** - * Parse the DTD with the given public and system ids and return a document - * walker that can be used to validate or provide user assistance for any - * document with the same external DTD and no internal subset. - * @param pub PUBLIC id of DTD. - * @param sys SYSTEM id of DTD. - * @param root Plausible root element qname. Any name will do but a - * name that will not cause a validation error is preferred. - * @return IWalker that can be used to traverse document. - * @throws ParseError for NOT_SUPPORTED or PARSE_ERROR. - * @throws IOException - */ - public ISchema parseDTD(String pub, String sys, String root) throws ParseError, IOException { - return parse(new InputSource(new DTDReader(pub, sys, root)), null); - } - - /** - * Parse the DTD from the reader and return a document walker that can be - * used to validate or provide user assistance for any document with the - * same external DTD and no internal subset. - * @param reader Reader for external subset DTD - * @param root Plausible root element qname. Any name will do but a - * name that will not cause a validation error is preferred. - * @return IWalker that can be used to traverse document. - * @throws ParseError for NOT_SUPPORTED or PARSE_ERROR. - * @throws IOException - */ - public ISchema parseDTD(Reader reader, String root) throws ParseError, IOException { - return parse(new InputSource(new DTDReader(INTERNAL, INTERNAL, root)), new DTDEntityResolver(reader)); - } - - private static class DTDReader extends Reader { - private Reader fDelegate; - - public DTDReader(String pub, String sys, String root) { - String document = "<!DOCTYPE "+root+" PUBLIC '"+pub+"' '"+sys+"'><"+root+"/>"; //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ //$NON-NLS-5$ - fDelegate = new StringReader(document); - } - - /** - * @see java.io.Reader#close() - */ - public void close() throws IOException { - fDelegate.close(); - } - - /** - * @see java.io.Reader#read(char, int, int) - */ - public int read(char[] cbuf, int off, int len) throws IOException { - return fDelegate.read(cbuf, off, len); - } - } - - private static class DTDEntityResolver implements EntityResolver { - private Reader reader; - public DTDEntityResolver(Reader reader) { - this.reader = reader; - } - /** - * @see org.xml.sax.EntityResolver#resolveEntity(java.lang.String, java.lang.String) - */ - public InputSource resolveEntity(String publicId, String systemId) throws SAXException, IOException { - if (publicId.equals(INTERNAL) && systemId.equals(INTERNAL)) - return new InputSource(reader); - return null; - } - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/AntDTDSchemaMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/AntDTDSchemaMessages.java deleted file mode 100644 index d76a3a4e0..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/AntDTDSchemaMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntDTDSchemaMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.dtd.schema.AntDTDSchemaMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntDTDSchemaMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/AntDTDSchemaMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/AntDTDSchemaMessages.properties deleted file mode 100644 index 2d0c0b7c0..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/AntDTDSchemaMessages.properties +++ /dev/null @@ -1,18 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -Model.model_may_not_be_changed=model may not be changed once its contents have been requested -Model.***UNKNOWN***_2=<UNKNOWN> -NfmParser.Ambiguous=Ambiguous content model starting with {0} -SchemaFactory.Doubly_defined=Element {0} is doubly defined -SchemaFactory.Start_with_left_parenthesis=Element {0} model does not start with left parenthesis -SchemaFactory.Expecting_operator_or_right_parenthesis=Expecting operator or right parenthesis in element {0} model {1} -SchemaFactory.Unexpected_end=Unexpected end of content model for element {0}: {1} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Atom.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Atom.java deleted file mode 100644 index c33aa5f19..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Atom.java +++ /dev/null @@ -1,36 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAtom; - -/** - * Atom contains information common to elements and attributes. - * @author Bob Foster - */ -public class Atom implements IAtom { - - protected String fName; - protected int fKind; - - protected Atom(int kind, String name) { - fKind = kind; - fName = name.intern(); - } - - public String getName() { - return fName; - } - - public String toString() { - return fName; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Attribute.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Attribute.java deleted file mode 100644 index 83c450aac..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Attribute.java +++ /dev/null @@ -1,114 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import org.eclipse.ui.externaltools.internal.ant.dtd.*; - -/** - * Attr contains information about a single attribute. - * @author Bob Foster - */ -public class Attribute extends Atom implements IAttribute { - private String fType; - private String[] fEnum; - private IElement fElement; - private String fDefault; - private boolean fFixed; - private boolean fRequired; - - /** - * Constructor. - * @param name Attribute qname. - * @param element Parent element. - */ - public Attribute(String name, IElement element) { - super(ATTRIBUTE, name); - fElement = element; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IAorg.eclipse.ui.externaltools.internal.ant.dtdpe() - */ - public String getType() { - return fType; - } - - /** - * @see org.eclipse.ui.exteorg.eclipse.ui.externaltools.internal.ant.dtdrnal.ant.dtd.IAttribute#getEnum() - */ - public String[] getEnum() { - return fEnum; - } - - /** - * @sorg.eclipse.ui.externaltools.internal.ant.dtd.ui.externaltools.internal.ant.dtd.IAttribute#getElement() - */ - public IElement getElement() { - return fElement; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IAttribute#getDefault() - */ - public String getDefault() { - return fDefault; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IAttribute#isFixed() - */ - public boolean isFixed() { - return fFixed; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IAttribute#isRequired() - */ - public boolean isRequired() { - return fRequired; - } - - public void setType(String type) { - fType = type; - } - /** - * Sets the default value. - * @param defaultValue Value - */ - public void setDefault(String defaultValue) { - fDefault = defaultValue; - } - - /** - * Sets the enum. - * @param enum The enum to set - */ - public void setEnum(String[] enum) { - fEnum = enum; - } - - /** - * Sets the fixed. - * @param fixed The fixed to set - */ - public void setFixed(boolean fixed) { - fFixed = fixed; - } - - /** - * Sets the required. - * @param required The required to set - */ - public void setRequired(boolean required) { - fRequired = required; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Dfm.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Dfm.java deleted file mode 100644 index 5b468f397..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Dfm.java +++ /dev/null @@ -1,169 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAtom; -import org.eclipse.ui.externaltools.internal.ant.dtd.IDfm; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.Factory; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.FactoryObject; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.MapHolder; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.SortedMap; - - -/** - * Deterministic finite state machine. - * Once constructed DFM is immutable and can be used by multiple threads. - * A Dfm node is essentially an accepting flag and a hashtable mapping atoms to - * Dfm nodes. (Almost of com. objfac. dtd. util is aimed at reducing the storage - * overhead of hundreds of little hashtables.) - * @author Bob Foster - */ -public class Dfm extends MapHolder implements IDfm, FactoryObject { - - public boolean accepting; - public boolean empty, any; - public int id; - private static int unique = 0; - private static Factory factory = new Factory(); - private Dfm fNext; - - public static Dfm dfm(boolean accepting) { - Dfm dfm = free(); - dfm.accepting = accepting; - return dfm; - } - - protected Dfm() { - } - - private static Dfm free() { - Dfm dfm = (Dfm) factory.getFree(); - if (dfm == null) - dfm = new Dfm(); - dfm.accepting = dfm.empty = dfm.any = false; - dfm.id = unique++; - return dfm; - } - - public static Dfm dfm(IAtom accept, Dfm follow) { - Dfm dfm = free(); - dfm.keys = new Object[1]; - dfm.keys[0] = accept; - dfm.values = new Object[1]; - dfm.values[0] = follow; - return dfm; - } - - public static void free(Dfm dfm) { - dfm.setKeys(null); - dfm.setValues(null); - factory.setFree(dfm); - } - - public boolean isAccepting() { - return accepting; - } - - public IDfm advance(String name) { - if (any) - return this; - if (empty) - return null; - if (keys == null) - return null; - SortedMap map = getIndirectStringMap(this); - Dfm dfm = (Dfm) map.get(name); - freeMap(map); - return dfm; - } - - public String[] getAccepts() { - if (keys == null) - return new String[0]; - String[] s = new String[keys.length]; - for (int i = 0; i < s.length; i++) { - s[i] = keys[i].toString(); - } - return s; - } - - public Dfm[] getFollows() { - if (values == null) - return new Dfm[0]; - Dfm[] s = new Dfm[values.length]; - System.arraycopy(values,0,s,0,values.length); - return s; - } - - public void merge(Dfm other) { - accepting |= other.accepting; - SortedMap map = getIndirectStringMap(this); - SortedMap othermap = getIndirectStringMap(other); - map.merge(othermap); - freeMap(map); - freeMap(othermap); - } - - public SortedMap getMap() { - return getIndirectStringMap(this); - } - - /** - * @see com.objfac.util.FactoryObject#next() - */ - public FactoryObject next() { - return fNext; - } - - /** - * @see com.objfac.util.FactoryObject#next(FactoryObject) - */ - public void next(FactoryObject obj) { - fNext = (Dfm) obj; - } - - /** - * @see com.objfac.xml.schema.IDfm#isAny() - */ - public boolean isAny() { - return any; - } - - /** - * @see com.objfac.xml.schema.IDfm#isEmpty() - */ - public boolean isEmpty() { - return empty; - } - - /** - * @see com.objfac.xml.schema.IDfm#getAtom(String) - */ - public IAtom getAtom(String name) { - Object[] keys = getKeys(); - if (empty || keys == null) - return null; - SortedMap map = getIndirectStringMap(this); - int index = map.keyIndex(name); - if (index < 0) - return null; - return (IAtom) keys[index]; - } - - /** - * @see com.objfac.xml.schema.IDfm#advance(java.lang.String, java.lang.String) - */ - public IDfm advance(String namespace, String localname) { - // no namespace support here - return advance(localname); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Element.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Element.java deleted file mode 100644 index b12d096f0..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Element.java +++ /dev/null @@ -1,192 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import java.util.HashMap; -import java.util.Map; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAttribute; -import org.eclipse.ui.externaltools.internal.ant.dtd.IDfm; -import org.eclipse.ui.externaltools.internal.ant.dtd.IElement; -import org.eclipse.ui.externaltools.internal.ant.dtd.IModel; -import org.eclipse.ui.externaltools.internal.ant.dtd.ParseError; - -public class Element extends Atom implements IElement { - private boolean fUndefined = true; - private boolean fText; - private boolean fMixed; - private IModel fModel; - private HashMap fMap = new HashMap(4); - private Dfm fElementDfm; - - /** - * Constructor - * @param name QName of element. - */ - public Element(String name) { - super(ELEMENT, name); - } - - /** - * Set undefined property. - * @param undefined False if defined; otherwise true (default). - */ - public void setUndefined(boolean undefined) { - fUndefined = undefined; - } - - /** - * Set text property. - * @param text True if text only; otherwise false (default). - */ - public void setText(boolean text) { - fText = text; - } - - /** - * Set mixed property. - * @param mixed True if text plus element content allowed; otherwise false - * (default). - */ - public void setMixed(boolean mixed) { - fMixed = mixed; - } - - /** - * Set model property. - * @param model Dfm describing content model. - */ - public void setContentModel(IModel model) { - fModel = model; - } - - /** - * Add an attribute to the attribute map. - * @param attribute Attribute to add. - */ - public void addAttribute(IAttribute attribute) { - fMap.put(attribute.getName(), attribute); - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#getAttributes() - */ - public Map getAttributes() { - return fMap; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#getContorg.eclipse.ui.externaltools.internal.ant.dtd*/ - public IModel getContentModel() { - return fModel; - } - - /** - * @see org.eclipse.ui.eorg.eclipse.ui.externaltools.internal.ant.dtdnternal.ant.dtd.IElement#isMixed() - */ - public boolean isMixed() { - return fMixed; - } - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#isText() - */ - public boolean isText() { - return fText; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#isUndefined() - */ - public boolean isUndefined() { - return fUndefined; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#getDfm() - */ - public IDfm getDfm() { - Dfm dfm = fElementDfm; - if (dfm == null) { - dfm = parseElementDfm(); - fElementDfm = dfm; - } - return dfm; - } - - private Dfm parseElementDfm() { - Dfm dfm; - if (fAny) { - dfm = Dfm.dfm(true); - dfm.any = true; - } - else if (fEmpty || fText) { - dfm = Dfm.dfm(true); - dfm.empty = true; - } - else { - dfm = parseModel(fModel); - } - return dfm; - } - - private Dfm parseModel(IModel model) { - Dfm dfm; - Nfm nfm = model.toNfm(); - if (nfm != null) { - try { - dfm = fNfmParser.parse(nfm, true); - } catch (ParseError e) { - //??? this would be the place to log the error - dfm = Dfm.dfm(false); - } - } - else { - dfm = Dfm.dfm(false); - } - return dfm; - } - - private static final NfmParser fNfmParser = new NfmParser(); - private boolean fAny; - private boolean fEmpty; - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#isAny() - */ - public boolean isAny() { - return fAny; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IElement#isEmpty() - */ - public boolean isEmpty() { - return fEmpty; - } - - /** - * Sets the any. - * @param any The any to set - */ - public void setAny(boolean any) { - fAny = any; - } - - /** - * Sets the empty. - * @param empty The empty to set - */ - public void setEmpty(boolean empty) { - fEmpty = empty; - } - -} - diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Model.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Model.java deleted file mode 100644 index 9fea6360f..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Model.java +++ /dev/null @@ -1,248 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; -import java.util.Iterator; -import java.util.LinkedList; -import java.util.List; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAtom; -import org.eclipse.ui.externaltools.internal.ant.dtd.IModel; - -/** - * IModel implementation. - * @author Bob Foster - */ -public class Model implements IModel { - - protected int fKind; - protected int fMin = 1; - protected int fMax = 1; - protected int fNum = 0; - protected IModel[] fContents; - protected List fContentsList; - protected IAtom fLeaf; - protected boolean fMixed; - - protected static IModel[] fEmptyContents = new IModel[0]; - - public Model(int kind) { - fKind = kind; - } - - public Model() { - fKind = UNKNOWN; - } - - public void setKind(int kind) { - fKind = kind; - } - - public void setMinOccurs(int min) { - fMin = min; - } - - public void setMaxOccurs(int max) { - fMax = max; - } - - public void setContents(IModel[] contents) { - fContents = contents; - } - - public void addModel(IModel model) { - if (fContents != null) - throw new IllegalStateException(AntDTDSchemaMessages.getString("Model.model_may_not_be_changed")); //$NON-NLS-1$ - - if (fContentsList == null) - fContentsList = new LinkedList(); - - fContentsList.add(model); - } - - public void setLeaf(IAtom leaf) { - fLeaf = leaf; - } - - protected static final String[] fOps = {"?",",","|","&","!!!"}; //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ //$NON-NLS-5$ - - private Nfm qualifyNfm(Nfm nfm) { - if (nfm == null) - return null; - if (fMin == 1 && fMax == 1) - return nfm; - if (fMin == 0 && fMax == 1) { - return Nfm.getQuestion(nfm); - } - if (fMin == 0 && fMax == UNBOUNDED) { - return Nfm.getStar(nfm); - } - if (fMin == 1 && fMax == UNBOUNDED) { - return Nfm.getPlus(nfm); - } - //the following cases cannot be reached by DTD models - if (fMax == 0) - return Nfm.getNfm(null); - if (fMax == UNBOUNDED) { - return Nfm.getUnbounded(nfm, fMin); - } - else { - return Nfm.getMinMax(nfm, fMin, fMax); - } - } - - public Model shallowCopy() { - Model copy = new Model(getKind()); - copy.fMixed = fMixed; - copy.fLeaf = fLeaf; - if (fContents != null) { - copy.fContentsList = new LinkedList(); - for (int i = 0; i < fContents.length; i++) { - copy.fContentsList.add(fContents[i]); - } - } - else if (fContentsList != null) { - copy.fContentsList = new LinkedList(); - Iterator it = fContentsList.iterator(); - while (it.hasNext()) { - copy.fContentsList.add(it.next()); - } - } - return copy; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getKind() - */ - public int getKind() { - return 0; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getMinOccurs() - */ - public int getMinOccurs() { - return fMin; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getMaxOccurs() - */ - public int getMaxOccurs() { - return fMax; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getContents() - */ - public IModel[] getContents() { - // A model contents may be referred to many times - // it would be inefficient to convert to array each time - if (fContents == null) { - if (fContentsList != null) { - fContents = (IModel[]) fContentsList.toArray(new IModel[fContentsList.size()]); - fContentsList = null; - } - else - fContents = fEmptyContents; - } - return fContents; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getLeaf() - */ - public IAtom getLeaf() { - return fLeaf; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getOperator() - */ - public String getOperator() { - return fOps[fKind]; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.schema.IModel#stringRep() - */ - public String stringRep() { - StringBuffer buf = new StringBuffer(); - stringRep(buf); - return buf.toString(); - } - - private void stringRep(StringBuffer buf) { - switch (getKind()) { - case IModel.CHOICE: - case IModel.SEQUENCE: - buf.append('('); - Iterator it = fContentsList.iterator(); - while (it.hasNext()) { - Model model = (Model) it.next(); - model.stringRep(buf); - if (it.hasNext()) - buf.append(getOperator()); - } - buf.append(')'); - buf.append(getQualifier()); - break; - case IModel.LEAF: - IAtom atom = getLeaf(); - buf.append(atom.getName()); - break; - default: - buf.append(AntDTDSchemaMessages.getString("Model.***UNKNOWN***_2")); //$NON-NLS-1$ - break; - } - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#getQualifier() - */ - public String getQualifier() { - return fMin == 1 ? (fMax == UNBOUNDED ? "+" : "") : (fMax == UNBOUNDED ? "*" : "?"); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.IModel#toNfm() - */ - public Nfm toNfm() { - Nfm nfm = null; - switch (fKind) { - case CHOICE: - case SEQUENCE: - { - IModel[] contents = getContents(); - if (contents == null || contents.length == 0) - nfm = null; - else { - nfm = contents[0].toNfm(); - for (int i = 1; i < contents.length; i++) { - Nfm tmp = contents[i].toNfm(); - if (fKind == SEQUENCE) { - nfm = Nfm.getComma(nfm, tmp); - } else { - nfm = Nfm.getOr(nfm, tmp); - } - } - } - break; - } - case LEAF: - { - nfm = Nfm.getNfm(fLeaf); - break; - } - } - return qualifyNfm(nfm); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Nfm.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Nfm.java deleted file mode 100644 index e11ad3f0f..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Nfm.java +++ /dev/null @@ -1,289 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAtom; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.Factory; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.FactoryObject; - - -/** - * Non-deterministic finite state machine. - * @author Bob Foster - */ -public class Nfm implements FactoryObject { - private NfmNode start; - private NfmNode stop; - - public NfmNode getStart() { - return start; - } - - public NfmNode getStop() { - return stop; - } - - /** - * Construct an nfm such that: - * <pre> - * start stop - * | | - * +---+ +---+ - * | s |->| | - * +---+ +---+ - * </pre> - * In all pictures, boxes are NfmNodes. - */ - private static Nfm nfm(IAtom s) { - Nfm nfm = free(); - nfm.stop = NfmNode.nfmNode(); - nfm.start = NfmNode.nfmNode(s, nfm.stop); - return nfm; - } - - /** - * Construct an nfm that "wraps" an existing nfm x such that: - * <pre> - * start stop - * | | - * +---+ +---------+ +---------+ +---+ - * | |->| x start | | x stop |->| | - * +---+ +---------+ +---------+ +---+ - * </pre> - */ - private static Nfm nfm(Nfm x) { - Nfm nfm = free(); - nfm.start = NfmNode.nfmNode(x.start); - nfm.stop = NfmNode.nfmNode(); - x.stop.next1 = nfm.stop; - return nfm; - } - - private static Nfm nfm() { - Nfm nfm = free(); - nfm.start = NfmNode.nfmNode(); - nfm.stop = NfmNode.nfmNode(); - return nfm; - } - - public static Nfm getNfm(IAtom s) { - return nfm(s); - } - - /** - * "Star" an existing nfm x. - * <pre> - * start stop - * | | - * +---+ +---------+ +---------+ +---+ - * | |->| x start | | x stop |->| | - * +---+ +---------+ +---------+ +---+ - * | | | | - * | +-----<------+ | - * +------>-------------------------+ - * </pre> - * Frees x. - */ - public static Nfm getStar(Nfm x) { - // Make the back link - x.stop.next2 = x.start; - Nfm tmp = nfm(x); - // Make the forward link - tmp.start.next2 = tmp.stop; - free(x); - return tmp; - } - - /** - * "Question" an existing nfm x: x => x? - * <pre> - * start stop - * | | - * +---+ +---------+ +---------+ +---+ - * | |->| x start | | x stop |->| | - * +---+ +---------+ +---------+ +---+ - * | | - * +---------------->---------------+ - * </pre> - * Frees x. - */ - public static Nfm getQuestion(Nfm x) { - Nfm tmp = nfm(x); - // Make the forward link - tmp.start.next2 = tmp.stop; - free(x); - return tmp; - } - - /** - * "Plus" an existing nfm x -> x+ - * <pre> - * start stop - * | | - * +---+ +---------+ +---------+ +---+ - * | |->| x start | | x stop |->| | - * +---+ +---------+ +---------+ +---+ - * | | - * +-----<------+ - * </pre> - * Frees x. - */ - public static Nfm getPlus(Nfm x) { - // Make the back link - x.stop.next2 = x.start; - Nfm tmp = nfm(x); - free(x); - return tmp; - } - - /** - * "Or" two existing nfms x,y -> x|y - * <pre> - * start stop - * | | - * +---+ +---------+ +---------+ +---+ - * | |->| x start | | x stop |->| | - * +---+ +---------+ +---------+ +---+ - * | | - * | +---------+ +---------+ | - * +--->| y start | | y stop |-->-+ - * +---------+ +---------+ - * </pre> - * Frees x and y. - */ - public static Nfm getOr(Nfm x, Nfm y) { - Nfm tmp = nfm(); - tmp.start.next1 = x.start; - tmp.start.next2 = y.start; - x.stop.next1 = tmp.stop; - y.stop.next1 = tmp.stop; - free(x); - free(y); - return tmp; - } - - /** - * "Comma" two existing nfms x,y -> x,y - * - * <p>Re-uses x so that x.stop is first - * transformed to y.start and then - * x.stop is reset to y.stop. - * This is as efficient as possible. - * <pre> - * x start former x stop x stop - * | | | - * +---------+ +----------+ +--------+ - * | x start | | y start |->| y stop | - * +---------+ +----------+ +--------+ - * </pre> - * Frees y, returns x modified. - */ - public static Nfm getComma(Nfm x, Nfm y) { - x.stop.next1 = y.start.next1; - x.stop.next2 = y.start.next2; - x.stop.symbol = y.start.symbol; - x.stop = y.stop; - free(y); - return x; - } - - /** - * "{min,*}" an existing nfm x -> x[0],x[1],...,x[min-1],x[min]* - * Frees x. - */ - public static Nfm getUnbounded(Nfm x, int min) { - if (min == 0) - return getStar(x); - if (min == 1) - return getPlus(x); - Nfm last1 = nfm(x), last2 = nfm(x); - for (int i = 2; i < min; i++) { - last1 = getComma(last1, last2); - free(last2); - last2 = nfm(x); - } - free(x); - return getComma(last1, getStar(last2)); - } - - /** - * "{min,max}" an existing nfm x -> x[0],x[1],...,x[min-1],x[min]?,...,x[max-1]? - * Frees or returns x. - */ - public static Nfm getMinMax(Nfm x, int min, int max) { - if (max == Integer.MAX_VALUE) - return getUnbounded(x, min); - if (max == 0) { - free(x); - return nfm((IAtom)null); - } - if (max == 1) { - if (min == 0) - return getQuestion(x); - return x; - } - Nfm last = null; - int i = 0; - for (; i < min; i++) { - if (last == null) - last = nfm(x); - else { - Nfm tmp = nfm(x); - last = getComma(last, tmp); - free(tmp); - } - } - for (; i < max; i++) { - if (last == null) - last = getQuestion(x); - else { - Nfm tmp = getQuestion(x); - last = getComma(last, tmp); - free(tmp); - //??? this is inefficient since the first failure - // in a sequence of x?,x?,...,x? can skip to - // the end rather than keep trying to match x - } - } - free(x); - return last; - } - - // Below here is factory stuff - - /** - * @see com.objfac.util.FactoryObject#next() - */ - public FactoryObject next() { - return fNext; - } - - /** - * @see com.objfac.util.FactoryObject#next(FactoryObject) - */ - public void next(FactoryObject obj) { - fNext = (Nfm) obj; - } - private Nfm fNext; - private static Factory fFactory = new Factory(); - private static Nfm free() { - Nfm nfm = (Nfm) fFactory.getFree(); - if (nfm == null) - return new Nfm(); - return nfm; - } - public static void free(Nfm nfm) { - nfm.start = nfm.stop = null; - fFactory.setFree(nfm); - } - private Nfm() { - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/NfmNode.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/NfmNode.java deleted file mode 100644 index 2eca27213..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/NfmNode.java +++ /dev/null @@ -1,113 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAtom; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.Factory; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.FactoryObject; - -/** - * Non-deterministic finite state machine node.<p> - * - * Following Aho & Ullman, nfm nodes contain two - * transition links. The graph is constructed so - * that no node requires more than two links. - * There are exactly these kinds of nodes: - * <pre> - * Symbol Next1 Next2 Meaning - * "a" fwd null Regexp "a" - * null null null Accepting node - * null fwd1 fwd2 Start node of ? and * regexp - * fwd2 points to stop node - * null fwd bkw Internal node of + and * regexp - * fwd points to stop node - * bkw points, e.g., in "a*" to start node of "a" - * null fwd1 fwd2 Start node of | regexp, e.g., "a|b", - * fwd nodes point to start nodes of "a" and "b". - * null fwd null Internal node of |. - * fwd points to stop node. - * </pre> - * See Nfm for pictures of how nodes are used. - * @author Bob Foster - */ -public class NfmNode implements FactoryObject { - - public IAtom symbol; - public NfmNode next1; - public NfmNode next2; - public Dfm dfm; - public int mark; - - private NfmNode() { - } - - public static NfmNode nfmNode(IAtom symbol, NfmNode next) { - NfmNode nfm = getFree(); - nfm.symbol = symbol; - nfm.next1 = next; - return nfm; - } - - public static NfmNode nfmNode(NfmNode next) { - NfmNode nfm = getFree(); - nfm.next1 = next; - return nfm; - } - - public static NfmNode nfmNode() { - return getFree(); - } - - /** - * Free all NfmNodes in use. - */ - public static void freeAll() { - while (fUsed != null) { - FactoryObject nfm = fUsed; - fUsed = nfm.next(); - setFree((NfmNode)nfm); - } - } - - // Below here is factory stuff - - /** - * @see com.objfac.util.FactoryObject#next() - */ - public FactoryObject next() { - return next; - } - - /** - * @see com.objfac.util.FactoryObject#next(FactoryObject) - */ - public void next(FactoryObject obj) { - next = (NfmNode) obj; - } - private NfmNode next; - private static Factory fFactory = new Factory(); - private static FactoryObject fUsed = null; - private static NfmNode getFree() { - NfmNode nfm = (NfmNode) fFactory.getFree(); - if (nfm == null) - nfm = new NfmNode(); - nfm.next(fUsed); - fUsed = nfm; - return nfm; - } - private static void setFree(NfmNode nfm) { - nfm.symbol = null; - nfm.next1 = nfm.next2 = null; - nfm.dfm = null; - nfm.mark = 0; - fFactory.setFree(nfm); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/NfmParser.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/NfmParser.java deleted file mode 100644 index f1ad317f5..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/NfmParser.java +++ /dev/null @@ -1,356 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import java.text.MessageFormat; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IAtom; -import org.eclipse.ui.externaltools.internal.ant.dtd.ParseError; -import org.eclipse.ui.externaltools.internal.ant.dtd.util.SortedMap; - -/** - * NfmParser parses an NFA and returns an equivalent DFA if it can do so in - * linear time and space (in terms of the original NFA).<p> - * - * As used here, NfmParser is called lazily when someone actually asks for a - * Dfm. This is for performance reasons. Why go to the work of calculating all - * those Dfms if nobody ever uses them? - * - * Well-formed errors in content models have already been detected. The only - * error that can arise in NfmParser is an ambiguity error. - * - * Bruggemann-Klein showed that if an NFA is 1-unambiguous, an epsilon-free NFA - * constructed from it in linear time is actually a DFA. This is obvious - * in NfmParser. The algorithm works by removing all ambiguous transitions as - * the graph is constructed, then proving that the reduced graph is equivalent - * to the original in time linear in the number of ambiguous transitions. - * - * An effort is made to keep the DFA small, but there is no optimization - * step, as DFAs are small anyway, with some linear inflation around *. - * In a pathological case, like the classical (a*,a*,a*,..., a*) the number - * of transitions in the DFA can be quadratic but this algorithm will not blow - * up exponentially. - * - * @author Bob Foster - */ -public class NfmParser { - - public Dfm parse(Nfm nfm, boolean optimize) throws ParseError { - - // Parse nfm into dfm - - Dfm dfm = parseStart(nfm.getStart(), nfm.getStop()); - - // Make list of dfms in graph - - ArrayList dfms = new ArrayList(); - collect(dfm, dfms); - - // Detect accept conflicts - - HashMap duplicates = new HashMap(); - detect(dfms, duplicates); - - // Replace duplicate dfms in graph - - replace(dfms, duplicates); - - // Allow nfm memory to be re-used - - Nfm.free(nfm); - NfmNode.freeAll(); - - return dfm; - } - - private void reportError(String name) throws ParseError { - throw new ParseError(MessageFormat.format(AntDTDSchemaMessages.getString("NfmParser.Ambiguous"), new String[]{name})); //$NON-NLS-1$ - } - - public static void collect(Dfm dfm, List dfms) { - dfms.add(dfm); - collect1(dfm, dfms); - } - - private static void collect1(Dfm dfm, List dfms) { - Object[] follows = dfm.getValues(); - if (follows != null) { - for (int i = 0; i < follows.length; i++) { - Dfm follow = (Dfm) follows[i]; - if (!dfms.contains(follow)) { - dfms.add(follow); - collect1(follow, dfms); - } - } - } - } - - - /** - * Replace duplicate dfms found during conflict resolution. - */ - private void replace(ArrayList dfms, HashMap removed) { - for (int i = 0; i < dfms.size(); i++) { - Dfm dfm = (Dfm) dfms.get(i); - Object[] follows = dfm.getValues(); - if (follows != null) { - for (int j = 0; j < follows.length; j++) { - Dfm replacement, follow = (Dfm) follows[j]; - while ((replacement = (Dfm) removed.get(follow)) != null) - follow = replacement; - follows[j] = follow; - } - } - } - - // release dfms so can be re-used - Iterator rit = removed.keySet().iterator(); - while (rit.hasNext()) - Dfm.free((Dfm)rit.next()); - } - - - /** - * Detect conflicts in each state. Two transitions are a potential conflict - * if they accept the same string value. They are an actual conflict if - * their follow dfms are not identical and they are an actual ambiguity if - * the transition atoms of the follow dfms are not pairwise identical. - * This is derived from the rule of Bruggemann-Klein, which determines - * that (a|a)b is not ambiguous, but both (a,b)|(a,c) and (a,b)|(a,b) are. - * The latter might be surprising, but that's committee work for you. - * If two transitions are not ambiguous, one can be removed without - * affecting the language accepted, and thus we have converted our - * epsilon-free NFA into a DFA. If any two transitions are ambiguous, - * we report an error and our responsibility ends. Note that no transitions - * can be removed until all have been checked; this might disguise the - * ambiguity in, e.g., ((a|a),b,(a|a))*. - */ - private void detect(ArrayList dfms, HashMap duplicates) throws ParseError { - for (Iterator iter = dfms.iterator(); iter.hasNext();) { - Dfm dfm = (Dfm) iter.next(); - - Object[] accepts = dfm.getKeys(); - Object[] follows = dfm.getValues(); - if (accepts != null) { - String last = null; - for (int i = 0, lasti = -1; i < accepts.length; i++) { - String accept = accepts[i].toString(); - // accepts strings are interned allowing identity comparison - - if (last != null && last == accept) { - if (follows[i] != follows[lasti]) - checkConflict(new Conflict(accept, (Dfm)follows[lasti], (Dfm)follows[i])); - } - else { - last = accept; - lasti = i; - } - } - } - } - - // once more for removal - - for (Iterator iter = dfms.iterator(); iter.hasNext();) { - Dfm dfm = (Dfm) iter.next(); - - // record conflicts - Object[] accepts = dfm.getKeys(); - Object[] follows = dfm.getValues(); - boolean remove = false; - if (accepts != null) { - boolean[] removes = new boolean[accepts.length]; - String last = null; - for (int i = 0, lasti = -1; i < accepts.length; i++) { - String accept = accepts[i].toString(); - - if (last != null && last == accept) { - remove = true; - removes[i] = true; - if (follows[i] != follows[lasti]) { - Dfm dfmhi = (Dfm) follows[i]; - Dfm dfmlo = (Dfm) follows[lasti]; - if (dfmhi.id < dfmlo.id) { - Dfm tmp = dfmhi; - dfmhi = dfmlo; - dfmlo = tmp; - } - Dfm dup = (Dfm) duplicates.get(dfmhi); - if (dup == null || dfmlo.id < dup.id) { - duplicates.put(dfmhi, dfmlo); - } else { - duplicates.put(dfmlo, dup); - } - } - } - else { - last = accept; - lasti = i; - } - } - - if (remove) { - SortedMap map = dfm.getMap(); - int i = 0; - for (Iterator iterator = map.keyIterator(); iterator.hasNext(); i++) { - iterator.next(); - if (removes[i]) - iterator.remove(); - } - Dfm.freeMap(map); - } - } - } - } - - /** - * Check conflict and report ambiguity. - * @param conflict Potential ambiguity - */ - private void checkConflict(Conflict conflict) throws ParseError { - if (conflict.dfm1.accepting != conflict.dfm2.accepting) { - reportError(conflict.name); - } - Object[] accept1 = conflict.dfm1.getKeys(); - Object[] accept2 = conflict.dfm2.getKeys(); - if ((accept1 == null) != (accept2 == null)) { - reportError(conflict.name); - } - if (accept1 != null) { - if (accept1.length != accept2.length) { - reportError(conflict.name); - } - for (int j = 0; j < accept2.length; j++) { - if (accept1[j] != accept2[j]) { - reportError(conflict.name); - } - } - } - } - - /** - * Recursive parse that visits every node reachable from - * the start symbol. - */ - private Dfm parseStart(NfmNode start, NfmNode accept) { - // mark the start node - Dfm result = Dfm.dfm(false); - start.dfm = result; - - // we can minimize alias dfms by marking all starting transfer links - while (start.next1 != null && start.next2 == null && start.symbol == null) { - start = start.next1; - start.dfm = result; - } - - Dfm parsed = parse(1, start, accept); - result.merge(parsed); - - Dfm.free(parsed); - - return result; - } - - private void parseNext(int mark, Dfm result, NfmNode start, NfmNode accept) { - Dfm parsed = parse(mark+1, start, accept); - result.merge(parsed); - - Dfm.free(parsed); - } - - /** - * Recursive parse that visits every node reachable from - * the start symbol. - */ - private Dfm parse(int mark, NfmNode start, NfmNode accept) { - - // eliminate useless recursion (note that accept node has no branches) - while (start.next1 != null && start.next2 == null && start.symbol == null) - start = start.next1; - - // if we reached the accept node, return an empty dfm that accepts - if (start == accept) - return Dfm.dfm(true); - - // for a symbol, construct a dfm that accepts the symbol - if (start.symbol != null) { - Dfm nextdfm = null; - NfmNode next = start.next1, snext = next; - while (snext.dfm == null && snext.next1 != null && snext.next2 == null && snext.symbol == null) - snext = snext.next1; - if (snext.dfm != null) { - for (NfmNode n = next; n != snext; n = n.next1) - n.dfm = snext.dfm; - nextdfm = snext.dfm; - } - else { - nextdfm = Dfm.dfm(false); - snext.dfm = nextdfm; - for (NfmNode n = next; n != snext; n = n.next1) - n.dfm = nextdfm; - parseNext(mark, nextdfm, snext, accept); - } - Dfm dfm = Dfm.dfm((IAtom)start.symbol, nextdfm); - return dfm; - } - - // otherwise, follow both branches and return the combined result - Dfm dfm1 = null, dfm2 = null; - int saveMark; - if (start.next1 != null && start.next1.mark != mark) { - saveMark = start.next1.mark; - start.next1.mark = mark; - dfm1 = parse(mark, start.next1, accept); - start.next1.mark = saveMark; - } - if (start.next2 != null && start.next2.mark != mark) { - saveMark = start.next2.mark; - start.next2.mark = mark; - dfm2 = parse(mark, start.next2, accept); - start.next2.mark = saveMark; - } - - if (dfm2 != null) { - if (dfm1 != null) - dfm1.merge(dfm2); - else - dfm1 = dfm2; - } - return dfm1; - } - - private static class Conflict { - public String name; - public Dfm dfm1, dfm2; - public Conflict(String name, Dfm dfm1, Dfm dfm2) { - this.name = name; - this.dfm1 = dfm1; - this.dfm2 = dfm2; - } - public int hashCode() { - return dfm1.hashCode() + dfm2.hashCode(); - } - public boolean equals(Object o) { - if (o == this) - return true; - if (!(o instanceof Conflict)) - return false; - Conflict other = (Conflict) o; - return (dfm1 == other.dfm1 && dfm2 == other.dfm2) - || (dfm1 == other.dfm2 && dfm2 == other.dfm1); - } - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Schema.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Schema.java deleted file mode 100644 index 0def85e63..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/Schema.java +++ /dev/null @@ -1,67 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import java.util.HashMap; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IElement; -import org.eclipse.ui.externaltools.internal.ant.dtd.ISchema; - -/** - * This is a very simple schema suitable for DTDs. - * Once constructed, a schema is immutable and could be - * used by multiple threads. However, since in general - * the schema will reflect the internal DTD subset, - * re-use for multiple documents is problematic. - * @author Bob Foster - */ -public class Schema implements ISchema { - private HashMap fElementMap = new HashMap(); - private Exception fErrorException; - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.ISchema#getElement(java.lang.String) - */ - public IElement getElement(String qname) { - return (IElement) fElementMap.get(qname); - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.ISchema#getElements() - */ - public IElement[] getElements() { - return (IElement[]) fElementMap.entrySet().toArray(new IElement[fElementMap.entrySet().size()]); - } - - /** - * Add a visible element to the schema. - * @param element Element to add. - */ - public void addElement(IElement element) { - fElementMap.put(element.getName(), element); - } - - /** - * Sets the exception thrown by then parser when the schema was built. - * Note that the exception does not necessarily mean the schema is incomplete. - * - * @param fErrorException the Exception - */ - public void setErrorException(Exception e) { - fErrorException = e; - } - - /** - * @see org.eclipse.ui.externaltools.internal.ant.dtd.schema.ISchema#getErrorException() - */ - public Exception getErrorException() { - return fErrorException; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/SchemaFactory.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/SchemaFactory.java deleted file mode 100644 index 656de504a..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/schema/SchemaFactory.java +++ /dev/null @@ -1,288 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.schema; - -import java.text.MessageFormat; -import java.util.HashSet; -import java.util.LinkedList; - -import org.eclipse.ui.externaltools.internal.ant.dtd.IModel; -import org.eclipse.ui.externaltools.internal.ant.dtd.ISchema; -import org.xml.sax.SAXException; -import org.xml.sax.ext.DeclHandler; - -/** - * SchemaFactory is a SAX DeclHandler that converts DTD ELEMENT and ATTLIST - * declarations to schema form on the fly. The only two methods available to - * external users of SchemaFactory are its constructor and - * <code>getSchema()</code>. The latter returns the schema built by this process - * and should not be called until the XML parser to which this handler is - * attached has finished parsing. - * @author Bob Foster - */ -public class SchemaFactory implements DeclHandler { - // used for parsing models - private char[] fBuf; - private int fLen; - private int fPos; - private Element fElement; - - private Schema fSchema; - private static HashSet fTypes = new HashSet(); - private Exception fErrorException; - static { - fTypes.add("CDATA"); //$NON-NLS-1$ - fTypes.add("ID"); //$NON-NLS-1$ - fTypes.add("IDREF"); //$NON-NLS-1$ - fTypes.add("IDREFS"); //$NON-NLS-1$ - fTypes.add("NMTOKEN"); //$NON-NLS-1$ - fTypes.add("NMTOKENS"); //$NON-NLS-1$ - fTypes.add("ENTITY"); //$NON-NLS-1$ - fTypes.add("ENTITIES"); //$NON-NLS-1$ - } - - /** - * Constructor. - */ - public SchemaFactory() { - fSchema = new Schema(); - } - - /** - * @return ISchema produced from the DeclHandler. The schema is always - * correct, though it may be incomplete if the parse was interrupted due to - * validation or well-formed errors. - */ - public ISchema getSchema() { - fSchema.setErrorException(fErrorException); - return fSchema; - } - - /** - * @see org.xml.sax.ext.DeclHandler#attributeDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) - */ - public void attributeDecl(String eName, String aName, String type, String valueDefault, String value) throws SAXException { - Element element = getElement(eName); - Attribute attr = (Attribute) element.getAttributes().get(aName); - if (attr == null) { - attr = new Attribute(aName, element); - element.addAttribute(attr); - - String[] enum = null; - if (fTypes.contains(type)) - attr.setType(type); - else if (type.startsWith("NOTATION")) //$NON-NLS-1$ - enum = parseValues(type.substring("NOTATION".length()+1), ','); //$NON-NLS-1$ - else { - type = stripSurroundingParentheses(type); - enum = parseValues(type, '|'); - } - attr.setEnum(enum); - - attr.setRequired(valueDefault == null || !valueDefault.equals("#IMPLIED")); //$NON-NLS-1$ - attr.setFixed(valueDefault != null && valueDefault.equals("#FIXED")); //$NON-NLS-1$ - attr.setDefault(value); - } - } - - - /** - * Strips the surrounding parentheses from <code>aString</code>. - * <P> - * i.e.: (true|false) -> true|false - */ - private String stripSurroundingParentheses(String aString) { - if(aString.startsWith("(")) { //$NON-NLS-1$ - aString = aString.substring(1); - } - if(aString.endsWith(")")) { //$NON-NLS-1$ - aString = aString.substring(0, aString.length()-1); - } - return aString; - } - - - /** - * @param eName Element name - * @return Element from schema or new element. Either way - * the element is in the schema upon return. - */ - private Element getElement(String eName) { - Element element = (Element) fSchema.getElement(eName); - if (element == null) { - element = new Element(eName); - fSchema.addElement(element); - } - return element; - } - - private String[] parseValues(String type, char separator) { - int start = 0, pos, len = type.length(); - LinkedList values = new LinkedList(); - while (start < len) { - pos = type.indexOf(separator, start); - if (pos < 0) pos = len; - String term = type.substring(start, pos); - start = pos + 1; - values.add(term); - } - return (String[]) values.toArray(new String[values.size()]); - } - - /** - * @see org.xml.sax.ext.DeclHandler#elementDecl(java.lang.String, java.lang.String) - */ - public void elementDecl(String name, String model) throws SAXException { - Element element = getElement(name); - if (!element.isUndefined()) { - // if the element has already been defined, this is an error - throw new SAXException(MessageFormat.format(AntDTDSchemaMessages.getString("SchemaFactory.Doubly_defined"), new String[]{name})); //$NON-NLS-1$ - } - - fElement = element; - if (model.equals("ANY")) //$NON-NLS-1$ - element.setAny(true); - else if (model.equals("EMPTY")) //$NON-NLS-1$ - element.setEmpty(true); - else if (model.equals("(#PCDATA)")) //$NON-NLS-1$ - element.setText(true); - else if (model.startsWith("(#PCDATA")) //$NON-NLS-1$ - element.setMixed(true); - else - element.setContentModel(parseModel(model)); - } - - /** - * Convert model string to IModel. The <code>fElement</code> - * variable is an implicit argument to this method, and it - * sets <code>fBuf</code>, <code>fPos</code> and <code>fLen</code> for use - * by other parser methods. - * @param model String from DTD, with parameter entities replaced. - * @return IModel - * @throws SAXException if syntax error detected in model. This is a - * validation error. Since the DTD is usually not read unless the parser is - * validating, we may not ever be handed a bad content model, but we need to - * check them, just the same. - */ - private IModel parseModel(String model) throws SAXException { - fBuf = model.toCharArray(); - fLen = fBuf.length; - if (fBuf[0] != '(') { - throw new SAXException( - MessageFormat.format(AntDTDSchemaMessages.getString("SchemaFactory.Start_with_left_parenthesis"), new String[]{fElement.getName()})); //$NON-NLS-1$ - } - - IModel emodel; - boolean ortext = model.startsWith("(#PCDATA|"); //$NON-NLS-1$ - if (ortext) { - fPos = "(#PCDATA".length() + 1; //$NON-NLS-1$ - emodel = scanExpr(); - } - else { - fPos = 0; - emodel = scanExpr(); - } - return emodel; - } - - /** - * Scan a parenthesized expression starting - * from the left parenthesis or leftmost operator. - * @return IModel - */ - private IModel scanExpr() throws SAXException { - // skip opening ( or | - fPos++; - return scanExpr(scanElement()); - } - - /** - * Scan a parenthesized expression with the - * first term in hand. - * @param term The first operand in the expression, pre-scanned. - * @return IModel - * @throws SAXException if errors are detected in the model. - */ - private IModel scanExpr(IModel term) throws SAXException { - checkLen(); - if (fBuf[fPos] != ')') { - char op = fBuf[fPos]; - if (op != '|' && op != ',') { - throw new SAXException( - MessageFormat.format(AntDTDSchemaMessages.getString("SchemaFactory.Expecting_operator_or_right_parenthesis"), //$NON-NLS-1$ - new String[]{fElement.getName(),String.valueOf(fBuf)})); - } - Model model = new Model(op == '|' ? IModel.CHOICE : IModel.SEQUENCE); - model.addModel(term); - term = model; - - while (fBuf[fPos] == op) { - fPos++; - IModel next = scanElement(); - model.addModel(next); - } - if (fBuf[fPos] != ')') { - throw new SAXException( - MessageFormat.format(AntDTDSchemaMessages.getString("SchemaFactory.Expecting_operator_or_right_parenthesis"), //$NON-NLS-1$ - new String[]{fElement.getName(), String.valueOf(fBuf)})); - } - fPos++; - } - return term; - } - - /** - * Scan an element name or a parenthesized sub-expression. - * @return IModel - * @throws SAXException - */ - private IModel scanElement() throws SAXException { - checkLen(); - if (fBuf[fPos] == '(') - return scanExpr(); - StringBuffer sb = new StringBuffer(); - while (fBuf[fPos] != '|' && fBuf[fPos] != ',' && fBuf[fPos] != ')' - && fBuf[fPos] != '*' && fBuf[fPos] != '+' && fBuf[fPos] != '?' ) { - sb.append(fBuf[fPos++]); - checkLen(); - } - String name = sb.toString(); - Element element = getElement(name); - Model model = new Model(IModel.LEAF); - model.setLeaf(element); - return model; - } - - private void checkLen() throws SAXException { - if (fPos == fLen) { - throw new SAXException( - MessageFormat.format(AntDTDSchemaMessages.getString("SchemaFactory.Unexpected_end"), //$NON-NLS-1$ - new String[]{fElement.getName(), - String.valueOf(fBuf)})); - } - } - - /** - * @see org.xml.sax.ext.DeclHandler#externalEntityDecl(java.lang.String, java.lang.String, java.lang.String) - */ - public void externalEntityDecl(String name, String publicId, String systemId) throws SAXException { - } - - /** - * @see org.xml.sax.ext.DeclHandler#internalEntityDecl(java.lang.String, java.lang.String) - */ - public void internalEntityDecl(String name, String value) throws SAXException { - } - - public void setErrorException(Exception e) { - fErrorException = e; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/AntDTDUtilMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/AntDTDUtilMessages.java deleted file mode 100644 index 6a59c95cd..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/AntDTDUtilMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntDTDUtilMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.dtd.util.AntDTDUtilMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntDTDUtilMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/AntDTDUtilMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/AntDTDUtilMessages.properties deleted file mode 100644 index 9f6b4ac5f..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/AntDTDUtilMessages.properties +++ /dev/null @@ -1,13 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -SortedMap.next()_called_for_empty_array_1=next() called for empty array -SortedMap.remove({0})_in_empty_map_2=remove({0}) in empty map diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/Factory.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/Factory.java deleted file mode 100644 index ac65e837e..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/Factory.java +++ /dev/null @@ -1,68 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -import java.lang.ref.SoftReference; - -/** - * Factory maintains a free list and, with FactoryObject, - * serves as a basis for factories of all types. - * Factory should only be subclassed in singleton classes; - * for static factories, it may be instantiated as - * a static object. - * @author Bob Foster - */ -public class Factory { - - /** - * Return the first object on the free list - * or null if none. - */ - public FactoryObject getFree() { - Head head = getHead(); - FactoryObject obj = head.next; - if (obj != null) { - head.next = obj.next(); - obj.next(null); - } - return obj; - } - - /** - * Add an object to the free list. - */ - public void setFree(FactoryObject obj) { - Head head = getHead(); - obj.next(head.next); - head.next = obj; - } - - private Head getHead() { - Head head = (Head) free.get(); - if (head == null) { - // head is needed because you can't change - // the referent of a SoftReference. - // Without head, we would need to create - // a new SoftReference each time we remove - // a map from the list. With head, getting - // a free object only causes memory allocation - // when the list has been previously collected. - head = new Head(); - free = new SoftReference(head); - } - return head; - } - - private static class Head { - public FactoryObject next; - } - private SoftReference free = new SoftReference(new Head()); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/FactoryObject.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/FactoryObject.java deleted file mode 100644 index c927257ec..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/FactoryObject.java +++ /dev/null @@ -1,22 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -/** - * A FactoryObject must implement a simple linked list. - * @author Bob Foster - */ -public interface FactoryObject { - - FactoryObject next(); - - void next(FactoryObject obj); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IKeyHolder.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IKeyHolder.java deleted file mode 100644 index bcb233a11..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IKeyHolder.java +++ /dev/null @@ -1,21 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -/** - * @author Bob Foster - */ -public interface IKeyHolder { - - Object[] getKeys(); - - void setKeys(Object[] keys); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IMapHolder.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IMapHolder.java deleted file mode 100644 index 32fb01032..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IMapHolder.java +++ /dev/null @@ -1,18 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -/** - * @author Bob Foster - */ -public interface IMapHolder extends IKeyHolder, IValueHolder { - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IValueHolder.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IValueHolder.java deleted file mode 100644 index 5bb13146b..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/IValueHolder.java +++ /dev/null @@ -1,21 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -/** - * @author Bob Foster - */ -public interface IValueHolder { - - Object[] getValues(); - - void setValues(Object[] values); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/MapHolder.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/MapHolder.java deleted file mode 100644 index 626b7a9c4..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/MapHolder.java +++ /dev/null @@ -1,49 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -/** - * @author Bob Foster - */ -public class MapHolder extends SortedMapFactory implements IMapHolder { - - public Object[] keys; - public Object[] values; - - /** - * @see com.objfac.util.IKeyHolder#getKeys() - */ - public Object[] getKeys() { - return keys; - } - - /** - * @see com.objfac.util.IKeyHolder#setKeys(Object[]) - */ - public void setKeys(Object[] keys) { - this.keys = keys; - } - - /** - * @see com.objfac.util.IValueHolder#getValues() - */ - public Object[] getValues() { - return values; - } - - /** - * @see com.objfac.util.IValueHolder#setValues(Object[]) - */ - public void setValues(Object[] values) { - this.values = values; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedMap.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedMap.java deleted file mode 100644 index 5cf36d216..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedMap.java +++ /dev/null @@ -1,268 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -import java.text.MessageFormat; -import java.util.Comparator; -import java.util.Iterator; - -/** - * @author Bob Foster - */ -public class SortedMap implements FactoryObject { - - private SortedSet fSet; - private IMapHolder fHolder; - private SortedMap fNext; - - public SortedMap(IMapHolder holder, Comparator comp) { - fHolder = holder; - fSet = new SortedSet(holder, comp); - } - - public SortedMap(Comparator comp) { - fSet = new SortedSet(comp); - } - - public SortedMap(IMapHolder holder) { - fHolder = holder; - fSet = new SortedSet(holder); - } - - public SortedMap() { - fSet = new SortedSet(); - } - - public void setMapHolder(IMapHolder holder) { - fHolder = holder; - fSet.setKeyHolder(holder); - } - - public void setComparator(Comparator comp) { - fSet.setComparator(comp); - } - - public boolean containsKey(Object key) { - return fSet.contains(key); - } - - public boolean containsKeyIdentity(Object key) { - return fSet.containsIdentity(key); - } - - public Object put(Object key, Object val) { - Object[] values = fHolder.getValues(); - int index = fSet.indexOf(key); - Object result = index >= 0 && values != null ? values[index] : null; - - int i = fSet.internalAdd(key, false); - if (i >= 0) - internalPut(i, val); - return result; - } - - protected void internalPut(int i, Object val) { - Object[] values = fHolder.getValues(); - if (values == null) { - values = new Object[1]; - values[0] = val; - return; - } - - Object[] tmp = new Object[values.length+1]; - System.arraycopy(values,0,tmp,0,i); - tmp[i] = val; - System.arraycopy(values,i,tmp,i+1,values.length-i); - fHolder.setValues(tmp); - } - - public int putAlways(Object key, Object val) { - int i = fSet.internalAdd(key, true); - internalPut(i, val); - return i; - } - - public void append(Object key, Object val) { - Object[] values = fHolder.getValues(); - int len = values != null ? values.length : 0; - fSet.internalAdd(len, key); - internalPut(len, val); - } - - public Object get(Object key) { - Object[] values = fHolder.getValues(); - if (values == null) - return null; - int i = fSet.indexOf(key); - if (i >= 0) - return values[i]; - return null; - } - - public Object getIdentity(Object key) { - Object[] values = fHolder.getValues(); - if (values == null) - return null; - int i = fSet.indexOfIdentity(key); - if (i >= 0) - return values[i]; - return null; - } - - public Object[] keys() { - return fSet.members(); - } - - public Object[] values() { - Object[] values = fHolder.getValues(); - if (values == null) - return new Object[0]; - return values; - } - - public Iterator keyIterator() { - return new ArrayIterator(); - } - - public Iterator valueIterator() { - return new ArrayIterator(); - } - - private class ArrayIterator implements Iterator { - private int fIndex; - - public ArrayIterator() { - fIndex = -1; - } - /** - * @see java.util.Iterator#hasNext() - */ - public boolean hasNext() { - Object[] array = SortedMap.this.fHolder.getKeys(); - if (array == null) - return false; - return fIndex + 1 < array.length; - } - - /** - * @see java.util.Iterator#next() - */ - public Object next() { - Object[] array = SortedMap.this.fHolder.getKeys(); - if (array == null) - throw new IllegalStateException(AntDTDUtilMessages.getString("SortedMap.next()_called_for_empty_array_1")); //$NON-NLS-1$ - return array[++fIndex]; - } - - /** - * @see java.util.Iterator#remove() - */ - public void remove() { - SortedMap.this.remove(fIndex); - --fIndex; - } - - } - - public void remove(int i) { - Object[] values = fHolder.getValues(); - if (values == null) { - throw new IllegalArgumentException(MessageFormat.format(AntDTDUtilMessages.getString("SortedMap.remove({0})_in_empty_map_2"), new String[]{Integer.toString(i)})); //$NON-NLS-1$ - } - fSet.remove(i); - Object[] tmp = new Object[values.length-1]; - System.arraycopy(values,0,tmp,0,i); - System.arraycopy(values,i+1,tmp,i,values.length-i-1); - fHolder.setValues(tmp); - } - - public Object remove(Object obj) { - Object[] values = fHolder.getValues(); - if (values == null) - return null; - int i = fSet.indexOf(obj); - if (i >= 0) { - Object tmp = values[i]; - fSet.remove(i); - remove(i); - return tmp; - } - return null; - } - public Object removeIdentity(Object obj) { - Object[] values = fHolder.getValues(); - if (values == null) - return null; - int i = fSet.indexOfIdentity(obj); - if (i >= 0) { - Object tmp = values[i]; - fSet.remove(i); - remove(i); - return tmp; - } - return null; - } - - public int size() { - return fSet.size(); - } - - public int keyIndex(Object key) { - return fSet.indexOf(key); - } - - public void merge(SortedMap other) { - Object[] values = fHolder.getValues(); - Object[] keys = fHolder.getKeys(); - Object[] othervalues = other.fHolder.getValues(); - Object[] otherkeys = other.fHolder.getKeys(); - if (otherkeys == null) - return; - if (keys == null) { - fHolder.setKeys(otherkeys); - fHolder.setValues(othervalues); - return; - } - int ithis = 0, iother = 0, i = 0; - int mthis = keys.length, mother = otherkeys.length; - Object[] ktmp = new Object[mthis+mother]; - Object[] vtmp = new Object[mthis+mother]; - while (ithis < mthis && iother < mother) { - int comp = fSet.fComp.compare(keys[ithis], otherkeys[iother]); - if (comp <= 0) { - vtmp[i] = values[ithis]; - ktmp[i++] = keys[ithis++]; - } - else { - vtmp[i] = othervalues[iother]; - ktmp[i++] = otherkeys[iother++]; - } - } - while (ithis < mthis) { - vtmp[i] = values[ithis]; - ktmp[i++] = keys[ithis++]; - } - while (iother < mother) { - vtmp[i] = othervalues[iother]; - ktmp[i++] = otherkeys[iother++]; - } - fHolder.setKeys(ktmp); - fHolder.setValues(vtmp); - } - - public FactoryObject next() { - return fNext; - } - - public void next(FactoryObject next) { - fNext = (SortedMap) next; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedMapFactory.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedMapFactory.java deleted file mode 100644 index 0339fdbe0..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedMapFactory.java +++ /dev/null @@ -1,66 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -import java.util.Comparator; - -/** - * Can be inherited or used statically. - * @author Bob Foster - */ -public class SortedMapFactory { - private static class StringComparator implements Comparator { - /** - * @see java.util.Comparator#compare(Object, Object) - */ - public int compare(Object o1, Object o2) { - return ((String)o1).compareTo(o2); - } - } - private static class IndirectStringComparator implements Comparator { - /** - * @see java.util.Comparator#compare(Object, Object) - */ - public int compare(Object o1, Object o2) { - return o1.toString().compareTo(o2.toString()); - } - } - private static final StringComparator fStringComp = new StringComparator(); - private static final IndirectStringComparator fIndirectStringComp = new IndirectStringComparator(); - private static final Factory fFactory = new Factory(); - - public static SortedMap getMap(IMapHolder holder, Comparator comp) { - SortedMap map = (SortedMap) fFactory.getFree(); - if (map == null) - map = new SortedMap(); - map.setMapHolder(holder); - map.setComparator(comp); - return map; - } - - public static SortedMap getStringMap(IMapHolder holder) { - return getMap(holder, fStringComp); - } - - public static SortedMap getIndirectStringMap(IMapHolder holder) { - return getMap(holder, fIndirectStringComp); - } - - public static SortedMap getCaseInsensitiveStringMap(IMapHolder holder) { - return getMap(holder, String.CASE_INSENSITIVE_ORDER); - } - - public static void freeMap(SortedMap map) { - map.setComparator(null); - map.setMapHolder(null); - fFactory.setFree(map); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedSet.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedSet.java deleted file mode 100644 index 3bdbfd1fb..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/dtd/util/SortedSet.java +++ /dev/null @@ -1,262 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 Object Factory Inc. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Object Factory Inc. - Initial implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.dtd.util; - -import java.util.Comparator; - -/** - * SortedSet is a flyweight set implementation that uses - * an external array provided by a KeyHolder. - * SortedSet provides both equality/comparison operations - * and identity operations. - * @author Bob Foster - */ -public class SortedSet { - protected Comparator fComp; - protected IKeyHolder fKeyHolder; - protected SortedSet fNext; - - public SortedSet(IKeyHolder holder, Comparator comp) { - fComp = comp; - fKeyHolder = holder; - } - /** - * Constructor. A keyholder must be - * supplied by <code>setKeyHolder()</code> prior ot - * <i>any</i> operations. - */ - public SortedSet(Comparator comp) { - fComp = comp; - } - /** - * Constructor, no comparator. Only identity operations - * may be performed in this set. - */ - public SortedSet(IKeyHolder holder) { - fKeyHolder = holder; - } - /** - * Constructor, no comparator. Only identity operations - * may be performed in this set. A keyholder must be - * supplied by <code>setKeyHolder()</code> prior ot - * <i>any</i> operations. - */ - public SortedSet() { - } - public void setKeyHolder(IKeyHolder holder) { - fKeyHolder = holder; - } - public void setComparator(Comparator comp) { - fComp = comp; - } - /** - * Add to set (no duplicates allowed). - * @param obj Object to add - * @return true if object was added; false - * if object was already in the set. - */ - public boolean add(Object obj) { - return internalAdd(obj, false) >= 0; - } - protected int internalAdd(Object obj, boolean always) { - Object[] array = fKeyHolder.getKeys(); - if (array == null) { - array = new Object[1]; - fKeyHolder.setKeys(array); - array[0] = obj; - return 0; - } - else { - int i = 0; - int comp = -1; - - for (; i < array.length; i++) { - if ((comp = fComp.compare(obj, array[i])) <= 0) { - break; - } - } - if (comp == 0 && !always) - return -1; - internalAdd(i, obj); - return i; - } - } - protected void internalAdd(int i, Object obj) { - Object[] array = fKeyHolder.getKeys(); - if (array == null) { - array = new Object[1]; - array[0] = obj; - fKeyHolder.setKeys(array); - } - else { - Object[] tmp = new Object[array.length+1]; - System.arraycopy(array,0,tmp,0,i); - tmp[i] = obj; - System.arraycopy(array,i,tmp,i+1,array.length-i); - fKeyHolder.setKeys(tmp); - } - } - /** - * Add allowing duplicates. - * @param obj Object to add - * @return index where object was added in sorted order. - */ - public int addAlways(Object obj) { - return internalAdd(obj, true); - } - /** - * Append, a variant of add allowing duplicates that - * always puts the new member at the end of the set. - * Set can be used with identity operations only. - */ - public void append(Object obj) { - Object[] array = fKeyHolder.getKeys(); - int len = array != null ? array.length : 0; - internalAdd(len, obj); - } - public boolean contains(Object obj) { - return indexOf(obj) >= 0; - } - public int indexOf(Object obj) { - Object[] array = fKeyHolder.getKeys(); - if (array == null) - return -1; - for (int i = 0; i < array.length; i++) { - int comp = fComp.compare(obj, array[i]); - if (comp == 0) - return i; - if (comp < 0) - return -1; - } - return -1; - } - public boolean containsIdentity(Object obj) { - return indexOf(obj) >= 0; - } - public int indexOfIdentity(Object obj) { - Object[] array = fKeyHolder.getKeys(); - if (array == null) - return -1; - for (int i = 0; i < array.length; i++) { - if (obj == array[i]) - return i; - } - return -1; - } - public boolean equals(Object o) { - if (this == o) - return true; - if (!(o instanceof SortedSet)) - return false; - SortedSet other = (SortedSet) o; - Object[] array = fKeyHolder.getKeys(); - Object[] otherarray = other.fKeyHolder.getKeys(); - if ((array == null) != (otherarray == null)) - return false; - if (array == null) - return true; - if (array.length != otherarray.length) - return false; - for (int i = 0; i < array.length; i++) { - if (array[i] != otherarray[i]) - return false; - } - return true; - } - public boolean equalsIdentify(Object o) { - if (this == o) - return true; - if (!(o instanceof SortedSet)) - return false; - SortedSet other = (SortedSet) o; - Object[] array = fKeyHolder.getKeys(); - Object[] otherarray = other.fKeyHolder.getKeys(); - if ((array == null) != (otherarray == null)) - return false; - if (array == null) - return true; - if (array.length != otherarray.length) - return false; - for (int i = 0; i < array.length; i++) { - if (fComp.compare(array[i], otherarray[i]) != 0) - return false; - } - return true; - } - public void merge(SortedSet other) { - Object[] array = fKeyHolder.getKeys(); - Object[] otherarray = other.fKeyHolder.getKeys(); - if (otherarray == null) - return; - if (array == null) { - array = otherarray; - return; - } - int ithis = 0, iother = 0, i = 0; - int mthis = array.length, mother = otherarray.length; - Object[] tmp = new Object[mthis+mother]; - while (ithis < mthis && iother < mother) { - int comp = fComp.compare(array[ithis], otherarray[iother]); - if (comp <= 0) { - tmp[i++] = array[ithis++]; - } - else { - tmp[i++] = otherarray[iother++]; - } - } - while (ithis < mthis) { - tmp[i++] = array[ithis++]; - } - while (iother < mother) { - tmp[i++] = otherarray[iother++]; - } - } - public Object[] members() { - Object[] array = fKeyHolder.getKeys(); - if (array == null) - return new Object[0]; - return array; - } - public int size() { - Object[] array = fKeyHolder.getKeys(); - return array == null ? 0 : array.length; - } - public void remove(int i) { - Object[] array = fKeyHolder.getKeys(); - Object[] tmp = new Object[array.length-1]; - System.arraycopy(array,0,tmp,0,i); - System.arraycopy(array,i+1,tmp,i,array.length-i-1); - fKeyHolder.setKeys(tmp); - } - public boolean remove(Object obj) { - int i = indexOf(obj); - if (i >= 0) { - remove(i); - return true; - } - return false; - } - public boolean removeIdentity(Object obj) { - int i = indexOfIdentity(obj); - if (i >= 0) { - remove(i); - return true; - } - return false; - } - public SortedSet getNextSet() { - return fNext; - } - public void setNextSet(SortedSet next) { - fNext = next; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditor.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditor.java deleted file mode 100644 index ce2e81e94..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditor.java +++ /dev/null @@ -1,375 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import java.util.ResourceBundle; - -import org.eclipse.core.runtime.CoreException; -import org.eclipse.jface.text.source.IAnnotationAccess; -import org.eclipse.jface.text.source.ISharedTextColors; -import org.eclipse.jface.text.source.ISourceViewer; -import org.eclipse.jface.text.source.IVerticalRuler; -import org.eclipse.jface.text.source.OverviewRuler; -import org.eclipse.jface.text.source.SourceViewer; -import org.eclipse.jface.util.PropertyChangeEvent; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.swt.custom.StyledText; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.ui.IEditorInput; -import org.eclipse.ui.IPartService; -import org.eclipse.ui.IWorkbenchPart; -import org.eclipse.ui.IWorkbenchWindow; -import org.eclipse.ui.editors.text.TextEditor; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.AntModel; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.AntEditorContentOutlinePage; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.XMLCore; -import org.eclipse.ui.externaltools.internal.ant.editor.text.AnnotationAccess; -import org.eclipse.ui.externaltools.internal.ant.editor.text.AnnotationType; -import org.eclipse.ui.externaltools.internal.ant.editor.text.IAntEditorColorConstants; -import org.eclipse.ui.externaltools.internal.ant.editor.text.AntEditorDocumentProvider; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.IAntEditorConstants; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlAttribute; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlElement; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntEditorPreferenceConstants; -import org.eclipse.ui.externaltools.internal.model.ColorManager; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.texteditor.ContentAssistAction; -import org.eclipse.ui.texteditor.DefaultRangeIndicator; -import org.eclipse.ui.texteditor.IDocumentProvider; -import org.eclipse.ui.texteditor.ITextEditorActionDefinitionIds; -import org.eclipse.ui.texteditor.SourceViewerDecorationSupport; -import org.eclipse.ui.views.contentoutline.IContentOutlinePage; - -/** - * The actual editor implementation for Eclipse's Ant integration. - * - * @author Alf Schiefelbein - */ -public class AntEditor extends TextEditor { - - /** - * The tab width - */ - public static final int TAB_WIDTH = 4; - - /** - * Selection changed listener for the outline view. - */ - protected SelectionChangedListener selectionChangedListener = new SelectionChangedListener(); - class SelectionChangedListener implements ISelectionChangedListener { - public void selectionChanged(SelectionChangedEvent event) { - doSelectionChanged(event); - } - }; - - - /** - * The page that shows the outline. - */ - protected AntEditorContentOutlinePage page; - - - /** - * Constructor for AntEditor. - */ - public AntEditor() { - super(); - setDocumentProvider(new AntEditorDocumentProvider(XMLCore.getDefault())); - setPreferenceStore(ExternalToolsPlugin.getDefault().getPreferenceStore()); - } - - - /** The <code>AntEditor</code> implementation of this - * <code>AbstractTextEditor</code> method extend the - * actions to add those specific to the receiver - */ - protected void createActions() { - super.createActions(); - - ContentAssistAction action = new ContentAssistAction(ResourceBundle.getBundle("org.eclipse.ui.externaltools.internal.ant.editor.AntEditorMessages"), "ContentAssistProposal.", this); //$NON-NLS-1$ //$NON-NLS-2$ - - // This action definition is associated with the accelerator Ctrl+Space - action.setActionDefinitionId(ITextEditorActionDefinitionIds.CONTENT_ASSIST_PROPOSALS); - setAction("ContentAssistProposal", action); //$NON-NLS-1$ - } - - public void initializeEditor() { - // That is where the assistant and its processor is defined - setSourceViewerConfiguration(new AntEditorSourceViewerConfiguration(this)); - setRangeIndicator(new DefaultRangeIndicator()); - setCompatibilityMode(false); - } - - /* (non-Javadoc) - * Method declared on IAdaptable - */ - public Object getAdapter(Class key) { - if (key.equals(IContentOutlinePage.class)) { - return getOutlinePage(); - } - return super.getAdapter(key); - } - - private AntEditorContentOutlinePage getOutlinePage() { - if (page == null) { - page= new AntEditorContentOutlinePage(XMLCore.getDefault()); - page.addPostSelectionChangedListener(selectionChangedListener); - setOutlinePageInput(page, getEditorInput()); - } - return page; - } - - private void doSelectionChanged(SelectionChangedEvent aSelectionChangedEvent) { - IStructuredSelection selection= (IStructuredSelection)aSelectionChangedEvent.getSelection(); - - if (!isActivePart() && ExternalToolsPlugin.getActivePage() != null) { - ExternalToolsPlugin.getActivePage().bringToTop(this); - } - - /* - * Here the according ISourceReference should be determined and - * then passed to setSelection. - */ - XmlElement tempSelectedXmlElement = (XmlElement)selection.getFirstElement(); - if(tempSelectedXmlElement != null) { - setSelection(tempSelectedXmlElement, !isActivePart()); - } - } - - /** - * Returns wether the editor is active. - */ - private boolean isActivePart() { - IWorkbenchWindow window= getSite().getWorkbenchWindow(); - IPartService service= window.getPartService(); - IWorkbenchPart part= service.getActivePart(); - return part != null && part.equals(this); - } - - protected void setSelection(XmlElement reference, boolean moveCursor) { - if (reference != null) { - if (reference.isExternal()) { - while (!reference.isRootExternal() || (reference.getParentNode() != null && reference.getParentNode().isExternal())) { - //no possible selection for this external element - //find the root external entity actually in the document - reference= reference.getParentNode(); - } - } - - StyledText textWidget= null; - - ISourceViewer sourceViewer= getSourceViewer(); - if (sourceViewer != null) { - textWidget= sourceViewer.getTextWidget(); - } - - if (textWidget == null) { - return; - } - - try { - - int offset= reference.getOffset(); - int length= reference.getLength(); - - if (offset < 0) { - return; - } - - textWidget.setRedraw(false); - - if(length > 0) { - setHighlightRange(offset, length, moveCursor); - } - - if (!moveCursor) { - return; - } - - XmlAttribute attrType= reference.getAttributeNamed(IAntEditorConstants.ATTR_TYPE); - if (!reference.isErrorNode() || - (attrType != null && - IAntEditorConstants.TYPE_PROJECT.equalsIgnoreCase(attrType.getValue()))) { - //NOTE: type is checked because isErrorNode() is true for an error node *and* - // the root node, which - in this case - should be handled as an normal node - offset= reference.getOffset()+1; - length= reference.getName().length(); - } - - if (offset > -1 && length > 0) { - sourceViewer.revealRange(offset, length); - // Selected region begins one index after offset - sourceViewer.setSelectedRange(offset, length); - } - } catch (IllegalArgumentException x) { - ExternalToolsPlugin.getDefault().log(x); - } finally { - if (textWidget != null) { - textWidget.setRedraw(true); - } - } - - } else if (moveCursor) { - resetHighlightRange(); - } - } - - /* (non-Javadoc) - * @see org.eclipse.ui.texteditor.AbstractTextEditor#affectsTextPresentation(org.eclipse.jface.util.PropertyChangeEvent) - */ - protected boolean affectsTextPresentation(PropertyChangeEvent event) { - String property= event.getProperty(); - return property.equals(IAntEditorColorConstants.P_DEFAULT) || - property.equals(IAntEditorColorConstants.P_PROC_INSTR) || - property.equals(IAntEditorColorConstants.P_STRING) || - property.equals(IAntEditorColorConstants.P_TAG) || - property.equals(IAntEditorColorConstants.P_XML_COMMENT); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.texteditor.AbstractTextEditor#handlePreferenceStoreChanged(org.eclipse.jface.util.PropertyChangeEvent) - */ - protected void handlePreferenceStoreChanged(PropertyChangeEvent event) { - AntEditorSourceViewerConfiguration sourceViewerConfiguration= (AntEditorSourceViewerConfiguration)getSourceViewerConfiguration(); - if (affectsTextPresentation(event)) { - sourceViewerConfiguration.updateScanners(); - } - - sourceViewerConfiguration.changeConfiguration(event); - - super.handlePreferenceStoreChanged(event); - } - - /* - * @see org.eclipse.ui.editors.text.TextEditor#doSetInput(org.eclipse.ui.IEditorInput) - */ - protected void doSetInput(IEditorInput input) throws CoreException { - super.doSetInput(input); - setOutlinePageInput(page, input); - } - - protected void setOutlinePageInput(AntEditorContentOutlinePage page, IEditorInput input) { - if (page != null) { - IDocumentProvider provider= getDocumentProvider(); - if (provider instanceof AntEditorDocumentProvider) { - AntEditorDocumentProvider documentProvider= (AntEditorDocumentProvider) provider; - AntModel model= documentProvider.getAntModel(input); - page.setPageInput(model); - } - } - } - - /** Preference key for showing the line number ruler */ - //private final static String LINE_NUMBER_RULER= AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER; - /** Preference key for the foreground color of the line numbers */ - //private final static String LINE_NUMBER_COLOR= AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER_COLOR; - /** Preference key for showing the overview ruler */ - //private final static String OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_OVERVIEW_RULER; - /** Preference key for error indication in overview ruler */ - private final static String ERROR_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_ERROR_INDICATION_IN_OVERVIEW_RULER; - /** Preference key for warning indication in overview ruler */ - private final static String WARNING_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_IN_OVERVIEW_RULER; - /** Preference key for info indication in overview ruler */ - private final static String INFO_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_IN_OVERVIEW_RULER; - /** Preference key for task indication in overview ruler */ - private final static String TASK_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_IN_OVERVIEW_RULER; - /** Preference key for bookmark indication in overview ruler */ - private final static String BOOKMARK_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_IN_OVERVIEW_RULER; - /** Preference key for search result indication in overview ruler */ - private final static String SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER; - /** Preference key for unknown annotation indication in overview ruler */ - private final static String UNKNOWN_INDICATION_IN_OVERVIEW_RULER= AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_IN_OVERVIEW_RULER; - - /** Preference key for error indication */ - private final static String ERROR_INDICATION= AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION; - /** Preference key for error color */ - private final static String ERROR_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION_COLOR; - /** Preference key for warning indication */ - private final static String WARNING_INDICATION= AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION; - /** Preference key for warning color */ - private final static String WARNING_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_COLOR; - /** Preference key for info indication */ - private final static String INFO_INDICATION= AntEditorPreferenceConstants.EDITOR_INFO_INDICATION; - /** Preference key for info color */ - private final static String INFO_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_COLOR; - /** Preference key for task indication */ - private final static String TASK_INDICATION= AntEditorPreferenceConstants.EDITOR_TASK_INDICATION; - /** Preference key for task color */ - private final static String TASK_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_COLOR; - /** Preference key for bookmark indication */ - private final static String BOOKMARK_INDICATION= AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION; - /** Preference key for bookmark color */ - private final static String BOOKMARK_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_COLOR; - /** Preference key for search result indication */ - private final static String SEARCH_RESULT_INDICATION= AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION; - /** Preference key for search result color */ - private final static String SEARCH_RESULT_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_COLOR; - /** Preference key for unknown annotation indication */ - private final static String UNKNOWN_INDICATION= AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION; - /** Preference key for unknown annotation color */ - private final static String UNKNOWN_INDICATION_COLOR= AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_COLOR; - - /** Preference key for highlighting current line */ - private final static String CURRENT_LINE= AntEditorPreferenceConstants.EDITOR_CURRENT_LINE; - /** Preference key for highlight color of current line */ - private final static String CURRENT_LINE_COLOR= AntEditorPreferenceConstants.EDITOR_CURRENT_LINE_COLOR; - /** Preference key for showing print marging ruler */ - private final static String PRINT_MARGIN= AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN; - /** Preference key for print margin ruler color */ - private final static String PRINT_MARGIN_COLOR= AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLOR; - /** Preference key for print margin ruler column */ - private final static String PRINT_MARGIN_COLUMN= AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLUMN; - - /* - * @see org.eclipse.ui.texteditor.AbstractTextEditor#createSourceViewer(org.eclipse.swt.widgets.Composite, org.eclipse.jface.text.source.IVerticalRuler, int) - */ - protected ISourceViewer createSourceViewer(Composite parent, IVerticalRuler ruler, int styles) { - fAnnotationAccess= createAnnotationAccess(); - ISharedTextColors sharedColors= ColorManager.getDefault(); - fOverviewRuler= new OverviewRuler(fAnnotationAccess, VERTICAL_RULER_WIDTH, sharedColors); - fOverviewRuler.addHeaderAnnotationType(AnnotationType.WARNING); - fOverviewRuler.addHeaderAnnotationType(AnnotationType.ERROR); - - ISourceViewer sourceViewer= new SourceViewer(parent, ruler, fOverviewRuler, isOverviewRulerVisible(), styles); - fSourceViewerDecorationSupport= new SourceViewerDecorationSupport(sourceViewer, fOverviewRuler, fAnnotationAccess, sharedColors); - configureSourceViewerDecorationSupport(); - WorkbenchHelp.setHelp(sourceViewer.getTextWidget(), IExternalToolsHelpContextIds.ANT_EDITOR); - return sourceViewer; - } - - protected IAnnotationAccess createAnnotationAccess() { - return new AnnotationAccess(); - } - - protected void configureSourceViewerDecorationSupport() { - - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.UNKNOWN, UNKNOWN_INDICATION_COLOR, UNKNOWN_INDICATION, UNKNOWN_INDICATION_IN_OVERVIEW_RULER, 0); - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.BOOKMARK, BOOKMARK_INDICATION_COLOR, BOOKMARK_INDICATION, BOOKMARK_INDICATION_IN_OVERVIEW_RULER, 1); - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.TASK, TASK_INDICATION_COLOR, TASK_INDICATION, TASK_INDICATION_IN_OVERVIEW_RULER, 2); - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.SEARCH, SEARCH_RESULT_INDICATION_COLOR, SEARCH_RESULT_INDICATION, SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER, 3); - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.INFO, INFO_INDICATION_COLOR, INFO_INDICATION, INFO_INDICATION_IN_OVERVIEW_RULER, 4); - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.WARNING, WARNING_INDICATION_COLOR, WARNING_INDICATION, WARNING_INDICATION_IN_OVERVIEW_RULER, 5); - fSourceViewerDecorationSupport.setAnnotationPainterPreferenceKeys(AnnotationType.ERROR, ERROR_INDICATION_COLOR, ERROR_INDICATION, ERROR_INDICATION_IN_OVERVIEW_RULER, 6); - - fSourceViewerDecorationSupport.setCursorLinePainterPreferenceKeys(CURRENT_LINE, CURRENT_LINE_COLOR); - fSourceViewerDecorationSupport.setMarginPainterPreferenceKeys(PRINT_MARGIN, PRINT_MARGIN_COLOR, PRINT_MARGIN_COLUMN); - - fSourceViewerDecorationSupport.setSymbolicFontName(getFontPropertyPreferenceKey()); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorActionContributor.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorActionContributor.java deleted file mode 100644 index 83413dd80..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorActionContributor.java +++ /dev/null @@ -1,87 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import java.util.ResourceBundle; - -import org.eclipse.jface.action.IMenuManager; -import org.eclipse.ui.IActionBars; -import org.eclipse.ui.IEditorPart; -import org.eclipse.ui.IWorkbenchActionConstants; -import org.eclipse.ui.editors.text.TextEditorActionContributor; -import org.eclipse.ui.texteditor.ITextEditor; -import org.eclipse.ui.texteditor.RetargetTextEditorAction; - -/** - * Contributes interesting Java actions to the desktop's Edit menu and the toolbar. - * - * @author Alf Schiefelbein - */ -public class AntEditorActionContributor extends TextEditorActionContributor { - - protected RetargetTextEditorAction fContentAssistProposal; -// protected RetargetTextEditorAction fContentAssistTip; - - /** - * Default constructor. - */ - public AntEditorActionContributor() { - super(); - fContentAssistProposal= new RetargetTextEditorAction(ResourceBundle.getBundle("org.eclipse.ui.externaltools.internal.ant.editor.AntEditorMessages"), "ContentAssistProposal."); //$NON-NLS-1$ //$NON-NLS-2$ -// fContentAssistTip= new RetargetTextEditor(ResourceBundle.getBundle("org.eclipse.ui.externaltools.internal.ant.editor.AntEditorMessages"), "ContentAssistTip."); //$NON-NLS-1$ - } - - private void doSetActiveEditor(IEditorPart part) { - super.setActiveEditor(part); - - ITextEditor editor= null; - if (part instanceof ITextEditor) - editor= (ITextEditor) part; - - fContentAssistProposal.setAction(getAction(editor, "ContentAssistProposal")); //$NON-NLS-1$ -// fContentAssistTip.setAction(getAction(editor, "ContentAssistTip")); //$NON-NLS-1$ - } - - /* - * @see IEditorActionBarContributor#init(IActionBars) - */ - public void init(IActionBars bars) { - super.init(bars); - - IMenuManager menuManager= bars.getMenuManager(); - IMenuManager editMenu= menuManager.findMenuUsingPath(IWorkbenchActionConstants.M_EDIT); - if (editMenu != null) { - editMenu.add(new org.eclipse.jface.action.Separator()); - editMenu.add(fContentAssistProposal); -// editMenu.add(fContentAssistTip); - } - - } - - /* - * @see IEditorActionBarContributor#setActiveEditor(IEditorPart) - */ - public void setActiveEditor(IEditorPart part) { - doSetActiveEditor(part); - } - - /* - * @see IEditorActionBarContributor#dispose() - */ - public void dispose() { - doSetActiveEditor(null); - super.dispose(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorCompletionProcessor.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorCompletionProcessor.java deleted file mode 100644 index e81410338..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorCompletionProcessor.java +++ /dev/null @@ -1,1199 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import java.io.File; -import java.io.IOException; -import java.io.InputStream; -import java.io.InputStreamReader; -import java.io.StringReader; -import java.util.ArrayList; -import java.util.Comparator; -import java.util.HashMap; -import java.util.Iterator; -import java.util.LinkedList; -import java.util.List; -import java.util.Map; -import java.util.NoSuchElementException; -import java.util.Set; -import java.util.TreeSet; - -import javax.xml.parsers.ParserConfigurationException; -import javax.xml.parsers.SAXParser; -import javax.xml.parsers.SAXParserFactory; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.Project; -import org.apache.tools.ant.Target; -import org.apache.tools.ant.Task; -import org.apache.tools.ant.taskdefs.Available; -import org.apache.tools.ant.taskdefs.Parallel; -import org.apache.tools.ant.taskdefs.PathConvert; -import org.apache.tools.ant.taskdefs.Property; -import org.apache.tools.ant.taskdefs.Sequential; -import org.apache.tools.ant.taskdefs.UpToDate; -import org.apache.tools.ant.taskdefs.condition.Condition; -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.ITextSelection; -import org.eclipse.jface.text.ITextViewer; -import org.eclipse.jface.text.contentassist.CompletionProposal; -import org.eclipse.jface.text.contentassist.ICompletionProposal; -import org.eclipse.jface.text.contentassist.IContentAssistProcessor; -import org.eclipse.jface.text.contentassist.IContextInformation; -import org.eclipse.jface.text.contentassist.IContextInformationValidator; -import org.eclipse.swt.graphics.Image; -import org.eclipse.ui.IEditorPart; -import org.eclipse.ui.IWorkbenchPage; -import org.eclipse.ui.IWorkbenchWindow; -import org.eclipse.ui.externaltools.internal.ant.dtd.IAttribute; -import org.eclipse.ui.externaltools.internal.ant.dtd.IDfm; -import org.eclipse.ui.externaltools.internal.ant.dtd.IElement; -import org.eclipse.ui.externaltools.internal.ant.dtd.ISchema; -import org.eclipse.ui.externaltools.internal.ant.dtd.ParseError; -import org.eclipse.ui.externaltools.internal.ant.dtd.Parser; -import org.eclipse.ui.externaltools.internal.ant.editor.utils.ProjectHelper; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.part.FileEditorInput; -import org.w3c.dom.Element; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; -import org.xml.sax.InputSource; -import org.xml.sax.SAXException; -import org.xml.sax.SAXParseException; - -/** - * The text completion processor for the Ant Editor. - * - * @author Alf Schiefelbein - */ -public class AntEditorCompletionProcessor implements IContentAssistProcessor { - - /** - * Helper Set that may only be used to collect - * <code>ICompletionProposal</code> instances. - * <P> - * This implementation tests the proposal objects by their display string - * for equality. - */ - protected class CompletionSet extends TreeSet { - - private Map displayStringToProposal = new HashMap(); - - /** - * Creates an instance that compares using the - * <code>CompletionComparator</code>. - */ - public CompletionSet() { - super(new Comparator() { - public int compare(Object o1, Object o2) { - String tempString1 = ((ICompletionProposal)o1).getDisplayString(); - String tempString2 = ((ICompletionProposal)o2).getDisplayString(); - return tempString1.compareToIgnoreCase(tempString2); - } - }); - } - - - /** - * Adds the specified <code>ICompletionProposal</code> only if another - * proposal with the same display string is not contained already. - * - * @param o must be instanceof <code>ICompletionProposal</code> - */ - public boolean add(Object o) { - ICompletionProposal tempProposal = (ICompletionProposal)o; - if(!displayStringToProposal.containsKey(tempProposal.getDisplayString())) { - boolean tempResult = super.add(o); - if(tempResult) { - displayStringToProposal.put(tempProposal.getDisplayString(), tempProposal); - } - return tempResult; - } - return false; - } - - - /** - * Returns true if no another proposal with the same display string is - * contained allready. - * - * @param o must be instanceof <code>ICompletionProposal</code> - */ - public boolean contains(Object o) { - ICompletionProposal tempProposal = (ICompletionProposal)o; - if(!displayStringToProposal.containsKey(tempProposal.getDisplayString())) { - return true; - } - return false; - } - - /** - * Removes the specified proposal. - * - * @param o must be instanceof <code>ICompletionProposal</code> - */ - public boolean remove(Object o) { - ICompletionProposal tempProposal = (ICompletionProposal)o; - boolean tempResult = super.remove(o); - if(tempResult) { - Object tempObject = displayStringToProposal.remove(tempProposal.getDisplayString()); - if(tempObject == null) { - throw new NoSuchElementException(AntEditorMessages.getString("AntEditorCompletionProcessor.Serious_Error")); //$NON-NLS-1$ - } - } - return tempResult; - } - - } - - - protected final static int PROPOSAL_MODE_NONE = 0; - protected final static int PROPOSAL_MODE_TASK_PROPOSAL = 1; - protected final static int PROPOSAL_MODE_ATTRIBUTE_PROPOSAL = 2; - protected final static int PROPOSAL_MODE_TASK_PROPOSAL_CLOSING = 3; - protected final static int PROPOSAL_MODE_ATTRIBUTE_VALUE_PROPOSAL = 4; - protected final static int PROPOSAL_MODE_PROPERTY_PROPOSAL = 5; - - protected final static String REQUIRED = "#REQUIRED"; //$NON-NLS-1$ - - /** - * The line where the cursor sits now. - * <P> - * The first line has index '1'. - */ - protected int lineNumber = -1; - - /** - * The startingColumn where the cursor sits now. - * <P> - * The first startingColumn has index '1'. - */ - protected int columnNumber = -1; - - public static final String ANT_1_5_DTD_FILENAME = "/ant1.5b.dtd"; //$NON-NLS-1$ - - /** - * The dtd. - */ - protected static ISchema dtd; - - - /** - * Cursor position, counted from the beginning of the document. - * <P> - * The first position has index '0'. - */ - protected int cursorPosition = -1; - - /** - * The text viewer. - */ - protected ITextViewer viewer; - - private char[] autoActivationChars= null; - - - /** - * The provider for all task and attribute descriptions. - */ - protected TaskDescriptionProvider descriptionProvider = new TaskDescriptionProvider(); - private AntEditorSaxDefaultHandler lastDefaultHandler; - - - /** - * Constructor for AntEditorCompletionProcessor. - */ - public AntEditorCompletionProcessor() { - super(); - if(dtd == null) { - try { - dtd = parseDtd(); - } catch (IOException e) { - ExternalToolsPlugin.getDefault().log(e); - } catch (ParseError e) { - ExternalToolsPlugin.getDefault().log(e); - } - } - } - - /** - * Parses the dtd. - */ - private ISchema parseDtd() throws ParseError, IOException { - InputStream tempStream = getClass().getResourceAsStream(ANT_1_5_DTD_FILENAME); - InputStreamReader tempReader = new InputStreamReader(tempStream, "UTF-8"); //$NON-NLS-1$ - Parser parser = new Parser(); - return parser.parseDTD(tempReader, "project"); //$NON-NLS-1$ - } - - /** - * @see org.eclipse.jface.text.contentassist.IContentAssistProcessor#computeCompletionProposals(ITextViewer, int) - */ - public ICompletionProposal[] computeCompletionProposals(ITextViewer refViewer, int documentOffset) { - this.viewer = refViewer; - return determineProposals(); - - } - - - /** - * @see org.eclipse.jface.text.contentassist.IContentAssistProcessor#computeContextInformation(ITextViewer, int) - */ - public IContextInformation[] computeContextInformation(ITextViewer refViewer, int documentOffset) { - return new IContextInformation[0]; - } - - /** - * @see org.eclipse.jface.text.contentassist.IContentAssistProcessor#getCompletionProposalAutoActivationCharacters() - */ - public char[] getCompletionProposalAutoActivationCharacters() { - return autoActivationChars; - } - - /** - * @see org.eclipse.jface.text.contentassist.IContentAssistProcessor#getContextInformationAutoActivationCharacters() - */ - public char[] getContextInformationAutoActivationCharacters() { - return null; - } - - /** - * @see org.eclipse.jface.text.contentassist.IContentAssistProcessor#getContextInformationValidator() - */ - public IContextInformationValidator getContextInformationValidator() { - return null; - } - - /** - * @see org.eclipse.jface.text.contentassist.IContentAssistProcessor#getErrorMessage() - */ - public String getErrorMessage() { - return AntEditorMessages.getString("AntEditorCompletionProcessor.No_Text_Completions_2"); //$NON-NLS-1$ - } - - - /** - * Returns the new determined proposals. - */ - private ICompletionProposal[] determineProposals() { - - String prefix = getCurrentPrefix(); - cursorPosition = ((ITextSelection)viewer.getSelectionProvider().getSelection()).getOffset(); - - IDocument tempDocument = viewer.getDocument(); - try { - lineNumber = tempDocument.getLineOfOffset(cursorPosition); - columnNumber = cursorPosition - tempDocument.getLineOffset(lineNumber); - } catch (BadLocationException e) { - ExternalToolsPlugin.getDefault().log(e); - } - - if (prefix == null || cursorPosition == -1) { - if (ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log(AntEditorMessages.getString("AntEditorCompletionProcessor.Could_not_do_completion_3"), null); //$NON-NLS-1$ - } - IWorkbenchWindow window= ExternalToolsPlugin.getActiveWorkbenchWindow(); - if (window != null) { - window.getShell().getDisplay().beep(); - } - return null; - } - - ICompletionProposal[] proposals = getProposalsFromDocument(tempDocument.get(), prefix); - return proposals; - - } - - - /** - * Returns the proposals for the specified document. - * - * @param aDocmuentString the text of the currently edited file as one string. - * @param the prefix - */ - private ICompletionProposal[] getProposalsFromDocument(String aDocumentString, String aPrefix) { - String tempTaskString = null; - - /* - * Completions will be determined depending on the proposal mode. - */ - switch (determineProposalMode(aDocumentString, cursorPosition, aPrefix)) { - - case PROPOSAL_MODE_NONE : - break; - - case PROPOSAL_MODE_ATTRIBUTE_PROPOSAL: - tempTaskString = getTaskStringFromDocumentStringToPrefix(aDocumentString.substring(0, cursorPosition-aPrefix.length())); - return getAttributeProposals(tempTaskString, aPrefix); - - case PROPOSAL_MODE_TASK_PROPOSAL: - return getTaskProposals(aDocumentString, findParentElement(aDocumentString, lineNumber, columnNumber), aPrefix); - - case PROPOSAL_MODE_TASK_PROPOSAL_CLOSING: - return getClosingTaskProposals(findNotClosedParentElement(aDocumentString, lineNumber, columnNumber), aPrefix); - - case PROPOSAL_MODE_ATTRIBUTE_VALUE_PROPOSAL: - tempTaskString = getTaskStringFromDocumentStringToPrefix(aDocumentString.substring(0, cursorPosition-aPrefix.length())); - String tempAttributeString = getAttributeStringFromDocumentStringToPrefix(aDocumentString.substring(0, cursorPosition-aPrefix.length())); - return getAttributeValueProposals(tempTaskString, tempAttributeString, aPrefix); - - case PROPOSAL_MODE_PROPERTY_PROPOSAL: - return getPropertyProposals(aDocumentString, aPrefix, cursorPosition); - - default : - break; - } - - return new ICompletionProposal[0]; - - } - - /** - * Returns all possible attributes for the specified task. - * - * @param aTaskName the name of the task for that the attribute shall be - * completed - * @param aPrefix prefix, that all proposals should start with. The prefix - * may be an empty string. - */ - protected ICompletionProposal[] getAttributeProposals(String aTaskName, String aPrefix) { - List tempProposals = new ArrayList(); - IElement tempElement = dtd.getElement(aTaskName); - if (tempElement != null) { - Iterator tempKeys = tempElement.getAttributes().keySet().iterator(); - while (tempKeys.hasNext()) { - String tempAttrName = (String) tempKeys.next(); - if (tempAttrName.startsWith(aPrefix)) { - IAttribute tempDTDAttribute = (IAttribute) tempElement.getAttributes().get(tempAttrName); - String tempReplacementString = tempAttrName+"=\"\""; //$NON-NLS-1$ - String tempDisplayString = tempAttrName; - String[] tempItems = tempDTDAttribute.getEnum(); - if (tempItems != null) { - if(tempItems.length > 1) { - tempDisplayString += " - ("; //$NON-NLS-1$ - } - for (int i = 0; i < tempItems.length; i++) { - tempDisplayString += tempItems[i]; - if(i+1 < tempItems.length) { - tempDisplayString += " | "; //$NON-NLS-1$ - } - else { - tempDisplayString += ")"; //$NON-NLS-1$ - } - } - } - - String tempProposalInfo = null; - String tempRequired = descriptionProvider.getRequiredAttributeForTaskAttribute(aTaskName, tempAttrName); - if(tempRequired != null && tempRequired.length() > 0) { - tempProposalInfo = AntEditorMessages.getString("AntEditorCompletionProcessor.Required___4") + tempRequired; //$NON-NLS-1$ - tempProposalInfo += "<BR><BR>"; //$NON-NLS-1$ - } - String tempDescription = descriptionProvider.getDescriptionForTaskAttribute(aTaskName, tempAttrName); - if(tempDescription != null) { - tempProposalInfo = (tempProposalInfo == null ? "" : tempProposalInfo); //$NON-NLS-1$ - tempProposalInfo += tempDescription; - } - - - ICompletionProposal tempProposal = new CompletionProposal(tempReplacementString, cursorPosition - aPrefix.length(), aPrefix.length(), tempAttrName.length()+2, null, tempDisplayString, null, tempProposalInfo); - /* - * This is how we do it, once we have the documentation. - * - * IContextInformation tempContextInfo = new ContextInformation("contextDisplayString", "informationDisplayString"); - * ICompletionProposal tempProposal = new CompletionProposal(tempAttrName+"=\"\"", cursorPosition - aPrefix.length(), aPrefix.length(), tempAttrName.length()+2, null, tempAttrName, tempContextInfo, "Pustekuchen ;-) !!!"); - */ - tempProposals.add(tempProposal); - } - } - } - return (ICompletionProposal[])tempProposals.toArray(new ICompletionProposal[tempProposals.size()]); - } - - - /** - * Returns all possible values for the specified attribute of the specified - * task. - * - * @param aTaskName the name of the task that the specified attribute - * belongs to. - * - * @param anAttributeName the name of the attribute for that the value - * shall be completed - * - * @param aPrefix prefix, that all proposals should start with. The prefix - * may be an empty string. - */ - private ICompletionProposal[] getAttributeValueProposals(String aTaskName, String anAttributeName, String aPrefix) { - List tempProposals = new ArrayList(); - IElement tempElement = dtd.getElement(aTaskName); - if (tempElement != null) { - IAttribute tempAttribute = (IAttribute) tempElement.getAttributes().get(anAttributeName); - if (tempAttribute != null) { - String[] tempItems = tempAttribute.getEnum(); - if (tempItems != null) { - for (int i = 0; i < tempItems.length; i++) { - String tempItem = tempItems[i]; - if(tempItem.startsWith(aPrefix)) { - ICompletionProposal tempProposal = new CompletionProposal(tempItem, cursorPosition - aPrefix.length(), aPrefix.length(), tempItem.length(), null, tempItem, null, null); - tempProposals.add(tempProposal); - } - } - } - } - } - return (ICompletionProposal[])tempProposals.toArray(new ICompletionProposal[tempProposals.size()]); - } - - - /** - * Returns all possible properties for the specified prefix. - * <P> - * Note that the completion mode must be property mode, otherwise it is not - * safe to call this method. - */ - protected ICompletionProposal[] getPropertyProposals(String aDocumentText, String aPrefix, int aCursorPosition) { - Set tempProposals = new CompletionSet(); - Map tempProperties = findPropertiesFromDocument(aDocumentText); - for(Iterator i=tempProperties.keySet().iterator(); i.hasNext(); ) { - String tempPropertyName = (String)i.next(); - if(tempPropertyName.startsWith(aPrefix)) { - String tempPropertyValue = (String)tempProperties.get(tempPropertyName); - String tempAdditPropInfo = tempPropertyValue; - - // Determine replacement length and offset - // String from beginning to the beginning of the prefix - int tempReplacementLength = aPrefix.length(); - int tempReplacementOffset = 0; - String tempStringToPrefix = aDocumentText.substring(0, aCursorPosition - aPrefix.length()); - // Property proposal - String tempLastTwoCharacters = tempStringToPrefix.substring(tempStringToPrefix.length()-2, tempStringToPrefix.length()); - if(tempLastTwoCharacters.equals("${")) { //$NON-NLS-1$ - tempReplacementLength += 2; - tempReplacementOffset = aCursorPosition - aPrefix.length() - 2; - } - else if(tempLastTwoCharacters.endsWith("$")) { //$NON-NLS-1$ - tempReplacementLength += 1; - tempReplacementOffset = aCursorPosition - aPrefix.length() - 1; } - else { - throw new AntEditorException(AntEditorMessages.getString("AntEditorCompletionProcessor.Error")); //$NON-NLS-1$ - } - if(aDocumentText.length() > aCursorPosition && aDocumentText.charAt(aCursorPosition) == '}') { - tempReplacementLength += 1; - } - - String tempReplacementString = new StringBuffer("${").append(tempPropertyName).append('}').toString(); //$NON-NLS-1$ - Image tempImage = ExternalToolsImages.getImage(IExternalToolsUIConstants.IMAGE_ID_PROPERTY); - - ICompletionProposal proposal = - new CompletionProposal( - tempReplacementString, - tempReplacementOffset, - tempReplacementLength, - tempReplacementString.length(), - tempImage, - tempPropertyName, null, - tempAdditPropInfo); - tempProposals.add(proposal); - } - } - return (ICompletionProposal[])tempProposals.toArray(new ICompletionProposal[tempProposals.size()]); - } - - - /** - * Returns all possible attributes for the specified parent task element. - * <P> - * No completions will be returned if <code>aParentTaskElement</code> is - * not known. - * - * @param aParentTaskName name of the parent(surrounding) task or - * <code>null</code> if completion should be done for the root element. - * - * @param aPrefix prefix, that all proposals should start with. The prefix - * may be an empty string. - */ - protected ICompletionProposal[] getTaskProposals(String aWholeDocumentString, Element aParentTaskElement, String aPrefix) { - // The code this replaced assumed that child elements - // are unordered; there was no provision for walking - // through a child sequence. This works for the Ant - // 1.5 DTD but not in general. I kept the assumption. bf - LinkedList tempProposals = new LinkedList(); - Image tempImage = ExternalToolsImages.getImage(IExternalToolsUIConstants.IMAGE_ID_TASK); - - if (aParentTaskElement == null) { - // DTDs do not designate a root element. - // The previous code must have looked for an element that - // was not in the content model of any other element. - // This test doesn't work with a DTD used to validate - // document partitions, a DTD with multiple candidate - // roots, etc. The right answer is to get - // the root element from the document. If there isn't - // one, we assume "project". bf - String tempRootElementName = null; - if(lastDefaultHandler != null) { - tempRootElementName = lastDefaultHandler.rootElementName; - } - if (tempRootElementName == null) { - tempRootElementName = aPrefix + "project"; //$NON-NLS-1$ - } - IElement tempRootElement = dtd.getElement(tempRootElementName); - if(tempRootElement != null && tempRootElementName.startsWith(aPrefix)) { - String tempProposalInfo = null; - String tempDescription = descriptionProvider.getDescriptionForTask(tempRootElementName); - if(tempDescription != null) { - tempProposalInfo = tempDescription; - } - - String tempReplacementString = getTaskProposalReplacementString(tempRootElementName); - int tempReplacementOffset = cursorPosition-aPrefix.length(); - int tempReplacementLength = aPrefix.length(); - if(tempReplacementOffset > 0 && tempReplacementOffset-1 < aWholeDocumentString.length() && aWholeDocumentString.charAt(tempReplacementOffset-1) == '<') { - tempReplacementOffset--; - tempReplacementLength++; - } - - ICompletionProposal tempProposal = new CompletionProposal( - tempReplacementString, - tempReplacementOffset, - tempReplacementLength, - tempRootElementName.length() + 2, - tempImage, - tempRootElementName, - null, - tempProposalInfo); - tempProposals.add(tempProposal); - } - } - else { - IElement parent = dtd.getElement(aParentTaskElement.getTagName()); - if (parent != null) { - IDfm dfm = parent.getDfm(); - String[] accepts = dfm.getAccepts(); - for (int i = 0; i < accepts.length; i++) { - String tempElementName = accepts[i]; - - if(tempElementName.startsWith(aPrefix)) { - - String tempProposalInfo = null; - String tempDescription = descriptionProvider.getDescriptionForTask(tempElementName); - if(tempDescription != null) { - tempProposalInfo = tempDescription; - } - - String tempReplacementString = getTaskProposalReplacementString(tempElementName); - int tempReplacementOffset = cursorPosition-aPrefix.length(); - int tempReplacementLength = aPrefix.length(); - if(tempReplacementOffset > 0 && aWholeDocumentString.charAt(tempReplacementOffset-1) == '<') { - tempReplacementOffset--; - tempReplacementLength++; - } - ICompletionProposal tempProposal = new CompletionProposal( - tempReplacementString, - tempReplacementOffset, - tempReplacementLength, - tempElementName.length()+2, - tempImage, - tempElementName, - null, - tempProposalInfo); - tempProposals.add(tempProposal); - } - } - } - } - - return (ICompletionProposal[])tempProposals.toArray(new ICompletionProposal[tempProposals.size()]); - } - - /** - * Returns the one possible completion for the specified unclosed task - * element. - * - * @param aUnclosedTaskElement the task element that hasn't been closed - * last - * - * @param aPrefix prefix, that the one possible proposals should start - * with. The prefix may be an empty string. - * - * @return array which may contain either one or none proposals - */ - private ICompletionProposal[] getClosingTaskProposals(Element aUnclosedTaskElement, String aPrefix) { - Set tempProposals = new CompletionSet(); - if(aUnclosedTaskElement != null) { - if(aUnclosedTaskElement.getTagName().startsWith(aPrefix)) { - String tempReplaceString = aUnclosedTaskElement.getTagName(); - tempProposals.add(new CompletionProposal(tempReplaceString + '>', cursorPosition - aPrefix.length(), aPrefix.length(), tempReplaceString.length()+1, null, tempReplaceString, null, null)); - } - } - return (ICompletionProposal[])tempProposals.toArray(new ICompletionProposal[tempProposals.size()]); - } - - /** - * Returns the replacement string for the specified task name. - */ - private String getTaskProposalReplacementString(String aTaskName) { - StringBuffer tempReplacement = new StringBuffer("<"); //$NON-NLS-1$ - tempReplacement.append(aTaskName); - if(isEmpty(aTaskName)) { - tempReplacement.append(" />"); //$NON-NLS-1$ - } - else { - tempReplacement.append(" ></"); //$NON-NLS-1$ - tempReplacement.append(aTaskName); - tempReplacement.append('>'); - } - return tempReplacement.toString(); - } - - - /** - * Returns whether the named element is empty, thus may not have any child - * elements. - */ - private boolean isEmpty(String aDTDElementName) { - IElement element = dtd.getElement(aDTDElementName); - return element.isEmpty(); - } - - - /** - * Finds a direct child element with <code>aChildElementName</code> of - * <code>anElement</code>. - * <P> - * The child will not be searched for in the whole hierarchy but only in - * the hierarchy step below. - * - * @return the found child or <code>null</code> if not found. - */ - protected Element findChildElementNamedOf(Element anElement, String aChildElementName) { - NodeList tempNodeList = anElement.getChildNodes(); - for (int i = 0; i < tempNodeList.getLength(); i++) { - Node tempChildNode = (Node)tempNodeList.item(i); - if(tempChildNode.getNodeType() == Node.ELEMENT_NODE) { - if(tempChildNode.getNodeName().equals(aChildElementName)) { - return (Element)tempChildNode; - } - } - - } - return null; - } - - /** - * Determines the current prefix, that should be used for completion. - */ - private String getCurrentPrefix() { - - ITextSelection selection = (ITextSelection)viewer.getSelectionProvider().getSelection(); - - if (selection.getLength() > 0) { - return null; - } - - IDocument doc = viewer.getDocument(); - - return getPrefixFromDocument(doc.get(), selection.getOffset()).toLowerCase(); - } - - - /** - * Returns the prefix in the specified document text with respect to the - * specified offset. - * - * @param aDocumentString the whole content of the edited file as String - * @param anOffset the cursor position - */ - protected String getPrefixFromDocument(String aDocumentText, int anOffset) { - - int startOfWordToken = anOffset; - - while (startOfWordToken > 0 - && (Character.isJavaIdentifierPart(aDocumentText.charAt(startOfWordToken - 1)) - || '.' == aDocumentText.charAt(startOfWordToken - 1) - || '-' == aDocumentText.charAt(startOfWordToken - 1)) - && !('$' == aDocumentText.charAt(startOfWordToken - 1))) { - startOfWordToken--; - } - - if (startOfWordToken != anOffset) { - return aDocumentText.substring(startOfWordToken, anOffset); - } else { - return ""; //$NON-NLS-1$ - } - } - - - /** - * Returns the current proposal mode. - */ - protected int determineProposalMode(String aWholeDocumentString, int aCursorPosition, String aPrefix) { - - // String from beginning of document to the beginning of the prefix - String tempStringToPrefix = aWholeDocumentString.substring(0, aCursorPosition - aPrefix.length()); - - // Is trimmable from behind - String tempTrimmedString = tempStringToPrefix.trim(); - char tempLastChar = 0; - if(tempTrimmedString.length() > 0) { - tempLastChar = tempTrimmedString.charAt(tempTrimmedString.length()-1); - } - else { - return PROPOSAL_MODE_TASK_PROPOSAL; - } - if(tempStringToPrefix.charAt(tempStringToPrefix.length()-1) != tempLastChar && tempLastChar != '>') { - /* - * Substring must be trimmable from behind in case of attribute - * proposal because a space or a new line must be used as delimiter - * between task name and attribute or attribute and attribute. - * Example: '<property id="bla" name="hups"' - */ - - // Attribute proposal - if(tempLastChar != '>' && tempLastChar != '<') { - String tempTaskString = - getTaskStringFromDocumentStringToPrefix( - tempTrimmedString); - if(tempTaskString != null && isNamedTaskKnown(tempTaskString)) { - return PROPOSAL_MODE_ATTRIBUTE_PROPOSAL; - } - } - } - - // Attribute value proposal - else if(tempStringToPrefix.charAt(tempStringToPrefix.length()-1) == '"') { - String tempTaskString = - getTaskStringFromDocumentStringToPrefix( - tempTrimmedString); - if(tempTaskString != null && isNamedTaskKnown(tempTaskString)) { - return PROPOSAL_MODE_ATTRIBUTE_VALUE_PROPOSAL; - } - } - - // Task proposal - else { - int tempSpaceIndex = tempStringToPrefix.lastIndexOf(' '); - int tempLessThanIndex = tempStringToPrefix.lastIndexOf('<'); - int tempGreaterThanIndex = tempStringToPrefix.lastIndexOf('>'); - - // Task proposal - if(tempLessThanIndex > tempSpaceIndex && tempGreaterThanIndex < tempLessThanIndex) { - int tempSlashIndex = tempStringToPrefix.lastIndexOf('/'); - if(tempSlashIndex == tempLessThanIndex +1) { - return PROPOSAL_MODE_TASK_PROPOSAL_CLOSING; // ... </ - } - return PROPOSAL_MODE_TASK_PROPOSAL; - } - if(tempLessThanIndex < tempGreaterThanIndex && "".equals(aPrefix)) { //$NON-NLS-1$ - - // no other regular character may be between '>' and cursor position - int tempActIndex = aCursorPosition; - do { - char tempChar = tempStringToPrefix.charAt(--tempActIndex); - if(tempChar != ' ' && tempChar != '\t' && tempChar != '\n' && tempChar != '\r') { - break; // found a character -> no task proposal mode - } - } while(tempActIndex > tempGreaterThanIndex); - - // no character found in between - if(tempActIndex == tempGreaterThanIndex) { - return PROPOSAL_MODE_TASK_PROPOSAL; - } - } - } - - // Property proposal - if(tempStringToPrefix.length() >= 2) { - String tempLastTwoCharacters = tempStringToPrefix.substring(tempStringToPrefix.length()-2, tempStringToPrefix.length()); - if(tempLastTwoCharacters.equals("${") || //$NON-NLS-1$ - tempStringToPrefix.charAt(tempStringToPrefix.length()-1) == '$') { - return PROPOSAL_MODE_PROPERTY_PROPOSAL; - } - } - - return PROPOSAL_MODE_NONE; - } - - - /** - * Returns the last occuring task string in the specified string. - * <P> - * The returned string must not necessarily be a valid Ant task string. - * This can be tested with the method <code>inNamedTaskKnown(String)</code> - * after invoking this method. - * - * @param aDocumentStringToPrefix the String that contains the whole string - * of the currently edited file from the beginning up to the prefix for code - * completion. Example: '<project default="name"><property '. - * - * @return the extracted task string or <code>null</code> if no string could - * be extracted. - */ - private String getTaskStringFromDocumentStringToPrefix( - String aDocumentStringToPrefix) { - - int tempLessThanIndex = aDocumentStringToPrefix.lastIndexOf('<'); - - if(tempLessThanIndex > -1) { - String tempTaskString = aDocumentStringToPrefix.trim(); - tempTaskString = tempTaskString.substring(tempLessThanIndex+1, tempTaskString.length()); - int tempIndex = tempTaskString.indexOf(' '); - if(tempIndex > 0) { - tempTaskString = tempTaskString.substring(0, tempIndex); - } - tempIndex = tempTaskString.indexOf('\n'); - if(tempIndex > 0) { - tempTaskString = tempTaskString.substring(0, tempIndex); - } - tempIndex = tempTaskString.indexOf('\r'); - if(tempIndex > 0) { - tempTaskString = tempTaskString.substring(0, tempIndex); - } - return tempTaskString; - } - - return null; - } - - - /** - * Returns the last occuring attribute string in the specified string. - * <P> - * Calling this method is only safe if the current proposal mode is really - * <code>PROPOSAL_MODE_ATTRIBUTE_VALUE_PROPOSAL</code>. - */ - private String getAttributeStringFromDocumentStringToPrefix(String aDocumentStringToPrefix) { - int tempIndex = aDocumentStringToPrefix.lastIndexOf('='); - String tempSubString = aDocumentStringToPrefix.substring(0, tempIndex); - tempSubString = tempSubString.trim(); - - tempIndex = tempSubString.lastIndexOf(' '); - if(tempIndex > 0) { - tempSubString = tempSubString.substring(tempIndex+1, tempSubString.length()); - } - tempIndex = tempSubString.lastIndexOf('\n'); - if(tempIndex > 0) { - tempSubString = tempSubString.substring(tempIndex+1, tempSubString.length()); - } - tempIndex = tempSubString.lastIndexOf('\r'); - if(tempIndex > 0) { - tempSubString = tempSubString.substring(tempIndex+1, tempSubString.length()); - } - return tempSubString; - } - - - /** - * Returns whether the specified task name is known according to the DTD. - */ - private boolean isNamedTaskKnown(String aTaskName) { - return dtd.getElement(aTaskName) != null; - } - - - /** - * Finds the parent task element in respect to the cursor position. - * - * @return the parent task element or <code>null</code> if not found. - */ - protected Element findParentElement(String aWholeDocumentString, int aLineNumber, int aColumnNumber) { - - // Return the parent - return parseEditedFileSearchingForParent(aWholeDocumentString, aLineNumber, aColumnNumber).getParentElement(true); - } - - - /** - * Parses the actually edited file as far as possible. - * <P> - * The returned handler can be asked about what happend while parsing - * the document. - * - * @return the handler that has been used for parsing or <code>null</code> - * if parsing couldn't be done because of some error. - */ - private AntEditorSaxDefaultHandler parseEditedFileSearchingForParent(String aWholeDocumentString, int aLineNumber, int aColumnNumber) { - // Get a new SAX Parser - SAXParser tempParser = null; - try { - tempParser = SAXParserFactory.newInstance().newSAXParser(); - } catch (ParserConfigurationException e) { - ExternalToolsPlugin.getDefault().log(e); - return null; - } catch (SAXException e) { - ExternalToolsPlugin.getDefault().log(e); - return null; - } - - // Set the handler - AntEditorSaxDefaultHandler tempHandler = null; - File editedFile= getEditedFile(); - try { - File parent = null; - if(editedFile != null) { - parent = editedFile.getParentFile(); - } - tempHandler = new AntEditorSaxDefaultHandler(parent, aLineNumber, aColumnNumber); - } catch (ParserConfigurationException e) { - ExternalToolsPlugin.getDefault().log(e); - } - - // Parse! - InputSource tempInputSource = new InputSource(new StringReader(aWholeDocumentString)); - if (editedFile != null) { - //needed for resolving relative external entities - tempInputSource.setSystemId(editedFile.getAbsolutePath()); - } - try { - tempParser.parse(tempInputSource, tempHandler); - } catch(SAXParseException e) { - // Ignore since that happens always if the edited file is not valid. We try to handle that. - } catch (SAXException e) { - ExternalToolsPlugin.getDefault().log(e); - } catch (IOException e) { - //ignore since can happen when user has incorrect paths / protocols for external entities - } - - lastDefaultHandler = tempHandler; // bf - return tempHandler; - } - - - /** - * Parses the actually edited file as far as possible. - * <P> - * We use the parsing facilities of the ant plug-in here. - * - * @return a map with all the found properties - */ - private Map findPropertiesFromDocument(String aWholeDocumentString) { - /* - * What is implemented here: - * - We first use the ant plug-in to create a Project instance. - * - We determine the enclosing parent task element - * - We determine the dependency Vector for the parent task element - * - We work our way through the dependency Vector and execute the - * Property relevant tasks. - */ - - // Create an initialized project - Project tempProject = new Project(); - tempProject.init(); - - /* - * Ant's parsing facilities always works on a file, therefore we need - * to determine the actual location of the file. Though the file - * contents will not be parsed. We parse the passed document string - * that is passed. - */ - File tempFile = getEditedFile(); - String filePath= ""; //$NON-NLS-1$ - if (tempFile != null) { - filePath= tempFile.getAbsolutePath(); - } - tempProject.setUserProperty("ant.file", filePath); //$NON-NLS-1$ - - try { - ProjectHelper.configureProject(tempProject, tempFile, aWholeDocumentString); // File will be parsed here - } - catch(BuildException e) { - // ignore a build exception on purpose, since we also parse invalid - // build files. - } - Map properties = tempProject.getProperties(); - - // Determine the parent - Element tempElement = findEnclosingTargetElement(aWholeDocumentString, lineNumber, columnNumber); - String tempTargetName = null; - if(tempElement == null - || (tempTargetName = tempElement.getAttribute("name")) == null //$NON-NLS-1$ - || tempTargetName.length() == 0) { - return properties; - } - List tempSortedTargets = null; - try { - tempSortedTargets= tempProject.topoSort(tempTargetName, tempProject.getTargets()); - } catch (BuildException be) { - return tempProject.getProperties(); - } - - int curidx = 0; - Target curtarget; - - do { - curtarget = (Target) tempSortedTargets.get(curidx++); - Task[] tempTasks = curtarget.getTasks(); - - for (int i = 0; i < tempTasks.length; i++) { - Task tempTask = tempTasks[i]; - - // sequential - if(tempTask instanceof Sequential) { - // (T) - } - - // parallel - if(tempTask instanceof Parallel) { - // (T) - } - - // waitfor (@since Ant 1.5) - // if(tempTask instanceof WaitFor) { - // // (T) - // } - - if(tempTask instanceof Property - || tempTask instanceof PathConvert - || tempTask instanceof Available - || tempTask instanceof UpToDate - || tempTask instanceof Condition) { - ((Task)tempTask).perform(); - } - - - // Ant 1.5 -// if(tempTask instanceof LoadFile) { -// -// } - - // Ant 1.5 -// if(tempTask instanceof XmlProperty) { -// -// } - - // Ant 1.5 -// if(tempTask instanceof Basename) { -// -// } - - - // Ant 1.5 -// if(tempTask instanceof Dirname) { -// -// } - - // Ant 1.5 -// if(tempTask instanceof LoadProperties) { -// -// } - } - } while (!curtarget.getName().equals(tempTargetName)); - - - // Need to reget it since tempTable hasn't been updated with Ant 1.5 - return tempProject.getProperties(); - } - - protected File getEditedFile() { - IWorkbenchPage page= ExternalToolsPlugin.getActivePage(); - if (page == null) { - return null; - } - IEditorPart editor= page.getActiveEditor(); - if (editor == null) { - return null; - } - FileEditorInput tempInput = (FileEditorInput) editor.getEditorInput(); - String tempProjectPath = tempInput.getFile().getProject().getLocation().toFile().getAbsolutePath(); - String tempProjectRelativeFilePath = tempInput.getFile().getFullPath().removeFirstSegments(1).makeRelative().toString(); - File tempFile = new File(tempProjectPath + File.separator +tempProjectRelativeFilePath); - return tempFile; - } - - /** - * Finds the parent task element in respect to the cursor position which - * that has not been closed yet. - * - * @return the not closed parent task element or <code>null</code> if not - * found. - */ - private Element findNotClosedParentElement(String aWholeDocumentString, int aLineNumber, int aColumnNumber) { - AntEditorSaxDefaultHandler tempHandler = parseEditedFileSearchingForParent(aWholeDocumentString, aLineNumber, aColumnNumber); - if(tempHandler != null) { - - // A not closed parent element can only be found by guessing. - if(tempHandler.getParentElement(false) == null) { - return tempHandler.getParentElement(true); - } - - } - return null; - } - - - /** - * Finds the enclosing target element in respect to the cursor position. - * - * @return the enclosing target element or <code>null</code> if not found. - */ - private Element findEnclosingTargetElement(String aWholeDocumentString, int aLineNumber, int aColumnNumber) { - - // Get a new SAX Parser - SAXParser tempParser = null; - try { - tempParser = SAXParserFactory.newInstance().newSAXParser(); - } catch (ParserConfigurationException e) { - ExternalToolsPlugin.getDefault().log(e); - return null; - } catch (SAXException e) { - ExternalToolsPlugin.getDefault().log(e); - return null; - } - - // Set the handler - EnclosingTargetSearchingHandler tempHandler = null; - File editedFile= getEditedFile(); - try { - File parent = null; - if(editedFile != null) { - parent = editedFile.getParentFile(); - } - tempHandler = new EnclosingTargetSearchingHandler(parent, aLineNumber, aColumnNumber); - } catch (ParserConfigurationException e) { - ExternalToolsPlugin.getDefault().log(e); - } - - // Parse! - InputSource tempInputSource = new InputSource(new StringReader(aWholeDocumentString)); - if (editedFile != null) { - //needed for resolving relative external entities - tempInputSource.setSystemId(editedFile.getAbsolutePath()); - } - try { - tempParser.parse(tempInputSource, tempHandler); - } catch(SAXParseException e) { - // Ignore since that happens always if the edited file is not valid. We try to handle that. - } catch (SAXException e) { - ExternalToolsPlugin.getDefault().log(e); - } catch (IOException e) { - ExternalToolsPlugin.getDefault().log(e); - } - - return tempHandler.getParentElement(true); - } - - /** - * Sets this processor's set of characters triggering the activation of the - * completion proposal computation. - * - * @param activationSet the activation set - */ - public void setCompletionProposalAutoActivationCharacters(char[] activationSet) { - autoActivationChars= activationSet; - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorException.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorException.java deleted file mode 100644 index 104057f00..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorException.java +++ /dev/null @@ -1,37 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany). - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -/** - * Exception that might be thrown in the Ant Editor context. - * - * @author Alf Schiefelbein - */ -public class AntEditorException extends RuntimeException { - - /** - * Constructor for AntEditorException. - */ - public AntEditorException() { - super(); - } - - /** - * Constructor for AntEditorException. - * @param s - */ - public AntEditorException(String s) { - super(s); - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorMessages.java deleted file mode 100644 index fa0a7b9cb..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntEditorMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.editor.AntEditorMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntEditorMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorMessages.properties deleted file mode 100644 index 945e76c53..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorMessages.properties +++ /dev/null @@ -1,27 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -ContentAssistProposal.label=Content Assist@Ctrl+Space -ContentAssistProposal.tooltip=Content Assist -ContentAssistProposal.image= -ContentAssistProposal.description=Content Assist - -EnclosingTargetSearchingHandler.Error_parsing=Error when parsing document: Neither a local name nor qualified of an element specified - -AntEditorCompletionProcessor.Serious_Error=Serious error in AntEditorCompletionProcessor.CompletionSet: Object was removed which should not actually exist. -AntEditorCompletionProcessor.No_Text_Completions_2=No Text Completions -AntEditorCompletionProcessor.Could_not_do_completion_3=Could not do completion -AntEditorCompletionProcessor.Required___4=Required: -AntEditorCompletionProcessor.Error=Error in AntEditorCompletionProcessor.getPropertyProposals -AntEditorSaxDefaultHandler.Invalid_cursor_position=The cursor position of {0}, {1} (startingRow, startingColumn) is not valid -AntEditorSaxDefaultHandler.Error_parsing=Error when parsing document: Neither a local name nor qualified of an element specified - -AntAnnotationHover.multipleMarkersAtThisLine=Multiple markers at this line diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorSaxDefaultHandler.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorSaxDefaultHandler.java deleted file mode 100644 index b719da359..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorSaxDefaultHandler.java +++ /dev/null @@ -1,362 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import java.io.File; -import java.io.FileNotFoundException; -import java.io.FileReader; -import java.text.MessageFormat; -import java.util.Stack; - -import javax.xml.parsers.DocumentBuilder; -import javax.xml.parsers.DocumentBuilderFactory; -import javax.xml.parsers.ParserConfigurationException; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.util.FileUtils; -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.w3c.dom.Document; -import org.w3c.dom.Element; -import org.xml.sax.Attributes; -import org.xml.sax.InputSource; -import org.xml.sax.Locator; -import org.xml.sax.SAXException; -import org.xml.sax.SAXParseException; -import org.xml.sax.helpers.DefaultHandler; - - -/** - * The <code>DefaultHandler</code> for the parsing of the currently edited file. - * - * @version 19.09.2002 - * @author Alf Schiefelbein - */ -public class AntEditorSaxDefaultHandler extends DefaultHandler { - - /** - * The locator that tells us the location of the currently parsed element - * in the parsed document. - */ - protected Locator locator; - - - /** - * Stack of still open elements. - * <P> - * On top of the stack is the innermost element. - */ - protected Stack stillOpenElements = new Stack(); - - - /** - * The parent element that we search for. - * <P> - * This variable will be set during the parsing process, when we first - * passed the cursor location. - */ - protected Element parentElement; - - - /** - * Flag that determines whether we are finished with parsing. - * <P> - * This is usually the case when the parent element was found and closed. - */ - protected boolean parsingFinished; - - - /** - * Document that is used to create the elements. - */ - protected Document document; - - - /** - * The startingRow where the cursor is located in the document. - * <P> - * The first startingRow is refered to with an index of '0'. - */ - protected int rowOfCursorPosition = -1; - - - /** - * The startingColumn where the cursor is located in the document. - * <P> - * The first startingColumn is refered to with an index of '0'. - */ - protected int columnOfCursorPosition = -1; - - /** - * The name of the document root element or null if none seen. - */ - public String rootElementName; - - /** - * Used as a helper for resolving external relative entries. - */ - private File mainFileContainer; - - - /** - * Creates an AntEditorSaxDefaultHandler, with the specified parameters. - * - * @param aRowOfCursorPosition the startingRow where the cursor is located in the - * document. The first startingRow is refered to with an index of '0'. - * @param aColumnOfCursorPosition the startingColumn where the cursor is located in - * the document. The first startingColumn is refered to with an index of '0'. - */ - public AntEditorSaxDefaultHandler(File mainFileContainer, int aRowOfCursorPosition, int aColumnOfCursorPosition) throws ParserConfigurationException { - super(); - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("AntEditorSaxDefaultHandler(" +aRowOfCursorPosition+ ", "+aColumnOfCursorPosition+ ")", null); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ - } - if(aRowOfCursorPosition < 0 || aColumnOfCursorPosition < 0) { - throw new IllegalArgumentException(MessageFormat.format(AntEditorMessages.getString("AntEditorSaxDefaultHandler.Invalid_cursor_position"), new String[]{Integer.toString(aRowOfCursorPosition), Integer.toString(aColumnOfCursorPosition)})); //$NON-NLS-1$ - } - rowOfCursorPosition = aRowOfCursorPosition; - columnOfCursorPosition = aColumnOfCursorPosition; - this.mainFileContainer= mainFileContainer; - initialize(); - } - - - /** - * Initializes the handler. - */ - protected void initialize() throws ParserConfigurationException { - DocumentBuilder tempDocumentBuilder = DocumentBuilderFactory.newInstance().newDocumentBuilder(); - document = tempDocumentBuilder.newDocument(); - } - - - - /** - * Checks whether the parent element, that we are searching for can be or - * has already been determined. - * <P> - * This will be done by comparing the current parsing position with the - * cursor position. If we just passed the cursor position and the parent - * element has not been set yet, it will be set. - * - * @return <code>true</code> if the parent element is known otherwise - * <code>false</code> - */ - protected boolean checkForParentElement() { - if(parentElement == null) { - if(locator != null) { - - /* - * The locator's numbers are 1-based though, we do everything - * 0-based. - */ - - int tempLineNr = locator.getLineNumber() -1; - int tempColumnNr = locator.getColumnNumber() -1; - if(tempLineNr> rowOfCursorPosition || - (tempLineNr == rowOfCursorPosition && tempColumnNr > columnOfCursorPosition) && !stillOpenElements.isEmpty()) { - parentElement = (Element)stillOpenElements.peek(); - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("AntEditorSaxDefaultHandler.checkForParentElement(): Parent element found: " +parentElement, null); //$NON-NLS-1$ - } - return true; - } - } - return false; - } - - // Parent element has been set already before - return true; - } - - - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#startElement(String, String, String, Attributes) - */ - public void startElement( - String aUri, - String aLocalName, - String aQualifiedName, - Attributes anAttributes) - throws SAXException { - /* - * While the crimson parser passes the tag name as local name, apache's - * xerces parser, passes the tag name as qualilfied name and an empty - * string as local name. - */ - - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("AntEditorSaxDefaultHandler.startElement(" +aUri+ ", " +aLocalName+ ", "+aQualifiedName+ ", "+anAttributes+ ")", null); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ //$NON-NLS-5$ - } - if(parsingFinished) { - return; - } - - // Checks whether we know the parent for sure - checkForParentElement(); - - // Create a Dom Element - String tempTagName = aLocalName.length() > 0 ? aLocalName : aQualifiedName; - if(tempTagName == null || tempTagName.length() == 0) { - throw new AntEditorException(AntEditorMessages.getString("AntEditorSaxDefaultHandler.Error_parsing")); //$NON-NLS-1$ - } - // This code added to determine root element in a rational way bf - if (rootElementName == null) { - rootElementName = tempTagName; - } - - Element tempElement = document.createElement(tempTagName); - - stillOpenElements.push(tempElement); - - super.startElement(aUri, aLocalName, aQualifiedName, anAttributes); - } - - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#endElement(String, String, String) - */ - public void endElement(String aUri, String aLocalName, String aQualifiedName) - throws SAXException { - - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("AntEditorSaxDefaultHandler.endElement(" +aUri+ ", " +aLocalName+ ", "+aQualifiedName+ ")", null); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ - } - - if(parsingFinished) { - return; - } - - // Checks whether we know the parent for sure - boolean tempParentKnown = checkForParentElement(); - - String tempTagName = aLocalName.length() > 0 ? aLocalName : aQualifiedName; - - if(!stillOpenElements.isEmpty()) { - Element tempLastStillOpenElement = (Element)stillOpenElements.peek(); - if(tempLastStillOpenElement != null && tempLastStillOpenElement.getTagName().equals(tempTagName)) { - stillOpenElements.pop(); - - if(!stillOpenElements.empty()) { - Element tempSecondLastStillOpenElement = (Element)stillOpenElements.peek(); - tempSecondLastStillOpenElement.appendChild(tempLastStillOpenElement); - } - if(tempParentKnown && parentElement != null && parentElement.getTagName().equals(tempTagName)) { - parsingFinished = true; - } - } - } - } - - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#setDocumentLocator(Locator) - */ - public void setDocumentLocator(Locator aLocator) { - locator = aLocator; - super.setDocumentLocator(aLocator); - } - - - /** - * Returns the parent element that has been determined during a prior - * parsing. - * <P> - * It is quite common that parsing stopped before the current cursor - * position. That happens when the parser finds an error within the parsed - * document before. In that case the parent element might be guessed to be - * the one that opened last. To tell the handler whether the parent should - * be guessed, <code>aGuessParentFlag</code> may be specified. - * - * @param aGuessParentFlag whether the parent should be guessed - * @return the parent element or <code>null</code> if not known. - */ - public Element getParentElement(boolean aGuessParentFlag) { - if(parentElement != null) { - return parentElement; - } - if(aGuessParentFlag) { - if(!stillOpenElements.empty()) { - return (Element)stillOpenElements.peek(); - } - } - return null; - } - - - /* (non-Javadoc) - * @see org.xml.sax.ErrorHandler#error(SAXParseException) - */ - public void error(SAXParseException anException) throws SAXException { - super.error(anException); - } - - /** - * We have to handle fatal errors. - * <P> - * They come up whenever we parse a not valid file, what we do all the time. - * Therefore a fatal error is nothing special for us. - * <P> - * Actually, we ignore all fatal errors for now. - * - * @see org.xml.sax.ErrorHandler#fatalError(SAXParseException) - */ - public void fatalError(SAXParseException anException) throws SAXException { - if(locator != null) { - // int tempLineNr = locator.getLineNumber() -1; - // int tempColumnNr = locator.getColumnNumber() -1; - // super.fatalError(anException); - } - } - - /** - * @see org.xml.sax.EntityResolver#resolveEntity(java.lang.String, java.lang.String) - */ - public InputSource resolveEntity(String publicId, String systemId) throws SAXException { - int index= systemId.indexOf(':'); - if (index > 0) { - //remove file: - systemId= systemId.substring(index+1, systemId.length()); - } - File resolvedFile= null; - IPath filePath= new Path(systemId); - IFile file = ResourcesPlugin.getWorkspace().getRoot().getFileForLocation(filePath); - if (file == null || !file.exists()) { - //relative path - try { - //this call is ok if mainFileContainer is null - resolvedFile= FileUtils.newFileUtils().resolveFile(mainFileContainer, systemId); - } catch (BuildException be) { - return null; - } - } else { - resolvedFile= file.getLocation().toFile(); - } - - if (resolvedFile != null && resolvedFile.exists()) { - try { - return new InputSource(new FileReader(resolvedFile)); - } catch (FileNotFoundException e) { - return null; - } - } - - return super.resolveEntity(publicId, systemId); - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorSourceViewerConfiguration.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorSourceViewerConfiguration.java deleted file mode 100644 index 2b2f8ac62..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/AntEditorSourceViewerConfiguration.java +++ /dev/null @@ -1,264 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import org.eclipse.jface.preference.IPreferenceStore; -import org.eclipse.jface.preference.PreferenceConverter; -import org.eclipse.jface.text.DefaultInformationControl; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.IInformationControl; -import org.eclipse.jface.text.IInformationControlCreator; -import org.eclipse.jface.text.ITextHover; -import org.eclipse.jface.text.TextAttribute; -import org.eclipse.jface.text.contentassist.ContentAssistant; -import org.eclipse.jface.text.contentassist.IContentAssistant; -import org.eclipse.jface.text.presentation.IPresentationReconciler; -import org.eclipse.jface.text.presentation.PresentationReconciler; -import org.eclipse.jface.text.reconciler.IReconciler; -import org.eclipse.jface.text.rules.DefaultDamagerRepairer; -import org.eclipse.jface.text.rules.Token; -import org.eclipse.jface.text.source.IAnnotationHover; -import org.eclipse.jface.text.source.ISourceViewer; -import org.eclipse.jface.text.source.SourceViewerConfiguration; -import org.eclipse.jface.util.PropertyChangeEvent; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Color; -import org.eclipse.swt.graphics.RGB; -import org.eclipse.swt.widgets.Shell; -import org.eclipse.ui.externaltools.internal.model.ColorManager; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; - -import org.eclipse.ui.externaltools.internal.ant.editor.derived.HTMLTextPresenter; -import org.eclipse.ui.externaltools.internal.ant.editor.text.XMLAnnotationHover; -import org.eclipse.ui.externaltools.internal.ant.editor.text.XMLTextHover; -import org.eclipse.ui.externaltools.internal.ant.editor.text.NonRuleBasedDamagerRepairer; -import org.eclipse.ui.externaltools.internal.ant.editor.text.IAntEditorColorConstants; -import org.eclipse.ui.externaltools.internal.ant.editor.text.NotifyingReconciler; -import org.eclipse.ui.externaltools.internal.ant.editor.text.AntEditorPartitionScanner; -import org.eclipse.ui.externaltools.internal.ant.editor.text.AntEditorProcInstrScanner; -import org.eclipse.ui.externaltools.internal.ant.editor.text.AntEditorTagScanner; -import org.eclipse.ui.externaltools.internal.ant.editor.text.XMLReconcilingStrategy; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntEditorPreferenceConstants; - -/** - * The source viewer configuration for the Ant Editor. - */ -public class AntEditorSourceViewerConfiguration extends SourceViewerConfiguration { - - private AntEditorTagScanner tagScanner; - private AntEditorProcInstrScanner instructionScanner; - private NonRuleBasedDamagerRepairer damageRepairer; - - private AntEditor fEditor; - - private XMLTextHover fTextHover; - - private ContentAssistant contentAssistant; - - /** - * Creates an instance with the specified color manager. - */ - public AntEditorSourceViewerConfiguration(AntEditor editor) { - super(); - fEditor= editor; - } - - /* (non-Javadoc) - * @see org.eclipse.jface.text.source.SourceViewerConfiguration#getContentAssistant(ISourceViewer) - */ - public IContentAssistant getContentAssistant(ISourceViewer sourceViewer) { - contentAssistant= new ContentAssistant(); - AntEditorCompletionProcessor processor = new AntEditorCompletionProcessor(); - contentAssistant.setContentAssistProcessor(processor, IDocument.DEFAULT_CONTENT_TYPE); - contentAssistant.setContentAssistProcessor(processor, AntEditorPartitionScanner.XML_TAG); - - IPreferenceStore store= ExternalToolsPlugin.getDefault().getPreferenceStore(); - - String triggers= store.getString(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_TRIGGERS); - if (triggers != null) { - processor.setCompletionProposalAutoActivationCharacters(triggers.toCharArray()); - } - - contentAssistant.enableAutoInsert(store.getBoolean(AntEditorPreferenceConstants.CODEASSIST_AUTOINSERT)); - contentAssistant.enableAutoActivation(store.getBoolean(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION)); - contentAssistant.setAutoActivationDelay(store.getInt(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_DELAY)); - contentAssistant.setProposalPopupOrientation(ContentAssistant.PROPOSAL_OVERLAY); - contentAssistant.setContextInformationPopupOrientation(ContentAssistant.CONTEXT_INFO_ABOVE); - contentAssistant.setInformationControlCreator(getInformationControlCreator(sourceViewer)); - - ColorManager manager= ColorManager.getDefault(); - Color background= getColor(store, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_BACKGROUND, manager); - contentAssistant.setContextInformationPopupBackground(background); - contentAssistant.setContextSelectorBackground(background); - contentAssistant.setProposalSelectorBackground(background); - - Color foreground= getColor(store, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_FOREGROUND, manager); - contentAssistant.setContextInformationPopupForeground(foreground); - contentAssistant.setContextSelectorForeground(foreground); - contentAssistant.setProposalSelectorForeground(foreground); - - IInformationControlCreator creator = getInformationControlCreator(true); - contentAssistant.setInformationControlCreator(creator); - - return contentAssistant; - } - - protected IContentAssistant getContentAssistant() { - return contentAssistant; - } - - protected IInformationControlCreator getInformationControlCreator(final boolean cutDown) { - return new IInformationControlCreator() { - public IInformationControl createInformationControl(Shell parent) { - int style= cutDown ? SWT.NONE : (SWT.V_SCROLL | SWT.H_SCROLL); - return new DefaultInformationControl(parent, style, new HTMLTextPresenter(cutDown)); - } - }; - } - - /* (non-Javadoc) - * Method declared on SourceViewerConfiguration - */ - public String[] getConfiguredContentTypes(ISourceViewer sourceViewer) { - return new String[] { - IDocument.DEFAULT_CONTENT_TYPE, - AntEditorPartitionScanner.XML_COMMENT, - AntEditorPartitionScanner.XML_TAG }; - } - - /** - * @return TAB_WIDTH - * @see SourceViewerConfiguration#getTabWidth(org.eclipse.jface.text.source.ISourceViewer) - */ - public int getTabWidth(ISourceViewer sourceViewer) { - return AntEditor.TAB_WIDTH; - } - - private AntEditorProcInstrScanner getDefaultScanner() { - if (instructionScanner == null) { - instructionScanner = new AntEditorProcInstrScanner(); - instructionScanner.setDefaultReturnToken( - new Token( - new TextAttribute(ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_DEFAULT)))); - } - return instructionScanner; - } - - private AntEditorTagScanner getTagScanner() { - if (tagScanner == null) { - tagScanner = new AntEditorTagScanner(); - tagScanner.setDefaultReturnToken( - new Token(new TextAttribute(ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_TAG)))); - } - return tagScanner; - } - - - public IPresentationReconciler getPresentationReconciler(ISourceViewer sourceViewer) { - PresentationReconciler reconciler = new PresentationReconciler(); - - DefaultDamagerRepairer dr = new DefaultDamagerRepairer(getDefaultScanner()); - reconciler.setDamager(dr, IDocument.DEFAULT_CONTENT_TYPE); - reconciler.setRepairer(dr, IDocument.DEFAULT_CONTENT_TYPE); - - dr = new DefaultDamagerRepairer(getTagScanner()); - reconciler.setDamager(dr, AntEditorPartitionScanner.XML_TAG); - reconciler.setRepairer(dr, AntEditorPartitionScanner.XML_TAG); - - damageRepairer= new NonRuleBasedDamagerRepairer( - new TextAttribute(ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_XML_COMMENT))); - reconciler.setDamager(damageRepairer, AntEditorPartitionScanner.XML_COMMENT); - reconciler.setRepairer(damageRepairer, AntEditorPartitionScanner.XML_COMMENT); - - return reconciler; - } - - - /** - * Preference colors have changed. - * Update the default tokens of the scanners. - */ - public void updateScanners() { - tagScanner.setDefaultReturnToken( - new Token(new TextAttribute(ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_TAG)))); - - instructionScanner.setDefaultReturnToken( - new Token( - new TextAttribute(ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_DEFAULT)))); - - damageRepairer.setDefaultTextAttribute(new TextAttribute(ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_XML_COMMENT))); - } - - /* - * @see SourceViewerConfiguration#getReconciler(ISourceViewer) - */ - public IReconciler getReconciler(ISourceViewer sourceViewer) { - NotifyingReconciler reconciler= new NotifyingReconciler(new XMLReconcilingStrategy(fEditor), false); - reconciler.setDelay(500); - return reconciler; - } - - /* - * @see org.eclipse.jface.text.source.SourceViewerConfiguration#getAnnotationHover(org.eclipse.jface.text.source.ISourceViewer) - */ - public IAnnotationHover getAnnotationHover(ISourceViewer sourceViewer) { - return new XMLAnnotationHover(); - } - - /* - * @see org.eclipse.jface.text.source.SourceViewerConfiguration#getInformationControlCreator(org.eclipse.jface.text.source.ISourceViewer) - */ - public IInformationControlCreator getInformationControlCreator(ISourceViewer sourceViewer) { - return getInformationControlCreator(true); - } - - /* - * @see org.eclipse.jface.text.source.SourceViewerConfiguration#getTextHover(org.eclipse.jface.text.source.ISourceViewer, java.lang.String) - */ - public ITextHover getTextHover(ISourceViewer sourceViewer, String contentType) { - if (fTextHover == null) { - fTextHover= new XMLTextHover(); - } - return fTextHover; - } - - private Color getColor(IPreferenceStore store, String key, ColorManager manager) { - RGB rgb= PreferenceConverter.getColor(store, key); - return manager.getColor(rgb); - } - - protected void changeConfiguration(PropertyChangeEvent event) { - IPreferenceStore store= ExternalToolsPlugin.getDefault().getPreferenceStore(); - String p= event.getProperty(); - - ColorManager manager= ColorManager.getDefault(); - if (AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION.equals(p)) { - boolean enabled= store.getBoolean(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION); - contentAssistant.enableAutoActivation(enabled); - } else if (AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_DELAY.equals(p)) { - int delay= store.getInt(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_DELAY); - contentAssistant.setAutoActivationDelay(delay); - } else if (AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_FOREGROUND.equals(p)) { - Color c= getColor(store, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_FOREGROUND, manager); - contentAssistant.setProposalSelectorForeground(c); - } else if (AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_BACKGROUND.equals(p)) { - Color c= getColor(store, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_BACKGROUND, manager); - contentAssistant.setProposalSelectorBackground(c); - } else if (AntEditorPreferenceConstants.CODEASSIST_AUTOINSERT.equals(p)) { - boolean enabled= store.getBoolean(AntEditorPreferenceConstants.CODEASSIST_AUTOINSERT); - contentAssistant.enableAutoInsert(enabled); - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/EnclosingTargetSearchingHandler.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/EnclosingTargetSearchingHandler.java deleted file mode 100644 index 6237426ef..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/EnclosingTargetSearchingHandler.java +++ /dev/null @@ -1,213 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import java.io.File; - -import javax.xml.parsers.ParserConfigurationException; - -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.w3c.dom.Element; -import org.xml.sax.Attributes; -import org.xml.sax.SAXException; - -/** - * SAX Parsing Handler that determines the enclosing target task element in - * respect to a specified cursor position. - * - * @version 19.11.2002 - * @author Alf Schiefelbein - */ -public class EnclosingTargetSearchingHandler extends AntEditorSaxDefaultHandler { - - /** - * Whether the enclosing target element has been determined. - * <P> - * This is the case if the method - * <code>determineEnclosingTargetTaskElement</code> has been called once. - */ - protected boolean enclosingTargetElementDetermined; - - /** - * Creates an EnclosingTargetSearchingHandler, with the specified parameters. - * - * @param aRowOfCursorPosition the startingRow where the cursor is located in the - * document. The first startingRow is refered to with an index of '0'. - * @param aColumnOfCursorPosition the startingColumn where the cursor is located in - * the document. The first startingColumn is refered to with an index of '0'. - */ - public EnclosingTargetSearchingHandler(File mainFileContainer, int aRowOfCursorPosition, int aColumnOfCursorPosition) throws ParserConfigurationException { - super(mainFileContainer, aRowOfCursorPosition, aColumnOfCursorPosition); - } - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#endElement(String, String, String) - */ - public void endElement(String aUri, String aLocalName, String aQualifiedName) - throws SAXException { - - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("AntEditorSaxDefaultHandler.endElement(" +aUri+ ", " +aLocalName+ ", "+aQualifiedName+ ")", null); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ - } - - if(parsingFinished) { - return; - } - - // Checks wether we know the parent for sure - boolean tempParentKnown = checkForParentElement(); - - String tempTagName = aLocalName.length() > 0 ? aLocalName : aQualifiedName; - - if(tempTagName.equals("target")) { //$NON-NLS-1$ - if(!stillOpenElements.isEmpty()) { - Element tempLastStillOpenElement = (Element)stillOpenElements.peek(); - if(tempLastStillOpenElement != null && tempLastStillOpenElement.getTagName().equals(tempTagName)) { - stillOpenElements.pop(); - - if(!stillOpenElements.empty()) { - Element tempSecondLastStillOpenElement = (Element)stillOpenElements.peek(); - tempSecondLastStillOpenElement.appendChild(tempLastStillOpenElement); - } - if(tempParentKnown && parentElement != null && parentElement.getTagName().equals(tempTagName)) { - parsingFinished = true; - } - } - } - } - } - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#startElement(String, String, String, Attributes) - */ - public void startElement( - String aUri, - String aLocalName, - String aQualifiedName, - Attributes anAttributes) - throws SAXException { - /* - * While the crimson parser passes the tag name as local name, apache's - * xerces parser, passes the tag name as qualilfied name and an empty - * string as local name. - */ - - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("AntEditorSaxDefaultHandler.startElement(" +aUri+ ", " +aLocalName+ ", "+aQualifiedName+ ", "+anAttributes+ ")", null); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ //$NON-NLS-5$ - } - if(parsingFinished) { - return; - } - - // Checks wether we know the parent for sure - checkForParentElement(); - - // Create a Dom Element - String tempTagName = aLocalName.length() > 0 ? aLocalName : aQualifiedName; - if(tempTagName == null || tempTagName.length() == 0) { - throw new AntEditorException(AntEditorMessages.getString("EnclosingTargetSearchingHandler.Error_parsing")); //$NON-NLS-1$ - } - - if(tempTagName.equals("target")) { //$NON-NLS-1$ - Element tempElement = document.createElement(tempTagName); - String tempTargetName = anAttributes.getValue("name"); //$NON-NLS-1$ - if(tempTargetName != null && tempTargetName.length() > 0) { - tempElement.setAttribute("name", tempTargetName); //$NON-NLS-1$ - } - stillOpenElements.push(tempElement); - } - } - - /** - * Checks whether the enclosing task element, that we are searching for can - * be or has already been determined. - * <P> - * This will be done by comparing the current parsing position with the - * cursor position. If we just passed the cursor position and the enclosing - * task element has not been set yet, it will be set. - * - * @return <code>true</code> if the enclosing task element is known - * otherwise <code>false</code> - */ - protected boolean checkForParentElement() { - if(parentElement == null && !enclosingTargetElementDetermined) { - if(locator != null) { - - /* - * The locator's numbers are 1-based though, we do everything - * 0-based. - */ - - int tempLineNr = locator.getLineNumber() -1; - int tempColumnNr = locator.getColumnNumber() -1; - if(tempLineNr> rowOfCursorPosition || - (tempLineNr == rowOfCursorPosition && tempColumnNr > columnOfCursorPosition)) { - determineEnclosingTargetTaskElement(); - return true; - } - } - return false; - } - - // Parent element has been set already before - return true; - } - - - /** - * Determines the enclosing target task element. - * <P> - * This Method shall only be called if the parser has passed the cursor - * position allready. - */ - protected void determineEnclosingTargetTaskElement() { - while(parentElement == null && !stillOpenElements.empty()) { - Element tempElement = (Element)stillOpenElements.pop(); - if(tempElement.getTagName().equals("target")) { //$NON-NLS-1$ - parentElement = tempElement; - if (ExternalToolsPlugin.getDefault() != null && ExternalToolsPlugin.getDefault().isDebugging()) { - ExternalToolsPlugin.getDefault().log("EnclosingTargetSearchingHandler.checkForParentElement(): Enclosing target element found: " +parentElement, null); //$NON-NLS-1$ - } - } - } - enclosingTargetElementDetermined = true; - } - - /** - * Returns the enclosing target task element that has been determined - * during a prior parsing. - * <P> - * It is quite common that parsing stopped before the current cursor - * position. That happens when the parser finds an error within the parsed - * document before. In that case the parent element might be guessed to be - * the one that opened last. To tell the handler wether the parent should - * be guessed, <code>aGuessParentFlag</code> may be specified. - * - * @param aGuessParentFlag wether the parent should be guessed - * @return the parent element or <code>null</code> if not known. - */ - public Element getParentElement(boolean aGuessParentFlag) { - if(enclosingTargetElementDetermined) { - return parentElement; - } - if(aGuessParentFlag) { - if(!stillOpenElements.empty()) { - determineEnclosingTargetTaskElement(); - return parentElement; - } - } - return null; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/TaskDescriptionProvider.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/TaskDescriptionProvider.java deleted file mode 100644 index 047083852..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/TaskDescriptionProvider.java +++ /dev/null @@ -1,414 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor; - -import java.io.IOException; -import java.net.URL; -import java.util.HashMap; -import java.util.Map; - -import javax.xml.parsers.DocumentBuilder; -import javax.xml.parsers.DocumentBuilderFactory; -import javax.xml.parsers.ParserConfigurationException; - -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.w3c.dom.Document; -import org.w3c.dom.Element; -import org.w3c.dom.NamedNodeMap; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; -import org.w3c.dom.Text; -import org.xml.sax.InputSource; -import org.xml.sax.SAXException; - -/** - * The <code>TaskDescriptionProvider</code> provides the additional descriptions - * for tasks and attributes for the code assist. - * <P> - * Descriptions for task are originally provided with the XML file - * <code>TASKS_DESCRIPTION_XML_FILE_NAME</code>. This file is parsed by the - * provider and requested descriptions are returned. - * <P> - * Check out the documentation for the public methods of this class. - * - * @author Alf Schiefelbein - * @author HJ - */ -public class TaskDescriptionProvider { - - /** - * The file that contains all task descriptions. - * <P> - * The value is "/anttasks_1.5b.xml". - */ - public static String TASKS_DESCRIPTION_XML_FILE_NAME = "/anttasks_1.5b.xml"; //$NON-NLS-1$ - - public static String XML_TAG_TASKS = "tasks"; //$NON-NLS-1$ - public static String XML_TAG_TASK = "task"; //$NON-NLS-1$ - public static String XML_TAG_ELEMENTS = "elements"; //$NON-NLS-1$ - public static String XML_TAG_ATTRIBUTE = "attribute"; //$NON-NLS-1$ - public static String XML_TAG_ATTRIBUTES = "attributes"; //$NON-NLS-1$ - public static String XML_TAG_ELEMENT = "element"; //$NON-NLS-1$ - public static String XML_TAG_STRUCTURE = "structure"; //$NON-NLS-1$ - public static String XML_TAG_DESCRIPTION = "short-description"; //$NON-NLS-1$ - public static String XML_ATTRIBUTE_NAME = "name"; //$NON-NLS-1$ - public static String XML_ATTRIBUTE_REQUIRED = "required"; //$NON-NLS-1$ - - - protected Map taskNodes = new HashMap(); - - - /** - * Creates an initialized instance. - */ - public TaskDescriptionProvider() { - initialize(); - } - - - /** - * Parses the task description xml file and stores the information. - */ - protected void initialize() { - Document tempDocument = parseFile(TASKS_DESCRIPTION_XML_FILE_NAME); - Node tempRootNode = tempDocument.getDocumentElement(); - NodeList tempChildNodes = tempRootNode.getChildNodes(); - for(int i=0; i<tempChildNodes.getLength(); i++) { - Node tempNode = tempChildNodes.item(i); - if(tempNode.getNodeType() == Node.ELEMENT_NODE) { - String tempTagName = tempNode.getNodeName(); - if(tempTagName.equals(XML_TAG_TASK)) { - NamedNodeMap tempAttributes = tempNode.getAttributes(); - Node tempAttributeNode = tempAttributes.getNamedItem(XML_ATTRIBUTE_NAME); - if(tempAttributeNode != null) { - String tempTaskName = tempAttributeNode.getNodeValue(); - if(tempTaskName != null) { - taskNodes.put(tempTaskName, tempNode); - } - } - } - } - } - } - - - /** - * Returns the (DOM) document as a result of parsing the file with the - * specified file name. - * <P> - * The file will be loaded as resource, thus must begin with '/' and must - * be relative to the classpath. - */ - protected Document parseFile(String aFileName) { - Document tempDocument = null; - - DocumentBuilderFactory tempFactory = DocumentBuilderFactory.newInstance(); - tempFactory.setIgnoringComments(true); - tempFactory.setIgnoringElementContentWhitespace(true); - tempFactory.setCoalescing(true); - - try { - DocumentBuilder tempDocBuilder = tempFactory.newDocumentBuilder(); - URL tempURL = getClass().getResource(aFileName); - InputSource tempInputSource = new InputSource(tempURL.toExternalForm()); - tempDocument = tempDocBuilder.parse(tempInputSource); - } catch (ParserConfigurationException e) { - ExternalToolsPlugin.getDefault().log(e); - } - catch (IOException ioException) { - ExternalToolsPlugin.getDefault().log(ioException); - } - catch (SAXException saxException) { - ExternalToolsPlugin.getDefault().log(saxException); - } - - return tempDocument; - } - - /** - * Returns the description string for the specified task. - * - * @return description string or <code>null</code> if task not known or - * no description available. - */ - public String getDescriptionForTask(String aTaskName) { - Element tempTaskElement = (Element)taskNodes.get(aTaskName); - if(tempTaskElement != null) { - return getDescriptionOfNode(tempTaskElement); - } - return null; - } - - - /** - * Returns the description of the specified node. - * <P> - * The node must be either one of task node or attribute node. - */ - protected String getDescriptionOfNode(Node aNode) { - NodeList tempChildNodes = aNode.getChildNodes(); - for (int i=0; i<tempChildNodes.getLength(); i++) { - Node tempNode = (Node) tempChildNodes.item(i); - if(tempNode instanceof Element && XML_TAG_DESCRIPTION.equals(tempNode.getNodeName())) { - Element tempDescriptionElement = (Element)tempNode; - Node tempChildNode = tempDescriptionElement.getFirstChild(); - if(tempChildNode instanceof Text) { - return ((Text)tempChildNode).getData(); - } - break; - } - } - return null; - } - - /** - * Returns the Required value of the specified node. - * <P> - * Currently the XML file has Required defined as NOTDEFINED in - * some cases. If so the value returned is an empty string - */ - protected String getRequiredOfNode(Node aNode) { - - String tmpNodeName = aNode.getNodeName(); - String tmpRequiredValue = null; - - if(aNode.getNodeType() == Node.ELEMENT_NODE && - (XML_TAG_ATTRIBUTE.equals(tmpNodeName) || XML_TAG_ELEMENT.equals(tmpNodeName)) ) { - - tmpRequiredValue = aNode.getAttributes().getNamedItem(XML_ATTRIBUTE_REQUIRED).getNodeValue(); - } - - if(tmpRequiredValue.equals("NOTDEFINED")) { //$NON-NLS-1$ - return ""; //$NON-NLS-1$ - } - - return tmpRequiredValue; - - } - - - /** - * Returns the description string for the specified attribute of the the - * specified task. - * - * @return description string or <code>null</code> if task or attribute - * not known or no description available. - */ - public String getDescriptionForTaskAttribute(String aTaskName, String anAttributeName) { - - String tmpDescription = null; - - Node tmpAttributesNode = getAttributesNode(aTaskName); - - if(tmpAttributesNode != null) { - - tmpDescription = getDescriptionForNodeNamedWithNameInNodeList( XML_TAG_ATTRIBUTE, anAttributeName, - tmpAttributesNode.getChildNodes()); - //If Description is null we try the elements section else we're satisfied. - if( tmpDescription != null ) { - return tmpDescription; - } - } - //Not yet found. Try the elements Node - tmpAttributesNode = getElementsNode(aTaskName); - if(tmpAttributesNode != null) { - tmpDescription = getDescriptionForNodeNamedWithNameInNodeList( XML_TAG_ELEMENT, anAttributeName, - tmpAttributesNode.getChildNodes()); - - return tmpDescription; - - } - return null; - } - - /** - * Returns the required string value for the specified attribute of the - * specified task. - * - * @return required string or <code>null</code> if task or attribute not - * known or no description available. - */ - public String getRequiredAttributeForTaskAttribute(String aTaskName, String anAttributeName) { - - String tmpRequired = null; - - Node tmpAttributesNode = getAttributesNode(aTaskName); - - if(tmpAttributesNode != null) { - - tmpRequired = getRequiredForNodeNamedWithNameInNodeList( XML_TAG_ATTRIBUTE, anAttributeName, - tmpAttributesNode.getChildNodes()); - - //If Required is null we try the elements section else we're satisfied. - if( tmpRequired != null ) { - return tmpRequired; - } - } - - //Not yet found. Try the elements Node - tmpAttributesNode = getElementsNode(aTaskName); - if(tmpAttributesNode != null) { - tmpRequired = getDescriptionForNodeNamedWithNameInNodeList( XML_TAG_ELEMENT, anAttributeName, - tmpAttributesNode.getChildNodes()); - //Return it even if its null - return tmpRequired; - - } - - //Not found return null - return null; - } - - /** - * Returns the Elements Node of the specified TaskName - * - * @param aTaskName The name of the task - * @param return The Elements Node of the Task. - */ - protected Node getElementsNode(String aTaskName) { - - Node tmpStructureNode = getStructureNode(aTaskName); - if(tmpStructureNode != null) { - return getChildNodeNamedOfTypeFromNode(XML_TAG_ELEMENTS, Node.ELEMENT_NODE, - tmpStructureNode); - } - else { - return null; - } - } - - /** - * Returns the Attributes Node of the specified TaskName - * - * @param aTaskName The name of the task - * @param return The Attributes Node of the Task. - */ - protected Node getAttributesNode(String aTaskName) { - - Node tmpStructureNode = getStructureNode(aTaskName); - if(tmpStructureNode != null){ - return getChildNodeNamedOfTypeFromNode(XML_TAG_ATTRIBUTES, Node.ELEMENT_NODE, - tmpStructureNode); - } - else { - return null; - } - - } - - /** - * Returns the Structure Node of the specified TaskName - * - * @param aTaskName The name of the task - * @param return The Structure Node of the Task. - */ - protected Node getStructureNode(String aTaskName) { - Element tempTaskElement = (Element)taskNodes.get(aTaskName); - if(tempTaskElement != null) { - //Dig us down to the Structure node - Node tmpStructureNode = getChildNodeNamedOfTypeFromNode(XML_TAG_STRUCTURE, Node.ELEMENT_NODE, - tempTaskElement); - return tmpStructureNode; - } - else { - return null; - } - } - - /** - * Returns the Description for a Node satisfying the criterias in the - * NodeList given as Argument. - * - * @param aNodeName The Name of the Node - * @param anAttributeName The string of the Name value - * @param anAttributesNodeList The NodeList to search in. - * @return The Description found or null if none is found - */ - protected String getDescriptionForNodeNamedWithNameInNodeList( String aNodeName, String anAttributeName, - NodeList anAttributesNodeList) { - for (int i=0; i<anAttributesNodeList.getLength(); i++) { - Node tempNode = (Node) anAttributesNodeList.item(i); - if(tempNode.getNodeType() == Node.ELEMENT_NODE && aNodeName.equals(tempNode.getNodeName())) { - if( anAttributeName.equals(getTaskAttributeName(tempNode)) ) { - return getDescriptionOfNode(tempNode); - } - } - } - - //Not found - return null; - } - - - /** - * Returns the Name of Task Attribute. - * - * @return The Name of the Attribute. - */ - public String getTaskAttributeName(Node aTaskAttributeNode) { - NamedNodeMap tmpNamedNodeMap = aTaskAttributeNode.getAttributes(); - return tmpNamedNodeMap.getNamedItem(XML_ATTRIBUTE_NAME).getNodeValue(); - } - - /** - * Returns the ChildNode of the node defined by the Arguments. The - * first child found matching the criterias is returned. - * - * @param aNodeName The Name of the Node to return. - * @param aType The Type of the node @see Node - * @param aParentNode The Node to get the child from - * - * @return The First Child Node found matching the criterias, - * or null if none is found. - */ - protected Node getChildNodeNamedOfTypeFromNode(String aNodeName, short aNodeType, Node aParentNode) { - - NodeList tmpNodeList = aParentNode.getChildNodes(); - for(int i=0; i<tmpNodeList.getLength(); ++i ) { - Node tmpNode = tmpNodeList.item(i); - if( (tmpNode.getNodeType() == aNodeType) && aNodeName.equals(tmpNode.getNodeName()) ) { - return tmpNode; - } - } - //Not found - return null; - } - - /** - * Returns the Required Field for a Node satisfying the criterias in the - * NodeList given as Argument. - * - * @param aNodeName The Name of the Node - * @param anAttributeName The string of the Name value - * @param anAttributesNodeList The NodeList to search in. - * @return The Description found or null if none is found - */ - protected String getRequiredForNodeNamedWithNameInNodeList( String aNodeName, String anAttributeName, - NodeList anAttributesNodeList) { - for (int i=0; i<anAttributesNodeList.getLength(); i++) { - Node tempNode = (Node) anAttributesNodeList.item(i); - if(tempNode.getNodeType() == Node.ELEMENT_NODE && aNodeName.equals(tempNode.getNodeName())) { - if( anAttributeName.equals(getTaskAttributeName(tempNode)) ) { - return getRequiredOfNode(tempNode); - } - } - } - - //Not found - return null; - } - - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTML2TextReader.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTML2TextReader.java deleted file mode 100644 index 9fdd82686..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTML2TextReader.java +++ /dev/null @@ -1,297 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.derived; - - -import java.io.IOException; -import java.io.PushbackReader; -import java.io.Reader; -import java.util.HashMap; -import java.util.HashSet; -import java.util.Map; -import java.util.Set; - -import org.eclipse.jface.text.TextPresentation; -import org.eclipse.swt.SWT; -import org.eclipse.swt.custom.StyleRange; - -/** - * Reads the text contents from a reader of HTML contents and translates - * the tags or cut them out. - * - * @see org.eclipse.jdt.internal.ui.text.HTML2TextReader - */ -public class HTML2TextReader extends SubstitutionTextReader { - - - private static final String LINE_DELIM= System.getProperty("line.separator", "\n"); //$NON-NLS-1$ //$NON-NLS-2$ - private static final String EMPTY_STRING= ""; //$NON-NLS-1$ - private static final Map fgEntityLookup; - private static final Set fgTags; - - static { - - fgTags= new HashSet(); - fgTags.add("b"); //$NON-NLS-1$ - fgTags.add("br"); //$NON-NLS-1$ - fgTags.add("h5"); //$NON-NLS-1$ - fgTags.add("p"); //$NON-NLS-1$ - fgTags.add("dl"); //$NON-NLS-1$ - fgTags.add("dt"); //$NON-NLS-1$ - fgTags.add("dd"); //$NON-NLS-1$ - fgTags.add("li"); //$NON-NLS-1$ - fgTags.add("ul"); //$NON-NLS-1$ - fgTags.add("pre"); //$NON-NLS-1$ - - fgEntityLookup= new HashMap(7); - fgEntityLookup.put("lt", "<"); //$NON-NLS-1$ //$NON-NLS-2$ - fgEntityLookup.put("gt", ">"); //$NON-NLS-1$ //$NON-NLS-2$ - fgEntityLookup.put("nbsp", " "); //$NON-NLS-1$ //$NON-NLS-2$ - fgEntityLookup.put("amp", "&"); //$NON-NLS-1$ //$NON-NLS-2$ - fgEntityLookup.put("circ", "^"); //$NON-NLS-1$ //$NON-NLS-2$ - fgEntityLookup.put("tilde", "~"); //$NON-NLS-2$ //$NON-NLS-1$ - fgEntityLookup.put("quot", "\""); //$NON-NLS-1$ //$NON-NLS-2$ - } - - private int fCounter= 0; - private TextPresentation fTextPresentation; - private int fBold= 0; - private int fStartOffset= -1; - private boolean fInParagraph= false; - private boolean fIsPreformattedText= false; - - /** - * Transforms the html text from the reader to formatted text. - * @param presentation If not <code>null</code>, formattings will be applied to - * the presentation. - */ - public HTML2TextReader(Reader reader, TextPresentation presentation) { - super(new PushbackReader(reader)); - fTextPresentation= presentation; - } - - public int read() throws IOException { - int c= super.read(); - if (c != -1) - ++ fCounter; - return c; - } - - protected void startBold() { - if (fBold == 0) - fStartOffset= fCounter; - ++ fBold; - } - - protected void startPreformattedText() { - fIsPreformattedText= true; - setSkipWhitespace(false); - } - - protected void stopPreformattedText() { - fIsPreformattedText= false; - setSkipWhitespace(true); - } - - protected void stopBold() { - -- fBold; - if (fBold == 0) { - if (fTextPresentation != null) { - fTextPresentation.addStyleRange(new StyleRange(fStartOffset, fCounter - fStartOffset, null, null, SWT.BOLD)); - } - fStartOffset= -1; - } - } - - /** - * @see SubstitutionTextReader#computeSubstitution(char) - */ - protected String computeSubstitution(int c) throws IOException { - - if (c == '<') - return processHTMLTag(); - else if (c == '&') - return processEntity(); - else if (fIsPreformattedText) - return processPreformattedText(c); - - return null; - } - - private String html2Text(String html) { - - String tag= html; - if ('/' == tag.charAt(0)) - tag= tag.substring(1); - - if (!fgTags.contains(tag)) - return EMPTY_STRING; - - - if ("pre".equals(html)) { //$NON-NLS-1$ - startPreformattedText(); - return EMPTY_STRING; - } - - if ("/pre".equals(html)) { //$NON-NLS-1$ - stopPreformattedText(); - return EMPTY_STRING; - } - - if (fIsPreformattedText) - return EMPTY_STRING; - - if ("b".equals(html)) { //$NON-NLS-1$ - startBold(); - return EMPTY_STRING; - } - - if ("h5".equals(html) || "dt".equals(html)) { //$NON-NLS-1$ //$NON-NLS-2$ - startBold(); - return EMPTY_STRING; - } - - if ("dl".equals(html)) //$NON-NLS-1$ - return LINE_DELIM; - - if ("dd".equals(html)) //$NON-NLS-1$ - return "\t"; //$NON-NLS-1$ - - if ("li".equals(html)) //$NON-NLS-1$ - return LINE_DELIM + "\t-"; //$NON-NLS-1$ - - if ("/b".equals(html)) { //$NON-NLS-1$ - stopBold(); - return EMPTY_STRING; - } - - if ("p".equals(html)) { //$NON-NLS-1$ - fInParagraph= true; - return LINE_DELIM; - } - - if ("br".equals(html)) //$NON-NLS-1$ - return LINE_DELIM; - - if ("/p".equals(html)) { //$NON-NLS-1$ - boolean inParagraph= fInParagraph; - fInParagraph= false; - return inParagraph ? EMPTY_STRING : LINE_DELIM; - } - - if ("/h5".equals(html) || "/dt".equals(html)) { //$NON-NLS-1$ //$NON-NLS-2$ - stopBold(); - return LINE_DELIM; - } - - if ("/dd".equals(html)) //$NON-NLS-1$ - return LINE_DELIM; - - return EMPTY_STRING; - } - - /* - * A '<' has been read. Process a html tag - */ - private String processHTMLTag() throws IOException { - - StringBuffer buf= new StringBuffer(); - int ch; - do { - - ch= nextChar(); - - while (ch != -1 && ch != '>') { - buf.append(Character.toLowerCase((char) ch)); - ch= nextChar(); - if (ch == '"'){ - buf.append(Character.toLowerCase((char) ch)); - ch= nextChar(); - while (ch != -1 && ch != '"'){ - buf.append(Character.toLowerCase((char) ch)); - ch= nextChar(); - } - } - if (ch == '<'){ - unread(ch); - return '<' + buf.toString(); - } - } - - if (ch == -1) - return null; - - int tagLen= buf.length(); - // needs special treatment for comments - if ((tagLen >= 3 && "!--".equals(buf.substring(0, 3))) //$NON-NLS-1$ - && !(tagLen >= 5 && "--!".equals(buf.substring(tagLen - 3)))) { //$NON-NLS-1$ - // unfinished comment - buf.append(ch); - } else { - break; - } - } while (true); - - return html2Text(buf.toString()); - } - - private String processPreformattedText(int c) { - if (c == '\r' || c == '\n') - fCounter++; - return null; - } - - - private void unread(int ch) throws IOException { - ((PushbackReader) getReader()).unread(ch); - } - - protected String entity2Text(String symbol) { - if (symbol.length() > 1 && symbol.charAt(0) == '#') { - int ch; - try { - if (symbol.charAt(1) == 'x') { - ch= Integer.parseInt(symbol.substring(2), 16); - } else { - ch= Integer.parseInt(symbol.substring(1), 10); - } - return EMPTY_STRING + (char)ch; - } catch (NumberFormatException e) { - } - } else { - String str= (String) fgEntityLookup.get(symbol); - if (str != null) { - return str; - } - } - return "&" + symbol; // not found //$NON-NLS-1$ - } - - /* - * A '&' has been read. Process a entity - */ - private String processEntity() throws IOException { - StringBuffer buf= new StringBuffer(); - int ch= nextChar(); - while (Character.isLetterOrDigit((char)ch) || ch == '#') { - buf.append((char) ch); - ch= nextChar(); - } - - if (ch == ';') - return entity2Text(buf.toString()); - - buf.insert(0, '&'); - if (ch != -1) - buf.append((char) ch); - return buf.toString(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTMLPrinter.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTMLPrinter.java deleted file mode 100644 index ec204c277..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTMLPrinter.java +++ /dev/null @@ -1,118 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.derived; - - -import java.io.IOException; -import java.io.Reader; - - -/** - * Provides a set of convenience methods for creating HTML pages. - * - * @see org.eclipse.jdt.internal.ui.text.HTMLPrinter - */ -public class HTMLPrinter { - - private HTMLPrinter() { - } - - private static String replace(String text, char c, String s) { - - int previous= 0; - int current= text.indexOf(c, previous); - - if (current == -1) - return text; - - StringBuffer buffer= new StringBuffer(); - while (current > -1) { - buffer.append(text.substring(previous, current)); - buffer.append(s); - previous= current + 1; - current= text.indexOf(c, previous); - } - buffer.append(text.substring(previous)); - - return buffer.toString(); - } - - public static String convertToHTMLContent(String content) { - content= replace(content, '<', "<"); //$NON-NLS-1$ - return replace(content, '>', ">"); //$NON-NLS-1$ - } - - public static String read(Reader rd) { - - StringBuffer buffer= new StringBuffer(); - char[] readBuffer= new char[2048]; - - try { - int n= rd.read(readBuffer); - while (n > 0) { - buffer.append(readBuffer, 0, n); - n= rd.read(readBuffer); - } - return buffer.toString(); - } catch (IOException x) { - } - - return null; - } - - public static void insertPageProlog(StringBuffer buffer, int position) { - buffer.insert(position, "<html><body text=\"#000000\" bgcolor=\"#FFFF88\"><font size=-1>"); //$NON-NLS-1$ - } - - public static void addPageProlog(StringBuffer buffer) { - insertPageProlog(buffer, buffer.length()); - } - - public static void addPageEpilog(StringBuffer buffer) { - buffer.append("</font></body></html>"); //$NON-NLS-1$ - } - - public static void startBulletList(StringBuffer buffer) { - buffer.append("<ul>"); //$NON-NLS-1$ - } - - public static void endBulletList(StringBuffer buffer) { - buffer.append("</ul>"); //$NON-NLS-1$ - } - - public static void addBullet(StringBuffer buffer, String bullet) { - if (bullet != null) { - buffer.append("<li>"); //$NON-NLS-1$ - buffer.append(bullet); - buffer.append("</li>"); //$NON-NLS-1$ - } - } - - public static void addSmallHeader(StringBuffer buffer, String header) { - if (header != null) { - buffer.append("<h5>"); //$NON-NLS-1$ - buffer.append(header); - buffer.append("</h5>"); //$NON-NLS-1$ - } - } - - public static void addParagraph(StringBuffer buffer, String paragraph) { - if (paragraph != null) { - buffer.append("<p>"); //$NON-NLS-1$ - buffer.append(paragraph); - } - } - - public static void addParagraph(StringBuffer buffer, Reader paragraphReader) { - if (paragraphReader != null) - addParagraph(buffer, read(paragraphReader)); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTMLTextPresenter.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTMLTextPresenter.java deleted file mode 100644 index 9d03b44d5..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/HTMLTextPresenter.java +++ /dev/null @@ -1,191 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.derived; - - -import java.io.IOException; -import java.io.Reader; -import java.io.StringReader; -import java.util.Iterator; - -import org.eclipse.jface.text.DefaultInformationControl; -import org.eclipse.jface.text.Region; -import org.eclipse.jface.text.TextPresentation; -import org.eclipse.swt.custom.StyleRange; -import org.eclipse.swt.graphics.GC; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; - -/** - * * @see org.eclipse.jdt.internal.ui.text.HTMLPresenter - */ -public class HTMLTextPresenter implements DefaultInformationControl.IInformationPresenter { - - private static final String LINE_DELIM= System.getProperty("line.separator", "\n"); //$NON-NLS-1$ //$NON-NLS-2$ - - private int fCounter; - private boolean fEnforceUpperLineLimit; - - public HTMLTextPresenter(boolean enforceUpperLineLimit) { - super(); - fEnforceUpperLineLimit= enforceUpperLineLimit; - } - - public HTMLTextPresenter() { - this(true); - } - - protected Reader createReader(String hoverInfo, TextPresentation presentation) { - return new HTML2TextReader(new StringReader(hoverInfo), presentation); - } - - protected void adaptTextPresentation(TextPresentation presentation, int offset, int insertLength) { - - int yoursStart= offset; - int yoursEnd= offset + insertLength -1; - yoursEnd= Math.max(yoursStart, yoursEnd); - - Iterator e= presentation.getAllStyleRangeIterator(); - while (e.hasNext()) { - - StyleRange range= (StyleRange) e.next(); - - int myStart= range.start; - int myEnd= range.start + range.length -1; - myEnd= Math.max(myStart, myEnd); - - if (myEnd < yoursStart) - continue; - - if (myStart < yoursStart) - range.length += insertLength; - else - range.start += insertLength; - } - } - - private void append(StringBuffer buffer, String string, TextPresentation presentation) { - - int length= string.length(); - buffer.append(string); - - if (presentation != null) - adaptTextPresentation(presentation, fCounter, length); - - fCounter += length; - } - - private String getIndent(String line) { - int length= line.length(); - - int i= 0; - while (i < length && Character.isWhitespace(line.charAt(i))) ++i; - - return (i == length ? line : line.substring(0, i)) + " "; //$NON-NLS-1$ - } - - /* - * @see IHoverInformationPresenter#updatePresentation(Display display, String, TextPresentation, int, int) - */ - public String updatePresentation(Display display, String hoverInfo, TextPresentation presentation, int maxWidth, int maxHeight) { - - if (hoverInfo == null) - return null; - - GC gc= new GC(display); - try { - - StringBuffer buffer= new StringBuffer(); - int maxNumberOfLines= Math.round(maxHeight / gc.getFontMetrics().getHeight()); - - fCounter= 0; - LineBreakingReader reader= new LineBreakingReader(createReader(hoverInfo, presentation), gc, maxWidth); - - boolean lastLineFormatted= false; - String lastLineIndent= null; - - String line=reader.readLine(); - boolean lineFormatted= reader.isFormattedLine(); - boolean firstLineProcessed= false; - - while (line != null) { - - if (fEnforceUpperLineLimit && maxNumberOfLines <= 0) - break; - - if (firstLineProcessed) { - if (!lastLineFormatted) - append(buffer, LINE_DELIM, null); - else { - append(buffer, LINE_DELIM, presentation); - if (lastLineIndent != null) - append(buffer, lastLineIndent, presentation); - } - } - - append(buffer, line, null); - firstLineProcessed= true; - - lastLineFormatted= lineFormatted; - if (!lineFormatted) - lastLineIndent= null; - else if (lastLineIndent == null) - lastLineIndent= getIndent(line); - - line= reader.readLine(); - lineFormatted= reader.isFormattedLine(); - - maxNumberOfLines--; - } - - if (line != null) { - append(buffer, LINE_DELIM, lineFormatted ? presentation : null); - append(buffer, "...", presentation); //$NON-NLS-1$ - } - - return trim(buffer, presentation); - - } catch (IOException e) { - - ExternalToolsPlugin.getDefault().log(e); - return null; - - } finally { - gc.dispose(); - } - } - - private String trim(StringBuffer buffer, TextPresentation presentation) { - - int length= buffer.length(); - - int end= length -1; - while (end >= 0 && Character.isWhitespace(buffer.charAt(end))) - -- end; - - if (end == -1) - return ""; //$NON-NLS-1$ - - if (end < length -1) - buffer.delete(end + 1, length); - else - end= length; - - int start= 0; - while (start < end && Character.isWhitespace(buffer.charAt(start))) - ++ start; - - buffer.delete(0, start); - presentation.setResultWindow(new Region(start, buffer.length())); - return buffer.toString(); - } -} - diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/LineBreakingReader.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/LineBreakingReader.java deleted file mode 100644 index 4ba6344b4..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/LineBreakingReader.java +++ /dev/null @@ -1,115 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.derived; - - -import java.io.BufferedReader; -import java.io.IOException; -import java.io.Reader; -import java.text.BreakIterator; - -import org.eclipse.swt.graphics.GC; - -/** - * Not a real reader. Could change if requested - * @see org.eclipse.jdt.internal.ui.text.LineBreakingReader - */ -public class LineBreakingReader { - - private BufferedReader fReader; - private GC fGC; - private int fMaxWidth; - - private String fLine; - private int fOffset; - - private BreakIterator fLineBreakIterator; - - /** - * Creates a reader that breaks an input text to fit in a given width. - * @param reader Reader of the input text - * @param gc The graphic context that defines the currently used font sizes - * @param maxLineWidth The max width (pixes) where the text has to fit in - */ - public LineBreakingReader(Reader reader, GC gc, int maxLineWidth) { - fReader= new BufferedReader(reader); - fGC= gc; - fMaxWidth= maxLineWidth; - fOffset= 0; - fLine= null; - fLineBreakIterator= BreakIterator.getLineInstance(); - } - - public boolean isFormattedLine() { - return fLine != null; - } - - /** - * Reads the next line. The lengths of the line will not exceed the gived maximum - * width. - */ - public String readLine() throws IOException { - if (fLine == null) { - String line= fReader.readLine(); - if (line == null) - return null; - - int lineLen= fGC.textExtent(line).x; - if (lineLen < fMaxWidth) { - return line; - } - fLine= line; - fLineBreakIterator.setText(line); - fOffset= 0; - } - int breakOffset= findNextBreakOffset(fOffset); - String res; - if (breakOffset != BreakIterator.DONE) { - res= fLine.substring(fOffset, breakOffset); - fOffset= findWordBegin(breakOffset); - if (fOffset == fLine.length()) { - fLine= null; - } - } else { - res= fLine.substring(fOffset); - fLine= null; - } - return res; - } - - private int findNextBreakOffset(int currOffset) { - int currWidth= 0; - int nextOffset= fLineBreakIterator.following(currOffset); - while (nextOffset != BreakIterator.DONE) { - String word= fLine.substring(currOffset, nextOffset); - int wordWidth= fGC.textExtent(word).x; - int nextWidth= wordWidth + currWidth; - if (nextWidth > fMaxWidth) { - if (currWidth > 0) { - return currOffset; - } else { - return nextOffset; - } - } - currWidth= nextWidth; - currOffset= nextOffset; - nextOffset= fLineBreakIterator.next(); - } - return nextOffset; - } - - private int findWordBegin(int idx) { - while (idx < fLine.length() && Character.isWhitespace(fLine.charAt(idx))) { - idx++; - } - return idx; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/SingleCharReader.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/SingleCharReader.java deleted file mode 100644 index 98d52ced3..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/SingleCharReader.java +++ /dev/null @@ -1,64 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.derived; - - -import java.io.IOException; -import java.io.Reader; - -/** - * @see org.eclipse.jdt.internal.corext.javadoc.SingleCharReader - */ -public abstract class SingleCharReader extends Reader { - - /** - * @see Reader#read() - */ - public abstract int read() throws IOException; - - /** - * @see Reader#read(char[],int,int) - */ - public int read(char cbuf[], int off, int len) throws IOException { - int end= off + len; - for (int i= off; i < end; i++) { - int ch= read(); - if (ch == -1) { - if (i == off) { - return -1; - } else { - return i - off; - } - } - cbuf[i]= (char)ch; - } - return len; - } - - /** - * @see Reader#ready() - */ - public boolean ready() throws IOException { - return true; - } - - /** - * Gets the content as a String - */ - public String getString() throws IOException { - StringBuffer buf= new StringBuffer(); - int ch; - while ((ch= read()) != -1) { - buf.append((char)ch); - } - return buf.toString(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/SubstitutionTextReader.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/SubstitutionTextReader.java deleted file mode 100644 index d2a61bcad..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/derived/SubstitutionTextReader.java +++ /dev/null @@ -1,153 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.derived; - - - -import java.io.IOException; -import java.io.Reader; - - -/** - * Reads the text contents from a reader and computes for each character - * a potential substitution. The substitution may eat more characters than - * only the one passed into the computation routine. - * - * @see org.eclipse.jdt.internal.ui.text.SubstitutionTextReader - */ -public abstract class SubstitutionTextReader extends SingleCharReader { - - protected static final String LINE_DELIM= System.getProperty("line.separator", "\n"); //$NON-NLS-1$ //$NON-NLS-2$ - - private Reader fReader; - private boolean fWasWhiteSpace; - private int fCharAfterWhiteSpace; - - /** - * Tells whether white space characters are skipped. - */ - private boolean fSkipWhiteSpace= true; - - private boolean fReadFromBuffer; - private StringBuffer fBuffer; - private int fIndex; - - - protected SubstitutionTextReader(Reader reader) { - fReader= reader; - fBuffer= new StringBuffer(); - fIndex= 0; - fReadFromBuffer= false; - fCharAfterWhiteSpace= -1; - fWasWhiteSpace= true; - } - - /** - * Implement to compute the substitution for the given character and - * if necessary subsequent characters. Use <code>nextChar</code> - * to read subsequent characters. - */ - protected abstract String computeSubstitution(int c) throws IOException; - - /** - * Returns the internal reader. - */ - protected Reader getReader() { - return fReader; - } - - /** - * Returns the next character. - */ - protected int nextChar() throws IOException { - fReadFromBuffer= (fBuffer.length() > 0); - if (fReadFromBuffer) { - char ch= fBuffer.charAt(fIndex++); - if (fIndex >= fBuffer.length()) { - fBuffer.setLength(0); - fIndex= 0; - } - return ch; - } else { - int ch= fCharAfterWhiteSpace; - if (ch == -1) { - ch= fReader.read(); - } - if (fSkipWhiteSpace && Character.isWhitespace((char)ch)) { - do { - ch= fReader.read(); - } while (Character.isWhitespace((char)ch)); - if (ch != -1) { - fCharAfterWhiteSpace= ch; - return ' '; - } - } else { - fCharAfterWhiteSpace= -1; - } - return ch; - } - } - - /** - * @see Reader#read() - */ - public int read() throws IOException { - int c; - do { - - c= nextChar(); - while (!fReadFromBuffer) { - String s= computeSubstitution(c); - if (s == null) - break; - if (s.length() > 0) - fBuffer.insert(0, s); - c= nextChar(); - } - - } while (fSkipWhiteSpace && fWasWhiteSpace && (c == ' ')); - fWasWhiteSpace= (c == ' ' || c == '\r' || c == '\n'); - return c; - } - - /** - * @see Reader#ready() - */ - public boolean ready() throws IOException { - return fReader.ready(); - } - - /** - * @see Reader#close() - */ - public void close() throws IOException { - fReader.close(); - } - - /** - * @see Reader#reset() - */ - public void reset() throws IOException { - fReader.reset(); - fWasWhiteSpace= true; - fCharAfterWhiteSpace= -1; - fBuffer.setLength(0); - fIndex= 0; - } - - protected final void setSkipWhitespace(boolean state) { - fSkipWhiteSpace= state; - } - - protected final boolean isSkippingWhitespace() { - return fSkipWhiteSpace; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntEditorContentOutlinePage.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntEditorContentOutlinePage.java deleted file mode 100644 index 4965f3e37..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntEditorContentOutlinePage.java +++ /dev/null @@ -1,517 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import java.util.List; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.resources.IWorkspaceRoot; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.jface.action.IMenuListener; -import org.eclipse.jface.action.IMenuManager; -import org.eclipse.jface.action.MenuManager; -import org.eclipse.jface.action.Separator; -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.jface.util.ListenerList; -import org.eclipse.jface.viewers.IColorProvider; -import org.eclipse.jface.viewers.ILabelProvider; -import org.eclipse.jface.viewers.ILabelProviderListener; -import org.eclipse.jface.viewers.ISelection; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.ITreeContentProvider; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.jface.viewers.StructuredSelection; -import org.eclipse.jface.viewers.TreeViewer; -import org.eclipse.jface.viewers.Viewer; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Color; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Display; -import org.eclipse.swt.widgets.Menu; -import org.eclipse.ui.IWorkbenchActionConstants; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.IAntEditorConstants; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlAttribute; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlElement; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.ant.view.actions.AntOpenWithMenu; -import org.eclipse.ui.externaltools.internal.model.AntImageDescriptor; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.part.IPageSite; -import org.eclipse.ui.part.IShowInSource; -import org.eclipse.ui.part.ShowInContext; -import org.eclipse.ui.views.contentoutline.ContentOutlinePage; - -/** - * Content outline page for the Ant Editor. - */ -public class AntEditorContentOutlinePage extends ContentOutlinePage implements IShowInSource, IAdaptable { - - private static final int EXPAND_TO_LEVEL= 2; - - private Menu menu; - private AntOpenWithMenu openWithMenu; - - private IDocumentModelListener fListener; - private AntModel fModel; - private XMLCore fCore; - private ListenerList fPostSelectionChangedListeners= new ListenerList(); - private boolean fIsModelEmpty= true; - - /** - * The content provider for the objects shown in the outline view. - */ - private class ContentProvider implements ITreeContentProvider { - - /** - * @see org.eclipse.jface.viewers.IContentProvider#dispose() - */ - public void dispose() { - } - - - /** - * do nothing - * @see org.eclipse.jface.viewers.IContentProvider#inputChanged(Viewer, Object, Object) - */ - public void inputChanged(Viewer viewer, Object oldInput, Object newInput) { - } - - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ITreeContentProvider#getChildren(Object) - */ - public Object[] getChildren(Object parentNode) { - XmlElement tempParentElement = (XmlElement)parentNode; - List tempChilds = tempParentElement.getChildNodes(); - Object[] tempChildObjects = new Object[tempChilds.size()]; - for(int i=0; i<tempChilds.size(); i++) { - tempChildObjects[i] = (Object)tempChilds.get(i); - } - return tempChildObjects; - } - - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ITreeContentProvider#getParent(Object) - */ - public Object getParent(Object aNode) { - XmlElement tempElement = (XmlElement)aNode; - return tempElement.getParentNode(); - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ITreeContentProvider#hasChildren(Object) - */ - public boolean hasChildren(Object aNode) { - return ((XmlElement)aNode).getChildNodes().size() > 0; - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IStructuredContentProvider#getElements(Object) - */ - public Object[] getElements(Object anInputElement) { - return ((AntModel) anInputElement).getRootElements(); - } - - } - - /** - * The label provider for the objects shown in the outline view. - */ - private class LabelProvider implements ILabelProvider, IColorProvider { - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IBaseLabelProvider#addListener(ILabelProviderListener) - */ - public void addListener(ILabelProviderListener listener) { - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IBaseLabelProvider#dispose() - */ - public void dispose() { - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IBaseLabelProvider#isLabelProperty(Object, String) - */ - public boolean isLabelProperty(Object element, String property) { - return false; - } - - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IBaseLabelProvider#removeListener(ILabelProviderListener) - */ - public void removeListener(ILabelProviderListener listener) { - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ILabelProvider#getImage(Object) - */ - public Image getImage(Object anElement) { - XmlElement tempElement = (XmlElement)anElement; - if("target".equals(tempElement.getName())) { //$NON-NLS-1$ - ImageDescriptor base = null; - int flags = 0; - - if (tempElement.isErrorNode()) { - flags = flags | AntImageDescriptor.HAS_ERRORS; - } - if (isDefaultTargetNode(tempElement)) { - flags = flags | AntImageDescriptor.DEFAULT_TARGET; - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_DEFAULT_TARGET); - } else if (tempElement.getAttributeNamed(IAntEditorConstants.ATTR_DESCRIPTION) == null) { - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_TARGET_PRIVATE); - } else { - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_TARGET); - } - return ExternalToolsImages.getImage(new AntImageDescriptor(base, flags)); - } - if("project".equals(tempElement.getName())) { //$NON-NLS-1$ - return getProjectImage(tempElement); - } - - if("property".equals(tempElement.getName())) { //$NON-NLS-1$ - return ExternalToolsImages.getImage(IExternalToolsUIConstants.IMAGE_ID_PROPERTY); - } - - XmlAttribute attribute= tempElement.getAttributeNamed(IAntEditorConstants.ATTR_TYPE); - if (attribute != null && IAntEditorConstants.TYPE_EXTERNAL.equals(attribute.getValue())) { - return getProjectImage(tempElement); - } - - if (attribute != null && IAntEditorConstants.TYPE_UNKNOWN.equals(attribute.getValue())) { - int flags= 0; - ImageDescriptor base= ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMAGE_ID_TASK); - if (tempElement.isErrorNode()) { - flags |= AntImageDescriptor.HAS_ERRORS; - } - return ExternalToolsImages.getImage(new AntImageDescriptor(base, flags)); - } - - if (tempElement.isErrorNode()) { - return ExternalToolsImages.getImage(IExternalToolsUIConstants.IMG_ANT_TARGET_ERROR); - } - return ExternalToolsImages.getImage(IExternalToolsUIConstants.IMAGE_ID_TASK); - } - - private Image getProjectImage(XmlElement tempElement) { - int flags = 0; - ImageDescriptor base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_PROJECT); - if (tempElement.isErrorNode()) { - flags = flags | AntImageDescriptor.HAS_ERRORS; - } - return ExternalToolsImages.getImage(new AntImageDescriptor(base, flags)); - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ILabelProvider#getText(Object) - */ - public String getText(Object aNode) { - XmlElement element= (XmlElement) aNode; - StringBuffer displayName= new StringBuffer(element.getDisplayName()); - if (element.isExternal() && (!element.isRootExternal() || (element.getParentNode() != null && element.getParentNode().isExternal()))) { - displayName.append(AntOutlineMessages.getString("AntEditorContentOutlinePage._[external]_1")); //$NON-NLS-1$ - } - return displayName.toString(); - } - - public Color getForeground(Object element) { - if (isDefaultTargetNode((XmlElement) element)) { - return Display.getDefault().getSystemColor(SWT.COLOR_BLUE); - } - return null; - } - - public Color getBackground(Object element) { - return null; - } - } - - private boolean isDefaultTargetNode(XmlElement node) { - XmlAttribute type= node.getAttributeNamed(IAntEditorConstants.ATTR_TYPE); - if (type == null || !type.getValue().equals(IAntEditorConstants.TYPE_TARGET)) { - return false; - } - XmlElement parent= node.getParentNode(); - if (parent != null) { - type= parent.getAttributeNamed(IAntEditorConstants.ATTR_TYPE); - while (parent != null && (type == null || !type.getValue().equals(IAntEditorConstants.TYPE_PROJECT))) { - parent= parent.getParentNode(); - if (parent != null) { - type= parent.getAttributeNamed(IAntEditorConstants.ATTR_TYPE); - } - } - } - if (parent == null) { - return false; - } - - XmlAttribute defaultTarget= parent.getAttributeNamed(IAntEditorConstants.ATTR_DEFAULT); - XmlAttribute nameAttribute= node.getAttributeNamed(IAntEditorConstants.ATTR_NAME); - return defaultTarget != null && nameAttribute != null && defaultTarget.getValue().equals(nameAttribute.getValue()); - } - - /** - * Creates a new AntEditorContentOutlinePage. - */ - public AntEditorContentOutlinePage(XMLCore core) { - super(); - fCore= core; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.part.IPage#dispose() - */ - public void dispose() { - if (menu != null) { - menu.dispose(); - } - if (openWithMenu != null) { - openWithMenu.dispose(); - } - if (fListener != null) { - fCore.removeDocumentModelListener(fListener); - fListener= null; - } - } - - /** - * Creates the control (outline view) for this page - */ - public void createControl(Composite parent) { - super.createControl(parent); - - TreeViewer viewer = getTreeViewer(); - - /* - * We might want to implement our own content provider. - * This content provider should be able to work on a dom like tree - * structure that resembles the file contents. - */ - viewer.setContentProvider(new ContentProvider()); - - /* - * We probably also need our own label provider. - */ - viewer.setLabelProvider(new LabelProvider()); - if (fModel != null) { - setViewerInput(fModel); - } - - MenuManager manager= new MenuManager("#PopUp"); //$NON-NLS-1$ - manager.setRemoveAllWhenShown(true); - manager.addMenuListener(new IMenuListener() { - public void menuAboutToShow(IMenuManager manager) { - contextMenuAboutToShow(manager); - } - }); - menu= manager.createContextMenu(viewer.getTree()); - viewer.getTree().setMenu(menu); - - IPageSite site= getSite(); - site.registerContextMenu(IExternalToolConstants.PLUGIN_ID + ".antEditorOutline", manager, viewer); //$NON-NLS-1$ - - openWithMenu= new AntOpenWithMenu(this.getSite().getPage()); - - viewer.addPostSelectionChangedListener(new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - postSelectionChanged(event); - } - }); - } - - private void setViewerInput(Object newInput) { - TreeViewer tree= getTreeViewer(); - Object oldInput= tree.getInput(); - - boolean isAntModel= (newInput instanceof AntModel); - boolean wasAntModel= (oldInput instanceof AntModel); - - if (isAntModel && !wasAntModel) { - if (fListener == null) { - fListener= createAntModelChangeListener(); - } - fCore.addDocumentModelListener(fListener); - } else if (!isAntModel && wasAntModel && fListener != null) { - fCore.removeDocumentModelListener(fListener); - fListener= null; - } - - - tree.setInput(newInput); - - if (isAntModel) { - updateTreeExpansion(); - } - } - - public void setPageInput(AntModel xmlModel) { - fModel= xmlModel; - if (getTreeViewer() != null) { - setViewerInput(fModel); - } - } - - private IDocumentModelListener createAntModelChangeListener() { - return new IDocumentModelListener() { - public void documentModelChanged(final DocumentModelChangeEvent event) { - if (event.getModel() == fModel && !getControl().isDisposed()) { - getControl().getDisplay().asyncExec(new Runnable() { - public void run() { - Control ctrl= getControl(); - if (ctrl != null && !ctrl.isDisposed()) { - getTreeViewer().refresh(); - updateTreeExpansion(); - } - } - }); - } - } - }; - } - - public void addPostSelectionChangedListener(ISelectionChangedListener listener) { - fPostSelectionChangedListeners.add(listener); - } - - public void removePostSelectionChangedListener(ISelectionChangedListener listener) { - fPostSelectionChangedListeners.remove(listener); - } - - private void updateTreeExpansion() { - boolean wasModelEmpty= fIsModelEmpty; - fIsModelEmpty= fModel == null || fModel.getRootElements() == null || fModel.getRootElements().length == 0; - if (wasModelEmpty && !fIsModelEmpty) { - getTreeViewer().expandToLevel(EXPAND_TO_LEVEL); - } - } - - public void postSelectionChanged(SelectionChangedEvent event) { - firePostSelectionChanged(event.getSelection()); - } - - - private void firePostSelectionChanged(ISelection selection) { - // create an event - SelectionChangedEvent event= new SelectionChangedEvent(this, selection); - - // fire the event - Object[] listeners= fPostSelectionChangedListeners.getListeners(); - for (int i= 0; i < listeners.length; ++i) { - ((ISelectionChangedListener) listeners[i]).selectionChanged(event); - } - } - - private void contextMenuAboutToShow(IMenuManager menu) { - if (shouldAddOpenWithMenu()) { - addOpenWithMenu(menu); - } - menu.add(new Separator(IWorkbenchActionConstants.MB_ADDITIONS)); - } - - private void addOpenWithMenu(IMenuManager menu) { - IStructuredSelection selection= (IStructuredSelection)getSelection(); - XmlElement element= (XmlElement)selection.getFirstElement(); - String path = getElementPath(element); - - if (path != null) { - IPath resourcePath= new Path(path); - IWorkspaceRoot root= ResourcesPlugin.getWorkspace().getRoot(); - IResource resource= root.getFileForLocation(resourcePath); - if (resource != null && resource.getType() == IResource.FILE && resource.exists()) { - menu.add(new Separator("group.open")); //$NON-NLS-1$ - IMenuManager submenu= new MenuManager(AntOutlineMessages.getString("AntEditorContentOutlinePage.Open_With_1")); //$NON-NLS-1$ - openWithMenu.setFile((IFile)resource); - submenu.add(openWithMenu); - menu.appendToGroup("group.open", submenu); //$NON-NLS-1$ - - } - } - } - - private String getElementPath(XmlElement element) { - String path= element.getFilePath(); - if (element.isRootExternal()){ - List children= element.getChildNodes(); - if (!children.isEmpty()) { - XmlElement child= (XmlElement)children.get(0); - path= child.getFilePath(); - } - } - return path; - } - - private boolean shouldAddOpenWithMenu() { - ISelection iselection= getSelection(); - if (iselection instanceof IStructuredSelection) { - IStructuredSelection selection= (IStructuredSelection)iselection; - if (selection.size() == 1) { - Object selected= selection.getFirstElement(); - if (selected instanceof XmlElement) { - XmlElement element= (XmlElement)selected; - if (element.isExternal()) { - String path = getElementPath(element); - if (path.length() == 0) { - return false; - } - - XmlElement parent= element.getParentNode(); - while (parent != null) { - String parentPath= getElementPath(parent); - if (path != null && !path.equals(parentPath)) { - return true; - } - parent= parent.getParentNode(); - } - } - } - } - } - return false; - } - - /* (non-Javadoc) - * @see org.eclipse.core.runtime.IAdaptable#getAdapter(java.lang.Class) - */ - public Object getAdapter(Class key) { - if (key == IShowInSource.class) { - return this; - } - return null; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.part.IShowInSource#getShowInContext() - */ - public ShowInContext getShowInContext() { - if (fModel != null) { - ILocationProvider locationProvider= fModel.getLocationProvider(); - IFile file= AntUtil.getFile(locationProvider.getLocation().toOSString()); - ISelection selection= new StructuredSelection(file); - return new ShowInContext(null, selection); - } - return null; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntModel.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntModel.java deleted file mode 100644 index 4e0a25a48..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntModel.java +++ /dev/null @@ -1,203 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import java.io.IOException; -import java.io.StringReader; - -import org.apache.xerces.parsers.SAXParser; -import org.eclipse.core.runtime.IPath; -import org.eclipse.jface.text.DocumentEvent; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.IDocumentListener; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlElement; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; - -import org.xml.sax.InputSource; -import org.xml.sax.SAXException; -import org.xml.sax.SAXParseException; - -/** - * AntModel.java - */ -public class AntModel { - - private XMLCore fCore; - private IDocument fDocument; - private IProblemRequestor fProblemRequestor; - private ILocationProvider fLocationProvider; - - private XmlElement[] fRootElements= new XmlElement[0]; - private Object fRootElementLock= new Object(); - - private final Object fDirtyLock= new Object(); - private boolean fIsDirty= true; - private IDocumentListener fListener; - - public AntModel(XMLCore core, IDocument document, IProblemRequestor problemRequestor, ILocationProvider locationProvider) { - fCore= core; - fDocument= document; - fProblemRequestor= problemRequestor; - fLocationProvider= locationProvider; - } - - public void install() { - fListener= new IDocumentListener() { - public void documentAboutToBeChanged(DocumentEvent event) { - synchronized (fDirtyLock) { - fIsDirty= true; - } - } - public void documentChanged(DocumentEvent event) {} - }; - fDocument.addDocumentListener(fListener); - - reconcile(); - } - - public void dispose() { - - if (fDocument != null) { - fDocument.removeDocumentListener(fListener); - } - - synchronized (this) { - fDocument= null; - fCore= null; - } - } - - public void reconcile() { - - synchronized (fDirtyLock) { - if (!fIsDirty) { - return; - } - fIsDirty= false; - } - - synchronized (this) { - if (fCore == null) { - // disposed - return; - } - - XmlElement[] rootElements; - if (fDocument == null) { - rootElements= new XmlElement[0]; - } else { - XmlElement rootElement= parseDocument(fDocument); - if (rootElement == null) { - rootElements= new XmlElement[0]; - } else { - rootElements= new XmlElement[] { rootElement }; - } - } - - setRootElements(rootElements); - - fCore.notifyDocumentModelListeners(new DocumentModelChangeEvent(this)); - } - } - - private void setRootElements(XmlElement[] rootElements) { - synchronized (fRootElementLock) { - fRootElements= rootElements; - } - } - - public XmlElement[] getRootElements() { - synchronized (fRootElementLock) { - return fRootElements; - } - } - - /** - * Gets the content outline for a given input element. - * Returns the root XmlElement, or null if the - * outline could not be generated. - */ - private XmlElement parseDocument(IDocument input) { - /* - * What happens here: - * The file is parsed by the SAX Parser. - * The Parser then creates the DOM Tree of the file. - * The root element is returned here. - */ - - String tempWholeDocumentString= input.get(); - - // Create the parser - SAXParser tempParser; - try { - tempParser = new SAXParser(); - tempParser.setFeature("http://xml.org/sax/features/namespaces", false); //$NON-NLS-1$ - } catch (SAXException e) { - ExternalToolsPlugin.getDefault().log(e); - return null; - } - - // Create the handler - OutlinePreparingHandler tempHandler = null; - - tempHandler = new OutlinePreparingHandler(fLocationProvider); - tempHandler.setProblemRequestor(fProblemRequestor); - tempHandler.setDocument(input); - - tempParser.setContentHandler(tempHandler); - tempParser.setDTDHandler(tempHandler); - tempParser.setEntityResolver(tempHandler); - tempParser.setErrorHandler(tempHandler); -// tempParser.setLocale(...); - - // Parse! - try { - tempHandler.begin(); - InputSource tempInputSource = new InputSource(new StringReader(tempWholeDocumentString)); - IPath location= fLocationProvider.getLocation(); - if (location != null) { - //needed for resolving relative external entities - tempInputSource.setSystemId(location.toOSString()); - } - tempParser.setProperty("http://xml.org/sax/properties/lexical-handler", tempHandler); //$NON-NLS-1$ - tempParser.parse(tempInputSource); - } catch(SAXParseException e) { - tempHandler.fixEndLocations(e); - } catch (SAXException e) { - ExternalToolsPlugin.getDefault().log(e); - return null; - } catch (IOException e) { - XmlElement tempElement= tempHandler.getLastOpenElement(); - tempHandler.fixEndLocations(); - generateExceptionOutline(tempElement); - } finally { - tempHandler.end(); - } - - XmlElement tempRootElement = tempHandler.getRootElement(); - return tempRootElement; - } - - private void generateExceptionOutline(XmlElement openElement) { - while (openElement != null) { - openElement.setIsErrorNode(true); - openElement= openElement.getParentNode(); - } - } - - /** - * @return ILocationProvider - */ - public ILocationProvider getLocationProvider() { - return fLocationProvider; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntOutlineMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntOutlineMessages.java deleted file mode 100644 index 524cba196..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntOutlineMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntOutlineMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.editor.outline.AntOutlineMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntOutlineMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntOutlineMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntOutlineMessages.properties deleted file mode 100644 index 42f45d28d..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/AntOutlineMessages.properties +++ /dev/null @@ -1,17 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -OutlinePreparingHandler.Error_Name=Error when parsing document: Neither a local name nor qualified of an element specified -OutlinePreparingHandler._line___2=\ line: -OutlinePreparingHandler._[default]_2=\ [default] - -AntEditorContentOutlinePage._[external]_1=\ [external] -AntEditorContentOutlinePage.Open_With_1=Open With diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/DocumentModelChangeEvent.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/DocumentModelChangeEvent.java deleted file mode 100644 index 5950ddd52..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/DocumentModelChangeEvent.java +++ /dev/null @@ -1,29 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -/** - * DocumentModelChangeEvent.java - */ -public class DocumentModelChangeEvent { - - private AntModel fModel; - - DocumentModelChangeEvent(AntModel model) { - fModel= model; - } - - public AntModel getModel() { - return fModel; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IDocumentModelListener.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IDocumentModelListener.java deleted file mode 100644 index 0ce02aed5..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IDocumentModelListener.java +++ /dev/null @@ -1,18 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - - -public interface IDocumentModelListener { - - public void documentModelChanged(DocumentModelChangeEvent event); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/ILocationProvider.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/ILocationProvider.java deleted file mode 100644 index 9c11676e3..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/ILocationProvider.java +++ /dev/null @@ -1,20 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import org.eclipse.core.runtime.IPath; - - -public interface ILocationProvider { - - public IPath getLocation(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IProblem.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IProblem.java deleted file mode 100644 index a4c16792d..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IProblem.java +++ /dev/null @@ -1,46 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import org.eclipse.jface.text.IRegion; - - -public interface IProblem extends IRegion { - - /** - * Returns the problem code - * - * @return the problem code - */ - String getCode(); - - /** - * Answer a localized, human-readable message string which describes the problem. - * - * @return a localized, human-readable message string which describes the problem - */ - String getMessage(); - - /** - * Checks the severity to see if the Error bit is set. - * - * @return true if the Error bit is set for the severity, false otherwise - */ - boolean isError(); - - /** - * Checks the severity to see if the Error bit is not set. - * - * @return true if the Error bit is not set for the severity, false otherwise - */ - boolean isWarning(); - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IProblemRequestor.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IProblemRequestor.java deleted file mode 100644 index 157f9489e..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/IProblemRequestor.java +++ /dev/null @@ -1,35 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -public interface IProblemRequestor { - - /** - * Notification of a XML problem. - * - * @param problem IProblem - The discovered Java problem. - */ - void acceptProblem(IProblem problem); - - /** - * Notification sent before starting the problem detection process. - * Typically, this would tell a problem collector to clear previously recorded problems. - */ - void beginReporting(); - - /** - * Notification sent after having completed problem detection process. - * Typically, this would tell a problem collector that no more problems should be expected in this - * iteration. - */ - void endReporting(); - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/LocationProvider.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/LocationProvider.java deleted file mode 100644 index 1358f81d4..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/LocationProvider.java +++ /dev/null @@ -1,37 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.runtime.IPath; - - -/** - * LocationProvider.java - */ -public class LocationProvider implements ILocationProvider { - private IPath fPath; - - public LocationProvider() { - } - - public LocationProvider(IFile file) { - setLocationFromFile(file); - } - - public void setLocationFromFile(IFile file) { - fPath= file != null ? file.getLocation() : null; - } - - public IPath getLocation() { - return fPath; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/OutlinePreparingHandler.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/OutlinePreparingHandler.java deleted file mode 100644 index 46aa03b08..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/OutlinePreparingHandler.java +++ /dev/null @@ -1,846 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import java.io.File; -import java.io.FileNotFoundException; -import java.io.FileReader; -import java.util.Stack; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.util.FileUtils; -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.IDocument; -import org.eclipse.ui.externaltools.internal.ant.editor.AntEditorException; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.IAntEditorConstants; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlAttribute; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlElement; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.xml.sax.Attributes; -import org.xml.sax.InputSource; -import org.xml.sax.Locator; -import org.xml.sax.SAXException; -import org.xml.sax.SAXParseException; -import org.xml.sax.ext.LexicalHandler; -import org.xml.sax.helpers.DefaultHandler; - -/** - * Used when parsing the content of the editor to create a tree model that is - * used as model for the outline view. - * <P> - * The handler makes use of the xml parser's locator to pre-determine - * positions of tags. The locations as they can be determined at this point - * are set for the <code>XmlElement</code> instances. The locations that are - * set are not the correct ones yet, after parsing. They have to be corrected - * afterwards. This actually happens in the OutlineView. The locations that are - * set at this point are only the ones that the locator gives us in - * <code>startElement()</code> and <code>endElement()</code>. - * - */ -public class OutlinePreparingHandler extends DefaultHandler implements LexicalHandler { - - /** - * The locator that tells us the location of the currently parsed element - * in the parsed document. - */ - private Locator locator; - - - /** - * Stack of still open elements. - * <P> - * On top of the stack is the innermost element. - */ - private Stack stillOpenElements = new Stack(); - - - /** - * The root element of the DOM Tree that we create while parsing. - */ - private XmlElement rootElement; - - /** - * Used as a helper for resolving external relative entries - * and paths for error elements. - */ - private File mainFile; - - /** - * Helper for generating <code>IProblem</code>s - */ - private XEErrorHandler errorHandler; - - /** - * The parsed document - */ - private IDocument document; - - /** - * Whether the current element is the root of the external entity tree - */ - private boolean isTopLevelRootExternal; - - /** - * Whether the current callbacks are from elements in the DTD. - */ - private boolean isInDTD; - - /** - * Start offset of the last seen external entity. - */ - private int lastExternalEntityOffset= -1; - - /** - * Creates an instance. - */ - public OutlinePreparingHandler(ILocationProvider locationProvider) { - super(); - IPath location= locationProvider.getLocation(); - if(location != null) { - this.mainFile= location.toFile(); - } - } - - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#startElement(String, String, String, Attributes) - */ - public void startElement(String aUri, String aLocalName, String aQualifiedName, Attributes anAttributes) - throws SAXException { - /* - * While the crimson parser passes the tag name as local name, apache's - * xerces parser, passes the tag name as qualilfied name and an empty - * string as local name. - */ - - // Create a Dom Element - XmlElement tempElement = createXmlElement(aLocalName, aQualifiedName, anAttributes); - - // Is it our root - if(rootElement == null) { - rootElement = tempElement; - } else { // Add it as child to parent - XmlElement tempLastOpenedElement = (XmlElement)stillOpenElements.peek(); - tempLastOpenedElement.addChildNode(tempElement); - tempElement.setExternal(isExternal()); - } - - // set starting the location - computeStartLocation(tempElement); - - stillOpenElements.push(tempElement); - - super.startElement(aUri, aLocalName, aQualifiedName, anAttributes); - } - - - /** - * Creates an <code>XmlElement</code> instance from the specified parameters. - */ - private XmlElement createXmlElement(String aLocalName, String aQualifiedName, Attributes attributes) { - String tempElementName = null; - - XmlElement tempElement = null; - if(aLocalName.length() > 0) { - tempElementName = aLocalName; - } - else if(aQualifiedName.length() > 0) { - tempElementName = aQualifiedName; - } - else { - throw new AntEditorException(AntOutlineMessages.getString("OutlinePreparingHandler.Error_Name")); //$NON-NLS-1$ - } - String elementType= null; - if(tempElementName.equalsIgnoreCase("target")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_TARGET; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_NAME); - if(tempXmlAttr != null) { - StringBuffer name= new StringBuffer(tempXmlAttr.getValue()); - XmlElement parent= getParentNode(); - XmlAttribute type= parent != null ? parent.getAttributeNamed(IAntEditorConstants.ATTR_TYPE) : null; - while (parent != null && (type == null || !type.getValue().equals(IAntEditorConstants.TYPE_PROJECT))){ - parent= parent.getParentNode(); - if (parent != null) { - type= parent.getAttributeNamed(IAntEditorConstants.ATTR_TYPE); - } - } - if (parent != null) { - XmlAttribute defaultTarget= parent.getAttributeNamed(IAntEditorConstants.ATTR_DEFAULT); - if (defaultTarget != null && defaultTarget.getValue().equals(tempXmlAttr.getValue())) { - name.append(AntOutlineMessages.getString("OutlinePreparingHandler._[default]_2")); //$NON-NLS-1$ - } - } - return name.toString(); - } - return super.getDisplayName(); - } - }; - } else if (tempElementName.equalsIgnoreCase("project")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_PROJECT; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_NAME); - if(tempXmlAttr != null) { - return tempXmlAttr.getValue(); - } - return super.getDisplayName(); - } - }; - } else if(tempElementName.equalsIgnoreCase("property")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_PROPERTY; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_NAME); - if(tempXmlAttr != null) { - return tempXmlAttr.getValue(); - } - tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_FILE); - if(tempXmlAttr != null) { - return "file="+tempXmlAttr.getValue(); //$NON-NLS-1$ - } - tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_RESOURCE); - if(tempXmlAttr != null) { - return "resource="+tempXmlAttr.getValue(); //$NON-NLS-1$ - } - tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_ENVIRONMENT); - if(tempXmlAttr != null) { - return "environment="+tempXmlAttr.getValue(); //$NON-NLS-1$ - } - return super.getDisplayName(); - } - }; - } - else if(tempElementName.equalsIgnoreCase("antcall")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_ANTCALL; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = "antcall "; //$NON-NLS-1$ - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_TARGET); - if(tempXmlAttr != null) { - tempDisplayName += tempXmlAttr.getValue(); - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("mkdir")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_MKDIR; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = "mkdir "; //$NON-NLS-1$ - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_DIR); - if(tempXmlAttr != null) { - tempDisplayName += tempXmlAttr.getValue(); - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("copy")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_COPY; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = "copy "; //$NON-NLS-1$ - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_FILE); - if(tempXmlAttr != null) { - tempDisplayName += tempXmlAttr.getValue(); - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("tar") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("jar") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("war") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("zip")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_ARCHIVE; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = super.getDisplayName(); - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_DESTFILE); - if(tempXmlAttr != null) { - tempDisplayName += " " + tempXmlAttr.getValue(); //$NON-NLS-1$ - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("untar") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("unjar") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("unwar") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("gunzip") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("bunzip2") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("unzip")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_DECOMPRESS; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = super.getDisplayName(); - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_SRC); - if(tempXmlAttr != null) { - tempDisplayName += " " + tempXmlAttr.getValue(); //$NON-NLS-1$ - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("gzip") //$NON-NLS-1$ - || tempElementName.equalsIgnoreCase("bzip2")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_COMPRESS; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = super.getDisplayName(); - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_ZIPFILE); - if(tempXmlAttr != null) { - tempDisplayName += " " + tempXmlAttr.getValue(); //$NON-NLS-1$ - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("exec")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_EXEC; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = "exec "; //$NON-NLS-1$ - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_COMMAND); - if(tempXmlAttr != null) { - tempDisplayName += tempXmlAttr.getValue(); - } - tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_EXECUTABLE); - if(tempXmlAttr != null) { - tempDisplayName += tempXmlAttr.getValue(); - } - return tempDisplayName; - } - }; - } - else if(tempElementName.equalsIgnoreCase("delete")) { //$NON-NLS-1$ - elementType= IAntEditorConstants.TYPE_DELETE; - tempElement = new XmlElement(tempElementName) { - public String getDisplayName() { - String tempDisplayName = "delete "; //$NON-NLS-1$ - XmlAttribute tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_FILE); - if(tempXmlAttr != null) { - return tempDisplayName + tempXmlAttr.getValue(); - } - tempXmlAttr = getAttributeNamed(IAntEditorConstants.ATTR_DIR); - if(tempXmlAttr != null) { - return tempDisplayName + tempXmlAttr.getValue(); - } - return tempDisplayName; - } - }; - } - else { - elementType= IAntEditorConstants.TYPE_UNKNOWN; - tempElement = new XmlElement(tempElementName); - } - - if (attributes != null) { - // Add all attributes - for(int i=0; i < attributes.getLength(); i++) { - String tempAttrName = attributes.getLocalName(i); - if(tempAttrName == null || tempAttrName.length() == 0) { - tempAttrName = attributes.getQName(i); - } - String tempAttrValue = attributes.getValue(i); - tempElement.addAttribute(new XmlAttribute(tempAttrName, tempAttrValue)); - } - } - // Add the type attribute - tempElement.addAttribute(new XmlAttribute(IAntEditorConstants.ATTR_TYPE, elementType)); - tempElement.setFilePath(locator.getSystemId()); - return tempElement; - } - - - /* (non-Javadoc) - * @see org.xml.sax.ContentHandler#endElement(String, String, String) - */ - public void endElement(String aUri, String aLocalName, String aQualifiedName) - throws SAXException { - - String tempTagName = aLocalName.length() > 0 ? aLocalName : aQualifiedName; - - XmlElement tempLastStillOpenElement = (XmlElement)stillOpenElements.peek(); - if(tempLastStillOpenElement != null && tempLastStillOpenElement.getName().equalsIgnoreCase(tempTagName)) { - computeEndLocation(tempLastStillOpenElement); - stillOpenElements.pop(); - } - } - - - /** - * We use the document locator to locate the position of elements in the - * document exactly. - * - * @see org.xml.sax.ContentHandler#setDocumentLocator(Locator) - */ - public void setDocumentLocator(Locator aLocator) { - locator = aLocator; - super.setDocumentLocator(aLocator); - } - - - /** - * Returns the parent that has been created during a prior - * parsing. - * <P> - * It is quite common that parsing stopped before the current cursor - * position. That happens when the parser finds an error within the parsed - * document before. - * - * @return the parent element or <code>null</code> if no parent exists - */ - public XmlElement getRootElement() { - return rootElement; - } - - - /* - * @see org.xml.sax.ErrorHandler#warning(org.xml.sax.SAXParseException) - */ - public void warning(SAXParseException anException) throws SAXException { - if (errorHandler != null) { - XmlElement element= createProblemElement(anException); - errorHandler.warning(anException, element); - } - } - - /* (non-Javadoc) - * @see org.xml.sax.ErrorHandler#error(SAXParseException) - */ - public void error(SAXParseException anException) throws SAXException { - generateErrorElementHierarchy(); - if (errorHandler != null) { - XmlElement errorElement= createProblemElement(anException); - errorHandler.error(anException, errorElement); - } - } - - /** - * Fatal errors occur when we parse a non valid file. Populate the error - * element hierarchy. - * - * @see org.xml.sax.ErrorHandler#fatalError(SAXParseException) - */ - public void fatalError(SAXParseException anException) throws SAXException { - generateErrorElementHierarchy(); - if (errorHandler != null) { - XmlElement errorElement= createProblemElement(anException); - errorHandler.fatalError(anException, errorElement); - } - } - - private XmlElement createProblemElement(SAXParseException exception) { - int lineNumber= exception.getLineNumber(); - StringBuffer message= new StringBuffer(exception.getMessage()); - if (lineNumber != -1){ - message.append(AntOutlineMessages.getString("OutlinePreparingHandler._line___2") + lineNumber); //$NON-NLS-1$ - } - - XmlElement errorNode= new XmlElement(message.toString()); - errorNode.setFilePath(exception.getSystemId()); - errorNode.setExternal(isExternal()); - errorNode.setIsErrorNode(true); - computeErrorLocation(errorNode, exception); - return errorNode; - } - - private void generateErrorElementHierarchy() { - XmlElement openElement= getLastOpenElement(); - while (openElement != null) { - openElement.setIsErrorNode(true); - openElement= openElement.getParentNode(); - } - } - - /** - * @see org.xml.sax.EntityResolver#resolveEntity(java.lang.String, java.lang.String) - */ - public InputSource resolveEntity(String publicId, String systemId) throws SAXException { - int index= systemId.indexOf(':'); - if (index > 0) { - //remove file: - systemId= systemId.substring(index + 1, systemId.length()); - } - File resolvedFile= null; - IPath filePath= new Path(systemId); - IFile file = ResourcesPlugin.getWorkspace().getRoot().getFileForLocation(filePath); - if (file == null || !file.exists()) { - //relative path - try { - //this call is ok if mainFileContainer is null - resolvedFile= FileUtils.newFileUtils().resolveFile(mainFile.getParentFile(), systemId); - } catch (BuildException be) { - return null; - } - } else { - resolvedFile= file.getLocation().toFile(); - } - - if (resolvedFile != null && resolvedFile.exists()) { - try { - InputSource inputSource= new InputSource(new FileReader(resolvedFile)); - inputSource.setSystemId(resolvedFile.getAbsolutePath()); - return inputSource; - } catch (FileNotFoundException e) { - return null; - } - } - - return super.resolveEntity(publicId, systemId); - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#comment(char[], int, int) - */ - public void comment(char[] ch, int start, int length) throws SAXException { - if (isInDTD || isExternal()) { - return; - } - - try { - lastExternalEntityOffset= getOffset(locator.getLineNumber(), locator.getColumnNumber()) - 1; - } catch (BadLocationException e) { - ExternalToolsPlugin.getDefault().log(e); - } - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#endCDATA() - */ - public void endCDATA() throws SAXException { - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#endDTD() - */ - public void endDTD() throws SAXException { - isInDTD= false; - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#endEntity(java.lang.String) - */ - public void endEntity(String name) throws SAXException { - if (isInDTD) { - return; - } - XmlElement element= getLastOpenElement(); - boolean isNestedRootExternal= element == null || element.getParentNode() == null || element.getParentNode().isExternal(); - if (!isNestedRootExternal) { - isTopLevelRootExternal= true; - } - endElement(null, name, ""); //$NON-NLS-1$ - if (!isNestedRootExternal) { - isTopLevelRootExternal= false; - } - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#startCDATA() - */ - public void startCDATA() throws SAXException { - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#startDTD(java.lang.String, java.lang.String, java.lang.String) - */ - public void startDTD(String name, String publicId, String systemId) throws SAXException { - isInDTD= true; - } - - /* (non-Javadoc) - * @see org.xml.sax.ext.LexicalHandler#startEntity(java.lang.String) - */ - public void startEntity(String name) throws SAXException { - if (isInDTD) { - return; - } - boolean isNestedRootExternal= isExternal(); - if (!isNestedRootExternal) { - isTopLevelRootExternal= true; - } - startElement(null, name, "", null); //$NON-NLS-1$ - XmlElement external= (XmlElement)stillOpenElements.peek(); - external.setExternal(true); - external.setRootExternal(true); - external.getAttributes().removeAll(external.getAttributes()); - external.addAttribute(new XmlAttribute(IAntEditorConstants.ATTR_TYPE, IAntEditorConstants.TYPE_EXTERNAL)); - if (!isNestedRootExternal) { - isTopLevelRootExternal= false; - } - } - - private void computeStartLocation(XmlElement element) { - if (element.isExternal()) { - return; - } - - try { - int offset; - - if (isTopLevelRootExternal) { - String source= "&" + element.getName() + ";"; //$NON-NLS-1$ //$NON-NLS-2$ - offset= document.search(lastExternalEntityOffset + 1, source, true, true, false); - lastExternalEntityOffset= offset; - } else { - int locatorLine= locator.getLineNumber(); - int locatorColumn= locator.getColumnNumber(); - String prefix= "<"; //$NON-NLS-1$ - - if (locatorColumn <= 0) { - offset= getOffset(locatorLine, getLastCharColumn(locatorLine)); - offset= document.search(offset, prefix + element.getName(), false, false, false); - - lastExternalEntityOffset= offset; - } else { - offset= getOffset(locatorLine, locatorColumn); - - lastExternalEntityOffset= offset - 1; - - offset= document.search(offset - 1, prefix, false, true, false); - } - } - - int line= getLine(offset); - int column= getColumn(offset, line); - - element.setOffset(offset); - element.setStartingRow(line); - element.setStartingColumn(column); - } catch (BadLocationException e) { - //ignore as the parser may be out of sync with the document during reconciliation - } - } - - private void computeEndLocation(XmlElement element) { - if (element.isExternal() && !isTopLevelRootExternal) { - return; - } - - try { - int length, line, column; - - if (isTopLevelRootExternal) { - length= element.getName().length() + 2; - line= element.getStartingRow(); - column= element.getStartingColumn() + length; - } else { - line= locator.getLineNumber(); - column= locator.getColumnNumber(); - - int offset; - - if (column <= 0) { - int lineOffset= getOffset(line, 1); - offset= document.search(lineOffset, element.getName(), true, false, false); - if (offset < 0 || getLine(offset) != line) { - offset= lineOffset; - } - String endDelimiter= ">"; //$NON-NLS-1$ - offset= document.search(lineOffset, endDelimiter, true, true, false); //$NON-NLS-1$ - if (offset < 0 || getLine(offset) != line) { - offset= lineOffset; - column= 1; - } else { - offset++; - column= getColumn(offset, line); - } - } else { - offset= getOffset(line, column); - } - - length= offset - element.getOffset(); - - lastExternalEntityOffset= offset - 1; - } - - element.setLength(length); - element.setEndingRow(line); - element.setEndingColumn(column); - } catch (BadLocationException e) { - //ignore as the parser may be out of sync with the document during reconciliation - } - } - - private void computeErrorLocation(XmlElement element, SAXParseException exception) { - if (element.isExternal()) { - return; - } - - try { - int line= exception.getLineNumber(); - int startColumn= exception.getColumnNumber(); - int endColumn; - - if (line <= 0) { - line= locator.getLineNumber(); - startColumn= locator.getColumnNumber(); - - if (line <= 0) { - line= 1; - startColumn= 1; - } - } - - if (startColumn <= 0) { - startColumn= 1; - endColumn= getLastCharColumn(line) + 1; - } else { - if (startColumn > 1) { - --startColumn; - } - - endColumn= startColumn; - if (startColumn <= getLastCharColumn(line)) { - ++endColumn; - } - } - - int offset= getOffset(line, startColumn); - - element.setStartingRow(line); - element.setStartingColumn(startColumn); - element.setOffset(offset); - - element.setEndingRow(line); - element.setEndingColumn(endColumn); - element.setLength(endColumn - startColumn); - } catch (BadLocationException e) { - //ignore as the parser may be out of sync with the document during reconciliation - } - } - - public void fixEndLocations() { - fixEndLocations(null); - } - - public void fixEndLocations(SAXParseException e) { - XmlElement lastOpenElement= getLastOpenElement(); - if (lastOpenElement == null) { - return; - } - - boolean recoverFromExternal= lastOpenElement.isExternal(); - - while (lastOpenElement.isExternal() && (!lastOpenElement.isRootExternal() || (lastOpenElement.getParentNode() != null && lastOpenElement.getParentNode().isExternal()))) { - stillOpenElements.pop(); - lastOpenElement= getLastOpenElement(); - } - - try { - int offset, line, column; - - if (recoverFromExternal) { - XmlElement element= (XmlElement) stillOpenElements.peek(); - int length= element.getName().length() + 2; - offset= element.getOffset() + length; - line= element.getStartingRow(); - column= element.getStartingColumn() + length; - } else if (e == null) { - XmlElement element= (XmlElement) stillOpenElements.peek(); - offset= element.getOffset(); - line= element.getStartingRow(); - column= element.getStartingColumn(); - } else { - line= e.getLineNumber(); - column= e.getColumnNumber(); - - if (line <= 0) { - line= 1; - } - - if (column <= 0) { - column= 1; - } - - offset= getOffset(line, column); - } - - while (!stillOpenElements.empty()) { - XmlElement element= (XmlElement) stillOpenElements.pop(); - element.setLength(offset - element.getOffset()); - element.setEndingRow(line); - element.setEndingColumn(column); - } - } catch (BadLocationException ble) { - //ignore as the parser may be out of sync with the document during reconciliation - } - } - - public XmlElement getLastOpenElement() { - if (!stillOpenElements.empty()) { - return (XmlElement) stillOpenElements.peek(); - } - return null; - } - - private boolean isExternal() { - if (!stillOpenElements.empty()) { - return ((XmlElement) stillOpenElements.peek()).isExternal(); - } - return false; - } - - private int getLastCharColumn(int line) throws BadLocationException { - String lineDelimiter= document.getLineDelimiter(line - 1); - int lineDelimiterLength= lineDelimiter != null ? lineDelimiter.length() : 0; - return document.getLineLength(line - 1) - lineDelimiterLength; - } - - private int getOffset(int line, int column) throws BadLocationException { - return document.getLineOffset(line - 1) + column - 1; - } - - private int getLine(int offset) throws BadLocationException { - return document.getLineOfOffset(offset) + 1; - } - - private int getColumn(int offset, int line) throws BadLocationException { - return offset - document.getLineOffset(line - 1) + 1; - } - - public void begin() { - if (errorHandler != null) { - errorHandler.beginReporting(); - } - } - - public void end() { - if (errorHandler != null) { - errorHandler.endReporting(); - } - } - - public void setDocument(IDocument document) { - this.document= document; - } - - public void setProblemRequestor(IProblemRequestor requestor) { - if (requestor != null) { - errorHandler= new XEErrorHandler(requestor); - } else { - errorHandler= null; - } - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/XEErrorHandler.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/XEErrorHandler.java deleted file mode 100644 index 3299b9004..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/XEErrorHandler.java +++ /dev/null @@ -1,101 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import org.eclipse.jface.text.Region; -import org.eclipse.ui.externaltools.internal.ant.editor.xml.XmlElement; -import org.xml.sax.SAXParseException; - - -public class XEErrorHandler implements IProblemRequestor { - - protected class XMLProblem extends Region implements IProblem { - private String fCode, fMessage; - private int fSeverity; - - public XMLProblem(String code, String message, int severity, int offset, int length) { - super(offset, length); - fCode= code; - fMessage= message; - fSeverity= severity; - } - - public String getCode() { - return fCode; - } - - public String getMessage() { - return fMessage; - } - - public boolean isError() { - return fSeverity == SEVERTITY_ERROR || fSeverity == SEVERTITY_FATAL_ERROR; - } - - public boolean isWarning() { - return fSeverity == SEVERTITY_WARNING; - } - - } - - private static final int SEVERTITY_WARNING= 0; - private static final int SEVERTITY_ERROR= 1; - private static final int SEVERTITY_FATAL_ERROR= 2; - - private IProblemRequestor fProblemRequestor; - - /** - * Constructor XEErrorHandler. - * @param resourceProvider - */ - public XEErrorHandler(IProblemRequestor problemRequestor) { - fProblemRequestor= problemRequestor; - } - - public void acceptProblem(IProblem problem) { - if (fProblemRequestor != null) { - fProblemRequestor.acceptProblem(problem); - } - } - - public void beginReporting() { - if (fProblemRequestor != null) { - fProblemRequestor.beginReporting(); - } - } - - public void endReporting() { - if (fProblemRequestor != null) { - fProblemRequestor.endReporting(); - } - } - - protected IProblem createProblem(SAXParseException exception, XmlElement element, int severity) { - return new XMLProblem(exception.toString(), exception.getMessage(), severity, element.getOffset(), element.getLength()); - } - - protected void notifyProblemRequestor(SAXParseException exception, XmlElement element, int severity) { - IProblem problem= createProblem(exception, element, severity); - acceptProblem(problem); - } - - public void warning(SAXParseException exception, XmlElement element) { - notifyProblemRequestor(exception, element, SEVERTITY_WARNING); - } - - public void error(SAXParseException exception, XmlElement element) { - notifyProblemRequestor(exception, element, SEVERTITY_ERROR); - } - - public void fatalError(SAXParseException exception, XmlElement element) { - notifyProblemRequestor(exception, element, SEVERTITY_FATAL_ERROR); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/XMLCore.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/XMLCore.java deleted file mode 100644 index 1a64698be..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/outline/XMLCore.java +++ /dev/null @@ -1,56 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.outline; - -import java.util.ArrayList; -import java.util.Iterator; - -/** - * XMLCore.java - */ -public class XMLCore { - - private static XMLCore inst; - - public static XMLCore getDefault() { - if (inst == null) { - inst= new XMLCore(); - } - - return inst; - } - - private ArrayList fModelChangeListeners= new ArrayList(); - - private XMLCore() { } - - public void addDocumentModelListener(IDocumentModelListener listener) { - synchronized (fModelChangeListeners) { - fModelChangeListeners.add(listener); - } - } - - public void removeDocumentModelListener(IDocumentModelListener listener) { - synchronized (fModelChangeListeners) { - fModelChangeListeners.remove(listener); - } - } - - public void notifyDocumentModelListeners(DocumentModelChangeEvent event) { - Iterator i; - synchronized (fModelChangeListeners) { - i= new ArrayList(fModelChangeListeners).iterator(); - } - while (i.hasNext()) { - ((IDocumentModelListener)i.next()).documentModelChanged(event); - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AnnotationAccess.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AnnotationAccess.java deleted file mode 100644 index 540686306..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AnnotationAccess.java +++ /dev/null @@ -1,53 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import org.eclipse.jface.text.source.Annotation; -import org.eclipse.jface.text.source.IAnnotationAccess; - -/** - * AnnotationAccess.java - */ -public class AnnotationAccess implements IAnnotationAccess { - - /* - * @see org.eclipse.jface.text.source.IAnnotationAccess#getType(org.eclipse.jface.text.source.Annotation) - */ - public Object getType(Annotation annotation) { - if (annotation instanceof IXMLAnnotation) { - IXMLAnnotation xmlAnnotation= (IXMLAnnotation) annotation; - if (xmlAnnotation.isRelevant()) { - return xmlAnnotation.getAnnotationType(); - } - } - return null; - } - - /* - * @see org.eclipse.jface.text.source.IAnnotationAccess#isMultiLine(org.eclipse.jface.text.source.Annotation) - */ - public boolean isMultiLine(Annotation annotation) { - return true; - } - - /* - * @see org.eclipse.jface.text.source.IAnnotationAccess#isTemporary(org.eclipse.jface.text.source.Annotation) - */ - public boolean isTemporary(Annotation annotation) { - if (annotation instanceof IXMLAnnotation) { - IXMLAnnotation xmlAnnotation= (IXMLAnnotation) annotation; - if (xmlAnnotation.isRelevant()) { - return xmlAnnotation.isTemporary(); - } - } - return false; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AnnotationType.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AnnotationType.java deleted file mode 100644 index 54aad3a58..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AnnotationType.java +++ /dev/null @@ -1,50 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import org.eclipse.jface.util.Assert; - -final public class AnnotationType { - - public final static AnnotationType UNKNOWN= new AnnotationType(); - public final static AnnotationType BOOKMARK= new AnnotationType(); - public final static AnnotationType TASK= new AnnotationType(); - public final static AnnotationType ERROR= new AnnotationType(); - public final static AnnotationType WARNING= new AnnotationType(); - public final static AnnotationType INFO= new AnnotationType(); - public final static AnnotationType SEARCH= new AnnotationType(); - - private AnnotationType() { - } - - public String toString() { - if (this == UNKNOWN) - return "AnnotationType.UNKNOWN"; //$NON-NLS-1$ - - if (this == BOOKMARK) - return "AnnotationType.BOOKMARK"; //$NON-NLS-1$ - - if (this == TASK) - return "AnnotationType.TASK"; //$NON-NLS-1$ - - if (this == ERROR) - return "AnnotationType.ERROR"; //$NON-NLS-1$ - - if (this == WARNING) - return "AnnotationType.WARNING"; //$NON-NLS-1$ - - if (this == SEARCH) - return "AnnotationType.SEARCH"; //$NON-NLS-1$ - - Assert.isLegal(false); - return ""; //$NON-NLS-1$ - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorDocumentProvider.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorDocumentProvider.java deleted file mode 100644 index 3d833d5b0..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorDocumentProvider.java +++ /dev/null @@ -1,439 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.core.resources.IMarker; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IStatus; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.IDocumentPartitioner; -import org.eclipse.jface.text.Position; -import org.eclipse.jface.text.rules.DefaultPartitioner; -import org.eclipse.jface.text.source.Annotation; -import org.eclipse.jface.text.source.AnnotationModelEvent; -import org.eclipse.jface.text.source.IAnnotationModel; -import org.eclipse.ui.IEditorInput; -import org.eclipse.ui.IFileEditorInput; -import org.eclipse.ui.editors.text.FileDocumentProvider; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.AntModel; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblem; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.LocationProvider; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblemRequestor; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.XMLCore; -import org.eclipse.ui.texteditor.MarkerAnnotation; -import org.eclipse.ui.texteditor.ResourceMarkerAnnotationModel; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. It has been renamed and edited by GEBIT - * after copying. - */ -public class AntEditorDocumentProvider extends FileDocumentProvider { - - protected class XMLAnnotationModel extends ResourceMarkerAnnotationModel implements IProblemRequestor { - - private List fGeneratedAnnotations= new ArrayList(); - private List fCollectedProblems= new ArrayList(); - - private ReverseMap fReverseMap= new ReverseMap(); - private List fPreviouslyOverlaid= null; - private List fCurrentlyOverlaid= new ArrayList(); - - /** - * Constructor for XMLAnnotationModel. - * @param resource - */ - public XMLAnnotationModel(IFileEditorInput input) { - super(input.getFile()); - } - - /* - * @see org.eclipse.ui.texteditor.AbstractMarkerAnnotationModel#createMarkerAnnotation(org.eclipse.core.resources.IMarker) - */ - protected MarkerAnnotation createMarkerAnnotation(IMarker marker) { - return new XMLMarkerAnnotation(marker); - } - - protected Position createPositionFromProblem(IProblem problem) { - int start= problem.getOffset(); - if (start >= 0) { - int length= problem.getLength(); - - if (length >= 0) - return new Position(start, length); - } - - return null; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblemRequestor#acceptProblem(org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblem) - */ - public void acceptProblem(IProblem problem) { - fCollectedProblems.add(problem); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblemRequestor#acceptProblem(org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblem) - */ - public void beginReporting() { - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblemRequestor#acceptProblem(org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblem) - */ - public void endReporting() { - boolean temporaryProblemsChanged= false; - fPreviouslyOverlaid= fCurrentlyOverlaid; - fCurrentlyOverlaid= new ArrayList(); - - synchronized (fAnnotations) { - - if (fGeneratedAnnotations.size() > 0) { - temporaryProblemsChanged= true; - removeAnnotations(fGeneratedAnnotations, false, true); - fGeneratedAnnotations.clear(); - } - - if (fCollectedProblems != null && fCollectedProblems.size() > 0) { - Iterator e= fCollectedProblems.iterator(); - while (e.hasNext()) { - - IProblem problem= (IProblem) e.next(); - - Position position= createPositionFromProblem(problem); - if (position != null) { - - XMLProblemAnnotation annotation= new XMLProblemAnnotation(problem); - overlayMarkers(position, annotation); - fGeneratedAnnotations.add(annotation); - addAnnotation(annotation, position, false); - - temporaryProblemsChanged= true; - } - } - - fCollectedProblems.clear(); - } - - removeMarkerOverlays(); - fPreviouslyOverlaid.clear(); - fPreviouslyOverlaid= null; - } - - if (temporaryProblemsChanged) - fireModelChanged(new AnnotationModelEvent(this)); - } - - private void removeMarkerOverlays() { - Iterator e= fPreviouslyOverlaid.iterator(); - while (e.hasNext()) { - XMLMarkerAnnotation annotation= (XMLMarkerAnnotation) e.next(); - annotation.setOverlay(null); - } - } - - /** - * Overlays value with problem annotation. - * @param problemAnnotation - */ - private void setOverlay(Object value, XMLProblemAnnotation problemAnnotation) { - if (value instanceof XMLMarkerAnnotation) { - XMLMarkerAnnotation annotation= (XMLMarkerAnnotation) value; - if (annotation.isProblem()) { - annotation.setOverlay(problemAnnotation); - fPreviouslyOverlaid.remove(annotation); - fCurrentlyOverlaid.add(annotation); - } - } - } - - private void overlayMarkers(Position position, XMLProblemAnnotation problemAnnotation) { - Object value= getAnnotations(position); - if (value instanceof List) { - List list= (List) value; - for (Iterator e = list.iterator(); e.hasNext();) - setOverlay(e.next(), problemAnnotation); - } else { - setOverlay(value, problemAnnotation); - } - } - - private Object getAnnotations(Position position) { - return fReverseMap.get(position); - } - - /* - * @see AnnotationModel#addAnnotation(Annotation, Position, boolean) - */ - protected void addAnnotation(Annotation annotation, Position position, boolean fireModelChanged) { - super.addAnnotation(annotation, position, fireModelChanged); - - Object cached= fReverseMap.get(position); - if (cached == null) - fReverseMap.put(position, annotation); - else if (cached instanceof List) { - List list= (List) cached; - list.add(annotation); - } else if (cached instanceof Annotation) { - List list= new ArrayList(2); - list.add(cached); - list.add(annotation); - fReverseMap.put(position, list); - } - } - - /* - * @see AnnotationModel#removeAllAnnotations(boolean) - */ - protected void removeAllAnnotations(boolean fireModelChanged) { - super.removeAllAnnotations(fireModelChanged); - fReverseMap.clear(); - } - - /* - * @see AnnotationModel#removeAnnotation(Annotation, boolean) - */ - protected void removeAnnotation(Annotation annotation, boolean fireModelChanged) { - Position position= getPosition(annotation); - Object cached= fReverseMap.get(position); - if (cached instanceof List) { - List list= (List) cached; - list.remove(annotation); - if (list.size() == 1) { - fReverseMap.put(position, list.get(0)); - list.clear(); - } - } else if (cached instanceof Annotation) { - fReverseMap.remove(position); - } - - super.removeAnnotation(annotation, fireModelChanged); - } - }; - - /** - * Remembers a XML document model for each element. - */ - protected class XMLFileInfo extends FileInfo { - - public AntModel fModel; - - public XMLFileInfo(IDocument document, IAnnotationModel annotationModel, FileSynchronizer fileSynchronizer, AntModel model) { - super(document, annotationModel, fileSynchronizer); - fModel= model; - } - }; - - /** - * Internal structure for mapping positions to some value. - * The reason for this specific structure is that positions can - * change over time. Thus a lookup is based on value and not - * on hash value. - */ - protected static class ReverseMap { - - static class Entry { - Position fPosition; - Object fValue; - }; - - private List fList= new ArrayList(2); - private int fAnchor= 0; - - public ReverseMap() { - } - - public Object get(Position position) { - - Entry entry; - - // behind anchor - int length= fList.size(); - for (int i= fAnchor; i < length; i++) { - entry= (Entry) fList.get(i); - if (entry.fPosition.equals(position)) { - fAnchor= i; - return entry.fValue; - } - } - - // before anchor - for (int i= 0; i < fAnchor; i++) { - entry= (Entry) fList.get(i); - if (entry.fPosition.equals(position)) { - fAnchor= i; - return entry.fValue; - } - } - - return null; - } - - private int getIndex(Position position) { - Entry entry; - int length= fList.size(); - for (int i= 0; i < length; i++) { - entry= (Entry) fList.get(i); - if (entry.fPosition.equals(position)) - return i; - } - return -1; - } - - public void put(Position position, Object value) { - int index= getIndex(position); - if (index == -1) { - Entry entry= new Entry(); - entry.fPosition= position; - entry.fValue= value; - fList.add(entry); - } else { - Entry entry= (Entry) fList.get(index); - entry.fValue= value; - } - } - - public void remove(Position position) { - int index= getIndex(position); - if (index > -1) - fList.remove(index); - } - - public void clear() { - fList.clear(); - } - } - - - private XMLCore fCore; - - public AntEditorDocumentProvider(XMLCore core) { - super(); - fCore= core; - } - - private IDocumentPartitioner createDocumentPartitioner() { - DefaultPartitioner partitioner = - new DefaultPartitioner( - new AntEditorPartitionScanner(), - new String[] { - AntEditorPartitionScanner.XML_TAG, - AntEditorPartitionScanner.XML_COMMENT }); - return partitioner; - } - - public IDocument createDocument(Object element) throws CoreException { - IDocument document; - if (element instanceof IEditorInput) { - document= new PartiallySynchronizedDocument(); - if (setDocumentContent(document, (IEditorInput) element, getEncoding(element))) { - initializeDocument(document); - } - } else { - document= null; - } - return document; - } - - protected void initializeDocument(IDocument document) { - IDocumentPartitioner partitioner= createDocumentPartitioner(); - document.setDocumentPartitioner(partitioner); - partitioner.connect(document); - } - - public AntModel getAntModel(Object element) { - ElementInfo info= getElementInfo(element); - if (info instanceof XMLFileInfo) { - XMLFileInfo xmlInfo= (XMLFileInfo) info; - return xmlInfo.fModel; - } - return null; - } - - /* - * @see org.eclipse.ui.texteditor.AbstractDocumentProvider#createAnnotationModel(java.lang.Object) - */ - protected IAnnotationModel createAnnotationModel(Object element) throws CoreException { - if (element instanceof IFileEditorInput) { - IFileEditorInput input= (IFileEditorInput) element; - return new XMLAnnotationModel(input); - } - return super.createAnnotationModel(element); - } - - protected AntModel createAntModel(Object element, IDocument document, IAnnotationModel annotationModel) { - IProblemRequestor requestor= annotationModel instanceof IProblemRequestor ? (IProblemRequestor) annotationModel : null; - return new AntModel(fCore, document, requestor, new LocationProvider(element instanceof IFileEditorInput ? ((IFileEditorInput) element).getFile() : null)); - } - - /* - * @see org.eclipse.ui.editors.text.FileDocumentProvider#createElementInfo(java.lang.Object) - */ - protected ElementInfo createElementInfo(Object element) throws CoreException { - if (element instanceof IFileEditorInput) { - - IFileEditorInput input= (IFileEditorInput) element; - - try { - refreshFile(input.getFile()); - } catch (CoreException x) { - handleCoreException(x, "XMLDocumentProvider.createElementInfo: Core exception"); //$NON-NLS-1$ - } - - IDocument d= null; - IStatus s= null; - - try { - d= createDocument(element); - } catch (CoreException x) { - s= x.getStatus(); - d= createEmptyDocument(); - } - - IAnnotationModel m= createAnnotationModel(element); - AntModel o= createAntModel(element, d, m); - o.install(); - FileSynchronizer f= new FileSynchronizer(input); - f.install(); - - XMLFileInfo info= new XMLFileInfo(d, m, f, o); - info.fModificationStamp= computeModificationStamp(input.getFile()); - info.fStatus= s; - info.fEncoding= getPersistedEncoding(input); - - return info; - } - - return super.createElementInfo(element); - } - - /* - * @see org.eclipse.ui.editors.text.FileDocumentProvider#disposeElementInfo(java.lang.Object, org.eclipse.ui.texteditor.AbstractDocumentProvider.ElementInfo) - */ - protected void disposeElementInfo(Object element, ElementInfo info) { - if (info instanceof XMLFileInfo) { - XMLFileInfo xmlInfo= (XMLFileInfo) info; - if (xmlInfo.fModel != null) - xmlInfo.fModel.dispose(); - } - super.disposeElementInfo(element, info); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorPartitionScanner.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorPartitionScanner.java deleted file mode 100644 index 9f860d1b3..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorPartitionScanner.java +++ /dev/null @@ -1,77 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 32890, bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. It has been renamed and edited by GEBIT - * after copying. - */ - -import org.eclipse.jface.text.rules.ICharacterScanner; -import org.eclipse.jface.text.rules.IPredicateRule; -import org.eclipse.jface.text.rules.IToken; -import org.eclipse.jface.text.rules.MultiLineRule; -import org.eclipse.jface.text.rules.RuleBasedPartitionScanner; -import org.eclipse.jface.text.rules.Token; - -/** - * Scanner that scans the document and partitions the document into the three - * supported content types: - * <ul> - * <li>XML_COMMENT</li> - * <li>XML_TAG</li> - * <li>XML_DEFAULT</li> - * </ul> - */ -public class AntEditorPartitionScanner extends RuleBasedPartitionScanner { - public class MultiLineRuleWithEOF extends MultiLineRule { - public MultiLineRuleWithEOF(String startSequence, String endSequence, IToken token) { - super(startSequence, endSequence, token); - } - protected boolean endSequenceDetected(ICharacterScanner scanner) { - boolean result= super.endSequenceDetected(scanner); - if (!result) { - if (scanner.read() == ICharacterScanner.EOF) { - result= true; - } else { - scanner.unread(); - } - } - return result; - } - } - - public final static String XML_DEFAULT = "__xml_default"; //$NON-NLS-1$ - public final static String XML_COMMENT = "__xml_comment"; //$NON-NLS-1$ - public final static String XML_TAG = "__xml_tag"; //$NON-NLS-1$ - - /** - * Creates an instance. - */ - public AntEditorPartitionScanner() { - - IPredicateRule[] rules =new IPredicateRule[2]; - - IToken xmlComment = new Token(XML_COMMENT); - rules[0]= new MultiLineRuleWithEOF("<!--", "-->", xmlComment); //$NON-NLS-1$ //$NON-NLS-2$ - - IToken tag = new Token(XML_TAG); - rules[1]= new TagRule(tag); - - setPredicateRules(rules); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorProcInstrScanner.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorProcInstrScanner.java deleted file mode 100644 index 5a50706ce..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorProcInstrScanner.java +++ /dev/null @@ -1,50 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. It has been renamed and edited by GEBIT - * after copying. - */ - -import org.eclipse.jface.text.TextAttribute; -import org.eclipse.jface.text.rules.IRule; -import org.eclipse.jface.text.rules.IToken; -import org.eclipse.jface.text.rules.RuleBasedScanner; -import org.eclipse.jface.text.rules.SingleLineRule; -import org.eclipse.jface.text.rules.Token; -import org.eclipse.jface.text.rules.WhitespaceRule; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; - -public class AntEditorProcInstrScanner extends RuleBasedScanner { - - public AntEditorProcInstrScanner() { - IRule[] rules =new IRule[2]; - IToken procInstr = - new Token( - new TextAttribute( - ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_PROC_INSTR))); - - //Add rule for processing instructions - rules[0]= new SingleLineRule("<?", "?>", procInstr); //$NON-NLS-1$ //$NON-NLS-2$ - - // Add generic whitespace rule. - rules[1]= new WhitespaceRule(new AntEditorWhitespaceDetector()); - - setRules(rules); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorTagScanner.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorTagScanner.java deleted file mode 100644 index 1ef6840c8..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorTagScanner.java +++ /dev/null @@ -1,53 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 31796, bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. It has been renamed and edited by GEBIT - * after copying. - */ - -import org.eclipse.jface.text.TextAttribute; -import org.eclipse.jface.text.rules.IRule; -import org.eclipse.jface.text.rules.IToken; -import org.eclipse.jface.text.rules.MultiLineRule; -import org.eclipse.jface.text.rules.RuleBasedScanner; -import org.eclipse.jface.text.rules.SingleLineRule; -import org.eclipse.jface.text.rules.Token; -import org.eclipse.jface.text.rules.WhitespaceRule; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; - -public class AntEditorTagScanner extends RuleBasedScanner { - - public AntEditorTagScanner() { - IToken string = - new Token( - new TextAttribute( - ExternalToolsPlugin.getPreferenceColor(IAntEditorColorConstants.P_STRING))); - - IRule[] rules =new IRule[3]; - - // Add rule for single and double quotes - rules[0]= new MultiLineRule("\"", "\"", string, '\\'); //$NON-NLS-1$ //$NON-NLS-2$ - rules[1]= new SingleLineRule("'", "'", string, '\\'); //$NON-NLS-1$ //$NON-NLS-2$ - - // Add generic whitespace rule. - rules[2]= new WhitespaceRule(new AntEditorWhitespaceDetector()); - - setRules(rules); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorWhitespaceDetector.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorWhitespaceDetector.java deleted file mode 100644 index 1897e2e24..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/AntEditorWhitespaceDetector.java +++ /dev/null @@ -1,31 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 29148 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. It has been renamed by GEBIT - * after copying. - */ - -import org.eclipse.jface.text.rules.IWhitespaceDetector; - -public class AntEditorWhitespaceDetector implements IWhitespaceDetector { - - public boolean isWhitespace(char c) { - return (c == ' ' || c == '\t' || c == '\n' || c == '\r'); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IAntEditorColorConstants.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IAntEditorColorConstants.java deleted file mode 100644 index c3999cf37..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IAntEditorColorConstants.java +++ /dev/null @@ -1,35 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import org.eclipse.swt.graphics.RGB; - -/** - * The color constants used by the Ant Editor. - */ -public interface IAntEditorColorConstants { - RGB XML_COMMENT = new RGB(128, 0, 0); - RGB PROC_INSTR = new RGB(128, 128, 128); - RGB STRING= new RGB( 0, 128, 0); - RGB DEFAULT= new RGB( 0, 0, 0); - RGB TAG= new RGB( 0, 0, 128); - - - String P_XML_COMMENT = "antEditor.color.xml_comment"; //$NON-NLS-1$ - String P_PROC_INSTR = "antEditor.color.instr"; //$NON-NLS-1$ - String P_STRING = "antEditor.color.string"; //$NON-NLS-1$ - String P_DEFAULT = "antEditor.color.default"; //$NON-NLS-1$ - String P_TAG = "antEditor.color.tag"; //$NON-NLS-1$ -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IReconcilingParticipant.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IReconcilingParticipant.java deleted file mode 100644 index 4d9addda4..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IReconcilingParticipant.java +++ /dev/null @@ -1,24 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - - - -/** - * Interface of an object participating in reconciling. - */ -public interface IReconcilingParticipant { - - /** - * Called after reconciling has been finished. - */ - void reconciled(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IXMLAnnotation.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IXMLAnnotation.java deleted file mode 100644 index 0bd6ecfdf..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/IXMLAnnotation.java +++ /dev/null @@ -1,87 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import java.util.Iterator; - -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.widgets.Display; - -/** - * Interface of annotations representing markers - * and problems. - * - * @see org.eclipse.core.resources.IMarker - * @see org.eclipse.jdt.core.compiler.IProblem - */ -public interface IXMLAnnotation { - - AnnotationType getAnnotationType(); - - boolean isTemporary(); - - String getMessage(); - - Image getImage(Display display); - - /** - * Returns whether this annotation is relavant. - * <p> - * If the annotation is overlaid then it is not - * relevant. After all overlays have been removed - * the annotation might either become relevant again - * or stay irrelevant. - * </p> - * - * @return <code>true</code> if relevant - * @see #hasOverlay() - */ - boolean isRelevant(); - - /** - * Returns whether this annotation is overlaid. - * - * @return <code>true</code> if overlaid - */ - boolean hasOverlay(); - - /** - * Returns an iterator for iterating over the - * annotation which are overlaid by this annotation. - * - * @return an iterator over the overlaid annotaions - */ - Iterator getOverlaidIterator(); - - /** - * Adds the given annotation to the list of - * annotations which overlaid by this annotations. - * - * @param annotation the problem annoation - */ - void addOverlaid(IXMLAnnotation annotation); - - /** - * Removes the given annotation from the list of - * annotations which are overlaid by this annotation. - * - * @param annotation the problem annoation - */ - void removeOverlaid(IXMLAnnotation annotation); - - /** - * Tells whether this annotation is a problem - * annotation. - * - * @return <code>true</code> if it is a problem annotation - */ - boolean isProblem(); -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/NonRuleBasedDamagerRepairer.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/NonRuleBasedDamagerRepairer.java deleted file mode 100644 index 602003f78..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/NonRuleBasedDamagerRepairer.java +++ /dev/null @@ -1,151 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 31797 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.DocumentEvent; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.IRegion; -import org.eclipse.jface.text.ITypedRegion; -import org.eclipse.jface.text.Region; -import org.eclipse.jface.text.TextAttribute; -import org.eclipse.jface.text.TextPresentation; -import org.eclipse.jface.text.presentation.IPresentationDamager; -import org.eclipse.jface.text.presentation.IPresentationRepairer; -import org.eclipse.jface.util.Assert; -import org.eclipse.swt.custom.StyleRange; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. - */ -public class NonRuleBasedDamagerRepairer implements IPresentationDamager, IPresentationRepairer { - - /** The document this object works on */ - protected IDocument fDocument; - /** The default text attribute if none is returned as data by the current token */ - protected TextAttribute fDefaultTextAttribute; - - public NonRuleBasedDamagerRepairer(TextAttribute defaultTextAttribute) { - Assert.isNotNull(defaultTextAttribute); - - fDefaultTextAttribute = defaultTextAttribute; - } - - /** - * @see IPresentationRepairer#setDocument(IDocument) - */ - public void setDocument(IDocument document) { - fDocument = document; - } - - /** - * Returns the end offset of the line that contains the specified offset or - * if the offset is inside a line delimiter, the end offset of the next line. - * - * @param offset the offset whose line end offset must be computed - * @return the line end offset for the given offset - * @exception BadLocationException if offset is invalid in the current document - */ - private int endOfLineOf(int offset) throws BadLocationException { - - IRegion info = fDocument.getLineInformationOfOffset(offset); - if (offset <= info.getOffset() + info.getLength()) - return info.getOffset() + info.getLength(); - - int line = fDocument.getLineOfOffset(offset); - try { - info = fDocument.getLineInformation(line + 1); - return info.getOffset() + info.getLength(); - } catch (BadLocationException x) { - return fDocument.getLength(); - } - } - - /** - * @see IPresentationDamager#getDamageRegion(ITypedRegion, DocumentEvent, boolean) - */ - public IRegion getDamageRegion( - ITypedRegion partition, - DocumentEvent event, - boolean documentPartitioningChanged) { - if (!documentPartitioningChanged) { - try { - - IRegion info = fDocument.getLineInformationOfOffset(event.getOffset()); - int start = Math.max(partition.getOffset(), info.getOffset()); - - int end = - event.getOffset() - + (event.getText() == null ? event.getLength() : event.getText().length()); - - if (info.getOffset() <= end && end <= info.getOffset() + info.getLength()) { - // optimize the case of the same line - end = info.getOffset() + info.getLength(); - } else { - end = endOfLineOf(end); - } - - end = Math.min(partition.getOffset() + partition.getLength(), end); - return new Region(start, end - start); - - } catch (BadLocationException x) { - } - } - - return partition; - } - - /** - * @see IPresentationRepairer#createPresentation(TextPresentation, ITypedRegion) - */ - public void createPresentation(TextPresentation presentation, ITypedRegion region) { - addRange( - presentation, - region.getOffset(), - region.getLength(), - fDefaultTextAttribute); - } - - /** - * Adds style information to the given text presentation. - * - * @param presentation the text presentation to be extended - * @param offset the offset of the range to be styled - * @param length the length of the range to be styled - * @param attr the attribute describing the style of the range to be styled - */ - private void addRange(TextPresentation presentation, int offset, int length, TextAttribute attr) { - if (attr != null) { - presentation.addStyleRange( - new StyleRange( - offset, - length, - attr.getForeground(), - attr.getBackground(), - attr.getStyle())); - } - } - - /** - * Configures the scanner's default return token. This is the text attribute - * which is returned when none is returned by the current token. - */ - public void setDefaultTextAttribute(TextAttribute defaultTextAttribute) { - Assert.isNotNull(defaultTextAttribute); - fDefaultTextAttribute= defaultTextAttribute; - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/NotifyingReconciler.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/NotifyingReconciler.java deleted file mode 100644 index 05c6bd2ec..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/NotifyingReconciler.java +++ /dev/null @@ -1,58 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - - -import java.util.ArrayList; -import java.util.Iterator; - -import org.eclipse.jface.text.reconciler.DirtyRegion; -import org.eclipse.jface.text.reconciler.IReconcilingStrategy; -import org.eclipse.jface.text.reconciler.MonoReconciler; - - -public class NotifyingReconciler extends MonoReconciler { - - private ArrayList fReconcilingParticipants= new ArrayList(); - - /** - * Constructor for NotifyingReconciler. - * @param strategy - * @param isIncremental - */ - public NotifyingReconciler(IReconcilingStrategy strategy, boolean isIncremental) { - super(strategy, isIncremental); - } - - /* - * @see org.eclipse.jface.text.reconciler.AbstractReconciler#process(org.eclipse.jface.text.reconciler.DirtyRegion) - */ - protected void process(DirtyRegion dirtyRegion) { - super.process(dirtyRegion); - notifyReconcilingParticipants(); - } - - public void addReconcilingParticipant(IReconcilingParticipant participant) { - fReconcilingParticipants.add(participant); - } - - public void removeReconcilingParticipant(IReconcilingParticipant participant) { - fReconcilingParticipants.remove(participant); - } - - protected void notifyReconcilingParticipants() { - Iterator i= new ArrayList(fReconcilingParticipants).iterator(); - while (i.hasNext()) { - ((IReconcilingParticipant) i.next()).reconciled(); - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/PartiallySynchronizedDocument.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/PartiallySynchronizedDocument.java deleted file mode 100644 index 03975330c..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/PartiallySynchronizedDocument.java +++ /dev/null @@ -1,70 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.Document; - -/** - * Document that can also be used by a background reconciler. - */ -public class PartiallySynchronizedDocument extends Document { - - /* - * @see IDocumentExtension#startSequentialRewrite(boolean) - */ - synchronized public void startSequentialRewrite(boolean normalized) { - super.startSequentialRewrite(normalized); - } - - /* - * @see IDocumentExtension#stopSequentialRewrite() - */ - synchronized public void stopSequentialRewrite() { - super.stopSequentialRewrite(); - } - - /* - * @see IDocument#get() - */ - synchronized public String get() { - return super.get(); - } - - /* - * @see IDocument#get(int, int) - */ - synchronized public String get(int offset, int length) throws BadLocationException { - return super.get(offset, length); - } - - /* - * @see IDocument#getChar(int) - */ - synchronized public char getChar(int offset) throws BadLocationException { - return super.getChar(offset); - } - - /* - * @see IDocument#replace(int, int, String) - */ - synchronized public void replace(int offset, int length, String text) throws BadLocationException { - super.replace(offset, length, text); - } - - /* - * @see IDocument#set(String) - */ - synchronized public void set(String text) { - super.set(text); - } -}; diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/TagRule.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/TagRule.java deleted file mode 100644 index 82a1300a5..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/TagRule.java +++ /dev/null @@ -1,52 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -/* - * This file originates from an internal package of Eclipse's - * Manifest Editor. It has been copied by GEBIT to here in order to - * permanently use those features. It has been renamed and edited by GEBIT - * after copying. - */ - -import org.eclipse.jface.text.rules.*; - -public class TagRule extends MultiLineRule { - - public TagRule(IToken token) { - super("<", ">", token); //$NON-NLS-1$ //$NON-NLS-2$ - } - - protected boolean sequenceDetected(ICharacterScanner scanner, char[] sequence, boolean eofAllowed) { - int c = scanner.read(); - if (sequence[0] == '<') { - if (c == '?') { - // processing instruction - abort - scanner.unread(); - return false; - } - if (c == '!') { - scanner.unread(); - // comment - abort - return false; - } - } else if (sequence[0] == '>') { - scanner.unread(); - } - - return super.sequenceDetected(scanner, sequence, eofAllowed); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLAnnotationHover.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLAnnotationHover.java deleted file mode 100644 index 0788e64a4..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLAnnotationHover.java +++ /dev/null @@ -1,195 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import java.util.ArrayList; -import java.util.HashMap; -import java.util.Iterator; -import java.util.List; -import java.util.Map; - -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.Position; -import org.eclipse.jface.text.source.Annotation; -import org.eclipse.jface.text.source.IAnnotationHover; -import org.eclipse.jface.text.source.IAnnotationModel; -import org.eclipse.jface.text.source.ISourceViewer; -import org.eclipse.ui.externaltools.internal.ant.editor.AntEditorMessages; -import org.eclipse.ui.externaltools.internal.ant.editor.derived.HTMLPrinter; - - -/** - * Determines all markers for the given line and collects, concatenates, and formates - * their messages. - */ -public class XMLAnnotationHover implements IAnnotationHover { - - /** - * Returns the distance to the ruler line. - */ - protected int compareRulerLine(Position position, IDocument document, int line) { - - if (position.getOffset() > -1 && position.getLength() > -1) { - try { - int xmlAnnotationLine= document.getLineOfOffset(position.getOffset()); - if (line == xmlAnnotationLine) - return 1; - if (xmlAnnotationLine <= line && line <= document.getLineOfOffset(position.getOffset() + position.getLength())) - return 2; - } catch (BadLocationException x) { - } - } - - return 0; - } - - /** - * Selects a set of markers from the two lists. By default, it just returns - * the set of exact matches. - */ - protected List select(List exactMatch, List including) { - return exactMatch; - } - - /** - * Returns one marker which includes the ruler's line of activity. - */ - protected List getXMLAnnotationsForLine(ISourceViewer viewer, int line) { - - IDocument document= viewer.getDocument(); - IAnnotationModel model= viewer.getAnnotationModel(); - - if (model == null) - return null; - - List exact= new ArrayList(); - List including= new ArrayList(); - - Iterator e= model.getAnnotationIterator(); - HashMap messagesAtPosition= new HashMap(); - while (e.hasNext()) { - Object o= e.next(); - if (o instanceof IXMLAnnotation) { - IXMLAnnotation a= (IXMLAnnotation)o; - if (!a.hasOverlay()) { - Position position= model.getPosition((Annotation)a); - if (position == null) - continue; - - if (isDuplicateXMLAnnotation(messagesAtPosition, position, a.getMessage())) - continue; - - switch (compareRulerLine(position, document, line)) { - case 1: - exact.add(a); - break; - case 2: - including.add(a); - break; - } - } - } - } - - return select(exact, including); - } - - private boolean isDuplicateXMLAnnotation(Map messagesAtPosition, Position position, String message) { - if (messagesAtPosition.containsKey(position)) { - Object value= messagesAtPosition.get(position); - if (message.equals(value)) - return true; - - if (value instanceof List) { - List messages= (List)value; - if (messages.contains(message)) - return true; - else - messages.add(message); - } else { - ArrayList messages= new ArrayList(); - messages.add(value); - messages.add(message); - messagesAtPosition.put(position, messages); - } - } else - messagesAtPosition.put(position, message); - return false; - } - - /* - * @see IVerticalRulerHover#getHoverInfo(ISourceViewer, int) - */ - public String getHoverInfo(ISourceViewer sourceViewer, int lineNumber) { - List xmlAnnotations= getXMLAnnotationsForLine(sourceViewer, lineNumber); - if (xmlAnnotations != null) { - - if (xmlAnnotations.size() == 1) { - - // optimization - IXMLAnnotation xmlAnnotation= (IXMLAnnotation)xmlAnnotations.get(0); - String message= xmlAnnotation.getMessage(); - if (message != null && message.trim().length() > 0) - return formatSingleMessage(message); - - } else { - - List messages= new ArrayList(); - - Iterator e= xmlAnnotations.iterator(); - while (e.hasNext()) { - IXMLAnnotation xmlAnnotation= (IXMLAnnotation)e.next(); - String message= xmlAnnotation.getMessage(); - if (message != null && message.trim().length() > 0) - messages.add(message.trim()); - } - - if (messages.size() == 1) - return formatSingleMessage((String) messages.get(0)); - - if (messages.size() > 1) - return formatMultipleMessages(messages); - } - } - - return null; - } - - /* - * Formats a message as HTML text. - */ - private String formatSingleMessage(String message) { - StringBuffer buffer= new StringBuffer(); - HTMLPrinter.addPageProlog(buffer); - HTMLPrinter.addParagraph(buffer, HTMLPrinter.convertToHTMLContent(message)); - HTMLPrinter.addPageEpilog(buffer); - return buffer.toString(); - } - - /* - * Formats several message as HTML text. - */ - private String formatMultipleMessages(List messages) { - StringBuffer buffer= new StringBuffer(); - HTMLPrinter.addPageProlog(buffer); - HTMLPrinter.addParagraph(buffer, HTMLPrinter.convertToHTMLContent(AntEditorMessages.getString("AntAnnotationHover.multipleMarkersAtThisLine"))); //$NON-NLS-1$ - - HTMLPrinter.startBulletList(buffer); - Iterator e= messages.iterator(); - while (e.hasNext()) - HTMLPrinter.addBullet(buffer, HTMLPrinter.convertToHTMLContent((String) e.next())); - HTMLPrinter.endBulletList(buffer); - - HTMLPrinter.addPageEpilog(buffer); - return buffer.toString(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLAnnotationIterator.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLAnnotationIterator.java deleted file mode 100644 index cff408570..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLAnnotationIterator.java +++ /dev/null @@ -1,75 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import java.util.Iterator; -import org.eclipse.jface.text.source.IAnnotationModel; - - -/** - * Filters problems based on their types. - */ -public class XMLAnnotationIterator implements Iterator { - - private Iterator fIterator; - private IXMLAnnotation fNext; - private boolean fSkipIrrelevants; - - public XMLAnnotationIterator(IAnnotationModel model, boolean skipIrrelevants) { - fIterator= model.getAnnotationIterator(); - fSkipIrrelevants= skipIrrelevants; - skip(); - } - - private void skip() { - while (fIterator.hasNext()) { - Object next= fIterator.next(); - if (next instanceof IXMLAnnotation) { - IXMLAnnotation a= (IXMLAnnotation) next; - if (fSkipIrrelevants) { - if (a.isRelevant()) { - fNext= a; - return; - } - } else { - fNext= a; - return; - } - } - } - fNext= null; - } - - /* - * @see Iterator#hasNext() - */ - public boolean hasNext() { - return fNext != null; - } - - /* - * @see Iterator#next() - */ - public Object next() { - try { - return fNext; - } finally { - skip(); - } - } - - /* - * @see Iterator#remove() - */ - public void remove() { - throw new UnsupportedOperationException(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLMarkerAnnotation.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLMarkerAnnotation.java deleted file mode 100644 index 0368fab8a..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLMarkerAnnotation.java +++ /dev/null @@ -1,226 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - - -import java.util.Iterator; - -import org.eclipse.core.resources.IMarker; -import org.eclipse.core.runtime.CoreException; - -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.widgets.Display; - -import org.eclipse.jface.resource.ImageRegistry; -import org.eclipse.jface.text.Assert; - -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.texteditor.MarkerAnnotation; - - -public class XMLMarkerAnnotation extends MarkerAnnotation implements IXMLAnnotation { - - private static final int NO_IMAGE= 0; - private static final int ORIGINAL_MARKER_IMAGE= 1; - private static final int OVERLAY_IMAGE= 4; - private static final int GRAY_IMAGE= 5; - - private static ImageRegistry fgGrayMarkersImageRegistry; - - private IXMLAnnotation fOverlay; - private boolean fNotRelevant= false; - private AnnotationType fType; - private int fImageType; - - public XMLMarkerAnnotation(IMarker marker) { - super(marker); - } - - /** - * Initializes the annotation's icon representation and its drawing layer - * based upon the properties of the underlying marker. - */ - protected void initialize() { - fImageType= NO_IMAGE; - IMarker marker= getMarker(); - - fType= AnnotationType.UNKNOWN; - try { - if (marker != null && marker.exists()) { - if (marker.isSubtypeOf(IMarker.BOOKMARK)) { - fType= AnnotationType.BOOKMARK; - } else if (marker.isSubtypeOf(IMarker.TASK)) { - fType= AnnotationType.TASK; - } else if (marker.isSubtypeOf(IMarker.PROBLEM)) { - int severity= marker.getAttribute(IMarker.SEVERITY, -1); - switch (severity) { - case IMarker.SEVERITY_ERROR: - fType= AnnotationType.ERROR; - break; - case IMarker.SEVERITY_WARNING: - fType= AnnotationType.WARNING; - break; - case IMarker.SEVERITY_INFO: - fType= AnnotationType.INFO; - break; - } -// } else if (marker.isSubtypeOf(SearchUI.SEARCH_MARKER)) { TODO: fix -// result= AnnotationType.SEARCH; - } - } - } catch (CoreException e) { - ExternalToolsPlugin.getDefault().log(e); - } - super.initialize(); - } - - /* - * @see IXMLAnnotation#getMessage() - */ - public String getMessage() { - IMarker marker= getMarker(); - if (marker == null || !marker.exists()) - return ""; //$NON-NLS-1$ - else - return marker.getAttribute(IMarker.MESSAGE, ""); //$NON-NLS-1$ - } - - /* - * @see IXMLAnnotation#isTemporary() - */ - public boolean isTemporary() { - return false; - } - - /* - * @see IXMLAnnotation#isProblem() - */ - public boolean isProblem() { - return fType == AnnotationType.WARNING || fType == AnnotationType.ERROR; - } - - /* - * @see IXMLAnnotation#isRelevant() - */ - public boolean isRelevant() { - return !fNotRelevant; - } - - /** - * Overlays this annotation with the given xmlAnnotation. - * - * @param javaAnnotation annotation that is overlaid by this annotation - */ - public void setOverlay(IXMLAnnotation xmlAnnotation) { - if (fOverlay != null) - fOverlay.removeOverlaid(this); - - fOverlay= xmlAnnotation; - fNotRelevant= (fNotRelevant || fOverlay != null); - - if (xmlAnnotation != null) - xmlAnnotation.addOverlaid(this); - } - - /* - * @see IXMLAnnotation#hasOverlay() - */ - public boolean hasOverlay() { - return fOverlay != null; - } - - /* - * @see MarkerAnnotation#getImage(Display) - */ - public Image getImage(Display display) { - int newImageType= NO_IMAGE; - - if (hasOverlay()) - newImageType= OVERLAY_IMAGE; - else if (isRelevant()) - newImageType= ORIGINAL_MARKER_IMAGE; - else - newImageType= GRAY_IMAGE; - - if (fImageType == newImageType && newImageType != OVERLAY_IMAGE) - // Nothing changed - simply return the current image - return super.getImage(display); - - Image newImage= null; - switch (newImageType) { - case ORIGINAL_MARKER_IMAGE: - newImage= null; - break; - case OVERLAY_IMAGE: - newImage= fOverlay.getImage(display); - break; - case GRAY_IMAGE: - if (fImageType != ORIGINAL_MARKER_IMAGE) - setImage(null); - Image originalImage= super.getImage(display); - if (originalImage != null) { - ImageRegistry imageRegistry= getGrayMarkerImageRegistry(display); - if (imageRegistry != null) { - String key= Integer.toString(originalImage.hashCode()); - Image grayImage= imageRegistry.get(key); - if (grayImage == null) { - grayImage= new Image(display, originalImage, SWT.IMAGE_GRAY); - imageRegistry.put(key, grayImage); - } - newImage= grayImage; - } - } - break; - default: - Assert.isLegal(false); - } - - fImageType= newImageType; - setImage(newImage); - return super.getImage(display); - } - - private ImageRegistry getGrayMarkerImageRegistry(Display display) { - if (fgGrayMarkersImageRegistry == null) - fgGrayMarkersImageRegistry= new ImageRegistry(display); - return fgGrayMarkersImageRegistry; - } - - /* - * @see IXMLAnnotation#addOverlaid(IXMLAnnotation) - */ - public void addOverlaid(IXMLAnnotation annotation) { - // not supported - } - - /* - * @see IXMLAnnotation#removeOverlaid(IXMLAnnotation) - */ - public void removeOverlaid(IXMLAnnotation annotation) { - // not supported - } - - /* - * @see IXMLAnnotation#getOverlaidIterator() - */ - public Iterator getOverlaidIterator() { - // not supported - return null; - } - - /* - * @see org.eclipse.jdt.internal.ui.javaeditor.IXMLAnnotation#getAnnotationType() - */ - public AnnotationType getAnnotationType() { - return fType; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLProblemAnnotation.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLProblemAnnotation.java deleted file mode 100644 index 90dabcd4b..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLProblemAnnotation.java +++ /dev/null @@ -1,129 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.jface.text.source.Annotation; -import org.eclipse.swt.graphics.GC; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.graphics.Rectangle; -import org.eclipse.swt.widgets.Canvas; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.IProblem; -import org.eclipse.ui.texteditor.MarkerAnnotation; - -/** - * Annotation representating an <code>IProblem</code>. - */ -public class XMLProblemAnnotation extends Annotation implements IXMLAnnotation { - - private List fOverlaids; - private IProblem fProblem; - private AnnotationType fType; - - - public XMLProblemAnnotation(IProblem problem) { - - fProblem= problem; - setLayer(MarkerAnnotation.PROBLEM_LAYER + 1); - - if (fProblem.isError()) - fType= AnnotationType.ERROR; - else if (fProblem.isWarning()) - fType= AnnotationType.WARNING; - else - fType= AnnotationType.INFO; - } - - /* - * @see Annotation#paint - */ - public void paint(GC gc, Canvas canvas, Rectangle r) { - } - - /* - * @see IXMLAnnotation#getImage(Display) - */ - public Image getImage(Display display) { - return null; - } - - /* - * @see IXMLAnnotation#getMessage() - */ - public String getMessage() { - return fProblem.getMessage(); - } - - /* - * @see IXMLAnnotation#isTemporary() - */ - public boolean isTemporary() { - return true; - } - - /* - * @see IXMLAnnotation#isProblem() - */ - public boolean isProblem() { - return fType == AnnotationType.WARNING || fType == AnnotationType.ERROR; - } - - /* - * @see IXMLAnnotation#isRelevant() - */ - public boolean isRelevant() { - return true; - } - - /* - * @see IXMLAnnotation#hasOverlay() - */ - public boolean hasOverlay() { - return false; - } - - /* - * @see IXMLAnnotation#addOverlaid(IXMLAnnotation) - */ - public void addOverlaid(IXMLAnnotation annotation) { - if (fOverlaids == null) - fOverlaids= new ArrayList(1); - fOverlaids.add(annotation); - } - - /* - * @see IXMLAnnotation#removeOverlaid(IXMLAnnotation) - */ - public void removeOverlaid(IXMLAnnotation annotation) { - if (fOverlaids != null) { - fOverlaids.remove(annotation); - if (fOverlaids.size() == 0) - fOverlaids= null; - } - } - - /* - * @see IXMLAnnotation#getOverlaidIterator() - */ - public Iterator getOverlaidIterator() { - if (fOverlaids != null) - return fOverlaids.iterator(); - return null; - } - - public AnnotationType getAnnotationType() { - return fType; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLReconcilingStrategy.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLReconcilingStrategy.java deleted file mode 100644 index 3283158bf..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLReconcilingStrategy.java +++ /dev/null @@ -1,76 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.text; - - -import org.eclipse.core.runtime.IProgressMonitor; -import org.eclipse.jface.text.IDocument; -import org.eclipse.jface.text.IRegion; -import org.eclipse.jface.text.reconciler.DirtyRegion; -import org.eclipse.jface.text.reconciler.IReconcilingStrategy; -import org.eclipse.jface.text.reconciler.IReconcilingStrategyExtension; -import org.eclipse.ui.externaltools.internal.ant.editor.outline.AntModel; -import org.eclipse.ui.texteditor.IDocumentProvider; -import org.eclipse.ui.texteditor.ITextEditor; - - -public class XMLReconcilingStrategy implements IReconcilingStrategy, IReconcilingStrategyExtension { - - private ITextEditor fEditor; - - public XMLReconcilingStrategy(ITextEditor editor) { - fEditor= editor; - } - - private void internalReconcile() { - IDocumentProvider provider= fEditor.getDocumentProvider(); - if (provider instanceof AntEditorDocumentProvider) { - AntEditorDocumentProvider documentProvider= (AntEditorDocumentProvider) provider; - AntModel model= documentProvider.getAntModel(fEditor.getEditorInput()); - if (model != null) - model.reconcile(); - } - } - - /* - * @see IReconcilingStrategy#reconcile(IRegion) - */ - public void reconcile(IRegion partition) { - internalReconcile(); - } - - /* - * @see IReconcilingStrategy#reconcile(DirtyRegion, IRegion) - */ - public void reconcile(DirtyRegion dirtyRegion, IRegion subRegion) { - internalReconcile(); - } - - /* - * @see IReconcilingStrategy#setDocument(IDocument) - */ - public void setDocument(IDocument document) { - } - - /* - * @see org.eclipse.jface.text.reconciler.IReconcilingStrategyExtension#setProgressMonitor(org.eclipse.core.runtime.IProgressMonitor) - */ - public void setProgressMonitor(IProgressMonitor monitor) { - } - - /* - * @see org.eclipse.jface.text.reconciler.IReconcilingStrategyExtension#initialReconcile() - */ - public void initialReconcile() { - internalReconcile(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLTextHover.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLTextHover.java deleted file mode 100644 index 4b67be422..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/text/XMLTextHover.java +++ /dev/null @@ -1,77 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.text; - - -import java.util.Iterator; - -import org.eclipse.jface.text.IRegion; -import org.eclipse.jface.text.ITextHover; -import org.eclipse.jface.text.ITextViewer; -import org.eclipse.jface.text.Position; -import org.eclipse.jface.text.Region; -import org.eclipse.jface.text.source.Annotation; -import org.eclipse.jface.text.source.IAnnotationModel; -import org.eclipse.jface.text.source.ISourceViewer; -import org.eclipse.ui.externaltools.internal.ant.editor.derived.HTMLPrinter; - - -public class XMLTextHover implements ITextHover { - - /* - * Formats a message as HTML text. - */ - private String formatMessage(String message) { - StringBuffer buffer= new StringBuffer(); - HTMLPrinter.addPageProlog(buffer); - HTMLPrinter.addParagraph(buffer, HTMLPrinter.convertToHTMLContent(message)); - HTMLPrinter.addPageEpilog(buffer); - return buffer.toString(); - } - - /* - * @see ITextHover#getHoverInfo(ITextViewer, IRegion) - */ - public String getHoverInfo(ITextViewer textViewer, IRegion hoverRegion) { - - if (!(textViewer instanceof ISourceViewer)) - return null; - - ISourceViewer sourceViewer= (ISourceViewer) textViewer; - IAnnotationModel model= sourceViewer.getAnnotationModel(); - - if (model != null) { - Iterator e= new XMLAnnotationIterator(model, true); - while (e.hasNext()) { - Annotation a= (Annotation) e.next(); - Position p= model.getPosition(a); - if (p.overlapsWith(hoverRegion.getOffset(), hoverRegion.getLength())) { - String msg= ((IXMLAnnotation) a).getMessage(); - if (msg != null && msg.trim().length() > 0) - return formatMessage(msg); - } - } - } - - return null; - } - - /* - * @see ITextHover#getHoverRegion(ITextViewer, int) - */ - public IRegion getHoverRegion(ITextViewer textViewer, int offset) { - int startOffset= offset > 0 ? offset - 1 : offset; - int documentLength= textViewer.getDocument() != null ? textViewer.getDocument().getLength() : 0; - int endOffset= offset < documentLength - 1 ? offset + 1 : offset; - return new Region(startOffset, endOffset - startOffset); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/AntEditorToolsMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/AntEditorToolsMessages.java deleted file mode 100644 index 4cc3ca2eb..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/AntEditorToolsMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.tools; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntEditorToolsMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.editor.tools.AntEditorToolsMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntEditorToolsMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/AntEditorToolsMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/AntEditorToolsMessages.properties deleted file mode 100644 index 7602f99b2..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/AntEditorToolsMessages.properties +++ /dev/null @@ -1,14 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -TaskXMLFileMerger.No_Task=Did not find Task \"{0}\" in HTML XML file. -TaskXMLFileMerger.No_TaskName=Did not find TaskName in TargetTaskNode: {0} -TaskXMLFileMerger.Could_not_print=Could not print XML: {0} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/TaskXMLFileMerger.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/TaskXMLFileMerger.java deleted file mode 100644 index 004e0ff7b..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/tools/TaskXMLFileMerger.java +++ /dev/null @@ -1,339 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 24108 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.tools; - -import java.io.IOException; -import java.net.URL; -import java.text.MessageFormat; -import java.util.Vector; - -import javax.xml.parsers.DocumentBuilder; -import javax.xml.parsers.DocumentBuilderFactory; -import javax.xml.parsers.ParserConfigurationException; - -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.w3c.dom.Document; -import org.w3c.dom.NamedNodeMap; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; -import org.xml.sax.InputSource; -import org.xml.sax.SAXException; - -/** - * This class can be used to merge the TaskDescriptions xml - * file containing information if attributes are required or not. - * The xml automatically generated from the proposed xdoclet in the Apache Ant's - * project currently has no such information. In the future the task writers - * hopefully will include this information in the surce code comments. Our - * template currently inserts an attriubte required="NOTDEFINED" and this class - * replaces that field if its defined in the xml file we have generated from the - * information based on the html files in the Apache Ant's manual directory. - */ -public class TaskXMLFileMerger { - - //Definitions for the HTML Generated XML File - public static String HTML_TASKS_DESCRIPTION_XML_FILE_NAME = "/tasks.xml"; //$NON-NLS-1$ - public static String HTML_XML_TAG_TASKS = "TASKS"; //$NON-NLS-1$ - public static String HTML_XML_TAG_TASK = "TASK"; //$NON-NLS-1$ - public static String HTML_XML_TAG_ATTRIBUTE = "ATTRIBUTE"; //$NON-NLS-1$ - //public static String HTML_XML_TAG_DESCRIPTION = "DESCRIPTION"; - public static String HTML_XML_ATTRIBUTE_NAME = "NAME"; //$NON-NLS-1$ - public static String HTML_XML_ATTRIBUTE_REQUIRED = "REQUIRED"; //$NON-NLS-1$ - - //Definitions for the XDoclet Genereated XML File - public static String XDOC_TASKS_DESCRIPTION_XML_FILE_NAME = "/XDOCtasks.xml"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_TASKS = "tasks"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_TASK = "task"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_NAME = "name"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_STRUCTURE = "structure"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_ATTRIBUTES = "attributes"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_ATTRIBUTE = "attribute"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_ELEMENTS = "elements"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_ELEMENT = "element"; //$NON-NLS-1$ - public static String XDOC_XML_TAG_REQUIRED = "required"; //$NON-NLS-1$ - - - protected NodeList taskNodes_HTML = null; - protected NodeList taskNodes_XDOC = null; - public Document xdocXMLDocument = null; - - /** - * Creates an initialized instance. - */ - public TaskXMLFileMerger() { - initialize(); - } - - - /** - * Parses the task description xml files and stores the information. - */ - private void initialize() { - - Document tmpDocument = null; - - //Get All the Tasks in the HTML XML Generated file and store in the taskNodes_HTML - tmpDocument = parseFile(HTML_TASKS_DESCRIPTION_XML_FILE_NAME); - taskNodes_HTML = tmpDocument.getFirstChild().getChildNodes(); - - //Do the same for the XDOC XML Generated file - tmpDocument = parseFile(XDOC_TASKS_DESCRIPTION_XML_FILE_NAME); - taskNodes_XDOC = tmpDocument.getFirstChild().getChildNodes(); - xdocXMLDocument = tmpDocument; -/* - Document tempDocument = parseFile(aFileName); - Node tempRootNode = tempDocument.getDocumentElement(); - NodeList tempChildNodes = tempRootNode.getChildNodes(); - for(int i=0; i<tempChildNodes.getLength(); i++) { - Node tempNode = tempChildNodes.item(i); - if(tempNode.getNodeType() == Node.ELEMENT_NODE) { - String tempTagName = tempNode.getNodeName(); - if(tempTagName.equals(anXML_TAG_TASK)) { - NamedNodeMap tempAttributes = tempNode.getAttributes(); - Node tempAttributeNode = tempAttributes.getNamedItem(anXML_ATTRIBUTE_NAME); - if(tempAttributeNode != null) { - String tempTaskName = tempAttributeNode.getNodeValue(); - if(tempTaskName != null) { - aHashMap.put(tempTaskName, tempNode); - } - } - } - } - } -*/ - } - - - /** - * This is the function that does all the work. Calling this - * will cause all Required fields in all Attributes in the - * XMLDoc file to be replaced with the value in the corresponding - * Attributes Required field in the HTML Xml file. - */ - public void runReplaceAttributeRequiredProcess() { - - //Iterate over all the tasks. If task is found in sourceList, - //then iterate over all the attributes, try to find out if the - //the attribute is required. - for(int i = 0; i < taskNodes_XDOC.getLength(); ++i ) { - Node tmpTargetNode = taskNodes_XDOC.item(i); - - if(tmpTargetNode.getNodeType() == Node.ELEMENT_NODE ) { - replaceAttributeRequiredInTaskNode(tmpTargetNode); - } - } - } - - private void replaceAttributeRequiredInTaskNode(Node aTargetTaskNode) { - - String tmpTaskName = aTargetTaskNode.getAttributes().getNamedItem(XDOC_XML_TAG_NAME).getNodeValue(); - - if(tmpTaskName != null ) { - Node tmpSourceNode = getTaskInHTMLGeneratedTaskListNamed(tmpTaskName); - - if(tmpSourceNode != null) { - replaceAttributeRequiredInXMLTaskNodeWithAttributeRequiredInHTMLNode(aTargetTaskNode, - tmpSourceNode); - } - else { - System.out.println(MessageFormat.format(AntEditorToolsMessages.getString("TaskXMLFileMerger.No_Task"), new String[]{tmpTaskName})); //$NON-NLS-1$ - } - } - else { - System.out.println(MessageFormat.format(AntEditorToolsMessages.getString("TaskXMLFileMerger.No_TaskName"), new String[]{aTargetTaskNode.toString()})); //$NON-NLS-1$ - } - } - - private Node getTaskInHTMLGeneratedTaskListNamed(String aTaskName) { - - for(int i = 0; i<taskNodes_HTML.getLength(); ++i ) { - - Node tmpTaskNode = taskNodes_HTML.item(i); - if(tmpTaskNode.getNodeType() == Node.ELEMENT_NODE ) { - String tmpTagName = tmpTaskNode.getNodeName(); - if(tmpTagName.equals(HTML_XML_TAG_TASK)) { - NamedNodeMap tmpMap = tmpTaskNode.getAttributes(); - Node tmpNameNode = tmpMap.getNamedItem(HTML_XML_ATTRIBUTE_NAME); - if( aTaskName.equals(tmpNameNode.getNodeValue()) ) { - return tmpTaskNode; - } - } - } - } - //Not found - return null; - } - - private void replaceAttributeRequiredInXMLTaskNodeWithAttributeRequiredInHTMLNode(Node aTargetTaskNode, - Node aSourceTaskNode) { - - Node tmpStructureNode = getChildNodeNamedWithTypeFromNode( XDOC_XML_TAG_STRUCTURE, - Node.ELEMENT_NODE, - aTargetTaskNode ); - - if(tmpStructureNode != null ) { - Node tmpTargetAttributesNode = getChildNodeNamedWithTypeFromNode(XDOC_XML_TAG_ATTRIBUTES, - Node.ELEMENT_NODE, - tmpStructureNode); - if(tmpTargetAttributesNode != null ) { - Vector tmpTargetAttributesVector = getAttributeNodesFromXMLAttributesNode(tmpTargetAttributesNode); - Vector tmpSourceAttributesVector = getAttributeNodesFromHTMLTaskNode(aSourceTaskNode); - - //Iterate over all the attributes in the targetTaskNode - for(int i=0; i < tmpTargetAttributesVector.size(); ++i) { - Node tmpAttributeNode = (Node)tmpTargetAttributesVector.get(i); - replaceAttributeRequiredInAttributeNodeWithValueFoundInNodeVector(tmpAttributeNode, tmpSourceAttributesVector); - } - } - } - } - - private void replaceAttributeRequiredInAttributeNodeWithValueFoundInNodeVector(Node aTargetAttributeNode, Vector aSourceAttributeVector) { - - NamedNodeMap tmpTargetNamedNodeMap = aTargetAttributeNode.getAttributes(); - String tmpTargetAttributeName = tmpTargetNamedNodeMap.getNamedItem(XDOC_XML_TAG_NAME).getNodeValue(); - - String tmpSourceAttributeName = null; - String tmpSourceRequiredValue = null; - - for(int i=0; i < aSourceAttributeVector.size(); ++i) { - Node tmpSourceAttributeNode = (Node)aSourceAttributeVector.get(i); - NamedNodeMap tmpSourceAttributeNamedNodeMap = tmpSourceAttributeNode.getAttributes(); - tmpSourceAttributeName = tmpSourceAttributeNamedNodeMap.getNamedItem(HTML_XML_ATTRIBUTE_NAME).getNodeValue(); - //If the Attribute Name is the same we replace the REQUIRED Value - if(tmpTargetAttributeName.equals(tmpSourceAttributeName) ){ - tmpSourceRequiredValue = tmpSourceAttributeNamedNodeMap.getNamedItem(HTML_XML_ATTRIBUTE_REQUIRED).getNodeValue(); - //Set the Vaule to the on we just got. - tmpTargetNamedNodeMap.getNamedItem(XDOC_XML_TAG_REQUIRED).setNodeValue(tmpSourceRequiredValue); - } - } - } - - private Vector getAttributeNodesFromXMLAttributesNode(Node anXMLAttributesNode){ - - Vector allAttributes = new Vector(); - NodeList tmpList = anXMLAttributesNode.getChildNodes(); - - for(int i = 0; i<tmpList.getLength(); ++i) { - Node tmpNode = tmpList.item(i); - if(tmpNode.getNodeType() == Node.ELEMENT_NODE - && XDOC_XML_TAG_ATTRIBUTE.equals(tmpNode.getNodeName()) ) { - allAttributes.add(tmpNode); - } - } - return allAttributes; - } - - private Vector getAttributeNodesFromHTMLTaskNode(Node anHTTP_XML_TaskNode) { - - Vector tmpVector = new Vector(); - NodeList tmpList = anHTTP_XML_TaskNode.getChildNodes(); - - for(int i = 0; i < tmpList.getLength(); ++i) { - Node tmpNode = tmpList.item(i); - if(tmpNode.getNodeType() == Node.ELEMENT_NODE - && HTML_XML_TAG_ATTRIBUTE.equals(tmpNode.getNodeName()) ) { - tmpVector.add(tmpNode); - } - } - - return tmpVector; - } - - /** - * Returns the ChildNode of the node defined by the Arguments. The - * first child found matching the criterias is returned. - * - * @param aNodeName The Name of the Node to return. - * @param aType The Type of the node @see Node - * @param aParentNode The Node to get the child from - * - * @return The First Child Node found matching the criterias, - * or null if none is found. - */ - private Node getChildNodeNamedWithTypeFromNode(String aName, short aNodeType, Node aNode ) { - - NodeList tmpNodeList = aNode.getChildNodes(); - for(int i=0; i<tmpNodeList.getLength(); ++i ) { - Node tmpNode = tmpNodeList.item(i); - if( (tmpNode.getNodeType() == aNodeType) && aName.equals(tmpNode.getNodeName()) ) { - return tmpNode; - } - } - //Not found - return null; - } - - - /** - * Returns the (DOM) document as a result of parsing the file with the - * specified file name. - * <P> - * The file will be loaded as resource, thus must begin with '/' and must - * be relative to the classpath. - */ - private Document parseFile(String aFileName) { - Document tempDocument = null; - - DocumentBuilderFactory tempFactory = DocumentBuilderFactory.newInstance(); - tempFactory.setIgnoringComments(true); - tempFactory.setIgnoringElementContentWhitespace(true); - tempFactory.setCoalescing(true); - - try { - DocumentBuilder tempDocBuilder = tempFactory.newDocumentBuilder(); - URL tempURL = getClass().getResource(aFileName); - InputSource tempInputSource = new InputSource(tempURL.toExternalForm()); - tempDocument = tempDocBuilder.parse(tempInputSource); - } catch (ParserConfigurationException e) { - ExternalToolsPlugin.getDefault().log(e); - } - catch (IOException ioException) { - ExternalToolsPlugin.getDefault().log(ioException); - } - catch (SAXException saxException) { - ExternalToolsPlugin.getDefault().log(saxException); - } - - return tempDocument; - } - - /** - * This function writes the XMLDocument to the specified file. - * @param aFileName The filename to which the XMLDocument should be written. - */ - public void writeXMLDocumentToFile(String aFileName) { - -// try { -// XmlDocument xmlDocument = (XmlDocument)xdocXMLDocument; -// xmlDocument.write(new FileWriter(aFileName), "UTF-8"); //$NON-NLS-1$ -// } -// catch(IOException ioe) { -// System.out.println(MessageFormat.format(AntEditorToolsMessages.getString("TaskXMLFileMerger.Could_not_print"), new String[]{ioe.toString()})); //$NON-NLS-1$ -// } - } - - /** - * Creates an Instance of this class and calls the - * generateParsedXML() method. - * @see generateParsedXML() - */ - public static void main(String[] args) { - - TaskXMLFileMerger tmpTaskXMLFileMerger = new TaskXMLFileMerger(); - tmpTaskXMLFileMerger.runReplaceAttributeRequiredProcess(); - tmpTaskXMLFileMerger.writeXMLDocumentToFile("src\\anttasks_1.5b.xml"); //$NON-NLS-1$ - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/AntEditorUtilsMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/AntEditorUtilsMessages.java deleted file mode 100644 index d13f3b43e..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/AntEditorUtilsMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.utils; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntEditorUtilsMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.editor.utils.AntEditorUtilsMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntEditorUtilsMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/AntEditorUtilsMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/AntEditorUtilsMessages.properties deleted file mode 100644 index 99b18e655..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/AntEditorUtilsMessages.properties +++ /dev/null @@ -1,22 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -ProjectHelperImpl.Unexpected_element___{0}__1=Unexpected element \"{0}" -ProjectHelperImpl.Unexpected_text___{0}__2=Unexpected text \"{0}" -ProjectHelperImpl.Unknown_data_type__3=Unknown data type -ProjectHelperImpl.Unexpected_attribute___{0}__4=Unexpected attribute \"{0}" -ProjectHelperImpl.The_default_attribute_of_project_is_required_5=The default attribute of project is required -ProjectHelperImpl.Unexpected_element___{0}__6=Unexpected element \"{0}" -ProjectHelperImpl.Config_file_is_not_of_expected_XML_type_7=Config file is not of expected XML type -ProjectHelperImpl.Unexpected_attribute___{0}__8=Unexpected attribute \"{0}" -ProjectHelperImpl.target_element_appears_without_a_name_attribute_9=target element appears without a name attribute -ProjectHelperImpl.Encoding_of_project_file_is_invalid._10=Encoding of project file is invalid. -ProjectHelperImpl.Error_reading_project_file__{0}_11=Error reading project file: {0} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/ProjectHelper.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/ProjectHelper.java deleted file mode 100644 index b78814fff..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/ProjectHelper.java +++ /dev/null @@ -1,97 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.utils; - -/* - * The Apache Software License, Version 1.1 - * - * Copyright (c) 2000-2002 The Apache Software Foundation. All rights - * reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in - * the documentation and/or other materials provided with the - * distribution. - * - * 3. The end-user documentation included with the redistribution, if - * any, must include the following acknowlegement: - * "This product includes software developed by the - * Apache Software Foundation (http://www.apache.org/)." - * Alternately, this acknowlegement may appear in the software itself, - * if and wherever such third-party acknowlegements normally appear. - * - * 4. The names "The Jakarta Project", "Ant", and "Apache Software - * Foundation" must not be used to endorse or promote products derived - * from this software without prior written permission. For written - * permission, please contact apache@apache.org. - * - * 5. Products derived from this software may not be called "Apache" - * nor may "Apache" appear in their names without prior written - * permission of the Apache Group. - * - * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED - * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES - * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR - * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF - * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND - * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT - * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF - * SUCH DAMAGE. - * ==================================================================== - * - * This software consists of voluntary contributions made by many - * individuals on behalf of the Apache Software Foundation. For more - * information on the Apache Software Foundation, please see - * <http://www.apache.org/>. - */ - -import java.io.File; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.Project; - -/** - * Derived from the original Ant ProjectHelper class - */ -public class ProjectHelper extends org.apache.tools.ant.ProjectHelper { - - /** - * That is the one method that was needed and why copying of this package - * from ant 1.5 had to be done. Other than usual Ant processing, here we don't - * work on a file but on a string. - * - * @param project the project - * @param aWholeDocumentString the string that contains the whole docoment - * that we want to configure the project on. - * - * @author Alf Schiefelbein - */ - public static void configureProject(Project project, File aFile, String aWholeDocumentString) throws BuildException { - ProjectHelperImpl helper = (ProjectHelperImpl)getProjectHelper(); - helper.parse(project, aFile, aWholeDocumentString); - } - - public static org.apache.tools.ant.ProjectHelper getProjectHelper() throws BuildException { - return new ProjectHelperImpl(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/ProjectHelperImpl.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/ProjectHelperImpl.java deleted file mode 100644 index b4bdb6c19..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/utils/ProjectHelperImpl.java +++ /dev/null @@ -1,1167 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.utils; - -/* - * The Apache Software License, Version 1.1 - * - * Copyright (c) 2000-2002 The Apache Software Foundation. All rights - * reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in - * the documentation and/or other materials provided with the - * distribution. - * - * 3. The end-user documentation included with the redistribution, if - * any, must include the following acknowlegement: - * "This product includes software developed by the - * Apache Software Foundation (http://www.apache.org/)." - * Alternately, this acknowlegement may appear in the software itself, - * if and wherever such third-party acknowlegements normally appear. - * - * 4. The names "The Jakarta Project", "Ant", and "Apache Software - * Foundation" must not be used to endorse or promote products derived - * from this software without prior written permission. For written - * permission, please contact apache@apache.org. - * - * 5. Products derived from this software may not be called "Apache" - * nor may "Apache" appear in their names without prior written - * permission of the Apache Group. - * - * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED - * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES - * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR - * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF - * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND - * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT - * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF - * SUCH DAMAGE. - * ==================================================================== - * - * This software consists of voluntary contributions made by many - * individuals on behalf of the Apache Software Foundation. For more - * information on the Apache Software Foundation, please see - * <http://www.apache.org/>. - */ - -import java.io.File; -import java.io.FileInputStream; -import java.io.FileNotFoundException; -import java.io.IOException; -import java.io.StringReader; -import java.io.UnsupportedEncodingException; -import java.text.MessageFormat; -import java.util.Locale; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.IntrospectionHelper; -import org.apache.tools.ant.Location; -import org.apache.tools.ant.Project; -import org.apache.tools.ant.ProjectHelper; -import org.apache.tools.ant.RuntimeConfigurable; -import org.apache.tools.ant.Target; -import org.apache.tools.ant.Task; -import org.apache.tools.ant.TaskAdapter; -import org.apache.tools.ant.TaskContainer; -import org.apache.tools.ant.UnknownElement; -import org.apache.tools.ant.util.JAXPUtils; -import org.xml.sax.AttributeList; -import org.xml.sax.DocumentHandler; -import org.xml.sax.HandlerBase; -import org.xml.sax.InputSource; -import org.xml.sax.Locator; -import org.xml.sax.SAXException; -import org.xml.sax.SAXParseException; -import org.xml.sax.helpers.XMLReaderAdapter; - -/** - * Derived from the original Ant ProjectHelperImpl class. - * Changes: - * All logging is turned off as the Project we are dealing with is a "temp" - * project that has no registered build listeners. - * NLS'ed - * Able to parse based on String instead of a file - */ - -public class ProjectHelperImpl extends org.apache.tools.ant.helper.ProjectHelperImpl { - - /** - * SAX 1 style parser used to parse the given file. This may - * in fact be a SAX 2 XMLReader wrapped in an XMLReaderAdapter. - */ - private org.xml.sax.Parser parser; - - /** The project to configure. */ - private Project project; - /** The configuration file to parse. */ - private File buildFile; - /** - * Parent directory of the build file. Used for resolving entities - * and setting the project's base directory. - */ - private File buildFileParent; - /** - * Locator for the configuration file parser. - * Used for giving locations of errors etc. - */ - private Locator locator; - - /** - * Scans an attribute list for the <code>id</code> attribute and - * stores a reference to the target object in the project if an - * id is found. - * <p> - * This method was moved out of the configure method to allow - * it to be executed at parse time. - * - * @see #configure(Object,AttributeList,Project) - */ - private void configureId(Object target, AttributeList attr) { - String id = attr.getValue("id"); //$NON-NLS-1$ - if (id != null) { - project.addReference(id, target); - } - } - - /** - * Parses the project file, configuring the project as it goes. - * <P> - * This method does the same as <code>parse(Project, File)</code>, though - * it works on a string. This is required for finding the properties for - * the Ant Editor code assistance. - * - * @param project project instance to be configured. - * @param source the source as string from which the project is read. - * @exception BuildException if the configuration is invalid or cannot - * be read. - * - * @author Alf Schiefelbein - */ - public void parse(Project refProject, File aFile, String sourceAsString) throws BuildException { - FileInputStream inputStream = null; - InputSource inputSource = null; - - this.project = refProject; - this.buildFile = new File(aFile.getAbsolutePath()); - buildFileParent = new File(this.buildFile.getParent()); - - try { - try { - parser = JAXPUtils.getParser(); - } catch (BuildException e) { - parser = new XMLReaderAdapter(JAXPUtils.getXMLReader()); - } - - String uri = "file:" + buildFile.getAbsolutePath().replace('\\', '/'); //$NON-NLS-1$ - for (int index = uri.indexOf('#'); index != -1; index = uri.indexOf('#')) { - uri = uri.substring(0, index) + "%23" + uri.substring(index + 1); //$NON-NLS-1$ - } - - // changed here - inputSource = new InputSource(new StringReader(sourceAsString)); - inputSource.setSystemId(uri); - - HandlerBase hb = new RootHandler(this); - parser.setDocumentHandler(hb); - parser.setEntityResolver(hb); - parser.setErrorHandler(hb); - parser.setDTDHandler(hb); - parser.parse(inputSource); - } catch (SAXParseException exc) { - Location location = - new Location(exc.getSystemId(), exc.getLineNumber(), - exc.getColumnNumber()); - - Throwable t = exc.getException(); - if (t instanceof BuildException) { - BuildException be = (BuildException) t; - if (be.getLocation() == Location.UNKNOWN_LOCATION) { - be.setLocation(location); - } - throw be; - } - - throw new BuildException(exc.getMessage(), t, location); - } catch (SAXException exc) { - Throwable t = exc.getException(); - if (t instanceof BuildException) { - throw (BuildException) t; - } - throw new BuildException(exc.getMessage(), t); - } catch (FileNotFoundException exc) { - throw new BuildException(exc); - } catch (UnsupportedEncodingException exc) { - throw new BuildException(AntEditorUtilsMessages.getString("ProjectHelperImpl.Encoding_of_project_file_is_invalid._10"), //$NON-NLS-1$ - exc); - } catch (IOException exc) { - throw new BuildException(MessageFormat.format(AntEditorUtilsMessages.getString("ProjectHelperImpl.Error_reading_project_file__{0}_11"), new String[]{exc.getMessage()}), exc); //$NON-NLS-1$ - } finally { - if (inputStream != null) { - try { - inputStream.close(); - } catch (IOException ioe) { - // ignore this - } - } - } - } - - /** - * The common superclass for all SAX event handlers used to parse - * the configuration file. Each method just throws an exception, - * so subclasses should override what they can handle. - * - * Each type of XML element (task, target, etc.) in Ant has - * a specific subclass. - * - * In the constructor, this class takes over the handling of SAX - * events from the parent handler and returns - * control back to the parent in the endElement method. - */ - static class AbstractHandler extends HandlerBase { - - /** - * Previous handler for the document. - * When the next element is finished, control returns - * to this handler. - */ - protected DocumentHandler parentHandler; - - /** Helper impl. With non-static internal classes, the compiler will generate - this automatically - but this will fail with some compilers ( reporting - "Expecting to find object/array on stack" ). If we pass it - explicitely it'll work with more compilers. - */ - ProjectHelperImpl helperImpl; - - /** - * Creates a handler and sets the parser to use it - * for the current element. - * - * @param helperImpl the ProjectHelperImpl instance associated - * with this handler. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public AbstractHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - this.parentHandler = parentHandler; - this.helperImpl = helperImpl; - - // Start handling SAX events - helperImpl.parser.setDocumentHandler(this); - } - - /** - * Handles the start of an element. This base implementation just - * throws an exception. - * - * @param tag The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if this method is not overridden, or in - * case of error in an overridden version - */ - public void startElement(String tag, AttributeList attrs) throws SAXParseException { - throw new SAXParseException(MessageFormat.format(AntEditorUtilsMessages.getString("ProjectHelperImpl.Unexpected_element___{0}__1"), new String[]{tag}), helperImpl.locator); //$NON-NLS-1$ - } - - /** - * Handles text within an element. This base implementation just - * throws an exception. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - * - * @exception SAXParseException if this method is not overridden, or in - * case of error in an overridden version - */ - public void characters(char[] buf, int start, int count) throws SAXParseException { - String s = new String(buf, start, count).trim(); - - if (s.length() > 0) { - throw new SAXParseException(MessageFormat.format(AntEditorUtilsMessages.getString("ProjectHelperImpl.Unexpected_text___{0}__2"), new String[]{s}), helperImpl.locator); //$NON-NLS-1$ - } - } - - /** - * Called when this element and all elements nested into it have been - * handled. - */ - protected void finished() {} - - /** - * Handles the end of an element. Any required clean-up is performed - * by the finished() method and then the original handler is restored to - * the parser. - * - * @param name The name of the element which is ending. - * Will not be <code>null</code>. - * - * @exception SAXException in case of error (not thrown in - * this implementation) - * - * @see #finished() - */ - public void endElement(String name) throws SAXException { - - finished(); - // Let parent resume handling SAX events - helperImpl.parser.setDocumentHandler(parentHandler); - } - } - /** - * Handler for all data types directly subordinate to project or target. - */ - static class DataTypeHandler extends AbstractHandler { - /** Parent target, if any. */ - private Target target; - /** The element being configured. */ - private Object element; - /** Wrapper for this element, if it's part of a target. */ - private RuntimeConfigurable wrapper = null; - - /** - * Constructor with no target specified. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public DataTypeHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - this(helperImpl, parentHandler, null); - } - - /** - * Constructor with a target specified. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - * - * @param target The parent target of this element. - * May be <code>null</code>. - */ - public DataTypeHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler, Target target) { - super(helperImpl, parentHandler); - this.target = target; - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. This configures - * the element with its attributes and sets it up with - * its parent container (if any). Nested elements are then - * added later as the parser encounters them. - * - * @param propType Name of the element which caused this handler - * to be created. Must not be <code>null</code>. - * - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException in case of error, such as a - * BuildException being thrown during configuration. - */ - public void init(String propType, AttributeList attrs) throws SAXParseException { - try { - element = helperImpl.project.createDataType(propType); - if (element == null) { - throw new BuildException(AntEditorUtilsMessages.getString("ProjectHelperImpl.Unknown_data_type__3") + propType); //$NON-NLS-1$ - } - - if (target != null) { - wrapper = new RuntimeConfigurable(element, propType); - wrapper.setAttributes(attrs); - target.addDataType(wrapper); - } else { - configure(element, attrs, helperImpl.project); - helperImpl.configureId(element, attrs); - } - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } - - // XXX: (Jon Skeet) Any reason why this doesn't use the wrapper - // if one is available, whereas NestedElementHandler.characters does? - /** - * Adds text to the element. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - * - * @exception SAXParseException if the element doesn't support text - * - * @see ProjectHelper#addText(Project,Object,char[],int,int) - */ - public void characters(char[] buf, int start, int count) throws SAXParseException { - try { - ProjectHelper.addText(helperImpl.project, element, buf, start, count); - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } - - /** - * Handles the start of an element within this one. - * This will always use a nested element handler. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - new NestedElementHandler(helperImpl, this, element, wrapper, target).init(name, attrs); - } - } - /** - * Handler for all nested properties. - */ - static class NestedElementHandler extends AbstractHandler { - /** Parent object (task/data type/etc). */ - private Object parent; - /** The nested element itself. */ - private Object child; - /** - * Wrapper for the parent element, if any. The wrapper for this - * element will be added to this wrapper as a child. - */ - private RuntimeConfigurable parentWrapper; - /** - * Wrapper for this element which takes care of actually configuring - * the element, if a parent wrapper is provided. - * Otherwise the configuration is performed with the configure method. - * @see ProjectHelper#configure(Object,AttributeList,Project) - */ - private RuntimeConfigurable childWrapper = null; - /** Target this element is part of, if any. */ - private Target target; - - /** - * Constructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - * - * @param parent Parent of this element (task/data type/etc). - * Must not be <code>null</code>. - * - * @param parentWrapper Wrapper for the parent element, if any. - * May be <code>null</code>. - * - * @param target Target this element is part of. - * May be <code>null</code>. - */ - public NestedElementHandler(ProjectHelperImpl helperImpl, - DocumentHandler parentHandler, - Object parent, - RuntimeConfigurable parentWrapper, - Target target) { - super(helperImpl, parentHandler); - - if (parent instanceof TaskAdapter) { - this.parent = ((TaskAdapter) parent).getProxy(); - } else { - this.parent = parent; - } - this.parentWrapper = parentWrapper; - this.target = target; - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. This configures - * the element with its attributes and sets it up with - * its parent container (if any). Nested elements are then - * added later as the parser encounters them. - * - * @param propType Name of the element which caused this handler - * to be created. Must not be <code>null</code>. - * - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException in case of error, such as a - * BuildException being thrown during configuration. - */ - public void init(String propType, AttributeList attrs) throws SAXParseException { - Class parentClass = parent.getClass(); - IntrospectionHelper ih = - IntrospectionHelper.getHelper(parentClass); - - try { - String elementName = propType.toLowerCase(Locale.US); - if (parent instanceof UnknownElement) { - UnknownElement uc = new UnknownElement(elementName); - uc.setProject(helperImpl.project); - ((UnknownElement) parent).addChild(uc); - child = uc; - } else { - child = ih.createElement(helperImpl.project, parent, elementName); - } - - helperImpl.configureId(child, attrs); - - if (parentWrapper != null) { - childWrapper = new RuntimeConfigurable(child, propType); - childWrapper.setAttributes(attrs); - parentWrapper.addChild(childWrapper); - } else { - configure(child, attrs, helperImpl.project); - ih.storeElement(helperImpl.project, parent, child, elementName); - } - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } - - /** - * Adds text to the element, using the wrapper if one is - * available or using addText otherwise. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - * - * @exception SAXParseException if the element doesn't support text - * - * @see ProjectHelper#addText(Project,Object,char[],int,int) - */ - public void characters(char[] buf, int start, int count) throws SAXParseException { - if (parentWrapper == null) { - try { - ProjectHelper.addText(helperImpl.project, child, buf, start, count); - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } else { - childWrapper.addText(buf, start, count); - } - } - - /** - * Handles the start of an element within this one. Task containers - * will always use a task handler, and all other elements - * will always use another nested element handler. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the appropriate child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (child instanceof TaskContainer) { - // taskcontainer nested element can contain other tasks - no other - // nested elements possible - new TaskHandler(helperImpl, this, (TaskContainer) child, - childWrapper, target).init(name, attrs); - } else { - new NestedElementHandler(helperImpl, this, child, - childWrapper, target).init(name, attrs); - } - } - } - /** - * Handler for the top level "project" element. - */ - static class ProjectHandler extends AbstractHandler { - - /** - * Constructor which just delegates to the superconstructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public ProjectHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - super(helperImpl, parentHandler); - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. The attributes which - * this handler can deal with are: <code>"default"</code>, - * <code>"name"</code>, <code>"id"</code> and <code>"basedir"</code>. - * - * @param tag Name of the element which caused this handler - * to be created. Should not be <code>null</code>. - * Ignored in this implementation. - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException if an unexpected attribute is - * encountered or if the <code>"default"</code> attribute - * is missing. - */ - public void init(String tag, AttributeList attrs) throws SAXParseException { - String def = null; - String name = null; - String id = null; - String baseDir = null; - - for (int i = 0; i < attrs.getLength(); i++) { - String key = attrs.getName(i); - String value = attrs.getValue(i); - - if (key.equals("default")) { //$NON-NLS-1$ - def = value; - } else if (key.equals("name")) { //$NON-NLS-1$ - name = value; - } else if (key.equals("id")) { //$NON-NLS-1$ - id = value; - } else if (key.equals("basedir")) { //$NON-NLS-1$ - baseDir = value; - } else { - throw new SAXParseException(MessageFormat.format(AntEditorUtilsMessages.getString("ProjectHelperImpl.Unexpected_attribute___{0}__4"), new String[]{attrs.getName(i)}), //$NON-NLS-1$ - helperImpl.locator); - } - } - - if (def == null) { - throw new SAXParseException(AntEditorUtilsMessages.getString("ProjectHelperImpl.The_default_attribute_of_project_is_required_5"), //$NON-NLS-1$ - helperImpl.locator); - } else { - helperImpl.project.setDefaultTarget(def); - } - - if (name != null) { - helperImpl.project.setName(name); - helperImpl.project.addReference(name, helperImpl.project); - } - - if (id != null) { - helperImpl.project.addReference(id, helperImpl.project); - } - - if (helperImpl.project.getProperty("basedir") != null) { //$NON-NLS-1$ - helperImpl.project.setBasedir(helperImpl.project.getProperty("basedir")); //$NON-NLS-1$ - } else { - if (baseDir == null) { - helperImpl.project.setBasedir(helperImpl.buildFileParent.getAbsolutePath()); - } else { - // check whether the user has specified an absolute path - if ((new File(baseDir)).isAbsolute()) { - helperImpl.project.setBasedir(baseDir); - } else { - helperImpl.project.setBaseDir(helperImpl.project.resolveFile(baseDir, - helperImpl.buildFileParent)); - } - } - } - - } - - /** - * Handles the start of a top-level element within the project. An - * appropriate handler is created and initialised with the details - * of the element. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if the tag given is not - * <code>"taskdef"</code>, <code>"typedef"</code>, - * <code>"property"</code>, <code>"target"</code> - * or a data type definition - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (name.equals("taskdef")) { //$NON-NLS-1$ - handleTaskdef(name, attrs); - } else if (name.equals("typedef")) { //$NON-NLS-1$ - handleTypedef(name, attrs); - } else if (name.equals("property")) { //$NON-NLS-1$ - handleProperty(name, attrs); - } else if (name.equals("target")) { //$NON-NLS-1$ - handleTarget(name, attrs); - } else if (helperImpl.project.getDataTypeDefinitions().get(name) != null) { - handleDataType(name, attrs); - } else { - throw new SAXParseException(MessageFormat.format(AntEditorUtilsMessages.getString("ProjectHelperImpl.Unexpected_element___{0}__6"), new String[]{name}), helperImpl.locator); //$NON-NLS-1$ - } - } - - /** - * Handles a task defintion element by creating a task handler - * and initialising is with the details of the element. - * - * @param name The name of the element to be handled. - * Will not be <code>null</code>. - * @param attrs Attributes of the element to be handled. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the task handler - * - */ - private void handleTaskdef(String name, AttributeList attrs) throws SAXParseException { - (new TaskHandler(helperImpl, this, null, null, null)).init(name, attrs); - } - - /** - * Handles a type defintion element by creating a task handler - * and initialising is with the details of the element. - * - * @param name The name of the element to be handled. - * Will not be <code>null</code>. - * @param attrs Attributes of the element to be handled. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs initialising the - * handler - */ - private void handleTypedef(String name, AttributeList attrs) throws SAXParseException { - (new TaskHandler(helperImpl, this, null, null, null)).init(name, attrs); - } - - /** - * Handles a property defintion element by creating a task handler - * and initialising is with the details of the element. - * - * @param name The name of the element to be handled. - * Will not be <code>null</code>. - * @param attrs Attributes of the element to be handled. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs initialising - * the handler - */ - private void handleProperty(String name, AttributeList attrs) throws SAXParseException { - (new TaskHandler(helperImpl, this, null, null, null)).init(name, attrs); - } - - /** - * Handles a target defintion element by creating a target handler - * and initialising is with the details of the element. - * - * @param tag The name of the element to be handled. - * Will not be <code>null</code>. - * @param attrs Attributes of the element to be handled. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs initialising - * the handler - */ - private void handleTarget(String tag, AttributeList attrs) throws SAXParseException { - new TargetHandler(helperImpl, this).init(tag, attrs); - } - /** - * Handles a data type defintion element by creating a data type - * handler and initialising is with the details of the element. - * - * @param name The name of the element to be handled. - * Will not be <code>null</code>. - * @param attrs Attributes of the element to be handled. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs initialising - * the handler - */ - private void handleDataType(String name, AttributeList attrs) throws SAXParseException { - new DataTypeHandler(helperImpl, this).init(name, attrs); - } - - } - /** - * Handler for the root element. Its only child must be the "project" element. - */ - static class RootHandler extends HandlerBase { - ProjectHelperImpl helperImpl; - - public RootHandler(ProjectHelperImpl helperImpl) { - this.helperImpl = helperImpl; - } - - /** - * Resolves file: URIs relative to the build file. - * - * @param publicId The public identifer, or <code>null</code> - * if none is available. Ignored in this - * implementation. - * @param systemId The system identifier provided in the XML - * document. Will not be <code>null</code>. - */ - public InputSource resolveEntity(String publicId, - String systemId) { - - //helperImpl.project.log("resolving systemId: " + systemId, Project.MSG_VERBOSE); - - if (systemId.startsWith("file:")) { //$NON-NLS-1$ - String path = systemId.substring(5); - int index = path.indexOf("file:"); //$NON-NLS-1$ - - // we only have to handle these for backward compatibility - // since they are in the FAQ. - while (index != -1) { - path = path.substring(0, index) + path.substring(index + 5); - index = path.indexOf("file:"); //$NON-NLS-1$ - } - - String entitySystemId = path; - index = path.indexOf("%23"); //$NON-NLS-1$ - // convert these to # - while (index != -1) { - path = path.substring(0, index) + "#" + path.substring(index + 3); //$NON-NLS-1$ - index = path.indexOf("%23"); //$NON-NLS-1$ - } - - File file = new File(path); - if (!file.isAbsolute()) { - file = new File(helperImpl.buildFileParent, path); - } - - try { - InputSource inputSource = new InputSource(new FileInputStream(file)); - inputSource.setSystemId("file:" + entitySystemId); //$NON-NLS-1$ - return inputSource; - } catch (FileNotFoundException fne) { - //helperImpl.project.log(file.getAbsolutePath() + " could not be found", - // Project.MSG_WARN); - } - } - // use default if not file or file not found - return null; - } - - /** - * Handles the start of a project element. A project handler is created - * and initialised with the element name and attributes. - * - * @param tag The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if the tag given is not - * <code>"project"</code> - */ - public void startElement(String tag, AttributeList attrs) throws SAXParseException { - if (tag.equals("project")) { //$NON-NLS-1$ - new ProjectHandler(helperImpl, this).init(tag, attrs); - } else { - throw new SAXParseException(AntEditorUtilsMessages.getString("ProjectHelperImpl.Config_file_is_not_of_expected_XML_type_7"), helperImpl.locator); //$NON-NLS-1$ - } - } - - /** - * Sets the locator in the project helper for future reference. - * - * @param locator The locator used by the parser. - * Will not be <code>null</code>. - */ - public void setDocumentLocator(Locator locator) { - helperImpl.locator = locator; - } - } - /** - * Handler for "target" elements. - */ - static class TargetHandler extends AbstractHandler { - private Target target; - - /** - * Constructor which just delegates to the superconstructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public TargetHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - super(helperImpl, parentHandler); - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. The attributes which - * this handler can deal with are: <code>"name"</code>, - * <code>"depends"</code>, <code>"if"</code>, - * <code>"unless"</code>, <code>"id"</code> and - * <code>"description"</code>. - * - * @param tag Name of the element which caused this handler - * to be created. Should not be <code>null</code>. - * Ignored in this implementation. - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException if an unexpected attribute is encountered - * or if the <code>"name"</code> attribute is missing. - */ - public void init(String tag, AttributeList attrs) throws SAXParseException { - String name = null; - String depends = ""; //$NON-NLS-1$ - String ifCond = null; - String unlessCond = null; - String id = null; - String description = null; - - for (int i = 0; i < attrs.getLength(); i++) { - String key = attrs.getName(i); - String value = attrs.getValue(i); - - if (key.equals("name")) { //$NON-NLS-1$ - name = value; - } else if (key.equals("depends")) { //$NON-NLS-1$ - depends = value; - } else if (key.equals("if")) { //$NON-NLS-1$ - ifCond = value; - } else if (key.equals("unless")) { //$NON-NLS-1$ - unlessCond = value; - } else if (key.equals("id")) { //$NON-NLS-1$ - id = value; - } else if (key.equals("description")) { //$NON-NLS-1$ - description = value; - } else { - throw new SAXParseException(MessageFormat.format(AntEditorUtilsMessages.getString("ProjectHelperImpl.Unexpected_attribute___{0}__8"), new String[]{key}), helperImpl.locator); //$NON-NLS-1$ - } - } - - if (name == null) { - throw new SAXParseException(AntEditorUtilsMessages.getString("ProjectHelperImpl.target_element_appears_without_a_name_attribute_9"), //$NON-NLS-1$ - helperImpl.locator); - } - - target = new Target(); - target.setName(name); - target.setIf(ifCond); - target.setUnless(unlessCond); - target.setDescription(description); - helperImpl.project.addTarget(name, target); - - if (id != null && !id.equals("")) { //$NON-NLS-1$ - helperImpl.project.addReference(id, target); - } - - // take care of dependencies - - if (depends.length() > 0) { - target.setDepends(depends); - } - } - - /** - * Handles the start of an element within a target. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the appropriate child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (helperImpl.project.getDataTypeDefinitions().get(name) != null) { - new DataTypeHandler(helperImpl, this, target).init(name, attrs); - } else { - new TaskHandler(helperImpl, this, target, null, target).init(name, attrs); - } - } - } - /** - * Handler for all task elements. - */ - static class TaskHandler extends AbstractHandler { - /** Containing target, if any. */ - private Target target; - /** - * Container for the task, if any. If target is - * non-<code>null</code>, this must be too. - */ - private TaskContainer container; - /** - * Task created by this handler. - */ - private Task task; - /** - * Wrapper for the parent element, if any. The wrapper for this - * element will be added to this wrapper as a child. - */ - private RuntimeConfigurable parentWrapper; - /** - * Wrapper for this element which takes care of actually configuring - * the element, if this element is contained within a target. - * Otherwise the configuration is performed with the configure method. - * @see ProjectHelper#configure(Object,AttributeList,Project) - */ - private RuntimeConfigurable wrapper = null; - - /** - * Constructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - * - * @param container Container for the element. - * May be <code>null</code> if the target is - * <code>null</code> as well. If the - * target is <code>null</code>, this parameter - * is effectively ignored. - * - * @param parentWrapper Wrapper for the parent element, if any. - * May be <code>null</code>. If the - * target is <code>null</code>, this parameter - * is effectively ignored. - * - * @param target Target this element is part of. - * May be <code>null</code>. - */ - public TaskHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler, - TaskContainer container, RuntimeConfigurable parentWrapper, Target target) { - super(helperImpl, parentHandler); - this.container = container; - this.parentWrapper = parentWrapper; - this.target = target; - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. This configures - * the element with its attributes and sets it up with - * its parent container (if any). Nested elements are then - * added later as the parser encounters them. - * - * @param tag Name of the element which caused this handler - * to be created. Must not be <code>null</code>. - * - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException in case of error (not thrown in - * this implementation) - */ - public void init(String tag, AttributeList attrs) throws SAXParseException { - try { - task = helperImpl.project.createTask(tag); - } catch (BuildException e) { - // swallow here, will be thrown again in - // UnknownElement.maybeConfigure if the problem persists. - } - - if (task == null) { - task = new UnknownElement(tag); - task.setProject(helperImpl.project); - //XXX task.setTaskType(tag); - task.setTaskName(tag); - } - - task.setLocation(new Location(helperImpl.locator.getSystemId(), helperImpl.locator.getLineNumber(), - helperImpl.locator.getColumnNumber())); - helperImpl.configureId(task, attrs); - - // Top level tasks don't have associated targets - if (target != null) { - task.setOwningTarget(target); - container.addTask(task); - task.init(); - wrapper = task.getRuntimeConfigurableWrapper(); - wrapper.setAttributes(attrs); - if (parentWrapper != null) { - parentWrapper.addChild(wrapper); - } - } else { - task.init(); - configure(task, attrs, helperImpl.project); - } - } - - /** - * Executes the task if it is a top-level one. - */ - protected void finished() { - if (task != null && target == null) { - task.execute(); - } - } - - /** - * Adds text to the task, using the wrapper if one is - * available (in other words if the task is within a target) - * or using addText otherwise. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - * - * @exception SAXParseException if the element doesn't support text - * - * @see ProjectHelper#addText(Project,Object,char[],int,int) - */ - public void characters(char[] buf, int start, int count) throws SAXParseException { - if (wrapper == null) { - try { - ProjectHelper.addText(helperImpl.project, task, buf, start, count); - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } else { - wrapper.addText(buf, start, count); - } - } - - /** - * Handles the start of an element within a target. Task containers - * will always use another task handler, and all other tasks - * will always use a nested element handler. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the appropriate child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (task instanceof TaskContainer) { - // task can contain other tasks - no other nested elements possible - new TaskHandler(helperImpl, this, (TaskContainer) task, - wrapper, target).init(name, attrs); - } else { - new NestedElementHandler(helperImpl, this, task, - wrapper, target).init(name, attrs); - } - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/AntEditorXMLMessages.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/AntEditorXMLMessages.java deleted file mode 100644 index 8abfba527..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/AntEditorXMLMessages.java +++ /dev/null @@ -1,34 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.xml; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntEditorXMLMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.editor.xml.AntEditorXMLMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = - ResourceBundle.getBundle(BUNDLE_NAME); - - private AntEditorXMLMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/AntEditorXMLMessages.properties b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/AntEditorXMLMessages.properties deleted file mode 100644 index 5f99b341d..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/AntEditorXMLMessages.properties +++ /dev/null @@ -1,13 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -XmlElement.XmlElement_cannot_be_added_as_a_child=XmlElement \'{0}\' cannot be added as a child, as it already is a child of \'{1}\' -XmlElement.XmlElement_toString=XmlElement[name={0}; starting={1},{2}; ending={3},{4}] diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/IAntEditorConstants.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/IAntEditorConstants.java deleted file mode 100644 index 6a8074eb2..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/IAntEditorConstants.java +++ /dev/null @@ -1,52 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.editor.xml; - -/** - * Constants used by the Ant editor - */ -public interface IAntEditorConstants { - - /** - * Attributes stored in XmlElements - */ - public static final String ATTR_NAME= "name"; //$NON-NLS-1$ - public static final String ATTR_DEFAULT= "default"; //$NON-NLS-1$ - public static final String ATTR_RESOURCE= "resource"; //$NON-NLS-1$ - public static final String ATTR_ENVIRONMENT= "environment"; //$NON-NLS-1$ - public static final String ATTR_TARGET= "target"; //$NON-NLS-1$ - public static final String ATTR_DIR= "dir"; //$NON-NLS-1$ - public static final String ATTR_FILE= "file"; //$NON-NLS-1$ - public static final String ATTR_DESTFILE= "destfile"; //$NON-NLS-1$ - public static final String ATTR_SRC= "src"; //$NON-NLS-1$ - public static final String ATTR_ZIPFILE= "zipfile"; //$NON-NLS-1$ - public static final String ATTR_COMMAND= "command"; //$NON-NLS-1$ - public static final String ATTR_EXECUTABLE= "executable"; //$NON-NLS-1$ - public static final String ATTR_TYPE= "type"; //$NON-NLS-1$ - public static final String ATTR_DESCRIPTION= "description"; //$NON-NLS-1$ - /** - * Values of the type attribute stored in XmlElements - */ - public static final String TYPE_EXTERNAL = "external"; //$NON-NLS-1$ - public static final String TYPE_TARGET = "target"; //$NON-NLS-1$ - public static final String TYPE_PROJECT = "project"; //$NON-NLS-1$ - public static final String TYPE_PROPERTY = "property"; //$NON-NLS-1$ - public static final String TYPE_ANTCALL = "antcall"; //$NON-NLS-1$ - public static final String TYPE_MKDIR = "mkdir"; //$NON-NLS-1$ - public static final String TYPE_COPY = "copy"; //$NON-NLS-1$ - public static final String TYPE_ARCHIVE = "archive"; //$NON-NLS-1$ - public static final String TYPE_DECOMPRESS = "decompress"; //$NON-NLS-1$ - public static final String TYPE_COMPRESS = "compress"; //$NON-NLS-1$ - public static final String TYPE_EXEC = "exec"; //$NON-NLS-1$ - public static final String TYPE_DELETE = "delete"; //$NON-NLS-1$ - public static final String TYPE_UNKNOWN = "unknown"; //$NON-NLS-1$ - -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/XmlAttribute.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/XmlAttribute.java deleted file mode 100644 index 4307fd4c0..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/XmlAttribute.java +++ /dev/null @@ -1,58 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug 29148 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.xml; - - -/** - * General representation of an xml attribute. - * <P> - * Here an xml attribute is refered to as what is specified using like - * '<... attribute="some value">' in an xml file. - * - */ -public class XmlAttribute { - - /** - * The attribute name. - */ - protected String name; - - /** - * The attribute value. - */ - protected String value; - - /** - * Creates an instance with the specified name and value. - */ - public XmlAttribute(String aName, String aValue) { - name = aName; - value = aValue; - } - - /** - * Returns the name. - */ - public String getName() { - return name; - } - - /** - * Returns the value. - */ - public String getValue() { - return value; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/XmlElement.java b/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/XmlElement.java deleted file mode 100644 index efd2972ab..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/org/eclipse/ui/externaltools/internal/ant/editor/xml/XmlElement.java +++ /dev/null @@ -1,565 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2002, 2003 GEBIT Gesellschaft fuer EDV-Beratung - * und Informatik-Technologien mbH, - * Berlin, Duesseldorf, Frankfurt (Germany) and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * GEBIT Gesellschaft fuer EDV-Beratung und Informatik-Technologien mbH - initial API and implementation - * IBM Corporation - bug fixes - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.editor.xml; - -import java.io.File; -import java.text.MessageFormat; -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.apache.xerces.util.URI; -import org.apache.xerces.util.URI.MalformedURIException; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.core.runtime.Path; -import org.eclipse.ui.externaltools.internal.ant.editor.AntEditorException; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; - -/** - * General representation of an xml element. - * <P> - * Here an xml element is refered to as what is specified using like - * '<elementName>' in an xml file. - * - */ -public class XmlElement implements IAdaptable { - - /* - * (T) - * Eventually extract an interface XmlSourceRange in respect to - * ISourceReference that contains the two methods getOffset and - * getLength - */ - - - /** - * The offset of the corresponding source. - * @see #getOffset() - */ - protected int offset; - - - /** - * The length of the corresponding source. - * @see #getLength() - */ - protected int length; - - - /** - * The parent node. - */ - protected XmlElement parent; - - - /** - * The attributes. - */ - protected List attributes = new ArrayList(); - - - /** - * The child nodes. - */ - protected List childNodes = new ArrayList(); - - - /** - * The (tag-)name of the element. - */ - protected String name; - - - /** - * The startingRow where the element begins at. - * <P> - * The first startingRow has the index '1'. - */ - protected int startingRow; - - - /** - * The startingColumn where the element begins at. - * <P> - * The first startingColumn has the index '1'. - */ - protected int startingColumn; - - - /** - * The row where the element ends at. - * <P> - * The first ending row has the index '1'. - */ - protected int endingRow; - - - /** - * The column where the element ends at. - * <P> - * The first ending column has the index '1'. - * The ending column is actually the index on this line after '>'. - */ - protected int endingColumn; - - /** - * Whether this element has been generated as part of an element hierarchy - * this is not complete as a result of an error. - */ - private boolean isErrorNode; - - /** - * The absolute file system path of the file this element is - * defined within. - */ - private String filePath; - - /** - * Whether this element has been generated from an external entity definition - */ - private boolean isExternal = false; - - /** - * Whether this element is the root external element generated from an external entity definition - */ - private boolean isRootExternal = false; - - /** - * The unique (in the corresponding element tree) path of this element. - */ - private String fElementPath; - - /** - * The (not necessarily unique) identifier of this element. - */ - private String fElementIdentifier; - - - /** - * Creates an instance with the specified name. - */ - public XmlElement(String aName) { - name = aName; - } - - - /** - * Returns the name. - */ - public String getName() { - return name; - } - - - /** - * Returns the name that is used for display in outline view. - * <P> - * The default implementation returns just the same as the method <code>getName()</code>. - * Override this method in your own subclass for special elements in order to provide a - * custom display name. - */ - public String getDisplayName() { - return getName(); - } - - - /** - * Returns the child nodes. - */ - public List getChildNodes() { - return childNodes; - } - - - /** - * Returns the parent XmlElement. - * - * @return the parent or <code>null</code> if this element has no parent. - */ - public XmlElement getParentNode() { - return parent; - } - - - /** - * Adds the specified element as child. - * <P> - * The specified element will have this assigned as its parent. - * - * @throws AntEditorException if the specified child element allready - * has a parent. - */ - public void addChildNode(XmlElement aChildElement) { - if(aChildElement.getParentNode() != null) { - throw new AntEditorException(MessageFormat.format(AntEditorXMLMessages.getString("XmlElement.XmlElement_cannot_be_added_as_a_child"), new String[]{aChildElement.toString(), aChildElement.getParentNode().toString()})); //$NON-NLS-1$ - } - aChildElement.parent = this; - childNodes.add(aChildElement); - } - - - /** - * Returns all attributes. - */ - public List getAttributes() { - return attributes; - } - - - /** - * Adds the specified attribute. - */ - public void addAttribute(XmlAttribute anAttribute) { - attributes.add(anAttribute); - } - - - /** - * Returns the attribute with the specified name or <code>null</code>, - * if non existing. - */ - public XmlAttribute getAttributeNamed(String anAttributeName) { - for (Iterator i = attributes.iterator(); i.hasNext();) { - XmlAttribute anAttribute = (XmlAttribute) i.next(); - if(anAttributeName.equals(anAttribute.name)) { - return anAttribute; - } - } - return null; - } - - - /** - * Returns the startingColumn. - * <P> - * The first column has the index '1'. - */ - public int getStartingColumn() { - return startingColumn; - } - - - /** - * Returns the startingRow. - * <P> - * The first row has the index '1'. - */ - public int getStartingRow() { - return startingRow; - } - - - /** - * Returns the endingRow. - * <P> - * The first row has the index '1'. - */ - public int getEndingRow() { - return endingRow; - } - - - /** - * Sets the endingRow. - * <P> - * The first row has the index '1'. - */ - public void setEndingRow(int endingRow) { - this.endingRow = endingRow; - } - - - /** - * Returns the ending column. - * <P> - * The first column has the index '1'. - * The ending column is actually the index right after '>' on the ending - * line. - */ - public int getEndingColumn() { - return endingColumn; - } - - /** - * Sets the absolute file system path of the file this element is defined - * within. - */ - public void setFilePath(String path) { - URI uri= null; - try { - uri= new URI(path); - } catch (MalformedURIException e) { - filePath= path; - return; - } - filePath = new Path(new File(uri.getPath()).getAbsolutePath()).toString(); - } - - /** - * Returns the absolute file system path of the file this element is defined - * within. - */ - public String getFilePath() { - return filePath; - } - - /** - * Sets the endingColumn. - * <P> - * The first column has the index '1'. - * The ending column is actually the index right after '>' on the ending - * line. - */ - public void setEndingColumn(int endingColumn) { - this.endingColumn = endingColumn; - } - - - /** - * Sets the startingColumn. - * <P> - * The first column has the index '1'. - */ - public void setStartingColumn(int startingColumn) { - this.startingColumn = startingColumn; - } - - - /** - * Sets the startingRow. - * <P> - * The first row has the index '1'. - */ - public void setStartingRow(int startingRow) { - this.startingRow = startingRow; - } - - - /** - * Returns the 0-based index of the first character of the source code for this element, - * relative to the source buffer in which this element is contained. - * - * @return the 0-based index of the first character of the source code for this element, - * relative to the source buffer in which this element is contained - */ - public int getOffset() { - return offset; - } - - - /** - * Sets the offset. - * - * @see #getOffset() - */ - public void setOffset(int anOffset) { - offset = anOffset; - } - - - /** - * Returns the number of characters of the source code for this element, - * relative to the source buffer in which this element is contained. - * - * @return the number of characters of the source code for this element, - * relative to the source buffer in which this element is contained - */ - public int getLength() { - return length; - } - - - /** - * Sets the length. - * - * @see #getLength() - */ - public void setLength(int aLength) { - length = aLength; - } - - - /** - * Returns a string representation of this element. - */ - public String toString() { - return MessageFormat.format(AntEditorXMLMessages.getString("XmlElement.XmlElement_toString"), new String[]{name, Integer.toString(startingRow), Integer.toString(startingColumn), Integer.toString(endingRow), Integer.toString(endingColumn)}); //$NON-NLS-1$ - } - - /** - * Returns whether this element has been generated as part of an element - * hierarchy this is not complete as a result of an error. - */ - public boolean isErrorNode() { - return isErrorNode; - } - - /** - * Sets whether this element has been generated as part of an element - * hierarchy this is not complete as a result of an error. - */ - public void setIsErrorNode(boolean isErrorNode) { - this.isErrorNode= isErrorNode; - } - /** - * Returns whether this xml element is defined in an external entity. - * - * @return boolean - */ - public boolean isExternal() { - return isExternal; - } - - /** - * Sets whether this xml element is defined in an external entity. - */ - public void setExternal(boolean isExternal) { - this.isExternal = isExternal; - } - - /** - * Sets whether this xml element is the root external entity. - */ - public void setRootExternal(boolean isExternal) { - this.isRootExternal = isExternal; - } - - /** - * Returns whether this xml element is the root external entity. - */ - public boolean isRootExternal() { - return isRootExternal; - } - - public String getElementPath() { - if (fElementPath == null) { - StringBuffer buffer= new StringBuffer(getParentNode() != null ? getParentNode().getElementPath() : ""); //$NON-NLS-1$ - buffer.append('/'); - buffer.append(getElementIdentifier()); - buffer.append('['); - buffer.append(getParentNode() != null ? getParentNode().getElementIndexOf(this) : 0); - buffer.append(']'); - - fElementPath= buffer.toString(); - } - return fElementPath; - } - - private String getElementIdentifier() { - if (fElementIdentifier == null) { - StringBuffer buffer= escape(new StringBuffer(getName() != null ? getName() : ""), '\\', "$/[]\\"); //$NON-NLS-1$ //$NON-NLS-2$ - buffer.append('$'); - buffer.append(escape(new StringBuffer(getDisplayName() != null ? getDisplayName() : ""), '\\', "$/[]\\").toString()); //$NON-NLS-1$ //$NON-NLS-2$ - - fElementIdentifier= buffer.toString(); - } - return fElementIdentifier; - } - - private StringBuffer escape(StringBuffer sb, char esc, String special) { - for (int i= 0; i < sb.length(); i++) { - if (special.indexOf(sb.charAt(i)) >= 0) { - sb.insert(i++, esc); - } - } - - return sb; - } - - private int getElementIndexOf(XmlElement child) { - if (getChildNodes() == null) { - return -1; - } - - int result= -1; - - Iterator iter= getChildNodes().iterator(); - XmlElement current= null; - while (current != child && iter.hasNext()) { - current= (XmlElement) iter.next(); - if (child.getElementIdentifier().equals(current.getElementIdentifier())) - result++; - } - - if (current != child) { - return -1; - } - - return result; - } - - /* - * @see java.lang.Object#equals(java.lang.Object) - */ - public boolean equals(Object o2) { - // prepared to be used in an IElementComparer, depends on http://dev.eclipse.org/bugs/show_bug.cgi?id=32254 - Object o1= this; - - if (o1 == o2) { - return true; - } - if (o1 == null || o2 == null) { - return false; - } - if (!(o1 instanceof XmlElement || o2 instanceof XmlElement)) { - return o2.equals(o1); - } - if (!(o1 instanceof XmlElement && o2 instanceof XmlElement)) { - return false; - } - - XmlElement e1= (XmlElement) o1; - XmlElement e2= (XmlElement) o2; - - if (e1.getElementPath().equals(e2.getElementPath())) { - return true; - } - - return false; - } - - /* - * @see java.lang.Object#hashCode() - */ - public int hashCode() { - // prepared to be used in an IElementComparer, depends on http://dev.eclipse.org/bugs/show_bug.cgi?id=32254 - Object o1= this; - - if (o1 == null) { - return 0; - } - if (!(o1 instanceof XmlElement)) { - return o1.hashCode(); - } - - XmlElement e1= (XmlElement) o1; - - return e1.getElementPath().hashCode(); - } - - /* (non-Javadoc) - * @see org.eclipse.core.runtime.IAdaptable#getAdapter(java.lang.Class) - */ - public Object getAdapter(Class adapter) { - if (adapter == IResource.class) { - if (getFilePath() != null) { - return AntUtil.getFile(getFilePath()); - } - } - return null; - } - -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Editor/tasks.xml b/org.eclipse.ui.externaltools/Ant Editor/tasks.xml deleted file mode 100644 index 626f04e67..000000000 --- a/org.eclipse.ui.externaltools/Ant Editor/tasks.xml +++ /dev/null @@ -1,5139 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<TASKS> - <TASK NAME="ant"> - <DESCRIPTION><p>Runs Ant on a supplied buildfile. This can be used to build subprojects.</p> -<p>When the <i>antfile</i> attribute is omitted, the file &quot;build.xml&quot; -in the supplied directory (<i>dir</i> attribute) is used.</p> -<p>If no target attribute is supplied, the default target of the new project is -used.</p> -<p>By default, all of the properties of the current project will be -available in the new project. Alternatively, you can -set the <i>inheritAll</i> attribute to <code>false</code> and only -&quot;user&quot; properties (i.e., those passed on the command-line) -will be passed to the new project. In either case, the set of -properties passed to the new project will override the properties that -are set in the new project (See also the <a href="property.html">property task</a>).</p> -<p>You can also set properties in the new project from the old project by -using nested property tags. These properties are always passed regardless of the -setting of <i>inheritAll</i>. This allows you to parameterize your subprojects.</p> -<p>References to data types can also be passed to the new project, but -by default they are not. If you set the inheritrefs attribute to -true, all references will be copied, but they will not override -references defined in the new project.</p> -<p>Nested <a href="#reference"><i>&lt;reference&gt;</i></a> elements -can also be used to copy references from the calling project to the -new project, optionally under a different id. References taken from -nested elements will override existing references in the new -project.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="antfile" REQUIRED="no"> - <DESCRIPTION>the buildfile to use. Defaults to"build.xml". This file is expected to be a filenamerelative to the dir attribute given</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>the directory to use as a basedir for the new Ant project. Defaults to the current project's basedir, unlessinheritall has been set to false, in which case it doesn'thave a default value. This will override the basedirsetting of the called project</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="target" REQUIRED="no"> - <DESCRIPTION>the target of the new Ant project that should be executed.Defaults to the new project's default target</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output" REQUIRED="no"> - <DESCRIPTION>Filename to write the ant output to. This isrelative to the value of the dir attribute if it has been set orto the base directory of the current project otherwise.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="inheritall" REQUIRED="no"> - <DESCRIPTION>If true, pass all properties to thenew Ant project. Defaults to true</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="inheritrefs" REQUIRED="no"> - <DESCRIPTION>If true, pass all references to thenew Ant project. Defaults to false</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="antcall"> - <DESCRIPTION><p>Call another target within the same build-file optionally specifying some -properties (param's in this context)</p> -<p>By default, all of the properties of the current project will be -available in the new project. Alternatively, you can -set the <i>inheritAll</i> attribute to <code>false</code> and only -&quot;user&quot; properties (i.e., those passed on the command-line) -will be passed to the new project. In either case, the set of -properties passed to the new project will override the properties that -are set in the new project (See also the <a href="property.html">property task</a>).</p> -<p>You can also set properties in the new project from the old project by -using nested param tags. These properties are always passed regardless of the -setting of <i>inheritAll</i>. This allows you to parameterize your subprojects.</p> -<p>Nested <a href="#reference"><i>&lt;reference&gt;</i></a> elements can -be used to copy references from the calling project to the new -project, optionally under a different id. References taken from -nested elements will override existing references in the new -project.</p> -<p> -When a target is invoked by antcall, all of its dependent targets will -also be called within the context of any new parameters. For example. if -the target &quot;doSomethingElse&quot; depended on the target &quot;init&quot;, then the -<i>antcall</i> of &quot;doSomethingElse&quot; will call &quot;init&quot; during the call. -Of course, any properties defined in the antcall task or inherited from the calling target -will be fixed and not overridable in the init task -or indeed in the &quot;doSomethingElse&quot; task. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="target" REQUIRED="yes"> - <DESCRIPTION>The target to execute</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="inheritall" REQUIRED="no"> - <DESCRIPTION>If true, pass all properties to the new Antproject. Defaults to true.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="inheritrefs" REQUIRED="no"> - <DESCRIPTION>If true, pass all references to thenew Ant project. Defaults to false</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="antstructure"> - <DESCRIPTION><p>Generates a DTD for Ant buildfiles which contains information -about all tasks currently known to Ant.</p> -<p>Note that the DTD generated by this task is incomplete, you can -always add XML entities using <a -href="taskdef.html"><code>&lt;taskdef&gt;</code></a> or <a -href="typedef.html"><code>&lt;typedef&gt;</code></a>. See <a -href="http://www.sdv.fr/pages/casa/html/ant-dtd.en.html" -target="_top">here</a> for a way to get around this problem.</p> -<p>This task doesn't know about required attributes, all will be -listed as <code>#IMPLIED</code>.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="output" REQUIRED="yes"> - <DESCRIPTION>file to write the DTD to</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="apply"> - <DESCRIPTION><p>Executes a system command. When the <i>os</i> attribute is specified, then -the command is only executed when Ant is run on one of the specified operating -systems.</p> -<p>The files and/or directories of a number of <a -href="../CoreTypes/fileset.html">FileSet</a>s are passed as arguments -to the system command.</p> -<p>If you specify a nested <a -href="../CoreTypes/mapper.html">mapper</a> and the <i>dest</i> attribute, -the timestamp of each source file is compared to the timestamp of a -target file which is defined by the nested mapper element and searched -for in the given dest.</p> -<p>At least one fileset is required, and you must not specify more than -one mapper.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="executable" REQUIRED="yes"> - <DESCRIPTION>the command to execute without any command linearguments</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes, if you specify a nested mapper"> - <DESCRIPTION>the directory where the <apply> expects the target files will be placed by the command, when it is executed. </DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>the directory in which the command should be executed</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="relative" REQUIRED="no, default is false"> - <DESCRIPTION>whether the filenames should be passed on thecommand line as absolute or relative pathnames (relative to thebase directory of the corresponding fileset for source files orthe dest attribute for target files)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="os" REQUIRED="no"> - <DESCRIPTION>list of Operating Systems on which the command may beexecuted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output" REQUIRED="no"> - <DESCRIPTION>the file to which the output of the command should beredirected</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="outputproperty" REQUIRED="no"> - <DESCRIPTION>the name of a property in which the output of the command should be stored</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeout" REQUIRED="no"> - <DESCRIPTION>Stop the command if it doesn't finish within thespecified time (given in milliseconds)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Stop the buildprocess if the command exits with areturncode other than 0</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="skipemptyfilesets" REQUIRED="no, default is false"> - <DESCRIPTION>Don't run the command, if no source files havebeen found or are newer than their corresponding targetfiles</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="parallel" REQUIRED="no"> - <DESCRIPTION>Run the command only once, appending all files asarguments. If false, command will be executed once for every file. Defaults to false.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="type" REQUIRED="no, default is file"> - <DESCRIPTION>One of file, dir orboth. If set to file, only the names of plainfiles will be sent to the command. If set to dir, onlythe names of directories are considered</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="newenvironment" REQUIRED="no, default is false"> - <DESCRIPTION>Do not propagate old environment when new environmentvariables are specified</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="vmlauncher" REQUIRED="no, default is true"> - <DESCRIPTION>Run command using the Java VM's execution facilitieswhere available. If set to false the underlying OS's shell,either directly or through the antRun scripts, will be used.Under some operating systems, this gives access to facilitiesnot normally available through the VM including, under Windows,being able to execute scripts, rather than their associatedinterpreter. If you want to specify the name of theexecutable as a relative path to the directory given by thedir attribute, it may become necessary to set vmlauncher tofalse as well</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="available"> - <DESCRIPTION><p>Sets a property if a resource is available at runtime. This resource can be a -file, a directory, a class in the classpath, or a JVM system resource.</p> -<p>If the resource is present, the property value is set to true by -default; otherwise, the property is not set. You can set the value to -something other than the default by specifying the <code>value</code> attribute.</p> -<p>Normally, this task is used to set properties that are useful to avoid target -execution depending on system parameters.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of the property to set</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="value" REQUIRED="no"> - <DESCRIPTION>The value to set the property to. Defaults to "true"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classname" REQUIRED="yes"> - <DESCRIPTION>The class to look for in the classpath</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="file" REQUIRED=""> - <DESCRIPTION>The file to look for</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="resource" REQUIRED=""> - <DESCRIPTION>The resource to look for in the JVM</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>The classpath to use when looking up classname or resource</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filepath" REQUIRED="no"> - <DESCRIPTION>The path to use when looking up file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>The classpath to use, given as a reference to a path defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="type" REQUIRED="no"> - <DESCRIPTION>The type of file to look for, either a directory (type="dir") or a file(type="file"). If not set, the property will be set if the name specified in the fileattribute exists as either a file or a directory</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ignoresystemclasses" REQUIRED="no"> - <DESCRIPTION>Ignore Ant's runtime classes, using only the specifiedclasspath. Only affects the "classname" attribute. Defaults to "false</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="basename"> - <DESCRIPTION><p> -Task to determine the basename of a specified file, optionally minus a -specified suffix. -</p> -<p> -When this task executes, it will set the specified property to the -value of the last path element of the specified file. If <code>file</code> is a -directory, the basename will be the last directory element. If -<code>file</code> is a full-path, relative-path, or simple filename, -the basename will be the simple file name, without any directory elements. -</p> -<p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="yes"> - <DESCRIPTION>The path to take the basename of</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of the property to set</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="suffix" REQUIRED="no"> - <DESCRIPTION>The suffix to remove from the resulting basename(specified either with or without the ".")</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="buildnumber"> - <DESCRIPTION><p>This is a basic task that can be used to track build numbers.</p> -<p>It will first attempt to read a build number from a file (by default, -<code>build.number</code> in the current directory), then -set the property <code>build.number</code> to the value that was read in -(or to <code>0</code>, if no such value). It will then increment the -number by one and write it back out to the file. -(See the -<a href="../OptionalTasks/propertyfile.html">PropertyFile</a> task -if you need finer control over things such as the property name or -the number format.) -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="no; defaults to "build.number""> - <DESCRIPTION>The file to read and write the build number from/to</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="changelog"> - <DESCRIPTION><p>Generates an XML-formatted report file of the change logs recorded in a -<a href="http://www.cvshome.org/" target="_top">CVS</a> repository. </p> -</DESCRIPTION> - <ATTRIBUTE NAME="dir" REQUIRED="no; defaults to ${basedir}."> - <DESCRIPTION>The directory from which to run the CVS logcommand</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>The file in which to write the change log report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="usersfile" REQUIRED="no"> - <DESCRIPTION>Property file that contains name-value pairs mappinguser IDs and names that should be used in the report in place ofthe user ID</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="daysinpast" REQUIRED="no"> - <DESCRIPTION>Sets the number of days into the past for which thechange log information should be retrieved</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="start" REQUIRED="no"> - <DESCRIPTION>The earliest date from which change logs are to beincluded in the report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="end" REQUIRED="no"> - <DESCRIPTION>The latest date to which change logs are to beincluded in the report</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="checksum"> - <DESCRIPTION><p> -Generates checksum for files. This task can also be used to -perform checksum verifications. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="one of either file or - at least one nested fileset element."> - <DESCRIPTION>The file to generate checksum for</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="algorithm" REQUIRED="no"> - <DESCRIPTION>Specifies the algorithm to be used tocompute the checksum. Defaults to "MD5".Other popular algorithms like "SHA" may be usedas well.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="provider" REQUIRED="no"> - <DESCRIPTION>Specifies the provider of the algorithm</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fileext" REQUIRED="no"> - <DESCRIPTION>The generated checksum file's name will be theoriginal filename with "." and fileext added to it.Defaults to the algorithm name being used.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="property" REQUIRED="no"> - <DESCRIPTION>Specifies the name of the property to be setwith the generated checksum value. This cannot be specifiedwhen fileext is being used or when the number of filesfor which checksums is to be generated is greater than 1.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="forceoverwrite" REQUIRED="no"> - <DESCRIPTION>Overwrite existing files even if the destinationfiles are newer. Defaults to "no"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verifyproperty" REQUIRED="no"> - <DESCRIPTION>Specifies the name of the property to be setwith "true" or "false" depending upon whetherthe generated checksum matches the existing checksum. Whenthis is set, the generated checksum is not written to a file orproperty, but rather, the content of the file or property is used tocheck against the generated checksum.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="readbuffersize" REQUIRED="no"> - <DESCRIPTION>The size of the buffer )in bytes) to use whenreading a file. Defaults to "8192" - you may get abetter performance on big files if you increase this value</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="chmod"> - <DESCRIPTION><p>Changes the permissions of a file or all files inside specified directories. Right now it has effect only under Unix. -The permissions are also UNIX style, like the argument for the chmod command.</p> -<p>See the section on <a href="../dirtasks.html#directorybasedtasks">directory based -tasks</a>, on how the inclusion/exclusion of files works, and how to -write patterns.</p> -<p>This task holds an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all of FileSet's attributes and nested elements -directly. More FileSets can be specified using nested -<code>&lt;fileset&gt;</code> elements.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="exactly one of the two or nested <fileset> elements."> - <DESCRIPTION>the file or single directory of which the permissions must be changed</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED=""> - <DESCRIPTION>the directory which holds the files whose permissions must be changed</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="perm" REQUIRED="yes"> - <DESCRIPTION>the new permissions</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="parallel" REQUIRED="no"> - <DESCRIPTION>process all specified files using a singlechmod command. Defaults to true</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="type" REQUIRED="no, default is file"> - <DESCRIPTION>One of file, dir orboth. If set to file, only the permissions ofplain files are going to be changed. If set to dir, onlythe directories are considered</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="concat"> - <DESCRIPTION><p> -Concatenates a file, or a series of files, to a single file or -the console. The destination file will be created if it does -not exist, though the the <var>append</var> attribute may be -used to alter this behavior. -</p> -<p> -<a href="../CoreTypes/fileset.html">FileSet</a>s and/or <a -href="../CoreTypes/filelist.html">FileList</a>s are used to -select which files are to be concatenated. There is no -singular 'file' attribute to specify a single file to cat -- a -fileset or filelist must also be used in these cases. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="no - "> - <DESCRIPTION>The destination file for the concatenated stream.If not specified the console will be used instead.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no"> - <DESCRIPTION>Specifies whether or not the file specified by 'destfile'should be overwritten. Defaults to "no".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>Specifies the encoding for the input files. Please see http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.htmlfor a list of possible values. Defaults to the platform'sdefault character encoding.</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="condition"> - <DESCRIPTION><p>Sets a property if a certain condition holds true - this is a -generalization of <a href="available.html">Available</a> and <a -href="uptodate.html">Uptodate</a>.</p> -<p>If the condition holds true, the property value is set to true by -default; otherwise, the property is not set. You can set the value to -something other than the default by specifying the <code>value</code> -attribute.</p> -<p>Conditions are specified as <a href="#nested">nested elements</a>, -you must specify exactly one condition.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of the property to set</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="value" REQUIRED="no"> - <DESCRIPTION>The value to set the property to. Defaults to"true"</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="conditions"> - <DESCRIPTION></DESCRIPTION> </TASK> - <TASK NAME="copy"> - <DESCRIPTION><p>Copies a file or FileSet to a new file or directory. By default, files are -only copied if the source file is newer than the destination file, -or when the destination file does not exist. However, you can explicitly -overwrite files with the <code>overwrite</code> attribute.</p> -<p><a href="../CoreTypes/fileset.html">FileSet</a>s are used to select a -set of files to copy. -To use a <code>&lt;fileset&gt;</code>, the <code>todir</code> attribute -must be set.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="yes, unless a nested - <fileset> element is used."> - <DESCRIPTION>The file to copy</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="preservelastmodified" REQUIRED="no; defaults to false."> - <DESCRIPTION>Give the copied files the same last modifiedtime as the original source files.(Note: Ignored on Java 1.1</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tofile" REQUIRED="with the file - attribute, either tofile or todir can be used. - with nested <fileset> elements, if the set of files - is greater than 1, or if only the dir attribute is - specified in the <fileset>, or if the - file attribute is also specified, then only - todir is allowed."> - <DESCRIPTION>The file to copy to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="todir" REQUIRED=""> - <DESCRIPTION>The directory to copy to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="overwrite" REQUIRED="no; defaults to false."> - <DESCRIPTION>Overwrite existing files even if the destinationfiles are newer</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtering" REQUIRED="no; defaults to false."> - <DESCRIPTION>Indicates whether token filtering using the globalbuild-file filters should take place during the copy.Note: Nested <filterset> elements willalways be used, even if this attribute is not specified, or its value isfalse (no, or off)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="flatten" REQUIRED="no; defaults to false."> - <DESCRIPTION>Ignore the directory structure of the source files,and copy all files into the directory specified by the todirattribute. Note that you can achieve the same effect by using aflatten mapper</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includeemptydirs" REQUIRED="no; defaults to true."> - <DESCRIPTION>Copy any empty directories included in the FileSet(s).</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no; defaults to true."> - <DESCRIPTION>Log a warning message, but do not stop the build,when the file to copy does not exist.Only meaningful when copying a single file.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no; defaults to false."> - <DESCRIPTION>Log the files that are being copied</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="copydir"> - <DESCRIPTION><p>Copies a directory tree from the source to the destination.</p> -<p>It is possible to refine the set of files that are being copied. This can be -done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> -attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns.</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>src</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="src" REQUIRED="yes"> - <DESCRIPTION>the directory to copy</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>the directory to copy to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtering" REQUIRED="no"> - <DESCRIPTION>indicates whether token filtering should take place duringthe cop</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="flatten" REQUIRED="no"> - <DESCRIPTION>ignore directory structure of source directory,copy all files into a single directory, specified by the destattribute (default is false)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="forceoverwrite" REQUIRED="no"> - <DESCRIPTION>overwrite existing files even if the destinationfiles are newer (default is false)</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="copyfile"> - <DESCRIPTION><p>Copies a file from the source to the destination. The file is only copied if -the source file is newer than the destination file, or when the destination file -does not exist.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="src" REQUIRED="yes"> - <DESCRIPTION>the filename of the file to copy</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>the filename of the file where to copy to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtering" REQUIRED="no"> - <DESCRIPTION>indicates whether token filtering should take place duringthe cop</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="forceoverwrite" REQUIRED="no"> - <DESCRIPTION>overwrite existing files even if the destinationfiles are newer (default is false)</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="cvs"> - <DESCRIPTION><p>Handles packages/modules retrieved from a -<a href="http://www.cvshome.org/" target="_top">CVS</a> repository.</p> -<p>When doing automated builds, the <a href="get.html">get task</a> should be -preferred over the <i>checkout</i> command, because of speed.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="command" REQUIRED="no, default "checkout"."> - <DESCRIPTION>the CVS command to execute</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compression" REQUIRED="no. defaults to false."> - <DESCRIPTION>true or false - if setto true, this is the same as compressionlevel="3</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compressionlevel" REQUIRED="no. defaults to no compression."> - <DESCRIPTION>A number between 1 and 9 (corresponding topossible values for CVS' -z# argument). Anyother value is treated as compression="false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cvsroot" REQUIRED="no"> - <DESCRIPTION>the CVSROOT variable</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cvsrsh" REQUIRED="no"> - <DESCRIPTION>the CVS_RSH variable</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="no, default is project's basedir."> - <DESCRIPTION>the directory where the checked out files should be placed</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="package" REQUIRED="no"> - <DESCRIPTION>the package/module to check out</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tag" REQUIRED="no"> - <DESCRIPTION>the tag of the package/module to check out</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="date" REQUIRED="no"> - <DESCRIPTION>Use the most recent revision no later than the given dat</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="quiet" REQUIRED="no, default "false""> - <DESCRIPTION>suppress informational messages</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="noexec" REQUIRED="no, default to "false""> - <DESCRIPTION>report only, don't change any files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output" REQUIRED="no, default output to ant log as msg_info."> - <DESCRIPTION>the file to direct standard output from the command</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="error" REQUIRED="no, default error to ant log as msg_warn."> - <DESCRIPTION>the file to direct standard error from the command</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no, default to "false"."> - <DESCRIPTION>whether to append output/error when redirecting to a file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="port" REQUIRED="no, default port 2401."> - <DESCRIPTION>Port used by CVS to communicate with the server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="passfile" REQUIRED="no, default file ~/.cvspass."> - <DESCRIPTION>Password file to read passwords from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Stop the build process if the command exits with areturn code other than 0. Defaults to fals</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="cvspass"> - <DESCRIPTION><p>Adds entries to a .cvspass file. Adding entries to this file has the same affect as a cvs login command.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="cvsroot" REQUIRED="yes"> - <DESCRIPTION>the CVS repository to add an entry for</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="password" REQUIRED="yes"> - <DESCRIPTION>Password to be added to the password file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="passfile" REQUIRED="no, default is ~/.cvspass."> - <DESCRIPTION>Password file to add the entry to</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="cvstagdiff"> - <DESCRIPTION><p>Generates an XML-formatted report file of the changes between two tags or dates recorded in a -<a href="http://www.cvshome.org/" target="_top">CVS</a> repository. </p> -</DESCRIPTION> - <ATTRIBUTE NAME="starttag" REQUIRED="exactly one of the two."> - <DESCRIPTION>The earliest tag from which diffs are to beincluded in the report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="startdate" REQUIRED=""> - <DESCRIPTION>The earliest date from which diffs are to beincluded in the report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="endtag" REQUIRED="exactly one of the two."> - <DESCRIPTION>The latest tag from which diffs are to beincluded in the report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="enddate" REQUIRED=""> - <DESCRIPTION>The latest date from which diffs are to beincluded in the report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>The file in which to write the diff report</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="rootdir" REQUIRED="no"> - <DESCRIPTION>Root directory for the package, if different from the package name</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="delete"> - <DESCRIPTION><p>Deletes a single file, a specified directory and all its files and -subdirectories, or a set of files specified by one or more -<a href="../CoreTypes/fileset.html">FileSet</a>s. -When specifying a set of files, empty directories are <i>not</i> removed by -default. -To remove empty directories, use the <code>includeEmptyDirs</code> attribute. -</p> -<p> -If you use this task to delete temporary files created by editors -and it doesn't seem to work, read up on the -<a href="../dirtasks.html#defaultexcludes">default exclusion set</a> -in <strong>Directory-based Tasks</strong>, and see the -<code>defaultexcludes</code> attribute below. -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="at least one of the two, - unless a <fileset> is specified."> - <DESCRIPTION>The file to delete, specified as either the simplefilename (if the file exists in the current base directory), arelative-path filename, or a full-path filename</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED=""> - <DESCRIPTION>The directory to delete, including all its files andsubdirectoriesNote: dir is not usedto specify a directory name for file; fileand dir are independent of each otherWARNING: Do not set dir to".", "${basedir}",or the full-pathname equivalent unless you truly intend torecursively remove the entire contents of the current base directory(and the base directory itself, if different from the current workingdirectory)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>Show the name of each deleted file("true"/"false").Default is "false" when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="quiet" REQUIRED="no"> - <DESCRIPTION>If the specified file or directory does not exist,do not display a diagnostic message (unless Anthas been invoked with the &#x2011;verbose or&#x2011;debug switches) or modify the exit status toreflect an error.When set to "true", if a file or directory cannot be deleted,no error is reported. This setting emulates the -f option to the Unix rm command.Default is "false".Setting this to "true" implies settingfailonerror to "false".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Controls whether an error (such as a failure to delete a file)stops the build or is merely reported to the screen.Only relevant if quiet is "false".Default is "true".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includeemptydirs" REQUIRED="no"> - <DESCRIPTION>Set to "true" to delete empty directories whenusing filesets. Default is "false"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>Deprecated. Use <fileset>.Comma- or space-separated list of patterns offiles that must be deleted. All files are relative to the directoryspecified in dir.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>Deprecated. Use <fileset>.The name of a file. Each line ofthis file is taken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>Deprecated. Use <fileset>.Comma- or space-separated list of patterns offiles that must be excluded from the deletion list.All files are relative to the directory specified in dir.No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>Deprecated. Use <fileset>.The name of a file. Each line ofthis file is taken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>Indicates whether default excludesshould be used or not ("yes"/"no").Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="deltree"> - <DESCRIPTION><p>Deletes a directory with all its files and subdirectories.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="dir" REQUIRED="yes"> - <DESCRIPTION>the directory to delete</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="dependset"> - <DESCRIPTION><p> -The dependset task compares a set of source files with a set of target -files. If any of the source files is more recent than any of -the target files, all of the target files are removed. -</p> -<p> -Source files and target files are specified via nested <a -href="../CoreTypes/fileset.html">FileSets</a> and/or nested <a -href="../CoreTypes/filelist.html">FileLists</a>. Arbitrarily many -source and target filesets/filelists may be specified, but at -least one filelist/fileset is required for both sources and targets. -</p> -<p> -Use a FileSet when you want to use wildcard include or exclude -patterns and don't care about missing files. Use a FileList when you -want to consider the non-existence of a file as if it were out of -date. If there are any non-existing files in any source or target -FileList, all target files will be removed. -</p> -<p> -DependSet is useful to capture dependencies that are not or cannot be -determined algorithmically. For example, the &lt;style&gt; task only -compares the source XML file and XSLT stylesheet against the target -file to determined whether to restyle the source. Using dependset you -can extend this dependency checking to include a DTD or XSD file as -well as other stylesheets imported by the main stylesheet. -</p> -</DESCRIPTION> </TASK> - <TASK NAME="dirname"> - <DESCRIPTION><p> -Task to determine the directory path of a specified file. -</p> -<p> -When this task executes, it will set the specified property to the -value of the specified file up to, but not including, the last path -element. If the specified file is a path that ends in a filename, -the filename will be dropped. If the specified file is just a filename, -the directory will be the current directory. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="yes"> - <DESCRIPTION>The path to take the dirname of</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of the property to set</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="ear"> - <DESCRIPTION><p>An extension of the <a href="jar.html">Jar</a> task with special -treatment for files that should end up in an Enterprise Application archive.</p> -<p>(The Ear task is a shortcut for specifying the particular layout of a EAR file. -The same thing can be accomplished by using the <i>prefix</i> and <i>fullpath</i> -attributes of zipfilesets in a Zip or Jar task.)</p> -<p>The extended zipfileset element from the zip task (with attributes <i>prefix</i>, <i>fullpath</i>, and <i>src</i>) is available in the Ear task.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>the EAR file to create</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="appxml" REQUIRED="yes, unless update is set to true"> - <DESCRIPTION>The deployment descriptor to use (META-INF/application.xml)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="basedir" REQUIRED="no"> - <DESCRIPTION>the directory from which to jar the files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compress" REQUIRED="no"> - <DESCRIPTION>Not only store data but also compress them, defaults to tru</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>The character encoding to use for filenamesinside the archive. Defaults to UTF8. It is notrecommended to change this value as the created archive will mostlikely be unreadable for Java otherwise</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filesonly" REQUIRED="no"> - <DESCRIPTION>Store only file entries, defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="manifest" REQUIRED="no"> - <DESCRIPTION>the manifest file to use</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="update" REQUIRED="no"> - <DESCRIPTION>indicates whether to update or overwritethe destination file if it already exists</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="duplicate" REQUIRED="no"> - <DESCRIPTION>behavior when a duplicate file is found. Valid values are "add", "preserve", and "fail". The default value is "add". </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="echo"> - <DESCRIPTION><p>Echoes a message to the current loggers and listeners which -means <tt>System.out</tt> unless overridden. A <tt>level</tt> -can be specified, which controls at what logging level the message is -filtered at. -<p> -The task can also echo to a file, in which case the option to append rather -than overwrite the file is available, and the <tt>level</tt> option is -ignored</p> -</DESCRIPTION> - <ATTRIBUTE NAME="message" REQUIRED="yes, unless data is included in a - character section within this element."> - <DESCRIPTION>the message to echo</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="file" REQUIRED="no"> - <DESCRIPTION>the file to write the message to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no - default is false."> - <DESCRIPTION>Append to an existing file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="level" REQUIRED="no - default is "warning"."> - <DESCRIPTION>Control the level at which this message is reported.One of "error", "warning", "info", "verbose", "debug</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="exec"> - <DESCRIPTION><p>Executes a system command. When the <i>os</i> attribute is specified, then -the command is only executed when Ant is run on one of the specified operating -systems.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="command" REQUIRED="exactly one of the two."> - <DESCRIPTION>the command to execute with all command linearguments. deprecated, use executable and nested<arg> elements instead</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="executable" REQUIRED=""> - <DESCRIPTION>the command to execute without any command linearguments</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>the directory in which the command should be executed</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="os" REQUIRED="no"> - <DESCRIPTION>list of Operating Systems on which the command may beexecuted. If the current OS's name is contained in this list, the command willbe executed. The OS's name is determined by the Java Virtual machine and is setin the "os.name" system property</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output" REQUIRED="no"> - <DESCRIPTION>the file to which the output of the command should beredirected</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no"> - <DESCRIPTION>whether output should be appended to or overwritean existing file. Defaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="outputproperty" REQUIRED="no"> - <DESCRIPTION>the name of a property in which the output of the command should be stored</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="resultproperty" REQUIRED="no"> - <DESCRIPTION>the name of a property in which the return code of the command should be stored. Only of interest if failonerror=fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeout" REQUIRED="no"> - <DESCRIPTION>Stop the command if it doesn't finish within thespecified time (given in milliseconds)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Stop the buildprocess if the command exits with areturncode other than 0. Defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failifexecutionfails" REQUIRED="no"> - <DESCRIPTION>Stop the build if we can't start the program.Defaults to true.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="newenvironment" REQUIRED="no, default is false"> - <DESCRIPTION>Do not propagate old environment when new environmentvariables are specified</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="vmlauncher" REQUIRED="no, default is true"> - <DESCRIPTION>Run command using the Java VM's execution facilitieswhere available. If set to false the underlying OS's shell,either directly or through the antRun scripts, will be used.Under some operating systems, this gives access to facilitiesnot normally available through the VM including, under Windows,being able to execute scripts, rather than their associatedinterpreter. If you want to specify the name of theexecutable as a relative path to the directory given by thedir attribute, it may become necessary to set vmlauncher tofalse as well</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="fail"> - <DESCRIPTION><p>Exits the current build (just throwing a BuildException), optionally printing additional information.</p> -<p>The message of the Exception can be set via the message attribute -or character data nested into the element.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="message" REQUIRED="no"> - <DESCRIPTION>A message giving further information on why the build exite</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="if" REQUIRED="no"> - <DESCRIPTION>Only fail if a property of the given name existsin the current projec</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="unless" REQUIRED="no"> - <DESCRIPTION>Only fail if a property of the given name doesn'texist in the current projec</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="filter"> - <DESCRIPTION><p>Sets a token filter for this project or read multiple token filter from -an input file and sets these as filters. -Token filters are used by all tasks that perform file copying operations -through the Project commodity methods.</p> -<p>Note 1: the token string must not contain the separators chars (@).<br> -Note 2: Either token and value attributes must be provided, or only the -filtersfile attribute.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="token" REQUIRED="yes*"> - <DESCRIPTION>the token string without </DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="value" REQUIRED="yes*"> - <DESCRIPTION>the string that should be put to replace the token when the file is copie</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtersfile" REQUIRED="yes*"> - <DESCRIPTION>The file from which the filters must be read. This file must be a formatted as a property file.</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="fixcrlf"> - <DESCRIPTION><p> -Adjusts a text file to local conventions. -</p> -<p> -The set of files to be adjusted can be refined with the -<i>includes</i>, <i>includesfile</i>, <i>excludes</i>, -<i>excludesfile</i> and <i>defaultexcludes</i> -attributes. Patterns provided through the <i>includes</i> or -<i>includesfile</i> attributes specify files to be -included. Patterns provided through the <i>exclude</i> or -<i>excludesfile</i> attribute specify files to be -excluded. Additionally, default exclusions can be specified with -the <i>defaultexcludes</i> attribute. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based -tasks</a>, for details of file inclusion/exclusion patterns -and their usage. -</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>srcdir</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -<p> -The output file is only written if it is a new file, or if it -differs from the existing file. This prevents spurious -rebuilds based on unchanged files which have been regenerated -by this task. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="srcdir" REQUIRED="yes"> - <DESCRIPTION>Where to find the files to be fixed up</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED="no"> - <DESCRIPTION>Where to place the corrected files. Defaults tosrcDir (replacing the original file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="eol" REQUIRED="no"> - <DESCRIPTION>Specifies how end-of-line (EOL) characters are to behandled. The EOL characters are CR, LF and the pair CRLF.Valid values for this property are:asis: leave EOL characters alonecr: convert all EOLs to a single CRlf: convert all EOLs to a single LFcrlf: convert all EOLs to the pair CRLFDefault is based on the platform on which you are runningthis task. For Unix platforms, the default is "lf".For DOS based systems (including Windows), the default is"crlf". For Mac OS, the default is "cr".This is the preferred method for specifying EOL. The"cr" attribute (see below) isnow deprecated.N.B.: One special case is recognized. The threecharacters CR-CR-LF are regarded as a single EOL.Unless this property is specified as "asis",this sequence will be converted into the specified EOLtype.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cr" REQUIRED="no"> - <DESCRIPTION>Deprecated. Specifies how CR characters areto be handled at end-of-line (EOL). Valid values for thisproperty are:asis: leave EOL characters alone.add: add a CR before any single LF characters. Theintent is to convert all EOLs to the pair CRLF.remove: remove all CRs from the file. The intent isto convert all EOLs to a single LF.Default is based on the platform on which you are runningthis task. For Unix platforms, the default is "remove".For DOS based systems (including Windows), the default is"add".N.B.: One special case is recognized. The threecharacters CR-CR-LF are regarded as a single EOL.Unless this property is specified as "asis",this sequence will be converted into the specified EOLtype.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="javafiles" REQUIRED="no"> - <DESCRIPTION>Used only in association with the"tab" attribute (see below), thisboolean attribute indicates whether the fileset is a setof java source files("yes"/"no"). Defaults to"no". See notes in section on "tab".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tab" REQUIRED="no"> - <DESCRIPTION>Specifies how tab characters are to be handled. Validvalues for this property are:add: convert sequences of spaces which span a tab stop to tabsasis: leave tab and space characters aloneremove: convert tabs to spacesDefault for this parameter is "asis".N.B.: When the attribute"javafiles" (see above) is"true", literal TAB characters occurringwithin Java string or character constants are nevermodified. This functionality also requires therecognition of Java-style comments.N.B.: There is an incompatibility between thisand the previous version in the handling of whitespace at the end of lines. This version doesnot remove trailing whitespace on lines.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tablength" REQUIRED="no"> - <DESCRIPTION>TAB character interval. Valid values are between2 and 80 inclusive. The default for this parameter is 8</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="eof" REQUIRED="no"> - <DESCRIPTION>Specifies how DOS end of file (control-Z) characters areto be handled. Valid values for this property are:add: ensure that there is an EOF character at the end of the fileasis: leave EOF characters aloneremove: remove any EOF character found at the endDefault is based on the platform on which you are running this task.For Unix platforms, the default is remove. For DOS based systems(including Windows), the default is asis.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no - defaults to default jvm encoding"> - <DESCRIPTION>The encoding of the file</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="genkey"> - <DESCRIPTION><p>Generates a key in keystore. This task needs Java1.2 or later</p> -</DESCRIPTION> - <ATTRIBUTE NAME="alias" REQUIRED="yes."> - <DESCRIPTION>the alias to add unde</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="storepass" REQUIRED="yes."> - <DESCRIPTION>password for keystore integrity. Mustbe at least 6 characters lon</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keystore" REQUIRED="no"> - <DESCRIPTION>keystore locatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="storetype" REQUIRED="no"> - <DESCRIPTION>keystore typ</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keypass" REQUIRED="no"> - <DESCRIPTION>password for private key (if different</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sigalg" REQUIRED="no"> - <DESCRIPTION>the algorithm to use in signin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keyalg" REQUIRED="no"> - <DESCRIPTION>the method to use when generating name-value pai</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>(true | false) verbose output when signin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dname" REQUIRED="yes if dname element unspecified"> - <DESCRIPTION>The distinguished name for entit</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="validity" REQUIRED="no"> - <DESCRIPTION>(integer) indicates how many days certificate is vali</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keysize" REQUIRED="no"> - <DESCRIPTION>(integer) indicates the size of key generate</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="get"> - <DESCRIPTION><p>Gets a file from a URL. When the verbose option is &quot;on&quot;, this task -displays a '.' for every 100 Kb retrieved. Any URL schema supported by -the runtime is valid here, including http:, ftp: and jar:; -https: is only valid if the appropriate support is added to the pre-1.4 Java -runtimes. -</p> -<p>This task should be preferred above the <a href="cvs.html">CVS task</a> when -fetching remote content. CVS is significantly slower than loading a compressed -archive compared to http/ftp.</p> -The <i>usetimestamp</i> option enables you to control downloads so that the remote file is -only fetched if newer than the local copy. If there is no local copy, the download always takes -place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp, -if the JVM is Java1.2 or later. -NB: This timestamp facility only works on downloads using the HTTP protocol. -<p> -A username and password can be specified, in which case basic 'slightly encoded -plain text' authentication is used. This is only a secure authentication -mechanism over an HTTPS link. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="src" REQUIRED="yes"> - <DESCRIPTION>the URL from which to retrieve a file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>the file where to store the retrieved file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no; default "false""> - <DESCRIPTION>show verbose progress information ("on"/"off")</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ignoreerrors" REQUIRED="no; default "false""> - <DESCRIPTION>Log errors but don't treat as fatal</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="usetimestamp" REQUIRED="no; default "false""> - <DESCRIPTION>conditionally download a file based on the timestamp of thelocal copy. HTTP onl</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="username" REQUIRED="if password is set"> - <DESCRIPTION>username for 'BASIC' http authenticatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="password" REQUIRED="if username is set"> - <DESCRIPTION>password: required</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="input"> - <DESCRIPTION><p>Allows user interaction during the build process by prompting for -input. To do so, it uses the configured -<a href="../inputhandler.html">InputHandler</a>.</p> -<p>The prompt can be set via the message attribute or as character -data nested into the element.</p> -<p>Optinonally a set of valid imput arguments can be defined via the -validargs attribute. Input task will no accept value that don't match -one of the predefined.</p> -<p>Optionally a property can be created from the value entered by the -user. This property can then be used during the following build -run. Input behaves according to <a href="property.html">property -task</a> which means that existing properties cannot be overriden.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="message" REQUIRED="no"> - <DESCRIPTION>the Message which gets displayed to the userduring the build run</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="validargs" REQUIRED="no"> - <DESCRIPTION>comma separated String containing valid inputarguments. If set, input task will reject any input not definedhere. Validargs are compared case sensitive. If you want 'a' and'A' to be accepted you will need to define both arguments withinvalidargs</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="addproperty" REQUIRED="no"> - <DESCRIPTION>the name of a property to be created frominput. Behaviour is equal to propertytask which means that existing properties cannot beoverriden</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jar"> - <DESCRIPTION><p>Jars a set of files.</p> -<p>The <i>basedir</i> attribute is the reference directory from where to jar.</p> -<p>Note that file permissions will not be stored in the resulting jarfile.</p> -<p>It is possible to refine the set of files that are being jarred. This can be -done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> -attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns.</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>basedir</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -<p>You can also use nested file sets for more flexibility, and specify -multiple ones to merge together different trees of files into one JAR. -The extended fileset and groupfileset attributes from the zip task are -also available in the jar task. -See the <a href="zip.html">Zip</a> task for more details and examples.</p> -<p>If the manifest is omitted, a simple one will be supplied by Ant.</p> -<p>The <code>update</code> parameter controls what happens if the -JAR file already exists. When set to <code>yes</code>, the JAR file is -updated with the files specified. When set to <code>no</code> (the -default) the JAR file is overwritten. An example use of this is -provided in the <a href="zip.html">Zip task documentation</a>.</p> -<p>(The Jar task is a shortcut for specifying the manifest file of a JAR file. -The same thing can be accomplished by using the <i>fullpath</i> -attribute of a zipfileset in a Zip task. The one difference is that if the -<i>manifest</i> attribute is not specified, the Jar task will -include an empty one for you.)</p> -<p>Manifests are processed by the Jar task according to the -<a href="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html">Jar file specification.</a> -Note in particular that this may result in manifest lines greater than 72 bytes -being wrapped and continued on the next line. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>the JAR file to create</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="basedir" REQUIRED="no"> - <DESCRIPTION>the directory from which to jar the files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compress" REQUIRED="no"> - <DESCRIPTION>Not only store data but also compress them, defaults to tru</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>The character encoding to use for filenamesinside the archive. Defaults to UTF8. It is notrecommended to change this value as the created archive will mostlikely be unreadable for Java otherwise</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filesonly" REQUIRED="no"> - <DESCRIPTION>Store only file entries, defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="manifest" REQUIRED="no"> - <DESCRIPTION>the manifest file to use. This can be either the location of a manifest, or the name of a jar added through a fileset. If its the name of an added jar, the task expects the manifest to be in the jar at META-INF/MANIFEST.M</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="update" REQUIRED="no"> - <DESCRIPTION>indicates whether to update or overwritethe destination file if it already exists</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="whenempty" REQUIRED="no"> - <DESCRIPTION>behavior when no files match. Valid values are "fail", "skip", and "create". Default is "skip"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="duplicate" REQUIRED="no"> - <DESCRIPTION>behavior when a duplicate file is found. Valid values are "add", "preserve", and "fail". The default value is "add". </DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="index" REQUIRED="no"> - <DESCRIPTION>whether to create an index list to speed up classloading. This is a JDK 1.3+ specific feature. Defaults to false.</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="java"> - <DESCRIPTION><p>Executes a Java class within the running (Ant) VM or forks another VM if -specified.</p> -<p> -If odd things go wrong when you run this task, set fork="true" to use a new -JVM. -</DESCRIPTION> - <ATTRIBUTE NAME="classname" REQUIRED="either jar or classname"> - <DESCRIPTION>the Java class to execute</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="jar" REQUIRED="either jar or classname"> - <DESCRIPTION>the location of the jar file to execute (must have a Main-Class entry in the manifest). Fork must be set to true if this option is selected</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="args" REQUIRED="no"> - <DESCRIPTION>the arguments for the class that isexecuted. deprecated, use nested <arg>elements instead</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>the classpath to use</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>the classpath to use, given as reference to a PATH defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fork" REQUIRED="no"> - <DESCRIPTION>if enabled triggers the class execution in another VM(disabled by default</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="jvm" REQUIRED="no"> - <DESCRIPTION>the command used to invoke the Java Virtual Machine,default is 'java'. The command is resolved by java.lang.Runtime.exec().Ignored if fork is disabled.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="jvmargs" REQUIRED="no"> - <DESCRIPTION>the arguments to pass to the forked VM (ignoredif fork is disabled). deprecated, use nested<jvmarg> elements instead</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxmemory" REQUIRED="no"> - <DESCRIPTION>Max amount of memory to allocate to the forked VM(ignored if fork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Stop the buildprocess if the command exits with areturncode other than 0. Default is "false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>The directory to invoke the VM in. (ignored iffork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output" REQUIRED="no"> - <DESCRIPTION>Name of a file to write the output to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no"> - <DESCRIPTION>whether output should be appended to or overwritean existing file. Defaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="newenvironment" REQUIRED="no"> - <DESCRIPTION>Do not propagate old environment when newenvironment variables are specified. Default is "false"(ignored if fork is disabled)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeout" REQUIRED="no"> - <DESCRIPTION>Stop the command if it doesn't finish within thespecified time (given in milliseconds). It is highlyrecommended to use this feature only if fork is enabled</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="javac"> - <DESCRIPTION><p>Compiles a Java source tree.</p> -<p>The source and destination directory will be recursively scanned for Java -source files to compile. Only Java files that have no corresponding -<code>.class</code> file -or where the class file is older than the -<code>.java</code> file will be compiled.</p> -<p>Note: Ant uses only the names of the source and class files to find -the classes that need a rebuild. It will not scan the source and therefore -will have no knowledge about nested classes, classes that are named different -from the source file, and so on. See the -<a href="../OptionalTasks/depend.html"><code>&lt;depend&gt;</code></a> task -for dependency checking based on other than just -existence/modification times.</p> -<p>When the source files are part of a package, the directory structure of -the source tree should follow the package -hierarchy.</p> -<p>It is possible to refine the set of files that are being compiled. -This can be done with the <code>includes</code>, <code>includesfile</code>, -<code>excludes</code>, and <code>excludesfile</code> -attributes. With the <code>includes</code> or -<code>includesfile</code> attribute, you specify the files you want to -have included. -The <code>exclude</code> or <code>excludesfile</code> attribute is used -to specify -the files you want to have excluded. In both cases, the list of files -can be specified by either the filename, relative to the directory(s) specified -in the <code>srcdir</code> attribute or nested <code>&lt;src&gt;</code> -element(s), or by using wildcard patterns. See the section on -<a href="../dirtasks.html#directorybasedtasks">directory-based tasks</a>, -for information on how the -inclusion/exclusion of files works, and how to write wildcard patterns.</p> -<p>It is possible to use different compilers. This can be specified by -either setting the global <code>build.compiler</code> property, which will -affect all <code>&lt;javac&gt;</code> tasks throughout the build, or by -setting the <code>compiler</code> attribute, specific to the current -<code>&lt;javac&gt;</code> task. -<a name="compilervalues">Valid values for either the -<code>build.compiler</code> property or the <code>compiler</code> -attribute are:</a></p> -<ul> -<li><code>classic</code> (the standard compiler of JDK 1.1/1.2) &ndash; -<code>javac1.1</code> and -<code>javac1.2</code> can be used as aliases.</li> -<li><code>modern</code> (the standard compiler of JDK 1.3/1.4) &ndash; -<code>javac1.3</code> and -<code>javac1.4</code> can be used as aliases.</li> -<li><code>jikes</code> (the <a -href="http://oss.software.ibm.com/developerworks/opensource/jikes/" target="_top">Jikes</a> -compiler).</li> -<li><code>jvc</code> (the Command-Line Compiler from Microsoft's SDK -for Java / Visual J++) &ndash; <code>microsoft</code> can be used -as an alias.</li> -<li><code>kjc</code> (the <a href="http://www.dms.at/kopi/" target="_top">kopi</a> -compiler).</li> -<li><code>gcj</code> (the gcj compiler from gcc).</li> -<li><code>sj</code> (Symantec java compiler) &ndash; -<code>symantec</code> can be used as an alias.</li> -<li><code>extJavac</code> (run either modern or classic in a JVM of -its own).</li> -</ul> -<p>The default is <code>javac1.x</code> with <code>x</code> depending -on the JDK version you use while you are running Ant. -If you wish to use a different compiler interface than those -supplied, you can write a class that implements the CompilerAdapter interface -(<code>package org.apache.tools.ant.taskdefs.compilers</code>). Supply the full -classname in the <code>build.compiler</code> property or the -<code>compiler</code> attribute. -</p> -<p>The fork attribute overrides the <code>build.compiler</code> property -or <code>compiler</code> attribute setting and -expects a JDK1.1 or higher to be set in <code>JAVA_HOME</code>. -</p> -<p>You can also use the <code>compiler</code> attribute to tell Ant -which JDK version it shall assume when it puts together the command -line switches - even if you set <code>fork=&quot;true&quot;</code>. -This is useful if you want to run the compiler of JDK 1.1 while you -current JDK is 1.2+. If you use -<code>compiler=&quot;javac1.1&quot;</code> and (for example) -<code>depend=&quot;true&quot;</code> Ant will use the command line -switch <code>-depend</code> instead of <code>-Xdepend</code>.</p> -<p>This task will drop all entries that point to non-existent -files/directories from the classpath it passes to the compiler.</p> -<p><strong>Windows Note:</strong>When the modern compiler is used -in unforked mode on Windows, it locks up the files present in the -classpath of the <code>&lt;javac&gt;</code> task, and does not release them. -The side effect of this is that you will not be able to delete or move -those files later on in the build. The workaround is to fork when -invoking the compiler.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="srcdir" REQUIRED="yes, unless nested <src> elements are present."> - <DESCRIPTION>Location of the java files. (See thenote below.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED="no"> - <DESCRIPTION>Location to store the class files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>Comma- or space-separated list of files (may be specified usingwildcard patterns) that must beincluded; all .java files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>The name of a file that contains a list of files toinclude (may be specified using wildcard patterns)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>Comma- or space-separated list of files (may be specified usingwildcard patterns) that must be excluded; no files (except defaultexcludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>The name of a file that contains a list of files toexclude (may be specified using wildcard patterns)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>The classpath to use</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sourcepath" REQUIRED="no"> - <DESCRIPTION>The sourcepath to use; defaults to the value of the srcdir attribute (or nested <src> elements).To suppress the sourcepath switch, use sourcepath=""</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bootclasspath" REQUIRED="no"> - <DESCRIPTION>Location of bootstrap class files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>The classpath to use, given as areference to a path defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sourcepathref" REQUIRED="no"> - <DESCRIPTION>The sourcepath to use, given as areference to a path defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bootclasspathref" REQUIRED="no"> - <DESCRIPTION>Location of bootstrap class files, given as areference to a path defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="extdirs" REQUIRED="no"> - <DESCRIPTION>Location of installed extensions</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>Encoding of source files. (Note: gcj doesn't supportthis option yet.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nowarn" REQUIRED="no"> - <DESCRIPTION>Indicates whether the -nowarn switchshould be passed to the compiler; defaults to off</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debug" REQUIRED="no"> - <DESCRIPTION>Indicates whether source should be compiled with debuginformation; defaults to off</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debuglevel" REQUIRED="no"> - <DESCRIPTION>Keyword list to be appended to the -gcommand-line switch. This will be ignored by all implementations exceptmodern and classic(ver >= 1.2).Legal values are none or a comma-separated list of thefollowing keywords:lines, vars, and source.If debuglevel is not specified, by default,:none will beappended to -g. If debug is not turned on,this attribute will be ignored.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="optimize" REQUIRED="no"> - <DESCRIPTION>Indicates whether source should be compiled withoptimization; defaults to off</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="deprecation" REQUIRED="no"> - <DESCRIPTION>Indicates whether source should be compiled withdeprecation information; defaults to off</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="target" REQUIRED="no"> - <DESCRIPTION>Generate class files for specific VM version(e.g., 1.1 or 1.2). Note that thedefault value depends on the JVM that is running Ant. Inparticular, if you use JDK 1.4 the generated classes will not beusable for a 1.1 Java VM unless you explicitly set this attributeto the value 1.1 (which is the default value for JDK 1.1 to1.3)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>Asks the compiler for verbose output</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="depend" REQUIRED="no"> - <DESCRIPTION>Enables dependency-trackingfor compilers that support this (jikes andclassic)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includeantruntime" REQUIRED="no"> - <DESCRIPTION>Whether to include the Ant run-time libraries in theclasspath; defaults to yes</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includejavaruntime" REQUIRED="no"> - <DESCRIPTION>Whether to include the default run-timelibraries from the executing VM in the classpath;defaults to yes</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fork" REQUIRED="no"> - <DESCRIPTION>Whether to execute javac using theJDK compiler externally; defaults to no</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="executable" REQUIRED="no"> - <DESCRIPTION>Complete path to the javacexecutable to use in case of fork="yes".Defaults to the compiler of the Java version that is currentlyrunning Ant. Ignored if fork="no</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="memoryinitialsize" REQUIRED="no"> - <DESCRIPTION>The initial size of the memory for the underlying VM,if javac is run externally; ignored otherwise. Defaultsto the standard VM memory setting.(Examples: 83886080, 81920k, or80m</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="memorymaximumsize" REQUIRED="no"> - <DESCRIPTION>The maximum size of the memory for the underlying VM,if javac is run externally; ignored otherwise. Defaultsto the standard VM memory setting.(Examples: 83886080, 81920k, or80m</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Indicates whether the build will continue even if there are compilation errors; defaults to true.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="source" REQUIRED="no"> - <DESCRIPTION>Value of the -source command-lineswitch; will be ignored by all implementations exceptjavac1.4 (or modern when Ant is notrunning in a 1.3 VM) and jikesIf you use thisattribute together with jikes, you must make surethat your version of jikes supports the -sourceswitchLegal values are 1.3 and 1.4&ndash; by default, no -source argument will be usedat all</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compiler" REQUIRED="no"> - <DESCRIPTION>The compiler implementation to use.If this attribute is not set, the value of thebuild.compiler property, if set, will be used.Otherwise, the default compiler for the current VM will be used.(See the above list of validcompilers.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="listfiles" REQUIRED="no"> - <DESCRIPTION>Indicates whether the source files to be compiled willbe listed; defaults to no</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="javadoc"> - <DESCRIPTION><p>Generates code documentation using the javadoc tool.</p> -<p>The source directory will be recursively scanned for Java source files to process -but only those matching the inclusion rules, and not matching the exclusions rules -will be passed to the javadoc tool. This -allows wildcards to be used to choose between package names, reducing verbosity -and management costs over time. This task, however, has no notion of -&quot;changed&quot; files, unlike the <a href="javac.html">javac</a> task. This means -all packages will be processed each time this task is run. In general, however, -this task is used much less frequently.</p> -<p>This task works seamlessly between different javadoc versions (1.1, -1.2 and 1.4), with the obvious restriction that the 1.2 attributes -will be ignored if run in a 1.1 VM.</p> -<p>NOTE: since javadoc calls System.exit(), javadoc cannot be run inside the -same VM as ant without breaking functionality. For this reason, this task -always forks the VM. This overhead is not significant since javadoc is normally a heavy -application and will be called infrequently.</p> -<p>NOTE: the packagelist attribute allows you to specify the list of packages to -document outside of the Ant file. It's a much better practice to include everything -inside the build.xml file. This option was added in order to make it easier to -migrate from regular makefiles, where you would use this option of javadoc. -The packages listed in packagelist are not checked, so the task performs even -if some packages are missing or broken. Use this option if you wish to convert from -an existing makefile. Once things are running you should then switch to the regular -notation. </p> -<p><i><b>DEPRECATION:</b> the javadoc2 task simply points to the javadoc task and it's -there for back compatibility reasons. Since this task will be removed in future -versions, you are strongly encouraged to use <a href="javadoc.html">javadoc</a> -instead.</i></p> -<p>In the table below, 1.1 means available if your current Java VM is -a 1.1 VM, 1.2 for either 1.2 or 1.3 and 1.4 for a 1.4 Java VM. 1.2+ -means any VM of at least version 1.2.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="sourcepath" REQUIRED="at least one of the three or nested - <sourcepath>, <fileset> or - <packageset>"> - <DESCRIPTION>Specify where to find source file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sourcepathref" REQUIRED=""> - <DESCRIPTION>Specify where to find source files by reference to a PATH defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sourcefiles" REQUIRED=""> - <DESCRIPTION>Comma separated list of source file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED="yes, unless a doclet has been specified."> - <DESCRIPTION>Destination directory for output file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxmemory" REQUIRED="no"> - <DESCRIPTION>Max amount of memory to allocate to the javadoc V</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="packagenames" REQUIRED="no"> - <DESCRIPTION>Comma separated list of package files (with terminatingwildcard</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="packagelist" REQUIRED="no"> - <DESCRIPTION>The name of a file containing the packages to proces</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>Specify where to find user class file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bootclasspath" REQUIRED="no"> - <DESCRIPTION>Override location of class files loaded by the bootstrapclass loade</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>Specify where to find user class files by reference to a PATH defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bootclasspathref" REQUIRED="no"> - <DESCRIPTION>Override location of class files loaded by thebootstrap class loader by reference to aPATH defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="extdirs" REQUIRED="no"> - <DESCRIPTION>Override location of installed extension</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="overview" REQUIRED="no"> - <DESCRIPTION>Read overview documentation from HTML fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="access" REQUIRED="no (default protected)"> - <DESCRIPTION>Access mode: one of public, protected,package, or privat</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="public" REQUIRED="no"> - <DESCRIPTION>Show only public classes and member</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="protected" REQUIRED="no"> - <DESCRIPTION>Show protected/public classes and members (default</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="package" REQUIRED="no"> - <DESCRIPTION>Show package/protected/public classes and member</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="private" REQUIRED="no"> - <DESCRIPTION>Show all classes and member</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="old" REQUIRED="no"> - <DESCRIPTION>Generate output using JDK 1.1 emulating docle</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>Output messages about what Javadoc is doin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="locale" REQUIRED="no"> - <DESCRIPTION>Locale to be used, e.g. en_US or en_US_WI</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>Source file encoding nam</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="version" REQUIRED="no"> - <DESCRIPTION>Include @version paragraph</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="use" REQUIRED="no"> - <DESCRIPTION>Create class and package usage page</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="author" REQUIRED="no"> - <DESCRIPTION>Include @author paragraph</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="splitindex" REQUIRED="no"> - <DESCRIPTION>Split index into one file per lette</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="windowtitle" REQUIRED="no"> - <DESCRIPTION>Browser window title for the documentation (text</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="doctitle" REQUIRED="no"> - <DESCRIPTION>Include title for the package index(first) page (html-code</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="header" REQUIRED="no"> - <DESCRIPTION>Include header text for each page (html-code</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="footer" REQUIRED="no"> - <DESCRIPTION>Include footer text for each page (html-code</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bottom" REQUIRED="no"> - <DESCRIPTION>Include bottom text for each page (html-code</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="link" REQUIRED="no"> - <DESCRIPTION>Create links to javadoc output at the given UR</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="linkoffline" REQUIRED="no"> - <DESCRIPTION>Link to docs at <url> using package list at<url2> - separate the URLs by using a space character</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="group" REQUIRED="no"> - <DESCRIPTION>Group specified packages together in overviewpage. The format is as described below</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodeprecated" REQUIRED="no"> - <DESCRIPTION>Do not include @deprecated informatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodeprecatedlist" REQUIRED="no"> - <DESCRIPTION>Do not generate deprecated lis</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="notree" REQUIRED="no"> - <DESCRIPTION>Do not generate class hierarch</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="noindex" REQUIRED="no"> - <DESCRIPTION>Do not generate inde</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nohelp" REQUIRED="no"> - <DESCRIPTION>Do not generate help lin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nonavbar" REQUIRED="no"> - <DESCRIPTION>Do not generate navigation ba</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="serialwarn" REQUIRED="no"> - <DESCRIPTION>Generate warning about @serial ta</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="helpfile" REQUIRED="no"> - <DESCRIPTION>Specifies the HTML help file to us</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="stylesheetfile" REQUIRED="no"> - <DESCRIPTION>Specifies the CSS stylesheet to us</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="charset" REQUIRED="no"> - <DESCRIPTION>Charset for cross-platform viewing of generateddocumentatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="docencoding" REQUIRED="no"> - <DESCRIPTION>Output file encoding nam</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="doclet" REQUIRED="no"> - <DESCRIPTION>Specifies the class file that starts the doclet used in generating the documentation</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="docletpath" REQUIRED="no"> - <DESCRIPTION>Specifies the path to the doclet class file that is specified with the -doclet option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="docletpathref" REQUIRED="no"> - <DESCRIPTION>Specifies the path to the doclet class file thatis specified with the -doclet option by reference to a PATH defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="additionalparam" REQUIRED="no"> - <DESCRIPTION>Lets you add additional parameters to the javadoccommand line. Useful for doclets. Parameters containingspaces need to be quoted using &quot;</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>Stop the buildprocess if the command exits with areturncode other than 0</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludepackagenames" REQUIRED="no"> - <DESCRIPTION>comma separated list of packages you don't wantdocs for</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used(yes | no); default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="useexternalfile" REQUIRED="no"> - <DESCRIPTION>indicates whether the sourcefile name specifiedin srcfiles or as nested source elements should be written to atemporary file to make the command line shorter. Also applies tothe package names specified via the packagenames attribute ornested package elements.(yes | no). Default is no</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="source" REQUIRED="no"> - <DESCRIPTION>Necessary to enable javadoc to handle assertionspresent in J2SE v 1.4 source code. Set this to "1.4" todocuments code that compiles using "javac -source1.4". Will be ignored if you use a customdoclet</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="loadfile"> - <DESCRIPTION><p> -Load a text file into a single property. Unless an encoding is specified, -the encoding of the current locale is used. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="srcfile" REQUIRED="yes"> - <DESCRIPTION>source fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>property to save t</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>encoding to use when loading the fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no, default "true""> - <DESCRIPTION>Whether to halt the build on failur</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="loadproperties"> - <DESCRIPTION><p> -Load a file's contents as Ant properties. This is equivalent -to &lt;property file=&quot;...&quot;/&gt; except that it -supports nested &lt;filterchain&gt; elements and it cannot be -specified outside a target. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="srcfile" REQUIRED="yes"> - <DESCRIPTION>source fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>encoding to use when loading the fil</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="mail"> - <DESCRIPTION><p>A task to send SMTP email. This task can send mail using either plain -text, UU encoding, or MIME format mail, depending on what is available. -Attachments may be sent using nested -<a href="../CoreTypes/fileset.html">fileset</a> elements.</p> -<p><strong>Note:</strong> This task may depend on external libraries -that are not included -in the Ant distribution. See <a href="../install.html#librarydependencies"> -Library Dependencies</a> for more information. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="from" REQUIRED="either a from attribute, or a <from> - element."> - <DESCRIPTION>Email address of sender</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tolist" REQUIRED="at least one of these, or the - equivalent elements."> - <DESCRIPTION>Comma-separated list of recipients</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cclist" REQUIRED=""> - <DESCRIPTION>Comma-separated list of recipients to carbon cop</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bcclist" REQUIRED=""> - <DESCRIPTION>Comma-separated list of recipients to carbon cop</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="message" REQUIRED="one of these or a - <message> element."> - <DESCRIPTION>Message to send in the body of the email</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="messagefile" REQUIRED=""> - <DESCRIPTION>File to send as the body of the email. Propertyvalues in the file will be expanded</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="messagemimetype" REQUIRED="no"> - <DESCRIPTION>The content type of the message. The default istext/plain</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="files" REQUIRED="no"> - <DESCRIPTION>Files to send as attachments to the email. Separate multiplefile names using a comma. You can also use <fileset>elements to specify files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no."> - <DESCRIPTION>flag to indicate whether to halt the build onany error. The default value is true</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includefilenames" REQUIRED="no"> - <DESCRIPTION>Include filename(s) before file contents.Valid only when the plain encoding is used. The defaultvalue is false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mailhost" REQUIRED="no"> - <DESCRIPTION>Host name of the SMTP server. The default value islocalhost</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mailport" REQUIRED="no"> - <DESCRIPTION>TCP port of the SMTP server. The default value is 25</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>Specifies the encoding to use for the content of the email.Values are mime, uu, plain, orauto. The default value is auto</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="subject" REQUIRED="no"> - <DESCRIPTION>Email subject line</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="manifest"> - <DESCRIPTION><p>Creates a manifest file.</p> -<p>This task can be used to write a Manifest file, optionally -replacing or updating an existing file.</p> -<p>Manifests are processed according to the -<a href="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html">Jar -file specification.</a>. Specifically, a manifest element consists of -a set of attributes and sections. These sections in turn may contain -attributes. Note in particular that this may result in manifest lines -greater than 72 bytes being wrapped and continued on the next -line.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="yes"> - <DESCRIPTION>the manifest-file to create/update</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mode" REQUIRED="no"> - <DESCRIPTION>One of "update" or "replace", default is "replace"</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="mkdir"> - <DESCRIPTION><p>Creates a directory. Also non-existent parent directories are created, when -necessary.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="dir" REQUIRED="yes"> - <DESCRIPTION>the directory to create</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="move"> - <DESCRIPTION><p>Moves a file to a new file or directory, or sets of files to -a new directory. By default, the -destination file is overwritten if it already exists. When <var>overwrite</var> is -turned off, then files are only moved if the source file is newer than -the destination file, or when the destination file does not exist.</p> -<p><a href="../CoreTypes/fileset.html">FileSet</a>s are used to select sets of files -to move to the <var>todir</var> directory.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="one of file or - at least one nested fileset element"> - <DESCRIPTION>the file to mov</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tofile" REQUIRED="with the file attribute, - either tofile or todir can be used. with nested filesets, - if the fileset size is greater than 1 or if the only entry in the fileset is a - directory or if the file attribute is already specified, only - todir is allowed"> - <DESCRIPTION>the file to move t</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="todir" REQUIRED=""> - <DESCRIPTION>the directory to move t</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="overwrite" REQUIRED="no"> - <DESCRIPTION>overwrite existing files even if the destinationfiles are newer (default is "true"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtering" REQUIRED="no"> - <DESCRIPTION>indicates whether token filtering should take place duringthe move. See the filter task for a description ofhow filters work</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="flatten" REQUIRED="no"> - <DESCRIPTION>ignore directory structure of source directory,copy all files into a single directory, specified by the todirattribute (default is "false").Note that you can achieve thesame effect by using a flatten mappe</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includeemptydirs" REQUIRED="no"> - <DESCRIPTION>Copy empty directories included with the nested FileSet(s).Defaults to "yes"</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="parallel"> - <DESCRIPTION><p>Parallel is a container task - it can contain other Ant tasks. Each nested -task within the parallel task will be executed in its own thread. </p> -<p>Parallel tasks have a number of uses in an Ant buildfile including:</p> -<ul> -<li>Taking advantage of available processing resources to reduce build time</li> -<li>Testing servers, where the server can be run in one thread and the test -harness is run in another thread.</li> -</ul> -<p>Care must be taken when using multithreading to ensure the tasks within the -threads do not interact. For example, two javac compile tasks which write -classes into the same destination directory may interact where one tries to -read a class for dependency information while the other task is writing the -class file. Be sure to avoid these types of interactions within a -&lt;parallel&gt; task</p> -<p>The parallel task has no attributes and does not support any nested -elements apart from Ant tasks. Any valid Ant task may be embedded within a -parallel task, including other parallel tasks.</p> -<p>Note that while the tasks within the parallel task are being run, the main -thread will be blocked waiting for all the child threads to complete.</p> -<p>If any of the tasks within the &lt;parallel&gt; task fails, the remaining -tasks in other threads will continue to run until all threads have completed. -In this situation, the parallel task will also fail.</p> -<p>The parallel task may be combined with the <a href="sequential.html"> -sequential</a> task to define sequences of tasks to be executed on each thread -within the parallel block</p> -<h3>Examples</h3> -<pre> -&lt;parallel&gt; -&lt;wlrun ... &gt; -&lt;sequential&gt; -&lt;sleep seconds=&quot;30&quot;/&gt; -&lt;junit ... &gt; -&lt;wlstop/&gt; -&lt;/sequential&gt; -&lt;/parallel&gt; -</pre> -<p>This example represents a typical pattern for testing a server application. -In one thread the server is started (the wlrun task). The other thread consists -of a three tasks which are performed in sequence. The sleep task is used to -give the server time to come up. Another task which is capable of validating -that the server is available could be used in place of the sleep task. The -test harness is then run. Once the tests are complete, the server is stopped -(using wlstop in this example), allowing both threads to complete. The -parallel task will also complete at this time and the build will then -continue.</p> -<pre> -&lt;parallel&gt; -&lt;javac ...&gt; &lt;!-- compiler servlet code --&gt; -&lt;wljspc ...&gt; &lt;!-- precompile JSPs --&gt; -&lt;/parallel&gt; -</pre> -<p>This example shows two independent tasks being run to achieve better -resource utilization during the build. In this instance, some servlets are being -compiled in one thead and a set of JSPs is being precompiled in another. As -noted above, you need to be careful that the two tasks are independent, both in -terms of their dependencies and in terms of their potential interactions in -Ant's external environment.</p> -<hr> -<p align="center">Copyright &copy; 2001-2002 Apache Software Foundation. All rights -Reserved.</p> -</body> -</html> -</DESCRIPTION> </TASK> - <TASK NAME="patch"> - <DESCRIPTION><p>Applies a diff file to originals. ; requires "patch" to be -on the execution path. </p> -</DESCRIPTION> - <ATTRIBUTE NAME="patchfile" REQUIRED="yes"> - <DESCRIPTION>the file that includes the diff outpu</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="originalfile" REQUIRED="no, tries to guess it from the diff - file"> - <DESCRIPTION>the file to patc</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="backups" REQUIRED="no"> - <DESCRIPTION>Keep backups of the unpatched file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="quiet" REQUIRED="no"> - <DESCRIPTION>Work silently unless an error occur</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="reverse" REQUIRED="no"> - <DESCRIPTION>Assume patch was created with old and new files swapped</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ignorewhitespace" REQUIRED="no"> - <DESCRIPTION>Ignore whitespace differences</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strip" REQUIRED="no"> - <DESCRIPTION>Strip the smallest prefix containing num leading slashes from filenames</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no, default is the project's basedir."> - <DESCRIPTION>The directory in which to run the patch command</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="pathconvert"> - <DESCRIPTION><p>Converts a nested <code>&lt;path&gt;</code> or reference to a Path, -FileSet, DirSet, or FileList into a path -form for a particular platform, and stores the result in a given property. -It can also be used when you need -to convert a Path, FileSet, or DirSet into a list, separated by a given -character, such as a comma or space, or, conversely, to convert a list -of files in a FileList into a path. -</p> -<p>Nested <code>&lt;map&gt;</code> elements can be specified to map Windows -drive letters to Unix paths, and vice-versa.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="targetos" REQUIRED="yes, unless pathsep and/or - dirsep are specified. - "> - <DESCRIPTION>The target architecture. Must be one of 'unix', 'windows', 'netware' or 'os/2'.This is a shorthand mechanism for specifying bothpathsep and dirsepaccording to the specified target architecture.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dirsep" REQUIRED="no, defaults to current jvm file.separator"> - <DESCRIPTION>The character(s) to use as the directory separator in thegenerated paths.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="pathsep" REQUIRED="no, defaults to current jvm file.pathseparator"> - <DESCRIPTION>The character(s) to use as the path-element separator in thegenerated paths.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of the property in which to place the converted path</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="refid" REQUIRED="no; if omitted, a nested - <path> element must be supplied."> - <DESCRIPTION>What to convert, given as areference to a<path>, <fileset>,<dirset>, or <fileset>defined elsewher</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="setonempty" REQUIRED="no; default is "true". - "> - <DESCRIPTION>Should the property be set, even if the resultis the empty string?</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="property"> - <DESCRIPTION><p>Sets a property (by name and value), or set of properties (from file or -resource) in the project. Properties are case sensitive.</p> -Properties are immutable: whoever sets a property first freezes it for the -rest of the build; they are most definately not variable. -<p>There are five ways to set properties:</p> -<ul> -<li>By supplying both the <i>name</i> and <i>value</i> attribute.</li> -<li>By supplying both the <i>name</i> and <i>refid</i> attribute.</li> -<li>By setting the <i>file</i> attribute with the filename of the property -file to load. This property file has the format as defined by the file used -in the class java.util.Properties.</li> -<li>By setting the <i>resource</i> attribute with the resource name of the -property file to load. This property file has the format as defined by the -file used in the class java.util.Properties.</li> -<li>By setting the <i>environment</i> attribute with a prefix to use. -Properties will be defined for every environment variable by -prefixing the supplied name and a period to the name of the variable.</li> -</ul> -<p>Although combinations of these ways are possible, only one should be used -at a time. Problems might occur with the order in which properties are set, for -instance.</p> -<p>The value part of the properties being set, might contain references to other -properties. These references are resolved at the time these properties are set. -This also holds for properties loaded from a property file.</p> -<p>A list of predefined properties can be found <a -href="../using.html#built-in-props">here</a>.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="name" REQUIRED="no"> - <DESCRIPTION>the name of the property to set</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="value" REQUIRED="one of these, when using the - name attribute"> - <DESCRIPTION>the value of the property</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="location" REQUIRED=""> - <DESCRIPTION>Sets the property to the absolute filename of thegiven file. If the value of this attribute is an absolute path, itis left unchanged (with / and \ characters converted to thecurrent platforms conventions). Otherwise it is taken as a pathrelative to the project's basedir and expanded</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="refid" REQUIRED=""> - <DESCRIPTION>Reference to an objectdefined elsewhere. Only yields reasonable results for referencesto PATH like structures or properties</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="resource" REQUIRED="one of these, when - not using the name attribute"> - <DESCRIPTION>the resource name of the property file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="file" REQUIRED=""> - <DESCRIPTION>the filename of the property file </DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="environment" REQUIRED=""> - <DESCRIPTION>the prefix to use when retrieving environment variables. Thusif you specify environment="myenv" you will be able to access OS-specific environment variables via property names "myenv.PATH" or "myenv.TERM". Note that if you supply a property name with a final "." it will not be doubled. ie environment="myenv." will still allow access of environment variables through "myenv.PATH" and "myenv.TERM". This functionality is currently only implemented on select platforms. Feel free to send patches to increase the number of platformsthis functionality is supported on ;)Note also that properties are case sensitive, even if theenvironment variables on your operating system are not, e.g. itwill be ${env.Path} not ${env.PATH} on Windows 2000</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>the classpath to use when looking up a resource</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>the classpath to use when looking up a resource,given as reference to a <path> definedelsewhere.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="prefix" REQUIRED="no"> - <DESCRIPTION>Prefix to apply to properties loaded using fileor resource. A "." is appended to the prefix if not specified</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="recorder"> - <DESCRIPTION><p>A recorder is a listener to the current build process that records the -output to a file.</p> -<p>Several recorders can exist at the same time. Each recorder is -associated with a file. The filename is used as a unique identifier for -the recorders. The first call to the recorder task with an unused filename -will create a recorder (using the parameters provided) and add it to the -listeners of the build. All subsequent calls to the recorder task using -this filename will modify that recorders state (recording or not) or other -properties (like logging level).</p> -<p>Some technical issues: the file's print stream is flushed for &quot;finished&quot; -events (buildFinished, targetFinished and taskFinished), and is closed on -a buildFinished event.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="name" REQUIRED="yes"> - <DESCRIPTION>The name of the file this logger is associated with</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="action" REQUIRED="no"> - <DESCRIPTION>This tells the logger what to do: should it startrecording or stop? The first time that the recorder task is called forthis logfile, and if this attribute is not provided, then the defaultfor this attribute is "start". If this attribute is not provided onsubsequent calls, then the state remains as previous.[Values = {start|stop}, Default = no state change</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no"> - <DESCRIPTION>Should the recorder append to a file, or create a newone? This is only applicable the first time this task is called forthis file. [Values = {yes|no}, Default=yes</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="emacsmode" REQUIRED="no, default is false"> - <DESCRIPTION>Removes [task] banners like Ant's-emacs command line switch if set totrue</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="loglevel" REQUIRED="no"> - <DESCRIPTION>At what logging level should this recorder instancerecord to? This is not a once only parameter (like appendis) -- you can increase or decrease the logging level as the build processcontinues. [Values= {error|warn|info|verbose|debug}, Default = no change]</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="rename"> - <DESCRIPTION><p>Renames a given file.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="src" REQUIRED="yes"> - <DESCRIPTION>file to rename</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>new name of the file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="replace" REQUIRED="no"> - <DESCRIPTION>Enable replacing of existing file (default: on)</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="replace"> - <DESCRIPTION><p>Replace is a directory based task for replacing the occurrence of a given string with another string -in selected file.</p> -<p>If you want to replace a text that crosses line boundaries, you -must use a nested <code>&lt;replacetoken&gt;</code> element.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="exactly one of the two."> - <DESCRIPTION>file for which the token should be replaced</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED=""> - <DESCRIPTION>The base directory to use when replacing a token in multiple files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no - defaults to default jvm encoding"> - <DESCRIPTION>The encoding of the files upon which replace operates</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="token" REQUIRED="yes, unless a nested - replacetoken element or the replacefilterfile - attribute is used."> - <DESCRIPTION>the token which must be replaced</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="value" REQUIRED="no"> - <DESCRIPTION>the new value for the token. When omitted, an empty string("") is used</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="summary" REQUIRED="no, by default no summary is produced"> - <DESCRIPTION>Indicates whether a summary of the replace operation should be produced, detailing how many token occurrences and files were processed</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="propertyfile" REQUIRED="yes only if property attribute of <replacefilter> is used."> - <DESCRIPTION>valid property file from which properties specified using nested <replacefilter> elements are drawn</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="replacefilterfile" REQUIRED="no."> - <DESCRIPTION>valid property file. Each property will betreated as a replacefilter where token is the name ofthe property and value is the properties value.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="rmic"> - <DESCRIPTION><p>Runs the rmic compiler for a certain class.</p> -<p>Rmic can be run on a single class (as specified with the classname -attribute) or a number of classes at once (all classes below base that -are neither _Stub nor _Skel classes). If you want to rmic a single -class and this class is a class nested into another class, you have to -specify the classname in the form <code>Outer$$Inner</code> instead of -<code>Outer.Inner</code>.</p> -<p>It is possible to refine the set of files that are being rmiced. This can be -done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> -attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns.</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>base</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -<p>It is possible to use different compilers. This can be selected -with the &quot;build.rmic&quot; property or the <code>compiler</code> -attribute. <a name="compilervalues">There are three choices</a>:</p> -<ul> -<li>sun (the standard compiler of the JDK)</li> -<li>kaffe (the standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li> -<li>weblogic</li> -</ul> -<p>The <a href="http://dione.zcu.cz/~toman40/miniRMI/">miniRMI</a> -project contains a compiler implementation for this task as well, -please consult miniRMI's documentation to learn how to use it.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="base" REQUIRED="yes"> - <DESCRIPTION>the location to store the compiled files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classname" REQUIRED="no"> - <DESCRIPTION>the class for which to run rmic</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtering" REQUIRED="no"> - <DESCRIPTION>indicates whether token filtering should take plac</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sourcebase" REQUIRED="no"> - <DESCRIPTION>Pass the "-keepgenerated" flag to rmic andmove the generated source file to the base directory</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="stubversion" REQUIRED="no"> - <DESCRIPTION>Specify the JDK version for the generated stub code.Specify "1.1" to pass the "-v1.1" option to rmic</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>The classpath to use during compilatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>The classpath to use during compilation, given as reference to a PATH defined elsewher</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verify" REQUIRED="no"> - <DESCRIPTION>check that classes implement Remote before handing them to rmic (default is false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="iiop" REQUIRED="no"> - <DESCRIPTION>indicates that portable (RMI/IIOP) stubs should be generate</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="iiopopts" REQUIRED="no"> - <DESCRIPTION>additional arguments for IIOP class generatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="idl" REQUIRED="no"> - <DESCRIPTION>indicates that IDL output files should be generate</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="idlopts" REQUIRED="no"> - <DESCRIPTION>additional arguments for IDL file generatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debug" REQUIRED="no"> - <DESCRIPTION>generate debug info (passes -g to rmic). Defaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includeantruntime" REQUIRED="no"> - <DESCRIPTION>whether to include the Ant run-time libraries;defaults to yes</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includejavaruntime" REQUIRED="no"> - <DESCRIPTION>whether to include the default run-timelibraries from the executing VM; defaults to no</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="extdirs" REQUIRED="no"> - <DESCRIPTION>location of installed extensions</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compiler" REQUIRED="no"> - <DESCRIPTION>The compiler implementation to use.If this attribute is not set, the value of thebuild.rmic property, if set, will be used.Otherwise, the default compiler for the current VM will be used.(See the above list of validcompilers.</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="sequential"> - <DESCRIPTION><p>Sequential is a container task - it can contain other Ant tasks. The nested -tasks are simply executed in sequence. Sequential's primary use is to support -the sequential execution of a subset of tasks within the -<a href="parallel.html">parallel</a> task</p> -<p>The sequential task has no attributes and does not support any nested -elements apart from Ant tasks. Any valid Ant task may be embedded within the -sequential task.</p> -<h3>Example</h3> -<pre> -&lt;parallel&gt; -&lt;wlrun ... &gt; -&lt;sequential&gt; -&lt;sleep seconds=&quot;30&quot;/&gt; -&lt;junit ... &gt; -&lt;wlstop/&gt; -&lt;/sequential&gt; -&lt;/parallel&gt; -</pre> -<p>This example shows how the sequential task is used to execute three tasks in -sequence, while another task is being executed in a separate thread. </p> -<hr> -<p align="center">Copyright &copy; 2001-2002 Apache Software Foundation. All rights -Reserved.</p> -</body> -</html> -</DESCRIPTION> </TASK> - <TASK NAME="signjar"> - <DESCRIPTION><p>Signs jar or zip files with the javasign command line tool. The -tool detailed dependency checking: files are only signed if they -are not signed. The <tt>signjar</tt> attribute can point to the file to -generate; if this file exists then -its modification date is used as a cue as to whether to resign any JAR file. -<br> -<strong>Note:</strong> Requires Java 1.2 or later. </p> -</DESCRIPTION> - <ATTRIBUTE NAME="jar" REQUIRED="yes."> - <DESCRIPTION>the jar file to sig</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="alias" REQUIRED="yes."> - <DESCRIPTION>the alias to sign unde</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="storepass" REQUIRED="yes."> - <DESCRIPTION>password for keystore integrity</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keystore" REQUIRED="no"> - <DESCRIPTION>keystore locatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="storetype" REQUIRED="no"> - <DESCRIPTION>keystore typ</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keypass" REQUIRED="no"> - <DESCRIPTION>password for private key (if different</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sigfile" REQUIRED="no"> - <DESCRIPTION>name of .SF/.DSA fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="signedjar" REQUIRED="no"> - <DESCRIPTION>name of signed JAR fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no; default false"> - <DESCRIPTION>(true | false) verbose output when signin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="internalsf" REQUIRED="no; default false"> - <DESCRIPTION>(true | false) include the .SF file inside the signaturebloc</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sectionsonly" REQUIRED="no; default false"> - <DESCRIPTION>(true | false) don't compute hash of entire manifes</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="lazy" REQUIRED="no; default false"> - <DESCRIPTION>flag to control whether the presence of a signaturefile means a JAR is signe</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="sleep"> - <DESCRIPTION><p> A task for sleeping a short period of time, useful when a build or deployment -process requires an interval between tasks.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="hours" REQUIRED="no"> - <DESCRIPTION>hours to to add to the sleep tim</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="minutes" REQUIRED="no"> - <DESCRIPTION>minutes to add to the sleep tim</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="seconds" REQUIRED="no"> - <DESCRIPTION>seconds to add to the sleep tim</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="milliseconds" REQUIRED="no"> - <DESCRIPTION>milliseconds to add to the sleep tim</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>flag controlling whether to break the build on an error. </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="sql"> - <DESCRIPTION><p>Executes a series of SQL statements via JDBC to a database. Statements can -either be read in from a text file using the <i>src</i> attribute or from -between the enclosing SQL tags.</p> -<p>Multiple statements can be provided, separated by semicolons (or the -defined <i>delimiter</i>). Individual lines within the statements can be -commented using either --, // or REM at the start of the line.</p> -<p>The <i>autocommit</i> attribute specifies whether auto-commit should be -turned on or off whilst executing the statements. If auto-commit is turned -on each statement will be executed and committed. If it is turned off the -statements will all be executed as one transaction.</p> -<p>The <i>onerror</i> attribute specifies how to proceed when an error occurs -during the execution of one of the statements. -The possible values are: <b>continue</b> execution, only show the error; -<b>stop</b> execution and commit transaction; -and <b>abort</b> execution and transaction and fail task.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="driver" REQUIRED="yes"> - <DESCRIPTION>Class name of the jdbc drive</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="url" REQUIRED="yes"> - <DESCRIPTION>Database connection ur</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="userid" REQUIRED="yes"> - <DESCRIPTION>Database user nam</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="password" REQUIRED="yes"> - <DESCRIPTION>Database passwor</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="src" REQUIRED="yes, unless statements enclosed within tags"> - <DESCRIPTION>File containing SQL statement</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no - defaults to default jvm encoding"> - <DESCRIPTION>The encoding of the files containing SQL statement</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="delimiter" REQUIRED="no, default ";""> - <DESCRIPTION>String that separates SQL statement</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="autocommit" REQUIRED="no, default "false""> - <DESCRIPTION>Auto commit flag for database connection (default false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="print" REQUIRED="no, default "false""> - <DESCRIPTION>Print result sets from the statements (default false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="showheaders" REQUIRED="no, default "true""> - <DESCRIPTION>Print headers for result sets from the statements (default true</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output" REQUIRED="no (print to system.out by default)"> - <DESCRIPTION>Output file for result sets (defaults to System.out</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="append" REQUIRED="no"> - <DESCRIPTION>whether output should be appended to or overwritean existing file. Defaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no (use system classpath)"> - <DESCRIPTION>Classpath used to load drive</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no (use system classpath)"> - <DESCRIPTION>The classpath to use, given as a reference to a path defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="onerror" REQUIRED="no, default "abort""> - <DESCRIPTION>Action to perform when statement fails: continue, stop, abor</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="rdbms" REQUIRED="no (no restriction)"> - <DESCRIPTION>Execute task only if this rdbm</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="version" REQUIRED="no (no restriction)"> - <DESCRIPTION>Execute task only if rdbms version matc</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="caching" REQUIRED="no (default=true)"> - <DESCRIPTION>Should the task cache loaders and the driver</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="tar"> - <DESCRIPTION><p>Creates a tar archive.</p> -<p>The <i>basedir</i> attribute is the reference directory from where to tar.</p> -<p>This task is a <a href="../dirtasks.html#directorybasedtasks">directory based task</a> -and, as such, forms an implicit <a href="../CoreTypes/fileset.html">Fileset</a>. This -defines which files, relative to the <i>basedir</i>, will be included in the -archive. The tar task supports all the attributes of Fileset to refine the -set of files to be included in the implicit fileset.</p> -<p>In addition to the implicit fileset, the tar task supports nested filesets. These -filesets are extended to allow control over the access mode, username and groupname -to be applied to the tar entries. This is useful, for example, when preparing archives for -Unix systems where some files need to have execute permission.</p> -<p>Early versions of tar did not support path lengths greater than 100 -characters. Modern versions of tar do so, but in incompatible ways. -The behaviour of the tar task when it encounters such paths is -controlled by the <i>longfile</i> attribute. -If the longfile attribute is set to <code>fail</code>, any long paths will -cause the tar task to fail. If the longfile attribute is set to -<code>truncate</code>, any long paths will be truncated to the 100 character -maximum length prior to adding to the archive. If the value of the longfile -attribute is set to <code>omit</code> then files containing long paths will be -omitted from the archive. Either option ensures that the archive can be -untarred by any compliant version of tar. If the loss of path or file -information is not acceptable, and it rarely is, longfile may be set to the -value <code>gnu</code>. The tar task will then produce a GNU tar file which -can have arbitrary length paths. Note however, that the resulting archive will -only be able to be untarred with GNU tar. The default for the longfile -attribute is <code>warn</code> which behaves just like the gnu option except -that it produces a warning for each file path encountered that does not match -the limit.</p> -<p>This task can perform compression by setting the compression attribute to "gzip" -or "bzip2".</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>the tar-file to create</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="basedir" REQUIRED="no"> - <DESCRIPTION>the directory from which to tar the files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="longfile" REQUIRED="no"> - <DESCRIPTION>Determines how long files (>100 chars) are to behandled. Allowable values are "truncate", "fail","warn", "omit" and "gnu". Default is"warn"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compression" REQUIRED="no"> - <DESCRIPTION>compression method. Allowable values are "none", "gzip" and "bzip2". Default is"none"</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="taskdef"> - <DESCRIPTION><p>Adds a task definition to the current project, such that this new task can be -used in the current project. Two attributes are needed, the name that identifies -this task uniquely, and the full name of the class (including the packages) that -implements this task.</p> -<p>You can also define a group of tasks at once using the file or -resource attributes. These attributes point to files in the format of -Java property files. Each line defines a single task in the -format:</p> -<pre> -taskname=fully.qualified.java.classname -</pre> -<p>Taskdef should be used to add your own tasks to the system. See also &quot;<a -href="../develop.html#writingowntask">Writing your own task</a>&quot;.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="name" REQUIRED="yes, unless file or resource have - been specified."> - <DESCRIPTION>the name of the tas</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classname" REQUIRED="yes, unless file or resource have - been specified."> - <DESCRIPTION>the full class name implementing the tas</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="file" REQUIRED="no"> - <DESCRIPTION>Name of the property file to loadtaskname/classname pairs from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="resource" REQUIRED="no"> - <DESCRIPTION>Name of the property resource to loadtaskname/classname pairs from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>the classpath touse when looking up classname orresource</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>Reference to a classpath touse when looking up classname orresource</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="loaderref" REQUIRED="no"> - <DESCRIPTION>the name of the loader that isused to load the class, constructed from the specified classpath. Use this toallow multiple tasks/types to be loaded with the same loader, so they can calleach other. ( introduced in ant1.5 </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="touch"> - <DESCRIPTION><p>Changes the modification time of a file and possibly creates it at -the same time. In addition to working with a single file, this Task -can also work a <a href="../CoreTypes/fileset.html">Fileset</a> (which -also includes directories).</p> -<p>For JDK 1.1 only the creation of new files with a modification time -of now works, all other cases will emit a warning.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="unless a nested fileset element - has been specified."> - <DESCRIPTION>the name of the fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="millis" REQUIRED="no"> - <DESCRIPTION>specifies the new modification time of the filein milliseconds since midnight Jan 1 197</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="datetime" REQUIRED="no"> - <DESCRIPTION>specifies the new modification time of the filein the format MM/DD/YYYY HH:MM AM_or_PM</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="tstamp"> - <DESCRIPTION><p>Sets the <code>DSTAMP</code>, <code>TSTAMP</code>, and <code>TODAY</code> -properties in the current project. By default, -the <code>DSTAMP</code> property is in the -format &quot;yyyyMMdd&quot;, <code>TSTAMP</code> is in the -format &quot;hhmm&quot;, and <code>TODAY</code> is in the -format &quot;MMMM dd yyyy&quot;. Use the nested &lt;format&gt; element -to specify a different format.</p> -<p>These properties can be used in the build-file, for instance, to create -time-stamped filenames, or used to replace placeholder tags inside documents -to indicate, for example, the release date. The best place for this task is -probably in an initialization target.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="prefix" REQUIRED="no"> - <DESCRIPTION>Prefix used for all properties set. The default is no prefix</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="typedef"> - <DESCRIPTION><p>Adds a data type definition to the current project, such that this -new type can be used in the current project. Two attributes are -needed, the name that identifies this data type uniquely, and the full -name of the class (including the packages) that implements this -type.</p> -<p>You can also define a group of data types at once using the file or -resource attributes. These attributes point to files in the format of -Java property files. Each line defines a single data type in the -format:</p> -<pre> -typename=fully.qualified.java.classname -</pre> -<p>Typedef should be used to add your own types to the system. Data -types are things like <a href="../using.html#path">paths</a> or <a -href="../CoreTypes/fileset.html">filesets</a> that can be defined at -the project level and referenced via their ID attribute.</p> -<p>Custom data types usually need custom tasks to put them to good use.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="name" REQUIRED="yes, unless file or resource have - been specified."> - <DESCRIPTION>the name of the data typ</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classname" REQUIRED="yes, unless file or resource have - been specified."> - <DESCRIPTION>the full class name implementing the data typ</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="file" REQUIRED="no"> - <DESCRIPTION>Name of the property file to loadtypename/classname pairs from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="resource" REQUIRED="no"> - <DESCRIPTION>Name of the property resource to loadtypename/classname pairs from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>the classpath touse when looking up classname</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="loaderref" REQUIRED="no"> - <DESCRIPTION>the name of the loader that isused to load the class, constructed from the specified classpath. Use this toallow multiple tasks/types to be loaded with the same loader, so they can calleach other. ( introduced in ant1.5 </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="unzip"> - <DESCRIPTION><p>Unzips a zip-, war-, tar- or jarfile.</p> -<p>For JDK 1.1 &quot;last modified time&quot; field is set to current time instead of being -carried from the archive file.</p> -<p><a href="../CoreTypes/patternset.html">PatternSet</a>s are used to select files to extract -<I>from</I> the archive. If no patternset is used, all files are extracted. -</p> -<p><a href="../CoreTypes/fileset.html">FileSet</a>s may be used used to select archived files -to perform unarchival upon. -</p> -<p>File permissions will not be restored on extracted files.</p> -<p>The untar task recognizes the long pathname entries used by GNU tar.<p> -</DESCRIPTION> - <ATTRIBUTE NAME="src" REQUIRED="yes, if filesets are not used."> - <DESCRIPTION>archive file to expand</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>directory where to store the expanded files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="overwrite" REQUIRED="no"> - <DESCRIPTION>Overwrite files, even if they are newer than thecorresponding entries in the archive (true or false, default istrue)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compression" REQUIRED="no"> - <DESCRIPTION>compression method for untar. Allowable values are"none", "gzip" and "bzip2". Default is"none"</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="uptodate"> - <DESCRIPTION><p>Sets a property if a target file or set of target files is more up-to-date -than a source file or set of source files. A single source file is specified -using the <code>srcfile</code> attribute. A set of source files is specified -using the nested <code>&lt;srcfiles&gt;</code> -elements. These are <a href="../CoreTypes/fileset.html">FileSet</a>s, -whereas multiple target files are specified using a nested -<a href="../CoreTypes/mapper.html"><code>&lt;mapper&gt;</code></a> element.</p> -<p>By default, the value of the property is set to <code>true</code> if -the timestamp of the target file(s) is more recent than the timestamp of -the corresponding source file(s). You can set the value to something other -than the default by specifying the <code>value</code> attribute.</p> -<p>If a <code>&lt;srcfiles&gt;</code> element is used, without also specifying -a <code>&lt;mapper&gt;</code> element, the default behavior is to use a -<a href="../CoreTypes/mapper.html#merge-mapper">merge mapper</a>, with the -<code>to</code> attribute set to the value of the -<code>targetfile</code> attribute.</p> -<p>Normally, this task is used to set properties that are useful to avoid -target execution depending on the relative age of the specified files.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of the property to set</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="value" REQUIRED="no; defaults to true."> - <DESCRIPTION>The value to set the property to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="srcfile" REQUIRED="yes, unless a nested - <srcfiles> element is present."> - <DESCRIPTION>The file to check against the target file(s)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="targetfile" REQUIRED="yes, unless a nested - <mapper> element is present."> - <DESCRIPTION>The file for which we want to determine the status</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="waitfor"> - <DESCRIPTION><p>Blocks execution until a set of specified conditions become true. This is intended -to be used with the <a href="parallel.html">parallel</a> task to -synchronize a set of processes.</p> -<p>The conditions to wait for are defined in <a href="waitfor.html#nested">nested elements</a>, -if multiple conditions are specified, then the task will wait until all conditions are true..</p> -<p></p> -<p>If both maxwait and maxwaitunit are not specified, the maxwait is 3 minutes (180000 milliseconds).</p> -<p>If the <code>timeoutproperty</code> attribute has been set, a -property of that name will be created if the condition didn't come -true within the specified time.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="maxwait" REQUIRED="no"> - <DESCRIPTION>The maximum amount of time to wait for all the required conditionsto become true before failing the task. Defaults to 180000 maxwaitunits</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxwaitunit" REQUIRED="no"> - <DESCRIPTION>The unit of time that must be used to interpret the value of themaxwait attribute. Defaults to millisecond.Valid Values aremillisecondsecondminutehourdayweek</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="checkevery" REQUIRED="no"> - <DESCRIPTION>The amount of time to wait between each test of the conditions.Defaults to 500 checkeveryunits</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="checkeveryunit" REQUIRED="no"> - <DESCRIPTION>The unit of time that must be used to interpret the value of thecheckevery attribute. Defaults to millisecond.Valid Values aremillisecondsecondminutehourdayweek</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeoutproperty" REQUIRED="no"> - <DESCRIPTION>the name of the property to set if maxwait hasbeen exceeded</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="war"> - <DESCRIPTION><p>An extension of the <a href="jar.html">Jar</a> task with special -treatment for files that should end up in the -<code>WEB-INF/lib</code>, <code>WEB-INF/classes</code> or -<code>WEB-INF</code> directories of the Web Application Archive.</p> -<p>(The War task is a shortcut for specifying the particular layout of a WAR file. -The same thing can be accomplished by using the <i>prefix</i> and <i>fullpath</i> -attributes of zipfilesets in a Zip or Jar task.)</p> -<p>The extended zipfileset element from the zip task (with attributes <i>prefix</i>, <i>fullpath</i>, and <i>src</i>) is available in the War task.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>the WAR file to create</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="warfile" REQUIRED="no"> - <DESCRIPTION>Deprecated name of the file to create-use destfile instead</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="webxml" REQUIRED="yes, unless update is set to true"> - <DESCRIPTION>The deployment descriptor to use (WEB-INF/web.xml)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="basedir" REQUIRED="no"> - <DESCRIPTION>the directory from which to jar the files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compress" REQUIRED="no"> - <DESCRIPTION>Not only store data but also compress them, defaults to tru</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>The character encoding to use for filenamesinside the archive. Defaults to UTF8. It is notrecommended to change this value as the created archive will mostlikely be unreadable for Java otherwise</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filesonly" REQUIRED="no"> - <DESCRIPTION>Store only file entries, defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="manifest" REQUIRED="no"> - <DESCRIPTION>the manifest file to use</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="update" REQUIRED="no"> - <DESCRIPTION>indicates whether to update or overwritethe destination file if it already exists</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="duplicate" REQUIRED="no"> - <DESCRIPTION>behavior when a duplicate file is found. Valid values are "add", "preserve", and "fail". The default value is "add". </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="xmlproperty"> - <DESCRIPTION><p> -Loads property values from a valid xml file. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="yes"> - <DESCRIPTION>The XML file to parse</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="prefix" REQUIRED="no"> - <DESCRIPTION>The prefix to prepend to each propert</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keeproot" REQUIRED="no, default is true."> - <DESCRIPTION>If false, it doesn't include the xml root tag as a firstvalue in the property name</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="validate" REQUIRED="no, default is false."> - <DESCRIPTION>If true, it enables validation</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="collapseattributes" REQUIRED="no, default is false."> - <DESCRIPTION>If true, it treats attributes as nested elements</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="xslt"> - <DESCRIPTION><p>Process a set of documents via XSLT.</p> -<p>This is useful for building views of XML based documentation, -or for generating code.</p> -<p><b>Note:</b> This task depends on external libraries not included in the Ant distribution. -See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> -<p>It is possible to refine the set of files that are being processed. This can be -done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> -attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns.</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and supports all -attributes of <code>&lt;fileset&gt;</code> (<code>dir</code> becomes <code>basedir</code>) -as well as the nested <code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> -and <code>&lt;patternset&gt;</code> elements.</p> -<p>This task supports the use of a nested &lt;param&gt; element which is used to pass values -to an &lt;xsl:param&gt; declaration.</p> -<p>This task supports the use of a nested <a href="../CoreTypes/xmlcatalog.html">xmlcatalog</a> -element which is used to perform Entity and URI resolution</p> -<p><i>&lt;style&gt; and &lt;xslt&gt; refer to the same Ant task and can be used interchangeably.</i></p> -<p>If you want to use Xalan-J 1 or XSL:P, you also need Ant's optional.jar</p> -</DESCRIPTION> - <ATTRIBUTE NAME="basedir" REQUIRED="no"> - <DESCRIPTION>where to find the source XML file, default is theproject's basedir</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED="yes, unless in and out have been - specified."> - <DESCRIPTION>directory in which to store the results</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="extension" REQUIRED="no"> - <DESCRIPTION>desired file extension to be used for the targets. If notspecified, the default is ".html"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="style" REQUIRED="yes"> - <DESCRIPTION>name of the stylesheet to use - given either relativeto the project's basedir or as an absolute pathDEPRECATED - can be specified as a path relativeto the basedir attribute of this task as well.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>the classpath to use when looking up the XSLTprocessor</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>the classpath to use, given as reference to a path defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="force" REQUIRED="no; default is false"> - <DESCRIPTION>Recreate target files, even if they are newerthan their corresponding source files or the stylesheet</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="processor" REQUIRED="no"> - <DESCRIPTION>name of the XSLT processor to use. Permissible values are"trax" for a TraX compliant processor (ie JAXP interfaceimplementation such as Xalan 2 or Saxon),"xslp" for the XSL:P processor, "xalan" forthe Apache XML Xalan (version 1) processor the name of anarbitrary XSLTLiaison class. Defaults to trax, followed by xalanand then xslp (in that order). The first one found in your classpath is the one that is used.DEPRECATED - XSL:P and xalan are deprecated and nomore supported..</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must be included.All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file is taken to bean include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must be excluded.No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file is taken to bean exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="in" REQUIRED="no"> - <DESCRIPTION>specifies a single XML document to be styled. Should be usedwith the out attribute</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="out" REQUIRED="no"> - <DESCRIPTION>specifies the output name for the styled result from thein attribute</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="scanincludeddirectories" REQUIRED="no"> - <DESCRIPTION>If any directories are matched by theincludes/excludes patterns, try to transform all files in thesedirectories. Default is tru</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="zip"> - <DESCRIPTION><p>Creates a zipfile.</p> -<p>The <i>basedir</i> attribute is the reference directory from where to zip.</p> -<p>Note that file permissions will not be stored in the resulting zipfile.</p> -<p>It is possible to refine the set of files that are being zipped. This can be -done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> -attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to -have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns. </p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>basedir</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -<p>Or, you may place within it nested file sets, or references to file sets. -In this case <code>basedir</code> is optional; the implicit file set is <i>only used</i> -if <code>basedir</code> is set. You may use any mixture of the implicit file set -(with <code>basedir</code> set, and optional attributes like <code>includes</code> -and optional subelements like <code>&lt;include&gt;</code>); explicit nested -<code>&lt;fileset&gt;</code> elements so long as at least one fileset total is specified. The ZIP file will -only reflect the relative paths of files <i>within</i> each fileset. The Zip task and its derivatives know a special form of a fileset named zipfileset that has additional attributes (described below). </p> -<p>The Zip task also supports the merging of multiple zip files into the zip file. -This is possible through either the <i>src</i> attribute of any nested filesets -or by using the special nested fileset <i>zipgroupfileset</i>.</p> -<p>The <code>update</code> parameter controls what happens if the -ZIP file already exists. When set to <code>yes</code>, the ZIP file is -updated with the files specified. (New files are added; old files are -replaced with the new versions.) When set to <code>no</code> (the -default) the ZIP file is overwritten.</p> -<p>The <code>whenempty</code> parameter controls what happens when no files match. -If <code>skip</code> (the default), the ZIP is not created and a warning is issued. -If <code>fail</code>, the ZIP is not created and the build is halted with an error. -If <code>create</code>, an empty ZIP file (explicitly zero entries) is created, -which should be recognized as such by compliant ZIP manipulation tools.</p> -<p>This task will now use the platform's default character encoding -for filenames - this is consistent with the command line ZIP tools, -but causes problems if you try to open them from within Java and your -filenames contain non US-ASCII characters. Use the encoding attribute -and set it to UTF8 to create zip files that can safely be read by -Java.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="yes"> - <DESCRIPTION>the zip-file to create</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="zipfile" REQUIRED="yes"> - <DESCRIPTION>the deprecated old name of destfile</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="basedir" REQUIRED="no"> - <DESCRIPTION>the directory from which to zip the files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compress" REQUIRED="no"> - <DESCRIPTION>Not only store data but also compress them, defaults to tru</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>The character encoding to use for filenamesinside the zip file. For a list of possible values see http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html.Defaults to the platform's default character encoding</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filesonly" REQUIRED="no"> - <DESCRIPTION>Store only file entries, defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="update" REQUIRED="no"> - <DESCRIPTION>indicates whether to update or overwritethe destination file if it already exists</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="whenempty" REQUIRED="no"> - <DESCRIPTION>behavior when no files match. Valid values are "fail", "skip", and "create". Default is "skip"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="duplicate" REQUIRED="no"> - <DESCRIPTION>behavior when a duplicate file is found. Valid values are "add", "preserve", and "fail". The default value is "add". </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="antlr"> - <DESCRIPTION><p> -Invokes the <a HREF="http://www.antlr.org/" target="_top">ANTLR</a> Translator generator -on a grammar file. -</p> -<p> -To use the ANTLR task, set the <i>target</i> attribute to the name of the -grammar file to process. Optionally, you can also set the -<i>outputdirectory</i> to write the generated file to a specific directory. -Otherwise ANTLR writes the generated files to the directory containing -the grammar file. -</p> -<p> -This task only invokes ANTLR if the grammar file is newer than the generated -files. -</p> -<p> -<i> -To successfully run ANTLR, your best option is probably to build the whole -jar with the provided script <b>mkalljar</b> and drop the resulting jar (about 300KB) -into ${ant.home}/lib. Dropping the default jar (70KB) is probably not enough -for most needs and your only option will be to add ANTLR home directory -to your classpath as described in ANTLR <tt>install.html</tt> document. -</i> -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="target" REQUIRED="yes"> - <DESCRIPTION>The grammar file to process</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="outputdirectory" REQUIRED="no"> - <DESCRIPTION>The directory to write the generated files to. If not set, the filesare written to the directory containing the grammar file.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="glib" REQUIRED="no"> - <DESCRIPTION>An optional super grammar file that the target grammar overrides. Thisfeature is only needed for advanced vocabularies.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debug" REQUIRED="no"> - <DESCRIPTION>When set to "yes", this flag adds code to the generated parser that willlaunch the ParseView debugger upon invocation. The default is "no".Note: ParseView is a separate component that needs to be installed or yourgrammar will have compilation errors.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="html" REQUIRED="no"> - <DESCRIPTION>Emit an html version of the grammar with hyperlinked actions.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="diagnostic" REQUIRED="no"> - <DESCRIPTION>Generates a text file with debugging infomation based on the target grammar.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="trace" REQUIRED="no"> - <DESCRIPTION>Forces all rules to call traceIn/traceOut if set to "yes".The default is "no".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="traceparser" REQUIRED="no"> - <DESCRIPTION>Only forces parser rules to call traceIn/traceOut if set to "yes".The default is "no".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tracelexer" REQUIRED="no"> - <DESCRIPTION>Only forces lexer rules to call traceIn/traceOut if set to "yes".The default is "no".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tracetreewalker" REQUIRED="no"> - <DESCRIPTION>Only forces tree walker rules to call traceIn/traceOut if set to"yes". The default is "no".</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>The directory to invoke the VM in.</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="borlandgenerateclient"> - <DESCRIPTION><p>The BorlandGenerateClient is a task dedicated to Borland Application Server -v 4.5. It offers to generate the client jar file corresponding to an ejb jar -file.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="ejbjar" REQUIRED="yes"> - <DESCRIPTION>ejb jar fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debug" REQUIRED="no"> - <DESCRIPTION>If true, turn on the debug mode for each borlandtools (java2iiop, iastool ...) default = fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="clientjar" REQUIRED="no"> - <DESCRIPTION>client jar file name. If missing the client jarfile name is build using the ejbjar file name: ejbjar = hellobean-ejb.jar=> hellobean-ejbclient.ja</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mode" REQUIRED="no"> - <DESCRIPTION>choose the command launching mode. Two values:java or fork. default = fork. java is not supported for version=5.Possibility to specify a classpath</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="version" REQUIRED="no, defaults to 4"> - <DESCRIPTION>set the Borland Application Version.4 means B.A.S (Borland Application Server 4.x)5 means B.E.S (Borland Application Server 5.x)</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="cab"> - <DESCRIPTION><p>The cab task creates Microsoft cab archive files. It is invoked -similar to the <a href="../CoreTasks/jar.html">jar</a> or <a href="../CoreTasks/zip.html">zip</a> tasks. -This task will work on Windows using the external cabarc tool (provided by Microsoft) -which must be located in your executable path.</p> -<p>To use this task on other platforms you need to download and compile libcabinet from -<a href="http://trill.cis.fordham.edu/~barbacha/cabinet_library/"> -http://trill.cis.fordham.edu/~barbacha/cabinet_library/</a>.</p> -<p>See the section on <a href="../dirtasks.html#directorybasedtasks">directory based -tasks</a>, on how the inclusion/exclusion of files works, and how to -write patterns.</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>basedir</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="cabfile" REQUIRED="yes"> - <DESCRIPTION>the name of the cab file to create</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="basedir" REQUIRED="yes"> - <DESCRIPTION>the directory to start archiving files from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>set to "yes" if you want to see the output fromthe cabarc tool. defaults to "no"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compress" REQUIRED="no"> - <DESCRIPTION>set to "no" to store files without compressing.defaults to "yes"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="options" REQUIRED="no"> - <DESCRIPTION>use to set additional command-line options forthe cabarc tool. should not normally be necessary</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files thatmust be included. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files thatmust be excluded. No files (except default excludes) are excludedwhen omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be usedor not ("yes"/"no"). Default excludes are used when omitted</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="depend"> - <DESCRIPTION><p> -The depend task works by determining which classes are out of date with -respect to their source and then removing the class files of any other -classes which depend on the out-of-date classes. -</p> -<p> To determine the class dependencies, the depend task analyses the class -files of all class files passed to it. Depend does not parse your source code in -any way but relies upon the class references encoded into the class files by the -compiler. This is generally faster than parsing the Java source.</p> -<p> -To learn more about how this information is obtained from the class files, -please refer to <a href="http://java.sun.com/docs/books/vmspec/">the Java -Virtual Machine Specification</a> -</p> -<p> Since a class' dependencies only change when the class itself changes, the -depend task is able to cache dependency information. Only those class files -which have changed will have their dependency information re-analysed. Note that -if you change a class' dependencies by changing the source, it will be -recompiled anyway. You can examine the dependency files created to understand -the dependencies of your classes. Please do not rely, however, on the format of -the information, as it may change in a later release. </p> -<p> Once depend discovers all of the class dependencies, it &quot;inverts&quot; -this relation to determine, for each class, which other classes are dependent -upon it. This &quot;affects&quot; list is used to discover which classes are -invalidated by the out of date class. The class files of the invalidated -classes are removed, triggering the compilation of the affected classes. </p> -<p> The depend task supports an attribute, &quot;closure&quot; which controls -whether depend will only consider direct class-class relationships or whether it -will also consider transitive, indirect relationships. For example, say there -are three classes, A, which depends on B, which in-turn depend on C. Now say -that class C is out of date. Without closure, only class B would be removed by -depend. With closure set, class A would also be removed. Normally direct -relationships are sufficient - it is unusual for a class to depend on another -without having a direct relationship. With closure set, you will notice that -depend typically removes far more class files. </p> -<p>The classpath attribute for <code>&lt;depend&gt;</code> is optional. If it is present, -depend will check class dependencies against classes and jars on this classpath. -Any classes which depend on an element from this classpath and which are older -than that element will be deleted. A typical example where you would use this -facility would be where you are building a utility jar and want to make sure -classes which are out of date with respect to this jar are rebuilt. You should -<b>not</b> include jars in this classpath which you do not expect to change, -such as the JDK runtime jar or third party jars, since doing so will just slow -down the dependency check. This means that if you do use a classpath for the -depend task it may be different from the classpath necessary to actually -compile your code.</p> -<h3>Performance</h3> -<p> The performance of the depend task is dependent on a -number of factors such as class relationship complexity and how many class files -are out of date. The decision about whether it is cheaper to just recompile all -classes or to use the depend task will depend on the size of your project and -how interrelated your classes are. </p> -<h3>Limitations</h3> -<p> There are some source dependencies which depend will not detect. </p> -<ul> -<li>If the Java compiler optimizes away a class relationship, -there can be a source dependency without a class dependency. </li> -<li>Non public classes cause two problems. Firstly depend cannot relate -the class file to a source file. In the future this may be addressed -using the source file attribute in the classfile. Secondly, neither -depend nor the compiler tasks can detect when a non public class is -missing. Inner classes are handled by the depend task.</li> -</ul> -The most obvious example of these limitations is that the task can't tell -which classes to recompile when a constant primitive data type exported -by other classes is changed. For example, a change in the definition of -something like -<pre> -public final class Constants { -public final static boolean DEBUG=false; -} -</pre> will not be picked up by other classes. -</DESCRIPTION> - <ATTRIBUTE NAME="srcdir" REQUIRED="yes"> - <DESCRIPTION>This is the directory where the source exists. dependwill examine this to determine which classes are out of date. If you use multiplesource directories you can pass this attribute a path of source directories</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED="no"> - <DESCRIPTION>This is the root directory of the class files whichwill be analysed. If this is not present, the srcdir is used</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cache" REQUIRED="no"> - <DESCRIPTION>This is a directory in which depend can store andretrieve dependency information. If this is not present, depend will notuse a cache</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="closure" REQUIRED="no"> - <DESCRIPTION>This attribute controls whether depend only removesclasses which directly depend on out of date classes. If this is set to true,depend will traverse the class dependency graph deleting all affectedclasses. Defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dump" REQUIRED="no"> - <DESCRIPTION>If true the dependency information will be written to the debug level log</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>The classpath containg jars and classes for which <depend> should alsocheck dependencie</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="echoproperties"> - <DESCRIPTION><p>Displays all the current properties in the project. The output can be -sent to a file if desired. You can also specify a subset of properties -to save by naming a prefix: only properties starting with this -prefix will be saved. This task can be used as a somewhat contrived -means of returning data from an <tt>&lt;ant&gt;</tt> invocation, -but is really for debugging buildfiles.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="no"> - <DESCRIPTION>If specified, the value indicates the name of thefile to send the output of the statement to. The generated output fileis compatible for loading by any Java application as a property file.If not specified, then the output will go to the Ant log</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="prefix" REQUIRED="no"> - <DESCRIPTION>a prefix which is used to filter the propertiesonly those properties starting with this prefix will be echoed.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>By default, the "failonerror" attribute is enabled.If an error occurs while writing the properties to a file, and thisattribute is enabled, then a BuildException will be thrown, causing thebuild to fail. If disabled, then IO errors will be reported as a logstatement, and the build will continue without failure from this task</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="ftp"> - <DESCRIPTION><p>The ftp task implements a basic FTP client that can send, receive, -list, delete files, and create directories. See below for descriptions and examples of how -to perform each task.</p> -<p><b>Note:</b> This task depends on external libraries not included in the Ant distribution. -See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> -<p>The ftp task makes no attempt to determine what file system syntax is -required by the remote server, and defaults to Unix standards. -<i>remotedir</i> must be specified in the exact syntax required by the ftp -server. If the usual Unix conventions are not supported by the server, -<i>separator</i> can be used to set the file separator that should be used -instead.</p> -<p>See the section on <a href="../dirtasks.html#directorybasedtasks">directory based -tasks</a>, on how the inclusion/exclusion of files works, and how to -write patterns.</p> -<p> -<b>Warning: </b> for the get and delete actions to work properly -with a Windows 2000 ftp server, it needs to be configured to generate -Unix style listings, and not the default MS-DOS listing. Or someone needs to write -the code to parse MS-DOS listings -any takers? -</DESCRIPTION> - <ATTRIBUTE NAME="server" REQUIRED="yes"> - <DESCRIPTION>the address of the remote ftp server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="port" REQUIRED="no"> - <DESCRIPTION>the port number of the remote ftp server.Defaults to port 21</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="userid" REQUIRED="yes"> - <DESCRIPTION>the login id to use on the ftp server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="password" REQUIRED="yes"> - <DESCRIPTION>the login password to use on the ftp server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="remotedir" REQUIRED="no"> - <DESCRIPTION>the directory to which to upload files on the ftp server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="action" REQUIRED="no"> - <DESCRIPTION>the ftp action to perform, defaulting to "send". Currently supports "put", "get","del", "list", "chmod" and "mkdir"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="binary" REQUIRED="no"> - <DESCRIPTION>selects binary-mode ("yes") or text-mode ("no") transfers. Defaults to "yes</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="passive" REQUIRED="no"> - <DESCRIPTION>selects passive-mode ("yes") transfers. Defaults to "no</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>displays information on each file transferred if set to "yes". Defaults to "no"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="depends" REQUIRED="no"> - <DESCRIPTION>transfers only new or changed files if set to "yes". Defaults to "no"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="newer" REQUIRED="no"> - <DESCRIPTION>a synonym for depends</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="separator" REQUIRED="no"> - <DESCRIPTION>sets the file separator used on the ftp server.Defaults to "/"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="umask" REQUIRED="no"> - <DESCRIPTION>sets the default file permissions for new files,unix only</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="chmod" REQUIRED="no"> - <DESCRIPTION>sets or changes file permissions for new or existing files,unix only. If used with a put action, chmod will be issued for each file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="listing" REQUIRED="no"> - <DESCRIPTION>the file to write results of the "list" action.Required for the "list" action, ignored otherwise</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ignorenoncriticalerrors" REQUIRED="no"> - <DESCRIPTION>flag which permits the task to ignore some non-fatal errorcodes sent by some servers during directory creation: wu-ftp in particular.Default: fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="skipfailedtransfers" REQUIRED="no"> - <DESCRIPTION>flag which enables unsuccessful file put, deleteand get operations to be skipped with a warning and theremainder of the files still transferred. Default: fals</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="icontract"> - <DESCRIPTION><P> -Instruments Java classes with <a href="http://www.reliable-systems.com/tools/">iContract</a> -DBC preprocessor.<br> -The task can generate a properties file for <a href="http://home.sol.no/~hellesoy/icplus.html">iControl</a>, -a graphical user interface that lets you turn on/off assertions. iControl generates a control file that you can refer to -from this task using the controlfile attribute. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="srcdir" REQUIRED="yes"> - <DESCRIPTION>Location of the java files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="instrumentdir" REQUIRED="yes"> - <DESCRIPTION>Indicates where the instrumented source files should go</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="repositorydir" REQUIRED="yes"> - <DESCRIPTION>Indicates where the repository source files should go</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="builddir" REQUIRED="no"> - <DESCRIPTION>Indicates where the compiled instrumented classes should go.Defaults to the value of instrumentdir.NOTE: Don't use the same directory for compiled instrumented classesand uninstrumented classes. It will break the dependency checking. (Classes willnot be reinstrumented if you change them)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="repositorybuilddir" REQUIRED="no"> - <DESCRIPTION>Indicates where the compiled repository classes should go.Defaults to the value of repositorydir</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="pre" REQUIRED="no"> - <DESCRIPTION>Indicates whether or not to instrument for preconditions.Defaults to true unless controlfile is specified, in which case itdefaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="post" REQUIRED="no"> - <DESCRIPTION>Indicates whether or not to instrument for postconditions.Defaults to true unless controlfile is specified, in which case itdefaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="invariant" REQUIRED="no"> - <DESCRIPTION>Indicates whether or not to instrument for invariants.Defaults to true unless controlfile is specified, in which case itdefaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failthrowable" REQUIRED="no"> - <DESCRIPTION>The full name of the Throwable (Exception) that should bethrown when an assertion is violated. Defaults to java.lang.Erro</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbosity" REQUIRED="no"> - <DESCRIPTION>Indicates the verbosity level of iContract. Any combinationof error*,warning*,note*,info*,progress*,debug* (comma separated) can beused. Defaults to error</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="quiet" REQUIRED="no"> - <DESCRIPTION>Indicates if iContract should be quiet. Turn it off if many your classes extend uninstrumented classesand you don't want warnings about this. Defaults to fals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="updateicontrol" REQUIRED="no"> - <DESCRIPTION>If set to true, it indicates that the properties file foriControl in the current directory should be updated (or created if it doesn't exist).Defaults to false</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="controlfile" REQUIRED="only if updateicontrol=true"> - <DESCRIPTION>The name of the control file to pass to iContract. Consider using iControl to generate the file.Default is not to pass a file.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classdir" REQUIRED="only if updateicontrol=true"> - <DESCRIPTION>Indicates where compiled (unistrumented) classes are located.This is required in order to properly update the icontrol.properties file, notfor instrumentation</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="targets" REQUIRED="no"> - <DESCRIPTION>Name of the file that will be generated by this task, which lists all theclasses that iContract will instrument. If specified, the file will not be deleted after execution.If not specified, a file will still be created, but it will be deleted after execution</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jarlib-available"> - <DESCRIPTION><p>Check whether an extension is present in a fileset or an extensionSet. -If the extension is present then a property is set.</p> -<p>Note that this task -works with extensions as defined by the "Optional Package" specification. -For more information about optional packages, see the document -<em>Optional Package Versioning</em> in the documentation bundle for your -Java2 Standard Edition package, in file -<code>guide/extensions/versioning.html</code> or online at -<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> -http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> -<p>See the Extension and ExtensionSet documentation for further details</p> -</DESCRIPTION> - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of property to set if extensions is available</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="file" REQUIRED="no, one of file, nested - extensionset or nested fileset must be present."> - <DESCRIPTION>The file to check for extensio</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jarlib-display"> - <DESCRIPTION><p>Display the "Optional Package" and "Package Specification" information -contained within the specified jars.</p> -<p>Note that this task -works with extensions as defined by the "Optional Package" specification. -For more information about optional packages, see the document -<em>Optional Package Versioning</em> in the documentation bundle for your -Java2 Standard Edition package, in file -<code>guide/extensions/versioning.html</code> or online at -<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> -http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> -<p>See the Extension and ExtensionSet documentation for further details</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="no, but one of file or fileset must be - present."> - <DESCRIPTION>The file to display extension information about</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jarlib-manifest"> - <DESCRIPTION><p>Task to generate a manifest that declares all the dependencies -in manifest. The dependencies are determined by looking in the -specified path and searching for Extension / "Optional Package" -specifications in the manifests of the jars.</p> -<p>Note that this task -works with extensions as defined by the "Optional Package" specification. -For more information about optional packages, see the document -<em>Optional Package Versioning</em> in the documentation bundle for your -Java2 Standard Edition package, in file -<code>guide/extensions/versioning.html</code> or online at -<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> -http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> -<p>See the Extension and ExtensionSet documentation for further details</p> -</DESCRIPTION> - <ATTRIBUTE NAME="destfile" REQUIRED="yes."> - <DESCRIPTION>The file to generate Manifest int</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jarlib-resolve"> - <DESCRIPTION><p>Try to locate a jar to satisfy an extension and place -location of jar into property. The task allows you to -add a number of resolvers that are capable of locating a -library for a specifc extension. Each resolver will be attempted -in specified order until library is found or no resolvers are left. -If no resolvers are left and failOnError is true then a BuildException -will be thrown.</p> -<p>Note that this task -works with extensions as defined by the "Optional Package" specification. -For more information about optional packages, see the document -<em>Optional Package Versioning</em> in the documentation bundle for your -Java2 Standard Edition package, in file -<code>guide/extensions/versioning.html</code> or online at -<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> -http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> -<p>See the Extension and ExtensionSet documentation for further details</p> -</DESCRIPTION> - <ATTRIBUTE NAME="property" REQUIRED="yes"> - <DESCRIPTION>The name of property to set to library location</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no, defaults to true."> - <DESCRIPTION>True if failure to locate library should result in build exception</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="checkextension" REQUIRED="no, defaults to true."> - <DESCRIPTION>True if librarys returned by nested resolvers should be checked to see ifthey supply extension</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="javacc"> - <DESCRIPTION><p> -Invokes the <a HREF="http://www.webgain.com/products/java_cc/" target="_top">JavaCC</a> compiler -compiler on a grammar file. -</p> -<p> -To use the javacc task, set the <i>target</i> attribute to the name of the -grammar file to process. You also need to specify the directory containing -the JavaCC installation using the <i>javacchome</i> attribute, so that ant -can find the JavaCC classes. Optionally, you can also set the -<i>outputdirectory</i> to write the generated file to a specific directory. -Otherwise javacc writes the generated files to the directory containing -the grammar file. -</p> -<p> -This task only invokes JavaCC if the grammar file is newer than the generated -Java files. javacc assumes that the Java class name of the generated parser -is the same as the name of the grammar file, ignoring the .jj. -If this is not the case, the javacc task will still work, but it will always -generate the output files. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="target" REQUIRED="yes"> - <DESCRIPTION>The grammar file to process</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="javacchome" REQUIRED="yes"> - <DESCRIPTION>The directory containing the JavaCC distribution</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="outputdirectory" REQUIRED="no"> - <DESCRIPTION>The directory to write the generated files to. If not set, the filesare written to the directory containing the grammar file.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="buildparser" REQUIRED="no"> - <DESCRIPTION>Sets the BUILD_PARSER grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="buildtokenmanager" REQUIRED="no"> - <DESCRIPTION>Sets the BUILD_TOKEN_MANAGER grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cachetokens" REQUIRED="no"> - <DESCRIPTION>Sets the CACHE_TOKENS grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="choiceambiguitycheck" REQUIRED="no"> - <DESCRIPTION>Sets the CHOICE_AMBIGUITY_CHECK grammar option. This is an integer option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="commontokenaction" REQUIRED="no"> - <DESCRIPTION>Sets the COMMON_TOKEN_ACTION grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debuglookahead" REQUIRED="no"> - <DESCRIPTION>Sets the DEBUG_LOOKAHEAD grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debugparser" REQUIRED="no"> - <DESCRIPTION>Sets the DEBUG_PARSER grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debugtokenmanager" REQUIRED="no"> - <DESCRIPTION>Sets the DEBUG_TOKEN_MANAGER grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="errorreporting" REQUIRED="no"> - <DESCRIPTION>Sets the ERROR_REPORTING grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="forcelacheck" REQUIRED="no"> - <DESCRIPTION>Sets the FORCE_LA_CHECK grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ignorecase" REQUIRED="no"> - <DESCRIPTION>Sets the IGNORE_CASE grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="javaunicodeescape" REQUIRED="no"> - <DESCRIPTION>Sets the JAVA_UNICODE_ESCAPE grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="lookahead" REQUIRED="no"> - <DESCRIPTION>Sets the LOOKAHEAD grammar option. This is an integer option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="optimizetokenmanager" REQUIRED="no"> - <DESCRIPTION>Sets the OPTIMIZE_TOKEN_MANAGER grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="otherambiguitycheck" REQUIRED="no"> - <DESCRIPTION>Sets the OTHER_AMBIGUITY_CHECK grammar option. This is an integer option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sanitycheck" REQUIRED="no"> - <DESCRIPTION>Sets the SANITY_CHECK grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="static" REQUIRED="no"> - <DESCRIPTION>Sets the STATIC grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="unicodeinput" REQUIRED="no"> - <DESCRIPTION>Sets the UNICODE_INPUT grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="usercharstream" REQUIRED="no"> - <DESCRIPTION>Sets the USER_CHAR_STREAM grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="usertokenmanager" REQUIRED="no"> - <DESCRIPTION>Sets the USER_TOKEN_MANAGER grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="javah"> - <DESCRIPTION><p>Generates JNI headers from a Java class.</p> -<p> When this task executes, it will generate the C header and source files that -are needed to implement native methods. JNI operates differently depending on -whether <a href="http://java.sun.com/j2se/1.3/docs/tooldocs/win32/javah.html">JDK1.2</a> -(or later) or <a href="http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/javah.html">pre-JDK1.2</a> -systems are used.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="class" REQUIRED="yes"> - <DESCRIPTION>the fully-qualified name of the class (or classes,separated by commas</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="outputfile" REQUIRED="yes"> - <DESCRIPTION>concatenates the resulting header or source files for all the classes listed into this fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED=""> - <DESCRIPTION>sets the directory where javah saves the header files or thestub files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="force" REQUIRED="no"> - <DESCRIPTION>specifies that output files should always be written (JDK1.2 only</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="old" REQUIRED="no"> - <DESCRIPTION>specifies that old JDK1.0-style header files should be generated(otherwise output file contain JNI-style native method function prototypes) (JDK1.2 only</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="stubs" REQUIRED="no"> - <DESCRIPTION>generate C declarations from the Java object file (used with old</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>causes Javah to print a message concerning the status of the generated file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>the classpath to use</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bootclasspath" REQUIRED="no"> - <DESCRIPTION>location of bootstrap class files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="extdirs" REQUIRED="no"> - <DESCRIPTION>location of installed extensions</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jdepend"> - <DESCRIPTION><P>Invokes the <a href="http://www.clarkware.com/software/JDepend.html">JDepend</a> parser.</P> -<P>This parser &quot;traverses a set of Java source file directories and generates design quality metrics for each Java package&quot;. -It allows to &quot;automatically measure the quality of a design in terms of its extensibility, reusability, and maintainability to -effectively manage and control package dependencies.&quot;</P> -<p>Source file directories are defined by nested <code>&lt;sourcespath&gt;</code>, see <a href="#nested">nested elements</a>.</p> -<p>Optionally, you can also set the <code>outputfile</code> name where the output is stored. By default the task writes its report to the standard output.</P> -<p> The task requires at least the JDepend 1.2 version. </p> -<P>Note: whereas the JDepend tool can be customized to exclude some packages, the current jdepend And Task does not have parameters to allow these exclusions. Read JDepend specific documentation for that purpose.</P> -</DESCRIPTION> - <ATTRIBUTE NAME="outputfile" REQUIRED="no"> - <DESCRIPTION>The output file name. If not set, the output is printed on the standard output</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="format" REQUIRED="no"> - <DESCRIPTION>The format to write the output in. The default is "text", the alternative is "xml</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fork" REQUIRED="no, default is "off""> - <DESCRIPTION>Run the tests in a separate VM</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="haltonerror" REQUIRED="no, default is "off""> - <DESCRIPTION>Stop the build process if an error occurs during the jdepend analysis</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeout" REQUIRED="no"> - <DESCRIPTION>Cancel the operation if it doesn't finish in the given time (measured in milliseconds). (Ignored if fork is disabled.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="jvm" REQUIRED="no, default "java""> - <DESCRIPTION>The command used to invoke the Java Virtual Machine, default is 'java'. The command is resolved by java.lang.Runtime.exec(). (Ignored if fork is disabled.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>The directory to invoke the VM in. (Ignored if fork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>the classpath to use, given as reference to a PATH defined elsewhere</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jjtree"> - <DESCRIPTION>Invokes the <a href="http://www.webgain.com/products/java_cc/">JJTree</a> preprocessor -for the JavaCC compiler compiler. It inserts parse tree building actions -at various places in the JavaCC source that it generates. The output of -JJTree is run through JavaCC to create the parser. -<p>To use the jjtree task, set the <i>target</i> attribute to the name -of the jjtree grammar file to process. You also need to specify the directory -containing the JavaCC installation using the <i>javacchome</i> attribute, -so that ant can find the JavaCC classes. Optionally, you can also set the -<i>outputdirectory</i> -to write the generated file to a specific directory. Otherwise jjtree writes -the generated JavaCC grammar file to the directory containing the JJTree -grammar file.</p> -<p>This task only invokes JJTree if the grammar file is newer than the -generated JavaCC file.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="target" REQUIRED="yes"> - <DESCRIPTION>The jjtree grammar file to process</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="javacchome" REQUIRED="yes"> - <DESCRIPTION>The directory containing the JavaCC distribution</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="outputdirectory" REQUIRED="no"> - <DESCRIPTION>The directory to write the generated file to. If not set,the files are written to the directory containing the grammar file.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="buildnodefiles" REQUIRED="no"> - <DESCRIPTION>Sets the BUILD_NODE_FILES grammar option. This is a booleanoption</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="multi" REQUIRED="no"> - <DESCRIPTION>Sets the MULTI grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodedefaultvoid" REQUIRED="no"> - <DESCRIPTION>Sets the NODE_DEFAULT_VOID grammar option. This is a booleanoption</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodefactory" REQUIRED="no"> - <DESCRIPTION>Sets the NODE_FACTORY grammar option. This is boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodescopehook" REQUIRED="no"> - <DESCRIPTION>Sets the NODE_SCOPE_HOOK grammar option. This is a booleanoption</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodeusesparser" REQUIRED="no"> - <DESCRIPTION>Sets the NODE_USES_PARSER grammar option. This is a booleanoption</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="static" REQUIRED="no"> - <DESCRIPTION>Sets the STATIC grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="visitor" REQUIRED="no"> - <DESCRIPTION>Sets the VISITOR grammar option. This is a boolean option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodepackage" REQUIRED="no"> - <DESCRIPTION>Sets the NODE_PACKAGE grammar option. This is a string option</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="visitorexception" REQUIRED="no"> - <DESCRIPTION>Sets the VISITOR_EXCEPTION grammar option. This is a stringoption</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="nodeprefix" REQUIRED="no"> - <DESCRIPTION>Sets the NODE_PREFIX grammar option. This is a string option</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jlink"> - <DESCRIPTION><p>Links entries from sub-builds and libraries.</p> -<p>The jlink task can be used to build jar and zip files, similar to -the <i>jar</i> task. -However, jlink provides options for controlling the way entries from -input files -are added to the output file. Specifically, capabilities for merging -entries from -multiple zip or jar files is available.</p> -<p>If a mergefile is specified directly (eg. at the top level of a -<i>mergefiles</i> -pathelement) <i>and</i> the mergefile ends in &quot;.zip&quot; or -&quot;.jar&quot;, -entries in the mergefile will be merged into the outfile. A file with -any other extension -will be added to the output file, even if it is specified in the -mergefiles element. -Directories specified in either the mergefiles or addfiles element -are added to the -output file as you would expect: all files in subdirectories are -recursively added to -the output file with appropriate prefixes in the output file -(without merging). -</p> -<p> -In the case where duplicate entries and/or files are found among the -files to be merged or -added, jlink merges or adds the first entry and ignores all subsequent entries. -</p> -<p> -jlink ignores META-INF directories in mergefiles. Users should supply their -own manifest information for the output file. -</p> -<p>It is possible to refine the set of files that are being jlinked. -This can be -done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, -<i>excludesfile</i>, -and <i>defaultexcludes</i> attributes on the <i>addfiles</i> and -<i>mergefiles</i> -nested elements. With the <i>includes</i> or <i>includesfile</i> -attribute you specify the files you want to have included by using patterns. -The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify -the files you want to have excluded. This is also done with patterns. And -finally with the <i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns. The patterns are -relative to the <i>base</i> directory.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="outfile" REQUIRED="yes"> - <DESCRIPTION>the path of the output file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compress" REQUIRED="no"> - <DESCRIPTION>whether or not the output should be compressed. true,yes, or on result in compressed output.If omitted, output will be uncompressed (inflated)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mergefiles" REQUIRED="at least one of - mergefiles or addfiles"> - <DESCRIPTION>files to be merged into the output, if possible</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="addfiles" REQUIRED=""> - <DESCRIPTION>files to be added to the output</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="jspc"> - <DESCRIPTION><p> Ant task to run the JSP compiler and turn JSP pages into Java source. -<p> -It can be used to precompile JSP pages for fast initial invocation -of JSP pages, deployment on a server without the full JDK installed, -or simply to syntax check the pages without deploying them. -In most cases, a javac task is usually the next stage in the build process. -The task does basic dependency checking to prevent unnecessary recompilation -this -checking compares source and destination timestamps, and does not factor -in class or taglib dependencies, or &lt;jsp:include&gt; references. -<p> -By default the task uses the Jasper JSP compiler. This -means the task needs jasper.jar and jasper-runtime.jar, which come with -builds of Tomcat 4/Catalina from the -<a href="http://jakarta.apache.org/tomcat/">Jakarta Tomcat project</a> -</DESCRIPTION> - <ATTRIBUTE NAME="destdir" REQUIRED="yes"> - <DESCRIPTION>Where to place the generated files. They are locatedunder here according to the given package name</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="srcdir" REQUIRED="yes"> - <DESCRIPTION>Where to look for source jsp files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>The verbosity integer to pass to the compiler. Default="0</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="package" REQUIRED="no"> - <DESCRIPTION>Name of the destination package for generated javaclasses</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compiler" REQUIRED="no"> - <DESCRIPTION>class name of a JSP compiler adapte</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ieplugin" REQUIRED="no"> - <DESCRIPTION>Java Plugin classid for Internet Explorer</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mapped" REQUIRED="no"> - <DESCRIPTION>(boolean) Generate separate write() calls for each HTMLline in the JSP</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>The classpath to use to run the jsp compiler.This can also be specifiedby the nested element classpathPath)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>A Reference. Asper classpat</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>flag to control action on compile failures: default=ye</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="uribase" REQUIRED="no"> - <DESCRIPTION>The uri context of relative URIreferences in the JSP pages. If it does notexist then it is derived from the location of the filerelative to the declared or derived value of uriroot.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="uriroot" REQUIRED="no"> - <DESCRIPTION>The root directory that uri files should be resolvedagainst.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compiler" REQUIRED="no"> - <DESCRIPTION>Class name of jsp compiler adapter to use. Defaults tothe standard adapter for Jasper.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compilerclasspath" REQUIRED="no"> - <DESCRIPTION>The classpath used to find the compiler adapter specifiedby the compiler attribute</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="junit"> - <DESCRIPTION><p>This task runs tests from the JUnit testing framework. The latest -version of the framework can be found at -<a href="http://www.junit.org">http://www.junit.org</a>. -This task has been tested with JUnit 3.0 up to JUnit 3.8.1; it won't -work with versions prior to JUnit 3.0.</p> -<p><strong>Note:</strong> This task depends on external libraries not included -in the Ant distribution. See <a href="../install.html#librarydependencies"> -Library Dependencies</a> for more information. -</p> -<p> -<strong>Note</strong>: -You must have <code>junit.jar</code> and the class files for the -<code>&lt;junit&gt;</code> task in the same classpath. -You can do one of: -<ol> -<li> -Put both <code>junit.jar</code> and the optional tasks jar file in -<code>ANT_HOME/lib</code>. -</li> -<li> -Do not put either in <code>ANT_HOME/lib</code>, and instead -include their locations in your <code>CLASSPATH</code> environment variable. -</li> -<li> -Do neither of the above, and instead, specify their locations using -a <code>&lt;classpath&gt;</code> element in the buildfile. -See <a href="../../faq.html#delegating-classloader" target="_top">the -FAQ</a> for details. -</ol> -</p> -<p>Tests are defined by nested <code>test</code> or -<code>batchtest</code> tags (see <a href="#nested">nested -elements</a>).</p> -</DESCRIPTION> - <ATTRIBUTE NAME="printsummary" REQUIRED="no; default is off."> - <DESCRIPTION>Print one-line statistics for each testcase. Cantake the values on,off, andwithOutAndErr.withOutAndErr is the sameas on but also includes the output of the testas written to System.out and System.err</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fork" REQUIRED="no; default is off."> - <DESCRIPTION>Run the tests in a separate VM</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="haltonerror" REQUIRED="no; default is off."> - <DESCRIPTION>Stop the build process if an error occurs during the testrun</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="errorproperty" REQUIRED="no"> - <DESCRIPTION>The name of a property to set in the event of an error</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="haltonfailure" REQUIRED="no; default is off."> - <DESCRIPTION>Stop the build process if a test fails (errors areconsidered failures as well)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failureproperty" REQUIRED="no."> - <DESCRIPTION>The name of a property to set in the event of a failure(errors are considered failures as well)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filtertrace" REQUIRED="no; default is on."> - <DESCRIPTION>Filter out Junit and Ant stack frames from error and failure stack traces</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeout" REQUIRED="no"> - <DESCRIPTION>Cancel the individual tests if they don't finishin the given time (measured in milliseconds). Ignored iffork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxmemory" REQUIRED="no"> - <DESCRIPTION>Maximum amount of memory to allocate to the forked VM.Ignored if fork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="jvm" REQUIRED="no; default is java."> - <DESCRIPTION>The command used to invoke the Java Virtual Machine,default is 'java'. The command is resolved byjava.lang.Runtime.exec().Ignored if fork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dir" REQUIRED="no"> - <DESCRIPTION>The directory in which to invoke the VM. Ignored iffork is disabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="newenvironment" REQUIRED="no; default is false."> - <DESCRIPTION>Do not propagate the old environment when newenvironment variables are specified. Ignored if fork isdisabled</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includeantruntime" REQUIRED="no; default is true."> - <DESCRIPTION>Implicitly add the Ant classes required to runthe tests and JUnit to the classpath in forked mode</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="showoutput" REQUIRED="no"> - <DESCRIPTION>Send any output generated by tests to Ant'slogging system as well as to the formatters. By default only theformatters receive the output</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="maudit"> - <DESCRIPTION><p> -Invokes the Metamata Audit/ Webgain Quality Analyzer on a set of Java files. -</p> -<p> -<i>maudit</i> performs static analysis of the Java source code and byte code files to find and report -errors of style and potential problems related to performance, maintenance and robustness. -. As a convenience, a stylesheet is given in <tt>etc</tt> directory, so that an HTML report can be generated from the XML file. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="tofile" REQUIRED="yes"> - <DESCRIPTION>The XML file to which the Audit result should be written to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="metamatahome" REQUIRED="yes"> - <DESCRIPTION>The home directory containing the Metamata distribution</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fix" REQUIRED="no.default to false."> - <DESCRIPTION>Automatically fix certain errors (those marked as fixable in the manual).</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="list" REQUIRED="no. default to false."> - <DESCRIPTION>Creates listing file for each audited file. A .maudit file will be generated in thesame location as the source file.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="unused" REQUIRED="no. default to false."> - <DESCRIPTION>Finds declarations unused in search paths. It will look for unused global declarationsin the source code within a use domain specified by the searchpath element.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxmemory" REQUIRED="no"> - <DESCRIPTION>Set the maximum memory for the JVM. this is a convenientway to set the -mx or -Xmx argument</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="mimemail"> - <DESCRIPTION><p>Sends SMTP mail with MIME attachments. -<a href="http://java.sun.com/products/javamail/index.html">JavaMail</a> -and <a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">Java -Activation Framework</a> are required for this task.</p> -<p>Multiple files can be attached using <a href="../CoreTypes/fileset.html">FileSets.</a></p> -</DESCRIPTION> - <ATTRIBUTE NAME="message" REQUIRED="no, but only one of of 'message' or - 'messagefile' may be specified. if not specified, a fileset must be - provided."> - <DESCRIPTION>The message bod</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="messagefile" REQUIRED=""> - <DESCRIPTION>A filename to read and used as the message bod</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="messagemimetype" REQUIRED="no, defaults to "text/plain""> - <DESCRIPTION>MIME type to use for 'message' or 'messageFile' whenattached</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tolist" REQUIRED="yes, at least one of 'tolist', 'cclist', - or 'bcclist' must be specified."> - <DESCRIPTION>Comma-separated list of To: recipient</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cclist" REQUIRED=""> - <DESCRIPTION>Comma-separated list of CC: recipient</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bcclist" REQUIRED=""> - <DESCRIPTION>Comma-separated list of BCC: recipient</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="mailhost" REQUIRED="no, default to "localhost""> - <DESCRIPTION>Host name of the mail server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="subject" REQUIRED="no"> - <DESCRIPTION>Email subject line</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="from" REQUIRED="yes"> - <DESCRIPTION>Email address of sender</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no, default to "true""> - <DESCRIPTION>Stop the build process if an error occurs sending thee-mail</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="mmetrics"> - <DESCRIPTION><p> -Invokes the Metamata Metrics / WebGain Quality Analyzer source code -analyzer on a set of Java files. -</p> -<p> -<i>mmetrics</i> will compute the metrics of a set of Java files and write the results to an XML -file. As a convenience, a stylesheet is given in <tt>etc</tt> directory, so that an HTML report can be generated from the XML file. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="metamatahome" REQUIRED="yes"> - <DESCRIPTION>The home directory containing the Metamata distribution</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="tofile" REQUIRED="yes"> - <DESCRIPTION>The XML were the resulting metrics will be written to</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="granularity" REQUIRED="yes"> - <DESCRIPTION>Metrics granularity of the source files. Must be eitherfiles (compilation-units), types (types and compilation-units) or methods(methods, types and compilation-units).</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxmemory" REQUIRED="no"> - <DESCRIPTION>Set the maximum memory for the JVM. this is a convenientway to set the -mx or -Xmx argument</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="mparse"> - <DESCRIPTION><p> -Invokes the Metamata <a HREF="http://www.metamata.com/parse.html">MParse</a> compiler -compiler on a grammar file. -</p> -<p> -To use the <i>mparse</i> task, set the <i>target</i> attribute to the name of the -grammar file to process. You also need to specify the directory containing -the Metamata installation using the <i>metamatahome</i> attribute, so that Ant -can find the MParse classes. -</p> -<p> -This task only invokes MParse if the grammar file is newer than the generated -Java files. MParse assumes that the Java class name of the generated parser -is the same as the name of the grammar file, less the .jj extension. -</p> -<p>For additional information about MParse, please consult the online manual available <a href="http://download.metamata.com/parse.pdf">here</a> -(PDF) -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="target" REQUIRED="yes"> - <DESCRIPTION>The .jj grammar file to process. It will only be processedif the grammar is newer than the corresponding .java file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="metamatahome" REQUIRED="yes"> - <DESCRIPTION>The home directory containing the Metamata distribution</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>Enable all messages</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debugparser" REQUIRED="no"> - <DESCRIPTION>Enables parser debugging</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="debugscanner" REQUIRED="no"> - <DESCRIPTION>Enables scanner debugging</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cleanup" REQUIRED="no. default to false"> - <DESCRIPTION>Remove the intermediate SunJavaCC file created during the transformation of the grammar file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="maxmemory" REQUIRED="no"> - <DESCRIPTION>Set the maximum memory for the JVM. this is a convenientway to set the -mx or -Xmx argument</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="native2ascii"> - <DESCRIPTION><p> -Converts files from native encodings to ASCII with escaped Unicode. -A common usage is to convert source files maintained in a native -operating system encoding, to ASCII prior to compilation. -</p> -<p> -Files in the directory <em>src</em> -are converted from a native encoding to ASCII. -By default, all files in the directory are converted. -However, conversion may be limited to selected files using -<em>includes</em> and <em>excludes</em> attributes. -For more information on file matching patterns, -see the section on -<a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>. -If no <em>encoding</em> is specified, -the default encoding for the JVM is used. -If <em>ext</em> is specified, then output files are renamed -to use it as a new extension. -More sophisticated file name translations can be achieved using a nested -<em>&lt;mapper&gt;</em> element. By default an -<a href="../CoreTypes/mapper.html#identity-mapper">identity mapper</a> will be used. -If <em>dest</em> and <em>src</em> point to the same directory, -the <em>ext</em> attribute or a nested <em>&lt;mapper&gt;</em> -is required. -</p> -<p> -This task forms an implicit <a href="../CoreTypes/fileset.html">File Set</a>, -and supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>src</code>) as well as -nested <code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code>, -and <code>&lt;patternset&gt;</code> elements. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="reverse" REQUIRED="no"> - <DESCRIPTION>Reverse the sense of the conversion,i.e. convert from ASCII to nativ</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="encoding" REQUIRED="no"> - <DESCRIPTION>The native encoding the files are in(default is the default encoding for the JVM</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="src" REQUIRED="no"> - <DESCRIPTION>The directory to find files in (default is basedir</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>The directory to output file t</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ext" REQUIRED="no"> - <DESCRIPTION>File extension to use in renaming output file</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no").Default excludes are used when omitted.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must be excluded.No files (except default excludes) are excluded when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="netrexxc"> - <DESCRIPTION><p>Compiles a <a href="http://www2.hursley.ibm.com/netrexx" target="_top">NetRexx</a> -source tree within the running (Ant) VM.</p> -<p>The source and destination directory will be recursively scanned for -NetRexx source files to compile. Only NetRexx files that have no corresponding -class file or where the class file is older than the java file will be compiled.</p> -<p>Files in the source tree are copied to the destination directory, -allowing support files to be located properly in the classpath. The source -files are copied because the NetRexx compiler cannot produce class files in a -specific directory via parameters</p> -<p>The directory structure of the source tree should follow the package -hierarchy.</p> -<p>It is possible to refine the set of files that are being compiled/copied. -This can be done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and -<i>defaultexcludes</i> attributes. With the <i>includes</i> or <i>includesfile</i> attribute you -specify the files you want to have included by using patterns. The -<i>exclude</i> or <i>excludesfile</i> attribute is used to specify the files you want to have -excluded. This is also done with patterns. And finally with the -<i>defaultexcludes</i> attribute, you can specify whether you -want to use default exclusions or not. See the section on <a -href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns.</p> -<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>srcdir</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -<p>All properties except classpath, srcdir and destDir are also available as properties in the form -<code>ant.netrexxc.<i>attributename</i></code>, eg.<br> -<code>&lt;property name="ant.netrexxc.verbose" value="noverbose"/&gt;</code><br> -or from the command line as<br> -<code>ant -Dant.netrexxc.verbose=noverbose ...</code> -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="binary" REQUIRED="no"> - <DESCRIPTION>Whether literals are treated as the java binarytype rather than the NetRexx type</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="no"> - <DESCRIPTION>The classpath to use during compilatio</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="comments" REQUIRED="no"> - <DESCRIPTION>Whether comments are passed through to thegenerated java sourc</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compact" REQUIRED="no"> - <DESCRIPTION>Whether error messages come out in compact orverbose format. Default is the compact format</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="compile" REQUIRED="no"> - <DESCRIPTION>Whether the NetRexx compiler should compile thegenerated java cod</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="console" REQUIRED="no"> - <DESCRIPTION>Whether or not messages should be displayed on the'console</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="crossref" REQUIRED="no"> - <DESCRIPTION>Whether variable cross references are generate</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="decimal" REQUIRED="no"> - <DESCRIPTION>Whether decimal arithmetic should be used for theNetRexx cod</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used whenomitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destdir" REQUIRED="yes"> - <DESCRIPTION>the destination directory into which the NetRexxsource files should be copied and then compile</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="diag" REQUIRED="no"> - <DESCRIPTION>Whether diagnostic information about the compile isgenerate</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded whenomitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="explicit" REQUIRED="no"> - <DESCRIPTION>Whether variables must be declared explicitlybefore us</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="format" REQUIRED="no"> - <DESCRIPTION>Whether the generated java code is formatted nicelyor left to match NetRexx line numbers for call stack debuggin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="java" REQUIRED="no"> - <DESCRIPTION>Whether the generated java code is produce</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="keep" REQUIRED="no"> - <DESCRIPTION>Sets whether the generated java source file should be keptafter compilation. The generated files will have an extension of.java.keep, not .jav</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="logo" REQUIRED="no"> - <DESCRIPTION>Whether the compiler text logo is displayed whencompilin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="replace" REQUIRED="no"> - <DESCRIPTION>Whether the generated .java file should be replacedwhen compilin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="savelog" REQUIRED="no"> - <DESCRIPTION>Whether the compiler messages will be written toNetRexxC.log as well as to the consol</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="sourcedir" REQUIRED="no"> - <DESCRIPTION>Tells the NetRexx compiler to store the class files in thesame directory as the source files. The alternative is the workingdirector</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="srcdir" REQUIRED="yes"> - <DESCRIPTION>Set the source dir to find the source NetRexxfile</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strictargs" REQUIRED="no"> - <DESCRIPTION>Tells the NetRexx compiler that method calls alwaysneed parentheses, even if no arguments are needed, e.g.aStringVar.getBytes vs.aStringVar.getBytes(</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strictassign" REQUIRED="no"> - <DESCRIPTION>Tells the NetRexx compile that assignments mustmatch exactly on typ</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strictcase" REQUIRED="no"> - <DESCRIPTION>Specifies whether the NetRexx compiler should becase sensitive or no</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strictimport" REQUIRED="no"> - <DESCRIPTION>Whether classes need to be imported explicitly using animport statement. By default the NetRexx compiler willimport certain packages automaticall</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strictprops" REQUIRED="no"> - <DESCRIPTION>Whether local properties need to be qualifiedexplicitly using thi</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="strictsignal" REQUIRED="no"> - <DESCRIPTION>Whether the compiler should force catching ofexceptions by explicitly named type</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="symbols" REQUIRED="no"> - <DESCRIPTION>Whether debug symbols should be generated into theclass fil</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="time" REQUIRED="no"> - <DESCRIPTION>Asks the NetRexx compiler to print compilationtimes to the consol</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="trace" REQUIRED="no"> - <DESCRIPTION>Turns on or off tracing and directs the resultanttrace outpu</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="utf8" REQUIRED="no"> - <DESCRIPTION>Tells the NetRexx compiler that the source is in UTF</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="verbose" REQUIRED="no"> - <DESCRIPTION>Whether lots of warnings and error messages shouldbe generate</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="suppressmethodargumentnotused" REQUIRED="no"> - <DESCRIPTION>Tells whether we should filter out the&Method argument not used& messages in strictargs mode</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="suppressprivatepropertynotused" REQUIRED="no"> - <DESCRIPTION>Tells whether we should filter out the&Private Property defined, but not used& messages in strictargs mode</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="suppressvariablenotused" REQUIRED="no"> - <DESCRIPTION>Tells whether we should filter out the&Variable set but not used& messages in strictargs mode.Please be careful with this one, as you can hide errors behind it</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="suppressexceptionnotsignalled" REQUIRED="no"> - <DESCRIPTION>Tells whether we should filter out the&Exception is declared, but not signalled within the method&messages in strictsignal mode</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="suppressdeprecation" REQUIRED="no"> - <DESCRIPTION>Tells wether we should filter out any deprecation-messagesof the compiler out</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="pvcs"> - <DESCRIPTION>The pvcs task is set to point at a PVCS repository and optionally a project -within that repository, and can from that specification get the latest -version of the files contained by the repository. -</DESCRIPTION> - <ATTRIBUTE NAME="repository" REQUIRED="yes"> - <DESCRIPTION>The location of the repository (see your PVCSmanuals</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="pvcsproject" REQUIRED="no"> - <DESCRIPTION>The project within the PVCS repository to extractfiles from ("/" is root project and that is default if this attribute isn'tspecified</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="label" REQUIRED="no"> - <DESCRIPTION>Only files marked with this label are extracted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="promotiongroup" REQUIRED="no"> - <DESCRIPTION>Only files within this promotion group are extracted. Usingboth the label and the promotiongroup tag will cause the files in thepromotion group and with that label to be extracted.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="force" REQUIRED="no"> - <DESCRIPTION>If set to yes all files that exists and are writable are overwritten. Default no causes the files that are writable to be ignored. This stops the PVCS command get to stop asking questions</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="workspace" REQUIRED="no"> - <DESCRIPTION>By specifying a workspace, the files are extracted to that location. A PVCS workspace is aname for a location of the workfiles and isn't as such the location itself. You define the location for a workspaceusing the PVCS GUI clients. If this isn't specified the default workspace for the current user is used</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="pvcsbin" REQUIRED="no"> - <DESCRIPTION>On some systems the PVCS executables pcliand get are not found in the PATH. In such cases this attributeshould be set to the bin directory of the PVCS installation containingthe executables mentioned before. If this attribute isn't specified thetag expects the executables to be found using the PATH environment variable</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="ignorereturncode" REQUIRED="no"> - <DESCRIPTION>If set to true the return value from executingthe pvcs commands are ignored</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="updateonly" REQUIRED="no"> - <DESCRIPTION>If set to true files are gotten only ifnewer than existing local files</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="filenameformat" REQUIRED="no"> - <DESCRIPTION>The format of your folder names in aformat suitable for java.text.MessageFormat.Defaults to {0}-arc({1}). Repositories wherethe archive extension is not -arc should setthis</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="linestart" REQUIRED="no"> - <DESCRIPTION>Used to parse the output of the pclicommand. It defaults to "P:. The parser alreadyknows about / and \\, this property is useful in cases where therepository is accessed on a Windows platform via a drive lettermapping</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="renameextensions"> - <DESCRIPTION><p>Renames files in the <code>srcDir</code> directory ending with the -<code>fromExtension</code> string so that they end with the -<code>toExtension</code> string. Files are only replaced if -<code>replace</code> is true -</p> -<p>See the section on -<a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the -inclusion/exclusion of files works, and how to write patterns. -This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and -supports all attributes of <code>&lt;fileset&gt;</code> -(<code>dir</code> becomes <code>srcDir</code>) as well as the nested -<code>&lt;include&gt;</code>, <code>&lt;exclude&gt;</code> and -<code>&lt;patternset&gt;</code> elements.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="defaultexcludes" REQUIRED="no"> - <DESCRIPTION>indicates whether default excludes should be used or not("yes"/"no"). Default excludes are used whenomitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beexcluded. No files (except default excludes) are excluded whenomitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="excludesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an exclude patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="fromextention" REQUIRED="yes"> - <DESCRIPTION>The string that files must end in to be rename</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includes" REQUIRED="no"> - <DESCRIPTION>comma- or space-separated list of patterns of files that must beincluded. All files are included when omitted</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="includesfile" REQUIRED="no"> - <DESCRIPTION>the name of a file. Each line of this file istaken to be an include patter</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="replace" REQUIRED="no"> - <DESCRIPTION>Whether the file being renamed to should bereplaced if it already exist</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="srcdir" REQUIRED="yes"> - <DESCRIPTION>The starting directory for files to search i</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="toextension" REQUIRED="yes"> - <DESCRIPTION>The string that renamed files will end with oncompletio</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="replaceregeexp"> - <DESCRIPTION><p>ReplaceRegExp is a directory based task for replacing the -occurrence of a given regular expression with a substitution pattern -in a selected file or set of files.</p> -<p>Similar to <a href="../CoreTypes/mapper.html#regexp-mapper">regexp -type mappers</a> this task needs a supporting regular expression -library and an implementation of -<code>org.apache.tools.ant.util.regexp.Regexp</code>. Ant comes with -implementations for -<a href="http://java.sun.com/j2se/1.4/docs/api/java/util/regex/package-summary.html" target="_top">the java.util.regex package of JDK 1.4</a>, -<a href="http://jakarta.apache.org/regexp/" target="_top">jakarta-regexp</a> -and <a href="http://jakarta.apache.org/oro/" target="_top">jakarta-ORO</a>, -but you will still need the library itself.</p> -<p> -<i> -There are cross-platform issues for matches related to line terminator. -For example if you use $ to anchor your regular expression on the end of a line -the results might be very different depending on both your platform and the regular -expression library you use. It is 'highly recommended' that you test your pattern on -both Unix and Windows platforms before you rely on it. -<ul> -<li>Jakarta Oro defines a line terminator as '\n' and is consistent with Perl.</li> -<li>Jakarta RegExp uses a system-dependant line terminator.</li> -<li>JDK 1.4 uses '\n', '\r\n', '\u0085', '\u2028', '\u2029' as a default -but is configured in the wrapper to use only '\n' (UNIX_LINE)</li> -</ul> -We <b>strongly</b> recommend that you use Jakarta Oro. -</i> -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="yes if no nested <fileset> is used"> - <DESCRIPTION>file for which the regular expression should be replaced</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="match" REQUIRED="yes, if no nested <regexp> is used"> - <DESCRIPTION>The regular expression pattern to match in the file(s</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="replace" REQUIRED="yes, if no nested <substitution> is used"> - <DESCRIPTION>The substitution pattern to place in the file(s) in placeof the regular expression</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="flags" REQUIRED="no"> - <DESCRIPTION>The flags to use when matching the regular expression. For moreinformation, consult the Perl5 syntag : Global replacement. Replace all occurences founi : Case Insensitive. Do not consider case in the matcm : Multiline. Treat the string as multiple lines of input, using "^" and "$" as the start or end of any line, respectively, rather than start or end of strings : Singleline. Treat the string as a single line of input, using "." to match any character, including a newline, which normally, it would not match</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="byline" REQUIRED="no"> - <DESCRIPTION>Process the file(s) one line at a time, executing the replacementon one line at a time (true/false). This is useful if youwant to only replace the first occurence of a regular expression oneach line, which is not easy to do when processing the file as a whole.Defaults to false</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="rpm"> - <DESCRIPTION><p> -A basic task for invoking the rpm executable to build a Linux installation -file. The task currently only works on Linux or other Unix platforms -with rpm support. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="specfile" REQUIRED="yes"> - <DESCRIPTION>The name of the spec File to be used</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="topdir" REQUIRED="no"> - <DESCRIPTION>this is the directory which will have the expectedsubdirectories, SPECS, SOURCES, BUILD, SRPMS. If this isn't specified,the baseDir value is used</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="cleanbuilddir" REQUIRED="no"> - <DESCRIPTION>This will remove the generated files in the BUILDdirectory</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="removespec" REQUIRED="no"> - <DESCRIPTION>this will remove the spec file from SPEC</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="removesource" REQUIRED="no"> - <DESCRIPTION>Flag (optional, default=false) to remove the sources after the build.See the the --rmsource option of rpmbuild</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="command" REQUIRED="no"> - <DESCRIPTION>very similar idea to the cvs task. the default is "-bb</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="output/error" REQUIRED="no"> - <DESCRIPTION>where standard output and error g</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="script"> - <DESCRIPTION><p>Execute a script in a -<a href="http://www-124.ibm.com/developerworks/projects/bsf" target="_top">BSF</a> supported language.</p> -<p><b>Note:</b> This task depends on external libraries not included in the Ant distribution. -See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> -<p>All items (tasks, targets, etc) of the running project are -accessible from the script, using either their <code>name</code> or -<code>id</code> attributes (as long as their names are considered -valid Java identifiers, that is). -The name "project" is a pre-defined reference to the Project, which can be -used instead of the project name.</p> -<p><b>BeanShell users:</b> This task now natively supports the BeanShell -scripting language, using language="beanshell". The BeanShell engine is -still required. -</p> -<p>Scripts can do almost anything a task written in Java could do.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="language" REQUIRED="yes"> - <DESCRIPTION>The programming language the script is written in.Must be a supported BSF languag</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="src" REQUIRED="no"> - <DESCRIPTION>The location of the script as a file, if not inlin</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="serverdeploy"> - <DESCRIPTION><p>The <code>serverdeploy</code> task is used to run a "hot" deployment tool for -vendor-specific J2EE server. The task requires nested elements which define -the attributes of the vendor-specific deployment tool being executed. -Vendor-specific deployment tools elements may enforce rules for which -attributes are required, depending on the tool. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="action" REQUIRED="yes"> - <DESCRIPTION>This is the action to be performed. For most cases thiswill be "deploy". Some tools support additional actions, such as "delete", "list","undeploy", "update"..</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="source" REQUIRED="tool dependant"> - <DESCRIPTION>A fully qualified path/filename of the component to be deployed.This may be an .ear, .jar, .war, or any other type that is supported by the server.</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="splash"> - <DESCRIPTION><p>This task creates a splash screen. The splash screen is displayed -for the duration of the build and includes a handy progress bar as -well. Use in conjunction with the sound task to provide interest -whilst waiting for your builds to complete...</p> -</DESCRIPTION> - <ATTRIBUTE NAME="imageurl" REQUIRED="no"> - <DESCRIPTION>A URL pointing to an image to display</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="showduration" REQUIRED="no"> - <DESCRIPTION>Initial period to pause the build to show thesplash in milliseconds</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="stylebook"> - <DESCRIPTION><p>This executes the apache Stylebook documentation generator. -Unlike the commandline version of this tool, all three arguments -are required to run stylebook.</p> -<p><b>Note:</b> This task depends on external libraries not included in the Ant distribution. -See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> -<p> -Being extended from &lt;Java&gt;, all the parent's attributes -and options are available. Do not set any apart from the <tt>classpath</tt> -as they are not guaranteed to be there in future. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="book" REQUIRED="yes"> - <DESCRIPTION>the book xml file that the documentation generation starts from</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="skindirectory" REQUIRED="yes"> - <DESCRIPTION>the directory that contains the stylebook skin</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="targetdirectory" REQUIRED="yes"> - <DESCRIPTION>the destination directory where the documentation is generated </DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="telnet"> - <DESCRIPTION>Task to automate a remote telnet session. The task uses -nested <tt>&lt;read&gt;</tt> to indicate strings to wait for, and -<tt>&lt;write&gt;</tt> tags to specify text to send. -<p>If you do specify a userid and password, the system will -assume a common unix prompt to wait on. This behavior can be easily over-ridden.</p> -<p><b>Note:</b> This task depends on external libraries not included in the Ant distribution. -See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="userid" REQUIRED="only if password is specified"> - <DESCRIPTION>the login id to use on the telnet server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="password" REQUIRED="only if userid is specified"> - <DESCRIPTION>the login password to use on the telnet server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="server" REQUIRED="yes"> - <DESCRIPTION>the address of the remote telnet server</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="port" REQUIRED="no"> - <DESCRIPTION>the port number of the remote telnet server. Defaults to port 23</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="initialcr" REQUIRED="no"> - <DESCRIPTION>send a cr after connecting ("yes"). Defaults to "no"</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="timeout" REQUIRED="no"> - <DESCRIPTION>set a default timeout to wait for a response. Specified in seconds. Default is no timeout</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="test"> - <DESCRIPTION><p>This is a primitive task to execute a unit test in the org.apache.testlet framework.</p> -<p><strong>Note:</strong> This task depends on external libraries not included -in the Ant distribution. See <a href="../install.html#librarydependencies"> -Library Dependencies</a> for more information. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="showsuccess" REQUIRED="no"> - <DESCRIPTION>a boolean value indicating whether tests should display a message on success</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="showbanner" REQUIRED="no"> - <DESCRIPTION>a boolean value indicating whether a banner should be displayed when starting testlet engine</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="forceshowtrace" REQUIRED="no"> - <DESCRIPTION>a boolean indicating that a stack trace is displayed on any failure</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="showtrace" REQUIRED="no"> - <DESCRIPTION>a boolean indicating that a stack trace is displayed on error (but not normal failure)</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="translate"> - <DESCRIPTION><p>Identifies keys in files delimited by special tokens -and translates them with values read from resource bundles. -</p> -<p> -A resource bundle contains locale-specific key-value pairs. -A resource bundle is a hierarchical set of property files. -A bundle name makes up its base family name. Each file that -makes up this bundle has this name plus its locale. For example, -if the resource bundle name is MyResources, the file that contains -German text will take the name MyResources_de. In addition to -language, country and variant are also used to form the files in -the bundle. -</p> -<p> -The resource bundle lookup searches for resource files with various -suffixes on the basis of (1) the desired locale and (2) the default -locale (basebundlename), in the following order from lower-level -(more specific) to parent-level (less specific): -</p> -<pre> -basebundlename + &quot;_&quot; + language1 + &quot;_&quot; + country1 + &quot;_&quot; + variant1 -basebundlename + &quot;_&quot; + language1 + &quot;_&quot; + country1 -basebundlename + &quot;_&quot; + language1 -basebundlename -basebundlename + &quot;_&quot; + language2 + &quot;_&quot; + country2 + &quot;_&quot; + variant2 -basebundlename + &quot;_&quot; + language2 + &quot;_&quot; + country2 -basebundlename + &quot;_&quot; + language2 -</pre> -<p> -The file names generated thus are appended with the string &quot;.properties&quot; -to make up the file names that are to be used. -</p> -<p> -File encoding is supported. The encoding scheme of the source files, -destination files and the bundle files can be specified. -Destination files can be exlicitly overwritten using the -<var>forceoverwrite</var> attribute. If <var>forceoverwrite</var> -is false, the destination file is overwritten only if either the -source file or any of the files that make up the bundle have been -modified after the destination file was last modified. -</p> -<p><a href="../CoreTypes/fileset.html">FileSet</a>s are used to select files to -translate. -</p> -</DESCRIPTION> - <ATTRIBUTE NAME="todir" REQUIRED="yes"> - <DESCRIPTION>Destination directory where destination files areto be created</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="starttoken" REQUIRED="yes"> - <DESCRIPTION>The starting token to identify keys</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="endtoken" REQUIRED="yes"> - <DESCRIPTION>The ending token to identify keys</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bundle" REQUIRED="yes"> - <DESCRIPTION>Family name of resource bundle</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bundlelanguage" REQUIRED="no"> - <DESCRIPTION>Locale specific language of resource bundle. Defaults todefault locale's language.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bundlecountry" REQUIRED="no"> - <DESCRIPTION>Locale specific country of resource bundle. Defaults todefault locale's country.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bundlevariant" REQUIRED="no"> - <DESCRIPTION>Locale specific variant of resource bundle. Defaults tothe default variant of the country and language being used.</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="srcencoding" REQUIRED="no"> - <DESCRIPTION>Source file encoding scheme. Defaults tosystem default file encoding</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="destencoding" REQUIRED="no"> - <DESCRIPTION>Destination file encoding scheme. Defaults tosource file encoding</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="bundleencoding" REQUIRED="no"> - <DESCRIPTION>Resource Bundle file encoding scheme. Defaults tosource file encoding</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="forceoverwrite" REQUIRED="no"> - <DESCRIPTION>Overwrite existing files even if the destinationfiles are newer. Defaults to "no"</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="wljspc"> - <DESCRIPTION><p>Class to precompile JSP's using weblogic's jsp compiler (weblogic.jspc)</p> -Tested only on Weblogic 4.5.1 - NT4.0 and Solaris 5.7,5.8<br> -</DESCRIPTION> - <ATTRIBUTE NAME="src" REQUIRED="yes"> - <DESCRIPTION>oot of source tree for JSP, ie, the document root for your weblogic serve</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="dest" REQUIRED="yes"> - <DESCRIPTION>root of destination directory, what you have set as WorkingDir in the weblogic propertie</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="package" REQUIRED="yes"> - <DESCRIPTION>start package name under which your JSP's would be compile</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpath" REQUIRED="yes"> - <DESCRIPTION>Class path to use when compiling jsp'</DESCRIPTION> - </ATTRIBUTE> - </TASK> - <TASK NAME="xmlvalidate"> - <DESCRIPTION><p>This task checks xml files are valid (or only well formed). The -task uses the SAX2 parser implementation provided by JAXP by default -(probably the one that is used by Ant itself), but one can specify any -SAX1/2 parser if needed.</p> -<p>This task supports the use of nested <a -href="../CoreTypes/xmlcatalog.html">xmlcatalog</a> elements and/or nested -<tt>&lt;dtd&gt;</tt> elements which are used to resolve DTDs and entities.</p> -</DESCRIPTION> - <ATTRIBUTE NAME="file" REQUIRED="no"> - <DESCRIPTION>the file(s) you want to check. (optionally can use an embedded fileset</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="lenient" REQUIRED="no"> - <DESCRIPTION>if true, only check the xml document is well formed(ignored if the specified parser is as SAX1 parser)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classname" REQUIRED="no"> - <DESCRIPTION>the parser to use</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="classpathref" REQUIRED="no"> - <DESCRIPTION>where to find the parser class. Optionally can use an embedded classpath element</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="failonerror" REQUIRED="no"> - <DESCRIPTION>fails on a error if set to true (defaults to true)</DESCRIPTION> - </ATTRIBUTE> - - <ATTRIBUTE NAME="warn" REQUIRED="no"> - <DESCRIPTION>log parser warn events</DESCRIPTION> - </ATTRIBUTE> - </TASK> -</TASKS> diff --git a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/AntSupportMessages.java b/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/AntSupportMessages.java deleted file mode 100644 index 7e2dacb82..000000000 --- a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/AntSupportMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntSupportMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.AntSupportMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntSupportMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/AntSupportMessages.properties b/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/AntSupportMessages.properties deleted file mode 100644 index b8e9d0137..000000000 --- a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/AntSupportMessages.properties +++ /dev/null @@ -1,22 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -AntInputHandler.Ant_Input_Request_1=Ant Input Request -AntInputHandler.Invalid_input_2=Invalid input -AntInputHandler.Unable_to_respond_to_<input>_request_4=Unable to respond to <input> request - -AntProcessBuildLogger.BUILD_FAILED__{0}_1=BUILD FAILED: {0} -AntProcessBuildLogger.Total_time=Total time: -AntProcessBuildLogger._minutes_2=\ minutes -AntProcessBuildLogger._minute_3=\ minute -AntProcessBuildLogger._seconds_4=\ seconds -AntProcessBuildLogger._second_5=\ second -AntProcessBuildLogger._milliseconds_6=\ milliseconds diff --git a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/inputhandler/AntInputHandler.java b/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/inputhandler/AntInputHandler.java deleted file mode 100644 index 21b8d2fdb..000000000 --- a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/inputhandler/AntInputHandler.java +++ /dev/null @@ -1,65 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.inputhandler; - - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.input.DefaultInputHandler; -import org.apache.tools.ant.input.InputRequest; -import org.eclipse.jface.dialogs.IInputValidator; -import org.eclipse.jface.dialogs.InputDialog; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.ant.AntSupportMessages; - -/** - * The default input handler when using Ant within Eclipse. - * This is the class that will respond to <input> requests from - * within an Ant build file. - */ -public class AntInputHandler extends DefaultInputHandler { - - /** - * @see org.apache.tools.ant.input.InputHandler#handleInput(org.apache.tools.ant.input.InputRequest) - */ - public void handleInput(InputRequest request) throws BuildException { - BuildException[] problem= new BuildException[1]; - Runnable runnable= getHandleInputRunnable(request, problem); - Display.getDefault().syncExec(runnable); - if (problem[0] != null) { - throw problem[0]; - } - } - - protected Runnable getHandleInputRunnable(final InputRequest request, final BuildException[] problem) { - return new Runnable() { - public void run() { - String prompt = getPrompt(request); - String title= AntSupportMessages.getString("AntInputHandler.Ant_Input_Request_1"); //$NON-NLS-1$ - IInputValidator validator= new IInputValidator() { - int hitCount= -1; - public String isValid(String value) { - request.setInput(value); - if (request.isInputValid()) { - return null; - } else { - return AntSupportMessages.getString("AntInputHandler.Invalid_input_2"); //$NON-NLS-1$ - } - } - }; - - InputDialog dialog= new InputDialog(null, title, prompt, "", validator); //$NON-NLS-1$ - if (dialog.open() != InputDialog.OK) { - problem[0]= new BuildException(AntSupportMessages.getString("AntInputHandler.Unable_to_respond_to_<input>_request_4")); //$NON-NLS-1$ - } - } - }; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/logger/AntProcessBuildLogger.java b/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/logger/AntProcessBuildLogger.java deleted file mode 100644 index 169e37b84..000000000 --- a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/logger/AntProcessBuildLogger.java +++ /dev/null @@ -1,347 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - * Matt Conway - Patch for Bug 28052 - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.logger; - -import java.io.File; -import java.text.MessageFormat; - -import org.apache.tools.ant.BuildEvent; -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.Location; -import org.apache.tools.ant.Project; -import org.apache.tools.ant.Task; -import org.apache.tools.ant.util.FileUtils; -import org.eclipse.ant.core.AntSecurityException; -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.OperationCanceledException; -import org.eclipse.core.runtime.Path; -import org.eclipse.debug.core.DebugPlugin; -import org.eclipse.debug.core.model.IProcess; -import org.eclipse.debug.ui.console.FileLink; -import org.eclipse.debug.ui.console.IConsoleHyperlink; -import org.eclipse.jface.text.Region; -import org.eclipse.ui.externaltools.internal.ant.AntSupportMessages; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntProcess; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntStreamMonitor; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntStreamsProxy; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.TaskLinkManager; - -/** - */ -public class AntProcessBuildLogger extends NullBuildLogger { - - private File fBuildFileParent= null; - private long fStartTime; - - /** - * Size of left-hand column for right-justified task name. - * @see #logMessage(String, BuildEvent, -1) - */ - public static final int LEFT_COLUMN_SIZE = 15; - - /** - * Associated process - discovered as needed to log messages - */ - private AntProcess fProcess = null; - - /** - * @see org.eclipse.ui.externaltools.internal.ant.logger.NullBuildLogger#logMessage(java.lang.String, int) - */ - protected void logMessage(String message, BuildEvent event, int overridePriority) { - int priority= overridePriority; - if (priority == -1) { - priority= event.getPriority(); - } - - if (priority > getMessageOutputLevel()) { - return; - } - AntProcess antProcess = getAntProcess(event.getProject().getUserProperty(AntProcess.ATTR_ANT_PROCESS_ID)); - if (antProcess == null) { - return; - } - - AntStreamMonitor monitor = getMonitor(priority); - - if (event.getTarget() == null) { - // look for "Buildfile:" message - if (message.startsWith("Buildfile:")) { //$NON-NLS-1$ - String fileName = message.substring(10).trim(); - IFile file = getFileForLocation(fileName); - if (file != null) { - FileLink link = new FileLink(file, null, -1, -1, -1); - TaskLinkManager.addTaskHyperlink(fProcess, link, new Region(11 + System.getProperty("line.separator").length(), fileName.length()), fileName); //$NON-NLS-1$ - fBuildFileParent= file.getLocation().toFile().getParentFile(); - } - } - } - - StringBuffer fullMessage= new StringBuffer(System.getProperty("line.separator")); //$NON-NLS-1$ - - if (event.getTask() != null && !fEmacsMode) { - getAdornedMessage(event, fullMessage); - } - fullMessage.append(message); - message= fullMessage.toString(); - - monitor.append(message); - logMessageToLogFile(message, priority); - - } - - /** - * Builds a right justified task prefix for the given build event, placing it - * in the given string buffer. Creates a hyperlink for the task prefix. - * - * @param event build event - * @param fullMessage buffer to place task prefix in - */ - private void getAdornedMessage(BuildEvent event, StringBuffer fullMessage) { - String name = event.getTask().getTaskName(); - if (name == null) { - name = "null"; //$NON-NLS-1$ - } - int size = LEFT_COLUMN_SIZE - (name.length() + 3); - for (int i = 0; i < size; i++) { - fullMessage.append(' '); - } - fullMessage.append('['); - fullMessage.append(name); - fullMessage.append("] "); //$NON-NLS-1$ - int offset = Math.max(size, 0) + 1; - int length = LEFT_COLUMN_SIZE - size - 3; - IConsoleHyperlink taskLink = getTaskLink(event); - if (taskLink != null) { - TaskLinkManager.addTaskHyperlink(fProcess, taskLink, new Region(offset, length), name); - } - } - - private AntStreamMonitor getMonitor(int priority) { - AntStreamsProxy proxy = (AntStreamsProxy)fProcess.getStreamsProxy(); - AntStreamMonitor monitor = null; - switch (priority) { - case Project.MSG_INFO: - monitor = (AntStreamMonitor)proxy.getOutputStreamMonitor(); - break; - case Project.MSG_ERR: - monitor = (AntStreamMonitor)proxy.getErrorStreamMonitor(); - break; - case Project.MSG_DEBUG: - monitor = (AntStreamMonitor)proxy.getDebugStreamMonitor(); - break; - case Project.MSG_WARN: - monitor = (AntStreamMonitor)proxy.getWarningStreamMonitor(); - break; - case Project.MSG_VERBOSE: - monitor = (AntStreamMonitor)proxy.getVerboseStreamMonitor(); - break; - } - return monitor; - } - - private void logMessageToLogFile(String message, int priority) { - if (priority == Project.MSG_ERR) { - if (getErrorPrintStream() != null && getErrorPrintStream() != System.err) { - //user has designated to log to a logfile - getErrorPrintStream().println(message); - } - } else { - if (getOutputPrintStream() != null && getOutputPrintStream() != System.out) { - //user has designated to log to a logfile - getOutputPrintStream().println(message); - } - } - } - - /** - * Returns a hyperlink for the given task, or <code>null</code> if unable to - * parse a valid location for the task. The link is set to exist at the specified - * offset and length. - * - * @return hyper link, or <code>null</code> - */ - private IConsoleHyperlink getTaskLink(BuildEvent event) { - Task task = event.getTask(); - if (task != null) { - Location location = task.getLocation(); - if (location != null) { - String path = location.toString().trim(); - if (path.length() == 0) { - return null; - } - if (path.startsWith("file:")) { //$NON-NLS-1$ - // remove "file:" - path= path.substring(5, path.length()); - } - // format is file:F:L: where F is file path, and L is line number - int index = path.lastIndexOf(':'); - if (index == path.length() - 1) { - // remove trailing ':' - path = path.substring(0, index); - index = path.lastIndexOf(':'); - } - // split file and line number - String fileName = path.substring(0, index); - IFile file = getFileForLocation(fileName); - if (file != null) { - try { - String lineNumber = path.substring(index + 1); - int line = Integer.parseInt(lineNumber); - return new FileLink(file, null, -1, -1, line); - } catch (NumberFormatException e) { - } - } - } - } - return null; - } - - /** - * Returns the associated Ant process, finding it if necessary, if not - * already found. - */ - private AntProcess getAntProcess(String processId) { - if (fProcess == null && processId != null) { - IProcess[] all = DebugPlugin.getDefault().getLaunchManager().getProcesses(); - for (int i = 0; i < all.length; i++) { - IProcess process = all[i]; - if (process instanceof AntProcess && processId.equals(process.getAttribute(AntProcess.ATTR_ANT_PROCESS_ID))) { - fProcess = (AntProcess)process; - break; - } - } - } - return fProcess; - } - - /** - * Set the start time. - * - * @see org.apache.tools.ant.BuildListener#buildStarted(org.apache.tools.ant.BuildEvent) - */ - public void buildStarted(BuildEvent event) { - fStartTime= System.currentTimeMillis(); - } - - /** - * @see org.apache.tools.ant.BuildListener#buildFinished(org.apache.tools. - * ant.BuildEvent) - */ - public void buildFinished(BuildEvent event) { - handleException(event); - fHandledException= null; - fBuildFileParent= null; - logMessage(getTimeString(System.currentTimeMillis() - fStartTime), event, fMessageOutputLevel); - fProcess= null; - event.getProject().removeBuildListener(this); - } - - private String getTimeString(long milliseconds) { - long seconds = milliseconds / 1000; - long minutes = seconds / 60; - seconds= seconds % 60; - - StringBuffer result= new StringBuffer(AntSupportMessages.getString("AntProcessBuildLogger.Total_time")); //$NON-NLS-1$ - if (minutes > 0) { - result.append(minutes); - if (minutes > 1) { - result.append(AntSupportMessages.getString("AntProcessBuildLogger._minutes_2")); //$NON-NLS-1$ - } else { - result.append(AntSupportMessages.getString("AntProcessBuildLogger._minute_3")); //$NON-NLS-1$ - } - } - if (seconds > 0) { - if (minutes > 0) { - result.append(' '); - } - result.append(seconds); - - if (seconds > 1) { - result.append(AntSupportMessages.getString("AntProcessBuildLogger._seconds_4")); //$NON-NLS-1$ - } else { - result.append(AntSupportMessages.getString("AntProcessBuildLogger._second_5")); //$NON-NLS-1$ - } - } - if (seconds == 0 && minutes == 0) { - result.append(milliseconds); - result.append(AntSupportMessages.getString("AntProcessBuildLogger._milliseconds_6")); //$NON-NLS-1$ - } - return result.toString(); - } - - /** - * @see BuildListener#messageLogged(BuildEvent) - */ - public void messageLogged(BuildEvent event) { - logMessage(event.getMessage(), event, -1); - } - - protected void handleException(BuildEvent event) { - Throwable exception = event.getException(); - if (exception == null || exception == fHandledException - || exception instanceof OperationCanceledException - || exception instanceof AntSecurityException) { - return; - } - fHandledException= exception; - logMessage(MessageFormat.format(AntSupportMessages.getString("AntProcessBuildLogger.BUILD_FAILED__{0}_1"), new String[] { exception.toString()}), //$NON-NLS-1$ - event, Project.MSG_ERR); - } - - /** - * @see org.apache.tools.ant.BuildListener#targetStarted(org.apache.tools.ant.BuildEvent) - */ - public void targetStarted(BuildEvent event) { - if (Project.MSG_INFO > getMessageOutputLevel()) { - return; - } - StringBuffer msg= new StringBuffer(System.getProperty("line.separator")); //$NON-NLS-1$ - msg.append(event.getTarget().getName()); - msg.append(':'); - logMessage(msg.toString(), event, Project.MSG_INFO); - } - - /** - * Returns the workspace file associated with the given absolute path in the - * local file system, or <code>null</code> if none. - * - * @param absolutePath - * @return file or <code>null</code> - */ - private IFile getFileForLocation(String absolutePath) { - IPath filePath= new Path(absolutePath); - IFile file = ResourcesPlugin.getWorkspace().getRoot().getFileForLocation(filePath); - if (file == null) { - //relative path - File relativeFile= null; - try { - //this call is ok if fBuildFileParent is null - relativeFile= FileUtils.newFileUtils().resolveFile(fBuildFileParent, absolutePath); - filePath= new Path(relativeFile.getAbsolutePath()); - file = ResourcesPlugin.getWorkspace().getRoot().getFileForLocation(filePath); - if (file == null) { - return null; - } - } catch (BuildException be) { - return null; - } - } - - if (file.exists()) { - return file; - } - return null; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/logger/NullBuildLogger.java b/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/logger/NullBuildLogger.java deleted file mode 100644 index 3352d8019..000000000 --- a/org.eclipse.ui.externaltools/Ant Runner Support/org/eclipse/ui/externaltools/internal/ant/logger/NullBuildLogger.java +++ /dev/null @@ -1,165 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.logger; - - -import java.io.PrintStream; -import java.text.MessageFormat; - -import org.apache.tools.ant.BuildEvent; -import org.apache.tools.ant.BuildLogger; -import org.apache.tools.ant.Project; -import org.eclipse.ant.core.AntSecurityException; -import org.eclipse.core.runtime.OperationCanceledException; -import org.eclipse.ui.externaltools.internal.ant.AntSupportMessages; - -public class NullBuildLogger implements BuildLogger { - - protected int fMessageOutputLevel = Project.MSG_INFO; - private PrintStream fErr= null; - private PrintStream fOut= null; - protected boolean fEmacsMode= false; - - /** - * An exception that has already been logged. - */ - protected Throwable fHandledException= null; - - /** - * @see org.apache.tools.ant.BuildLogger#setMessageOutputLevel(int) - */ - public void setMessageOutputLevel(int level) { - fMessageOutputLevel= level; - } - - protected int getMessageOutputLevel() { - return fMessageOutputLevel; - } - - /** - * @see org.apache.tools.ant.BuildLogger#setEmacsMode(boolean) - */ - public void setEmacsMode(boolean emacsMode) { - fEmacsMode= emacsMode; - } - - /** - * @see org.apache.tools.ant.BuildListener#buildStarted(org.apache.tools.ant.BuildEvent) - */ - public void buildStarted(BuildEvent event) { - } - - /** - * @see org.apache.tools.ant.BuildListener#buildFinished(org.apache.tools.ant.BuildEvent) - */ - public void buildFinished(BuildEvent event) { - handleException(event); - fHandledException= null; - } - - /** - * @see org.apache.tools.ant.BuildListener#targetStarted(org.apache.tools.ant.BuildEvent) - */ - public void targetStarted(BuildEvent event) { - } - - /** - * @see org.apache.tools.ant.BuildListener#targetFinished(org.apache.tools.ant.BuildEvent) - */ - public void targetFinished(BuildEvent event) { - handleException(event); - } - - /** - * @see org.apache.tools.ant.BuildListener#taskStarted(org.apache.tools.ant.BuildEvent) - */ - public void taskStarted(BuildEvent event) { - } - - /** - * @see org.apache.tools.ant.BuildListener#taskFinished(org.apache.tools.ant.BuildEvent) - */ - public void taskFinished(BuildEvent event) { - handleException(event); - } - - /** - * @see BuildListener#messageLogged(BuildEvent) - */ - public void messageLogged(BuildEvent event) { - logMessage(event.getMessage(), event.getPriority()); - } - - protected PrintStream getErrorPrintStream() { - return fErr; - } - - protected PrintStream getOutputPrintStream() { - return fOut; - } - - /** - * @see org.apache.tools.ant.BuildLogger#setErrorPrintStream(java.io.PrintStream) - */ - public void setErrorPrintStream(PrintStream err) { - //this build logger logs to "null" unless - //the user has explicitly set a logfile to use - if (err == System.err) { - fErr= null; - } else { - fErr= err; - } - } - - /** - * @see org.apache.tools.ant.BuildLogger#setOutputPrintStream(java.io.PrintStream) - */ - public void setOutputPrintStream(PrintStream output) { - //this build logger logs to "null" unless - //the user has explicitly set a logfile to use - if (output == System.out) { - fOut= null; - } else { - fOut= output; - } - } - - protected void logMessage(String message, int priority) { - if (priority > getMessageOutputLevel()) { - return; - } - - if (priority == Project.MSG_ERR) { - if (getErrorPrintStream() != null && getErrorPrintStream() != System.err) { - //user has designated to log to a logfile - getErrorPrintStream().println(message); - } - } else { - if (getOutputPrintStream() != null && getOutputPrintStream() != System.out) { - //user has designated to log to a logfile - getOutputPrintStream().println(message); - } - } - } - - protected void handleException(BuildEvent event) { - Throwable exception = event.getException(); - if (exception == null || exception == fHandledException - || exception instanceof OperationCanceledException - || exception instanceof AntSecurityException) { - return; - } - fHandledException= exception; - logMessage(MessageFormat.format(AntSupportMessages.getString("AntProcessBuildLogger.BUILD_FAILED__{0}_1"), //$NON-NLS-1$ - new String[] { exception.toString()}), - Project.MSG_ERR); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/console/TaskLineTracker.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/console/TaskLineTracker.java deleted file mode 100644 index 4aa7857b3..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/console/TaskLineTracker.java +++ /dev/null @@ -1,54 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.console; - - -import org.eclipse.debug.ui.console.IConsole; -import org.eclipse.debug.ui.console.IConsoleLineTracker; -import org.eclipse.jface.text.IRegion; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.*; - -/** - * Processes task hyperlinks as lines are appended to the console - */ -public class TaskLineTracker implements IConsoleLineTracker { - - private IConsole fConsole; - - /** - * Constructor for TaskLineTracker. - */ - public TaskLineTracker() { - super(); - } - - /** - * @see org.eclipse.debug.ui.console.IConsoleLineTracker#init(org.eclipse.debug.ui.console.IConsole) - */ - public void init(IConsole console) { - fConsole = console; - } - - /** - * @see org.eclipse.debug.ui.console.IConsoleLineTracker#lineAppended(org.eclipse.jface.text.IRegion) - */ - public void lineAppended(IRegion line) { - TaskLinkManager.processNewLine(fConsole, line); - } - - /** - * @see org.eclipse.debug.ui.console.IConsoleLineTracker#dispose() - */ - public void dispose() { - TaskLinkManager.dispose(fConsole.getProcess()); - fConsole = null; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntBuilderTabGroup.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntBuilderTabGroup.java deleted file mode 100644 index ff59b6525..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntBuilderTabGroup.java +++ /dev/null @@ -1,36 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.debug.ui.AbstractLaunchConfigurationTabGroup; -import org.eclipse.debug.ui.ILaunchConfigurationDialog; -import org.eclipse.debug.ui.ILaunchConfigurationTab; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsBuilderTab; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsRefreshTab; - -public class AntBuilderTabGroup extends AbstractLaunchConfigurationTabGroup { - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTabGroup#createTabs(org.eclipse.debug.ui.ILaunchConfigurationDialog, java.lang.String) - */ - public void createTabs(ILaunchConfigurationDialog dialog, String mode) { - ILaunchConfigurationTab[] tabs = new ILaunchConfigurationTab[] { - new AntMainTab(), - new ExternalToolsRefreshTab(), - new AntTargetsTab(), - new AntPropertiesTab(), - new ExternalToolsBuilderTab(), - }; - setTabs(tabs); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntClasspathTab.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntClasspathTab.java deleted file mode 100644 index 07c6339ff..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntClasspathTab.java +++ /dev/null @@ -1,223 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.net.URL; -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.core.runtime.CoreException; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; -import org.eclipse.debug.ui.AbstractLaunchConfigurationTab; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntClasspathBlock; -import org.eclipse.ui.externaltools.internal.ant.preferences.IAntBlockContainer; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -public class AntClasspathTab extends AbstractLaunchConfigurationTab implements IAntBlockContainer { - - private Button useDefaultButton; - private AntClasspathBlock antClasspathBlock= new AntClasspathBlock(); - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#createControl(org.eclipse.swt.widgets.Composite) - */ - public void createControl(Composite parent) { - Font font= parent.getFont(); - Composite top = new Composite(parent, SWT.NONE); - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - layout.marginHeight = 2; - layout.marginWidth = 2; - top.setLayout(layout); - top.setLayoutData(new GridData(GridData.FILL_BOTH)); - top.setFont(font); - - setControl(top); - WorkbenchHelp.setHelp(top, IExternalToolsHelpContextIds.EXTERNAL_TOOLS_LAUNCH_CONFIGURATION_DIALOG_ANT_CLASSPATH_TAB); - - createChangeClasspath(top); - antClasspathBlock.setContainer(this); - antClasspathBlock.createContents(top); - } - - private void createChangeClasspath(Composite top) { - Font font= top.getFont(); - Composite changeClasspath = new Composite(top, SWT.NONE); - changeClasspath.setLayoutData(new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL)); - GridLayout layout = new GridLayout(); - layout.marginHeight = 0; - layout.marginWidth = 0; - changeClasspath.setLayout(layout); - changeClasspath.setFont(font); - - useDefaultButton = new Button(changeClasspath, SWT.CHECK); - useDefaultButton.setFont(font); - useDefaultButton.setText(AntLaunchConfigurationMessages.getString("AntClasspathTab.Use_&global")); //$NON-NLS-1$ - useDefaultButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - toggleUseDefaultClasspath(); - updateLaunchConfigurationDialog(); - } - - }); - } - - private void toggleUseDefaultClasspath() { - boolean enable = !useDefaultButton.getSelection(); - antClasspathBlock.setEnabled(enable); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#setDefaults(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void setDefaults(ILaunchConfigurationWorkingCopy configuration) { - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#initializeFrom(org.eclipse.debug.core.ILaunchConfiguration) - */ - public void initializeFrom(ILaunchConfiguration configuration) { - String urlStrings= null; - try { - urlStrings = configuration.getAttribute(IExternalToolConstants.ATTR_ANT_CUSTOM_CLASSPATH, (String) null); - } catch (CoreException e) { - } - if (urlStrings == null) { - useDefaultButton.setSelection(true); - antClasspathBlock.setTablesEnabled(false); - antClasspathBlock.initializeAntHome(null); - } else { - String antHomeString= null; - try { - antHomeString= configuration.getAttribute(IExternalToolConstants.ATTR_ANT_HOME, (String)null); - } catch (CoreException e) { - } - antClasspathBlock.initializeAntHome(antHomeString); - useDefaultButton.setSelection(false); - - List userURLs= new ArrayList(); - List antURLs= new ArrayList(); - AntUtil.getCustomClasspaths(configuration, antURLs, userURLs); - antClasspathBlock.setUserTableInput(userURLs); - antClasspathBlock.setAntTableInput(antURLs); - antClasspathBlock.setTablesEnabled(true); - } - - toggleUseDefaultClasspath(); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#performApply(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void performApply(ILaunchConfigurationWorkingCopy configuration) { - if (useDefaultButton.getSelection()) { - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_CUSTOM_CLASSPATH, (String)null); - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_HOME, (String)null); - return; - } - List antUrls= antClasspathBlock.getAntURLs(); - List userUrls= antClasspathBlock.getUserURLs(); - StringBuffer urlString= new StringBuffer(); - Iterator antUrlsItr= antUrls.iterator(); - while (antUrlsItr.hasNext()) { - URL url = (URL) antUrlsItr.next(); - urlString.append(url.getFile()); - urlString.append(','); - } - if (userUrls.size() > 0) { - urlString.append('*'); - } - Iterator userUrlsItr= userUrls.iterator(); - while (userUrlsItr.hasNext()) { - URL url = (URL) userUrlsItr.next(); - urlString.append(url.getFile()); - urlString.append(','); - } - if (urlString.length() > 0) { - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_CUSTOM_CLASSPATH, urlString.substring(0, urlString.length() - 1)); - } else { - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_CUSTOM_CLASSPATH, (String)null); - } - - String antHomeText= antClasspathBlock.getAntHome(); - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_HOME, antHomeText); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#getName() - */ - public String getName() { - return AntLaunchConfigurationMessages.getString("AntClasspathTab.Classpath_6"); //$NON-NLS-1$ - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#getImage() - */ - public Image getImage() { - return antClasspathBlock.getClasspathImage(); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#isValid(org.eclipse.debug.core.ILaunchConfiguration) - */ - public boolean isValid(ILaunchConfiguration launchConfig) { - setErrorMessage(null); - setMessage(null); - if (antClasspathBlock.isAntHomeEnabled()) { - return antClasspathBlock.validateAntHome(); - } else { - return super.isValid(launchConfig); - } - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setMessage(java.lang.String) - */ - public void setMessage(String message) { - super.setMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setErrorMessage(java.lang.String) - */ - public void setErrorMessage(String message) { - super.setErrorMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#createPushButton(org.eclipse.swt.widgets.Composite, java.lang.String) - */ - public Button createPushButton(Composite parent, String buttonText) { - return super.createPushButton(parent, buttonText, null); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#update() - */ - public void update() { - updateLaunchConfigurationDialog(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntConsoleColorProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntConsoleColorProvider.java deleted file mode 100644 index 712c442cb..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntConsoleColorProvider.java +++ /dev/null @@ -1,60 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.debug.core.model.IProcess; -import org.eclipse.debug.ui.IDebugUIConstants; -import org.eclipse.debug.ui.console.ConsoleColorProvider; -import org.eclipse.debug.ui.console.IConsole; -import org.eclipse.swt.graphics.Color; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IPreferenceConstants; - - -public class AntConsoleColorProvider extends ConsoleColorProvider { - - /** - * @see org.eclipse.debug.internal.ui.views.console.IConsoleColorProvider#getColor(java.lang.String) - */ - public Color getColor(String streamIdentifer) { - if (streamIdentifer.equals(IDebugUIConstants.ID_STANDARD_OUTPUT_STREAM)) { - return ExternalToolsPlugin.getPreferenceColor(IPreferenceConstants.CONSOLE_INFO_RGB); - } - if (streamIdentifer.equals(IDebugUIConstants.ID_STANDARD_ERROR_STREAM)) { - return ExternalToolsPlugin.getPreferenceColor(IPreferenceConstants.CONSOLE_ERROR_RGB); - } - if (streamIdentifer.equals(AntStreamsProxy.ANT_DEBUG_STREAM)) { - return ExternalToolsPlugin.getPreferenceColor(IPreferenceConstants.CONSOLE_DEBUG_RGB); - } - if (streamIdentifer.equals(AntStreamsProxy.ANT_VERBOSE_STREAM)) { - return ExternalToolsPlugin.getPreferenceColor(IPreferenceConstants.CONSOLE_VERBOSE_RGB); - } - if (streamIdentifer.equals(AntStreamsProxy.ANT_WARNING_STREAM)) { - return ExternalToolsPlugin.getPreferenceColor(IPreferenceConstants.CONSOLE_WARNING_RGB); - } - return super.getColor(streamIdentifer); - } - - /** - * @see org.eclipse.debug.internal.ui.views.console.IConsoleColorProvider#connect(org.eclipse.debug.core.model.IProcess, org.eclipse.debug.internal.ui.views.console.IConsole) - */ - public void connect(IProcess process, IConsole console) { - AntStreamsProxy proxy = (AntStreamsProxy)process.getStreamsProxy(); - ((AntProcess)process).setConsole(console); - console.connect(proxy.getDebugStreamMonitor(), AntStreamsProxy.ANT_DEBUG_STREAM); - console.connect(proxy.getWarningStreamMonitor(), AntStreamsProxy.ANT_WARNING_STREAM); - console.connect(proxy.getVerboseStreamMonitor(), AntStreamsProxy.ANT_VERBOSE_STREAM); - super.connect(process, console); - } - -} - diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchConfigurationMessages.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchConfigurationMessages.java deleted file mode 100644 index 2c25a58c2..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchConfigurationMessages.java +++ /dev/null @@ -1,34 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntLaunchConfigurationMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntLaunchConfigurationMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = - ResourceBundle.getBundle(BUNDLE_NAME); - - private AntLaunchConfigurationMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchConfigurationMessages.properties b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchConfigurationMessages.properties deleted file mode 100644 index 5a1daec56..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchConfigurationMessages.properties +++ /dev/null @@ -1,55 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -AntLaunchDelegate.Launching_{0}_1=Launching {0} -AntLaunchDelegate.Running_{0}_2=Running {0} -AntLaunchDelegate.Build_In_Progress=Ant build {0} already in progress -AntLaunchDelegate.Failure=Failure of Background Ant Build - -AntLaunchShortcut.Unable=Unable to find an Ant file to run. -AntLaunchShortcut.An_exception_occurred_while_creating_a_default_Ant_launch_configuration_for_{0}_2=An exception occurred while creating a default Ant launch configuration for {0} -AntLaunchShortcut.An_exception_occurred_while_retrieving_Ant_launch_configurations._3=An exception occurred while retrieving Ant launch configurations. -AntLaunchShortcut.Ant_Configuration_Selection_4=Ant Configuration Selection -AntLaunchShortcut.Choose_an_ant_configuration_to_run_5=&Choose an Ant configuration to run: -AntLaunchShortcut.Ant_builds_only_support___run___mode._6=Ant builds only support \'run\' mode. -AntLaunchShortcut.Error_7=Error -AntLaunchShortcut.Build_Failed_2=Build Failed -AntLaunchShortcut.Exception_launching=An exception occurred while launching {0} - -AntPropertiesTab.&Properties__6=&Properties: -AntPropertiesTab.Property_f&iles__7=P&roperty files: -AntPropertiesTab.P&roperties_8=Properties -AntPropertiesTab.Error_reading_configuration_9=Error reading configuration - -AntTargetLabelProvider.default_target_1=default target - -AntClasspathTab.Use_&global=Use &global classpath as specified in the Ant runtime preferences -AntClasspathTab.Classpath_6=Classpath - -AntMainTab.&Select_a_build_file__1=&Select a buildfile: -AntMainTab.Base_&Directory__3=Base &Directory: -AntMainTab.Capture_&output_1=Capture &output - -AntTargetsTab.Check_targets_to_e&xecute__1=Check targets to e&xecute: -AntTargetsTab.0_out_of_0_selected_2=0 out of 0 selected -AntTargetsTab.Target_execution_order__3=Target execution order: -AntTargetsTab.&Order..._4=&Order... -AntTargetsTab.Name_5=Name -AntTargetsTab.Description_6=Description -AntTargetsTab.{0}_out_of_{1}_selected_7={0} out of {1} selected -AntTargetsTab.Tar&gets_14=Targets -AntTargetsTab.No_targets=No targets selected for build -AntTargetsTab.Error_reading_configuration_12=Error reading configuration - -TargetOrderDialog.Order_Targets_1=Order Targets -TargetOrderDialog.&Specify_target_execution_order__2=&Specify target execution order: -TargetOrderDialog.&Up_3=&Up -TargetOrderDialog.&Down_4=&Down diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchDelegate.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchDelegate.java deleted file mode 100644 index 3a3e8c4c4..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchDelegate.java +++ /dev/null @@ -1,261 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.io.File; -import java.net.URL; -import java.text.MessageFormat; -import java.util.HashMap; -import java.util.Iterator; -import java.util.Map; - -import org.eclipse.ant.core.AntRunner; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.IProgressMonitor; -import org.eclipse.core.runtime.IStatus; -import org.eclipse.core.runtime.Status; -import org.eclipse.debug.core.ILaunch; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.core.model.ILaunchConfigurationDelegate; -import org.eclipse.debug.core.model.IProcess; -import org.eclipse.jface.dialogs.ErrorDialog; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsUtil; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.program.launchConfigurations.BackgroundResourceRefresher; -import org.eclipse.ui.externaltools.internal.variable.ExpandVariableContext; - -/** - * Launch delegate for ant builds - */ -public class AntLaunchDelegate implements ILaunchConfigurationDelegate { - - private static final String ANT_LOGGER_CLASS = "org.eclipse.ui.externaltools.internal.ant.logger.AntProcessBuildLogger"; //$NON-NLS-1$ - private static final String NULL_LOGGER_CLASS = "org.eclipse.ui.externaltools.internal.ant.logger.NullBuildLogger"; //$NON-NLS-1$ - private static final String BASE_DIR_PREFIX = "-Dbasedir="; //$NON-NLS-1$ - private static final String INPUT_HANDLER_CLASS = "org.eclipse.ui.externaltools.internal.ant.inputhandler.AntInputHandler"; //$NON-NLS-1$ - - /** - * @see org.eclipse.debug.core.model.ILaunchConfigurationDelegate#launch(org.eclipse.debug.core.ILaunchConfiguration, java.lang.String, org.eclipse.debug.core.ILaunch, org.eclipse.core.runtime.IProgressMonitor) - */ - public void launch(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) throws CoreException { - if (monitor.isCanceled()) { - return; - } - - if (ExternalToolsUtil.isBackground(configuration)) { - monitor.beginTask(MessageFormat.format(AntLaunchConfigurationMessages.getString("AntLaunchDelegate.Launching_{0}_1"), new String[] {configuration.getName()}), 10); //$NON-NLS-1$ - } else { - monitor.beginTask(MessageFormat.format(AntLaunchConfigurationMessages.getString("AntLaunchDelegate.Running_{0}_2"), new String[] {configuration.getName()}), 100); //$NON-NLS-1$ - } - - // get variable context - ExpandVariableContext resourceContext = ExternalToolsUtil.getVariableContext(); - monitor.worked(1); - - if (monitor.isCanceled()) { - return; - } - - // resolve location - IPath location = ExternalToolsUtil.getLocation(configuration, resourceContext); - monitor.worked(1); - - if (monitor.isCanceled()) { - return; - } - - if (AntRunner.isBuildRunning()) { - IStatus status= new Status(IStatus.ERROR, IExternalToolConstants.PLUGIN_ID, 1, MessageFormat.format(AntLaunchConfigurationMessages.getString("AntLaunchDelegate.Build_In_Progress"), new String[]{location.toOSString()}), null); //$NON-NLS-1$ - throw new CoreException(status); - } - - // resolve working directory - IPath workingDirectory = ExternalToolsUtil.getWorkingDirectory(configuration, resourceContext); - String baseDir = null; - if (workingDirectory != null) { - baseDir = workingDirectory.toOSString(); - } - monitor.worked(1); - - if (monitor.isCanceled()) { - return; - } - - // link the process to its build logger via a timestamp - long timeStamp = System.currentTimeMillis(); - String idStamp = Long.toString(timeStamp); - String idProperty = "-D" + AntProcess.ATTR_ANT_PROCESS_ID + "=" + idStamp; //$NON-NLS-1$ //$NON-NLS-2$ - - // resolve arguments - String[] arguments = ExternalToolsUtil.getArguments(configuration, resourceContext); - int argLength = 1; // at least one user property - timestamp - if (arguments != null) { - argLength += arguments.length; - } - if (baseDir != null && baseDir.length() > 0) { - argLength++; - } - String[] runnerArgs = new String[argLength]; - if (arguments != null) { - System.arraycopy(arguments, 0, runnerArgs, 0, arguments.length); - } - if (baseDir != null && baseDir.length() > 0) { - runnerArgs[runnerArgs.length - 2] = BASE_DIR_PREFIX + baseDir; - } - runnerArgs[runnerArgs.length -1] = idProperty; - - Map userProperties= AntUtil.getProperties(configuration); - String[] propertyFiles= AntUtil.getPropertyFiles(configuration); - - final AntRunner runner = new AntRunner(); - runner.setBuildFileLocation(location.toOSString()); - if (ExternalToolsUtil.getCaptureOutput(configuration)) { - runner.addBuildLogger(ANT_LOGGER_CLASS); - } else { - runner.addBuildLogger(NULL_LOGGER_CLASS); - } - runner.setInputHandler(INPUT_HANDLER_CLASS); - runner.setArguments(runnerArgs); - if (userProperties != null) { - runner.addUserProperties(userProperties); - } - - if (propertyFiles != null) { - runner.setPropertyFiles(propertyFiles); - } - - String[] targets = AntUtil.getTargetsFromConfig(configuration); - if (targets != null) { - runner.setExecutionTargets(targets); - } - - URL[] customClasspath= AntUtil.getCustomClasspath(configuration); - if (customClasspath != null) { - runner.setCustomClasspath(customClasspath); - } - - String antHome= AntUtil.getAntHome(configuration); - if (antHome != null) { - runner.setAntHome(antHome); - } - - monitor.worked(1); - - if (monitor.isCanceled()) { - return; - } - - // link the process to its build logger via a timestamp - Map attributes = new HashMap(); - attributes.put(IProcess.ATTR_PROCESS_TYPE, IExternalToolConstants.ID_ANT_PROCESS_TYPE); - attributes.put(AntProcess.ATTR_ANT_PROCESS_ID, idStamp); - final AntProcess process = new AntProcess(location.toOSString(), launch, attributes); - - // create "fake" command line for the process - StringBuffer commandLine= generateCommandLine(location, arguments, userProperties, propertyFiles, targets, antHome); - process.setAttribute(IProcess.ATTR_CMDLINE, commandLine.toString()); - - if (ExternalToolsUtil.isBackground(configuration)) { - Runnable r = new Runnable() { - public void run() { - try { - runner.run(process); - } catch (final CoreException e) { - ExternalToolsPlugin.getStandardDisplay().asyncExec(new Runnable() { - public void run() { - ErrorDialog.openError(null, AntLaunchConfigurationMessages.getString("AntLaunchDelegate.Failure"), null, e.getStatus()); //$NON-NLS-1$ - } - }); - } - process.terminated(); - } - }; - Thread background = new Thread(r); - background.start(); - monitor.worked(1); - // refresh resources after process finishes - if (ExternalToolsUtil.getRefreshScope(configuration) != null) { - BackgroundResourceRefresher refresher = new BackgroundResourceRefresher(configuration, process, resourceContext); - refresher.startBackgroundRefresh(); - } - } else { - // execute the build - try { - runner.run(monitor); - } catch (CoreException e) { - process.terminated(); - throw e; - } - process.terminated(); - - // refresh resources - ExternalToolsUtil.refreshResources(configuration, resourceContext, monitor); - } - - monitor.done(); - } - - private StringBuffer generateCommandLine(IPath location, String[] arguments, Map userProperties, String[] propertyFiles, String[] targets, String antHome) { - StringBuffer commandLine= new StringBuffer(); - if (antHome != null) { - commandLine.append(antHome); - commandLine.append(File.separator); - } - commandLine.append("ant"); //$NON-NLS-1$ - - if (arguments != null) { - for (int i = 0; i < arguments.length; i++) { - String arg = arguments[i]; - commandLine.append(' '); - commandLine.append(arg); - } - } - if (propertyFiles != null) { - for (int i = 0; i < propertyFiles.length; i++) { - String path = propertyFiles[i]; - commandLine.append(" -propertyfile "); //$NON-NLS-1$ - commandLine.append(path); - } - } - if (userProperties != null) { - Iterator keys = userProperties.keySet().iterator(); - while (keys.hasNext()) { - String key = (String)keys.next(); - commandLine.append(" -D"); //$NON-NLS-1$ - commandLine.append(key); - commandLine.append('='); - String value = (String)userProperties.get(key); - commandLine.append(value); - } - } - - commandLine.append(" -inputhandler "); //$NON-NLS-1$ - commandLine.append(INPUT_HANDLER_CLASS); - - commandLine.append(" -logger "); //$NON-NLS-1$ - commandLine.append(ANT_LOGGER_CLASS); - - commandLine.append(" -buildfile "); //$NON-NLS-1$ - commandLine.append(location.toOSString()); - - if (targets != null) { - for (int i = 0; i < targets.length; i++) { - commandLine.append(" "); //$NON-NLS-1$ - commandLine.append(targets[i]); - } - } - return commandLine; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchShortcut.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchShortcut.java deleted file mode 100644 index 77fc05d28..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntLaunchShortcut.java +++ /dev/null @@ -1,340 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.text.MessageFormat; -import java.util.ArrayList; -import java.util.List; - -import org.eclipse.core.resources.IContainer; -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.IStatus; -import org.eclipse.core.runtime.Status; -import org.eclipse.debug.core.DebugPlugin; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.core.ILaunchConfigurationType; -import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; -import org.eclipse.debug.core.ILaunchManager; -import org.eclipse.debug.ui.CommonTab; -import org.eclipse.debug.ui.DebugUITools; -import org.eclipse.debug.ui.ILaunchShortcut; -import org.eclipse.jface.dialogs.ErrorDialog; -import org.eclipse.jface.preference.IPreferenceStore; -import org.eclipse.jface.viewers.ILabelProvider; -import org.eclipse.jface.viewers.ISelection; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.IEditorInput; -import org.eclipse.ui.IEditorPart; -import org.eclipse.ui.dialogs.ElementListSelectionDialog; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IPreferenceConstants; -import org.eclipse.ui.externaltools.internal.model.ToolUtil; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsUtil; -import org.eclipse.ui.externaltools.internal.variable.ExpandVariableContext; - -/** - * - */ -public class AntLaunchShortcut implements ILaunchShortcut { - - private boolean fShowDialog= false; - - /** - * Constructor for AntLaunchShortcut. - */ - public AntLaunchShortcut() { - super(); - } - - /** - * @see org.eclipse.debug.ui.ILaunchShortcut#launch(org.eclipse.jface.viewers.ISelection, java.lang.String) - */ - public void launch(ISelection selection, String mode) { - if (selection instanceof IStructuredSelection) { - IStructuredSelection structuredSelection = (IStructuredSelection)selection; - Object object = structuredSelection.getFirstElement(); - if (object instanceof IAdaptable) { - IResource resource = (IResource)((IAdaptable)object).getAdapter(IResource.class); - if (resource != null) { - launch(resource, mode); - return; - } - } - } - antFileNotFound(); - } - - /** - * Inform the user that an ant file was not found to run. - */ - private void antFileNotFound() { - reportError(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Unable"), null); //$NON-NLS-1$ - } - - /** - * Launch the given file in the specified mode. - * - * @param resource either a build file (*.xml file) to execute or a resource - * from whose location a build file should be searched for. If the given - * resource is a file that does not end in ".xml", a search will begin at - * the resource's enclosing folder. The given resource must be of type IFile - * or IContainer. - * @param mode the mode in which the build file should be executed - */ - protected void launch(IResource resource, String mode) { - if (!("xml".equalsIgnoreCase(resource.getFileExtension()))) { //$NON-NLS-1$ - if (resource.getType() == IResource.FILE) { - resource= resource.getParent(); - } - resource= findBuildFile((IContainer)resource); - } - if (resource != null) { - launch((IFile)resource, mode, null); - } else { - antFileNotFound(); - } - } - - /** - * Launch the given targets in the given build file. The targets are - * launched in the given mode. - * - * @param file the build file to launch - * @param mode the mode in which the build file should be executed - * @param targetAttribute the targets to launch, in the form of the launch - * configuration targets attribute. - */ - public void launch(IFile file, String mode, String targetAttribute) { - ILaunchConfiguration configuration= null; - if (verifyMode(mode)) { - List configurations = findExistingLaunchConfigurations(file); - if (configurations.isEmpty()) { - configuration = createDefaultLaunchConfiguration(file); - } else { - if (configurations.size() == 1) { - configuration= (ILaunchConfiguration)configurations.get(0); - } else { - configuration= chooseConfig(configurations); - if (configuration == null) { - // User cancelled selection - return; - } - } - } - } - - if (configuration != null) { - if (fShowDialog) { - IStatus status = new Status(IStatus.INFO, IExternalToolConstants.PLUGIN_ID, IExternalToolConstants.STATUS_INIT_RUN_ANT, "", null); //$NON-NLS-1$ - DebugUITools.openLaunchConfigurationDialog(ExternalToolsPlugin.getActiveWorkbenchWindow().getShell(), configuration, IExternalToolConstants.ID_EXTERNAL_TOOLS_LAUNCH_GROUP, status); - } else { - if (targetAttribute != null) { - String newName= DebugPlugin.getDefault().getLaunchManager().generateUniqueLaunchConfigurationNameFrom(configuration.getName()); - try { - configuration= configuration.copy(newName); - ((ILaunchConfigurationWorkingCopy) configuration).setAttribute(IExternalToolConstants.ATTR_ANT_TARGETS, targetAttribute); - } catch (CoreException exception) { - reportError(MessageFormat.format(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Exception_launching"), new String[] {file.getName()}), exception); //$NON-NLS-1$ - return; - } - } - DebugUITools.launch(configuration, mode); - } - return; - } - - antFileNotFound(); - } - - /** - * Walks the file hierarchy looking for a build file. - * Returns the first build file found that matches the - * search criteria. - */ - private IFile findBuildFile(IContainer parent) { - String[] names= getBuildFileNames(); - if (names == null) { - return null; - } - IResource file= null; - while (file == null || file.getType() != IFile.FILE) { - for (int i = 0; i < names.length; i++) { - String string = names[i]; - file= parent.findMember(string); - if (file != null && file.getType() == IFile.FILE) { - break; - } - } - parent = parent.getParent(); - if (parent == null) { - return null; - } - } - return (IFile)file; - } - - private String[] getBuildFileNames() { - IPreferenceStore prefs= ExternalToolsPlugin.getDefault().getPreferenceStore(); - String buildFileNames= prefs.getString(IPreferenceConstants.ANT_FIND_BUILD_FILE_NAMES); - if (buildFileNames.length() == 0) { - //the user has not specified any names to look for - return null; - } - return AntUtil.parseString(buildFileNames, ","); //$NON-NLS-1$ - } - - /** - * Creates and returns a default launch configuration for the given file. - * - * @param file - * @return default launch configuration - */ - public static ILaunchConfiguration createDefaultLaunchConfiguration(IFile file) { - ILaunchManager manager = DebugPlugin.getDefault().getLaunchManager(); - ILaunchConfigurationType type = manager.getLaunchConfigurationType(IExternalToolConstants.ID_ANT_LAUNCH_CONFIGURATION_TYPE); - StringBuffer buffer = new StringBuffer(file.getProject().getName()); - buffer.append(' '); - buffer.append(file.getName()); - String name = buffer.toString().trim(); - name= manager.generateUniqueLaunchConfigurationNameFrom(name); - try { - ILaunchConfigurationWorkingCopy workingCopy = type.newInstance(null, name); - StringBuffer buf = new StringBuffer(); - ToolUtil.buildVariableTag(IExternalToolConstants.VAR_WORKSPACE_LOC, file.getFullPath().toString(), buf); - workingCopy.setAttribute(IExternalToolConstants.ATTR_LOCATION, buf.toString()); - - // set default for common settings - CommonTab tab = new CommonTab(); - tab.setDefaults(workingCopy); - tab.dispose(); - - return workingCopy.doSave(); - } catch (CoreException e) { - reportError(MessageFormat.format(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.An_exception_occurred_while_creating_a_default_Ant_launch_configuration_for_{0}_2"), new String[]{file.toString()}), e); //$NON-NLS-1$ - } - return null; - } - - /** - * Returns a list of existing launch configuration for the given file. - * - * @param file - * @return list of launch configurations - */ - public static List findExistingLaunchConfigurations(IFile file) { - ILaunchManager manager = DebugPlugin.getDefault().getLaunchManager(); - ILaunchConfigurationType type = manager.getLaunchConfigurationType(IExternalToolConstants.ID_ANT_LAUNCH_CONFIGURATION_TYPE); - List validConfigs= new ArrayList(); - if (type != null) { - ILaunchConfiguration[] configs = null; - try { - configs = manager.getLaunchConfigurations(type); - } catch (CoreException e) { - reportError(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.An_exception_occurred_while_retrieving_Ant_launch_configurations._3"), e); //$NON-NLS-1$ - } - if (configs != null && configs.length > 0) { - IPath filePath = file.getLocation(); - ExpandVariableContext context = ExternalToolsUtil.getVariableContext(); - for (int i = 0; i < configs.length; i++) { - ILaunchConfiguration configuration = configs[i]; - IPath location; - try { - location = ExternalToolsUtil.getLocation(configuration, context); - if (filePath.equals(location)) { - validConfigs.add(configuration); - } - } catch (CoreException e) { - // error occurred in variable expand - ignore - } - } - } - } - return validConfigs; - } - - /** - * Prompts the user to choose from the list of given launch configurations - * and returns the config the user choose of <code>null</code> if the user - * pressed Cancel or if the given list is empty. - */ - public static ILaunchConfiguration chooseConfig(List configs) { - if (configs.isEmpty()) { - return null; - } - ILabelProvider labelProvider = DebugUITools.newDebugModelPresentation(); - ElementListSelectionDialog dialog= new ElementListSelectionDialog(Display.getDefault().getActiveShell(), labelProvider); - dialog.setElements((ILaunchConfiguration[]) configs.toArray(new ILaunchConfiguration[configs.size()])); - dialog.setTitle(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Ant_Configuration_Selection_4")); //$NON-NLS-1$ - dialog.setMessage(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Choose_an_ant_configuration_to_run_5")); //$NON-NLS-1$ - dialog.setMultipleSelection(false); - int result = dialog.open(); - labelProvider.dispose(); - if (result == ElementListSelectionDialog.OK) { - return (ILaunchConfiguration) dialog.getFirstResult(); - } - return null; - } - - /** - * Verifies the mode is supported - * - * @param mode - * @return boolean - */ - protected boolean verifyMode(String mode) { - if (!mode.equals(ILaunchManager.RUN_MODE)) { - reportError(AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Ant_builds_only_support___run___mode._6"), null); //$NON-NLS-1$ - return false; - } - return true; - } - - /** - * @see org.eclipse.debug.ui.ILaunchShortcut#launch(org.eclipse.ui.IEditorPart, java.lang.String) - */ - public void launch(IEditorPart editor, String mode) { - IEditorInput input = editor.getEditorInput(); - IFile file = (IFile)input.getAdapter(IFile.class); - if (file != null) { - launch(file, mode); - return; - } - antFileNotFound(); - } - - protected static void reportError(String message, Throwable throwable) { - IStatus status = null; - if (throwable instanceof CoreException) { - status = ((CoreException)throwable).getStatus(); - } else { - status = new Status(IStatus.ERROR, IExternalToolConstants.PLUGIN_ID, 0, message, throwable); - } - ErrorDialog.openError(ExternalToolsPlugin.getActiveWorkbenchWindow().getShell(), AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Error_7"), AntLaunchConfigurationMessages.getString("AntLaunchShortcut.Build_Failed_2"), status); //$NON-NLS-1$ //$NON-NLS-2$ - } - - /** - * Sets whether to show the external tools launch configuration dialog - * - * @param showDialog If true the launch configuration dialog will always be - * shown - */ - public void setShowDialog(boolean showDialog) { - fShowDialog = showDialog; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntMainTab.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntMainTab.java deleted file mode 100644 index cb6b003de..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntMainTab.java +++ /dev/null @@ -1,128 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; -import org.eclipse.swt.SWT; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsLaunchConfigurationMessages; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsMainTab; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.model.ToolUtil; -import org.eclipse.ui.externaltools.internal.ui.FileSelectionDialog; -import org.eclipse.ui.help.WorkbenchHelp; - -public class AntMainTab extends ExternalToolsMainTab { - - protected Button captureOutputButton; - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#initializeFrom(org.eclipse.debug.core.ILaunchConfiguration) - */ - public void initializeFrom(ILaunchConfiguration configuration) { - super.initializeFrom(configuration); - updateCaptureOutput(configuration); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#performApply(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void performApply(ILaunchConfigurationWorkingCopy configuration) { - super.performApply(configuration); - setAttribute(IExternalToolConstants.ATTR_CAPTURE_OUTPUT, configuration, captureOutputButton.getSelection(), true); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#createControl(org.eclipse.swt.widgets.Composite) - */ - public void createControl(Composite parent) { - Composite mainComposite = new Composite(parent, SWT.NONE); - setControl(mainComposite); - WorkbenchHelp.setHelp(mainComposite, IExternalToolsHelpContextIds.EXTERNAL_TOOLS_LAUNCH_CONFIGURATION_DIALOG_ANT_MAIN_TAB); - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - GridData gridData = new GridData(GridData.FILL_HORIZONTAL); - mainComposite.setLayout(layout); - mainComposite.setLayoutData(gridData); - mainComposite.setFont(parent.getFont()); - createLocationComponent(mainComposite); - createWorkDirectoryComponent(mainComposite); - createArgumentComponent(mainComposite); - createVerticalSpacer(mainComposite, 2); - createRunBackgroundComponent(mainComposite); - createCaptureOutputComponent(mainComposite); - } - - /** - * Creates the controls needed to edit the capture output attribute of an - * external tool - * - * @param parent the composite to create the controls in - */ - protected void createCaptureOutputComponent(Composite parent) { - captureOutputButton = new Button(parent, SWT.CHECK); - captureOutputButton.setText(AntLaunchConfigurationMessages.getString("AntMainTab.Capture_&output_1")); //$NON-NLS-1$ - GridData data = new GridData(GridData.HORIZONTAL_ALIGN_FILL); - data.horizontalSpan = 2; - captureOutputButton.setLayoutData(data); - captureOutputButton.setFont(parent.getFont()); - captureOutputButton.addSelectionListener(getSelectionAdapter()); - } - - protected void updateCaptureOutput(ILaunchConfiguration configuration) { - boolean captureOutput= true; - try { - captureOutput= configuration.getAttribute(IExternalToolConstants.ATTR_CAPTURE_OUTPUT, true); - } catch (CoreException ce) { - ExternalToolsPlugin.getDefault().log(ExternalToolsLaunchConfigurationMessages.getString("ExternalToolsMainTab.Error_reading_configuration_7"), ce); //$NON-NLS-1$ - } - captureOutputButton.setSelection(captureOutput); - } - - /** - * Prompts the user for a workspace location within the workspace and sets - * the location as a String containing the workspace_loc variable or - * <code>null</code> if no location was obtained from the user. - */ - protected void handleWorkspaceLocationButtonSelected() { - FileSelectionDialog dialog; - dialog = new FileSelectionDialog(getShell(), ResourcesPlugin.getWorkspace().getRoot(), AntLaunchConfigurationMessages.getString("AntMainTab.&Select_a_build_file__1")); //$NON-NLS-1$ - dialog.setFileFilter("*.xml", true); //$NON-NLS-1$ - dialog.open(); - IFile file = dialog.getResult(); - if (file == null) { - return; - } - StringBuffer buf = new StringBuffer(); - ToolUtil.buildVariableTag(IExternalToolConstants.VAR_WORKSPACE_LOC, file.getFullPath().toString(), buf); - String text= buf.toString(); - if (text != null) { - locationField.setText(text); - } - } - - /** - * @see org.eclipse.ui.externaltools.launchConfigurations.ExternalToolsMainTab#getWorkingDirectoryLabel() - */ - protected String getWorkingDirectoryLabel() { - return AntLaunchConfigurationMessages.getString("AntMainTab.Base_&Directory__3"); //$NON-NLS-1$ - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntProcess.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntProcess.java deleted file mode 100644 index 53d128e2b..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntProcess.java +++ /dev/null @@ -1,208 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.util.HashMap; -import java.util.Map; - -import org.eclipse.core.runtime.IProgressMonitor; -import org.eclipse.debug.core.DebugEvent; -import org.eclipse.debug.core.DebugException; -import org.eclipse.debug.core.DebugPlugin; -import org.eclipse.debug.core.ILaunch; -import org.eclipse.debug.core.model.IProcess; -import org.eclipse.debug.core.model.IStreamsProxy; -import org.eclipse.debug.ui.console.IConsole; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; - -/** - * - */ -public class AntProcess implements IProcess, IProgressMonitor { - - /** - * Process attribute with process identifier - links the ant process build - * logger to a process. - */ - public static final String ATTR_ANT_PROCESS_ID = IExternalToolConstants.PLUGIN_ID + ".ATTR_ANT_PROCESS_ID"; //$NON-NLS-1$ - - private AntStreamsProxy fProxy = new AntStreamsProxy(); - private String fLabel = null; - private ILaunch fLaunch = null; - private Map fAttributes = null; - private boolean fTerminated = false; - private boolean fCancelled = false; - private IConsole fConsole = null; - - public AntProcess(String label, ILaunch launch, Map attributes) { - fLabel = label; - fLaunch = launch; - if (attributes == null) { - fAttributes = new HashMap(); - } else { - fAttributes = attributes; - } - launch.addProcess(this); - } - - /** - * @see org.eclipse.debug.core.model.IProcess#getLabel() - */ - public String getLabel() { - return fLabel; - } - - /** - * @see org.eclipse.debug.core.model.IProcess#getLaunch() - */ - public ILaunch getLaunch() { - return fLaunch; - } - - /** - * @see org.eclipse.debug.core.model.IProcess#getStreamsProxy() - */ - public IStreamsProxy getStreamsProxy() { - return fProxy; - } - - /** - * @see org.eclipse.debug.core.model.IProcess#setAttribute(java.lang.String, java.lang.String) - */ - public void setAttribute(String key, String value) { - fAttributes.put(key, value); - } - - /** - * @see org.eclipse.debug.core.model.IProcess#getAttribute(java.lang.String) - */ - public String getAttribute(String key) { - return (String)fAttributes.get(key); - } - - /** - * @see org.eclipse.debug.core.model.IProcess#getExitValue() - */ - public int getExitValue() throws DebugException { - return 0; - } - - /** - * @see org.eclipse.core.runtime.IAdaptable#getAdapter(java.lang.Class) - */ - public Object getAdapter(Class adapter) { - return null; - } - - /** - * @see org.eclipse.debug.core.model.ITerminate#canTerminate() - */ - public boolean canTerminate() { - return !isCanceled() && !isTerminated(); - } - - /** - * @see org.eclipse.debug.core.model.ITerminate#isTerminated() - */ - public boolean isTerminated() { - return fTerminated; - } - - protected void terminated() { - if (!fTerminated) { - fTerminated = true; - if (DebugPlugin.getDefault() != null) { - DebugPlugin.getDefault().fireDebugEventSet(new DebugEvent[] {new DebugEvent(this, DebugEvent.TERMINATE)}); - } - } - } - - /** - * @see org.eclipse.debug.core.model.ITerminate#terminate() - */ - public void terminate() throws DebugException { - setCanceled(true); - } - - /** - * Returns the console associated with this process, or <code>null</code> if - * none. - * - * @return console, or <code>null</code> - */ - public IConsole getConsole() { - return fConsole; - } - - /** - * Sets the console associated with this process. - * - * @param console - */ - protected void setConsole(IConsole console) { - fConsole = console; - } - - // IProgressMontior implemented to support termination. - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#beginTask(java.lang.String, int) - */ - public void beginTask(String name, int totalWork) { - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#done() - */ - public void done() { - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#internalWorked(double) - */ - public void internalWorked(double work) { - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#isCanceled() - */ - public boolean isCanceled() { - return fCancelled; - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#setCanceled(boolean) - */ - public void setCanceled(boolean value) { - fCancelled = value; - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#setTaskName(java.lang.String) - */ - public void setTaskName(String name) { - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#subTask(java.lang.String) - */ - public void subTask(String name) { - } - - /** - * @see org.eclipse.core.runtime.IProgressMonitor#worked(int) - */ - public void worked(int work) { - } - -} - diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntPropertiesTab.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntPropertiesTab.java deleted file mode 100644 index ef4c28b10..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntPropertiesTab.java +++ /dev/null @@ -1,168 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.util.HashMap; -import java.util.Map; - -import org.eclipse.ant.core.Property; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; -import org.eclipse.debug.ui.AbstractLaunchConfigurationTab; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntPropertiesBlock; -import org.eclipse.ui.externaltools.internal.ant.preferences.IAntBlockContainer; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Tab for setting Ant user properties per launch configuration. All properties - * specified here will be set as user properties on the project for the - * specified Ant build - */ -public class AntPropertiesTab extends AbstractLaunchConfigurationTab implements IAntBlockContainer { - - private AntPropertiesBlock antPropertiesBlock= new AntPropertiesBlock(this); - - public void createControl(Composite parent) { - Composite top = new Composite(parent, SWT.NONE); - top.setFont(parent.getFont()); - setControl(top); - WorkbenchHelp.setHelp(getControl(), IExternalToolsHelpContextIds.EXTERNAL_TOOLS_LAUNCH_CONFIGURATION_DIALOG_ANT_PROPERTIES_TAB); - - GridLayout layout = new GridLayout(); - layout.numColumns= 2; - top.setLayout(layout); - GridData gridData = new GridData(GridData.FILL_HORIZONTAL); - top.setLayoutData(gridData); - antPropertiesBlock.createControl(top, AntLaunchConfigurationMessages.getString("AntPropertiesTab.&Properties__6"), AntLaunchConfigurationMessages.getString("AntPropertiesTab.Property_f&iles__7")); //$NON-NLS-1$ //$NON-NLS-2$ - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#getImage() - */ - public Image getImage() { - return ExternalToolsImages.getImage(IExternalToolConstants.IMG_PROPERTY); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#getName() - */ - public String getName() { - return AntLaunchConfigurationMessages.getString("AntPropertiesTab.P&roperties_8"); //$NON-NLS-1$ - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#initializeFrom(org.eclipse.debug.core.ILaunchConfiguration) - */ - public void initializeFrom(ILaunchConfiguration configuration) { - setErrorMessage(null); - setMessage(null); - Map properties= null; - try { - properties= configuration.getAttribute(IExternalToolConstants.ATTR_ANT_PROPERTIES, (Map)null); - } catch (CoreException ce) { - ExternalToolsPlugin.getDefault().log(AntLaunchConfigurationMessages.getString("AntPropertiesTab.Error_reading_configuration_9"), ce); //$NON-NLS-1$ - } - - String propertyFiles= null; - try { - propertyFiles= configuration.getAttribute(IExternalToolConstants.ATTR_ANT_PROPERTY_FILES, (String)null); - } catch (CoreException ce) { - ExternalToolsPlugin.getDefault().log(AntLaunchConfigurationMessages.getString("AntPropertiesTab.Error_reading_configuration_9"), ce); //$NON-NLS-1$ - } - - antPropertiesBlock.populatePropertyViewer(properties); - - String[] files= AntUtil.parseString(propertyFiles, ","); //$NON-NLS-1$ - antPropertiesBlock.setPropertyFilesInput(files); - - antPropertiesBlock.update(); - } - - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#performApply(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void performApply(ILaunchConfigurationWorkingCopy configuration) { - - Object[] items= antPropertiesBlock.getProperties(); - Map properties= null; - if (items.length > 0) { - properties= new HashMap(items.length); - for (int i = 0; i < items.length; i++) { - Property property = (Property)items[i]; - properties.put(property.getName(), property.getValue()); - } - } - - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_PROPERTIES, properties); - - items= antPropertiesBlock.getPropertyFiles(); - String files= null; - if (items.length > 0) { - StringBuffer buff= new StringBuffer(); - for (int i = 0; i < items.length; i++) { - String path = (String)items[i]; - buff.append(path); - buff.append(','); - } - files= buff.toString(); - } - - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_PROPERTY_FILES, files); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#setDefaults(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void setDefaults(ILaunchConfigurationWorkingCopy configuration) { - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setMessage(java.lang.String) - */ - public void setMessage(String message) { - super.setMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setErrorMessage(java.lang.String) - */ - public void setErrorMessage(String message) { - super.setErrorMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#createPushButton(org.eclipse.swt.widgets.Composite, java.lang.String) - */ - public Button createPushButton(Composite parent, String buttonText) { - return super.createPushButton(parent, buttonText, null); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#update() - */ - public void update() { - updateLaunchConfigurationDialog(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntRunActionDelegate.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntRunActionDelegate.java deleted file mode 100644 index f17d54ee5..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntRunActionDelegate.java +++ /dev/null @@ -1,62 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.core.resources.IFile; -import org.eclipse.debug.core.ILaunchManager; -import org.eclipse.jface.action.IAction; -import org.eclipse.jface.viewers.ISelection; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.ui.IObjectActionDelegate; -import org.eclipse.ui.IWorkbenchPart; -import org.eclipse.ui.actions.ActionDelegate; - -/** - * Action delegate to launch Ant on a build file. - */ -public class AntRunActionDelegate extends ActionDelegate implements IObjectActionDelegate { - private IFile selectedFile; - private IWorkbenchPart part; - - /* (non-Javadoc) - * Method declared on IActionDelegate. - */ - public void run(IAction action) { - if (part != null && selectedFile != null) { - AntLaunchShortcut shortcut = new AntLaunchShortcut(); - shortcut.setShowDialog(true); - shortcut.launch(selectedFile, ILaunchManager.RUN_MODE); - } - } - - /* (non-Javadoc) - * Method declared on IActionDelegate. - */ - public void selectionChanged(IAction action, ISelection selection) { - selectedFile = null; - if (selection instanceof IStructuredSelection) { - IStructuredSelection structuredSelection = (IStructuredSelection) selection; - if (structuredSelection.size() == 1) { - Object selectedResource = structuredSelection.getFirstElement(); - if (selectedResource instanceof IFile) - selectedFile = (IFile) selectedResource; - } - } - } - - /* (non-Javadoc) - * Method declared on IObjectActionDelegate. - */ - public void setActivePart(IAction action, IWorkbenchPart targetPart) { - this.part = targetPart; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntStreamMonitor.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntStreamMonitor.java deleted file mode 100644 index 92d672391..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntStreamMonitor.java +++ /dev/null @@ -1,85 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.debug.core.IStreamListener; -import org.eclipse.debug.core.model.IFlushableStreamMonitor; -import org.eclipse.debug.internal.core.ListenerList; - -/** - * Stream monitor implementation for an ant build process. - */ -public class AntStreamMonitor implements IFlushableStreamMonitor { - - private StringBuffer fContents = new StringBuffer(); - private ListenerList fListeners = new ListenerList(1); - private boolean fBuffered = true; - - /** - * @see org.eclipse.debug.core.model.IStreamMonitor#addListener(org.eclipse.debug.core.IStreamListener) - */ - public void addListener(IStreamListener listener) { - fListeners.add(listener); - } - - /** - * @see org.eclipse.debug.core.model.IStreamMonitor#getContents() - */ - public String getContents() { - return fContents.toString(); - } - - /** - * @see org.eclipse.debug.core.model.IStreamMonitor#removeListener(org.eclipse.debug.core.IStreamListener) - */ - public void removeListener(IStreamListener listener) { - fListeners.remove(listener); - } - - /** - * Appends the given message to this stream, and notifies listeners. - * - * @param message - */ - public void append(String message) { - if (isBuffered()) { - fContents.append(message); - } - Object[] listeners = fListeners.getListeners(); - for (int i = 0; i < listeners.length; i++) { - IStreamListener listener = (IStreamListener)listeners[i]; - listener.streamAppended(message, this); - } - } - /** - * @see org.eclipse.debug.core.model.IFlushableStreamMonitor#flushContents() - */ - public void flushContents() { - fContents.setLength(0); - } - - /** - * @see org.eclipse.debug.core.model.IFlushableStreamMonitor#isBuffered() - */ - public boolean isBuffered() { - return fBuffered; - } - - /** - * @see org.eclipse.debug.core.model.IFlushableStreamMonitor#setBuffered(boolean) - */ - public void setBuffered(boolean buffer) { - fBuffered = buffer; - } - -} - diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntStreamsProxy.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntStreamsProxy.java deleted file mode 100644 index 01e9a2bbe..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntStreamsProxy.java +++ /dev/null @@ -1,68 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.io.IOException; - -import org.eclipse.debug.core.model.IStreamMonitor; -import org.eclipse.debug.core.model.IStreamsProxy; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -; - -/** - * - */ -public class AntStreamsProxy implements IStreamsProxy { - - private AntStreamMonitor fErrorMonitor = new AntStreamMonitor(); - private AntStreamMonitor fOutputMonitor = new AntStreamMonitor(); - - public static final String ANT_DEBUG_STREAM = IExternalToolConstants.PLUGIN_ID + ".ANT_DEBUG_STREAM"; //$NON-NLS-1$ - public static final String ANT_VERBOSE_STREAM = IExternalToolConstants.PLUGIN_ID + ".ANT_VERBOSE_STREAM"; //$NON-NLS-1$ - public static final String ANT_WARNING_STREAM = IExternalToolConstants.PLUGIN_ID + ".ANT_WARNING_STREAM"; //$NON-NLS-1$ - - private AntStreamMonitor fDebugMonitor = new AntStreamMonitor(); - private AntStreamMonitor fVerboseMonitor = new AntStreamMonitor(); - private AntStreamMonitor fWarningMonitor = new AntStreamMonitor(); - - /** - * @see org.eclipse.debug.core.model.IStreamsProxy#getErrorStreamMonitor() - */ - public IStreamMonitor getErrorStreamMonitor() { - return fErrorMonitor; - } - - /** - * @see org.eclipse.debug.core.model.IStreamsProxy#getOutputStreamMonitor() - */ - public IStreamMonitor getOutputStreamMonitor() { - return fOutputMonitor; - } - - /** - * @see org.eclipse.debug.core.model.IStreamsProxy#write(java.lang.String) - */ - public void write(String input) throws IOException { - } - - public IStreamMonitor getWarningStreamMonitor() { - return fWarningMonitor; - } - - public IStreamMonitor getDebugStreamMonitor() { - return fDebugMonitor; - } - - public IStreamMonitor getVerboseStreamMonitor() { - return fVerboseMonitor; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTabGroup.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTabGroup.java deleted file mode 100644 index 7e820905a..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTabGroup.java +++ /dev/null @@ -1,75 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.IResource; -import org.eclipse.debug.core.DebugPlugin; -import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; -import org.eclipse.debug.ui.AbstractLaunchConfigurationTabGroup; -import org.eclipse.debug.ui.CommonTab; -import org.eclipse.debug.ui.ILaunchConfigurationDialog; -import org.eclipse.debug.ui.ILaunchConfigurationTab; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.ToolUtil; -import org.eclipse.ui.externaltools.internal.model.VariableContextManager; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsRefreshTab; -import org.eclipse.ui.externaltools.internal.variable.ExpandVariableContext; - - -public class AntTabGroup extends AbstractLaunchConfigurationTabGroup { - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTabGroup#createTabs(org.eclipse.debug.ui.ILaunchConfigurationDialog, java.lang.String) - */ - public void createTabs(ILaunchConfigurationDialog dialog, String mode) { - ILaunchConfigurationTab[] tabs = new ILaunchConfigurationTab[] { - new AntMainTab(), - new ExternalToolsRefreshTab(), - new AntTargetsTab(), - new AntClasspathTab(), - new AntPropertiesTab(), - new CommonTab() - }; - setTabs(tabs); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTabGroup#setDefaults(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void setDefaults(ILaunchConfigurationWorkingCopy configuration) { - super.setDefaults(configuration); - // set default name for script - VariableContextManager manager = VariableContextManager.getDefault(); - ExpandVariableContext context = manager.getVariableContext(); - IResource resource = context.getSelectedResource(); - if (resource != null && resource instanceof IFile) { - IFile file = (IFile)resource; - String extension = file.getFileExtension(); - if (extension != null && extension.equalsIgnoreCase("xml")) { //$NON-NLS-1$ - StringBuffer buffer = new StringBuffer(file.getProject().getName()); - buffer.append(" "); //$NON-NLS-1$ - buffer.append(file.getName()); - String name = buffer.toString().trim(); - name= DebugPlugin.getDefault().getLaunchManager().generateUniqueLaunchConfigurationNameFrom(name); - configuration.rename(name); - - StringBuffer buf = new StringBuffer(); - ToolUtil.buildVariableTag(IExternalToolConstants.VAR_WORKSPACE_LOC, file.getFullPath().toString(), buf); - String text= buf.toString(); - if (text != null) { - configuration.setAttribute(IExternalToolConstants.ATTR_LOCATION, text); - } - } - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTargetContentProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTargetContentProvider.java deleted file mode 100644 index 848f8c2b7..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTargetContentProvider.java +++ /dev/null @@ -1,98 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.util.ArrayList; -import java.util.Arrays; -import java.util.List; - -import org.eclipse.jface.viewers.IStructuredContentProvider; -import org.eclipse.jface.viewers.TableViewer; -import org.eclipse.jface.viewers.Viewer; - -public class AntTargetContentProvider implements IStructuredContentProvider { - - protected List elements = new ArrayList(); - protected TableViewer viewer; - - public void add(Object o) { - elements.add(o); - viewer.add(o); - } - - public void addAll(List list) { - elements.addAll(list); - viewer.add(list.toArray()); - } - - public void dispose() { - } - - public Object[] getElements(Object inputElement) { - if (elements.isEmpty()) { - return new Object[0]; - } else { - return (Object[]) elements.toArray(new Object[elements.size()]); - } - } - - public void inputChanged(Viewer viewer, Object oldInput, Object newInput) { - this.viewer = (TableViewer) viewer; - elements.clear(); - if (newInput != null && ((Object[]) newInput).length != 0) { - elements.addAll(Arrays.asList((Object[]) newInput)); - } - } - - /** - * Removes the given target from the list of targets. Has no effect if the - * given target does not exist in the list. - * - * @param target the target to remove - */ - public void removeTarget(Object target) { - elements.remove(target); - viewer.remove(target); - } - - /** - * Moves the given target up in the list of active targets. Has no effect if - * the given target is already the first target in the list or the given - * index is invalid. - * - * @param index the index of the target to move up - */ - public void moveUpTarget(int index) { - Object target = elements.get(index); - if (index == 0 || target == null) { - return; - } - elements.set(index, elements.get(index - 1)); - elements.set(index - 1, target); - } - - /** - * Moves the given target down in the list of active targets. Has no effect - * if the given target is already the last target in the list or the given - * index is invalid. - * - * @param index the index of the target to move down - */ - public void moveDownTarget(int index) { - Object target = elements.get(index); - if (index == elements.size() - 1 || target == null) { - return; - } - elements.set(index, elements.get(index + 1)); - elements.set(index + 1, target); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTargetsTab.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTargetsTab.java deleted file mode 100644 index 538fb74fb..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/AntTargetsTab.java +++ /dev/null @@ -1,411 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.text.MessageFormat; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Comparator; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.ant.core.TargetInfo; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.MultiStatus; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; -import org.eclipse.debug.ui.AbstractLaunchConfigurationTab; -import org.eclipse.jface.dialogs.Dialog; -import org.eclipse.jface.dialogs.IDialogConstants; -import org.eclipse.jface.viewers.CheckStateChangedEvent; -import org.eclipse.jface.viewers.CheckboxTableViewer; -import org.eclipse.jface.viewers.ColumnWeightData; -import org.eclipse.jface.viewers.DoubleClickEvent; -import org.eclipse.jface.viewers.ICheckStateListener; -import org.eclipse.jface.viewers.IDoubleClickListener; -import org.eclipse.jface.viewers.ISelection; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.TableLayout; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Table; -import org.eclipse.swt.widgets.TableColumn; -import org.eclipse.swt.widgets.Text; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.launchConfigurations.ExternalToolsUtil; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.model.ToolUtil; -import org.eclipse.ui.externaltools.internal.variable.ExpandVariableContext; -import org.eclipse.ui.help.WorkbenchHelp; - -public class AntTargetsTab extends AbstractLaunchConfigurationTab { - - private TargetInfo fDefaultTarget = null; - private TargetInfo[] fAllTargets= null; - private List fOrderedTargets = null; - - private String fLocation= null; - - private CheckboxTableViewer fTableViewer = null; - private Label fSelectionCountLabel = null; - private Text fTargetOrderText = null; - private Button fOrderButton = null; - - private ILaunchConfiguration fLaunchConfiguration; - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#createControl(org.eclipse.swt.widgets.Composite) - */ - public void createControl(Composite parent) { - Font font = parent.getFont(); - - Composite comp = new Composite(parent, SWT.NONE); - setControl(comp); - WorkbenchHelp.setHelp(getControl(), IExternalToolsHelpContextIds.EXTERNAL_TOOLS_LAUNCH_CONFIGURATION_DIALOG_ANT_TARGETS_TAB); - - GridLayout topLayout = new GridLayout(); - comp.setLayout(topLayout); - GridData gd = new GridData(GridData.FILL_BOTH); - comp.setLayoutData(gd); - comp.setFont(font); - - Label label = new Label(comp, SWT.NONE); - label.setFont(font); - label.setText(AntLaunchConfigurationMessages.getString("AntTargetsTab.Check_targets_to_e&xecute__1")); //$NON-NLS-1$ - - createTargetsTable(comp); - - fSelectionCountLabel = new Label(comp, SWT.NONE); - fSelectionCountLabel.setFont(font); - fSelectionCountLabel.setText(AntLaunchConfigurationMessages.getString("AntTargetsTab.0_out_of_0_selected_2")); //$NON-NLS-1$ - gd = new GridData(GridData.FILL_HORIZONTAL); - fSelectionCountLabel.setLayoutData(gd); - - // spacer - label = new Label(comp, SWT.NONE); - label.setFont(font); - - label = new Label(comp, SWT.NONE); - label.setText(AntLaunchConfigurationMessages.getString("AntTargetsTab.Target_execution_order__3")); //$NON-NLS-1$ - label.setFont(font); - - Composite orderComposite = new Composite(comp, SWT.NONE); - gd = new GridData(GridData.FILL_HORIZONTAL); - orderComposite.setLayoutData(gd); - GridLayout layout = new GridLayout(2, false); - layout.marginHeight = 0; - layout.marginWidth = 0; - orderComposite.setLayout(layout); - orderComposite.setFont(font); - - fTargetOrderText = new Text(orderComposite, SWT.MULTI | SWT.WRAP | SWT.BORDER | SWT.V_SCROLL | SWT.READ_ONLY); - fTargetOrderText.setFont(font); - gd = new GridData(GridData.FILL_HORIZONTAL); - gd.heightHint = 40; - gd.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - fTargetOrderText.setLayoutData(gd); - - fOrderButton = createPushButton(orderComposite, AntLaunchConfigurationMessages.getString("AntTargetsTab.&Order..._4"), null); //$NON-NLS-1$ - gd = (GridData)fOrderButton.getLayoutData(); - gd.verticalAlignment = GridData.BEGINNING; - fOrderButton.setFont(font); - fOrderButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - handleOrderPressed(); - } - }); - } - - private void handleOrderPressed() { - TargetOrderDialog dialog = new TargetOrderDialog(getShell(), fOrderedTargets.toArray()); - int ok = dialog.open(); - if (ok == Dialog.OK) { - fOrderedTargets.clear(); - Object[] targets = dialog.getTargets(); - for (int i = 0; i < targets.length; i++) { - fOrderedTargets.add(targets[i]); - updateSelectionCount(); - updateLaunchConfigurationDialog(); - } - } - } - - private void createTargetsTable(Composite parent) { - Table table= new Table(parent, SWT.CHECK | SWT.BORDER | SWT.FULL_SELECTION | SWT.RESIZE); - - GridData data= new GridData(GridData.FILL_BOTH); - data.heightHint = 200; - data.widthHint = 250; - table.setLayoutData(data); - table.setFont(parent.getFont()); - - table.setHeaderVisible(true); - table.setLinesVisible(true); - - TableLayout tableLayout= new TableLayout(); - ColumnWeightData weightData = new ColumnWeightData(40, true); - tableLayout.addColumnData(weightData); - weightData = new ColumnWeightData(60, true); - tableLayout.addColumnData(weightData); - table.setLayout(tableLayout); - - TableColumn column1= new TableColumn(table, SWT.NULL); - column1.setText(AntLaunchConfigurationMessages.getString("AntTargetsTab.Name_5")); //$NON-NLS-1$ - - TableColumn column2= new TableColumn(table, SWT.NULL); - column2.setText(AntLaunchConfigurationMessages.getString("AntTargetsTab.Description_6")); //$NON-NLS-1$ - - fTableViewer = new CheckboxTableViewer(table); - fTableViewer.setLabelProvider(new TargetTableLabelProvider()); - fTableViewer.setContentProvider(new AntTargetContentProvider()); - - fTableViewer.addDoubleClickListener(new IDoubleClickListener() { - public void doubleClick(DoubleClickEvent event) { - ISelection selection= event.getSelection(); - if (selection instanceof IStructuredSelection) { - IStructuredSelection ss= (IStructuredSelection)selection; - Object element= ss.getFirstElement(); - boolean checked= !fTableViewer.getChecked(element); - fTableViewer.setChecked(element, checked); - updateOrderedTargets(element , checked); - } - } - }); - - fTableViewer.addCheckStateListener(new ICheckStateListener() { - public void checkStateChanged(CheckStateChangedEvent event) { - updateOrderedTargets(event.getElement(), event.getChecked()); - } - }); - } - - private void updateOrderedTargets(Object element , boolean checked) { - if (checked) { - fOrderedTargets.add(element); - } else { - fOrderedTargets.remove(element); - } - updateSelectionCount(); - updateLaunchConfigurationDialog(); - } - - private void updateSelectionCount() { - Object[] checked = fTableViewer.getCheckedElements(); - String numSelected = Integer.toString(checked.length); - int length= 0; - if (fAllTargets != null) { - length= fAllTargets.length; - } - String total = Integer.toString(length); - fSelectionCountLabel.setText(MessageFormat.format(AntLaunchConfigurationMessages.getString("AntTargetsTab.{0}_out_of_{1}_selected_7"), new String[]{numSelected, total})); //$NON-NLS-1$ - - fOrderButton.setEnabled(checked.length > 1); - - StringBuffer buffer = new StringBuffer(); - Iterator iter = fOrderedTargets.iterator(); - while (iter.hasNext()) { - buffer.append(((TargetInfo)iter.next()).getName()); - buffer.append(", "); //$NON-NLS-1$ - } - if (buffer.length() > 2) { - // remove trailing comma - buffer.setLength(buffer.length() - 2); - } - fTargetOrderText.setText(buffer.toString()); - } - - private TargetInfo[] getTargets() { - if (fAllTargets == null) { - setErrorMessage(null); - MultiStatus status = new MultiStatus(IExternalToolConstants.PLUGIN_ID, 0, "", null); //$NON-NLS-1$ - String expandedLocation = ToolUtil.expandFileLocation(fLocation, ExpandVariableContext.EMPTY_CONTEXT, status); - if (expandedLocation != null && status.isOK()) { - try { - String[] arguments = ExternalToolsUtil.getArguments(fLaunchConfiguration, ExpandVariableContext.EMPTY_CONTEXT); - fAllTargets = AntUtil.getTargets(expandedLocation, arguments, fLaunchConfiguration); - } catch (CoreException ce) { - setErrorMessage(ce.getMessage()); - fAllTargets= null; - return fAllTargets; - } - for (int i=0; i < fAllTargets.length; i++) { - if (fAllTargets[i].isDefault()) { - fDefaultTarget = fAllTargets[i]; - break; - } - } - } - - if (fAllTargets != null) { - Arrays.sort(fAllTargets, new Comparator() { - public int compare(Object o1, Object o2) { - TargetInfo t1= (TargetInfo)o1; - TargetInfo t2= (TargetInfo)o2; - return t1.getName().compareToIgnoreCase(t2.getName()); - } - public boolean equals(Object obj) { - return false; - } - }); - } - } - return fAllTargets; - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#setDefaults(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void setDefaults(ILaunchConfigurationWorkingCopy configuration) { - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#initializeFrom(org.eclipse.debug.core.ILaunchConfiguration) - */ - public void initializeFrom(ILaunchConfiguration configuration) { - fLaunchConfiguration= configuration; - setErrorMessage(null); - setMessage(null); - String configTargets= null; - String newLocation= null; - fOrderedTargets = new ArrayList(); - try { - configTargets= configuration.getAttribute(IExternalToolConstants.ATTR_ANT_TARGETS, (String)null); - newLocation= configuration.getAttribute(IExternalToolConstants.ATTR_LOCATION, (String)null); - } catch (CoreException ce) { - ExternalToolsPlugin.getDefault().log(AntLaunchConfigurationMessages.getString("AntTargetsTab.Error_reading_configuration_12"), ce); //$NON-NLS-1$ - } - - if (newLocation == null) { - fAllTargets= null; - fLocation= newLocation; - setExecuteInput(new TargetInfo[0]); - fTableViewer.setInput(new TargetInfo[0]); - return; - } - - if (!newLocation.equals(fLocation)) { - fAllTargets= null; - fLocation= newLocation; - } - - TargetInfo[] allInfos= getTargets(); - if (allInfos == null) { - setExecuteInput(new TargetInfo[0]); - fTableViewer.setInput(new TargetInfo[0]); - return; - } - - String[] targetNames= AntUtil.parseRunTargets(configTargets); - if (targetNames.length == 0) { - fOrderedTargets.add(fDefaultTarget); - fTableViewer.setAllChecked(false); - setExecuteInput(allInfos); - if (fDefaultTarget != null) { - fTableViewer.setChecked(fDefaultTarget, true); - } - updateSelectionCount(); - return; - } - - setExecuteInput(allInfos); - fTableViewer.setAllChecked(false); - for (int i = 0; i < targetNames.length; i++) { - for (int j = 0; j < fAllTargets.length; j++) { - if (targetNames[i].equals(fAllTargets[j].getName())) { - fOrderedTargets.add(fAllTargets[j]); - fTableViewer.setChecked(fAllTargets[j], true); - } - } - } - updateSelectionCount(); - } - - /** - * Sets the execute table's input to the given input. - */ - private void setExecuteInput(Object input) { - fTableViewer.setInput(input); - updateSelectionCount(); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#performApply(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy) - */ - public void performApply(ILaunchConfigurationWorkingCopy configuration) { - if (fOrderedTargets.size() == 1) { - TargetInfo item = (TargetInfo)fOrderedTargets.get(0); - if (item.isDefault()) { - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_TARGETS, (String)null); - return; - } - } else if (fOrderedTargets.size() == 0) { - return; - } - - StringBuffer buff= new StringBuffer(); - Iterator iter = fOrderedTargets.iterator(); - String targets = null; - while (iter.hasNext()) { - TargetInfo item = (TargetInfo)iter.next(); - buff.append(item.getName()); - buff.append(','); - } - if (buff.length() > 0) { - targets= buff.toString(); - } - - configuration.setAttribute(IExternalToolConstants.ATTR_ANT_TARGETS, targets); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#getName() - */ - public String getName() { - return AntLaunchConfigurationMessages.getString("AntTargetsTab.Tar&gets_14"); //$NON-NLS-1$ - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#getImage() - */ - public Image getImage() { - return ExternalToolsImages.getImage(IExternalToolConstants.IMG_TAB_ANT_TARGETS); - } - - /** - * @see org.eclipse.debug.ui.ILaunchConfigurationTab#isValid(org.eclipse.debug.core.ILaunchConfiguration) - */ - public boolean isValid(ILaunchConfiguration launchConfig) { - if (fAllTargets == null && getErrorMessage() != null) { - //error in parsing; - return false; - } - setErrorMessage(null); - setMessage(null); - - if (fAllTargets != null && fTableViewer.getCheckedElements().length == 0) { - setErrorMessage(AntLaunchConfigurationMessages.getString("AntTargetsTab.No_targets")); //$NON-NLS-1$ - return false; - } - return super.isValid(launchConfig); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/JavacLineTracker.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/JavacLineTracker.java deleted file mode 100644 index 483a5d3c2..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/JavacLineTracker.java +++ /dev/null @@ -1,152 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.Path; -import org.eclipse.debug.ui.console.FileLink; -import org.eclipse.debug.ui.console.IConsole; -import org.eclipse.debug.ui.console.IConsoleLineTracker; -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.IRegion; -import org.eclipse.ui.externaltools.internal.model.StringMatcher; - -/** - * Generates hyperlinks for javac output - */ -public class JavacLineTracker implements IConsoleLineTracker { - - private IConsole fConsole; - private IFile fLastFile; - private StringMatcher fEclipseCompilerMatcher; - private StringMatcher fJavacMatcher; - private StringMatcher fJikesMatcher; - - // trolling for errors after a Jikes error header was found - private boolean fTrolling = false; - - /** - * Constructor for JavacLineTracker. - */ - public JavacLineTracker() { - super(); - } - - /** - * @see org.eclipse.debug.ui.console.IConsoleLineTracker#init(org.eclipse.debug.ui.console.IConsole) - */ - public void init(IConsole console) { - fConsole = console; - fEclipseCompilerMatcher = new StringMatcher("*[javac]*ERROR in*.java*(at line*)*",false, false); //$NON-NLS-1$ - fJavacMatcher = new StringMatcher("*[javac] *.java:*:*",false, false); //$NON-NLS-1$ - fJikesMatcher = new StringMatcher("*[javac] *\"*.java\":", false, false); //$NON-NLS-1$ - } - - /** - * @see org.eclipse.debug.ui.console.IConsoleLineTracker#lineAppended(org.eclipse.jface.text.IRegion) - */ - public void lineAppended(IRegion line) { - try { - int lineOffset = line.getOffset(); - int lineLength = line.getLength(); - String text = fConsole.getDocument().get(lineOffset, lineLength); - String fileName = null; - String lineNumber = ""; //$NON-NLS-1$ - int fileStart = -1; - if (fEclipseCompilerMatcher.match(text)) { - fTrolling = false; - int index = text.indexOf("ERROR in"); //$NON-NLS-1$ - if (index > 0) { - fileStart = index + 9; - index = text.lastIndexOf("(at line "); //$NON-NLS-1$ - if (index > 0) { - int fileEnd = index - 1; - int numberStart = index + 9; - index = text.lastIndexOf(')'); - if (index > 0) { - int numberEnd = index; - fileName = text.substring(fileStart, fileEnd).trim(); - lineNumber = text.substring(numberStart, numberEnd).trim(); - } - } - } - } else if (fJavacMatcher.match(text)) { - fTrolling = false; - fileStart = text.indexOf("[javac] "); //$NON-NLS-1$ - fileStart += 8; - int index = text.indexOf(".java:", fileStart); //$NON-NLS-1$ - if (index > 0) { - int numberStart = index + 6; - fileName = text.substring(fileStart, numberStart - 1).trim(); - index = text.indexOf(":", numberStart); //$NON-NLS-1$ - if (index > numberStart) { - lineNumber = text.substring(numberStart, index); - } - } - } else if (fJikesMatcher.match(text)) { - fileStart = text.indexOf('"'); - fileStart++; - int index = text.indexOf(".java\"", fileStart); //$NON-NLS-1$ - if (index > 0) { - index += 5; - fileName = text.substring(fileStart, index).trim(); - fTrolling = true; - } - } else if (fTrolling) { - int index = text.indexOf("[javac]"); //$NON-NLS-1$ - if (index > 0) { - // look for a line number - index+=7; - int numEnd = text.indexOf(".", index); //$NON-NLS-1$ - if (numEnd > 0) { - String number = text.substring(index, numEnd).trim(); - try { - int num = Integer.parseInt(number); - int numStart = text.indexOf(number, index); - if (fLastFile != null && fLastFile.exists()) { - FileLink link = new FileLink(fLastFile, null, -1, -1, num); - fConsole.addLink(link, lineOffset + numStart, lineLength - numStart); - } - } catch (NumberFormatException e) { - // not a line number - } - } - } else { - fTrolling = false; - } - } - if (fileName != null) { - int num = -1; - try { - num = Integer.parseInt(lineNumber); - } catch (NumberFormatException e) { - } - IFile file = ResourcesPlugin.getWorkspace().getRoot().getFileForLocation(new Path(fileName)); - fLastFile = file; - if (file != null && file.exists()) { - FileLink link = new FileLink(file, null, -1, -1, num); - fConsole.addLink(link, lineOffset + fileStart, lineLength - fileStart); - } - } - } catch (BadLocationException e) { - } - } - - /** - * @see org.eclipse.debug.ui.console.IConsoleLineTracker#dispose() - */ - public void dispose() { - fConsole = null; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/RunAntStatusHandler.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/RunAntStatusHandler.java deleted file mode 100644 index ce28c28bd..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/RunAntStatusHandler.java +++ /dev/null @@ -1,34 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IStatus; -import org.eclipse.debug.core.IStatusHandler; -import org.eclipse.debug.ui.ILaunchConfigurationDialog; - -/** - * Status handler called when the launch dialog is opened via the "Run Ant..." - * action. This allows us to set the initial tab. - */ -public class RunAntStatusHandler implements IStatusHandler { - - /** - * @see org.eclipse.debug.core.IStatusHandler#handleStatus(org.eclipse.core.runtime.IStatus, java.lang.Object) - */ - public Object handleStatus(IStatus status, Object source) throws CoreException { - ILaunchConfigurationDialog dialog = (ILaunchConfigurationDialog)source; - dialog.setActiveTab(2); - return null; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TargetOrderDialog.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TargetOrderDialog.java deleted file mode 100644 index 867ef4490..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TargetOrderDialog.java +++ /dev/null @@ -1,201 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import org.eclipse.jface.dialogs.Dialog; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.jface.viewers.TableViewer; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Shell; -import org.eclipse.swt.widgets.Table; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Dialog to specify target execution order - */ -public class TargetOrderDialog extends Dialog implements ISelectionChangedListener { - - private Button fUp; - private Button fDown; - private TableViewer fViewer; - private AntTargetContentProvider fContentProvider; - private Object[] fTargets; - - /** - * Constructs the dialog. - * - * @param parentShell - */ - public TargetOrderDialog(Shell parentShell, Object[] targets) { - super(parentShell); - fTargets = targets; - } - - /* (non-Javadoc) - * @see org.eclipse.jface.dialogs.Dialog#createDialogArea(org.eclipse.swt.widgets.Composite) - */ - protected Control createDialogArea(Composite parent) { - getShell().setText(AntLaunchConfigurationMessages.getString("TargetOrderDialog.Order_Targets_1")); //$NON-NLS-1$ - - Composite comp = new Composite(parent, SWT.NONE); - GridLayout layout = new GridLayout(2, false); - comp.setLayout(layout); - GridData gd = new GridData(GridData.FILL_BOTH); - comp.setLayoutData(gd); - - Label label = new Label(comp, SWT.NONE); - label.setText(AntLaunchConfigurationMessages.getString("TargetOrderDialog.&Specify_target_execution_order__2")); //$NON-NLS-1$ - label.setFont(comp.getFont()); - gd = new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalSpan = 2; - label.setLayoutData(gd); - - createTargetList(comp); - - createButtons(comp); - - updateButtons(); - - return comp; - } - - /** - * Create button area & buttons - * - * @param comp - */ - private void createButtons(Composite parent) { - Composite comp = new Composite(parent, SWT.NONE); - GridLayout layout = new GridLayout(); - GridData gd = new GridData(GridData.HORIZONTAL_ALIGN_FILL); - gd.verticalAlignment = GridData.BEGINNING; - comp.setLayout(layout); - comp.setLayoutData(gd); - - fUp = new Button(comp, SWT.PUSH); - fUp.setFont(parent.getFont()); - fUp.setText(AntLaunchConfigurationMessages.getString("TargetOrderDialog.&Up_3")); //$NON-NLS-1$ - setButtonLayoutData(fUp); - fUp.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - handleUpPressed(); - } - }); - - fDown = new Button(comp, SWT.PUSH); - fDown.setFont(parent.getFont()); - fDown.setText(AntLaunchConfigurationMessages.getString("TargetOrderDialog.&Down_4")); //$NON-NLS-1$ - setButtonLayoutData(fDown); - fDown.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - handleDownPressed(); - } - }); - - } - - /** - * Down - */ - protected void handleDownPressed() { - int[] selections = fViewer.getTable().getSelectionIndices(); - for (int i = 0; i < selections.length; i++) { - fContentProvider.moveDownTarget(selections[i]); - } - fTargets = fContentProvider.getElements(null); - fViewer.refresh(); - updateButtons(); - } - - /** - * Up - */ - protected void handleUpPressed() { - int[] selections = fViewer.getTable().getSelectionIndices(); - for (int i = 0; i < selections.length; i++) { - fContentProvider.moveUpTarget(selections[i]); - } - fTargets = fContentProvider.getElements(null); - fViewer.refresh(); - updateButtons(); - } - - /** - * Creates a list viewer for the targets - * - * @param comp - */ - private void createTargetList(Composite comp) { - fViewer = new TableViewer(comp, SWT.MULTI | SWT.FULL_SELECTION | SWT.BORDER); - fViewer.setLabelProvider(new TargetTableLabelProvider()); - fContentProvider = new AntTargetContentProvider(); - fViewer.setContentProvider(fContentProvider); - fViewer.setInput(fTargets); - fViewer.addSelectionChangedListener(this); - Table table = fViewer.getTable(); - GridData gd = new GridData(GridData.FILL_BOTH); - gd.heightHint = 200; - gd.widthHint = 250; - table.setLayoutData(gd); - } - - /** - * Returns the ordered targets - */ - public Object[] getTargets() { - return fTargets; - } - - /** - * Update button enablement - * - * @see org.eclipse.jface.viewers.ISelectionChangedListener#selectionChanged(org.eclipse.jface.viewers.SelectionChangedEvent) - */ - public void selectionChanged(SelectionChangedEvent event) { - updateButtons(); - } - - private void updateButtons() { - int[] selections = fViewer.getTable().getSelectionIndices(); - int last = fTargets.length - 1; - boolean up = true && selections.length > 0; - boolean down = true && selections.length > 0; - for (int i = 0; i < selections.length; i++) { - if (selections[i] == 0) { - up = false; - } - if (selections[i] == last) { - down = false; - } - } - fUp.setEnabled(up); - fDown.setEnabled(down); - } - - /* (non-Javadoc) - * @see org.eclipse.jface.window.Window#configureShell(org.eclipse.swt.widgets.Shell) - */ - protected void configureShell(Shell shell) { - super.configureShell(shell); - WorkbenchHelp.setHelp(shell, IExternalToolsHelpContextIds.TARGET_ORDER_DIALOG); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TargetTableLabelProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TargetTableLabelProvider.java deleted file mode 100644 index 7b0531345..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TargetTableLabelProvider.java +++ /dev/null @@ -1,106 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - -import org.eclipse.ant.core.TargetInfo; -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.jface.viewers.IColorProvider; -import org.eclipse.jface.viewers.ITableLabelProvider; -import org.eclipse.jface.viewers.LabelProvider; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Color; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.model.AntImageDescriptor; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; - -/** - * Ant target label provider - */ -public class TargetTableLabelProvider extends LabelProvider implements ITableLabelProvider, IColorProvider { - - public TargetTableLabelProvider() { - super(); - } - - /* (non-Javadoc) - * Method declared on ILabelProvider. - */ - public String getText(Object model) { - TargetInfo target = (TargetInfo) model; - StringBuffer result = new StringBuffer(target.getName()); - if (target.isDefault()) { - result.append(" ("); //$NON-NLS-1$; - result.append(AntLaunchConfigurationMessages.getString("AntTargetLabelProvider.default_target_1")); //$NON-NLS-1$ - result.append(")"); //$NON-NLS-1$; - } - return result.toString(); - } - - /** - * @see org.eclipse.jface.viewers.ILabelProvider#getImage(java.lang.Object) - */ - public Image getImage(Object element) { - TargetInfo target = (TargetInfo)element; - ImageDescriptor base = null; - int flags = 0; - if (target.isDefault()) { - flags = flags | AntImageDescriptor.DEFAULT_TARGET; - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_DEFAULT_TARGET); - } else if (target.getDescription() == null) { - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_TARGET_PRIVATE); - } else { - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_TARGET); - } - return ExternalToolsImages.getImage(new AntImageDescriptor(base, flags)); - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ITableLabelProvider#getColumnImage(java.lang.Object, int) - */ - public Image getColumnImage(Object element, int columnIndex) { - if (columnIndex == 0) { - return getImage(element); - } - return null; - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.ITableLabelProvider#getColumnText(java.lang.Object, int) - */ - public String getColumnText(Object element, int columnIndex) { - if (columnIndex == 0){ - return getText(element); - } - String desc = ((TargetInfo)element).getDescription(); - if (desc == null) { - return ""; //$NON-NLS-1$ - } - return desc; - } - - public Color getForeground(Object element) { - if (!(element instanceof TargetInfo)) { - return null; - } - TargetInfo info = (TargetInfo) element; - if (info.isDefault()) { - return Display.getDefault().getSystemColor(SWT.COLOR_BLUE); - } - return null; - } - - public Color getBackground(Object element) { - return null; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TaskLinkManager.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TaskLinkManager.java deleted file mode 100644 index 4baedebf5..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/launchConfigurations/TaskLinkManager.java +++ /dev/null @@ -1,144 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.launchConfigurations; - - -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -import org.eclipse.debug.core.model.IProcess; -import org.eclipse.debug.ui.console.IConsole; -import org.eclipse.debug.ui.console.IConsoleHyperlink; -import org.eclipse.jface.text.BadLocationException; -import org.eclipse.jface.text.IRegion; - -/** - * Manages task links per process. As messages are logged to the console from - * build events, hyperlinks are created to link task names to the associated ant - * script. The build logger registers a task hyperlink with this manager for - * each build event associated with a task. When the associated line is later - * appended to the console, the corresponding text region in the console - * document is determined (as the length of a console document can not be - * determined beforehand), and the hyperlink is added to the document. - */ -public class TaskLinkManager { - - /** - * A map of processes to lists of queued task hyperlink entries - */ - private static Map fgProcessTable; - - private static class HyperlinkEntry { - private IConsoleHyperlink fLink; - private IRegion fRegion; - private String fTaskName; - - public HyperlinkEntry(IConsoleHyperlink link, IRegion region, String taskName) { - fLink = link; - fRegion = region; - fTaskName = taskName; - } - - public IRegion getRegion() { - return fRegion; - } - - public IConsoleHyperlink getLink() { - return fLink; - } - - public String getTaskName() { - return fTaskName; - } - } - - /** - * Not to be called. - */ - private TaskLinkManager() { - super(); - } - - /** - * Registers a hyperlink for the given process and task name. The given - * region is relative to the beginning of the line (not the document). - * - * @param process - * @param link - * @param region - * @param taskName - */ - public static void addTaskHyperlink(IProcess process, IConsoleHyperlink link, IRegion region, String taskName) { - if (fgProcessTable == null) { - fgProcessTable = new HashMap(10); - - } - List queue = (List)fgProcessTable.get(process); - if (queue == null) { - queue = new ArrayList(10); - fgProcessTable.put(process, queue); - } - synchronized (queue) { - queue.add(new HyperlinkEntry(link, region, taskName)); - } - } - - /** - * A new line has been added to the given console. Adds any task hyperlink - * associated with the line, to the console. - * - * @param console - * @param newLine - */ - public static void processNewLine(IConsole console, IRegion newLine) { - if (fgProcessTable == null) { - return; - } - IProcess process = console.getProcess(); - List queue = (List)fgProcessTable.get(process); - if (queue == null) { - return; - } - synchronized (queue) { - for (int i = 0; i < queue.size(); i++) { - HyperlinkEntry entry = (HyperlinkEntry)queue.get(i); - IRegion region = entry.getRegion(); - int offset = newLine.getOffset() + region.getOffset(); - int length = region.getLength(); - String text; - try { - text = console.getDocument().get(offset, length); - } catch (BadLocationException e) { - return; - } - if (text.equals(entry.getTaskName())) { - console.addLink(entry.getLink(), offset, length); - queue.remove(i); - return; - } - } - } - } - - /** - * Disposes any information stored for the given process. - * - * @param process - */ - public static void dispose(IProcess process) { - if (fgProcessTable != null) { - fgProcessTable.remove(process); - } - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AddCustomDialog.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AddCustomDialog.java deleted file mode 100644 index 058feb1cf..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AddCustomDialog.java +++ /dev/null @@ -1,627 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.io.File; -import java.io.IOException; -import java.net.URL; -import java.text.MessageFormat; -import java.util.Iterator; -import java.util.List; -import java.util.StringTokenizer; -import java.util.zip.ZipEntry; -import java.util.zip.ZipException; -import java.util.zip.ZipFile; - -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.jface.dialogs.IDialogConstants; -import org.eclipse.jface.viewers.DoubleClickEvent; -import org.eclipse.jface.viewers.IDoubleClickListener; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.ITreeContentProvider; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.swt.SWT; -import org.eclipse.swt.custom.BusyIndicator; -import org.eclipse.swt.events.FocusAdapter; -import org.eclipse.swt.events.FocusEvent; -import org.eclipse.swt.events.KeyAdapter; -import org.eclipse.swt.events.KeyEvent; -import org.eclipse.swt.events.ModifyEvent; -import org.eclipse.swt.events.ModifyListener; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Combo; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Shell; -import org.eclipse.swt.widgets.Text; -import org.eclipse.ui.dialogs.FileSystemElement; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.StatusDialog; -import org.eclipse.ui.externaltools.internal.ui.StatusInfo; -import org.eclipse.ui.externaltools.internal.ui.TreeAndListGroup; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.model.WorkbenchContentProvider; -import org.eclipse.ui.model.WorkbenchLabelProvider; -import org.eclipse.ui.model.WorkbenchViewerSorter; -import org.eclipse.ui.wizards.datatransfer.FileSystemStructureProvider; -import org.eclipse.ui.wizards.datatransfer.IImportStructureProvider; -import org.eclipse.ui.wizards.datatransfer.ZipFileStructureProvider; - -public class AddCustomDialog extends StatusDialog { - - private ZipFileStructureProvider providerCache; - private IImportStructureProvider currentProvider; - - //A boolean to indicate if the user has typed anything - private boolean entryChanged = false; - - protected Combo sourceNameField; - - private String title; - private String description; - private List libraryUrls; - private List existingNames; - - private TreeAndListGroup selectionGroup; - - protected Button sourceBrowseButton; - - private Text nameField; - - private String customLabel; - - private String name=""; //$NON-NLS-1$ - private URL library= null; - private String className=""; //$NON-NLS-1$ - - private boolean editing= false; - - /** - * Creates a new dialog with the given shell and title. - */ - public AddCustomDialog(Shell parent, List libraryUrls, List existingNames, String title, String description, String customLabel) { - super(parent); - this.title = title; - this.description = description; - this.libraryUrls = libraryUrls; - this.existingNames= existingNames; - this.customLabel= customLabel; - } - - /* (non-Javadoc) - * Method declared on Dialog. - */ - protected Control createDialogArea(Composite parent) { - Composite dialogArea = new Composite(parent, SWT.NULL); - dialogArea.setLayout(new GridLayout()); - dialogArea.setLayoutData(new GridData(GridData.VERTICAL_ALIGN_FILL | GridData.HORIZONTAL_ALIGN_FILL)); - dialogArea.setSize(dialogArea.computeSize(SWT.DEFAULT, SWT.DEFAULT)); - dialogArea.setFont(parent.getFont()); - - createNameGroup(dialogArea); - new Label(dialogArea, SWT.NULL); - createRootDirectoryGroup(dialogArea); - createFileSelectionGroup(dialogArea); - - if (library != null) { - setSourceName(library.getFile()); - } - return dialogArea; - } - - private void createNameGroup(Composite dialogArea) { - Composite nameContainerGroup = new Composite(dialogArea, SWT.NONE); - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - layout.marginHeight= 0; - layout.marginWidth= 0; - nameContainerGroup.setLayout(layout); - nameContainerGroup.setFont(dialogArea.getFont()); - nameContainerGroup.setLayoutData(new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL)); - - Label label = new Label(nameContainerGroup, SWT.NONE); - label.setFont(dialogArea.getFont()); - label.setText(AntPreferencesMessages.getString("AddCustomDialog.&Name__3")); //$NON-NLS-1$ - - nameField = new Text(nameContainerGroup, SWT.BORDER); - GridData data = new GridData(GridData.FILL_HORIZONTAL); - data.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - - nameField.setLayoutData(data); - nameField.setFont(dialogArea.getFont()); - nameField.setText(name); - nameField.addModifyListener(new ModifyListener() { - public void modifyText(ModifyEvent e) { - updateStatus(); - } - }); - } - - /* (non-Javadoc) - * Method declared on Window. - */ - protected void configureShell(Shell newShell) { - super.configureShell(newShell); - newShell.setText(title); - WorkbenchHelp.setHelp(newShell, IExternalToolsHelpContextIds.ADD_CUSTOM_DIALOG); - } - /** - * Clears the cached structure provider after first finalizing - * it properly. - */ - protected void clearProviderCache() { - if (providerCache != null) { - closeZipFile(providerCache.getZipFile()); - providerCache = null; - } - } - /** - * Attempts to close the passed zip file, and answers a boolean indicating success. - */ - protected boolean closeZipFile(ZipFile file) { - try { - file.close(); - } catch (IOException e) { - ExternalToolsPlugin.getDefault().log(MessageFormat.format(AntPreferencesMessages.getString("AddCustomDialog.Could_not_close_zip_file_{0}_4"), new String[]{file.getName()}), e); //$NON-NLS-1$ - return false; - } - - return true; - } - - /** - * Create the group for creating the root directory - */ - private void createRootDirectoryGroup(Composite parent) { - Composite sourceContainerGroup = new Composite(parent, SWT.NONE); - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - layout.marginHeight=0; - layout.marginWidth=0; - - sourceContainerGroup.setLayout(layout); - sourceContainerGroup.setFont(parent.getFont()); - sourceContainerGroup.setLayoutData(new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL)); - - Label groupLabel = new Label(sourceContainerGroup, SWT.NONE); - groupLabel.setText(AntPreferencesMessages.getString("AddCustomDialog.&Location")); //$NON-NLS-1$ - groupLabel.setFont(parent.getFont()); - - // source name entry field - sourceNameField = new Combo(sourceContainerGroup, SWT.BORDER | SWT.READ_ONLY); - GridData data = new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL); - data.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - sourceNameField.setLayoutData(data); - sourceNameField.setFont(parent.getFont()); - - sourceNameField.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - updateFromSourceField(); - } - }); - - Iterator libraries= libraryUrls.iterator(); - while (libraries.hasNext()) { - URL library = (URL) libraries.next(); - sourceNameField.add(library.getFile()); - } - - sourceNameField.addKeyListener(new KeyAdapter() { - /* - * @see KeyListener.keyPressed - */ - public void keyPressed(KeyEvent e) { - //If there has been a key pressed then mark as dirty - entryChanged = true; - } - }); - - sourceNameField.addFocusListener(new FocusAdapter() { - /* - * @see FocusListener.focusLost(FocusEvent) - */ - public void focusLost(FocusEvent e) { - //Clear the flag to prevent constant update - if (entryChanged) { - entryChanged = false; - updateFromSourceField(); - } - } - }); - } - - /** - * Update the receiver from the source name field. - */ - private void updateFromSourceField(){ - setSourceName(sourceNameField.getText()); - updateStatus(); - } - - - /** - * Check the field values and display a message in the status if needed. - */ - private void updateStatus() { - StatusInfo status= new StatusInfo(); - String name= nameField.getText().trim(); - if (name.length() == 0) { - status.setError(MessageFormat.format(AntPreferencesMessages.getString("AddCustomDialog.name"), new String[]{customLabel})); //$NON-NLS-1$ - } else if (!editing){ - Iterator names= existingNames.iterator(); - while (names.hasNext()) { - String aName = (String) names.next(); - if(aName.equals(name)) { - status.setError(MessageFormat.format(AntPreferencesMessages.getString("AddCustomDialog.exists"), new String[]{customLabel, name})); //$NON-NLS-1$ - updateStatus(status); - return; - } - } - } - if (selectionGroup.getListTableSelection().isEmpty()) { - status.setError(AntPreferencesMessages.getString("AddCustomDialog.mustSelect")); //$NON-NLS-1$ - } - updateStatus(status); - } - - - /** - * Sets the source name of the import to be the supplied path. - * Adds the name of the path to the list of items in the - * source combo and selects it. - * - * @param path the path to be added - */ - protected void setSourceName(String path) { - - if (path.length() > 0) { - - String[] currentItems = this.sourceNameField.getItems(); - int selectionIndex = -1; - for (int i = 0; i < currentItems.length; i++) { - if (currentItems[i].equals(path)) { - selectionIndex = i; - break; - } - } - if (selectionIndex < 0) { - int oldLength = currentItems.length; - String[] newItems = new String[oldLength + 1]; - System.arraycopy(currentItems, 0, newItems, 0, oldLength); - newItems[oldLength] = path; - this.sourceNameField.setItems(newItems); - selectionIndex = oldLength; - } - this.sourceNameField.select(selectionIndex); - - resetSelection(); - } - } - - /** - * Create the import source selection widget - */ - protected void createFileSelectionGroup(Composite parent) { - //Just create with a dummy root. - FileSystemElement dummyRoot= new FileSystemElement("Dummy", null, true); //$NON-NLS-1$ - this.selectionGroup = new TreeAndListGroup(parent, dummyRoot, - getFolderProvider(), new WorkbenchLabelProvider(), getFileProvider(), - new WorkbenchLabelProvider(), SWT.NONE, 400, 150); - - ISelectionChangedListener listener = new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - updateStatus(); - } - }; - - WorkbenchViewerSorter sorter = new WorkbenchViewerSorter(); - this.selectionGroup.setTreeSorter(sorter); - this.selectionGroup.setListSorter(sorter); - this.selectionGroup.addSelectionChangedListener(listener); - selectionGroup.addDoubleClickListener(new IDoubleClickListener() { - public void doubleClick(DoubleClickEvent event) { - if (getButton(IDialogConstants.OK_ID).isEnabled()) { - buttonPressed(IDialogConstants.OK_ID); - } - } - }); - } - - /** - * Answer a boolean indicating whether the specified source currently exists - * and is valid (ie.- proper format) - */ - protected boolean ensureSourceIsValid() { - ZipFile specifiedFile = getSpecifiedSourceFile(); - - if (specifiedFile == null) - return false; - - return closeZipFile(specifiedFile); - } - /** - * Answer the root FileSystemElement that represents the contents of the - * currently-specified .zip file. If this FileSystemElement is not - * currently defined then create and return it. - */ - protected MinimizedFileSystemElement getFileSystemTree() { - IImportStructureProvider provider= null; - MinimizedFileSystemElement element= null; - ZipFile sourceFile = getSpecifiedSourceFile(); - if (sourceFile == null) { - File file= new File(sourceNameField.getText()); - if (file.exists()) { - provider = FileSystemStructureProvider.INSTANCE; - element= selectFiles(file, provider); - } - } else { - //zip file set as location - provider = getStructureProvider(sourceFile); - element= selectFiles(((ZipFileStructureProvider)provider).getRoot(), provider); - } - this.currentProvider = provider; - return element; - } - - /** - * Invokes a file selection operation using the specified file system and - * structure provider. If the user specifies files then this selection is - * cached for later retrieval and is returned. - */ - protected MinimizedFileSystemElement selectFiles(final Object rootFileSystemObject, final IImportStructureProvider structureProvider) { - - final MinimizedFileSystemElement[] results = new MinimizedFileSystemElement[1]; - - BusyIndicator.showWhile(getShell().getDisplay(), new Runnable() { - public void run() { - //Create the root element from the supplied file system object - results[0] = createRootElement(rootFileSystemObject, structureProvider); - } - }); - - return results[0]; - } - - /** - * Creates and returns a <code>MinimizedFileSystemElement</code> if the specified - * file system object merits one. - */ - protected MinimizedFileSystemElement createRootElement(Object fileSystemObject, IImportStructureProvider provider) { - boolean isContainer = provider.isFolder(fileSystemObject); - String elementLabel = provider.getLabel(fileSystemObject); - - // Use an empty label so that display of the element's full name - // doesn't include a confusing label - MinimizedFileSystemElement dummyParent = - new MinimizedFileSystemElement("", null, true);//$NON-NLS-1$ - dummyParent.setPopulated(); - MinimizedFileSystemElement result = - new MinimizedFileSystemElement(elementLabel, dummyParent, isContainer); - result.setFileSystemObject(fileSystemObject); - - //Get the files for the element so as to build the first level - result.getFiles(provider); - - return dummyParent; - } - - /** - * Answer a handle to the zip file currently specified as being the source. - * Return null if this file does not exist or is not of valid format. - */ - protected ZipFile getSpecifiedSourceFile() { - try { - return new ZipFile(sourceNameField.getText()); - } catch (ZipException e) { - StatusInfo status= new StatusInfo(); - status.setError(AntPreferencesMessages.getString("AddCustomDialog.Bad_Format")); //$NON-NLS-1$ - updateStatus(status); - } catch (IOException e) { - StatusInfo status= new StatusInfo(); - status.setError(AntPreferencesMessages.getString("AddCustomDialog.Unreadable")); //$NON-NLS-1$ - updateStatus(status); - } - - sourceNameField.setFocus(); - return null; - } - /** - * Returns a structure provider for the specified zip file. - */ - protected ZipFileStructureProvider getStructureProvider(ZipFile targetZip) { - if (providerCache == null) { - providerCache = new ZipFileStructureProvider(targetZip); - } else if (!providerCache.getZipFile().getName().equals(targetZip.getName())) { - clearProviderCache(); - // ie.- new value, so finalize & remove old value - providerCache = new ZipFileStructureProvider(targetZip); - } else if (!providerCache.getZipFile().equals(targetZip)) { - closeZipFile(targetZip); // ie.- duplicate handle to same .zip - } - - return providerCache; - } - - /** - * Repopulate the view based on the currently entered directory. - */ - protected void resetSelection() { - MinimizedFileSystemElement currentRoot = getFileSystemTree(); - selectionGroup.setRoot(currentRoot); - - if (className.length() != 0) { - StringTokenizer tokenizer= new StringTokenizer(className, "."); //$NON-NLS-1$ - selectClass(currentRoot, tokenizer); - } - } - - private void selectClass(MinimizedFileSystemElement currentParent, StringTokenizer tokenizer) { - if (!tokenizer.hasMoreTokens()) { - return; - } - List folders= currentParent.getFolders(currentProvider); - if (folders.size() == 1) { - MinimizedFileSystemElement element = (MinimizedFileSystemElement)folders.get(0); - if (element.getLabel(null).equals("/")) { //$NON-NLS-1$ - selectionGroup.selectAndRevealFolder(element); - selectClass(element, tokenizer); - return; - } - } - String currentName= tokenizer.nextToken(); - if (tokenizer.hasMoreTokens()) { - Iterator allFolders= folders.iterator(); - while (allFolders.hasNext()) { - MinimizedFileSystemElement folder = (MinimizedFileSystemElement) allFolders.next(); - if (folder.getLabel(null).equals(currentName)) { - selectionGroup.selectAndRevealFolder(folder); - selectClass(folder, tokenizer); - return; - } - } - } else { - List files= currentParent.getFiles(currentProvider); - Iterator iter= files.iterator(); - while (iter.hasNext()) { - MinimizedFileSystemElement file = (MinimizedFileSystemElement) iter.next(); - if (file.getLabel(null).equals(currentName + ".class")) { //$NON-NLS-1$ - selectionGroup.selectAndRevealFile(file); - return; - } - } - } - } - - /** - * Returns a content provider for <code>MinimizedFileSystemElement</code>s that returns - * only files as children. - */ - protected ITreeContentProvider getFileProvider() { - return new WorkbenchContentProvider() { - public Object[] getChildren(Object o) { - if (o instanceof MinimizedFileSystemElement) { - MinimizedFileSystemElement element = (MinimizedFileSystemElement) o; - return element.getFiles(currentProvider).toArray(); - } - return new Object[0]; - } - }; - } - - /** - * Returns a content provider for <code>MinimizedFileSystemElement</code>s that returns - * only folders as children. - */ - protected ITreeContentProvider getFolderProvider() { - return new WorkbenchContentProvider() { - public Object[] getChildren(Object o) { - if (o instanceof MinimizedFileSystemElement) { - MinimizedFileSystemElement element = (MinimizedFileSystemElement) o; - return element.getFolders(currentProvider).toArray(); - } - return new Object[0]; - } - public boolean hasChildren(Object o) { - if (o instanceof MinimizedFileSystemElement) { - MinimizedFileSystemElement element = (MinimizedFileSystemElement) o; - if (element.isPopulated()) - return getChildren(element).length > 0; - else { - //If we have not populated then wait until asked - return true; - } - } - return false; - } - }; - } - - /** - * @see org.eclipse.jface.dialogs.Dialog#cancelPressed() - */ - protected void cancelPressed() { - clearProviderCache(); - super.cancelPressed(); - } - - /** - * @see org.eclipse.jface.dialogs.Dialog#okPressed() - */ - protected void okPressed() { - clearProviderCache(); - name= nameField.getText().trim(); - library= (URL)libraryUrls.get(sourceNameField.getSelectionIndex()); - IStructuredSelection selection= this.selectionGroup.getListTableSelection(); - MinimizedFileSystemElement element= (MinimizedFileSystemElement)selection.getFirstElement(); - if (element == null) { - super.okPressed(); - return; - } - Object file= element.getFileSystemObject(); - if (file instanceof ZipEntry) { - className= ((ZipEntry)file).getName(); - } else { - className= ((File)file).getAbsolutePath(); - IPath classPath= new Path(className); - IPath libraryPath= new Path(library.getPath()); - int matching= classPath.matchingFirstSegments(libraryPath); - classPath= classPath.removeFirstSegments(matching); - classPath= classPath.setDevice(null); - className= classPath.toString(); - } - int index= className.lastIndexOf('.'); - className= className.substring(0, index); - className= className.replace('/', '.'); - super.okPressed(); - } - - protected String getName() { - return name; - } - - protected void setName(String name) { - this.name= name; - } - - protected void setLibrary(URL library) { - this.library= library; - editing= true; - } - - protected URL getLibrary() { - return this.library; - } - - protected String getClassName() { - return className; - } - - protected void setClassName(String className) { - this.className= className; - } - - /** - * @see org.eclipse.jface.window.Window#create() - */ - public void create() { - super.create(); - getButton(IDialogConstants.OK_ID).setEnabled(!(library == null)); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AddPropertyDialog.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AddPropertyDialog.java deleted file mode 100644 index efe227426..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AddPropertyDialog.java +++ /dev/null @@ -1,144 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.jface.dialogs.Dialog; -import org.eclipse.jface.dialogs.IDialogConstants; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.ModifyEvent; -import org.eclipse.swt.events.ModifyListener; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Shell; -import org.eclipse.swt.widgets.Text; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -public class AddPropertyDialog extends Dialog { - - private String fName; - private String fValue; - - private String fTitle; - - private Label fNameLabel; - private Text fNameText; - private Label fValueLabel; - private Text fValueText; - - private String[] fInitialValues; - - public AddPropertyDialog(Shell shell, String title, String[] initialValues) { - super(shell); - fTitle = title; - fInitialValues= initialValues; - } - - /** - * @see Dialog#createDialogArea(Composite) - */ - protected Control createDialogArea(Composite parent) { - Composite comp = new Composite(parent, SWT.NULL); - GridLayout topLayout = new GridLayout(); - topLayout.numColumns = 2; - comp.setLayout(topLayout); - comp.setFont(parent.getFont()); - GridData gd; - - fNameLabel = new Label(comp, SWT.NONE); - fNameLabel.setText(AntPreferencesMessages.getString("AddPropertyDialog.&Name__1")); //$NON-NLS-1$ - fNameLabel.setFont(comp.getFont()); - - fNameText = new Text(comp, SWT.BORDER | SWT.SINGLE); - fNameText.setText(fInitialValues[0]); - gd = new GridData(GridData.FILL_HORIZONTAL); - gd.widthHint = 300; - fNameText.setLayoutData(gd); - fNameText.setFont(comp.getFont()); - fNameText.addModifyListener(new ModifyListener() { - public void modifyText(ModifyEvent e) { - updateButtons(); - } - }); - - fValueLabel = new Label(comp, SWT.NONE); - fValueLabel.setText(AntPreferencesMessages.getString("AddPropertyDialog.&Value__2")); //$NON-NLS-1$ - fValueLabel.setFont(comp.getFont()); - - fValueText = new Text(comp, SWT.BORDER | SWT.SINGLE); - fValueText.setText(fInitialValues[1]); - gd = new GridData(GridData.FILL_HORIZONTAL); - gd.widthHint = 300; - fValueText.setLayoutData(gd); - fValueText.setFont(comp.getFont()); - fValueText.addModifyListener(new ModifyListener() { - public void modifyText(ModifyEvent e) { - updateButtons(); - } - }); - - return comp; - } - - /** - * Return the name/value pair entered in this dialog. If the cancel button was hit, - * both will be <code>null</code>. - */ - public String[] getNameValuePair() { - return new String[] {fName, fValue}; - } - - /** - * @see Dialog#buttonPressed(int) - */ - protected void buttonPressed(int buttonId) { - if (buttonId == IDialogConstants.OK_ID) { - fName= fNameText.getText(); - fValue = fValueText.getText(); - } else { - fName = null; - fValue = null; - } - super.buttonPressed(buttonId); - } - - /** - * @see Window#configureShell(Shell) - */ - protected void configureShell(Shell shell) { - super.configureShell(shell); - if (fTitle != null) { - shell.setText(fTitle); - } - WorkbenchHelp.setHelp(shell, IExternalToolsHelpContextIds.ADD_PROPERTY_DIALOG); - } - - /** - * Enable the OK button if valid input - */ - protected void updateButtons() { - String name = fNameText.getText().trim(); - String value = fValueText.getText().trim(); - getButton(IDialogConstants.OK_ID).setEnabled((name.length() > 0) &&(value.length() > 0)); - } - - /** - * Enable the buttons on creation. - */ - public void create() { - super.create(); - updateButtons(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathBlock.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathBlock.java deleted file mode 100644 index 73685a004..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathBlock.java +++ /dev/null @@ -1,591 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.io.File; -import java.net.MalformedURLException; -import java.net.URL; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.ant.core.AntCorePlugin; -import org.eclipse.ant.core.AntCorePreferences; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.jface.dialogs.IDialogConstants; -import org.eclipse.jface.dialogs.IDialogSettings; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.jface.viewers.TableViewer; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.ModifyEvent; -import org.eclipse.swt.events.ModifyListener; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.DirectoryDialog; -import org.eclipse.swt.widgets.FileDialog; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Table; -import org.eclipse.swt.widgets.Text; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntClasspathContentProvider; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntClasspathLabelProvider; -import org.eclipse.ui.externaltools.internal.ant.preferences.AntPreferencesMessages; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.ui.ExternalToolsContentProvider; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; - -public class AntClasspathBlock { - - private TableViewer antTableViewer; - private ExternalToolsContentProvider antContentProvider; - private TableViewer userTableViewer; - private ExternalToolsContentProvider userContentProvider; - - private Button upButton; - private Button downButton; - private Button removeButton; - - private Button upUserButton; - private Button downUserButton; - private Button removeUserButton; - - private final AntClasspathLabelProvider labelProvider = new AntClasspathLabelProvider(); - private Button addUserJarButton; - private Button addUserFolderButtton; - private Button addFolderButtton; - private Button addJarButton; - - private Button antHomeButton; - private Text antHome; - private Button browseAntHomeButton; - - private final IDialogSettings dialogSettings = ExternalToolsPlugin.getDefault().getDialogSettings(); - - private boolean initializing = true; - - private IAntBlockContainer container; - - private boolean tablesEnabled= true; - - public void setContainer(IAntBlockContainer container) { - this.container= container; - } - - private void addButtonsToButtonGroup(Composite parent) { - if (addJarButton == null) { - addJarButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.addJarButtonTitle")); //$NON-NLS-1$; - addJarButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - addJars(antTableViewer); - - } - }); - addFolderButtton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.addFolderButtonTitle")); //$NON-NLS-1$; - addFolderButtton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - addFolder(antTableViewer, AntPreferencesMessages.getString("AntClasspathBlock.&Choose_a_folder_to_add_to_the_classpath__1")); //$NON-NLS-1$ - } - }); - - upButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.upButtonTitle")); //$NON-NLS-1$; - upButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - handleMove(-1, antTableViewer); - } - }); - downButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.downButtonTitle")); //$NON-NLS-1$; - downButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - handleMove(1, antTableViewer); - } - }); - removeButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.removeButtonTitle")); //$NON-NLS-1$; - removeButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - remove(antTableViewer); - } - }); - - } else { - addUserJarButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.addJarButtonTitle2")); //$NON-NLS-1$; - addUserJarButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - addJars(userTableViewer); - } - }); - addUserFolderButtton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.addFolderButtonTitle2")); //$NON-NLS-1$; - addUserFolderButtton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - addFolder(userTableViewer, AntPreferencesMessages.getString("AntClasspathBlock.&Choose_a_folder_to_add_to_the_classpath__1")); //$NON-NLS-1$ - } - }); - upUserButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.upButtonTitle2")); //$NON-NLS-1$; - upUserButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - handleMove(-1, userTableViewer); - } - }); - downUserButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.downButtonTitle2")); //$NON-NLS-1$; - downUserButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - handleMove(1, userTableViewer); - } - }); - removeUserButton = container.createPushButton(parent, AntPreferencesMessages.getString("AntClasspathBlock.removeButtonTitle2")); //$NON-NLS-1$; - removeUserButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - remove(userTableViewer); - } - }); - } - } - - private void handleMove(int direction, TableViewer viewer) { - IStructuredSelection sel = (IStructuredSelection) viewer.getSelection(); - List selList = sel.toList(); - Object[] elements = ((ExternalToolsContentProvider) viewer.getContentProvider()).getElements(viewer.getInput()); - List contents = new ArrayList(elements.length); - for (int i = 0; i < elements.length; i++) { - contents.add(elements[i]); - } - Object[] moved = new Object[contents.size()]; - int i; - for (Iterator current = selList.iterator(); current.hasNext();) { - Object config = current.next(); - i = contents.indexOf(config); - moved[i + direction] = config; - } - - contents.removeAll(selList); - - for (int j = 0; j < moved.length; j++) { - Object config = moved[j]; - if (config != null) { - contents.add(j, config); - } - } - viewer.setInput(contents); - viewer.setSelection(viewer.getSelection()); - container.update(); - } - - private void remove(TableViewer viewer) { - ExternalToolsContentProvider viewerContentProvider = (ExternalToolsContentProvider) viewer.getContentProvider(); - IStructuredSelection sel = (IStructuredSelection) viewer.getSelection(); - Iterator enum = sel.iterator(); - while (enum.hasNext()) { - viewerContentProvider.remove(enum.next()); - } - container.update(); - } - - /** - * Allows the user to enter a folder as a classpath. - */ - private void addFolder(TableViewer viewer, String message) { - String lastUsedPath = dialogSettings.get(IExternalToolsUIConstants.DIALOGSTORE_LASTFOLDER); - if (lastUsedPath == null) { - lastUsedPath = ResourcesPlugin.getWorkspace().getRoot().getLocation().toOSString(); - } - DirectoryDialog dialog = new DirectoryDialog(antTableViewer.getControl().getShell()); - dialog.setMessage(message); - dialog.setFilterPath(lastUsedPath); - String result = dialog.open(); - if (result != null) { - try { - URL url = new URL("file:" + result + "/"); //$NON-NLS-2$;//$NON-NLS-1$; - ((ExternalToolsContentProvider)viewer.getContentProvider()).add(url); - } catch (MalformedURLException e) { - } - } - viewer.setSelection(viewer.getSelection()); - dialogSettings.put(IExternalToolsUIConstants.DIALOGSTORE_LASTFOLDER, result); - container.update(); - } - - private void addJars(TableViewer viewer) { - String lastUsedPath = dialogSettings.get(IExternalToolsUIConstants.DIALOGSTORE_LASTEXTJAR); - if (lastUsedPath == null) { - lastUsedPath = ResourcesPlugin.getWorkspace().getRoot().getLocation().toOSString(); - } - FileDialog dialog = new FileDialog(antTableViewer.getControl().getShell(), SWT.MULTI); - dialog.setFilterExtensions(new String[] { "*.jar" }); //$NON-NLS-1$; - dialog.setFilterPath(lastUsedPath); - - String result = dialog.open(); - if (result == null) { - return; - } - IPath filterPath = new Path(dialog.getFilterPath()); - String[] results = dialog.getFileNames(); - for (int i = 0; i < results.length; i++) { - String jarName = results[i]; - try { - IPath path = filterPath.append(jarName).makeAbsolute(); - URL url = new URL("file:" + path.toOSString()); //$NON-NLS-1$; - ((ExternalToolsContentProvider)viewer.getContentProvider()).add(url); - } catch (MalformedURLException e) { - } - } - - viewer.setSelection(viewer.getSelection()); - dialogSettings.put(IExternalToolsUIConstants.DIALOGSTORE_LASTEXTJAR, filterPath.toOSString()); - container.update(); - } - - /** - * Creates the group which will contain the buttons. - */ - private void createButtonGroup(Composite top) { - Composite buttonGroup = new Composite(top, SWT.NONE); - GridLayout layout = new GridLayout(); - layout.marginHeight = 0; - layout.marginWidth = 0; - buttonGroup.setLayout(layout); - buttonGroup.setLayoutData(new GridData(GridData.FILL_VERTICAL)); - buttonGroup.setFont(top.getFont()); - - addButtonsToButtonGroup(buttonGroup); - } - - private void createAntTable(Composite parent) { - Table table = new Table(parent, SWT.MULTI | SWT.FULL_SELECTION | SWT.BORDER); - GridData data = new GridData(GridData.FILL_BOTH); - data.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - data.heightHint = table.getItemHeight(); - data.horizontalSpan = 1; - table.setLayoutData(data); - table.setFont(parent.getFont()); - - antContentProvider = new AntClasspathContentProvider(); - antTableViewer = new TableViewer(table); - antTableViewer.setContentProvider(antContentProvider); - antTableViewer.setLabelProvider(labelProvider); - antTableViewer.addSelectionChangedListener(new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - if (tablesEnabled) { - tableSelectionChanged((IStructuredSelection) event.getSelection(), - (ExternalToolsContentProvider) antTableViewer.getContentProvider(), false); - } - } - }); - } - - public void createContents(Composite parent) { - Font font = parent.getFont(); - Label label = new Label(parent, SWT.NONE); - GridData gd = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalSpan = 2; - label.setLayoutData(gd); - label.setFont(font); - label.setText(AntPreferencesMessages.getString("AntClasspathBlock.Run&time_classpath__8")); //$NON-NLS-1$ - - createAntTable(parent); - createButtonGroup(parent); - - createSeparator(parent); - - createAntHome(parent); - - label = new Label(parent, SWT.NONE); - gd = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalSpan = 2; - label.setLayoutData(gd); - label.setFont(font); - label.setText(AntPreferencesMessages.getString("AntClasspathBlock.Additional_classpath_entries__11")); //$NON-NLS-1$ - - createUserTable(parent); - createButtonGroup(parent); - } - - private void createUserTable(Composite top) { - Table table = new Table(top, SWT.MULTI | SWT.FULL_SELECTION | SWT.BORDER); - GridData data = new GridData(GridData.FILL_BOTH); - data.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - data.heightHint = table.getItemHeight(); - data.horizontalSpan = 1; - table.setLayoutData(data); - table.setFont(top.getFont()); - userContentProvider = new AntClasspathContentProvider(); - userTableViewer = new TableViewer(table); - userTableViewer.setContentProvider(userContentProvider); - userTableViewer.setLabelProvider(labelProvider); - userTableViewer.addSelectionChangedListener(new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - if (tablesEnabled) { - tableSelectionChanged((IStructuredSelection) event.getSelection(), - (ExternalToolsContentProvider) userTableViewer.getContentProvider(), true); - } - } - }); - } - - /** - * Creates a space between controls - */ - private Label createSeparator(Composite parent) { - Label separator = new Label(parent, SWT.NONE); - GridData gd = - new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.VERTICAL_ALIGN_BEGINNING); - gd.heightHint = 4; - gd.horizontalSpan = 2; - separator.setLayoutData(gd); - return separator; - } - - private void createAntHome(Composite top) { - Composite antHomeComposite = new Composite(top, SWT.NONE); - antHomeComposite.setLayoutData( - new GridData( - GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL)); - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - layout.marginHeight = 0; - layout.marginWidth = 0; - antHomeComposite.setLayout(layout); - antHomeComposite.setFont(top.getFont()); - - antHomeButton = new Button(antHomeComposite, SWT.CHECK); - antHomeButton.setFont(top.getFont()); - antHomeButton.setText(AntPreferencesMessages.getString("AntClasspathBlock.Set_ANT_HO&ME_9")); //$NON-NLS-1$ - antHomeButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - specifyAntHome(); - } - }); - - antHome = new Text(antHomeComposite, SWT.BORDER); - GridData gd = new GridData(GridData.FILL_HORIZONTAL); - gd.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - antHome.setLayoutData(gd); - antHome.setFont(top.getFont()); - antHome.setEnabled(false); - antHome.addModifyListener(new ModifyListener() { - public void modifyText(ModifyEvent e) { - if (initializing) { - return; - } - String path= antHome.getText(); - if (path.length() > 0) { - File rootDir = new File(path, "lib"); //$NON-NLS-1$ - if (rootDir.exists()) { - setAntHome(rootDir); - } - } - container.update(); - } - }); - - browseAntHomeButton = container.createPushButton(top, AntPreferencesMessages.getString("AntClasspathBlock.&Browse..._10")); //$NON-NLS-1$ - browseAntHomeButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - browseAntHome(); - } - }); - browseAntHomeButton.setEnabled(false); - } - - /* (non-Javadoc) - * Method declared on AntPage. - */ - private void tableSelectionChanged(IStructuredSelection selection, ExternalToolsContentProvider contentProvider, boolean user) { - Object[] elements = contentProvider.getElements(null); - List urls = Arrays.asList(elements); - boolean notEmpty = !selection.isEmpty(); - Iterator selected = selection.iterator(); - boolean first = false; - boolean last = false; - int lastUrl = urls.size() - 1; - while (selected.hasNext()) { - Object element = (Object) selected.next(); - if (!first && urls.indexOf(element) == 0) { - first = true; - } - if (!last && urls.indexOf(element) == lastUrl) { - last = true; - } - } - - if (user) { - removeUserButton.setEnabled(notEmpty); - upUserButton.setEnabled(notEmpty && !first); - downUserButton.setEnabled(notEmpty && !last); - } else { - removeButton.setEnabled(notEmpty); - upButton.setEnabled(notEmpty && !first); - downButton.setEnabled(notEmpty && !last); - } - } - - private void specifyAntHome() { - antHome.setEnabled(!antHome.getEnabled()); - browseAntHomeButton.setEnabled(!browseAntHomeButton.getEnabled()); - if (antHome.isEnabled()) { - File rootDir = validateAntHome(antHome.getText()); - if (rootDir != null) { - setAntHome(rootDir); - } - } else { - container.setMessage(null); - container.setErrorMessage(null); - } - container.update(); - } - - private File validateAntHome(String path) { - File rootDir = null; - if (path.length() > 0) { - rootDir = new File(path, "lib"); //$NON-NLS-1$ - if (!rootDir.exists()) { - container.setErrorMessage(AntPreferencesMessages.getString("AntClasspathBlock.Specified_ANT_HOME_does_not_contain_a___lib___directory_7")); //$NON-NLS-1$ - return null; - } - } else { - container.setErrorMessage(AntPreferencesMessages.getString("AntClasspathBlock.Specified_ANT_HOME_does_not_contain_a___lib___directory_7")); //$NON-NLS-1$ - return null; - } - - container.setErrorMessage(null); - return rootDir; - } - - private void browseAntHome() { - String lastUsedPath= dialogSettings.get(IExternalToolsUIConstants.DIALOGSTORE_LASTANTHOME); - if (lastUsedPath == null) { - lastUsedPath= ResourcesPlugin.getWorkspace().getRoot().getLocation().toOSString(); - } - DirectoryDialog dialog = new DirectoryDialog(antTableViewer.getControl().getShell()); - dialog.setMessage(AntPreferencesMessages.getString("AntClasspathBlock.&Choose_a_folder_that_will_be_used_as_the_location_of_ANT_HOME_3")); //$NON-NLS-1$ - dialog.setFilterPath(lastUsedPath); - String path = dialog.open(); - if (path == null) { - return; - } - - antHome.setText(path); - dialogSettings.put(IExternalToolsUIConstants.DIALOGSTORE_LASTANTHOME, path); - container.update(); - } - - private void setAntHome(File rootDir) { - AntClasspathContentProvider contentProvider = (AntClasspathContentProvider) antTableViewer.getContentProvider(); - contentProvider.removeAll(); - String[] names = rootDir.list(); - for (int i = 0; i < names.length; i++) { - File file = new File(rootDir, names[i]); - if (file.isFile() && file.getPath().endsWith(".jar")) { //$NON-NLS-1$ - try { - IPath jarPath = new Path(file.getAbsolutePath()); - URL url = new URL("file:" + jarPath.toOSString()); //$NON-NLS-1$ - contentProvider.add(url); - } catch (MalformedURLException e) { - } - } - } - AntCorePreferences prefs = AntCorePlugin.getPlugin().getPreferences(); - URL url = prefs.getToolsJarURL(); - if (url != null) { - contentProvider.add(url); - } - container.update(); - } - - public List getAntURLs() { - Object[] elements = antContentProvider.getElements(null); - return Arrays.asList(elements); - } - - public List getUserURLs() { - Object[] elements = userContentProvider.getElements(null); - return Arrays.asList(elements); - } - - public String getAntHome() { - String antHomeText= antHome.getText().trim(); - if (!antHomeButton.getSelection() || antHomeText.length() == 0) { - antHomeText= null; - } - return antHomeText; - } - - public void setEnabled(boolean enable) { - setTablesEnabled(enable); - antHomeButton.setEnabled(enable); - addFolderButtton.setEnabled(enable); - addJarButton.setEnabled(enable); - addUserJarButton.setEnabled(enable); - addUserFolderButtton.setEnabled(enable); - if (enable) { - antTableViewer.setSelection(antTableViewer.getSelection()); - userTableViewer.setSelection(userTableViewer.getSelection()); - } else { - antHomeButton.setSelection(false); - antHome.setEnabled(false); - browseAntHomeButton.setEnabled(false); - downButton.setEnabled(false); - downUserButton.setEnabled(false); - removeButton.setEnabled(false); - removeUserButton.setEnabled(false); - upButton.setEnabled(false); - upUserButton.setEnabled(false); - AntCorePreferences prefs = AntCorePlugin.getPlugin().getPreferences(); - antTableViewer.setInput(prefs.getAntURLs()); - userTableViewer.setInput(prefs.getCustomURLs()); - } - } - - public void initializeAntHome(String antHomeString) { - antHomeButton.setSelection(antHomeString != null); - antHome.setEnabled(antHomeString != null); - browseAntHomeButton.setEnabled(antHomeString != null); - if (antHomeString != null) { - antHome.setText(antHomeString); - } else { - antHome.setText(""); //$NON-NLS-1$ - } - initializing= false; - } - - public void setUserTableInput(Object input) { - userTableViewer.setInput(input); - } - - public void setAntTableInput(Object input) { - antTableViewer.setInput(input); - } - - public boolean isAntHomeEnabled() { - return antHome.isEnabled(); - } - - public boolean validateAntHome() { - return validateAntHome(antHome.getText()) != null; - } - - public Image getClasspathImage() { - return labelProvider.getClasspathImage(); - } - - public void setTablesEnabled(boolean tablesEnabled) { - this.tablesEnabled= tablesEnabled; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathContentProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathContentProvider.java deleted file mode 100644 index eada0d9ff..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathContentProvider.java +++ /dev/null @@ -1,59 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.io.File; -import java.net.URL; -import java.util.ArrayList; -import java.util.Iterator; - -import org.eclipse.jface.viewers.ViewerSorter; -import org.eclipse.ui.externaltools.internal.ui.ExternalToolsContentProvider; - -/** - * Content provider that maintains a list of URLs which are shown in a table - * viewer. - */ -public class AntClasspathContentProvider extends ExternalToolsContentProvider { - - /** - * @see org.eclipse.ui.externaltools.internal.ui.ExternalToolsContentProvider#add(java.lang.Object) - */ - public void add(Object o) { - URL newURL = (URL) o; - File newFile= new File(newURL.getFile()); - Iterator itr = elements.iterator(); - File existingFile; - while (itr.hasNext()) { - URL url = (URL) itr.next(); - existingFile= new File(url.getFile()); - if (existingFile.equals(newFile)) { - return; - } - } - elements.add(o); - tableViewer.add(o); - } - - public void removeAll() { - if (tableViewer != null) { - tableViewer.remove(elements.toArray()); - } - elements = new ArrayList(5); - } - /** - * @see org.eclipse.ui.externaltools.internal.ui.ExternalToolsContentProvider#getSorter() - */ - protected ViewerSorter getSorter() { - return null; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathPage.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathPage.java deleted file mode 100644 index eaf118281..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntClasspathPage.java +++ /dev/null @@ -1,170 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.util.ArrayList; -import java.util.Arrays; -import java.util.List; - -import org.eclipse.ant.core.AntCorePlugin; -import org.eclipse.ant.core.AntCorePreferences; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.TabFolder; -import org.eclipse.swt.widgets.TabItem; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Sub-page that allows the user to enter custom classpaths - * to be used when running Ant build files. - */ -public class AntClasspathPage implements IAntBlockContainer { - - private AntClasspathBlock antClasspathBlock= new AntClasspathBlock(); - private AntRuntimePreferencePage preferencePage; - - /** - * Creates an instance. - */ - public AntClasspathPage(AntRuntimePreferencePage preferencePage) { - this.preferencePage = preferencePage; - } - - /** - * Returns the specified user classpath URLs - * - * @return List - */ - protected List getUserURLs() { - return antClasspathBlock.getUserURLs(); - } - - /** - * Returns the currently listed objects in the table. - */ - protected List getAntURLs() { - return antClasspathBlock.getAntURLs(); - } - - protected String getAntHome() { - return antClasspathBlock.getAntHome(); - } - - /** - * Sets the contents of the tables on this page. - */ - protected void initialize() { - - AntCorePreferences prefs= AntCorePlugin.getPlugin().getPreferences(); - antClasspathBlock.setAntTableInput(prefs.getAntURLs()); - antClasspathBlock.setUserTableInput(Arrays.asList(prefs.getCustomURLs())); - antClasspathBlock.setEnabled(true); - String antHomeString= prefs.getAntHome(); - if (antHomeString != null && antHomeString.length() == 0) { - antHomeString= null; - } - antClasspathBlock.initializeAntHome(antHomeString); - - preferencePage.setErrorMessage(null); - preferencePage.setValid(true); - } - - protected void performDefaults() { - AntCorePreferences prefs= AntCorePlugin.getPlugin().getPreferences(); - antClasspathBlock.setAntTableInput(Arrays.asList(prefs.getDefaultAntURLs())); - antClasspathBlock.setUserTableInput(new ArrayList(0)); - antClasspathBlock.initializeAntHome(null); - antClasspathBlock.setEnabled(true); - update(); - } - - /** - * Creates the tab item that contains this sub-page. - */ - protected TabItem createTabItem(TabFolder folder) { - TabItem item = new TabItem(folder, SWT.NONE); - item.setText(AntPreferencesMessages.getString("AntClasspathPage.title")); //$NON-NLS-1$; - item.setImage(antClasspathBlock.getClasspathImage()); - item.setData(this); - item.setControl(createContents(folder)); - return item; - } - - /** - * Creates this page's controls - */ - protected Composite createContents(Composite parent) { - WorkbenchHelp.setHelp(parent, IExternalToolsHelpContextIds.ANT_CLASSPATH_PAGE); - Font font = parent.getFont(); - - Composite top = new Composite(parent, SWT.NONE); - top.setFont(font); - - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - layout.marginHeight = 2; - layout.marginWidth = 2; - top.setLayout(layout); - - top.setLayoutData(new GridData(GridData.FILL_BOTH)); - - antClasspathBlock.setContainer(this); - antClasspathBlock.createContents(top); - - return top; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#update() - */ - public void update() { - setMessage(null); - setErrorMessage(null); - boolean valid= true; - if (antClasspathBlock.isAntHomeEnabled()) { - valid= antClasspathBlock.validateAntHome(); - } - preferencePage.setValid(valid); - } - - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setMessage(java.lang.String) - */ - public void setMessage(String message) { - preferencePage.setMessage(message); - } - - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setErrorMessage(java.lang.String) - */ - public void setErrorMessage(String message) { - preferencePage.setErrorMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#createPushButton(org.eclipse.swt.widgets.Composite, java.lang.String) - */ - public Button createPushButton(Composite parent, String buttonText) { - Button button = new Button(parent, SWT.PUSH); - button.setFont(parent.getFont()); - button.setText(buttonText); - preferencePage.setButtonLayoutData(button); - return button; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntEditorPreferenceConstants.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntEditorPreferenceConstants.java deleted file mode 100644 index 93e164f67..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntEditorPreferenceConstants.java +++ /dev/null @@ -1,445 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.jface.preference.IPreferenceStore; -import org.eclipse.jface.preference.PreferenceConverter; -import org.eclipse.swt.graphics.RGB; - -/** - * Preference constants used in the default text editor preference store. - */ -public class AntEditorPreferenceConstants { - - private AntEditorPreferenceConstants() { - } - - /** - * A named preference that controls whether the current line highlighting is turned on or off. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_CURRENT_LINE= "currentLine"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to highlight the current line. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String EDITOR_CURRENT_LINE_COLOR= "currentLineColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the print margin is turned on or off. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_PRINT_MARGIN= "printMargin"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render the print margin. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String EDITOR_PRINT_MARGIN_COLOR= "printMarginColor"; //$NON-NLS-1$ - - /** - * Print margin column. Int value. - */ - public final static String EDITOR_PRINT_MARGIN_COLUMN= "printMarginColumn"; //$NON-NLS-1$ - - - /** - * A named preference that controls whether the editor shows problem indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_PROBLEM_INDICATION= "problemIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render problem indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_PROBLEM_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String EDITOR_PROBLEM_INDICATION_COLOR= "problemIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the editor shows warning indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_WARNING_INDICATION= "warningIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render warning indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_WARNING_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String EDITOR_WARNING_INDICATION_COLOR= "warningIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the editor shows info indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_INFO_INDICATION= "infoIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render info indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_INFO_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String EDITOR_INFO_INDICATION_COLOR= "infoIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the editor shows task indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_TASK_INDICATION= "taskIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render task indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_TASK_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String EDITOR_TASK_INDICATION_COLOR= "taskIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the editor shows bookmark - * indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_BOOKMARK_INDICATION= "bookmarkIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render bookmark indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_BOOKMARK_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - * @since 2.1 - */ - public final static String EDITOR_BOOKMARK_INDICATION_COLOR= "bookmarkIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the editor shows search - * indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_SEARCH_RESULT_INDICATION= "searchResultIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render search indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_SEARCH_RESULT_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - * @since 2.1 - */ - public final static String EDITOR_SEARCH_RESULT_INDICATION_COLOR= "searchResultIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the editor shows unknown - * indicators in text (squiggly lines). - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_UNKNOWN_INDICATION= "othersIndication"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render unknown - * indicators. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see #EDITOR_UNKNOWN_INDICATION - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - * @since 2.1 - */ - public final static String EDITOR_UNKNOWN_INDICATION_COLOR= "othersIndicationColor"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows error - * indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_ERROR_INDICATION_IN_OVERVIEW_RULER= "errorIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows warning - * indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_WARNING_INDICATION_IN_OVERVIEW_RULER= "warningIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows info - * indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_INFO_INDICATION_IN_OVERVIEW_RULER= "infoIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows task - * indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_TASK_INDICATION_IN_OVERVIEW_RULER= "taskIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows - * bookmark indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_BOOKMARK_INDICATION_IN_OVERVIEW_RULER= "bookmarkIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows - * search result indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER= "searchResultIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls whether the overview ruler shows - * unknown indicators. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String EDITOR_UNKNOWN_INDICATION_IN_OVERVIEW_RULER= "othersIndicationInOverviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls if temporary problems are evaluated and shown in the UI. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ -// public final static String EDITOR_EVALUTE_TEMPORARY_PROBLEMS= "handleTemporaryProblems"; //$NON-NLS-1$ - - /** - * A named preference that controls if the overview ruler is shown in the UI. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_OVERVIEW_RULER= "overviewRuler"; //$NON-NLS-1$ - - /** - * A named preference that controls if the line number ruler is shown in the UI. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String EDITOR_LINE_NUMBER_RULER= "lineNumberRuler"; //$NON-NLS-1$ - - /** - * A named preference that holds the color used to render line numbers inside the line number ruler. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - * @see #EDITOR_LINE_NUMBER_RULER - */ - public final static String EDITOR_LINE_NUMBER_RULER_COLOR= "lineNumberColor"; //$NON-NLS-1$ - - /** - * A named preference that controls if the Java code assist gets auto activated. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - */ - public final static String CODEASSIST_AUTOACTIVATION= "content_assist_autoactivation"; //$NON-NLS-1$ - - /** - * A name preference that holds the auto activation delay time in milli seconds. - * <p> - * Value is of type <code>Int</code>. - * </p> - */ - public final static String CODEASSIST_AUTOACTIVATION_DELAY= "content_assist_autoactivation_delay"; //$NON-NLS-1$ - - /** - * A named preference that controls if the Java code assist inserts a - * proposal automatically if only one proposal is available. - * <p> - * Value is of type <code>Boolean</code>. - * </p> - * @since 2.1 - */ - public final static String CODEASSIST_AUTOINSERT= "content_assist_autoinsert"; //$NON-NLS-1$ - - /** - * A named preference that holds the characters that auto activate code assist in Java code. - * <p> - * Value is of type <code>Sring</code>. All characters that trigger auto code assist in Java code. - * </p> - */ - public final static String CODEASSIST_AUTOACTIVATION_TRIGGERS= "content_assist_autoactivation_triggers_java"; //$NON-NLS-1$ - - /** - * A named preference that holds the background color used in the code assist selection dialog. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String CODEASSIST_PROPOSALS_BACKGROUND= "content_assist_proposals_background"; //$NON-NLS-1$ - - /** - * A named preference that holds the foreground color used in the code assist selection dialog. - * <p> - * Value is of type <code>String</code>. A RGB color value encoded as a string - * using class <code>PreferenceConverter</code> - * </p> - * - * @see org.eclipse.jface.resource.StringConverter - * @see org.eclipse.jface.preference.PreferenceConverter - */ - public final static String CODEASSIST_PROPOSALS_FOREGROUND= "content_assist_proposals_foreground"; //$NON-NLS-1$ - - public static void initializeDefaultValues(IPreferenceStore store) { - - store.setDefault(AntEditorPreferenceConstants.EDITOR_CURRENT_LINE, true); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_CURRENT_LINE_COLOR, new RGB(225, 235, 224)); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN, false); - store.setDefault(AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLUMN, 80); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLOR, new RGB(176, 180 , 185)); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION, true); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION_COLOR, new RGB(255, 0 , 128)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_ERROR_INDICATION_IN_OVERVIEW_RULER, true); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION, true); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_COLOR, new RGB(244, 200 , 45)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_IN_OVERVIEW_RULER, true); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_INFO_INDICATION, true); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_COLOR, new RGB(244, 200 , 45)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_IN_OVERVIEW_RULER, true); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_TASK_INDICATION, false); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_COLOR, new RGB(0, 128, 255)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_IN_OVERVIEW_RULER, false); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION, false); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_COLOR, new RGB(34, 164, 99)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_IN_OVERVIEW_RULER, false); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION, false); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_COLOR, new RGB(192, 192, 192)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER, false); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION, false); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_COLOR, new RGB(0, 0, 0)); - store.setDefault(AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_IN_OVERVIEW_RULER, false); - -// store.setDefault(AntEditorPreferenceConstants.EDITOR_EVALUTE_TEMPORARY_PROBLEMS, true); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_OVERVIEW_RULER, true); - - store.setDefault(AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER, false); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER_COLOR, new RGB(0, 0, 0)); - - store.setDefault(AntEditorPreferenceConstants.CODEASSIST_AUTOINSERT, true); - store.setDefault(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION, true); - store.setDefault(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_DELAY, 500); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_BACKGROUND, new RGB(254, 241, 233)); - PreferenceConverter.setDefault(store, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_FOREGROUND, new RGB(0, 0, 0)); - store.setDefault(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_TRIGGERS, "<${"); //$NON-NLS-1$ - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntEditorPreferencePage.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntEditorPreferencePage.java deleted file mode 100644 index 4694e82f3..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntEditorPreferencePage.java +++ /dev/null @@ -1,848 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.util.ArrayList; -import java.util.HashMap; -import java.util.Iterator; -import java.util.Map; - -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.ModifyEvent; -import org.eclipse.swt.events.ModifyListener; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.events.SelectionListener; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.graphics.RGB; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.List; -import org.eclipse.swt.widgets.TabFolder; -import org.eclipse.swt.widgets.TabItem; -import org.eclipse.swt.widgets.Text; - -import org.eclipse.core.runtime.IStatus; - -import org.eclipse.jface.dialogs.DialogPage; -import org.eclipse.jface.preference.PreferenceConverter; -import org.eclipse.jface.preference.PreferencePage; - -import org.eclipse.ui.IWorkbench; -import org.eclipse.ui.IWorkbenchPreferencePage; -import org.eclipse.ui.externaltools.internal.ant.editor.text.IAntEditorColorConstants; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.StatusInfo; -import org.eclipse.ui.help.WorkbenchHelp; - - -/* - * The page for setting the editor options. - */ -public class AntEditorPreferencePage extends PreferencePage implements IWorkbenchPreferencePage { - - public final OverlayPreferenceStore.OverlayKey[] fKeys= new OverlayPreferenceStore.OverlayKey[] { - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_CURRENT_LINE_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_CURRENT_LINE), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.INT, AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLUMN), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_INFO_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_TASK_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_ERROR_INDICATION_IN_OVERVIEW_RULER), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_IN_OVERVIEW_RULER), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_IN_OVERVIEW_RULER), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_IN_OVERVIEW_RULER), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_IN_OVERVIEW_RULER), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_IN_OVERVIEW_RULER), - -// new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_EVALUTE_TEMPORARY_PROBLEMS), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_OVERVIEW_RULER), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER_COLOR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, IAntEditorColorConstants.P_DEFAULT), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, IAntEditorColorConstants.P_PROC_INSTR), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, IAntEditorColorConstants.P_STRING), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, IAntEditorColorConstants.P_TAG), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, IAntEditorColorConstants.P_XML_COMMENT), - - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.INT, AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_DELAY), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.BOOLEAN, AntEditorPreferenceConstants.CODEASSIST_AUTOINSERT), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_BACKGROUND), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_FOREGROUND), - new OverlayPreferenceStore.OverlayKey(OverlayPreferenceStore.STRING, AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_TRIGGERS), - }; - - private final String[][] fAppearanceColorListModel= new String[][] { - {AntPreferencesMessages.getString("AntEditorPreferencePage.lineNumberForegroundColor"), AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER_COLOR}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.currentLineHighlighColor"), AntEditorPreferenceConstants.EDITOR_CURRENT_LINE_COLOR}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.printMarginColor"), AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLOR}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.Ant_editor_text_1"), IAntEditorColorConstants.P_DEFAULT, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.Ant_editor_processing_instuctions_2"), IAntEditorColorConstants.P_PROC_INSTR, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.Ant_editor_constant_strings_3"), IAntEditorColorConstants.P_STRING, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.Ant_editor_tags_4"), IAntEditorColorConstants.P_TAG, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.Ant_editor_comments_5"), IAntEditorColorConstants.P_XML_COMMENT, null} //$NON-NLS-1$ - - }; - - private final String[][] fAnnotationColorListModel= new String[][] { - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.errors"), AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_PROBLEM_INDICATION, AntEditorPreferenceConstants.EDITOR_ERROR_INDICATION_IN_OVERVIEW_RULER }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.warnings"), AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION, AntEditorPreferenceConstants.EDITOR_WARNING_INDICATION_IN_OVERVIEW_RULER }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.infos"), AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_INFO_INDICATION, AntEditorPreferenceConstants.EDITOR_INFO_INDICATION_IN_OVERVIEW_RULER }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.tasks"), AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_TASK_INDICATION, AntEditorPreferenceConstants.EDITOR_TASK_INDICATION_IN_OVERVIEW_RULER }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.searchResults"), AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION, AntEditorPreferenceConstants.EDITOR_SEARCH_RESULT_INDICATION_IN_OVERVIEW_RULER }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.bookmarks"), AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION, AntEditorPreferenceConstants.EDITOR_BOOKMARK_INDICATION_IN_OVERVIEW_RULER }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.others"), AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_COLOR, AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION, AntEditorPreferenceConstants.EDITOR_UNKNOWN_INDICATION_IN_OVERVIEW_RULER } //$NON-NLS-1$ - }; - - private final String[][] fContentAssistColorListModel= new String[][] { - {AntPreferencesMessages.getString("AntEditorPreferencePage.backgroundForCompletionProposals"), AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_BACKGROUND }, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntEditorPreferencePage.foregroundForCompletionProposals"), AntEditorPreferenceConstants.CODEASSIST_PROPOSALS_FOREGROUND }, //$NON-NLS-1$ - //{AntPreferencesMessages.getString("AntEditorPreferencePage.backgroundForCompletionReplacement"), AntEditorPreferenceConstants.CODEASSIST_REPLACEMENT_BACKGROUND }, //$NON-NLS-1$ - //{AntPreferencesMessages.getString("AntEditorPreferencePage.foregroundForCompletionReplacement"), AntEditorPreferenceConstants.CODEASSIST_REPLACEMENT_FOREGROUND } //$NON-NLS-1$ - }; - - private OverlayPreferenceStore fOverlayStore; - - private Map fCheckBoxes= new HashMap(); - private SelectionListener fCheckBoxListener= new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - } - public void widgetSelected(SelectionEvent e) { - Button button= (Button) e.widget; - fOverlayStore.setValue((String) fCheckBoxes.get(button), button.getSelection()); - } - }; - - private Map fTextFields= new HashMap(); - private ModifyListener fTextFieldListener= new ModifyListener() { - public void modifyText(ModifyEvent e) { - Text text= (Text) e.widget; - fOverlayStore.setValue((String) fTextFields.get(text), text.getText()); - } - }; - - private ArrayList fNumberFields= new ArrayList(); - private ModifyListener fNumberFieldListener= new ModifyListener() { - public void modifyText(ModifyEvent e) { - numberFieldChanged((Text) e.widget); - } - }; - - private List fAppearanceColorList; - private List fAnnotationList; - private List fContentAssistColorList; - - private ColorEditor fAppearanceColorEditor; - private ColorEditor fAnnotationForegroundColorEditor; - private ColorEditor fContentAssistColorEditor; - - private Button fShowInTextCheckBox; - private Button fShowInOverviewRulerCheckBox; - - private Control fAutoInsertDelayText; - private Control fAutoInsertTriggerText; - private Label fAutoInsertDelayLabel; - private Label fAutoInsertTriggerLabel; - - public AntEditorPreferencePage() { - setDescription(AntPreferencesMessages.getString("AntEditorPreferencePage.description")); //$NON-NLS-1$ - setPreferenceStore(ExternalToolsPlugin.getDefault().getPreferenceStore()); - fOverlayStore= new OverlayPreferenceStore(getPreferenceStore(), fKeys); - } - - /* - * @see IWorkbenchPreferencePage#init() - */ - public void init(IWorkbench workbench) { - } - - private Label getLabelControl(Control[] labelledTextField){ - return (Label)labelledTextField[0]; - } - - private Text getTextControl(Control[] labelledTextField){ - return (Text)labelledTextField[1]; - } - - private void handleAppearanceColorListSelection() { - int i= fAppearanceColorList.getSelectionIndex(); - String key= fAppearanceColorListModel[i][1]; - RGB rgb= PreferenceConverter.getColor(fOverlayStore, key); - fAppearanceColorEditor.setColorValue(rgb); - } - - private void handleAnnotationListSelection() { - int i= fAnnotationList.getSelectionIndex(); - - String key= fAnnotationColorListModel[i][1]; - RGB rgb= PreferenceConverter.getColor(fOverlayStore, key); - fAnnotationForegroundColorEditor.setColorValue(rgb); - - key= fAnnotationColorListModel[i][2]; - fShowInTextCheckBox.setSelection(fOverlayStore.getBoolean(key)); - - key= fAnnotationColorListModel[i][3]; - fShowInOverviewRulerCheckBox.setSelection(fOverlayStore.getBoolean(key)); - } - - private Control createAppearancePage(Composite parent) { - Font font= parent.getFont(); - - Composite appearanceComposite= new Composite(parent, SWT.NONE); - appearanceComposite.setFont(font); - GridLayout layout= new GridLayout(); layout.numColumns= 2; - appearanceComposite.setLayout(layout); - - String labelText= AntPreferencesMessages.getString("AntEditorPreferencePage.printMarginColumn"); //$NON-NLS-1$ - addTextField(appearanceComposite, labelText, AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN_COLUMN, 3, 0, true); - - labelText= AntPreferencesMessages.getString("AntEditorPreferencePage.showOverviewRuler"); //$NON-NLS-1$ - addCheckBox(appearanceComposite, labelText, AntEditorPreferenceConstants.EDITOR_OVERVIEW_RULER, 0); - - labelText= AntPreferencesMessages.getString("AntEditorPreferencePage.showLineNumbers"); //$NON-NLS-1$ - addCheckBox(appearanceComposite, labelText, AntEditorPreferenceConstants.EDITOR_LINE_NUMBER_RULER, 0); - - labelText= AntPreferencesMessages.getString("AntEditorPreferencePage.highlightCurrentLine"); //$NON-NLS-1$ - addCheckBox(appearanceComposite, labelText, AntEditorPreferenceConstants.EDITOR_CURRENT_LINE, 0); - - labelText= AntPreferencesMessages.getString("AntEditorPreferencePage.showPrintMargin"); //$NON-NLS-1$ - addCheckBox(appearanceComposite, labelText, AntEditorPreferenceConstants.EDITOR_PRINT_MARGIN, 0); - - - Label label= new Label(appearanceComposite, SWT.LEFT ); - label.setFont(font); - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL); - gd.horizontalSpan= 2; - gd.heightHint= convertHeightInCharsToPixels(1) / 2; - label.setLayoutData(gd); - - label= new Label(appearanceComposite, SWT.LEFT); - label.setFont(font); - label.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.appearanceOptions")); //$NON-NLS-1$ - gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL); - gd.horizontalSpan= 2; - label.setLayoutData(gd); - - Composite editorComposite= new Composite(appearanceComposite, SWT.NONE); - editorComposite.setFont(font); - layout= new GridLayout(); - layout.numColumns= 2; - layout.marginHeight= 0; - layout.marginWidth= 0; - editorComposite.setLayout(layout); - gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.FILL_VERTICAL); - gd.horizontalSpan= 2; - editorComposite.setLayoutData(gd); - - fAppearanceColorList= new List(editorComposite, SWT.SINGLE | SWT.V_SCROLL | SWT.BORDER); - fAppearanceColorList.setFont(font); - gd= new GridData(GridData.VERTICAL_ALIGN_BEGINNING | GridData.FILL_HORIZONTAL); - gd.heightHint= convertHeightInCharsToPixels(8); - fAppearanceColorList.setLayoutData(gd); - - Composite stylesComposite= new Composite(editorComposite, SWT.NONE); - stylesComposite.setFont(font); - layout= new GridLayout(); - layout.marginHeight= 0; - layout.marginWidth= 0; - layout.numColumns= 2; - stylesComposite.setLayout(layout); - stylesComposite.setLayoutData(new GridData(GridData.FILL_BOTH)); - - label= new Label(stylesComposite, SWT.LEFT); - label.setFont(font); - label.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.color")); //$NON-NLS-1$ - gd= new GridData(); - gd.horizontalAlignment= GridData.BEGINNING; - label.setLayoutData(gd); - - fAppearanceColorEditor= new ColorEditor(stylesComposite); - Button foregroundColorButton= fAppearanceColorEditor.getButton(); - foregroundColorButton.setFont(font); - gd= new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalAlignment= GridData.BEGINNING; - foregroundColorButton.setLayoutData(gd); - - fAppearanceColorList.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - public void widgetSelected(SelectionEvent e) { - handleAppearanceColorListSelection(); - } - }); - foregroundColorButton.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - public void widgetSelected(SelectionEvent e) { - int i= fAppearanceColorList.getSelectionIndex(); - String key= fAppearanceColorListModel[i][1]; - - PreferenceConverter.setValue(fOverlayStore, key, fAppearanceColorEditor.getColorValue()); - } - }); - return appearanceComposite; - } - - /** - * Returns an array of size 2: - * - first element is of type <code>Label</code> - * - second element is of type <code>Text</code> - * Use <code>getLabelControl</code> and <code>getTextControl</code> to get the 2 controls. - */ - private Control[] addLabelledTextField(Composite composite, String label, String key, int textLimit, int indentation, boolean isNumber) { - Label labelControl= new Label(composite, SWT.NONE); - labelControl.setText(label); - labelControl.setFont(composite.getFont()); - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalIndent= indentation; - labelControl.setLayoutData(gd); - - Text textControl= new Text(composite, SWT.BORDER | SWT.SINGLE); - gd= new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.widthHint= convertWidthInCharsToPixels(textLimit + 1); - textControl.setLayoutData(gd); - textControl.setTextLimit(textLimit); - textControl.setFont(composite.getFont()); - fTextFields.put(textControl, key); - if (isNumber) { - fNumberFields.add(textControl); - textControl.addModifyListener(fNumberFieldListener); - } else { - textControl.addModifyListener(fTextFieldListener); - } - - return new Control[]{labelControl, textControl}; - } - - private Control createContentAssistPage(Composite parent) { - Font font= parent.getFont(); - Composite contentAssistComposite= new Composite(parent, SWT.NULL); - GridLayout layout= new GridLayout(); - layout.numColumns= 2; - contentAssistComposite.setLayout(layout); - contentAssistComposite.setFont(font); - - String text= AntPreferencesMessages.getString("AntEditorPreferencePage.Insert"); //$NON-NLS-1$ - addCheckBox(contentAssistComposite, text, AntEditorPreferenceConstants.CODEASSIST_AUTOINSERT, 0); - - //text= "&Fill parameters automatically"; - //addCheckBox(contentAssistComposite, text, AntEditorPreferenceConstants.CODEASSIST_FILL_ARGUMENT_NAMES, 0); - - text= AntPreferencesMessages.getString("AntEditorPreferencePage.&Enable_auto_activation_2"); //$NON-NLS-1$ - final Button autoactivation= addCheckBox(contentAssistComposite, text, AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION, 0); - autoactivation.addSelectionListener(new SelectionAdapter(){ - public void widgetSelected(SelectionEvent e) { - updateAutoactivationControls(); - } - }); - - Control[] labelledTextField; - text= AntPreferencesMessages.getString("AntEditorPreferencePage.Auto_activation_&delay__3"); //$NON-NLS-1$ - labelledTextField= addLabelledTextField(contentAssistComposite, text, AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_DELAY, 4, 0, true); - fAutoInsertDelayLabel= getLabelControl(labelledTextField); - fAutoInsertDelayText= getTextControl(labelledTextField); - - text= AntPreferencesMessages.getString("AntEditorPreferencePage.Auto_activation_tri&ggers__4"); //$NON-NLS-1$ - labelledTextField= addLabelledTextField(contentAssistComposite, text, AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION_TRIGGERS, 4, 0, false); - fAutoInsertTriggerLabel= getLabelControl(labelledTextField); - fAutoInsertTriggerText= getTextControl(labelledTextField); - - Label label= new Label(contentAssistComposite, SWT.LEFT); - label.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.Code_assist_colo&r_options__5")); //$NON-NLS-1$ - label.setFont(font); - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL); - gd.horizontalSpan= 2; - label.setLayoutData(gd); - - Composite editorComposite= new Composite(contentAssistComposite, SWT.NONE); - layout= new GridLayout(); - layout.numColumns= 2; - layout.marginHeight= 0; - layout.marginWidth= 0; - editorComposite.setLayout(layout); - editorComposite.setFont(font); - gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.FILL_VERTICAL); - gd.horizontalSpan= 2; - editorComposite.setLayoutData(gd); - - fContentAssistColorList= new List(editorComposite, SWT.SINGLE | SWT.V_SCROLL | SWT.BORDER); - gd= new GridData(GridData.VERTICAL_ALIGN_BEGINNING | GridData.FILL_HORIZONTAL); - gd.heightHint= convertHeightInCharsToPixels(8); - fContentAssistColorList.setLayoutData(gd); - fContentAssistColorList.setFont(font); - - Composite stylesComposite= new Composite(editorComposite, SWT.NONE); - layout= new GridLayout(); - layout.marginHeight= 0; - layout.marginWidth= 0; - layout.numColumns= 2; - stylesComposite.setLayout(layout); - stylesComposite.setLayoutData(new GridData(GridData.FILL_BOTH)); - stylesComposite.setFont(font); - - label= new Label(stylesComposite, SWT.LEFT); - label.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.Col&or__6")); //$NON-NLS-1$ - label.setFont(font); - gd= new GridData(); - gd.horizontalAlignment= GridData.BEGINNING; - label.setLayoutData(gd); - - fContentAssistColorEditor= new ColorEditor(stylesComposite); - Button colorButton= fContentAssistColorEditor.getButton(); - gd= new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalAlignment= GridData.BEGINNING; - colorButton.setLayoutData(gd); - - fContentAssistColorList.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - public void widgetSelected(SelectionEvent e) { - handleContentAssistColorListSelection(); - } - }); - - colorButton.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - public void widgetSelected(SelectionEvent e) { - int i= fContentAssistColorList.getSelectionIndex(); - String key= fContentAssistColorListModel[i][1]; - - PreferenceConverter.setValue(fOverlayStore, key, fContentAssistColorEditor.getColorValue()); - } - }); - - return contentAssistComposite; - } - - private void handleContentAssistColorListSelection() { - int i= fContentAssistColorList.getSelectionIndex(); - String key= fContentAssistColorListModel[i][1]; - RGB rgb= PreferenceConverter.getColor(fOverlayStore, key); - fContentAssistColorEditor.setColorValue(rgb); - } - - private void updateAutoactivationControls() { - boolean autoactivation= fOverlayStore.getBoolean(AntEditorPreferenceConstants.CODEASSIST_AUTOACTIVATION); - fAutoInsertDelayText.setEnabled(autoactivation); - fAutoInsertDelayLabel.setEnabled(autoactivation); - - fAutoInsertTriggerText.setEnabled(autoactivation); - fAutoInsertTriggerLabel.setEnabled(autoactivation); - } - - private Control createAnnotationsPage(Composite parent) { - Font font= parent.getFont(); - Composite composite= new Composite(parent, SWT.NULL); - composite.setFont(font); - GridLayout layout= new GridLayout(); layout.numColumns= 2; - composite.setLayout(layout); - -// String text= AntPreferencesMessages.getString("AntEditorPreferencePage.analyseAnnotationsWhileTyping"); //$NON-NLS-1$ -// addCheckBox(composite, text, AntEditorPreferenceConstants.EDITOR_EVALUTE_TEMPORARY_PROBLEMS, 0); -// -// addFiller(composite); - - Label label= new Label(composite, SWT.LEFT); - label.setFont(font); - label.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.annotationPresentationOptions")); //$NON-NLS-1$ - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL); - gd.horizontalSpan= 2; - label.setLayoutData(gd); - - Composite editorComposite= new Composite(composite, SWT.NONE); - editorComposite.setFont(font); - layout= new GridLayout(); - layout.numColumns= 2; - layout.marginHeight= 0; - layout.marginWidth= 0; - editorComposite.setLayout(layout); - gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.FILL_VERTICAL); - gd.horizontalSpan= 2; - editorComposite.setLayoutData(gd); - - fAnnotationList= new List(editorComposite, SWT.SINGLE | SWT.V_SCROLL | SWT.BORDER); - fAnnotationList.setFont(font); - gd= new GridData(GridData.VERTICAL_ALIGN_BEGINNING | GridData.FILL_HORIZONTAL); - gd.heightHint= convertHeightInCharsToPixels(8); - fAnnotationList.setLayoutData(gd); - - Composite optionsComposite= new Composite(editorComposite, SWT.NONE); - optionsComposite.setFont(font); - layout= new GridLayout(); - layout.marginHeight= 0; - layout.marginWidth= 0; - layout.numColumns= 2; - optionsComposite.setLayout(layout); - optionsComposite.setLayoutData(new GridData(GridData.FILL_BOTH)); - - fShowInTextCheckBox= new Button(optionsComposite, SWT.CHECK); - fShowInTextCheckBox.setFont(font); - fShowInTextCheckBox.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.showInText")); //$NON-NLS-1$ - gd= new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalAlignment= GridData.BEGINNING; - gd.horizontalSpan= 2; - fShowInTextCheckBox.setLayoutData(gd); - - fShowInOverviewRulerCheckBox= new Button(optionsComposite, SWT.CHECK); - fShowInOverviewRulerCheckBox.setFont(font); - fShowInOverviewRulerCheckBox.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.showInOverviewRuler")); //$NON-NLS-1$ - gd= new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalAlignment= GridData.BEGINNING; - gd.horizontalSpan= 2; - fShowInOverviewRulerCheckBox.setLayoutData(gd); - - label= new Label(optionsComposite, SWT.LEFT); - label.setFont(font); - label.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.annotations.color")); //$NON-NLS-1$ - gd= new GridData(); - gd.horizontalAlignment= GridData.BEGINNING; - label.setLayoutData(gd); - - fAnnotationForegroundColorEditor= new ColorEditor(optionsComposite); - Button foregroundColorButton= fAnnotationForegroundColorEditor.getButton(); - foregroundColorButton.setFont(font); - gd= new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalAlignment= GridData.BEGINNING; - foregroundColorButton.setLayoutData(gd); - - fAnnotationList.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - - public void widgetSelected(SelectionEvent e) { - handleAnnotationListSelection(); - } - }); - - fShowInTextCheckBox.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - - public void widgetSelected(SelectionEvent e) { - int i= fAnnotationList.getSelectionIndex(); - String key= fAnnotationColorListModel[i][2]; - fOverlayStore.setValue(key, fShowInTextCheckBox.getSelection()); - } - }); - - fShowInOverviewRulerCheckBox.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - - public void widgetSelected(SelectionEvent e) { - int i= fAnnotationList.getSelectionIndex(); - String key= fAnnotationColorListModel[i][3]; - fOverlayStore.setValue(key, fShowInOverviewRulerCheckBox.getSelection()); - } - }); - - foregroundColorButton.addSelectionListener(new SelectionListener() { - public void widgetDefaultSelected(SelectionEvent e) { - // do nothing - } - - public void widgetSelected(SelectionEvent e) { - int i= fAnnotationList.getSelectionIndex(); - String key= fAnnotationColorListModel[i][1]; - PreferenceConverter.setValue(fOverlayStore, key, fAnnotationForegroundColorEditor.getColorValue()); - } - }); - - return composite; - } - -// private void addFiller(Composite composite) { -// Label filler= new Label(composite, SWT.LEFT ); -// GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL); -// gd.horizontalSpan= 2; -// gd.heightHint= convertHeightInCharsToPixels(1) / 2; -// filler.setLayoutData(gd); -// } - - /* - * @see PreferencePage#createContents(Composite) - */ - protected Control createContents(Composite parent) { - - WorkbenchHelp.setHelp(getControl(), IExternalToolsHelpContextIds.ANT_EDITOR_PREFERENCE_PAGE); - fOverlayStore.load(); - fOverlayStore.start(); - - Font font= parent.getFont(); - TabFolder folder= new TabFolder(parent, SWT.NONE); - folder.setLayout(new TabFolderLayout()); - folder.setLayoutData(new GridData(GridData.FILL_BOTH)); - folder.setFont(font); - - TabItem item= new TabItem(folder, SWT.NONE); - item.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.general")); //$NON-NLS-1$ - item.setControl(createAppearancePage(folder)); - - item= new TabItem(folder, SWT.NONE); - item.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.codeAssistTab.title")); //$NON-NLS-1$ - item.setControl(createContentAssistPage(folder)); - - item= new TabItem(folder, SWT.NONE); - item.setText(AntPreferencesMessages.getString("AntEditorPreferencePage.annotationsTab.title")); //$NON-NLS-1$ - item.setControl(createAnnotationsPage(folder)); - - - - initialize(); - - return folder; - } - - private void initialize() { - - initializeFields(); - - for (int i= 0; i < fAppearanceColorListModel.length; i++) { - fAppearanceColorList.add(fAppearanceColorListModel[i][0]); - } - fAppearanceColorList.getDisplay().asyncExec(new Runnable() { - public void run() { - if (fAppearanceColorList != null && !fAppearanceColorList.isDisposed()) { - fAppearanceColorList.select(0); - handleAppearanceColorListSelection(); - } - } - }); - - for (int i= 0; i < fAnnotationColorListModel.length; i++) { - fAnnotationList.add(fAnnotationColorListModel[i][0]); - } - fAnnotationList.getDisplay().asyncExec(new Runnable() { - public void run() { - if (fAnnotationList != null && !fAnnotationList.isDisposed()) { - fAnnotationList.select(0); - handleAnnotationListSelection(); - } - } - }); - - for (int i= 0; i < fContentAssistColorListModel.length; i++) { - fContentAssistColorList.add(fContentAssistColorListModel[i][0]); - } - fContentAssistColorList.getDisplay().asyncExec(new Runnable() { - public void run() { - if (fContentAssistColorList != null && !fContentAssistColorList.isDisposed()) { - fContentAssistColorList.select(0); - handleContentAssistColorListSelection(); - } - } - }); - } - - private void initializeFields() { - - Iterator e= fCheckBoxes.keySet().iterator(); - while (e.hasNext()) { - Button b= (Button) e.next(); - String key= (String) fCheckBoxes.get(b); - b.setSelection(fOverlayStore.getBoolean(key)); - } - - e= fTextFields.keySet().iterator(); - while (e.hasNext()) { - Text t= (Text) e.next(); - String key= (String) fTextFields.get(t); - t.setText(fOverlayStore.getString(key)); - } - } - - /* - * @see PreferencePage#performOk() - */ - public boolean performOk() { - fOverlayStore.propagate(); - ExternalToolsPlugin.getDefault().savePluginPreferences(); - return true; - } - - /* - * @see PreferencePage#performDefaults() - */ - protected void performDefaults() { - - fOverlayStore.loadDefaults(); - - initializeFields(); - - handleAppearanceColorListSelection(); - handleAnnotationListSelection(); - handleContentAssistColorListSelection(); - - super.performDefaults(); - } - - /* - * @see DialogPage#dispose() - */ - public void dispose() { - - if (fOverlayStore != null) { - fOverlayStore.stop(); - fOverlayStore= null; - } - - super.dispose(); - } - - private Button addCheckBox(Composite parent, String labelText, String key, int indentation) { - Button checkBox= new Button(parent, SWT.CHECK); - checkBox.setText(labelText); - checkBox.setFont(parent.getFont()); - - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalIndent= indentation; - gd.horizontalSpan= 2; - checkBox.setLayoutData(gd); - checkBox.addSelectionListener(fCheckBoxListener); - - fCheckBoxes.put(checkBox, key); - - return checkBox; - } - - private Control addTextField(Composite composite, String labelText, String key, int textLimit, int indentation, boolean isNumber) { - Font font= composite.getFont(); - - Label label= new Label(composite, SWT.NONE); - label.setText(labelText); - label.setFont(font); - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalIndent= indentation; - label.setLayoutData(gd); - - Text textControl= new Text(composite, SWT.BORDER | SWT.SINGLE); - textControl.setFont(font); - gd= new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.widthHint= convertWidthInCharsToPixels(textLimit + 1); - textControl.setLayoutData(gd); - textControl.setTextLimit(textLimit); - fTextFields.put(textControl, key); - if (isNumber) { - fNumberFields.add(textControl); - textControl.addModifyListener(fNumberFieldListener); - } else { - textControl.addModifyListener(fTextFieldListener); - } - - return textControl; - } - - private void numberFieldChanged(Text textControl) { - String number= textControl.getText(); - IStatus status= validatePositiveNumber(number); - if (!status.matches(IStatus.ERROR)) - fOverlayStore.setValue((String) fTextFields.get(textControl), number); - updateStatus(status); - } - - private IStatus validatePositiveNumber(String number) { - StatusInfo status= new StatusInfo(); - if (number.length() == 0) { - status.setError(AntPreferencesMessages.getString("AntEditorPreferencePage.empty_input")); //$NON-NLS-1$ - } else { - try { - int value= Integer.parseInt(number); - if (value < 0) - status.setError(AntPreferencesMessages.getFormattedString("AntEditorPreferencePage.invalid_input", number)); //$NON-NLS-1$ - } catch (NumberFormatException e) { - status.setError(AntPreferencesMessages.getFormattedString("AntEditorPreferencePage.invalid_input", number)); //$NON-NLS-1$ - } - } - return status; - } - - private void updateStatus(IStatus status) { - if (!status.matches(IStatus.ERROR)) { - for (int i= 0; i < fNumberFields.size(); i++) { - Text text= (Text) fNumberFields.get(i); - IStatus s= validatePositiveNumber(text.getText()); - status= s.getSeverity() > status.getSeverity() ? s : status; - } - } - setValid(!status.matches(IStatus.ERROR)); - applyToStatusLine(this, status); - } - - /** - * Applies the status to the status line of a dialog page. - */ - public void applyToStatusLine(DialogPage page, IStatus status) { - String message= status.getMessage(); - switch (status.getSeverity()) { - case IStatus.OK: - page.setMessage(message, DialogPage.NONE); - page.setErrorMessage(null); - break; - case IStatus.WARNING: - page.setMessage(message, DialogPage.WARNING); - page.setErrorMessage(null); - break; - case IStatus.INFO: - page.setMessage(message, DialogPage.INFORMATION); - page.setErrorMessage(null); - break; - default: - if (message.length() == 0) { - message= null; - } - page.setMessage(null); - page.setErrorMessage(message); - break; - } - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPage.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPage.java deleted file mode 100644 index 7221769f0..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPage.java +++ /dev/null @@ -1,338 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.ant.internal.core.AntObject; -import org.eclipse.jface.dialogs.IDialogConstants; -import org.eclipse.jface.viewers.DoubleClickEvent; -import org.eclipse.jface.viewers.IDoubleClickListener; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.ITableLabelProvider; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.jface.viewers.TableViewer; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Shell; -import org.eclipse.swt.widgets.TabFolder; -import org.eclipse.swt.widgets.TabItem; -import org.eclipse.swt.widgets.Table; -import org.eclipse.ui.externaltools.internal.ui.ExternalToolsContentProvider; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Provides the generic implementation for a sub-page in the - * Ant preference page. - */ -public abstract class AntPage { - protected SelectionAdapter selectionAdapter = new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - buttonPressed(((Integer) e.widget.getData()).intValue()); - } - }; - private AntRuntimePreferencePage preferencePage; - private TableViewer tableViewer; - private ExternalToolsContentProvider contentProvider; - - protected Button editButton; - protected Button removeButton; - - /** - * Creates an instance of this page. - */ - public AntPage(AntRuntimePreferencePage preferencePage) { - super(); - this.preferencePage = preferencePage; - } - - /** - * Adds buttons specific to the page. - */ - protected abstract void addButtonsToButtonGroup(Composite parent); - - /** - * Give this page a chance to initialize itself - */ - protected abstract void initialize(); - - /** - * Adds an object to the contents - */ - protected void addContent(Object o) { - if (contentProvider != null) { - contentProvider.add(o); - } - } - - /** - * Handles a button pressed event. - */ - protected void buttonPressed(int buttonId) { - } - - /** - * Creates and returns a button with appropriate size and layout. - * - * @param parent the control to create the button on - * @param labelKey the key to lookup the button's label - * @param buttonId the id to assign to this button - * @return a new and initialized button - */ - protected Button createPushButton(Composite parent, String buttonText, int buttonId) { - Button button = new Button(parent, SWT.PUSH); - button.setFont(parent.getFont()); - button.setText(buttonText); - button.setData(new Integer(buttonId)); - button.addSelectionListener(selectionAdapter); - preferencePage.setButtonLayoutData(button); - return button; - } - - /** - * Creates the group which will contain the buttons. - */ - protected void createButtonGroup(Composite top) { - Composite buttonGroup = new Composite(top, SWT.NONE); - GridLayout layout = new GridLayout(); - layout.marginHeight = 0; - layout.marginWidth = 0; - buttonGroup.setLayout(layout); - buttonGroup.setLayoutData(new GridData(GridData.FILL_VERTICAL)); - buttonGroup.setFont(top.getFont()); - - addButtonsToButtonGroup(buttonGroup); - } - - /** - * Creates a space between controls - */ - protected final Label createSeparator(Composite parent) { - Label separator = new Label(parent, SWT.NONE); - GridData gd = new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.VERTICAL_ALIGN_BEGINNING); - gd.heightHint = 4; - separator.setLayoutData(gd); - return separator; - } - - /** - * Creates the table viewer. - */ - protected void createTable(Composite parent) { - Table table = new Table(parent, SWT.MULTI | SWT.FULL_SELECTION | SWT.BORDER); - GridData data= new GridData(GridData.FILL_BOTH); - data.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - data.heightHint = table.getItemHeight(); - data.horizontalSpan= 1; - table.setLayoutData(data); - table.setFont(parent.getFont()); - - contentProvider = getContentProvider(); - tableViewer = new TableViewer(table); - tableViewer.setContentProvider(contentProvider); - tableViewer.setLabelProvider(getLabelProvider()); - tableViewer.addSelectionChangedListener(new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - tableSelectionChanged((IStructuredSelection) event.getSelection()); - } - }); - - tableViewer.addDoubleClickListener(new IDoubleClickListener() { - public void doubleClick(DoubleClickEvent event) { - edit((IStructuredSelection)event.getSelection()); - } - }); - } - - /** - * Returns the content provider to use for the table viewer - * - * @return AntPageContentProvider - */ - protected ExternalToolsContentProvider getContentProvider() { - return new ExternalToolsContentProvider(); - } - - /** - * Returns the currently listed objects in the table. Returns null - * if this widget has not yet been created or has been disposed. - */ - protected List getContents(boolean forDisplay) { - if (tableViewer == null || tableViewer.getControl().isDisposed()) { - return null; - } - List URLs= getPreferencePage().getLibraryURLs(); - Object[] elements = contentProvider.getElements(tableViewer.getInput()); - List contents= new ArrayList(elements.length); - Object element; - AntObject antObject; - for (int i = 0; i < elements.length; i++) { - element= elements[i]; - if (element instanceof AntObject) { - antObject= (AntObject)element; - if (forDisplay) { - if (!antObject.isDefault() && !URLs.contains(antObject.getLibrary())) { - continue; - } - } else if (antObject.isDefault() || !URLs.contains(antObject.getLibrary())) { - continue; - } - } - contents.add(element); - } - return contents; - } - - /** - * Returns the label provider the sub-page wants to use - * to display its content with. - */ - protected abstract ITableLabelProvider getLabelProvider(); - - /** - * Returns the selection in the viewer, or <code>null</code> if none. - */ - protected final IStructuredSelection getSelection() { - if (tableViewer == null || tableViewer.getControl().isDisposed()) { - return null; - } - return ((IStructuredSelection) tableViewer.getSelection()); - } - - /** - * Returns the shell of the sub-page. - */ - protected final Shell getShell() { - if (tableViewer == null || tableViewer.getControl().isDisposed()) { - return null; - } - return tableViewer.getControl().getShell(); - } - - /** - * Handles the remove button pressed event - */ - protected void remove() { - remove(tableViewer); - } - - protected void remove(TableViewer viewer) { - ExternalToolsContentProvider antContentProvider= (ExternalToolsContentProvider)viewer.getContentProvider(); - IStructuredSelection sel = (IStructuredSelection) viewer.getSelection(); - Iterator enum = sel.iterator(); - while (enum.hasNext()) { - antContentProvider.remove(enum.next()); - } - } - - /** - * Sets the contents of the table on this page. Has no effect - * if this widget has not yet been created or has been disposed. - */ - protected void setInput(List inputs) { - if (tableViewer == null || tableViewer.getControl().isDisposed()) { - return; - } - tableViewer.setInput(inputs); - tableSelectionChanged((IStructuredSelection) tableViewer.getSelection()); - } - - /** - * Updates the content element in the table viewer. - */ - protected final void updateContent(Object element) { - if (tableViewer == null || tableViewer.getControl().isDisposed()) { - return; - } - tableViewer.update(element, null); - } - - /** - * Creates the default contents of this page - */ - protected Composite createContents(Composite top) { - WorkbenchHelp.setHelp(top, getHelpContextId()); - GridLayout layout = new GridLayout(); - layout.numColumns = 2; - layout.marginHeight = 2; - layout.marginWidth = 2; - top.setLayout(layout); - - top.setLayoutData(new GridData(GridData.FILL_BOTH)); - - createTable(top); - createButtonGroup(top); - - return top; - } - - protected AntRuntimePreferencePage getPreferencePage() { - return preferencePage; - } - - protected TableViewer getTableViewer() { - return tableViewer; - } - - /** - * Handles selection changes in the table viewer. - */ - protected void tableSelectionChanged(IStructuredSelection newSelection) { - int size = newSelection.size(); - boolean enabled= true; - - Iterator itr= newSelection.iterator(); - while (itr.hasNext()) { - Object element = itr.next(); - if (element instanceof AntObject) { - AntObject antObject= (AntObject)element; - if (antObject.isDefault()) { - enabled= false; - break; - } - } - } - editButton.setEnabled(enabled && size == 1); - removeButton.setEnabled(enabled && size > 0); - } - - protected void edit(IStructuredSelection selection) { - } - - /** - * Returns this page's help context id, which is hooked - * to this page on creation. - * - * @return help context id - */ - protected abstract String getHelpContextId(); - - protected void connectToFolder(final TabItem item, TabFolder folder) { - folder.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - if (e.item == item) { - //remove ant objects whose library has been removed - setInput(getContents(true)); - } - } - }); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencePage.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencePage.java deleted file mode 100644 index 2db4e7eef..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencePage.java +++ /dev/null @@ -1,240 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.jface.preference.FieldEditorPreferencePage; -import org.eclipse.jface.preference.IPreferenceStore; -import org.eclipse.jface.preference.PreferenceConverter; -import org.eclipse.jface.preference.StringFieldEditor; -import org.eclipse.jface.resource.StringConverter; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.ModifyEvent; -import org.eclipse.swt.events.ModifyListener; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.graphics.RGB; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.List; -import org.eclipse.ui.IWorkbench; -import org.eclipse.ui.IWorkbenchPreferencePage; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.model.IPreferenceConstants; -import org.eclipse.ui.help.WorkbenchHelp; - -public class AntPreferencePage extends FieldEditorPreferencePage implements IWorkbenchPreferencePage { - - private StringFieldEditor fBuildFileNames; - - private List fAppearanceColorList; - private ColorEditor fAppearanceColorEditor; - - // Array containing the message to display, the preference key, and the - // default value (initialized in storeInitialValues()) for each color preference - private final String[][] fAppearanceColorListModel= new String[][] { - {AntPreferencesMessages.getString("AntPreferencePage.&Error__2"), IPreferenceConstants.CONSOLE_ERROR_RGB, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntPreferencePage.&Warning__3"), IPreferenceConstants.CONSOLE_WARNING_RGB, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntPreferencePage.I&nformation__4"), IPreferenceConstants.CONSOLE_INFO_RGB, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntPreferencePage.Ve&rbose__5"), IPreferenceConstants.CONSOLE_VERBOSE_RGB, null}, //$NON-NLS-1$ - {AntPreferencesMessages.getString("AntPreferencePage.Deb&ug__6"), IPreferenceConstants.CONSOLE_DEBUG_RGB, null}, //$NON-NLS-1$ - }; - - /** - * Create the Ant page. - */ - public AntPreferencePage() { - super(GRID); - setDescription(AntPreferencesMessages.getString("AntPreferencePage.General")); //$NON-NLS-1$ - setPreferenceStore(ExternalToolsPlugin.getDefault().getPreferenceStore()); - } - - /** - * @see org.eclipse.jface.preference.FieldEditorPreferencePage#createFieldEditors() - */ - protected void createFieldEditors() { - storeAppliedValues(); - - Font font= getFieldEditorParent().getFont(); - Label label= new Label(getFieldEditorParent(), SWT.NONE); - label.setText(AntPreferencesMessages.getString("AntPreferencePage.Enter")); //$NON-NLS-1$ - GridData gd= new GridData(); - gd.horizontalSpan= 2; - label.setLayoutData(gd); - label.setFont(font); - - fBuildFileNames = new StringFieldEditor(IPreferenceConstants.ANT_FIND_BUILD_FILE_NAMES, AntPreferencesMessages.getString("AntPreferencePage.&Names__3"), getFieldEditorParent()); //$NON-NLS-1$ - addField(fBuildFileNames); - fBuildFileNames.getTextControl(getFieldEditorParent()).addModifyListener(new ModifyListener() { - public void modifyText(ModifyEvent e) { - - } - }); - - label= new Label(getFieldEditorParent(), SWT.NONE); - label.setFont(font); - createColorComposite(); - } - - /** - * Stores the initial values of the color preferences. The preference values are updated - * on the fly as the user edits them (instead of only when they press "Apply"). We need - * to store the old values so that we can reset them when the user chooses "Cancel". - */ - private void storeAppliedValues() { - IPreferenceStore store= getPreferenceStore(); - for (int i = 0; i < fAppearanceColorListModel.length; i++) { - String preference = fAppearanceColorListModel[i][1]; - fAppearanceColorListModel[i][2]= store.getString(preference); - } - } - - private void createColorComposite() { - Font font= getFieldEditorParent().getFont(); - Label label= new Label(getFieldEditorParent(), SWT.LEFT); - label.setText(AntPreferencesMessages.getString("AntPreferencePage.Ant_Color_Options__6")); //$NON-NLS-1$ - label.setFont(font); - GridData gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL); - gd.horizontalSpan= 2; - label.setLayoutData(gd); - - Composite editorComposite= new Composite(getFieldEditorParent(), SWT.NONE); - GridLayout layout= new GridLayout(); - layout.numColumns= 2; - layout.marginHeight= 0; - layout.marginWidth= 0; - editorComposite.setLayout(layout); - editorComposite.setFont(font); - gd= new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.FILL_VERTICAL); - gd.horizontalSpan= 2; - editorComposite.setLayoutData(gd); - - fAppearanceColorList= new List(editorComposite, SWT.SINGLE | SWT.V_SCROLL | SWT.H_SCROLL | SWT.BORDER); - gd= new GridData(GridData.VERTICAL_ALIGN_BEGINNING | GridData.FILL_HORIZONTAL); - gd.heightHint= convertHeightInCharsToPixels(8); - fAppearanceColorList.setLayoutData(gd); - fAppearanceColorList.setFont(font); - - Composite stylesComposite= new Composite(editorComposite, SWT.NONE); - layout= new GridLayout(); - layout.marginHeight= 0; - layout.marginWidth= 0; - layout.numColumns= 2; - stylesComposite.setLayout(layout); - stylesComposite.setLayoutData(new GridData(GridData.FILL_BOTH)); - stylesComposite.setFont(font); - - label= new Label(stylesComposite, SWT.LEFT); - label.setText(AntPreferencesMessages.getString("AntPreferencePage.Color__7")); //$NON-NLS-1$ - label.setFont(font); - gd= new GridData(); - gd.horizontalAlignment= GridData.BEGINNING; - label.setLayoutData(gd); - - fAppearanceColorEditor= new ColorEditor(stylesComposite); - Button foregroundColorButton= fAppearanceColorEditor.getButton(); - gd= new GridData(GridData.FILL_HORIZONTAL); - gd.horizontalAlignment= GridData.BEGINNING; - foregroundColorButton.setLayoutData(gd); - foregroundColorButton.setFont(font); - - fAppearanceColorList.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - handleAppearanceColorListSelection(); - } - }); - foregroundColorButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - int i= fAppearanceColorList.getSelectionIndex(); - String key= fAppearanceColorListModel[i][1]; - - PreferenceConverter.setValue(getPreferenceStore(), key, fAppearanceColorEditor.getColorValue()); - } - }); - } - - /** - * Restore all color preferences to their values when the page was opened. - */ - public boolean performCancel() { - for (int i = 0; i < fAppearanceColorListModel.length; i++) { - String preference = fAppearanceColorListModel[i][1]; - PreferenceConverter.setValue(getPreferenceStore(), preference, StringConverter.asRGB(fAppearanceColorListModel[i][2])); - } - return super.performCancel(); - } - - /** - * When the user applies the preferences, update the set of stored - * preferences so that we will fall back to the applied values on Cancel. - */ - public boolean performOk() { - storeAppliedValues(); - return super.performOk(); - } - - private void handleAppearanceColorListSelection() { - int i= fAppearanceColorList.getSelectionIndex(); - String key= fAppearanceColorListModel[i][1]; - RGB rgb= PreferenceConverter.getColor(getPreferenceStore(), key); - fAppearanceColorEditor.setColorValue(rgb); - } - - /** - * @see FieldEditorPreferencePage#createContents(org.eclipse.swt.widgets.Composite) - */ - protected Control createContents(Composite parent) { - WorkbenchHelp.setHelp(parent, IExternalToolsHelpContextIds.ANT_PREFERENCE_PAGE); - return super.createContents(parent); - } - - /** - * @see IWorkbenchPreferencePage#init(IWorkbench) - */ - public void init(IWorkbench workbench) { - } - /** - * @see org.eclipse.jface.preference.FieldEditorPreferencePage#initialize() - */ - protected void initialize() { - super.initialize(); - for (int i= 0; i < fAppearanceColorListModel.length; i++) { - fAppearanceColorList.add(fAppearanceColorListModel[i][0]); - } - fAppearanceColorList.getDisplay().asyncExec(new Runnable() { - public void run() { - if (fAppearanceColorList != null && !fAppearanceColorList.isDisposed()) { - fAppearanceColorList.select(0); - handleAppearanceColorListSelection(); - } - } - }); - } - /** - * @see org.eclipse.jface.preference.PreferencePage#performDefaults() - */ - protected void performDefaults() { - for (int i = 0; i < fAppearanceColorListModel.length; i++) { - String key= fAppearanceColorListModel[i][1]; - PreferenceConverter.setValue(getPreferenceStore(), key, PreferenceConverter.getDefaultColor(getPreferenceStore(), key)); - } - handleAppearanceColorListSelection(); - - super.performDefaults(); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencesMessages.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencesMessages.java deleted file mode 100644 index 72e3da9f4..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencesMessages.java +++ /dev/null @@ -1,42 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.text.MessageFormat; -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntPreferencesMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.preferences.AntPreferencesMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntPreferencesMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } - - public static String getFormattedString(String key, String arg) { - return getFormattedString(key, new String[] { arg }); - } - - public static String getFormattedString(String key, String[] args) { - return MessageFormat.format(getString(key), args); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencesMessages.properties b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencesMessages.properties deleted file mode 100644 index abf9dc711..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPreferencesMessages.properties +++ /dev/null @@ -1,133 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -AntClasspathBlock.&Choose_a_folder_to_add_to_the_classpath__1=&Choose a folder to add to the classpath: -AntClasspathBlock.addFolderButtonTitle = Add &Folder... -AntClasspathBlock.addJarButtonTitle = Add &JARs... -AntClasspathBlock.upButtonTitle = &Up -AntClasspathBlock.downButtonTitle = Do&wn -AntClasspathBlock.removeButtonTitle = R&emove -AntClasspathBlock.addFolderButtonTitle2 = Add F&older... -AntClasspathBlock.addJarButtonTitle2 = Add JAR&s... -AntClasspathBlock.upButtonTitle2 = U&p -AntClasspathBlock.downButtonTitle2 = Dow&n -AntClasspathBlock.removeButtonTitle2 = Re&move -AntClasspathBlock.&Choose_a_folder_that_will_be_used_as_the_location_of_ANT_HOME_3=&Choose a folder that will be used as the location of ANT_HOME -AntClasspathBlock.Specified_ANT_HOME_does_not_contain_a___lib___directory_7=Specified ANT_HOME does not contain a \"lib\" directory -AntClasspathBlock.Run&time_classpath__8=Runt&ime classpath: -AntClasspathBlock.Set_ANT_HO&ME_9=Set ANT_&HOME -AntClasspathBlock.&Browse..._10=&Browse... -AntClasspathBlock.Additional_classpath_entries__11=Additional &classpath entries: - -AntClasspathPage.title = C&lasspath - -AddCustomDialog.Bad_Format=Specified zip file is not in the correct format -AddCustomDialog.Unreadable=Specified zip file could not be read -AddCustomDialog.&Name__3=&Name: -AddCustomDialog.Could_not_close_zip_file_{0}_4=Could not close zip file {0} -AddCustomDialog.&Location=&Location: -AddCustomDialog.name=A name must be provided for the new {0} -AddCustomDialog.exists=A {0} with the name {1} already exists -AddCustomDialog.mustSelect=A class file must be selected from the specified location - -AntPreferencePage.description = Settings used when running Ant buildfiles: -AntPreferencePage.General=General Ant Settings: -AntPreferencePage.Enter=File names used to emulate \"-find\".\nUsed by \"Run As > Ant Build\" when the current selection is not a buildfile.\nList is comma separated (e.g. export.xml, build.xml, clean.xml). -AntPreferencePage.&Names__3=&Names: -AntPreferencePage.Ant_Color_Options__6=Ant Color &Options: -AntPreferencePage.Color__7=&Color: -AntPreferencePage.&Error__2=Ant error message in console -AntPreferencePage.&Warning__3=Ant warning message in console -AntPreferencePage.I&nformation__4=Ant information message in console -AntPreferencePage.Ve&rbose__5=Ant verbose message in console -AntPreferencePage.Deb&ug__6=Ant debug message in console - -AntTasksPage.addTaskButtonTitle = Add &Task... -AntTasksPage.editTaskButtonTitle = &Edit Task... -AntTasksPage.removeButtonTitle = Remo&ve -AntTasksPage.addTaskDialogDescription = Enter a name, Java class, and library for your custom task: -AntTasksPage.addTaskDialogTitle = Add Task -AntTasksPage.title = Tas&ks -AntTasksPage.editTaskDialogDescription = Modify the name, Java class, and library of your custom task: -AntTasksPage.editTaskDialogTitle = Edit Task -AntTasksPage.task_1=task -AntTasksPage._[system_task]_3=\ [system task] - -AntTypesPage.removeButtonTitle = Remo&ve -AntTypesPage.addTypeButtonTitle = Add &Type... -AntTypesPage.editTypeButtonTitle = &Edit Type... -AntTypesPage.typesPageTitle = T&ypes -AntTypesPage.addTypeDialogDescription = Enter a name, Java class, and library for your custom type: -AntTypesPage.addTypeDialogTitle = Add Type -AntTypesPage.editTypeDialogDescription = Modify the name, Java class, and library of your custom type: -AntTypesPage.editTypeDialogTitle = Edit Type -AntTypesPage.type_1=type -AntTypesPage._[system_type]_3=\ [system type] - -AntPropertiesPage.title = P&roperties -AntPropertiesPage.&Global_properties__1=&Global properties: -AntPropertiesPage.Glo&bal_property_files__2=Glo&bal property files: - -AntPropertiesBlock.addButton = Add&... -AntPropertiesBlock.editButton = &Edit... -AntPropertiesBlock.removeButton = Rem&ove -AntPropertiesBlock.addFileButton = A&dd... -AntPropertiesBlock.removeFileButton = Re&move -AntPropertiesBlock.Add_Property_2=Add Property -AntPropertiesBlock.Edit_User_Property_5=Edit User Property - -AddPropertyDialog.&Name__1=&Name: -AddPropertyDialog.&Value__2=&Value: - -AntEditorPreferencePage.description=Ant Editor settings: -AntEditorPreferencePage.annotationsTab.title= Annotation&s -AntEditorPreferencePage.annotationPresentationOptions= Annotation &presentation: -AntEditorPreferencePage.annotations.bookmarks= Bookmarks -AntEditorPreferencePage.annotations.searchResults= Search Results -AntEditorPreferencePage.annotations.errors= Errors -AntEditorPreferencePage.annotations.warnings= Warnings -AntEditorPreferencePage.annotations.infos= Infos -AntEditorPreferencePage.annotations.tasks= Tasks -AntEditorPreferencePage.annotations.others= Others -AntEditorPreferencePage.annotations.showInText= Show in &text -AntEditorPreferencePage.annotations.showInOverviewRuler= Show in overview &ruler -AntEditorPreferencePage.annotations.color= C&olor: -AntEditorPreferencePage.invalid_input= Invalid print margin column specified -AntEditorPreferencePage.empty_input= No print margin column specified - -AntEditorPreferencePage.codeAssistTab.title= &Code Assist -AntEditorPreferencePage.backgroundForCompletionProposals=Completion proposal background -AntEditorPreferencePage.foregroundForCompletionProposals=Completion proposal foreground -AntEditorPreferencePage.backgroundForCompletionReplacement=Completion overwrite background -AntEditorPreferencePage.foregroundForCompletionReplacement=Completion overwrite foreground - -AntEditorPreferencePage.general=Appeara&nce -AntEditorPreferencePage.printMarginColumn=Print margin col&umn: -AntEditorPreferencePage.showOverviewRuler=Show overview &ruler -AntEditorPreferencePage.showLineNumbers=Show lin&e numbers -AntEditorPreferencePage.highlightCurrentLine=Hi&ghlight current line -AntEditorPreferencePage.showPrintMargin=Sho&w print margin -AntEditorPreferencePage.color=C&olor: -AntEditorPreferencePage.appearanceOptions=Appearance co&lor options: -AntEditorPreferencePage.lineNumberForegroundColor=Line number foreground -AntEditorPreferencePage.currentLineHighlighColor=Current line highlight -AntEditorPreferencePage.printMarginColor=Print margin -AntEditorPreferencePage.Ant_editor_text_1=Text -AntEditorPreferencePage.Ant_editor_processing_instuctions_2=Processing instructions -AntEditorPreferencePage.Ant_editor_constant_strings_3=Constant strings -AntEditorPreferencePage.Ant_editor_tags_4=Tags -AntEditorPreferencePage.Ant_editor_comments_5=Comments -AntEditorPreferencePage.Insert=Insert single &proposals automatically -AntEditorPreferencePage.&Enable_auto_activation_2=&Enable auto activation -AntEditorPreferencePage.Auto_activation_&delay__3=Auto activation &delay: -AntEditorPreferencePage.Auto_activation_tri&ggers__4=Auto activation tri&ggers: -AntEditorPreferencePage.Code_assist_colo&r_options__5=Code assist colo&r options: -AntEditorPreferencePage.Col&or__6=Col&or: diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesBlock.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesBlock.java deleted file mode 100644 index c275839a9..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesBlock.java +++ /dev/null @@ -1,319 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.util.Iterator; -import java.util.Map; - -import org.eclipse.ant.core.Property; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.jface.dialogs.Dialog; -import org.eclipse.jface.dialogs.IDialogConstants; -import org.eclipse.jface.dialogs.IDialogSettings; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.jface.viewers.TableViewer; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.FileDialog; -import org.eclipse.swt.widgets.Label; -import org.eclipse.swt.widgets.Table; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.ui.ExternalToolsContentProvider; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; - -public class AntPropertiesBlock { - - private IAntBlockContainer container; - - private Button editButton; - private Button removeButton; - private Button addButton; - private Button addFileButton; - private Button removeFileButton; - - private TableViewer propertyTableViewer; - private TableViewer fileTableViewer; - - private final AntPropertiesLabelProvider labelProvider = new AntPropertiesLabelProvider(); - - private IDialogSettings dialogSettings; - - /** - * Button listener that delegates for widget selection events. - */ - private SelectionAdapter buttonListener= new SelectionAdapter() { - public void widgetSelected(SelectionEvent event) { - if (event.widget == addButton) { - addProperty(); - } else if (event.widget == editButton) { - edit(); - } else if (event.widget == removeButton) { - remove(propertyTableViewer); - } else if (event.widget == addFileButton) { - addPropertyFile(); - } else if (event.widget == removeFileButton) { - remove(fileTableViewer); - } else if (event.widget == removeButton) { - } - } - }; - - /** - * Selection changed listener that delegates selection events. - */ - private ISelectionChangedListener tableListener= new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - if (event.getSource() == propertyTableViewer) { - propertyTableSelectionChanged((IStructuredSelection) event.getSelection()); - } else if (event.getSource() == fileTableViewer) { - fileTableSelectionChanged((IStructuredSelection) event.getSelection()); - } - } - }; - - public AntPropertiesBlock(IAntBlockContainer container) { - this.container= container; - } - - public void createControl(Composite top, String propertyLabel, String propertyFileLabel) { - Font font= top.getFont(); - dialogSettings= ExternalToolsPlugin.getDefault().getDialogSettings(); - - createVerticalSpacer(top, 2); - - Label label = new Label(top, SWT.NONE); - GridData gd = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalSpan =2; - label.setLayoutData(gd); - label.setFont(font); - label.setText(propertyLabel); - - propertyTableViewer= createTableViewer(top); - createButtonGroup(top); - - label = new Label(top, SWT.NONE); - gd = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING); - gd.horizontalSpan =2; - label.setLayoutData(gd); - label.setFont(font); - label.setText(propertyFileLabel); - - fileTableViewer= createTableViewer(top); - createButtonGroup(top); - } - - /** - * Create some empty space. - */ - private void createVerticalSpacer(Composite comp, int colSpan) { - Label label = new Label(comp, SWT.NONE); - GridData gd = new GridData(); - gd.horizontalSpan = colSpan; - label.setLayoutData(gd); - } - - /** - * Creates the group which will contain the buttons. - */ - private void createButtonGroup(Composite top) { - Composite buttonGroup = new Composite(top, SWT.NONE); - GridLayout layout = new GridLayout(); - layout.marginHeight = 0; - layout.marginWidth = 0; - buttonGroup.setLayout(layout); - buttonGroup.setLayoutData(new GridData(GridData.FILL_VERTICAL)); - buttonGroup.setFont(top.getFont()); - - addButtonsToButtonGroup(buttonGroup); - } - - /** - * Creates and returns a configured table viewer in the given parent - */ - private TableViewer createTableViewer(Composite parent) { - Table table = new Table(parent, SWT.MULTI | SWT.FULL_SELECTION | SWT.BORDER); - GridData data= new GridData(GridData.FILL_BOTH); - data.widthHint = IDialogConstants.ENTRY_FIELD_WIDTH; - table.setLayoutData(data); - table.setFont(parent.getFont()); - - TableViewer tableViewer= new TableViewer(table); - tableViewer.setContentProvider(new ExternalToolsContentProvider()); - tableViewer.setLabelProvider(labelProvider); - tableViewer.addSelectionChangedListener(tableListener); - return tableViewer; - } - - /* (non-Javadoc) - * Method declared on AntPage. - */ - protected void addButtonsToButtonGroup(Composite parent) { - if (editButton == null) { - addButton= createPushButton(parent, AntPreferencesMessages.getString("AntPropertiesBlock.addButton")); //$NON-NLS-1$ - editButton= createPushButton(parent, AntPreferencesMessages.getString("AntPropertiesBlock.editButton")); //$NON-NLS-1$ - removeButton= createPushButton(parent, AntPreferencesMessages.getString("AntPropertiesBlock.removeButton")); //$NON-NLS-1$ - } else { - addFileButton= createPushButton(parent, AntPreferencesMessages.getString("AntPropertiesBlock.addFileButton")); //$NON-NLS-1$ - removeFileButton= createPushButton(parent, AntPreferencesMessages.getString("AntPropertiesBlock.removeFileButton")); //$NON-NLS-1$ - } - } - - /** - * Creates and returns a configured button in the given composite with the given - * label. Widget selection callbacks for the returned button will be processed - * by the <code>buttonListener</code> - */ - private Button createPushButton(Composite parent, String label) { - Button button= container.createPushButton(parent, label); - button.addSelectionListener(buttonListener); - return button; - } - - /** - * Allows the user to enter property files - */ - private void addPropertyFile() { - String lastUsedPath; - lastUsedPath= dialogSettings.get(IExternalToolsUIConstants.DIALOGSTORE_LASTEXTFILE); - if (lastUsedPath == null) { - lastUsedPath= ""; //$NON-NLS-1$ - } - FileDialog dialog = new FileDialog(propertyTableViewer.getControl().getShell(), SWT.MULTI); - dialog.setFilterExtensions(new String[] { "*.properties" }); //$NON-NLS-1$; - dialog.setFilterPath(lastUsedPath); - - String result = dialog.open(); - if (result == null) { - return; - } - IPath filterPath= new Path(dialog.getFilterPath()); - String[] results= dialog.getFileNames(); - for (int i = 0; i < results.length; i++) { - String fileName = results[i]; - IPath path= filterPath.append(fileName).makeAbsolute(); - ((ExternalToolsContentProvider)fileTableViewer.getContentProvider()).add(path.toOSString()); - } - - dialogSettings.put(IExternalToolsUIConstants.DIALOGSTORE_LASTEXTFILE, filterPath.toOSString()); - container.update(); - } - - private void remove(TableViewer viewer) { - ExternalToolsContentProvider antContentProvider= (ExternalToolsContentProvider)viewer.getContentProvider(); - IStructuredSelection sel = (IStructuredSelection) viewer.getSelection(); - antContentProvider.remove(sel); - container.update(); - } - - /** - * Allows the user to enter a global user property - */ - private void addProperty() { - String title = AntPreferencesMessages.getString("AntPropertiesBlock.Add_Property_2"); //$NON-NLS-1$ - AddPropertyDialog dialog = new AddPropertyDialog(propertyTableViewer.getControl().getShell(), title, new String[]{"", ""}); //$NON-NLS-1$ //$NON-NLS-2$ - if (dialog.open() == Dialog.CANCEL) { - return; - } - - Property prop = new Property(); - String[] pair= dialog.getNameValuePair(); - prop.setName(pair[0]); - prop.setValue(pair[1]); - ((ExternalToolsContentProvider)propertyTableViewer.getContentProvider()).add(prop); - container.update(); - } - - private void edit() { - IStructuredSelection selection= (IStructuredSelection) propertyTableViewer.getSelection(); - Property prop = (Property) selection.getFirstElement(); - if (prop == null) { - return; - } - String title = AntPreferencesMessages.getString("AntPropertiesBlock.Edit_User_Property_5"); //$NON-NLS-1$ - AddPropertyDialog dialog = new AddPropertyDialog(propertyTableViewer.getControl().getShell(), title, new String[]{prop.getName(), prop.getValue()}); - - if (dialog.open() == Dialog.CANCEL) { - return; - } - - String[] pair= dialog.getNameValuePair(); - prop.setName(pair[0]); - prop.setValue(pair[1]); - propertyTableViewer.update(prop, null); - container.update(); - } - - /** - * Handles selection changes in the Property file table viewer. - */ - private void fileTableSelectionChanged(IStructuredSelection newSelection) { - removeFileButton.setEnabled(newSelection.size() > 0); - } - - /** - * Handles selection changes in the Property file table viewer. - */ - private void propertyTableSelectionChanged(IStructuredSelection newSelection) { - int size= newSelection.size(); - removeButton.setEnabled(size > 0); - editButton.setEnabled(size > 0); - } - - public void populatePropertyViewer(Map properties) { - if (properties == null) { - propertyTableViewer.setInput(new Property[0]); - return; - } - Property[] result = new Property[properties.size()]; - Iterator entries= properties.entrySet().iterator(); - int i= 0; - while (entries.hasNext()) { - Map.Entry element = (Map.Entry) entries.next(); - Property property = new Property(); - property.setName((String)element.getKey()); - property.setValue((String)element.getValue()); - result[i]= property; - i++; - } - propertyTableViewer.setInput(result); - } - - public void setPropertiesInput(Property[] properties) { - propertyTableViewer.setInput(properties); - } - - public void setPropertyFilesInput(String[] files) { - fileTableViewer.setInput(files); - } - - public void update() { - propertyTableSelectionChanged((IStructuredSelection) propertyTableViewer.getSelection()); - fileTableSelectionChanged((IStructuredSelection)fileTableViewer.getSelection()); - } - - public Object[] getProperties() { - return ((ExternalToolsContentProvider)propertyTableViewer.getContentProvider()).getElements(null); - } - - public Object[] getPropertyFiles() { - return ((ExternalToolsContentProvider)fileTableViewer.getContentProvider()).getElements(null); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesLabelProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesLabelProvider.java deleted file mode 100644 index 20f8afe2e..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesLabelProvider.java +++ /dev/null @@ -1,84 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.ant.core.Property; -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.jface.viewers.ITableLabelProvider; -import org.eclipse.jface.viewers.LabelProvider; -import org.eclipse.swt.graphics.Image; -import org.eclipse.ui.ISharedImages; -import org.eclipse.ui.PlatformUI; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; - -/** - * Label provider for property elements - */ -final class AntPropertiesLabelProvider extends LabelProvider implements ITableLabelProvider { - private static final String IMG_CLASSPATH = "icons/full/obj16/classpath.gif"; //$NON-NLS-1$; - - private Image classpathImage; - private Image fileImage; - - /** - * Creates an instance. - */ - public AntPropertiesLabelProvider() { - } - - /* (non-Javadoc) - * Method declared on IBaseLabelProvider. - */ - public void dispose() { - // file image is shared, do not dispose. - fileImage = null; - if (classpathImage != null) { - classpathImage.dispose(); - classpathImage = null; - } - } - - /* (non-Javadoc) - * Method declared on ITableLabelProvider. - */ - public Image getColumnImage(Object element, int columnIndex) { - if (element instanceof Property) { - return ExternalToolsImages.getImage(IExternalToolConstants.IMG_PROPERTY); - } else { - return getFileImage(); - } - } - - /* (non-Javadoc) - * Method declared on ITableLabelProvider. - */ - public String getColumnText(Object element, int columnIndex) { - return element.toString(); - } - - public Image getFileImage() { - if (fileImage == null) { - fileImage = PlatformUI.getWorkbench().getSharedImages().getImage(ISharedImages.IMG_OBJ_FILE); - } - return fileImage; - } - - public Image getClasspathImage() { - if (classpathImage == null) { - ImageDescriptor desc = ExternalToolsPlugin.getDefault().getImageDescriptor(AntPropertiesLabelProvider.IMG_CLASSPATH); - classpathImage = desc.createImage(); - } - return classpathImage; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesPage.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesPage.java deleted file mode 100644 index 63dbca1e9..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntPropertiesPage.java +++ /dev/null @@ -1,140 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.util.Arrays; -import java.util.List; - -import org.eclipse.ant.core.AntCorePlugin; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.TabFolder; -import org.eclipse.swt.widgets.TabItem; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Preference page for setting global Ant user properties. - * All properties specified here will be set as user properties on the - * project for any Ant build - */ -public class AntPropertiesPage implements IAntBlockContainer { - - private AntPropertiesBlock antPropertiesBlock= new AntPropertiesBlock(this); - private AntRuntimePreferencePage preferencePage; - - /** - * Creates an instance. - */ - public AntPropertiesPage(AntRuntimePreferencePage preferencePage) { - this.preferencePage= preferencePage; - } - - /** - * Creates the tab item that contains this sub-page. - */ - protected TabItem createTabItem(TabFolder folder) { - TabItem item = new TabItem(folder, SWT.NONE); - item.setText(AntPreferencesMessages.getString("AntPropertiesPage.title")); //$NON-NLS-1$ - item.setImage(ExternalToolsImages.getImage(IExternalToolConstants.IMG_PROPERTY)); - item.setData(this); - item.setControl(createContents(folder)); - return item; - } - - protected Composite createContents(Composite parent) { - Font font = parent.getFont(); - - Composite top = new Composite(parent, SWT.NONE); - top.setFont(font); - WorkbenchHelp.setHelp(top, IExternalToolsHelpContextIds.ANT_PROPERTIES_PAGE); - GridLayout layout = new GridLayout(); - layout.numColumns= 2; - top.setLayout(layout); - GridData gridData = new GridData(GridData.FILL_HORIZONTAL); - top.setLayoutData(gridData); - - antPropertiesBlock.createControl(top, AntPreferencesMessages.getString("AntPropertiesPage.&Global_properties__1"), AntPreferencesMessages.getString("AntPropertiesPage.Glo&bal_property_files__2")); //$NON-NLS-1$ //$NON-NLS-2$ - - return top; - } - - /** - * Sets the contents of the tables on this page. - */ - protected void initialize() { - antPropertiesBlock.setPropertiesInput(AntCorePlugin.getPlugin().getPreferences().getCustomProperties()); - antPropertiesBlock.setPropertyFilesInput(AntCorePlugin.getPlugin().getPreferences().getCustomPropertyFiles()); - antPropertiesBlock.update(); - } - - protected void performDefaults() { - antPropertiesBlock.populatePropertyViewer(null); - antPropertiesBlock.setPropertyFilesInput(new String[0]); - antPropertiesBlock.update(); - } - - /** - * Returns the specified property files - * - * @return String[] - */ - protected String[] getPropertyFiles() { - Object[] elements = antPropertiesBlock.getPropertyFiles(); - String[] files= new String[elements.length]; - for (int i = 0; i < elements.length; i++) { - files[i] = (String)elements[i]; - } - return files; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setMessage(java.lang.String) - */ - public void setMessage(String message) { - preferencePage.setMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#setErrorMessage(java.lang.String) - */ - public void setErrorMessage(String message) { - preferencePage.setErrorMessage(message); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#createPushButton(org.eclipse.swt.widgets.Composite, java.lang.String) - */ - public Button createPushButton(Composite parent, String buttonText) { - Button button = new Button(parent, SWT.PUSH); - button.setFont(parent.getFont()); - button.setText(buttonText); - preferencePage.setButtonLayoutData(button); - return button; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.externaltools.internal.ant.preferences.IAntClasspathBlockContainer#update() - */ - public void update() { - } - - protected List getProperties() { - return Arrays.asList(antPropertiesBlock.getProperties()); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntRuntimePreferencePage.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntRuntimePreferencePage.java deleted file mode 100644 index 1d153a9a2..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/AntRuntimePreferencePage.java +++ /dev/null @@ -1,164 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.net.URL; -import java.util.ArrayList; -import java.util.List; - -import org.eclipse.ant.core.AntCorePlugin; -import org.eclipse.ant.core.AntCorePreferences; -import org.eclipse.ant.core.Property; -import org.eclipse.ant.core.Task; -import org.eclipse.ant.core.Type; -import org.eclipse.jface.preference.PreferencePage; -import org.eclipse.swt.SWT; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.TabFolder; -import org.eclipse.ui.IWorkbench; -import org.eclipse.ui.IWorkbenchPreferencePage; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Ant preference page to set the classpath, tasks, and types and properties. - */ -public class AntRuntimePreferencePage extends PreferencePage implements IWorkbenchPreferencePage { - - private AntClasspathPage classpathPage; - private AntTasksPage tasksPage; - private AntTypesPage typesPage; - private AntPropertiesPage propertiesPage; - - /** - * Creates the preference page - */ - public AntRuntimePreferencePage() { - setDescription(AntPreferencesMessages.getString("AntPreferencePage.description")); //$NON-NLS-1$ - setPreferenceStore(ExternalToolsPlugin.getDefault().getPreferenceStore()); - } - - /* (non-Javadoc) - * Method declared on IWorkbenchPreferencePage. - */ - public void init(IWorkbench workbench) { - } - - /* (non-Javadoc) - * Method declared on PreferencePage. - */ - protected Control createContents(Composite parent) { - WorkbenchHelp.setHelp(getControl(), IExternalToolsHelpContextIds.ANT_RUNTIME_PREFERENCE_PAGE); - initializeDialogUnits(parent); - - TabFolder folder = new TabFolder(parent, SWT.NONE); - folder.setLayout(new TabFolderLayout()); - folder.setLayoutData(new GridData(GridData.FILL_BOTH)); - folder.setFont(parent.getFont()); - - classpathPage = new AntClasspathPage(this); - classpathPage.createTabItem(folder); - - tasksPage = new AntTasksPage(this); - tasksPage.createTabItem(folder); - - typesPage = new AntTypesPage(this); - typesPage.createTabItem(folder); - - propertiesPage= new AntPropertiesPage(this); - propertiesPage.createTabItem(folder); - - tasksPage.initialize(); - typesPage.initialize(); - classpathPage.initialize(); - propertiesPage.initialize(); - - return folder; - } - - /* (non-Javadoc) - * Method declared on PreferencePage. - */ - protected void performDefaults() { - super.performDefaults(); - - AntCorePreferences prefs = AntCorePlugin.getPlugin().getPreferences(); - tasksPage.setInput(prefs.getDefaultTasks()); - typesPage.setInput(prefs.getDefaultTypes()); - classpathPage.performDefaults(); - propertiesPage.performDefaults(); - } - - /* (non-Javadoc) - * Method declared on PreferencePage. - */ - public boolean performOk() { - AntCorePreferences prefs = AntCorePlugin.getPlugin().getPreferences(); - - List contents = classpathPage.getAntURLs(); - if (contents != null) { - URL[] urls = (URL[]) contents.toArray(new URL[contents.size()]); - prefs.setAntURLs(urls); - } - - contents = classpathPage.getUserURLs(); - if (contents != null) { - URL[] urls = (URL[]) contents.toArray(new URL[contents.size()]); - prefs.setCustomURLs(urls); - } - - String antHome= classpathPage.getAntHome(); - prefs.setAntHome(antHome); - - contents = tasksPage.getContents(false); - if (contents != null) { - Task[] tasks = (Task[]) contents.toArray(new Task[contents.size()]); - prefs.setCustomTasks(tasks); - } - - contents = typesPage.getContents(false); - if (contents != null) { - Type[] types = (Type[]) contents.toArray(new Type[contents.size()]); - prefs.setCustomTypes(types); - } - - contents = propertiesPage.getProperties(); - if (contents != null) { - Property[] properties = (Property[]) contents.toArray(new Property[contents.size()]); - prefs.setCustomProperties(properties); - } - - String[] files = propertiesPage.getPropertyFiles(); - prefs.setCustomPropertyFiles(files); - - prefs.updatePluginPreferences(); - return super.performOk(); - } - - /** - * @see org.eclipse.jface.dialogs.DialogPage#setButtonLayoutData(org.eclipse.swt.widgets.Button) - */ - protected GridData setButtonLayoutData(Button button) { - return super.setButtonLayoutData(button); - } - - protected List getLibraryURLs() { - List urls= new ArrayList(); - urls.addAll(classpathPage.getAntURLs()); - urls.addAll(classpathPage.getUserURLs()); - return urls; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/ColorEditor.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/ColorEditor.java deleted file mode 100644 index b98d59588..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/ColorEditor.java +++ /dev/null @@ -1,123 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.DisposeEvent; -import org.eclipse.swt.events.DisposeListener; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Color; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.graphics.GC; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.graphics.Point; -import org.eclipse.swt.graphics.RGB; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.ColorDialog; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Display; - -import org.eclipse.jface.resource.JFaceResources; - -/** - * A "button" of a certain color determined by the color picker - */ -public class ColorEditor { - - private Point fExtent; - private Image fImage; - private RGB fColorValue; - private Color fColor; - private Button fButton; - - public ColorEditor(Composite parent) { - - fButton= new Button(parent, SWT.PUSH); - fExtent= computeImageSize(parent); - fImage= new Image(parent.getDisplay(), fExtent.x, fExtent.y); - - GC gc= new GC(fImage); - gc.setBackground(fButton.getBackground()); - gc.fillRectangle(0, 0, fExtent.x, fExtent.y); - gc.dispose(); - - fButton.setImage(fImage); - fButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent event) { - ColorDialog colorDialog= new ColorDialog(fButton.getShell()); - colorDialog.setRGB(fColorValue); - RGB newColor = colorDialog.open(); - if (newColor != null) { - fColorValue= newColor; - updateColorImage(); - } - } - }); - - fButton.addDisposeListener(new DisposeListener() { - public void widgetDisposed(DisposeEvent event) { - if (fImage != null) { - fImage.dispose(); - fImage= null; - } - if (fColor != null) { - fColor.dispose(); - fColor= null; - } - } - }); - } - - public RGB getColorValue() { - return fColorValue; - } - - public void setColorValue(RGB rgb) { - fColorValue= rgb; - updateColorImage(); - } - - public Button getButton() { - return fButton; - } - - protected void updateColorImage() { - - Display display= fButton.getDisplay(); - - GC gc= new GC(fImage); - gc.setForeground(display.getSystemColor(SWT.COLOR_BLACK)); - gc.drawRectangle(0, 2, fExtent.x - 1, fExtent.y - 4); - - if (fColor != null) - fColor.dispose(); - - fColor= new Color(display, fColorValue); - gc.setBackground(fColor); - gc.fillRectangle(1, 3, fExtent.x - 2, fExtent.y - 5); - gc.dispose(); - - fButton.setImage(fImage); - } - - protected Point computeImageSize(Control window) { - GC gc= new GC(window); - Font f= JFaceResources.getFontRegistry().get(JFaceResources.DEFAULT_FONT); - gc.setFont(f); - int height= gc.getFontMetrics().getHeight(); - gc.dispose(); - Point p= new Point(height * 3 - 6, height); - return p; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/IAntBlockContainer.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/IAntBlockContainer.java deleted file mode 100644 index b900c2f17..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/IAntBlockContainer.java +++ /dev/null @@ -1,51 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; - -public interface IAntBlockContainer { - - /** - * Sets the error message for the container. - * May be <code>null</code> to remove the error message. - * - * @param message A string error message or <code>null</code> - */ - public void setErrorMessage(String message); - - /** - * Sets the message for the container. - * May be <code>null</code> to remove the message. - * - * @param message A string message or <code>null</code> - */ - public void setMessage(String message); - - /** - * Creates and returns a properly configured push button with - * the supplied label - * - * @param parent The composite parent of the button - * @param label The button label - * - * @return button the created button - */ - public Button createPushButton(Composite parent, String label); - - /** - * Notifies the container that state has changed. - */ - public void update(); - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/MinimizedFileSystemElement.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/MinimizedFileSystemElement.java deleted file mode 100644 index b7c940bc8..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/MinimizedFileSystemElement.java +++ /dev/null @@ -1,217 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import java.util.ArrayList; -import java.util.Collections; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.core.runtime.Platform; -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.ui.ISharedImages; -import org.eclipse.ui.PlatformUI; -import org.eclipse.ui.model.IWorkbenchAdapter; -import org.eclipse.ui.wizards.datatransfer.IImportStructureProvider; - -class MinimizedFileSystemElement implements IWorkbenchAdapter, IAdaptable { - private boolean populated = false; - private List folders = null; - private List files = null; - private String name; - private boolean isDirectory = false; - private MinimizedFileSystemElement parent; - private Object fileSystemObject; - - /** - * Create a <code>MinimizedFileSystemElement</code> with the supplied name and parent. - * @param name the name of the file element this represents - * @param parent the containing parent - * @param isDirectory indicated if this could have children or not - */ - public MinimizedFileSystemElement(String name, MinimizedFileSystemElement parent, boolean isDirectory) { - this.name = name; - this.parent = parent; - this.isDirectory = isDirectory; - if (parent != null) { - parent.addChild(this); - } - } - - /** - * Returns the adapter - */ - public Object getAdapter(Class adapter) { - if (adapter == IWorkbenchAdapter.class) { - return this; - } - //defer to the platform - return Platform.getAdapterManager().getAdapter(this, adapter); - } - - /** - * Returns true if this element represents a directory, and false - * otherwise. - */ - public boolean isDirectory() { - return isDirectory; - } - - /** - * Adds the passed child to this object's collection of children. - * - * @param child MinimizedFileSystemElement - */ - private void addChild(MinimizedFileSystemElement child) { - if (child.isDirectory()) { - if (folders == null) { - folders = new ArrayList(1); - } - folders.add(child); - } else { - if (files == null) { - files = new ArrayList(1); - } - files.add(child); - } - } - /** - * Returns a list of the files that are immediate children. Use the supplied provider - * if it needs to be populated. - */ - protected List getFiles(IImportStructureProvider provider) { - if (!populated) { - populate(provider); - } - - if (files == null) { - return Collections.EMPTY_LIST; - } - return files; - - } - /** - * Returns a list of the folders that are immediate children. Use the supplied provider - * if it needs to be populated. - */ - protected List getFolders(IImportStructureProvider provider) { - if (!populated) { - populate(provider); - } - - return getFolders(); - - } - - protected List getFolders() { - if (folders == null){ - return Collections.EMPTY_LIST; - } - return folders; - } - /** - * Return whether or not population has happened for the receiver. - */ - protected boolean isPopulated() { - return this.populated; - } - /** - * Return whether or not population has not happened for the receiver. - */ - protected boolean notPopulated() { - return !this.populated; - } - /** - * Populate the files and folders of the receiver using the supplied - * structure provider. - * @param provider org.eclipse.ui.wizards.datatransfer.IImportStructureProvider - */ - private void populate(IImportStructureProvider provider) { - - List children = provider.getChildren(fileSystemObject); - if (children == null) { - children = new ArrayList(1); - } - Iterator childrenEnum = children.iterator(); - while (childrenEnum.hasNext()) { - Object child = childrenEnum.next(); - - String elementLabel = provider.getLabel(child); - boolean isFolder= provider.isFolder(child); - if (!isFolder && !elementLabel.endsWith(".class")) { //$NON-NLS-1$ - continue; - } - //Create one level below - MinimizedFileSystemElement result = new MinimizedFileSystemElement(elementLabel, this, isFolder); - result.setFileSystemObject(child); - } - setPopulated(); - } - - /** - * Returns the file system object property of this element - * - * @return the file system object - */ - protected Object getFileSystemObject() { - return fileSystemObject; - } - - /** - * Set the file system object property of this element - * - * @param value the file system object - */ - protected void setFileSystemObject(Object value) { - fileSystemObject = value; - } - /** - * Set whether or not population has happened for the receiver to true. - */ - protected void setPopulated() { - this.populated = true; - } - /** - * @see org.eclipse.ui.model.IWorkbenchAdapter#getChildren(java.lang.Object) - */ - public Object[] getChildren(Object o) { - return getFolders().toArray(); - } - - /** - * @see org.eclipse.ui.model.IWorkbenchAdapter#getImageDescriptor(java.lang.Object) - */ - public ImageDescriptor getImageDescriptor(Object object) { - if (isDirectory()) { - return PlatformUI.getWorkbench().getSharedImages().getImageDescriptor(ISharedImages.IMG_OBJ_FOLDER); - } else { - return PlatformUI.getWorkbench().getEditorRegistry().getImageDescriptor(name); - } - } - - /** - * @see org.eclipse.ui.model.IWorkbenchAdapter#getLabel(java.lang.Object) - */ - public String getLabel(Object o) { - return name; - } - - /** - * @see org.eclipse.ui.model.IWorkbenchAdapter#getParent(java.lang.Object) - */ - public Object getParent(Object o) { - return parent; - } - -} - diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/OverlayPreferenceStore.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/OverlayPreferenceStore.java deleted file mode 100644 index bf32006dd..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/OverlayPreferenceStore.java +++ /dev/null @@ -1,451 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - -import org.eclipse.jface.preference.IPreferenceStore; -import org.eclipse.jface.preference.PreferenceStore; -import org.eclipse.jface.util.IPropertyChangeListener; -import org.eclipse.jface.util.PropertyChangeEvent; - -/** - * An overlaying preference store. - */ -class OverlayPreferenceStore implements IPreferenceStore { - - - public static final class TypeDescriptor { - private TypeDescriptor() { - } - }; - - public static final TypeDescriptor BOOLEAN= new TypeDescriptor(); - public static final TypeDescriptor DOUBLE= new TypeDescriptor(); - public static final TypeDescriptor FLOAT= new TypeDescriptor(); - public static final TypeDescriptor INT= new TypeDescriptor(); - public static final TypeDescriptor LONG= new TypeDescriptor(); - public static final TypeDescriptor STRING= new TypeDescriptor(); - - public static class OverlayKey { - - TypeDescriptor fDescriptor; - String fKey; - - public OverlayKey(TypeDescriptor descriptor, String key) { - fDescriptor= descriptor; - fKey= key; - } - }; - - private class PropertyListener implements IPropertyChangeListener { - - /* - * @see IPropertyChangeListener#propertyChange(PropertyChangeEvent) - */ - public void propertyChange(PropertyChangeEvent event) { - OverlayKey key= findOverlayKey(event.getProperty()); - if (key != null) - propagateProperty(fParent, key, fStore); - } - }; - - - private IPreferenceStore fParent; - private IPreferenceStore fStore; - private OverlayKey[] fOverlayKeys; - - private PropertyListener fPropertyListener; - - - public OverlayPreferenceStore(IPreferenceStore parent, OverlayKey[] overlayKeys) { - fParent= parent; - fOverlayKeys= overlayKeys; - fStore= new PreferenceStore(); - } - - private OverlayKey findOverlayKey(String key) { - for (int i= 0; i < fOverlayKeys.length; i++) { - if (fOverlayKeys[i].fKey.equals(key)) - return fOverlayKeys[i]; - } - return null; - } - - private boolean covers(String key) { - return (findOverlayKey(key) != null); - } - - private void propagateProperty(IPreferenceStore orgin, OverlayKey key, IPreferenceStore target) { - - if (orgin.isDefault(key.fKey)) { - if (!target.isDefault(key.fKey)) - target.setToDefault(key.fKey); - return; - } - - TypeDescriptor d= key.fDescriptor; - if (BOOLEAN == d) { - - boolean originValue= orgin.getBoolean(key.fKey); - boolean targetValue= target.getBoolean(key.fKey); - if (targetValue != originValue) - target.setValue(key.fKey, originValue); - - } else if (DOUBLE == d) { - - double originValue= orgin.getDouble(key.fKey); - double targetValue= target.getDouble(key.fKey); - if (targetValue != originValue) - target.setValue(key.fKey, originValue); - - } else if (FLOAT == d) { - - float originValue= orgin.getFloat(key.fKey); - float targetValue= target.getFloat(key.fKey); - if (targetValue != originValue) - target.setValue(key.fKey, originValue); - - } else if (INT == d) { - - int originValue= orgin.getInt(key.fKey); - int targetValue= target.getInt(key.fKey); - if (targetValue != originValue) - target.setValue(key.fKey, originValue); - - } else if (LONG == d) { - - long originValue= orgin.getLong(key.fKey); - long targetValue= target.getLong(key.fKey); - if (targetValue != originValue) - target.setValue(key.fKey, originValue); - - } else if (STRING == d) { - - String originValue= orgin.getString(key.fKey); - String targetValue= target.getString(key.fKey); - if (targetValue != null && originValue != null && !targetValue.equals(originValue)) - target.setValue(key.fKey, originValue); - - } - } - - public void propagate() { - for (int i= 0; i < fOverlayKeys.length; i++) - propagateProperty(fStore, fOverlayKeys[i], fParent); - } - - private void loadProperty(IPreferenceStore orgin, OverlayKey key, IPreferenceStore target, boolean forceInitialization) { - TypeDescriptor d= key.fDescriptor; - if (BOOLEAN == d) { - - if (forceInitialization) - target.setValue(key.fKey, true); - target.setValue(key.fKey, orgin.getBoolean(key.fKey)); - target.setDefault(key.fKey, orgin.getDefaultBoolean(key.fKey)); - - } else if (DOUBLE == d) { - - if (forceInitialization) - target.setValue(key.fKey, 1.0D); - target.setValue(key.fKey, orgin.getDouble(key.fKey)); - target.setDefault(key.fKey, orgin.getDefaultDouble(key.fKey)); - - } else if (FLOAT == d) { - - if (forceInitialization) - target.setValue(key.fKey, 1.0F); - target.setValue(key.fKey, orgin.getFloat(key.fKey)); - target.setDefault(key.fKey, orgin.getDefaultFloat(key.fKey)); - - } else if (INT == d) { - - if (forceInitialization) - target.setValue(key.fKey, 1); - target.setValue(key.fKey, orgin.getInt(key.fKey)); - target.setDefault(key.fKey, orgin.getDefaultInt(key.fKey)); - - } else if (LONG == d) { - - if (forceInitialization) - target.setValue(key.fKey, 1L); - target.setValue(key.fKey, orgin.getLong(key.fKey)); - target.setDefault(key.fKey, orgin.getDefaultLong(key.fKey)); - - } else if (STRING == d) { - - if (forceInitialization) - target.setValue(key.fKey, "1"); //$NON-NLS-1$ - target.setValue(key.fKey, orgin.getString(key.fKey)); - target.setDefault(key.fKey, orgin.getDefaultString(key.fKey)); - - } - } - - public void load() { - for (int i= 0; i < fOverlayKeys.length; i++) - loadProperty(fParent, fOverlayKeys[i], fStore, true); - } - - public void loadDefaults() { - for (int i= 0; i < fOverlayKeys.length; i++) - setToDefault(fOverlayKeys[i].fKey); - } - - public void start() { - if (fPropertyListener == null) { - fPropertyListener= new PropertyListener(); - fParent.addPropertyChangeListener(fPropertyListener); - } - } - - public void stop() { - if (fPropertyListener != null) { - fParent.removePropertyChangeListener(fPropertyListener); - fPropertyListener= null; - } - } - - /* - * @see IPreferenceStore#addPropertyChangeListener(IPropertyChangeListener) - */ - public void addPropertyChangeListener(IPropertyChangeListener listener) { - fStore.addPropertyChangeListener(listener); - } - - /* - * @see IPreferenceStore#removePropertyChangeListener(IPropertyChangeListener) - */ - public void removePropertyChangeListener(IPropertyChangeListener listener) { - fStore.removePropertyChangeListener(listener); - } - - /* - * @see IPreferenceStore#firePropertyChangeEvent(String, Object, Object) - */ - public void firePropertyChangeEvent(String name, Object oldValue, Object newValue) { - fStore.firePropertyChangeEvent(name, oldValue, newValue); - } - - /* - * @see IPreferenceStore#contains(String) - */ - public boolean contains(String name) { - return fStore.contains(name); - } - - /* - * @see IPreferenceStore#getBoolean(String) - */ - public boolean getBoolean(String name) { - return fStore.getBoolean(name); - } - - /* - * @see IPreferenceStore#getDefaultBoolean(String) - */ - public boolean getDefaultBoolean(String name) { - return fStore.getDefaultBoolean(name); - } - - /* - * @see IPreferenceStore#getDefaultDouble(String) - */ - public double getDefaultDouble(String name) { - return fStore.getDefaultDouble(name); - } - - /* - * @see IPreferenceStore#getDefaultFloat(String) - */ - public float getDefaultFloat(String name) { - return fStore.getDefaultFloat(name); - } - - /* - * @see IPreferenceStore#getDefaultInt(String) - */ - public int getDefaultInt(String name) { - return fStore.getDefaultInt(name); - } - - /* - * @see IPreferenceStore#getDefaultLong(String) - */ - public long getDefaultLong(String name) { - return fStore.getDefaultLong(name); - } - - /* - * @see IPreferenceStore#getDefaultString(String) - */ - public String getDefaultString(String name) { - return fStore.getDefaultString(name); - } - - /* - * @see IPreferenceStore#getDouble(String) - */ - public double getDouble(String name) { - return fStore.getDouble(name); - } - - /* - * @see IPreferenceStore#getFloat(String) - */ - public float getFloat(String name) { - return fStore.getFloat(name); - } - - /* - * @see IPreferenceStore#getInt(String) - */ - public int getInt(String name) { - return fStore.getInt(name); - } - - /* - * @see IPreferenceStore#getLong(String) - */ - public long getLong(String name) { - return fStore.getLong(name); - } - - /* - * @see IPreferenceStore#getString(String) - */ - public String getString(String name) { - return fStore.getString(name); - } - - /* - * @see IPreferenceStore#isDefault(String) - */ - public boolean isDefault(String name) { - return fStore.isDefault(name); - } - - /* - * @see IPreferenceStore#needsSaving() - */ - public boolean needsSaving() { - return fStore.needsSaving(); - } - - /* - * @see IPreferenceStore#putValue(String, String) - */ - public void putValue(String name, String value) { - if (covers(name)) - fStore.putValue(name, value); - } - - /* - * @see IPreferenceStore#setDefault(String, double) - */ - public void setDefault(String name, double value) { - if (covers(name)) - fStore.setDefault(name, value); - } - - /* - * @see IPreferenceStore#setDefault(String, float) - */ - public void setDefault(String name, float value) { - if (covers(name)) - fStore.setDefault(name, value); - } - - /* - * @see IPreferenceStore#setDefault(String, int) - */ - public void setDefault(String name, int value) { - if (covers(name)) - fStore.setDefault(name, value); - } - - /* - * @see IPreferenceStore#setDefault(String, long) - */ - public void setDefault(String name, long value) { - if (covers(name)) - fStore.setDefault(name, value); - } - - /* - * @see IPreferenceStore#setDefault(String, String) - */ - public void setDefault(String name, String value) { - if (covers(name)) - fStore.setDefault(name, value); - } - - /* - * @see IPreferenceStore#setDefault(String, boolean) - */ - public void setDefault(String name, boolean value) { - if (covers(name)) - fStore.setDefault(name, value); - } - - /* - * @see IPreferenceStore#setToDefault(String) - */ - public void setToDefault(String name) { - fStore.setToDefault(name); - } - - /* - * @see IPreferenceStore#setValue(String, double) - */ - public void setValue(String name, double value) { - if (covers(name)) - fStore.setValue(name, value); - } - - /* - * @see IPreferenceStore#setValue(String, float) - */ - public void setValue(String name, float value) { - if (covers(name)) - fStore.setValue(name, value); - } - - /* - * @see IPreferenceStore#setValue(String, int) - */ - public void setValue(String name, int value) { - if (covers(name)) - fStore.setValue(name, value); - } - - /* - * @see IPreferenceStore#setValue(String, long) - */ - public void setValue(String name, long value) { - if (covers(name)) - fStore.setValue(name, value); - } - - /* - * @see IPreferenceStore#setValue(String, String) - */ - public void setValue(String name, String value) { - if (covers(name)) - fStore.setValue(name, value); - } - - /* - * @see IPreferenceStore#setValue(String, boolean) - */ - public void setValue(String name, boolean value) { - if (covers(name)) - fStore.setValue(name, value); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/TabFolderLayout.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/TabFolderLayout.java deleted file mode 100644 index 0e724c7ae..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/preferences/TabFolderLayout.java +++ /dev/null @@ -1,54 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.preferences; - - -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Point; -import org.eclipse.swt.graphics.Rectangle; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Layout; - -public class TabFolderLayout extends Layout { - - protected Point computeSize (Composite composite, int wHint, int hHint, boolean flushCache) { - if (wHint != SWT.DEFAULT && hHint != SWT.DEFAULT) - return new Point(wHint, hHint); - - Control [] children = composite.getChildren (); - int count = children.length; - int maxWidth = 0, maxHeight = 0; - for (int i=0; i<count; i++) { - Control child = children [i]; - Point pt = child.computeSize (SWT.DEFAULT, SWT.DEFAULT, flushCache); - maxWidth = Math.max (maxWidth, pt.x); - maxHeight = Math.max (maxHeight, pt.y); - } - - if (wHint != SWT.DEFAULT) - maxWidth= wHint; - if (hHint != SWT.DEFAULT) - maxHeight= hHint; - - return new Point(maxWidth, maxHeight); - - } - - protected void layout (Composite composite, boolean flushCache) { - Rectangle rect= composite.getClientArea(); - - Control[] children = composite.getChildren(); - for (int i = 0; i < children.length; i++) { - children[i].setBounds(rect); - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntProjectContentProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntProjectContentProvider.java deleted file mode 100644 index 9f46f66a6..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntProjectContentProvider.java +++ /dev/null @@ -1,112 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view; - - -import org.eclipse.jface.viewers.ITreeContentProvider; -import org.eclipse.jface.viewers.Viewer; -import org.eclipse.ui.externaltools.internal.ant.view.elements.AntNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.RootNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; - -/** - * Content provider that provides a tree of ant projects. - */ -public class AntProjectContentProvider implements ITreeContentProvider { - - /** - * The root node of the project tree - */ - private RootNode rootNode; - - /** - * @see org.eclipse.jface.viewers.IStructuredContentProvider#getElements(java.lang.Object) - */ - public Object[] getElements(Object inputElement) { - return getChildren(inputElement); - } - - /** - * @see org.eclipse.jface.viewers.IContentProvider#dispose() - */ - public void dispose() { - } - - /** - * @see org.eclipse.jface.viewers.IContentProvider#inputChanged(org.eclipse.jface.viewers.Viewer, java.lang.Object, java.lang.Object) - */ - public void inputChanged(Viewer viewer, Object oldInput, Object newInput) { - if (newInput instanceof RootNode) { - rootNode= (RootNode) newInput; - } - } - - /** - * Adds the given buildfile to the tree. Has no effect if the given build - * file is already present in the tree. - * - * @param buildFileName the string representing the path to a build file - */ - public void addProject(ProjectNode project) { - ProjectNode[] projects= getRootNode().getProjects(); - for (int i = 0; i < projects.length; i++) { - ProjectNode node = projects[i]; - if (node.getBuildFileName().equals(project.getBuildFileName())) { - return; - } - } - getRootNode().addProject(project); - } - - /** - * Returns the root node of the tree or <code>null</code> if no root has - * been set as the input - * - * @return RootNode the root node of the tree - */ - public RootNode getRootNode() { - return rootNode; - } - - /** - * @see org.eclipse.jface.viewers.ITreeContentProvider#getChildren(Object) - */ - public Object[] getChildren(Object element) { - if (element instanceof RootNode) { - return ((RootNode) element).getProjects(); - } else if (element instanceof ProjectNode) { - return ((ProjectNode) element).getTargets(); - } - return null; - } - - /** - * @see org.eclipse.jface.viewers.ITreeContentProvider#getParent(Object) - */ - public Object getParent(Object element) { - if (element instanceof AntNode) { - return ((AntNode) element).getParent(); - } - return null; - } - - /** - * @see org.eclipse.jface.viewers.ITreeContentProvider#hasChildren(Object) - */ - public boolean hasChildren(Object element) { - if (element instanceof TargetNode) { - return false; - } - return true; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntTargetContentProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntTargetContentProvider.java deleted file mode 100644 index dfadeafee..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntTargetContentProvider.java +++ /dev/null @@ -1,114 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view; - - -import java.util.ArrayList; -import java.util.List; - -import org.eclipse.jface.viewers.IStructuredContentProvider; -import org.eclipse.jface.viewers.Viewer; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; - -/** - * Content provider which provides a list of ant targets chosen by the user - */ -public class AntTargetContentProvider implements IStructuredContentProvider { - - /** - * The collection of currently active targets - */ - private List targets = new ArrayList(); - - /** - * @see org.eclipse.jface.viewers.IStructuredContentProvider#getElements(java.lang.Object) - */ - public Object[] getElements(Object inputElement) { - return targets.toArray(); - } - - /** - * @see org.eclipse.jface.viewers.IContentProvider#dispose() - */ - public void dispose() { - } - - /** - * @see org.eclipse.jface.viewers.IContentProvider#inputChanged(org.eclipse.jface.viewers.Viewer, java.lang.Object, java.lang.Object) - */ - public void inputChanged(Viewer viewer, Object oldInput, Object newInput) { - } - - /** - * Returns the user's currently selected targets. The list contains - * <code>TargetNode</code> objects. - * - * @return List the user's currently selected targets - */ - public List getTargets() { - return targets; - } - - /** - * Adds the given target to the list of selected targets. Targets will - * appear in the list as often as they are added. - * - * @param target the target to add - */ - public void addTarget(TargetNode target) { - targets.add(target); - } - - /** - * Removes the given target from the list of selected targets. Has no effect - * if the given index is invalid. - * - * @param index the index of the the target to remove - */ - public void removeTarget(int index) { - if (targets.size() > index && index >= 0) { - targets.remove(index); - } - } - - /** - * Moves the given target up in the list of active targets. Has no effect if - * the given target is already the first target in the list or the given - * index is invalid. - * - * @param index the index of the target to move up - */ - public void moveUpTarget(int index) { - Object target= targets.get(index); - if (index == 0 || target == null) { - return; - } - targets.set(index, targets.get(index - 1)); - targets.set(index - 1, target); - } - - /** - * Moves the given target down in the list of active targets. Has no effect - * if the given target is already the last target in the list or the given - * index is invalid. - * - * @param index the index of the target to move down - */ - public void moveDownTarget(int index) { - Object target= targets.get(index); - if (index == targets.size() - 1 || target == null) { - return; - } - targets.set(index, targets.get(index + 1)); - targets.set(index + 1, target); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntView.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntView.java deleted file mode 100644 index d7936b973..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntView.java +++ /dev/null @@ -1,664 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * Roscoe Rush - Concept and prototype implementation - * IBM Corporation - current implementation - *******************************************************************************/ - -package org.eclipse.ui.externaltools.internal.ant.view; - -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.resources.IResourceChangeEvent; -import org.eclipse.core.resources.IResourceChangeListener; -import org.eclipse.core.resources.IResourceDelta; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.IPath; -import org.eclipse.core.runtime.Path; -import org.eclipse.jface.action.IMenuListener; -import org.eclipse.jface.action.IMenuManager; -import org.eclipse.jface.action.IToolBarManager; -import org.eclipse.jface.action.MenuManager; -import org.eclipse.jface.action.Separator; -import org.eclipse.jface.viewers.DoubleClickEvent; -import org.eclipse.jface.viewers.IDoubleClickListener; -import org.eclipse.jface.viewers.ISelection; -import org.eclipse.jface.viewers.ISelectionChangedListener; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.jface.viewers.SelectionChangedEvent; -import org.eclipse.jface.viewers.StructuredSelection; -import org.eclipse.jface.viewers.TreeViewer; -import org.eclipse.jface.viewers.Viewer; -import org.eclipse.jface.viewers.ViewerSorter; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.KeyAdapter; -import org.eclipse.swt.events.KeyEvent; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Display; -import org.eclipse.swt.widgets.Menu; -import org.eclipse.ui.IEditorDescriptor; -import org.eclipse.ui.IEditorRegistry; -import org.eclipse.ui.IMemento; -import org.eclipse.ui.IViewSite; -import org.eclipse.ui.IWorkbenchActionConstants; -import org.eclipse.ui.PartInitException; -import org.eclipse.ui.PlatformUI; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.ant.view.actions.AddBuildFileAction; -import org.eclipse.ui.externaltools.internal.ant.view.actions.AntOpenWithMenu; -import org.eclipse.ui.externaltools.internal.ant.view.actions.EditLaunchConfigurationAction; -import org.eclipse.ui.externaltools.internal.ant.view.actions.RefreshBuildFilesAction; -import org.eclipse.ui.externaltools.internal.ant.view.actions.RemoveAllAction; -import org.eclipse.ui.externaltools.internal.ant.view.actions.RemoveProjectAction; -import org.eclipse.ui.externaltools.internal.ant.view.actions.RunTargetAction; -import org.eclipse.ui.externaltools.internal.ant.view.actions.SearchForBuildFilesAction; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.RootNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.part.IShowInSource; -import org.eclipse.ui.part.ShowInContext; -import org.eclipse.ui.part.ViewPart; -import org.eclipse.ui.texteditor.IUpdate; - -/** - * A view which displays a hierarchical view of ant build files and allows the - * user to run selected targets from those files. - */ -public class AntView extends ViewPart implements IResourceChangeListener, IShowInSource { - /** - * The root node of the project viewer as restored during initialization - */ - private RootNode restoredRoot = null; - - /** - * XML tag used to identify an ant project in storage - */ - private static final String TAG_PROJECT = "project"; //$NON-NLS-1$ - /** - * XML key used to store whether or not an ant project is an error node. - * Persisting this data saved a huge amount of processing at startup. - */ - private static final String KEY_ERROR = "error"; //$NON-NLS-1$ - /** - * XML key used to store an ant project's path - */ - private static final String KEY_PATH = "path"; //$NON-NLS-1$ - /** - * XML key used to store an ant node's name - */ - private static final String KEY_NAME = "name"; //$NON-NLS-1$ - /** - * XML key used to store an ant project's default target name - */ - private static final String KEY_DEFAULT = "default"; //$NON-NLS-1$ - /** - * XML value for a boolean attribute whose value is <code>true</code> - */ - private static final String VALUE_TRUE = "true"; //$NON-NLS-1$ - /** - * XML value for a boolean attribute whose value is <code>false</code> - */ - private static final String VALUE_FALSE = "false"; //$NON-NLS-1$ - - /** - * The tree viewer that displays the users ant projects - */ - private TreeViewer projectViewer; - private AntProjectContentProvider projectContentProvider; - - /** - * Collection of <code>IUpdate</code> actions that need to update on - * selection changed in the project viewer. - */ - private List updateProjectActions; - // Ant View Actions - private AddBuildFileAction addBuildFileAction; - private SearchForBuildFilesAction searchForBuildFilesAction; - private RefreshBuildFilesAction refreshBuildFilesAction; - private RunTargetAction runTargetAction; - private RemoveProjectAction removeProjectAction; - private RemoveAllAction removeAllAction; - // Context-menu-only actions - private AntOpenWithMenu openWithMenu; - private EditLaunchConfigurationAction editConfigAction; - - /** - * The given build file has changed. Refresh the view to pick up any - * structural changes. - */ - private void handleBuildFileChanged(final ProjectNode project) { - project.parseBuildFile(); - Display.getDefault().asyncExec(new Runnable() { - public void run() { - projectViewer.refresh(project); - } - }); - } - - /** - * @see org.eclipse.ui.IWorkbenchPart#createPartControl(org.eclipse.swt.widgets.Composite) - */ - public void createPartControl(Composite parent) { - initializeActions(); - createProjectViewer(parent); - fillMainToolBar(); - if (getProjects().length > 0) { - // If any projects have been added to the view during startup, - // begin listening for resource changes - ResourcesPlugin.getWorkspace().addResourceChangeListener(this); - } - WorkbenchHelp.setHelp(parent, IExternalToolsHelpContextIds.ANT_VIEW); - updateProjectActions(); - } - - /** - * Creates a pop-up menu on the given control - * - * @param menuControl the control with which the pop-up - * menu will be associated - */ - private void createContextMenu(final Viewer viewer) { - Control menuControl = viewer.getControl(); - MenuManager menuMgr = new MenuManager("#PopUp"); //$NON-NLS-1$ - menuMgr.setRemoveAllWhenShown(true); - menuMgr.addMenuListener(new IMenuListener() { - public void menuAboutToShow(IMenuManager mgr) { - fillContextMenu(viewer, mgr); - } - }); - Menu menu = menuMgr.createContextMenu(menuControl); - menuControl.setMenu(menu); - - // register the context menu such that other plugins may contribute to it - getSite().registerContextMenu(menuMgr, viewer); - } - - /** - * Adds actions to the context menu - * - * @param viewer the viewer who's menu we're configuring - * @param menu The menu to contribute to - */ - private void fillContextMenu(Viewer viewer, IMenuManager menu) { - if (viewer == projectViewer) { - menu.add(addBuildFileAction); - menu.add(new Separator()); - menu.add(runTargetAction); - menu.add(editConfigAction); - menu.add(refreshBuildFilesAction); - addOpenWithMenu(menu); - menu.add(new Separator()); - menu.add(removeProjectAction); - menu.add(removeAllAction); - } - menu.add(new Separator(IWorkbenchActionConstants.MB_ADDITIONS)); - } - - private void addOpenWithMenu(IMenuManager menu) { - IFile buildFile= getSelectionBuildFile(); - if (buildFile != null && buildFile.exists()) { - menu.add(new Separator("group.open")); //$NON-NLS-1$ - IMenuManager submenu= new MenuManager(AntViewMessages.getString("AntView.Open_With_3")); //$NON-NLS-1$ - openWithMenu.setFile(buildFile); - submenu.add(openWithMenu); - menu.appendToGroup("group.open", submenu); //$NON-NLS-1$ - } - } - - /** - * Initialize the actions for this view - */ - private void initializeActions() { - updateProjectActions= new ArrayList(5); - - addBuildFileAction = new AddBuildFileAction(this); - - removeProjectAction = new RemoveProjectAction(this); - updateProjectActions.add(removeProjectAction); - - removeAllAction = new RemoveAllAction(this); - updateProjectActions.add(removeAllAction); - - runTargetAction = new RunTargetAction(this); - updateProjectActions.add(runTargetAction); - - searchForBuildFilesAction = new SearchForBuildFilesAction(this); - - refreshBuildFilesAction = new RefreshBuildFilesAction(this); - updateProjectActions.add(refreshBuildFilesAction); - - openWithMenu= new AntOpenWithMenu(this.getViewSite().getPage()); - - editConfigAction= new EditLaunchConfigurationAction(this); - updateProjectActions.add(editConfigAction); - } - - /** - * Updates the enabled state of all IUpdate actions associated - * with the project viewer. - */ - private void updateProjectActions() { - Iterator iter = updateProjectActions.iterator(); - while (iter.hasNext()) { - ((IUpdate) iter.next()).update(); - } - } - - /** - * Create the viewer which displays the ant projects - */ - private void createProjectViewer(Composite parent) { - projectViewer = new TreeViewer(parent, SWT.H_SCROLL | SWT.V_SCROLL | SWT.MULTI); - projectContentProvider = new AntProjectContentProvider(); - projectViewer.setContentProvider(projectContentProvider); - projectViewer.setLabelProvider(new AntViewLabelProvider()); - projectViewer.setInput(restoredRoot); - projectViewer.setSorter(new ViewerSorter() { - /** - * @see org.eclipse.jface.viewers.ViewerSorter#compare(org.eclipse.jface.viewers.Viewer, java.lang.Object, java.lang.Object) - */ - public int compare(Viewer viewer, Object e1, Object e2) { - return e1.toString().compareToIgnoreCase(e2.toString()); - } - }); - - projectViewer.addSelectionChangedListener(new ISelectionChangedListener() { - public void selectionChanged(SelectionChangedEvent event) { - handleSelectionChanged(event); - } - }); - - projectViewer.addDoubleClickListener(new IDoubleClickListener() { - public void doubleClick(DoubleClickEvent event) { - handleProjectViewerDoubleClick(event); - } - }); - - projectViewer.getControl().addKeyListener(new KeyAdapter() { - public void keyPressed(KeyEvent event) { - handleProjectViewerKeyPress(event); - } - }); - - createContextMenu(projectViewer); - } - - private void handleProjectViewerKeyPress(KeyEvent event) { - if (event.character == SWT.DEL && event.stateMask == 0) { - if (removeProjectAction.isEnabled()) { - removeProjectAction.run(); - } - } else if (event.keyCode == SWT.F5 && event.stateMask == 0) { - if (refreshBuildFilesAction.isEnabled()) { - refreshBuildFilesAction.run(); - } - } - } - - private void handleProjectViewerDoubleClick(DoubleClickEvent event) { - ISelection s= event.getSelection(); - if (!(s instanceof IStructuredSelection)) { - return; - } - Object selection= ((IStructuredSelection)s).getFirstElement(); - if (selection instanceof ProjectNode) { - ProjectNode project = (ProjectNode) selection; - IEditorRegistry registry= PlatformUI.getWorkbench().getEditorRegistry(); - IFile file= AntUtil.getFile(project.getBuildFileName()); - IEditorDescriptor editor = registry.getDefaultEditor(file); - if (editor == null) { - editor= registry.getDefaultEditor(); - } - try { - if (editor == null) { - getViewSite().getPage().openSystemEditor(file); - } else { - getViewSite().getPage().openEditor(file, editor.getId()); - } - } catch (PartInitException e) { - ExternalToolsPlugin.getDefault().log(e); - } - } else if (selection instanceof TargetNode){ - runTargetAction.run(); - } - } - - /** - * Updates the actions and status line for selection change in one of the - * viewers. - */ - private void handleSelectionChanged(SelectionChangedEvent event) { - updateProjectActions(); - Iterator selectionIter = ((IStructuredSelection) event.getSelection()).iterator(); - Object selection = null; - if (selectionIter.hasNext()) { - selection = selectionIter.next(); - } - String messageString= null; - if (!selectionIter.hasNext()) { - messageString= getStatusLineText(selection); - } - getViewSite().getActionBars().getStatusLineManager().setMessage(messageString); - } - - /** - * Returns text appropriate for display in the workbench status line for the - * given node. - */ - private static String getStatusLineText(Object node) { - if (node instanceof ProjectNode) { - ProjectNode project = (ProjectNode) node; - StringBuffer message= new StringBuffer(project.getBuildFileName()); - String description= project.getDescription(); - if (description != null) { - message.append(": "); //$NON-NLS-1$ - message.append(description); - } - return message.toString(); - } else if (node instanceof TargetNode) { - TargetNode target = (TargetNode) node; - StringBuffer message= new StringBuffer(AntViewMessages.getString("AntView.Name___1")); //$NON-NLS-1$ - message.append(target.getName()); - message.append('\"'); - String[] depends= target.getDependencies(); - if (depends.length > 0 ) { - message.append(AntViewMessages.getString("AntView._Depends___2")); //$NON-NLS-1$ - message.append(depends[0]); // Unroll the loop to avoid trailing comma - for (int i = 1; i < depends.length; i++) { - message.append(',').append(depends[i]); - } - message.append('\"'); - } - String description= target.getDescription(); - if (description != null && description.length() != 0) { - message.append(AntViewMessages.getString("AntView._Description___4")); //$NON-NLS-1$ - message.append(description); - message.append('\"'); - } - return message.toString(); - } - return null; - } - - /** - * Returns the tree viewer that displays the projects in this view - * - * @return TreeViewer this view's project viewer - */ - public TreeViewer getProjectViewer() { - return projectViewer; - } - - /** - * Returns the <code>ProjectNode</code>s currently displayed in this view. - * - * @return ProjectNode[] the <code>ProjectNode</code>s currently displayed - * in this view - */ - public ProjectNode[] getProjects() { - return projectContentProvider.getRootNode().getProjects(); - } - - /** - * Adds the given project project to the view - * - * @param project the project to add - */ - public void addProject(ProjectNode project) { - projectContentProvider.addProject(project); - projectViewer.refresh(); - ResourcesPlugin.getWorkspace().addResourceChangeListener(this); - updateProjectActions(); - } - - /** - * Removes the given project from the view - * - * @param project the project to remove - */ - private void removeProject(ProjectNode project) { - removeProjectFromContentProviders(project); - projectViewer.refresh(); - if (getProjects().length == 0) { - ResourcesPlugin.getWorkspace().removeResourceChangeListener(this); - } - } - - /** - * Removes the given list of <code>ProjectNode</code> objects from the view. - * This method should be called whenever multiple projects are to be removed - * because this method optimizes the viewer refresh associated with removing - * multiple items. - * - * @param projectNodes the list of <code>ProjectNode</code> objects to - * remove - */ - public void removeProjects(List projectNodes) { - Iterator iter = projectNodes.iterator(); - while (iter.hasNext()) { - ProjectNode project = (ProjectNode) iter.next(); - removeProjectFromContentProviders(project); - } - projectViewer.refresh(); - } - - /** - * Removes the given project node from the project content provider. Also - * removes any targets from the given project from the target content - * provider. - * - * @param project the project to remove - */ - private void removeProjectFromContentProviders(ProjectNode project) { - projectContentProvider.getRootNode().removeProject(project); - if (!projectContentProvider.getRootNode().hasProjects()) { - ResourcesPlugin.getWorkspace().removeResourceChangeListener(this); - } - } - - /** - * Removes all projects from the view - */ - public void removeAllProjects() { - // Remove all projects - projectContentProvider.getRootNode().removeAllProjects(); - // Refresh the viewer - projectViewer.refresh(); - ResourcesPlugin.getWorkspace().removeResourceChangeListener(this); - updateProjectActions(); - } - - /** - * @see org.eclipse.ui.IWorkbenchPart#setFocus() - */ - public void setFocus() { - if (getProjectViewer() != null) { - getProjectViewer().getControl().setFocus(); - } - } - - /** - * Restore the projects and selected targets - * - * @see org.eclipse.ui.IViewPart#init(IViewSite, IMemento) - */ - public void init(IViewSite site, IMemento memento) throws PartInitException { - init(site); - restoreRoot(memento); - } - - /** - * Initialize the root node by restoring the persisted projects - * - * @param memento the memento containing the persisted projects - */ - private void restoreRoot(IMemento memento) { - if (memento == null) { - restoredRoot = new RootNode(); - return; - } - IMemento[] projects = memento.getChildren(TAG_PROJECT); - if (projects.length < 1) { - restoredRoot = new RootNode(); - return; - } - List projectNodes = new ArrayList(projects.length); - for (int i = 0; i < projects.length; i++) { - IMemento projectMemento = projects[i]; - String pathString = projectMemento.getString(KEY_PATH); - if (!ResourcesPlugin.getWorkspace().getRoot().getFile(new Path(pathString)).exists()) { - // If the file no longer exists, don't add it. - continue; - } - String nameString = projectMemento.getString(KEY_NAME); - String defaultTarget= projectMemento.getString(KEY_DEFAULT); - String errorString = projectMemento.getString(KEY_ERROR); - - ProjectNode project = null; - if (nameString == null) { - nameString = ""; //$NON-NLS-1$ - } - project = new ProjectNode(nameString, pathString); - if (errorString != null && errorString.equals(VALUE_TRUE)) { - project.setIsErrorNode(true); - } - if (defaultTarget != null) { - project.setDefaultTargetName(defaultTarget); - } - projectNodes.add(project); - } - restoredRoot = new RootNode((ProjectNode[]) projectNodes.toArray(new ProjectNode[projectNodes.size()])); - } - - /** - * Save the contents of the project viewer and the target viewer - * - * @see org.eclipse.ui.IViewPart#saveState(IMemento) - */ - public void saveState(IMemento memento) { - // Save the projects - ProjectNode[] projects = projectContentProvider.getRootNode().getProjects(); - ProjectNode project; - IMemento projectMemento; - for (int i = 0; i < projects.length; i++) { - project = projects[i]; - projectMemento = memento.createChild(TAG_PROJECT); - projectMemento.putString(KEY_PATH, project.getBuildFileName()); - projectMemento.putString(KEY_NAME, project.getName()); - String defaultTarget= project.getDefaultTargetName(); - if (project.isErrorNode()) { - projectMemento.putString(KEY_ERROR, VALUE_TRUE); - } else { - if (defaultTarget != null) { - projectMemento.putString(KEY_DEFAULT, defaultTarget); - } - projectMemento.putString(KEY_ERROR, VALUE_FALSE); - } - } - } - - /** - * @see org.eclipse.ui.IWorkbenchPart#dispose() - */ - public void dispose() { - super.dispose(); - if (openWithMenu != null) { - openWithMenu.dispose(); - } - ResourcesPlugin.getWorkspace().removeResourceChangeListener(this); - } - - public void resourceChanged(IResourceChangeEvent event) { - IResourceDelta delta = event.getDelta(); - if (delta != null) { - ProjectNode projects[]= projectContentProvider.getRootNode().getProjects(); - IPath buildFilePath; - for (int i = 0; i < projects.length; i++) { - buildFilePath= new Path(projects[i].getBuildFileName()); - IResourceDelta change= delta.findMember(buildFilePath); - if (change != null) { - handleChangeDelta(change, projects[i]); - } - } - } - } - - /** - * Update the view for the given resource delta. The delta is a resource - * delta for the given build file in the view - * - * @param delta a delta for a build file in the view - * @param project the project node that has changed - */ - private void handleChangeDelta(IResourceDelta delta, final ProjectNode project) { - IResource resource= delta.getResource(); - if (resource.getType() != IResource.FILE) { - return; - } - if (delta.getKind() == IResourceDelta.REMOVED) { - Display.getDefault().asyncExec(new Runnable() { - public void run() { - removeProject(project); - } - }); - } else if (delta.getKind() == IResourceDelta.CHANGED && (delta.getFlags() & IResourceDelta.CONTENT) != 0) { - handleBuildFileChanged(project); - } - } - - private void fillMainToolBar() { - IToolBarManager toolBarMgr= getViewSite().getActionBars().getToolBarManager(); - toolBarMgr.removeAll(); - - toolBarMgr.add(addBuildFileAction); - toolBarMgr.add(searchForBuildFilesAction); - - toolBarMgr.add(runTargetAction); - toolBarMgr.add(removeProjectAction); - toolBarMgr.add(removeAllAction); - - toolBarMgr.update(false); - } - - private IFile getSelectionBuildFile() { - IStructuredSelection selection= (IStructuredSelection)getProjectViewer().getSelection(); - if (selection.size() == 1) { - Object element= selection.getFirstElement(); - ProjectNode projectNode= null; - if (element instanceof ProjectNode) { - projectNode= (ProjectNode)element; - } else if (element instanceof TargetNode) { - projectNode= ((TargetNode)element).getProject(); - } - if (projectNode != null) { - return AntUtil.getFile(projectNode.getBuildFileName()); - } - } - return null; - } - - /* (non-Javadoc) - * @see org.eclipse.ui.part.IShowInSource#getShowInContext() - */ - public ShowInContext getShowInContext() { - IFile buildFile= getSelectionBuildFile(); - if (buildFile != null && buildFile.exists()) { - ISelection selection= new StructuredSelection(buildFile); - return new ShowInContext(null, selection); - } - return null; - } -}
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewLabelProvider.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewLabelProvider.java deleted file mode 100644 index 949c4450a..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewLabelProvider.java +++ /dev/null @@ -1,135 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view; - - -import org.eclipse.jface.resource.CompositeImageDescriptor; -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.jface.viewers.IColorProvider; -import org.eclipse.jface.viewers.ILabelProvider; -import org.eclipse.jface.viewers.ILabelProviderListener; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Color; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; -import org.eclipse.ui.externaltools.internal.model.AntImageDescriptor; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; - -/** - * A label provider that provides labels for elements displayed in the - * <code>AntView</code> - */ -public class AntViewLabelProvider implements ILabelProvider, IColorProvider { - - /** - * @see org.eclipse.jface.viewers.ILabelProvider#getImage(java.lang.Object) - */ - public Image getImage(Object element) { - if (element instanceof ProjectNode) { - ProjectNode project= (ProjectNode) element; - int flags = 0; - if (project.isErrorNode()) { - flags = flags | AntImageDescriptor.HAS_ERRORS; - } - CompositeImageDescriptor descriptor = new AntImageDescriptor(ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_PROJECT), flags); - return ExternalToolsImages.getImage(descriptor); - } else if (element instanceof TargetNode) { - TargetNode target= (TargetNode) element; - int flags = 0; - ImageDescriptor base = null; - if (target.equals(target.getProject().getDefaultTarget())){ - flags = flags | AntImageDescriptor.DEFAULT_TARGET; - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_DEFAULT_TARGET); - } else if (target.getDescription() == null) { - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_TARGET_PRIVATE); - } else { - base = ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ANT_TARGET); - } - if (target.isErrorNode()) { - flags = flags | AntImageDescriptor.HAS_ERRORS; - } - return ExternalToolsImages.getImage(new AntImageDescriptor(base, flags)); - } - return null; - } - - /** - * @see org.eclipse.jface.viewers.ILabelProvider#getText(java.lang.Object) - */ - public String getText(Object element) { - if (element instanceof TargetNode) { - TargetNode node= (TargetNode)element; - StringBuffer name= new StringBuffer(node.getName()); - if (node.getName().equals(node.getProject().getDefaultTargetName())) { - name.append(AntViewMessages.getString("TargetNode.default")); //$NON-NLS-1$ - } - return name.toString(); - } else if (element instanceof ProjectNode) { - ProjectNode project= (ProjectNode) element; - StringBuffer buffer= new StringBuffer(project.getName()); - String defaultTarget= project.getDefaultTargetName(); - if (defaultTarget != null) { - buffer.append(" [").append(defaultTarget).append(']'); //$NON-NLS-1$ - } - return buffer.toString(); - } else { - return element.toString(); - } - } - - /** - * @see org.eclipse.jface.viewers.IBaseLabelProvider#addListener(org.eclipse.jface.viewers.ILabelProviderListener) - */ - public void addListener(ILabelProviderListener listener) { - } - - /** - * @see org.eclipse.jface.viewers.IBaseLabelProvider#dispose() - */ - public void dispose() { - } - - /** - * @see org.eclipse.jface.viewers.IBaseLabelProvider#isLabelProperty(java.lang.Object, java.lang.String) - */ - public boolean isLabelProperty(Object element, String property) { - return false; - } - - /** - * @see org.eclipse.jface.viewers.IBaseLabelProvider#removeListener(org.eclipse.jface.viewers.ILabelProviderListener) - */ - public void removeListener(ILabelProviderListener listener) { - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IColorProvider#getForeground(java.lang.Object) - */ - public Color getForeground(Object element) { - if (element instanceof TargetNode) { - TargetNode target= (TargetNode)element; - if (target == target.getProject().getDefaultTarget()) { - return Display.getDefault().getSystemColor(SWT.COLOR_BLUE); - } - } - return null; - } - - /* (non-Javadoc) - * @see org.eclipse.jface.viewers.IColorProvider#getBackground(java.lang.Object) - */ - public Color getBackground(Object element) { - return null; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewMessages.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewMessages.java deleted file mode 100644 index eca69110d..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntViewMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.view.AntViewMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntViewMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewMessages.properties b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewMessages.properties deleted file mode 100644 index cbead01e0..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/AntViewMessages.properties +++ /dev/null @@ -1,17 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -AntView.Open_With_3=Open With -AntView.Name___1=name=" -AntView._Depends___2=\ depends=" -AntView._Description___4=\ description=" - -TargetNode.default=\ [default]
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AddBuildFileAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AddBuildFileAction.java deleted file mode 100644 index 63dbe8a63..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AddBuildFileAction.java +++ /dev/null @@ -1,64 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.jface.action.Action; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.FileSelectionDialog; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * Action that prompts the user for a build file and adds the selected file to - * an <code>AntView</code> - */ -public class AddBuildFileAction extends Action { - - private AntView view; - - public AddBuildFileAction(AntView view) { - super(AntViewActionMessages.getString("AddBuildFileAction.Add_Build_File_1"), ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_ADD)); //$NON-NLS-1$ - this.view= view; - setToolTipText(AntViewActionMessages.getString("AddBuildFileAction.Add_Build_File_1")); //$NON-NLS-1$ - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.ADD_BUILDFILE_ACTION); - } - - /** - * @see org.eclipse.jface.action.IAction#run() - */ - public void run() { - FileSelectionDialog dialog = new FileSelectionDialog(Display.getCurrent().getActiveShell(), ResourcesPlugin.getWorkspace().getRoot(), AntViewActionMessages.getString("AddBuildFileAction.&Select")); //$NON-NLS-1$ - dialog.setFileFilter("*.xml", true); //$NON-NLS-1$ - dialog.open(); - IFile file= dialog.getResult(); - if (file == null) { - return; - } - String buildFileName= file.getFullPath().toString(); - ProjectNode[] existingProjects= view.getProjects(); - for (int j = 0; j < existingProjects.length; j++) { - ProjectNode existingProject = existingProjects[j]; - if (existingProject.getBuildFileName().equals(buildFileName)) { - // Don't parse projects that have already been added. - return; - } - } - ProjectNode project= new ProjectNode(buildFileName); - view.addProject(project); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntOpenWithMenu.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntOpenWithMenu.java deleted file mode 100644 index cde37df22..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntOpenWithMenu.java +++ /dev/null @@ -1,299 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import java.text.MessageFormat; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Comparator; -import java.util.Hashtable; -import java.util.Iterator; -import java.util.List; -import java.util.Map; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.jface.action.ContributionItem; -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.swt.SWT; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.program.Program; -import org.eclipse.swt.widgets.Event; -import org.eclipse.swt.widgets.Listener; -import org.eclipse.swt.widgets.Menu; -import org.eclipse.swt.widgets.MenuItem; -import org.eclipse.ui.IEditorDescriptor; -import org.eclipse.ui.IEditorRegistry; -import org.eclipse.ui.IWorkbenchPage; -import org.eclipse.ui.PartInitException; -import org.eclipse.ui.PlatformUI; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; - -/** - * - * Code mostly a copy of the OpenWithMenu which cannot be effectively subclassed - */ -public class AntOpenWithMenu extends ContributionItem { - - private IWorkbenchPage page; - private IAdaptable file; - private IEditorRegistry registry = PlatformUI.getWorkbench().getEditorRegistry(); - private static final String SYSTEM_EDITOR_ID= PlatformUI.PLUGIN_ID + ".SystemEditor"; //$NON-NLS-1$ - - private static Map imageCache = new Hashtable(11); - - /** - * The id of this action. - */ - public static final String ID = IExternalToolConstants.PLUGIN_ID + ".AntOpenWithMenu"; //$NON-NLS-1$ - - public AntOpenWithMenu(IWorkbenchPage page) { - super(ID); - this.page= page; - } - - public void setFile(IAdaptable file) { - this.file= file; - } - - public void dispose() { - super.dispose(); - Iterator iter= imageCache.values().iterator(); - while (iter.hasNext()) { - Image image = (Image) iter.next(); - image.dispose(); - } - imageCache.clear(); - } - - /** - * Returns an image to show for the corresponding editor descriptor. - * - * @param editorDesc the editor descriptor, or null for the system editor - * @return the image or null - */ - private Image getImage(IEditorDescriptor editorDesc) { - ImageDescriptor imageDesc = getImageDescriptor(editorDesc); - if (imageDesc == null) { - return null; - } - Image image = (Image) imageCache.get(imageDesc); - if (image == null) { - image = imageDesc.createImage(); - imageCache.put(imageDesc, image); - } - return image; - } - - /** - * Returns the image descriptor for the given editor descriptor, - * or null if it has no image. - */ - private ImageDescriptor getImageDescriptor(IEditorDescriptor editorDesc) { - ImageDescriptor imageDesc = null; - if (editorDesc == null) { - imageDesc = registry.getImageDescriptor(getFileResource()); - } else { - imageDesc = editorDesc.getImageDescriptor(); - } - if (imageDesc == null) { - if (editorDesc.getId().equals(SYSTEM_EDITOR_ID)) { - imageDesc = getSystemEditorImageDescriptor(getFileResource().getFileExtension()); - } - } - return imageDesc; - } - - /** - * Return the image descriptor of the system editor - * that is registered with the OS to edit files of - * this type. Null if none can be found. - */ - private ImageDescriptor getSystemEditorImageDescriptor(String extension) { - Program externalProgram = null; - if (extension != null) { - externalProgram = Program.findProgram(extension); - } - if (externalProgram == null) { - return null; - } else { - return new EditorImageDescriptor(externalProgram); - } - } - /** - * Creates the menu item for the editor descriptor. - * - * @param menu the menu to add the item to - * @param descriptor the editor descriptor, or null for the system editor - * @param preferredEditor the descriptor of the preferred editor, or <code>null</code> - */ - private void createMenuItem(Menu menu, final IEditorDescriptor descriptor, final IEditorDescriptor preferredEditor) { - // XXX: Would be better to use bold here, but SWT does not support it. - final MenuItem menuItem = new MenuItem(menu, SWT.RADIO); - boolean isPreferred = preferredEditor != null && descriptor.getId().equals(preferredEditor.getId()); - menuItem.setSelection(isPreferred); - menuItem.setText(descriptor.getLabel()); - Image image = getImage(descriptor); - if (image != null) { - menuItem.setImage(image); - } - Listener listener = new Listener() { - public void handleEvent(Event event) { - switch (event.type) { - case SWT.Selection : - if (menuItem.getSelection()) { - openEditor(descriptor); - } - break; - } - } - }; - menuItem.addListener(SWT.Selection, listener); - } - /* (non-Javadoc) - * Fills the menu with perspective items. - */ - public void fill(Menu menu, int index) { - IFile file = getFileResource(); - if (file == null) { - return; - } - - IEditorDescriptor defaultEditor = registry.getDefaultEditor(); // should not be null - IEditorDescriptor preferredEditor = registry.getDefaultEditor(file); // may be null - - Object[] editors= registry.getEditors(file); - Arrays.sort(editors, new Comparator() { - /** - * @see java.util.Comparator#compare(java.lang.Object, java.lang.Object) - */ - public int compare(Object o1, Object o2) { - String s1 = ((IEditorDescriptor) o1).getLabel(); - String s2 = ((IEditorDescriptor) o2).getLabel(); - //Return true if elementTwo is 'greater than' elementOne - return s1.compareToIgnoreCase(s2); - } - }); - IEditorDescriptor antEditor= registry.findEditor("org.eclipse.ui.externaltools.internal.ant.editor.AntEditor"); //$NON-NLS-1$ - - boolean defaultFound = false; - boolean antFound= false; - List alreadyAddedEditors= new ArrayList(editors.length); - for (int i = 0; i < editors.length; i++) { - IEditorDescriptor editor = (IEditorDescriptor) editors[i]; - if (alreadyAddedEditors.contains(editor.getId())) { - continue; - } - createMenuItem(menu, editor, preferredEditor); - if (defaultEditor != null && editor.getId().equals(defaultEditor.getId())) { - defaultFound = true; - } - if (antEditor != null && editor.getId().equals(antEditor.getId())) { - antFound= true; - } - alreadyAddedEditors.add(editor.getId()); - - } - - // Only add a separator if there is something to separate - if (editors.length > 0) { - new MenuItem(menu, SWT.SEPARATOR); - } - - // Add ant editor. - if (!antFound && antEditor != null) { - createMenuItem(menu, antEditor, preferredEditor); - } - - // Add default editor. - if (!defaultFound && defaultEditor != null) { - createMenuItem(menu, defaultEditor, preferredEditor); - } - - // Add system editor. - IEditorDescriptor descriptor = registry.findEditor(SYSTEM_EDITOR_ID); - createMenuItem(menu, descriptor, preferredEditor); - createDefaultMenuItem(menu, file); - } - - /** - * Converts the IAdaptable file to IFile or null. - */ - private IFile getFileResource() { - if (this.file instanceof IFile) { - return (IFile) this.file; - } else { - IResource resource = (IResource) this.file.getAdapter(IResource.class); - if (resource instanceof IFile) { - return (IFile) resource; - } - } - return null; - } - /* (non-Javadoc) - * Returns whether this menu is dynamic. - */ - public boolean isDynamic() { - return true; - } - /** - * Opens the given editor on the selected file. - * - * @param editor the editor descriptor, or null for the system editor - */ - private void openEditor(IEditorDescriptor editor) { - IFile file = getFileResource(); - try { - if (editor == null) { - page.openSystemEditor(file); - } else { - page.openEditor(file, editor.getId()); - } - } catch (PartInitException e) { - ExternalToolsPlugin.getDefault().log(MessageFormat.format(AntViewActionMessages.getString("AntViewOpenWithMenu.Editor_failed"), new String[]{file.getLocation().toOSString()}), e); //$NON-NLS-1$ - } - } - - /** - * Creates the menu item for the default editor - * - * @param menu the menu to add the item to - * @param file the file being edited - * @param registry the editor registry - */ - private void createDefaultMenuItem(Menu menu, final IFile file) { - final MenuItem menuItem = new MenuItem(menu, SWT.RADIO); - menuItem.setSelection(registry.getDefaultEditor(file) == null); - menuItem.setText(AntViewActionMessages.getString("AntViewOpenWithMenu.Default_Editor_4")); //$NON-NLS-1$ - - Listener listener = new Listener() { - public void handleEvent(Event event) { - switch (event.type) { - case SWT.Selection : - if (menuItem.getSelection()) { - registry.setDefaultEditor(file, null); - try { - page.openEditor(file); - } catch (PartInitException e) { - ExternalToolsPlugin.getDefault().log(MessageFormat.format(AntViewActionMessages.getString("AntViewOpenWithMenu.Editor_failed"), new String[]{file.getLocation().toOSString()}), e); //$NON-NLS-1$ - } - } - break; - } - } - }; - - menuItem.addListener(SWT.Selection, listener); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntViewActionMessages.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntViewActionMessages.java deleted file mode 100644 index 55d55bec0..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntViewActionMessages.java +++ /dev/null @@ -1,33 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntViewActionMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.view.actions.AntViewActionMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle(BUNDLE_NAME); - - private AntViewActionMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntViewActionMessages.properties b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntViewActionMessages.properties deleted file mode 100644 index 18d0deead..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/AntViewActionMessages.properties +++ /dev/null @@ -1,40 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -SearchForBuildFilesDialog.Search_for_Build_Files_1=Search for Buildfiles -SearchForBuildFilesDialog.&Input=&Input a buildfile name (* = any string, ? = any character): -SearchForBuildFilesDialog.Build_name_cannot_be_empty_3=Build name cannot be empty -SearchForBuildFilesDialog.&Search_4=&Search -SearchForBuildFilesDialog.Scope_5=Scope -SearchForBuildFilesDialog.&Workspace_6=&Workspace -SearchForBuildFilesDialog.Wor&king_Set__7=Wor&king Set: -SearchForBuildFilesDialog.&Choose..._8=&Choose... -SearchForBuildFilesDialog.Include_errors=Include &buildfiles that contain errors -SearchForBuildFilesDialog.Must_select_a_working_set_10=Must select a working set -SearchForBuildFilesDialog.No_searchable=No searchable resources found in the selected working set -AntViewOpenWithMenu.Editor_failed=Editor failed to open for {0} -AntViewOpenWithMenu.Default_Editor_4=Default Editor -AddBuildFileAction.Add_Build_File_1=Add Buildfile -AddBuildFileAction.&Select=&Select a buildfile: -RemoveAllAction.Remove_All=Remove All Buildfiles -RemoveProjectAction.Remove=Remove Buildfile -RemoveProjectAction.Remove_2=Remove Selected Buildfile -RunTargetAction.Run_1=Run -RunTargetAction.Run_Default=Run the Default Target of the Selected Buildfile -SearchForBuildFilesAction.Search_1=Search -SearchForBuildFilesAction.Add_build_files_with_search_2=Add Buildfiles with Search -SearchForBuildFilesAction.Processing_search_results_3=Processing search results -SearchForBuildFilesAction.Adding_{0}_4=Adding {0} -EditLaunchConfigurationAction.Properties=&Properties... -EditLaunchConfigurationAction.Edit=Edit the launch configuration properties for selected buildfile -RefreshBuildFilesAction.Refresh_Buildfiles_1=Refresh Buildfiles -RefreshBuildFilesAction.Refreshing_buildfiles_3=Refreshing buildfiles -RefreshBuildFilesAction.Refreshing_{0}_4=Refreshing {0} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/EditLaunchConfigurationAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/EditLaunchConfigurationAction.java deleted file mode 100644 index f188a52bf..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/EditLaunchConfigurationAction.java +++ /dev/null @@ -1,153 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import java.util.Iterator; -import java.util.List; - -import org.eclipse.core.resources.IFile; -import org.eclipse.debug.core.ILaunchConfiguration; -import org.eclipse.debug.ui.DebugUITools; -import org.eclipse.jface.action.Action; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntLaunchShortcut; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.ant.view.elements.AntNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.texteditor.IUpdate; - -/** - * Action for activating a target node selected in the ant view - */ -public class EditLaunchConfigurationAction extends Action implements IUpdate { - - private AntView view; - private ProjectNode projectNode; - - public EditLaunchConfigurationAction(AntView view) { - super(AntViewActionMessages.getString("EditLaunchConfigurationAction.Properties")); //$NON-NLS-1$ - setDescription(AntViewActionMessages.getString("EditLaunchConfigurationAction.Edit")); //$NON-NLS-1$ - this.view= view; - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.EDIT_LAUNCH_CONFIGURATION_ACTION); - } - - public void run() { - IFile file= AntUtil.getFile(projectNode.getBuildFileName()); - ILaunchConfiguration configuration= null; - List configurations = AntLaunchShortcut.findExistingLaunchConfigurations(file); - if (configurations.isEmpty()) { - configuration = AntLaunchShortcut.createDefaultLaunchConfiguration(file); - } else { - if (configurations.size() == 1) { - configuration= (ILaunchConfiguration)configurations.get(0); - } else { - configuration= AntLaunchShortcut.chooseConfig(configurations); - if (configuration == null) { - // User cancelled selection - return; - } - } - } - if (configuration != null) { - DebugUITools.openLaunchConfigurationPropertiesDialog(view.getSite().getShell(), configuration, IExternalToolConstants.ID_EXTERNAL_TOOLS_BUILDER_LAUNCH_GROUP); - } - } - - /** - * Updates the enablement of this action based on the user's selection - */ - public void update() { - boolean enabled= false; - IStructuredSelection selection= (IStructuredSelection) view.getProjectViewer().getSelection(); - if (selection.size() == 1) { - Object element= selection.getFirstElement(); - if (element instanceof ProjectNode) { - if (!((ProjectNode)element).isErrorNode()) { - enabled= true; - projectNode= (ProjectNode)element; - } - } else if (element instanceof TargetNode) { - if (!((TargetNode)element).isErrorNode()) { - enabled= true; - projectNode= getProjectNode((AntNode)element); - } - } else if (element instanceof AntNode) { - projectNode= getProjectNode((AntNode)element); - enabled= true; - } - } else if (!selection.isEmpty()){ - //all non-error nodes from the same project - Iterator iter= selection.iterator(); - Object data= null; - enabled= true; - ProjectNode tempProjectNode= null; - while (iter.hasNext()) { - data= iter.next(); - if (!(data instanceof AntNode)) { - continue; - } - if (data instanceof TargetNode) { - TargetNode targetNode= (TargetNode) data; - if(targetNode.isErrorNode()) { - enabled= false; - break; - } - } - if (data instanceof ProjectNode) { - ProjectNode projectNode= (ProjectNode) data; - if(projectNode.isErrorNode()) { - enabled= false; - break; - } - } - - tempProjectNode= getProjectNode((AntNode)data); - if (projectNode != null) { - if (!(projectNode.equals(tempProjectNode))) { - enabled= false; - break; - } - } else { - projectNode= tempProjectNode; - } - } - } - - if (!enabled) { - projectNode= null; - } - setEnabled(enabled); - } - - /** - * Method getProjectNode. - * @param antNode - * @return ProjectNode - */ - private ProjectNode getProjectNode(AntNode antNode) { - AntNode parentNode= null; - if (antNode instanceof ProjectNode) { - parentNode= antNode; - } else { - parentNode= antNode.getParent(); - while (parentNode != null && !(parentNode instanceof ProjectNode)) { - parentNode= parentNode.getParent(); - } - } - return (ProjectNode)parentNode; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/EditorImageDescriptor.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/EditorImageDescriptor.java deleted file mode 100644 index bf3e4129b..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/EditorImageDescriptor.java +++ /dev/null @@ -1,93 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import org.eclipse.jface.resource.ImageDescriptor; -import org.eclipse.swt.graphics.Image; -import org.eclipse.swt.graphics.ImageData; -import org.eclipse.swt.program.Program; -import org.eclipse.ui.ISharedImages; -import org.eclipse.ui.PlatformUI; - -/** - * Copy of org.eclipse.ui.internal.misc.ExternalProgramImageDescriptor for - * use in the AntViewOpenWithMenu - */ -public class EditorImageDescriptor extends ImageDescriptor { - - public Program program; - - /** - * Creates a new ImageDescriptor. The image is loaded - * from a file with the given name <code>name</code>. - */ - public EditorImageDescriptor(Program program) { - this.program = program; - } - /** - * @see Object#equals - */ - public boolean equals(Object o) { - if (!(o instanceof EditorImageDescriptor)) { - return false; - } - EditorImageDescriptor other = (EditorImageDescriptor) o; - - //See if there is a name - compare it if so and compare the programs if not - String otherName = other.program.getName(); - if (otherName == null) { - return other.program.equals(program); - } else { - return otherName.equals(program.getName()); - } - } - /** - * Returns an SWT Image that is described by the information - * in this descriptor. Each call returns a new Image. - */ - public Image getImage() { - return createImage(); - } - - /** - * @see org.eclipse.jface.resource.ImageDescriptor#getImageData() - */ - public ImageData getImageData() { - - ImageData defaultImage = PlatformUI.getWorkbench().getSharedImages().getImageDescriptor(ISharedImages.IMG_OBJ_FILE).getImageData(); - if (defaultImage == null) { - return null; - } - ImageData data = null; - if (program == null || ((data = program.getImageData()) == null)) { - return defaultImage; - } - - //The images in GNOME are too big. Scaling them does not give nice result so return defaultImage; - if (data.height > defaultImage.height || data.width > defaultImage.width) { - return defaultImage; - } - - return data; - } - /** - * @see Object#hashCode - */ - public int hashCode() { - String programName = program.getName(); - if (programName == null) { - return program.hashCode(); - } else { - return programName.hashCode(); - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RefreshBuildFilesAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RefreshBuildFilesAction.java deleted file mode 100644 index 738e4ace3..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RefreshBuildFilesAction.java +++ /dev/null @@ -1,118 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - -import java.lang.reflect.InvocationTargetException; -import java.text.MessageFormat; -import java.util.HashSet; -import java.util.Iterator; -import java.util.Set; - -import org.eclipse.core.runtime.IProgressMonitor; -import org.eclipse.jface.action.Action; -import org.eclipse.jface.dialogs.ProgressMonitorDialog; -import org.eclipse.jface.operation.IRunnableWithProgress; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolConstants; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.texteditor.IUpdate; - -/** - * Action which refreshes the selected buildfiles in the Ant view - */ -public class RefreshBuildFilesAction extends Action implements IUpdate { - - private AntView view; - - /** - * Creates a new <code>RefreshBuildFilesAction</code> which will refresh buildfiles - * in the given Ant view. - * @param view the Ant view whose selection this action will use when - * determining which buildfiles to refresh. - */ - public RefreshBuildFilesAction(AntView view) { - super(AntViewActionMessages.getString("RefreshBuildFilesAction.Refresh_Buildfiles_1"), ExternalToolsImages.getImageDescriptor(IExternalToolConstants.IMG_ACTION_REFRESH)); //$NON-NLS-1$ - setToolTipText(AntViewActionMessages.getString("RefreshBuildFilesAction.Refresh_Buildfiles_1")); //$NON-NLS-1$ - this.view = view; - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.REFRESH_BUILDFILE_ACTION); - } - - /** - * Refreshes the selected buildfiles (or all buildfiles if none selected) in the Ant view - */ - public void run() { - final Set projects= getSelectedProjects(); - if (projects.isEmpty()) { - // If no selection, add all - ProjectNode allProjects[]= view.getProjects(); - for (int i = 0; i < allProjects.length; i++) { - projects.add(allProjects[i]); - } - } - final Iterator iter= projects.iterator(); - if (!iter.hasNext()) { - return; - } - final ProgressMonitorDialog progressDialog= new ProgressMonitorDialog(Display.getDefault().getActiveShell()); - try { - progressDialog.run(true, true, new IRunnableWithProgress() { - public void run(IProgressMonitor monitor) throws InvocationTargetException, InterruptedException { - monitor.beginTask(AntViewActionMessages.getString("RefreshBuildFilesAction.Refreshing_buildfiles_3"), projects.size()); //$NON-NLS-1$ - ProjectNode project; - while (iter.hasNext()) { - project= (ProjectNode) iter.next(); - monitor.subTask(MessageFormat.format(AntViewActionMessages.getString("RefreshBuildFilesAction.Refreshing_{0}_4"), new String[] {project.getBuildFileName()})); //$NON-NLS-1$ - project.parseBuildFile(); - monitor.worked(1); - } - } - }); - } catch (InvocationTargetException e) { - } catch (InterruptedException e) { - } - view.getProjectViewer().refresh(); - } - - /** - * Returns the selected project nodes to refresh - * - * @return Set the selected <code>ProjectNode</code>s to refresh. - */ - private Set getSelectedProjects() { - IStructuredSelection selection = (IStructuredSelection) view.getProjectViewer().getSelection(); - HashSet set= new HashSet(); - Iterator iter = selection.iterator(); - Object data; - while (iter.hasNext()) { - data= iter.next(); - if (data instanceof ProjectNode) { - set.add(data); - } else if (data instanceof TargetNode) { - set.add(((TargetNode) data).getProject()); - } - } - return set; - } - - /** - * Updates the enablement of this action based on the user's selection - */ - public void update() { - setEnabled(view.getProjects().length > 0); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RemoveAllAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RemoveAllAction.java deleted file mode 100644 index 37f2ae1a0..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RemoveAllAction.java +++ /dev/null @@ -1,43 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import org.eclipse.jface.action.Action; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.texteditor.IUpdate; - -public class RemoveAllAction extends Action implements IUpdate { - private AntView view; - - public RemoveAllAction(AntView view) { - super(AntViewActionMessages.getString("RemoveAllAction.Remove_All"), ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_REMOVE_ALL)); //$NON-NLS-1$ - setDescription(AntViewActionMessages.getString("RemoveAllAction.Remove_All")); //$NON-NLS-1$ - setToolTipText(AntViewActionMessages.getString("RemoveAllAction.Remove_All")); //$NON-NLS-1$ - this.view= view; - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.REMOVE_ALL_ACTION); - } - - public void run() { - view.removeAllProjects(); - } - - /* (non-Javadoc) - * @see org.eclipse.ui.texteditor.IUpdate#update() - */ - public void update() { - setEnabled(view.getProjectViewer().getTree().getItemCount() != 0); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RemoveProjectAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RemoveProjectAction.java deleted file mode 100644 index ae6dd7e94..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RemoveProjectAction.java +++ /dev/null @@ -1,78 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.jface.action.Action; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.texteditor.IUpdate; - -/** - * Action that removes selected build files from an <code>AntView</code> - */ -public class RemoveProjectAction extends Action implements IUpdate { - - private AntView view; - - public RemoveProjectAction(AntView view) { - super(AntViewActionMessages.getString("RemoveProjectAction.Remove"), ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_REMOVE)); //$NON-NLS-1$ - this.view= view; - setToolTipText(AntViewActionMessages.getString("RemoveProjectAction.Remove_2")); //$NON-NLS-1$ - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.REMOVE_PROJECT_ACTION); - } - - /** - * @see org.eclipse.jface.action.IAction#run() - */ - public void run() { - IStructuredSelection selection= (IStructuredSelection) view.getProjectViewer().getSelection(); - Iterator iter= selection.iterator(); - Object element; - List projectNodes= new ArrayList(); - while (iter.hasNext()) { - element= iter.next(); - if (element instanceof ProjectNode) { - projectNodes.add(element); - } - } - view.removeProjects(projectNodes); - } - - /** - * @see org.eclipse.ui.texteditor.IUpdate#update() - */ - public void update() { - IStructuredSelection selection= (IStructuredSelection) view.getProjectViewer().getSelection(); - if (selection.isEmpty()) { - setEnabled(false); - return; - } - Object element; - Iterator iter= selection.iterator(); - while (iter.hasNext()) { - element= iter.next(); - if (!(element instanceof ProjectNode)) { - setEnabled(false); - return; - } - } - setEnabled(true); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RunTargetAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RunTargetAction.java deleted file mode 100644 index 18494cc24..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/RunTargetAction.java +++ /dev/null @@ -1,133 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import java.util.Iterator; - -import org.eclipse.core.resources.IFile; -import org.eclipse.debug.core.ILaunchManager; -import org.eclipse.jface.action.Action; -import org.eclipse.jface.viewers.IStructuredSelection; -import org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntLaunchShortcut; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.ant.view.elements.AntNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.ant.view.elements.TargetNode; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.help.WorkbenchHelp; -import org.eclipse.ui.texteditor.IUpdate; - -/** - * Action which runs the selected target or the default target of the selected - * project in the AntView. - */ -public class RunTargetAction extends Action implements IUpdate { - - private AntView view; - - /** - * Creates a new <code>RunTargetAction</code> which will execute - * targets in the given view. - * @param view the Ant view whose selection this action will use when - * determining which target to run. - */ - public RunTargetAction(AntView view) { - super(AntViewActionMessages.getString("RunTargetAction.Run_1"), ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_RUN)); //$NON-NLS-1$ - setToolTipText(AntViewActionMessages.getString("RunTargetAction.Run_Default")); //$NON-NLS-1$ - this.view= view; - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.RUN_TARGET_ACTION); - } - - /** - * Executes the selected target or project in the Ant view. - */ - public void run() { - TargetNode target= getSelectedTarget(); - if (target == null) { - return; - } - run(target); - } - - /** - * Executes the given target - * @param target the target to execute - */ - public void run(TargetNode target) { - IFile file= AntUtil.getFile(target.getProject().getBuildFileName()); - if (file == null) { - ExternalToolsPlugin.getStandardDisplay().beep(); - return; - } - AntLaunchShortcut shortcut= new AntLaunchShortcut(); - shortcut.launch(file, ILaunchManager.RUN_MODE, target.getName()); - } - - /** - * Updates the enablement of this action based on the user's selection - */ - public void update() { - AntNode selection= getSelectedElement(); - boolean enabled= false; - if (selection instanceof TargetNode) { - if (!((TargetNode) selection).isErrorNode()) { - enabled= true; - } - } else if (selection instanceof ProjectNode) { - if (!((ProjectNode) selection).isErrorNode()) { - enabled= true; - } - } - setEnabled(enabled); - } - - /** - * Returns the selected target or project node or <code>null</code> if no target or - * project is selected or if more than one element is selected. - * - * @return AntNode the selected <code>TargetNode</code> or <code>ProjectNode</code> - */ - private AntNode getSelectedElement() { - IStructuredSelection selection= (IStructuredSelection) view.getProjectViewer().getSelection(); - if (selection.isEmpty()) { - return null; - } - Iterator iter= selection.iterator(); - Object data= iter.next(); - if (iter.hasNext() || (!(data instanceof TargetNode) && !(data instanceof ProjectNode))) { - // Only return a TargetNode or ProjectNode - return null; - } - return (AntNode) data; - } - - /** - * Returns the selected target in the project viewer or <code>null</code> if - * no target is selected or more than one element is selected. - * - * @return TargetNode the selected target - */ - private TargetNode getSelectedTarget() { - AntNode selectedNode= getSelectedElement(); - if (selectedNode instanceof TargetNode) { - return (TargetNode) selectedNode; - } else if (selectedNode instanceof ProjectNode) { - return ((ProjectNode) selectedNode).getDefaultTarget(); - } - return null; - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/SearchForBuildFilesAction.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/SearchForBuildFilesAction.java deleted file mode 100644 index a77057762..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/SearchForBuildFilesAction.java +++ /dev/null @@ -1,98 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; -import java.lang.reflect.InvocationTargetException; -import java.text.MessageFormat; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.runtime.IProgressMonitor; -import org.eclipse.jface.action.Action; -import org.eclipse.jface.dialogs.Dialog; -import org.eclipse.jface.dialogs.ProgressMonitorDialog; -import org.eclipse.jface.operation.IRunnableWithProgress; -import org.eclipse.swt.widgets.Display; -import org.eclipse.ui.externaltools.internal.ant.view.AntView; -import org.eclipse.ui.externaltools.internal.ant.view.elements.ProjectNode; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsImages; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.ui.IExternalToolsUIConstants; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * This action opens a dialog to search for build files and adds the resulting - * projects to the ant view. - */ -public class SearchForBuildFilesAction extends Action { - private AntView view; - - public SearchForBuildFilesAction(AntView view) { - super(AntViewActionMessages.getString("SearchForBuildFilesAction.Search_1"), ExternalToolsImages.getImageDescriptor(IExternalToolsUIConstants.IMG_SEARCH)); //$NON-NLS-1$ - setToolTipText(AntViewActionMessages.getString("SearchForBuildFilesAction.Add_build_files_with_search_2")); //$NON-NLS-1$ - this.view= view; - WorkbenchHelp.setHelp(this, IExternalToolsHelpContextIds.SEARCH_FOR_BUILDFILES_ACTION); - } - - /** - * Opens the <code>SearchForBuildFilesDialog</code> and adds the results to - * the ant view. - */ - public void run() { - SearchForBuildFilesDialog dialog= new SearchForBuildFilesDialog(); - if (dialog.open() != Dialog.CANCEL) { - final IFile[] files= dialog.getResults(); - final boolean includeErrorNodes= dialog.getIncludeErrorResults(); - final ProgressMonitorDialog progressDialog= new ProgressMonitorDialog(Display.getCurrent().getActiveShell()); - final ProjectNode[] existingProjects= view.getProjects(); - try { - progressDialog.run(true, true, new IRunnableWithProgress() { - public void run(IProgressMonitor monitor) throws InvocationTargetException, InterruptedException { - monitor.beginTask(AntViewActionMessages.getString("SearchForBuildFilesAction.Processing_search_results_3"), files.length); //$NON-NLS-1$ - for (int i = 0; i < files.length && !monitor.isCanceled(); i++) { - String buildFileName= files[i].getFullPath().toString(); - monitor.subTask(MessageFormat.format(AntViewActionMessages.getString("SearchForBuildFilesAction.Adding_{0}_4"), new String[] {buildFileName})); //$NON-NLS-1$ - if (alreadyAdded(buildFileName)) { - // Don't parse projects that have already been added. - continue; - } - final ProjectNode project= new ProjectNode(buildFileName); - // Force the project to be parsed so the error state is set. - project.getName(); - monitor.worked(1); - if (includeErrorNodes || !(project.isErrorNode())) { - Display.getDefault().asyncExec(new Runnable() { - public void run() { - view.addProject(project); - } - }); - } - } - } - /** - * Returns whether or not the given build file already - * exists in the ant view. - */ - private boolean alreadyAdded(String buildFileName) { - for (int j = 0; j < existingProjects.length; j++) { - ProjectNode existingProject = existingProjects[j]; - if (existingProject.getBuildFileName().equals(buildFileName)) { - return true; - } - } - return false; - } - }); - } catch (InvocationTargetException e) { - } catch (InterruptedException e) { - } - } - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/SearchForBuildFilesDialog.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/SearchForBuildFilesDialog.java deleted file mode 100644 index a3e6080a1..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/actions/SearchForBuildFilesDialog.java +++ /dev/null @@ -1,410 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.actions; - - -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; - -import org.eclipse.core.resources.IFile; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.resources.IResourceProxy; -import org.eclipse.core.resources.IResourceProxyVisitor; -import org.eclipse.core.resources.ResourcesPlugin; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IAdaptable; -import org.eclipse.jface.dialogs.Dialog; -import org.eclipse.jface.dialogs.IDialogSettings; -import org.eclipse.jface.dialogs.IInputValidator; -import org.eclipse.jface.dialogs.InputDialog; -import org.eclipse.swt.SWT; -import org.eclipse.swt.events.SelectionAdapter; -import org.eclipse.swt.events.SelectionEvent; -import org.eclipse.swt.graphics.Font; -import org.eclipse.swt.layout.GridData; -import org.eclipse.swt.layout.GridLayout; -import org.eclipse.swt.widgets.Button; -import org.eclipse.swt.widgets.Composite; -import org.eclipse.swt.widgets.Control; -import org.eclipse.swt.widgets.Display; -import org.eclipse.swt.widgets.Group; -import org.eclipse.swt.widgets.Shell; -import org.eclipse.swt.widgets.Text; -import org.eclipse.ui.IWorkingSet; -import org.eclipse.ui.PlatformUI; -import org.eclipse.ui.dialogs.IWorkingSetSelectionDialog; -import org.eclipse.ui.externaltools.internal.model.ExternalToolsPlugin; -import org.eclipse.ui.externaltools.internal.model.IExternalToolsHelpContextIds; -import org.eclipse.ui.externaltools.internal.model.IPreferenceConstants; -import org.eclipse.ui.externaltools.internal.model.StringMatcher; -import org.eclipse.ui.help.WorkbenchHelp; - -/** - * This dialog allows the user to search for Ant build files whose names match a - * given pattern. The search may be performed on the entire workspace or it can - * be limited to a particular working set. - */ -public class SearchForBuildFilesDialog extends InputDialog { - - /** - * List of <code>IFile</code> objects that were found - */ - private List results = new ArrayList(); - /** - * List of <code>IResource</code> objects in which to search. - * - * If the searchScopes are <code>null</code>, the user has asked to search - * the workspace. If the searchScopes are empty, the user has asked to - * search a working set that has no resources. - */ - private List searchScopes = null; - /** - * The working set scope radio button. - */ - private Button workingSetScopeButton; - /** - * The workspace scope radio button. - */ - private Button workspaceScopeButton; - /** - * The text field that displays the current working set name - */ - private Text workingSetText; - /** - * The button that allows the user to decide if error results should be - * parsed - */ - private Button includeErrorResultButton; - /** - * The dialog settings used to persist this dialog's settings. - */ - private static IDialogSettings settings= ExternalToolsPlugin.getDefault().getDialogSettings(); - - /** - * Initialize any dialog settings that haven't been set. - */ - static { - if (settings.get(IPreferenceConstants.ANTVIEW_LAST_SEARCH_STRING) == null) { - settings.put(IPreferenceConstants.ANTVIEW_LAST_SEARCH_STRING, "build.xml"); //$NON-NLS-1$ - } - if (settings.get(IPreferenceConstants.ANTVIEW_LAST_WORKINGSET_SEARCH_SCOPE) == null) { - settings.put(IPreferenceConstants.ANTVIEW_LAST_WORKINGSET_SEARCH_SCOPE, ""); //$NON-NLS-1$ - } - } - - /** - * Creates a new dialog to search for build files. - */ - public SearchForBuildFilesDialog() { - super(Display.getCurrent().getActiveShell(), AntViewActionMessages.getString("SearchForBuildFilesDialog.Search_for_Build_Files_1"), AntViewActionMessages.getString("SearchForBuildFilesDialog.&Input"), //$NON-NLS-1$ //$NON-NLS-2$ - settings.get(IPreferenceConstants.ANTVIEW_LAST_SEARCH_STRING), new IInputValidator() { - public String isValid(String newText) { - String trimmedText = newText.trim(); - if (trimmedText.length() == 0) { - return AntViewActionMessages.getString("SearchForBuildFilesDialog.Build_name_cannot_be_empty_3"); //$NON-NLS-1$ - } - return null; - } - }); - } - - /** - * Change the label on the "Ok" button and initialize the enabled state - */ - protected void createButtonsForButtonBar(Composite parent) { - super.createButtonsForButtonBar(parent); - getOkButton().setText(AntViewActionMessages.getString("SearchForBuildFilesDialog.&Search_4")); //$NON-NLS-1$ - - String workingSetName= settings.get(IPreferenceConstants.ANTVIEW_LAST_WORKINGSET_SEARCH_SCOPE); - if (workingSetName.length() > 0) { - setWorkingSet(PlatformUI.getWorkbench().getWorkingSetManager().getWorkingSet(workingSetName)); - } - if (!settings.getBoolean(IPreferenceConstants.ANTVIEW_USE_WORKINGSET_SEARCH_SCOPE)) { - selectRadioButton(workspaceScopeButton); - handleRadioButtonPressed(); - } - } - - /** - * Add the scope selection widgets to the dialog area - */ - protected Control createDialogArea(Composite parent) { - Font font = parent.getFont(); - - Composite composite = (Composite) super.createDialogArea(parent); - createIncludeErrorResultButton(composite, font); - createScopeGroup(composite, font); - return composite; - } - - private void createScopeGroup(Composite composite, Font font) { - Group scope= new Group(composite, SWT.NONE); - scope.setText(AntViewActionMessages.getString("SearchForBuildFilesDialog.Scope_5")); //$NON-NLS-1$ - GridData data= new GridData(GridData.FILL_BOTH); - scope.setLayoutData(data); - GridLayout layout= new GridLayout(3, false); - scope.setLayout(layout); - scope.setFont(font); - - // Create a composite for the radio buttons - Composite radioComposite= new Composite(scope, SWT.NONE); - GridLayout radioLayout= new GridLayout(); - radioLayout.marginHeight= 0; - radioComposite.setLayout(radioLayout); - - SelectionAdapter selectionListener= new SelectionAdapter() { - public void widgetSelected(SelectionEvent e) { - handleRadioButtonPressed(); - } - }; - - workspaceScopeButton= new Button(radioComposite, SWT.RADIO); - workspaceScopeButton.setFont(font); - workspaceScopeButton.setText(AntViewActionMessages.getString("SearchForBuildFilesDialog.&Workspace_6")); //$NON-NLS-1$ - workspaceScopeButton.addSelectionListener(selectionListener); - - workingSetScopeButton=new Button(radioComposite, SWT.RADIO); - workingSetScopeButton.setFont(font); - workingSetScopeButton.setText(AntViewActionMessages.getString("SearchForBuildFilesDialog.Wor&king_Set__7")); //$NON-NLS-1$ - workingSetScopeButton.addSelectionListener(selectionListener); - - selectRadioButton(workspaceScopeButton); - - workingSetText= new Text(scope, SWT.BORDER); - workingSetText.setEditable(false); - data= new GridData(GridData.FILL_HORIZONTAL | GridData.VERTICAL_ALIGN_END); - workingSetText.setLayoutData(data); - workingSetText.setFont(font); - - Button chooseButton = new Button(scope, SWT.PUSH); - data= new GridData(GridData.VERTICAL_ALIGN_END); - chooseButton.setLayoutData(data); - chooseButton.setFont(font); - chooseButton.setText(AntViewActionMessages.getString("SearchForBuildFilesDialog.&Choose..._8")); //$NON-NLS-1$ - chooseButton.addSelectionListener(new SelectionAdapter() { - public void widgetSelected(SelectionEvent evt) { - handleChooseButtonPressed(); - } - }); - } - - /** - * Programatically selects the given radio button, deselecting the other - * radio button. - * - * @param button the radio button to select. This parameter must be one of - * either the <code>workingSetScopeButton</code> or the - * <code>workspaceScopeButton</code> or this method will have no effect. - */ - private void selectRadioButton(Button button) { - if (button == workingSetScopeButton) { - workingSetScopeButton.setSelection(true); - workspaceScopeButton.setSelection(false); - } else if (button == workspaceScopeButton) { - workspaceScopeButton.setSelection(true); - workingSetScopeButton.setSelection(false); - } - } - - /** - * One of the search scope radio buttons has been pressed. Update the dialog - * accordingly. - */ - private void handleRadioButtonPressed() { - if (workingSetScopeButton.getSelection()) { - IWorkingSet set= PlatformUI.getWorkbench().getWorkingSetManager().getWorkingSet(getWorkingSetName()); - if (set != null) { - setWorkingSet(set); - return; - } - } - setWorkingSet(null); - } - - /** - * Returns the working set name currently displayed. - */ - private String getWorkingSetName() { - return workingSetText.getText().trim(); - } - - /** - * Creates the button that allows the user to specify whether or not build - * files should that cannot be parsed should be included in the results. - */ - private void createIncludeErrorResultButton(Composite composite, Font font) { - includeErrorResultButton= new Button(composite, SWT.CHECK); - includeErrorResultButton.setFont(font); - includeErrorResultButton.setText(AntViewActionMessages.getString("SearchForBuildFilesDialog.Include_errors")); //$NON-NLS-1$ - includeErrorResultButton.setSelection(settings.getBoolean(IPreferenceConstants.ANTVIEW_INCLUDE_ERROR_SEARCH_RESULTS)); - } - - /** - * Updates the enablement of the "Search" button based on the validity of - * the user's selections. - */ - private void updateOkEnabled() { - if (workingSetScopeButton.getSelection()) { - String error= null; - if (searchScopes == null) { - error= AntViewActionMessages.getString("SearchForBuildFilesDialog.Must_select_a_working_set_10"); //$NON-NLS-1$ - } else if (searchScopes.isEmpty()) { - error= AntViewActionMessages.getString("SearchForBuildFilesDialog.No_searchable"); //$NON-NLS-1$ - } - if (error != null) { - getErrorMessageLabel().setText(error); - getErrorMessageLabel().getParent().update(); - getOkButton().setEnabled(false); - return; - } - } - getOkButton().setEnabled(true); - getErrorMessageLabel().setText(""); //$NON-NLS-1$ - getErrorMessageLabel().getParent().update(); - } - - /** - * Handles the working set choose button pressed. Returns the name of the - * chosen working set or <code>null</code> if none. - */ - private void handleChooseButtonPressed() { - IWorkingSetSelectionDialog dialog= PlatformUI.getWorkbench().getWorkingSetManager().createWorkingSetSelectionDialog(getShell(), false); - if (dialog.open() == Dialog.CANCEL) { - return; - } - IWorkingSet[] sets= dialog.getSelection(); - if (sets == null) { - return; - } - if (sets.length == 0) { - setWorkingSet(null); //ok pressed with no working set selected - } else { - setWorkingSet(sets[0]); // We disallowed multi-select - } - } - - /** - * Sets the current working set search scope. This populates the search - * scope with resources found in the given working set and updates the - * enabled state of the dialog based on the sets contents. - * - * @param set the working set scope for the search - */ - private void setWorkingSet(IWorkingSet set) { - if (set == null) { - searchScopes= null; - workingSetText.setText(""); //$NON-NLS-1$ - updateOkEnabled(); - return; - } - IAdaptable[] elements= set.getElements(); - searchScopes= new ArrayList(); - for (int i = 0; i < elements.length; i++) { - // Try to get an IResource object from each element - IResource resource= null; - IAdaptable adaptable = elements[i]; - if (adaptable instanceof IResource) { - resource= (IResource) adaptable; - } else { - resource= (IResource) adaptable.getAdapter(IResource.class); - } - if (resource != null) { - searchScopes.add(resource); - } - } - workingSetText.setText(set.getName()); - selectRadioButton(workingSetScopeButton); - - updateOkEnabled(); - } - - /** - * Returns the trimmed user input - */ - private String getInput() { - return getText().getText().trim(); - } - - /** - * Returns the search results - */ - public IFile[] getResults() { - return (IFile[]) results.toArray(new IFile[results.size()]); - } - - /** - * Returns whether the user wishes to include results which cannot be - * parsed. - */ - protected boolean getIncludeErrorResults() { - return settings.getBoolean(IPreferenceConstants.ANTVIEW_INCLUDE_ERROR_SEARCH_RESULTS); - } - - /** - * When the user presses the search button (tied to the OK id), search the - * workspace for files matching the regular expression in the input field. - */ - protected void okPressed() { - String input = getInput(); - settings.put(IPreferenceConstants.ANTVIEW_LAST_SEARCH_STRING, input); - settings.put(IPreferenceConstants.ANTVIEW_INCLUDE_ERROR_SEARCH_RESULTS, includeErrorResultButton.getSelection()); - settings.put(IPreferenceConstants.ANTVIEW_LAST_WORKINGSET_SEARCH_SCOPE, getWorkingSetName()); - settings.put(IPreferenceConstants.ANTVIEW_USE_WORKINGSET_SEARCH_SCOPE, workingSetScopeButton.getSelection()); - results = new ArrayList(); // Clear previous results - ResourceProxyVisitor visitor= new ResourceProxyVisitor(); - if (searchScopes == null || searchScopes.isEmpty()) { - try { - ResourcesPlugin.getWorkspace().getRoot().accept(visitor, IResource.NONE); - } catch (CoreException ce) { - //Closed project...don't want build files from there - } - } else { - Iterator iter= searchScopes.iterator(); - while(iter.hasNext()) { - try { - ((IResource) iter.next()).accept(visitor, IResource.NONE); - } catch (CoreException ce) { - //Closed project...don't want build files from there - } - } - } - super.okPressed(); - } - - /** - * Searches for files whose name matches the given regular expression. - */ - class ResourceProxyVisitor implements IResourceProxyVisitor { - StringMatcher matcher= new StringMatcher(getInput(), true, false); - - /** - * @see org.eclipse.core.resources.IResourceProxyVisitor#visit(org.eclipse.core.resources.IResourceProxy) - */ - public boolean visit(IResourceProxy proxy) throws CoreException { - if (proxy.getType() == IResource.FILE) { - if (matcher.match(proxy.getName())) { - results.add(proxy.requestResource()); - } - return false; - } - return true; - } - } - /* (non-Javadoc) - * @see org.eclipse.jface.window.Window#configureShell(org.eclipse.swt.widgets.Shell) - */ - protected void configureShell(Shell shell) { - super.configureShell(shell); - WorkbenchHelp.setHelp(shell, IExternalToolsHelpContextIds.SEARCH_FOR_BUILDFILES_DIALOG); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntNode.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntNode.java deleted file mode 100644 index e2c809d8a..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntNode.java +++ /dev/null @@ -1,112 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.elements; - - -public abstract class AntNode { - - private AntNode parent= null; - private String name= null; - private String description= null; - - /** - * Creates a new node with no parent - */ - private AntNode() { - } - - /** - * Creates a new node with the given name - * - * @param name the new node's name - */ - public AntNode(String name) { - this(null, name); - } - - /** - * Creates a new node with the given parent and the given name - * - * @param parent the new node's parent node - * @param name the new node's name - */ - public AntNode(AntNode parent, String name) { - this.parent= parent; - this.name= name; - } - - /** - * Returns this node's parent or <code>null</code> if none. - * - * @return AntNode this node's parent node - */ - public AntNode getParent() { - return parent; - } - - /** - * Sets this node's parent node to the given node - * - * @param parent the parent node - */ - public void setParent(AntNode parent) { - this.parent= parent; - } - - /** - * Returns this node's name or <code>null</code> if none. Subclasses which - * represent an ant build element that has a required name must override - * this method to never return <code>null</code> - * - * @return String this node's name or <code>null</code> if the name - * attribute is optional for this node. - */ - public String getName() { - return name; - } - - /** - * Sets this node's name to the given name - * - * @param name the new name - */ - public void setName(String name) { - this.name= name; - } - - public String toString() { - if (getName() != null) { - return getName(); - } - return super.toString(); - } - - /** - * Sets this node's description to the given description - * - * @param description the new description - */ - public void setDescription(String description) { - this.description= description; - } - - /** - * Returns this node's description or <code>null</code> if none. Subclasses - * which represent an ant build element that has a required description must - * override this method to never return <code>null</code> - * - * @return String this node's description or <code>null</code> if the - * description attribute is optional for this node. - */ - public String getDescription() { - return description; - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntViewElementsMessages.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntViewElementsMessages.java deleted file mode 100644 index dbfd70a1a..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntViewElementsMessages.java +++ /dev/null @@ -1,34 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.elements; - - -import java.util.MissingResourceException; -import java.util.ResourceBundle; - -public class AntViewElementsMessages { - - private static final String BUNDLE_NAME = "org.eclipse.ui.externaltools.internal.ant.view.elements.AntViewElementsMessages"; //$NON-NLS-1$ - - private static final ResourceBundle RESOURCE_BUNDLE = - ResourceBundle.getBundle(BUNDLE_NAME); - - private AntViewElementsMessages() { - } - - public static String getString(String key) { - try { - return RESOURCE_BUNDLE.getString(key); - } catch (MissingResourceException e) { - return '!' + key + '!'; - } - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntViewElementsMessages.properties b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntViewElementsMessages.properties deleted file mode 100644 index fedbf8999..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/AntViewElementsMessages.properties +++ /dev/null @@ -1,15 +0,0 @@ -############################################################################### -# Copyright (c) 2000, 2003 IBM Corporation and others. -# All rights reserved. This program and the accompanying materials -# are made available under the terms of the Common Public License v1.0 -# which accompanies this distribution, and is available at -# http://www.eclipse.org/legal/cpl-v10.html -# -# Contributors: -# IBM Corporation - initial API and implementation -############################################################################### - -ProjectNode.No_targets=No targets found -ProjectNode.No_default=No default target found -ProjectNode.<name_unspecified>_1=<name unspecified> -ProjectNode.Build_file_not_found_1=Buildfile not found diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/ProjectNode.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/ProjectNode.java deleted file mode 100644 index 20166ad48..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/ProjectNode.java +++ /dev/null @@ -1,303 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.elements; - -import java.util.ArrayList; -import java.util.Collections; -import java.util.Comparator; -import java.util.Enumeration; -import java.util.List; - -import org.apache.tools.ant.Project; -import org.apache.tools.ant.Target; -import org.eclipse.ant.core.ProjectInfo; -import org.eclipse.ant.core.TargetInfo; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IPath; -import org.eclipse.ui.externaltools.internal.ant.model.AntUtil; - -/** - * Representation of an ant build project. - */ -public class ProjectNode extends AntNode { - - private List targets= null; - private TargetNode defaultTarget= null; - private String buildFileName; - private boolean isErrorNode= false; - - private String defaultTargetName; - /** - * Creates a new project node with the given name and the given build file - * name. - * - * @param name the project's name or <code>null</code> if the project's - * name is not known. If this value is <code>null</code>, the file will be - * parsed the first time a value is requested that requires it. - * @param buildFileName - */ - public ProjectNode(String name, String buildFileName) { - super(name); - this.buildFileName= buildFileName; - } - - /** - * Creates a new project node on the given build file. - */ - public ProjectNode(String buildFileName) { - this(null, buildFileName); - } - - /** - * Returns the targets in this project - * - * @return TargetNode[] the targets in this project - */ - public TargetNode[] getTargets() { - if (targets == null) { - // Lazily parse the file to populate the targets - parseBuildFile(); - } - return (TargetNode[])targets.toArray(new TargetNode[targets.size()]); - } - - /** - * Adds the given target to this project - * - * @param target the target to add - */ - private void addTarget(TargetNode target) { - targets.add(target); - target.setParent(this); - } - - /** - * Sets this project's default target to the given target - * - * @param target this project's default target - */ - public void setDefaultTarget(TargetNode target) { - defaultTarget= target; - if (target != null) { - defaultTargetName= target.getName(); - } - } - - /** - * Returns the name of the build file containing this project - * - * @return String the name of this project's build file - */ - public String getBuildFileName() { - return buildFileName; - } - - /** - * Returns the default target in this project or <code>null</code> if none - * has been set - * - * @return TargetNode the default target or <code>null</code> if none has - * been set - */ - public TargetNode getDefaultTarget() { - if (targets == null) { - // Lazily parse the file to populate the targets - parseBuildFile(); - } - return defaultTarget; - } - - /** - * Returns the default target name. If this project has not been parsed yet, this - * method will return the default target name specified via setDefaultTargetName(String) - * or <code>null</code> if no default target name has been specified. - * - * This method is intended to be used by clients who want to access the name of this - * project's default target without forcing the build file to be parsed. - * - * @return String the name of the default target in this project. - */ - public String getDefaultTargetName() { - return defaultTargetName; - } - - /** - * Sets the name of this project node's default target. - * - * @param name the name of this project node's default target - * @see ProjectNode#getDefaultTargetName() - */ - public void setDefaultTargetName(String name) { - defaultTargetName= name; - } - - /** - * Sets this project's error node state - * - * @param boolean whether or not an error occurred while parsing this node - */ - public void setIsErrorNode(boolean isErrorNode) { - this.isErrorNode= isErrorNode; - } - - /** - * Returns whether an error occurred while parsing this Ant node - * - * @return whether an error occurred while parsing this Ant node - */ - public boolean isErrorNode() { - return isErrorNode; - } - - /** - * Parses the given build file and populates the targets contained in the - * build file. If an error occurs while parsing the file, the error - * state will be set and a target error node will be added - */ - public void parseBuildFile() { - clear(); - TargetInfo[] infos = null; - IPath buildFilePath= AntUtil.getFile(getBuildFileName()).getLocation(); - if (buildFilePath == null) { - setErrorMessage(AntViewElementsMessages.getString("ProjectNode.Build_file_not_found_1")); //$NON-NLS-1$ - return; - } - try { - infos = AntUtil.getTargets(buildFilePath.toString()); - } catch (CoreException e) { - setErrorMessage(e.getMessage()); - return; - } - if (infos.length < 1) { - setErrorMessage(AntViewElementsMessages.getString("ProjectNode.No_targets")); //$NON-NLS-1$ - return; - } - ProjectInfo projectInfo= infos[0].getProject(); - // Create Apache Ant objects - Project project = new Project(); - if (projectInfo.getName() != null) { - project.setName(projectInfo.getName()); - } - - for (int i = 0; i < infos.length; i++) { - TargetInfo info = infos[i]; - if (info.isDefault()) { - project.setDefault(info.getName()); - } - Target target = new Target(); - target.setName(info.getName()); - String[] dependencies = info.getDependencies(); - StringBuffer depends = new StringBuffer(); - int numDependencies = dependencies.length; - if (numDependencies > 0) { - // Onroll the loop to avoid trailing comma - depends.append(dependencies[0]); - } - for (int j = 1; j < numDependencies; j++) { - depends.append(',').append(dependencies[j]); - } - target.setDepends(depends.toString()); - target.setDescription(info.getDescription()); - project.addTarget(target); - } - if (project.getDefaultTarget() == null) { - setErrorMessage(AntViewElementsMessages.getString("ProjectNode.No_default")); //$NON-NLS-1$ - return; - } - // Set the project node data based on the Apache Ant data - String projectName = project.getName(); - if (projectName == null) { - projectName = AntViewElementsMessages.getString("ProjectNode.<name_unspecified>_1"); //$NON-NLS-1$ - } - // Update the project name - setName(projectName); - setDescription(projectInfo.getDescription()); - Enumeration projTargets = project.getTargets().elements(); - while (projTargets.hasMoreElements()) { - Target target = (Target) projTargets.nextElement(); - // Target Node ----------------- - Enumeration targetDependencies = target.getDependencies(); - TargetNode targetNode = new TargetNode(target.getName(), target.getDescription()); - while (targetDependencies.hasMoreElements()) { - targetNode.addDependency((String) targetDependencies.nextElement()); - } - addTarget(targetNode); - if (target.getName().equals(project.getDefaultTarget())) { - setDefaultTarget(targetNode); - } - } - Collections.sort(targets, new Comparator() { - /** - * @see java.util.Comparator#compare(java.lang.Object, java.lang.Object) - */ - public int compare(Object o1, Object o2) { - String name1=""; //$NON-NLS-1$ - String name2= ""; //$NON-NLS-1$ - if (o1 instanceof TargetNode) { - name1= ((TargetNode)o1).getName(); - } - if (o2 instanceof TargetNode) { - name2= ((TargetNode)o2).getName(); - } - return name1.compareToIgnoreCase(name2); - } - }); - } - - /** - * Clear's this node's internally stored data - */ - private void clear() { - targets= new ArrayList(); - setIsErrorNode(false); - setDefaultTarget(null); - setDefaultTargetName(null); - } - - /** - * Sets the error message of this project and creates a new target child - * node with the message - * - * @param errorMessage the error message generated while parsing this - * project - */ - private void setErrorMessage(String errorMessage) { - setName(getBuildFileName()); - setIsErrorNode(true); - TargetNode target= new TargetNode(errorMessage, errorMessage); - target.setIsErrorNode(true); - addTarget(target); - } - - /** - * Returns the name of this project, parsing the build file first if - * necessary. - * - * @return String this project's name - */ - public String getName() { - if (super.getName() == null) { - parseBuildFile(); - } - String name= super.getName(); - if (name == null || name.length() == 0) { - name= AntViewElementsMessages.getString("ProjectNode.<name_unspecified>_1"); //$NON-NLS-1$ - } - return name; - } - - /** - * @see java.lang.Object#toString() - */ - public String toString() { - return getName(); - } -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/RootNode.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/RootNode.java deleted file mode 100644 index 827ee6a14..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/RootNode.java +++ /dev/null @@ -1,84 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.elements; - -import java.util.ArrayList; -import java.util.List; - -/** - * The root node of an ant node tree - */ -public class RootNode extends AntNode { - - private List projects= new ArrayList(); - - public RootNode() { - super(null); - } - - /** - * Creates a new root node containing the given projects - * - * @param projects the projects to add to this node - */ - public RootNode(ProjectNode[] projects) { - super(null); - for (int i = 0; i < projects.length; i++) { - this.projects.add(projects[i]); - } - } - - /** - * Returns the list of projects stored in this root node - * - * @return ProjectNode[] the projects in this node - */ - public ProjectNode[] getProjects() { - return (ProjectNode[])projects.toArray(new ProjectNode[projects.size()]); - } - - /** - * Returns whether this root node contains any projects - * - * @return boolean Whether there are any projects - */ - public boolean hasProjects() { - return !projects.isEmpty(); - } - - /** - * Adds the given project to this root node - * - * @param project the project to add - */ - public void addProject(ProjectNode project) { - projects.add(project); - } - - /** - * Removes the given project from this root node. Has no effect if the given - * project is not a child of this root - * - * @param project the project to remove - */ - public void removeProject(ProjectNode project) { - projects.remove(project); - } - - /** - * Removes all projects from this root node. Has no effect if this node has - * no projects. - */ - public void removeAllProjects() { - projects.clear(); - } - -} diff --git a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/TargetNode.java b/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/TargetNode.java deleted file mode 100644 index 47d077eaa..000000000 --- a/org.eclipse.ui.externaltools/Ant Tools Support/org/eclipse/ui/externaltools/internal/ant/view/elements/TargetNode.java +++ /dev/null @@ -1,85 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. - * All rights reserved. This program and the accompanying materials - * are made available under the terms of the Common Public License v1.0 - * which accompanies this distribution, and is available at - * http://www.eclipse.org/legal/cpl-v10.html - * - * Contributors: - * IBM Corporation - initial API and implementation - *******************************************************************************/ -package org.eclipse.ui.externaltools.internal.ant.view.elements; - -import java.util.ArrayList; -import java.util.List; - - -/** - * Representation of an ant target - */ -public class TargetNode extends AntNode { - private List dependencies= new ArrayList(); - private boolean isErrorNode= false; - - /** - * Creates a new target node with the given parent node, name, and target - * dependencies - * - * @param parent the new node's parent - * @param name the new node's name - * @param description the target description or <code>null</code> if the - * target has no description - */ - public TargetNode(String name, String description) { - super(name); - setDescription(description); - } - - /** - * Adds the given dependency to the list of this target's dependencies - * - * @param dependency the dependency to add - */ - public void addDependency(String dependency) { - dependencies.add(dependency); - } - - /** - * Returns the dependency node containing the names of the targets on which - * this target depends - * - * @return DependencyNode the node containing the names of this target's - * dependencies - */ - public String[] getDependencies() { - return (String[]) dependencies.toArray(new String[dependencies.size()]); - } - - /** - * Returns the ProjectNode containing this target. This method is equivalent - * to calling getParent() and casting the result to a ProjectNode. - * - * @return ProjectNode the project containing this target - */ - public ProjectNode getProject() { - return (ProjectNode) getParent(); - } - - /** - * Sets this target's error node state - * - * @param boolean whether or not an error occurred while parsing this node - */ - public void setIsErrorNode(boolean isErrorNode) { - this.isErrorNode= isErrorNode; - } - - /** - * Returns whether an error occurred while parsing this Ant node - * - * @return whether an error occurred while parsing this Ant node - */ - public boolean isErrorNode() { - return isErrorNode; - } -} diff --git a/org.eclipse.ui.externaltools/build.properties b/org.eclipse.ui.externaltools/build.properties index a8345cf0c..6bd0c1eb9 100644 --- a/org.eclipse.ui.externaltools/build.properties +++ b/org.eclipse.ui.externaltools/build.properties @@ -9,11 +9,7 @@ # IBM Corporation - initial API and implementation ############################################################################### source.externaltools.jar = External Tools Base/,\ - Program Tools Support/,\ - Ant Tools Support/,\ - Ant Editor/ - -source.lib/antrunner.jar = Ant Runner Support/ + Program Tools Support/ src.includes=about.html @@ -23,7 +19,6 @@ bin.includes = icons/,\ plugin.xml,\ about.html,\ *.jar,\ - lib/*.jar -jars.compile.order=externaltools.jar,lib/antrunner.jar +jars.compile.order=externaltools.jar jars.extra.classpath=../org.apache.ant/ant.jar diff --git a/org.eclipse.ui.externaltools/scripts/buildSelfHostingJARs.xml b/org.eclipse.ui.externaltools/buildfiles/buildSelfHostingJARs.xml index 4057dc544..4057dc544 100644 --- a/org.eclipse.ui.externaltools/scripts/buildSelfHostingJARs.xml +++ b/org.eclipse.ui.externaltools/buildfiles/buildSelfHostingJARs.xml diff --git a/org.eclipse.ui.externaltools/scripts/exportplugin.xml b/org.eclipse.ui.externaltools/buildfiles/exportplugin.xml index 948fc9a66..948fc9a66 100644 --- a/org.eclipse.ui.externaltools/scripts/exportplugin.xml +++ b/org.eclipse.ui.externaltools/buildfiles/exportplugin.xml diff --git a/org.eclipse.ui.externaltools/scripts/updateTarget.xml b/org.eclipse.ui.externaltools/buildfiles/updateTarget.xml index 22c0307b6..22c0307b6 100644 --- a/org.eclipse.ui.externaltools/scripts/updateTarget.xml +++ b/org.eclipse.ui.externaltools/buildfiles/updateTarget.xml diff --git a/org.eclipse.ui.externaltools/scripts/updateTargets.xml b/org.eclipse.ui.externaltools/buildfiles/updateTargets.xml index 23289c85a..23289c85a 100644 --- a/org.eclipse.ui.externaltools/scripts/updateTargets.xml +++ b/org.eclipse.ui.externaltools/buildfiles/updateTargets.xml diff --git a/org.eclipse.ui.externaltools/icons/full/ovr16/error_co.gif b/org.eclipse.ui.externaltools/icons/full/ovr16/error_co.gif Binary files differdeleted file mode 100644 index 8612eaff5..000000000 --- a/org.eclipse.ui.externaltools/icons/full/ovr16/error_co.gif +++ /dev/null diff --git a/org.eclipse.ui.externaltools/lib/antrunner.jar b/org.eclipse.ui.externaltools/lib/antrunner.jar Binary files differdeleted file mode 100644 index 78e7a5f86..000000000 --- a/org.eclipse.ui.externaltools/lib/antrunner.jar +++ /dev/null diff --git a/org.eclipse.ui.externaltools/plugin.properties b/org.eclipse.ui.externaltools/plugin.properties index c31299c0b..ba9b7298b 100644 --- a/org.eclipse.ui.externaltools/plugin.properties +++ b/org.eclipse.ui.externaltools/plugin.properties @@ -11,7 +11,7 @@ Plugin.name = External Tools Plugin.providerName = Eclipse.org -AntLaunchShortcut.label = &Ant Build + ExtPoint.configurationDuplicationMaps = Launch Configuration Duplication Maps ExtPoint.toolTypes = External Tool Types ExtPoint.toolVariables = External Tool Variables @@ -30,20 +30,11 @@ PropertyPage.option = Options PropertyPage.refresh = Refresh Scope PropertyPage.antTargets = Targets PropertyPage.externalToolsBuilders = External Tools Builders -CategoryView.antViews = Ant Builder.externalTools = Integrated External Tool Builder View.externalToolView = External Tools -View.logConsole = Log Console -View.antView = Ant PreferencePage.externalToolsPreferences = External Tools -PreferencePage.antPreferences = Ant -PreferencePage.antRuntimePreferences = Runtime -PreferencePage.antEditorPreferences = Editor -PopupMenu.runAnt = Run &Ant... -PopupMenu.runAntTip = Run Ant With The Selected File -AntBuild.externalTools = Ant Build Program.externalTools = Program #tool variables @@ -70,12 +61,4 @@ resource.description= Expands to a resource. working_set.description= Expands to the group of resources in a working set. ActionDefinition.externalToolMenuDelegateToolbar.name=Run Last Launched External Tool -ActionDefinition.externalToolMenuDelegateToolbar.description=Runs the last launched external Tool -ActionDefinition.antContentAssistProposals.name=Ant Content Assist -ActionDefinition.antContentAssistProposals.description=Content Assist in the Ant Editor - -AntEditor.name=Ant Editor -AddBookmark.label=Add Boo&kmark... -AddBookmark.tooltip=Add Bookmark... -AddTask.label=Add &Task... -AddTask.tooltip=Add Task... +ActionDefinition.externalToolMenuDelegateToolbar.description=Runs the last launched external Tool
\ No newline at end of file diff --git a/org.eclipse.ui.externaltools/plugin.xml b/org.eclipse.ui.externaltools/plugin.xml index e8efd0f55..dbcfb3236 100644 --- a/org.eclipse.ui.externaltools/plugin.xml +++ b/org.eclipse.ui.externaltools/plugin.xml @@ -29,17 +29,6 @@ <extension-point id="refreshVariables" name="%ExtPoint.refreshVariables"/> <!-- Extensions --> - <extension point="org.eclipse.ui.editors"> - <editor - name="%AntEditor.name" - icon="icons/full/obj16/ant_buildfile.gif" - filenames="build.xml" - contributorClass="org.eclipse.ui.externaltools.internal.ant.editor.AntEditorActionContributor" - class="org.eclipse.ui.externaltools.internal.ant.editor.AntEditor" - id="org.eclipse.ui.externaltools.internal.ant.editor.AntEditor"> - </editor> - </extension> - <!-- UI extensions --> <extension point="org.eclipse.ui.actionSets"> <actionSet @@ -91,64 +80,6 @@ /> </extension> - <extension point="org.eclipse.ui.views"> - <category - id="org.eclipse.ui.externaltools.ant.views" - name="%CategoryView.antViews"> - </category> - <view - id="org.eclipse.ui.externaltools.AntView" - name="%View.antView" - icon="icons/full/cview16/ant_view.gif" - category="org.eclipse.ui.externaltools.ant.views" - fastViewWidthRatio="0.40" - class="org.eclipse.ui.externaltools.internal.ant.view.AntView"> - </view> - </extension> - - <extension point="org.eclipse.ui.perspectiveExtensions"> - <perspectiveExtension - targetID="org.eclipse.ui.resourcePerspective"> - <view id="org.eclipse.ui.externaltools.AntView" - relative="org.eclipse.ui.views.ContentOutline" - relationship="stack" - visible="false"/> - <viewShortcut id="org.eclipse.ui.externaltools.AntView"/> - </perspectiveExtension> - <perspectiveExtension - targetID="org.eclipse.jdt.ui.JavaBrowsingPerspective"> - <view id="org.eclipse.ui.externaltools.AntView" - relative="org.eclipse.ui.views.ContentOutline" - relationship="stack" - visible="false"/> - <viewShortcut id="org.eclipse.ui.externaltools.AntView"/> - </perspectiveExtension> - <perspectiveExtension - targetID="org.eclipse.jdt.ui.JavaPerspective"> - <view id="org.eclipse.ui.externaltools.AntView" - relative="org.eclipse.ui.views.ContentOutline" - relationship="stack" - visible="false"/> - <viewShortcut id="org.eclipse.ui.externaltools.AntView"/> - </perspectiveExtension> - <perspectiveExtension - targetID="org.eclipse.jdt.ui.JavaHierarchyPerspective"> - <view id="org.eclipse.ui.externaltools.AntView" - relative="org.eclipse.ui.views.ContentOutline" - relationship="stack" - visible="false"/> - <viewShortcut id="org.eclipse.ui.externaltools.AntView"/> - </perspectiveExtension> - <perspectiveExtension - targetID="org.eclipse.debug.ui.DebugPerspective"> - <view id="org.eclipse.ui.externaltools.AntView" - relative="org.eclipse.ui.views.ContentOutline" - relationship="stack" - visible="false"/> - <viewShortcut id="org.eclipse.ui.externaltools.AntView"/> - </perspectiveExtension> - </extension> - <extension point="org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.externaltools.ExternalToolsPreferencePage" @@ -156,63 +87,6 @@ class="org.eclipse.ui.externaltools.internal.ui.ExternalToolsPreferencePage" category="org.eclipse.ui.preferencePages.Workbench"> </page> - <page - id="org.eclipse.ui.externaltools.AntPreferencePage" - name="%PreferencePage.antPreferences" - class="org.eclipse.ui.externaltools.internal.ant.preferences.AntPreferencePage"> - </page> - <page - id="org.eclipse.ui.externaltools.AntRuntimePreferencePage" - name="%PreferencePage.antRuntimePreferences" - class="org.eclipse.ui.externaltools.internal.ant.preferences.AntRuntimePreferencePage" - category="org.eclipse.ui.externaltools.AntPreferencePage"> - </page> - <page - id="org.eclipse.ui.externaltools.AntEditorPreferencePage" - name="%PreferencePage.antEditorPreferences" - class="org.eclipse.ui.externaltools.internal.ant.preferences.AntEditorPreferencePage" - category="org.eclipse.ui.externaltools.AntPreferencePage"> - </page> - </extension> - - <extension point="org.eclipse.ui.popupMenus"> - <objectContribution - id="org.eclipse.ui.externaltools.RunAnt" - objectClass="org.eclipse.core.resources.IFile" - adaptable="true" - nameFilter="*.xml"> - <action - id="org.eclipse.ui.externaltools.RunAntAction" - label="%PopupMenu.runAnt" - tooltip="%PopupMenu.runAntTip" - menubarPath="additions" - enablesFor="1" - class="org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntRunActionDelegate"> - </action> - </objectContribution> - </extension> - - <extension point="org.eclipse.ui.popupMenus"> - <viewerContribution - targetID="org.eclipse.ui.externaltools.internal.ant.editor.AntEditor.RulerContext" - id="org.eclipse.ui.externaltools.internal.ant.editor.AntEditor.RulerContext"> - <action - label="%AddTask.label" - helpContextId="org.eclipse.ui.AddTask_action_context" - tooltip="%AddTask.tooltip" - class="org.eclipse.ui.texteditor.TaskRulerAction" - menubarPath="additions" - id="org.eclipse.ui.texteditor.TaskRulerAction"> - </action> - <action - label="%AddBookmark.label" - helpContextId="org.eclipse.ui.bookmark_action_context" - tooltip="%AddBookmark.tooltip" - class="org.eclipse.ui.texteditor.BookmarkRulerAction" - menubarPath="additions" - id="org.eclipse.ui.texteditor.BookmarkRulerAction"> - </action> - </viewerContribution> </extension> <extension point="org.eclipse.ui.propertyPages"> @@ -233,30 +107,9 @@ <run class="org.eclipse.ui.externaltools.internal.model.ExternalToolBuilder"/> </builder> </extension> - - <extension point="org.eclipse.ant.core.extraClasspathEntries"> - <extraClasspathEntry - library="lib/antrunner.jar"> - </extraClasspathEntry> - </extension> - - <extension point="org.eclipse.debug.ui.consoleColorProviders"> - <consoleContentProvider - id="org.eclipse.ant.consoleColorProvider" - class="org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntConsoleColorProvider" - processType="org.eclipse.ui.externaltools.ant"> - </consoleContentProvider> - </extension> <!-- Launch Configuration Extensions --> <extension point="org.eclipse.debug.core.launchConfigurationTypes"> - <launchConfigurationType - id = "org.eclipse.ant.AntLaunchConfigurationType" - name = "%AntBuild.externalTools" - delegate = "org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntLaunchDelegate" - modes = "run" - category = "org.eclipse.ui.externaltools"> - </launchConfigurationType> <launchConfigurationType id = "org.eclipse.ui.externaltools.ProgramLaunchConfigurationType" name = "%Program.externalTools" @@ -265,13 +118,6 @@ category = "org.eclipse.ui.externaltools"> </launchConfigurationType> <launchConfigurationType - id = "org.eclipse.ant.AntBuilderLaunchConfigurationType" - name = "%AntBuild.externalTools" - delegate = "org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntLaunchDelegate" - modes = "run" - category = "org.eclipse.ui.externaltools.builder"> - </launchConfigurationType> - <launchConfigurationType id = "org.eclipse.ui.externaltools.ProgramBuilderLaunchConfigurationType" name = "%Program.externalTools" delegate = "org.eclipse.ui.externaltools.internal.program.launchConfigurations.ProgramLaunchDelegate" @@ -282,10 +128,6 @@ <extension point = "org.eclipse.ui.externaltools.configurationDuplicationMaps"> <configurationMap - sourceType="org.eclipse.ant.AntLaunchConfigurationType" - builderType="org.eclipse.ant.AntBuilderLaunchConfigurationType"> - </configurationMap> - <configurationMap sourceType="org.eclipse.ui.externaltools.ProgramLaunchConfigurationType" builderType="org.eclipse.ui.externaltools.ProgramBuilderLaunchConfigurationType"> </configurationMap> @@ -323,22 +165,12 @@ id="org.eclipse.ui.externaltools.launchConfigurationTypeImage.program" configTypeID="org.eclipse.ui.externaltools.ProgramLaunchConfigurationType" icon="icons/full/obj16/external_tools.gif"> - </launchConfigurationTypeImage> - <launchConfigurationTypeImage - id="org.eclipse.ant.launchConfigurationTypeImage.ant" - configTypeID="org.eclipse.ant.AntLaunchConfigurationType" - icon="icons/full/obj16/ant.gif"> </launchConfigurationTypeImage> <launchConfigurationTypeImage id="org.eclipse.ui.externaltools.launchConfigurationTypeImage.program.builder" configTypeID="org.eclipse.ui.externaltools.ProgramBuilderLaunchConfigurationType" icon="icons/full/obj16/external_tools.gif"> </launchConfigurationTypeImage> - <launchConfigurationTypeImage - id="org.eclipse.ant.launchConfigurationTypeImage.ant.builder" - configTypeID="org.eclipse.ant.AntBuilderLaunchConfigurationType" - icon="icons/full/obj16/ant.gif"> - </launchConfigurationTypeImage> </extension> <extension point = "org.eclipse.debug.ui.launchGroups"> @@ -359,33 +191,7 @@ bannerImage = "icons/full/wizban/ext_tools_wiz.gif" public = "false"> </launchGroup> - </extension> - - <extension point = "org.eclipse.debug.ui.launchShortcuts"> - <shortcut - id="org.eclipse.ui.externaltools.antShortcut" - helpContextId="org.eclipse.ui.externaltools.launchShortcutHelpContext.antShortcut" - class="org.eclipse.ui.externaltools.internal.ant.launchConfigurations.AntLaunchShortcut" - label="%AntLaunchShortcut.label" - icon="icons/full/obj16/ant.gif" - modes="run" - category ="org.eclipse.ui.externaltools"> - </shortcut> - </extension> - - <!-- Console Extensions --> - <extension point = "org.eclipse.debug.ui.consoleLineTrackers"> - <consoleLineTracker - id = "org.eclipse.ui.externaltools.ant.javacLineTracker" - class = "org.eclipse.ui.externaltools.internal.ant.launchConfigurations.JavacLineTracker" - processType = "org.eclipse.ui.externaltools.ant"> - </consoleLineTracker> - <consoleLineTracker - id = "org.eclipse.ui.externaltools.ant.taskLineTracker" - class = "org.eclipse.ui.externaltools.internal.ant.console.TaskLineTracker" - processType = "org.eclipse.ui.externaltools.ant"> - </consoleLineTracker> - </extension> + </extension> <!-- Variable Extensions --> <extension point="org.eclipse.ui.externaltools.toolVariables"> @@ -492,14 +298,4 @@ expanderClass="org.eclipse.ui.externaltools.internal.variable.WorkingSetExpander"> </variable> </extension> - - <extension point = "org.eclipse.debug.core.statusHandlers"> - <statusHandler - id="org.eclipse.ui.externaltools.statusHandler.runAntInit" - class="org.eclipse.ui.externaltools.internal.ant.launchConfigurations.RunAntStatusHandler" - plugin ="org.eclipse.ui.externaltools" - code="1000"> - </statusHandler> - </extension> - </plugin> diff --git a/org.eclipse.ui.externaltools/scripts/buildExtraJAR.xml b/org.eclipse.ui.externaltools/scripts/buildExtraJAR.xml deleted file mode 100644 index 9ef72fd8a..000000000 --- a/org.eclipse.ui.externaltools/scripts/buildExtraJAR.xml +++ /dev/null @@ -1,72 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<project name="Build externaltools JAR" default="build" basedir=".."> - - <target name="build" description="Cleans, builds and refreshes"> - <antcall target="clean"/> - <antcall target="lib/antrunnerlib.jar"/> - <antcall target="refresh"/> - </target> - - <target name="init" depends="properties"> - <property name="bootclasspath" value=""/> - <property name="plugin" value="org.eclipse.ui.externaltools"/> - <property name="version.suffix" value="_2.1.0"/> - <property name="full.name" value="${plugin}${version.suffix}"/> - <property name="temp.folder" value="${basedir}/temp.folder"/> - <property name="plugin.destination" value="${basedir}"/> - <property name="build.result.folder" value="${basedir}"/> - <property name="win32.jar" value="${basedir}/../org.eclipse.swt.win32/ws/win32/swt.jar"/> - <property name="gtk.jar" value="${basedir}/../org.eclipse.swt.gtk/ws/gtk/swt.jar"/> - <property name="motif.jar" value="${basedir}/../org.eclipse.swt.motif/ws/motif/swt.jar"/> - <available file="${win32.jar}" property="swt.jar" value="${win32.jar}"/> - <available file="${gtk.jar}" property="swt.jar" value="${gtk.jar}"/> - <available file="${motif.jar}" property="swt.jar" value="${motif.jar}"/> - </target> - - <target name="properties" if="eclipse.running"> - <property name="build.compiler" value="org.eclipse.jdt.core.JDTCompilerAdapter"/> - </target> - - <target name="lib/antrunnerlib.jar" description= "Creates the antrunner.jar" depends="init"> - <property name="destdir" value="${temp.folder}/lib/antrunner.jar.bin"/> - <delete dir="${temp.folder}/lib/antrunner.jar.bin"/> - <mkdir dir="${temp.folder}/lib/antrunner.jar.bin"/> - <!-- compile the source code --> - <javac target="1.3" source="1.3" destdir="${temp.folder}/lib/antrunner.jar.bin" failonerror="true" verbose="false" debug="on" includeJavaRuntime= "yes" includeAntRuntime="no" - bootclasspath="${bootclasspath}" - classpath="${basedir}/../org.eclipse.debug.core/dtcore.jar; - ${basedir}/../org.eclipse.core.runtime/runtime.jar; - ${basedir}/../org.eclipse.core.resources/resources.jar; - ${basedir}/../org.apache.ant/ant.jar; - ${basedir}/bin; - ${swt.jar}; - ${basedir}/../org.eclipse.jface/jface.jar; - ${basedir}/../org.eclipse.text/text.jar; - ${basedir}/../org.eclipse.ant.core/bin; - ${basedir}/../org.eclipse.core.resources/bin; - ${basedir}/../org.eclipse.debug.core/bin; - ${basedir}/../org.eclipse.debug.ui/bin; - ${basedir}/../org.eclipse.jface/bin; - ${basedir}/../org.eclipse.text/bin; - ${basedir}/../org.eclipse.swt/bin;"> - <src path="Ant Runner Support/"/> - </javac> - <!-- copy necessary resources --> - <copy todir="${temp.folder}/lib/antrunner.jar.bin"> - <fileset dir="Ant Runner Support/" excludes="**/*.java"/> - </copy> - <mkdir dir="${build.result.folder}/lib"/> - <jar jarfile="${build.result.folder}/lib/antrunner.jar" basedir="${temp.folder}/lib/antrunner.jar.bin"/> - <delete dir="${temp.folder}"/> - </target> - - <target name="clean" description="Deletes previous build remnants" depends="init"> - <delete file="${build.result.folder}/lib/antrunner.jar"/> - <delete dir="${temp.folder}"/> - </target> - - <target name="refresh" description= "Re-synchs resources" depends="init" if="eclipse.running"> - <eclipse.refreshLocal resource="${plugin}" depth="infinite"/> - </target> - -</project> |
