Sync Task

From 753a6c60f47f3ac4f270005b65e9d6481de8eb68 Mon Sep 17 00:00:00 2001 From: Ashlee Young Date: Fri, 23 Oct 2015 10:00:02 -0700 Subject: Adding maven and ant source trees Change-Id: I0a39b9add833a31b9c3f98d193983ae2f3a5a445 Signed-off-by: Ashlee Young --- .../ant/apache-ant-1.9.6/manual/Tasks/sync.html | 166 +++++++++++++++++++++ 1 file changed, 166 insertions(+) create mode 100644 framework/src/ant/apache-ant-1.9.6/manual/Tasks/sync.html (limited to 'framework/src/ant/apache-ant-1.9.6/manual/Tasks/sync.html') diff --git a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/sync.html b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/sync.html new file mode 100644 index 00000000..1d34aeef --- /dev/null +++ b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/sync.html @@ -0,0 +1,166 @@ + + + + + + +Sync Task + + + + +

Sync

Since Apache Ant 1.6

Description

+ +

Synchronize a target directory from the files defined in one or +more Resource Collections.

+ +

Any file in the target directory that has not been matched by at +least one of the nested resource collections gets removed. I.e. if you exclude a +file in your sources and a file of that name is present in the target +dir, it will get removed from the target.

+ +

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Attribute	Description	Required
todir	the target directory to sync with the resource collections	Yes
overwrite	Overwrite existing files even if the destination + files are newer.	No; defaults to false.
includeEmptyDirs	Copy any empty directories included in the + resource collection(s). + Note this attribute also controls the behavior for any + nested <preserveintarget> element. If this attribute is + false (the default) empty directories that only exist in the + target directory will be removed even if they are matched by + the patterns of <preserveintarget>. This can be + overridden by <preserveintarget>'s + preserveEmptyDirs attribute. +	No; defaults to false.
failonerror	If is set to false, log a warning message, but do not stop the build, + when one of the nested filesets points to a directory that + doesn't exist. +	No; defaults to true.
verbose	Log the files that are being copied.	No; defaults to false.
granularity	The number of milliseconds leeway to give before + deciding a file is out of date. This is needed because not every + file system supports tracking the last modified time to the + millisecond level. Default is 0 milliseconds, or 2 seconds on DOS + systems. This can also be useful if source and target files live + on separate machines with clocks being out of sync. since Ant + 1.6.2.	No.

+ +

Parameters specified as nested elements

+ +

fileset or any other resource collection

Resource +Collections are used to select groups of files to copy.

Prior to Ant 1.7 only <fileset> has been +supported as a nested element.

+ +

preserveInTarget

+ +

Since Ant 1.7.0

+ +

Specifies files or directories that should be kept in the target +directory even if they are not present in one of the source +directories.

+ +

This nested element is like a FileSet except that it doesn't +support the dir attribute and the usedefaultexcludes attribute +defaults to false.

+ +

Additional Parameters

+ + + + + + + + + + + +

Attribute	Description	Required
preserveEmptyDirs	Overrules the includeEmptydirs setting for + directories matched by this element. If you want to preserve + empty directories that are not in your source directory you can + either set the task's includeemptydirs attribute or this one. + If the two attribute values conflict, this attribute + "wins".	No, defaults to the value of the + task's includeemptydirs attribute

+ +

Examples

+ +

+<sync todir="site">
+  <fileset dir="generated-site"/>
+</sync>
+

overwrites all files in site with newer files from +generated-site, deletes files from site that are not +present in generated-site.

+ +

+<sync todir="site">
+  <fileset dir="generated-site"/>
+  <preserveintarget>
+    <include name="**/CVS/**"/>
+  </preserveintarget>
+</sync>
+

overwrites all files in site with newer files from +generated-site, deletes files from site that are not +present in generated-site but keeps all files in any +CVS sub-directory.

+ + + + + + -- cgit 1.2.3-korg