From b5de6e5a6a5d41ba7e3d4aae0109c6838a59cbb2 Mon Sep 17 00:00:00 2001 From: Conor MacNeill Date: Sun, 9 Feb 2003 12:17:16 +0000 Subject: [PATCH] Document new input capabilities git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@274024 13f79535-47bb-0310-9956-ffa450edef68 --- WHATSNEW | 10 +++++++ docs/manual/CoreTasks/exec.html | 27 +++++++++++++----- docs/manual/CoreTasks/java.html | 49 +++++++++++++++++++++++++++++++-- 3 files changed, 76 insertions(+), 10 deletions(-) diff --git a/WHATSNEW b/WHATSNEW index 9d504d941..266e2c69b 100644 --- a/WHATSNEW +++ b/WHATSNEW @@ -210,6 +210,16 @@ Other changes: * now has an optional encoding attribute to support replacing in files that are in a different encoding than the platform's default. + +* The task may now have its input redirected from either a file or + a string from the build file. The error output can be separated to a different + file when outut is redirected. standard error may be logged to the Ant log + when redirecting output to a file + +* The task also supports the input redirection and separate error streams + introduced to the task. In addition, it is now possible to save the + output into a property for use within the build file as was possible with + in Ant 1.5 Changes from Ant 1.5.1Beta1 to 1.5.1 ==================================== diff --git a/docs/manual/CoreTasks/exec.html b/docs/manual/CoreTasks/exec.html index dc634acb9..6005b446c 100644 --- a/docs/manual/CoreTasks/exec.html +++ b/docs/manual/CoreTasks/exec.html @@ -53,14 +53,13 @@ Windows executable and is not aware of Cygwin conventions. output - the file to which the output of the command should be - redirected. If the error stream is not also redirected to a file - or poerperty, it will appear in the output + Name of a file to which to write the output. If the error stream + is not also redirected to a file or property, it will appear in this output. No error - the file to which the standard error of the command should be + The file to which the standard error of the command should be redirected. No @@ -75,23 +74,37 @@ Windows executable and is not aware of Cygwin conventions. append - whether output and error files should be appended to or overwritten. + Whether output and error files should be appended to or overwritten. Defaults to false. No outputproperty - the name of a property in which the output of the + The name of a property in which the output of the command should be stored. Unless the error stream is redirected to a separate file or stream, this property will include the error output. No errorproperty - the name of a property in which the standard error of the + The name of a property in which the standard error of the command should be stored. No + + input + A file from which the executed command's standard input + is taken. This attribute is mutually exclusive with the + inputstring attribute + No + + + inputstring + A string which serves as the input stream for the + executed command. This attribute is mutually exclusive with the + inputstring attribute. + No + resultproperty the name of a property in which the return code of the diff --git a/docs/manual/CoreTasks/java.html b/docs/manual/CoreTasks/java.html index e35c6fb16..e076f2c33 100644 --- a/docs/manual/CoreTasks/java.html +++ b/docs/manual/CoreTasks/java.html @@ -91,13 +91,56 @@ JVM. output - Name of a file to write the output to. + Name of a file to which to write the output. If the error stream + is not also redirected to a file or property, it will appear in this output. + No + + + error + The file to which the standard error of the command should be + redirected. + No + + + logError + This attribute is used when you wish to see error output in Ant's + log and you are redirecting output to a file/property. The error + output will not be included in the output file/property. If you + redirect error with the "error" or "errorProperty" + attributes, this will have no effect. No append - whether output should be appended to or overwrite - an existing file. Defaults to false. + Whether output and error files should be appended to or overwritten. + Defaults to false. + No + + + outputproperty + The name of a property in which the output of the + command should be stored. Unless the error stream is redirected to a separate + file or stream, this property will include the error output. + No + + + errorproperty + The name of a property in which the standard error of the + command should be stored. + No + + + input + A file from which the executed command's standard input + is taken. This attribute is mutually exclusive with the + inputstring attribute + No + + + inputstring + A string which serves as the input stream for the + executed command. This attribute is mutually exclusive with the + inputstring attribute. No