Return-Path: Delivered-To: apmail-jakarta-ant-dev-archive@apache.org Received: (qmail 54365 invoked from network); 21 Nov 2001 06:24:43 -0000 Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131) by daedalus.apache.org with SMTP; 21 Nov 2001 06:24:43 -0000 Received: (qmail 24243 invoked by uid 97); 21 Nov 2001 06:24:50 -0000 Delivered-To: qmlist-jakarta-archive-ant-dev@jakarta.apache.org Received: (qmail 24194 invoked by uid 97); 21 Nov 2001 06:24:49 -0000 Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list ant-dev@jakarta.apache.org Received: (qmail 24183 invoked by uid 97); 21 Nov 2001 06:24:48 -0000 Date: 21 Nov 2001 06:09:41 -0000 Message-ID: <20011121060941.37388.qmail@icarus.apache.org> From: stevel@apache.org To: jakarta-ant-cvs@apache.org Subject: cvs commit: jakarta-ant/docs/manual/CoreTasks echo.html X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N stevel 01/11/20 22:09:41 Modified: docs/manual/CoreTasks echo.html Log: Fix Bug 4991; add more examples of other options. This should mark the last change to echo.html for a while. Except. We say that message is required unless text is provided, but in fact is perfectly valid, is it not? Revision Changes Path 1.6 +32 -5 jakarta-ant/docs/manual/CoreTasks/echo.html Index: echo.html =================================================================== RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/echo.html,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- echo.html 2001/11/16 06:44:33 1.5 +++ echo.html 2001/11/21 06:09:41 1.6 @@ -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