From 5e16daf1e789e40f2461893c90f3daffa3f9909b Mon Sep 17 00:00:00 2001 From: Diane Holt Date: Tue, 5 Feb 2002 20:21:59 +0000 Subject: [PATCH] Fix the 'dir' attribute description, and usual general clean-up. Also removed the block of deprecated attrs, since they were old enough to qualify for social security :) PR: 5777 Obtained from: Submitted by: Reviewed by: git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@271159 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/CoreTasks/delete.html | 79 +++++++++++-------------------- 1 file changed, 27 insertions(+), 52 deletions(-) diff --git a/docs/manual/CoreTasks/delete.html b/docs/manual/CoreTasks/delete.html index 11f74da0e..5e4e983ac 100644 --- a/docs/manual/CoreTasks/delete.html +++ b/docs/manual/CoreTasks/delete.html @@ -9,10 +9,13 @@

Delete

Description

-

Deletes either a single file, all files in a specified directory and its -sub-directories, or a set of files specified by one or more FileSets. -When specifying a set of files, empty directories are not removed by default. -To remove empty directories, use the includeEmptyDirs atribute.

+

Deletes a single file, a specified directory and all its files and +subdirectories, or a set of files specified by one or more +FileSets. +When specifying a set of files, empty directories are not removed by +default. +To remove empty directories, use the includeEmptyDirs attribute. +

Parameters

@@ -23,38 +26,41 @@ To remove empty directories, use the includeEmptyDirs atribute.

- + - + - - Setting this to true, implies setting failonerror to false. + message (unless Ant + has been invoked with the ‑verbose or + ‑debug switches) or modify the exit status to + reflect 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 setting + failonerror to "false". + @@ -64,37 +70,6 @@ To remove empty directories, use the includeEmptyDirs atribute.

using filesets. Default is "false". - - - - - - - - - - - - - - - - - - - - - - - - -
file The file to delete.at least one of the twoAt least one of the two, unless a <fileset> is specified.
dirThe directory to delete files from.The directory to delete, including all its files and subdirectories.
verboseShow name of each deleted file ("true"/"false"). + Show the name of each deleted file ("true"/"false"). Default is "false" when omitted. No
quiet If the file does not exist, do not display a diagnostic - message or modify the exit status to reflect an error (unless Ant - has been invoked with the -verbose or -debug switches). - 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. - ("true"/"false"). - Default is "false" meaning things are "noisy". No
failonerror - This flag (which is only of relevance if 'quiet' is false), - controls whether an error -such as a failure to delete a file- - stops the build task, or is merely reported to the screen. - The default is "true" + 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". No
No
includesDeprecated. Comma separated list of patterns of files that must be - deleted. All files are in the current directory - and any sub-directories are deleted when omitted.No
includesfileDeprecated. The name of a file. Each line of this file is - taken to be an include patternNo
excludesDeprecated. Comma separated list of patterns of files that must be - excluded from the deletion list. No files (except default excludes) are excluded when omitted.No
excludesfileDeprecated. The name of a file. Each line of this file is - taken to be an exclude patternNo
defaultexcludesDeprecated. Indicates whether default excludes should be used or not - ("yes"/"no"). Default excludes are used when omitted.No

Examples

  <delete file="/lib/ant.jar"/>
@@ -106,8 +81,8 @@ and subdirectories of lib.

<fileset dir="." includes="**/*.bak"/> </delete> -

deletes all files with the extension ".bak" from the current directory -and any sub-directories.

+

deletes all files with the extension .bak from the current directory +and any subdirectories.

  <delete includeEmptyDirs="true" >
     <fileset dir="build" />
   </delete>