diff --git a/docs/manual/CoreTasks/echo.html b/docs/manual/CoreTasks/echo.html index 570b780e3..8b4c902e2 100644 --- a/docs/manual/CoreTasks/echo.html +++ b/docs/manual/CoreTasks/echo.html @@ -9,7 +9,14 @@

Echo

Description

-

Echoes a message to System.out or a file.

+

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. +

+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 +ignored

Parameters

@@ -44,16 +51,36 @@

Examples

-
  <echo message="Hello world"/>
+
  <echo message="Hello, world"/>
+
  
+<echo>This is a longer message stretching over
+two lines.
+</echo>
+
  
 <echo>
 This is a longer message stretching over
-two lines.
+three lines; the first line is a blank
+</echo>
+
+As XML parsers are wont to do, the first newline in the text element +has been included in the text. + +
<echo message="Deleting drive C:" level="debug" />
+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.  
 </echo>
 
-
<echo message="Deleting drive C:" 
-  level="debug" />
+A message which appears even in -quiet mode. +
<echo file="runner.csh" append="false" >#\!/bin/tcsh
+java-1.3.1 -mx1024m ${project.entrypoint} $$*
+
+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

Copyright © 2000,2001 Apache Software Foundation. All rights