diff --git a/docs/manual/CoreTasks/echo.html b/docs/manual/CoreTasks/echo.html index f033f4d1e..c2a516a28 100644 --- a/docs/manual/CoreTasks/echo.html +++ b/docs/manual/CoreTasks/echo.html @@ -13,10 +13,10 @@

Echoes a message to the current loggers and listeners which means System.out unless overridden. A level can be specified, which controls at what logging level the message is -filtered at. -

+filtered at. +

The task can also echo to a file, in which case the option to append rather -than overwrite the file is available, and the level option is +than overwrite the file is available, and the level option is ignored

Parameters

@@ -38,19 +38,20 @@ ignored

- + + One of "error", "warning", "info", "verbose", "debug" (decreasing order) - - -
appendAppend to an existing file?Append to an existing file (or + + open a new file / overwrite an existing file)? + No - default is false.
level Control the level at which this message is reported. - One of "error", "warning", "info", "verbose", "debug" No - default is "warning".
+

Examples

 <echo message="Hello, world"/>
@@ -82,7 +83,7 @@ W3C Recommendation 04 February 2004 / End of Line handling
 A message which only appears in -debug mode.
 
<echo level="error">
 Imminent failure in the antimatter containment facility.
-Please withdraw to safe location at least 50km away.  
+Please withdraw to safe location at least 50km away.
 </echo>
 
A message which appears even in -quiet mode. @@ -92,12 +93,68 @@ java-1.3.1 -mx1024m ${project.entrypoint} $$* </echo>
Generate a shell script by echoing to a file. Note the use of a double $ symbol to stop Ant -filtering out the single $ during variable expansion -
+filtering out the single $ during variable expansion + +

Depending on the loglevel Ant runs, messages are print out or silently +ignored: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Ant-Statement-quiet, -qno statement-verbose, -v-debug, -d
<echo message="This is error message." level="error" />
okokokok
<echo message="This is warning message." />
okokokok
<echo message="This is warning message." level="warning" />
okokokok
<echo message="This is info message." level="info" />
not loggedokokok
<echo message="This is verbose message." level="verbose" />
not loggednot loggedokok
<echo message="This is debug message." level="debug" />
not loggednot loggednot loggedok
+ + + +


Copyright © 2000-2002,2004-2005 The Apache Software Foundation. All rights Reserved.

-