Remove *encoding attributes from <sync> as they are meaningless when

we are not filtering in <copy>. Add documentation for <sync>. git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@274571 13f79535-47bb-0310-9956-ffa450edef68
22 years ago · 3f301fd4e5
--- a/docs/manual/CoreTasks/sync.html
+++ b/docs/manual/CoreTasks/sync.html
@@ -0,0 +1,68 @@
 <html>

 <head>
 <meta http-equiv="Content-Language" content="en-us">
 <title>Sync Task</title>
 </head>

 <body>

 <h2><a name="get">Sync</a></h2>
 <p><em>Since Ant 1.6</em></p>
 <h3>Description</h3>

 <p>Synchronize a target directory from the files defined in one or
 more filesets.</p>

 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
  <tr>
    <td valign="top"><b>Attribute</b></td>
    <td valign="top"><b>Description</b></td>
    <td align="center" valign="top"><b>Required</b></td>
  </tr>
  <tr>
    <td valign="top">todir</td>
    <td valign="top">the target directory to sync with the filesets</td>
    <td align="center" valign="top">Yes</td>
  </tr>  
  <tr>
    <td valign="top">overwrite</td>
    <td valign="top">Overwrite existing files even if the destination
      files are newer.</td>
    <td valign="top" align="center">No; defaults to false.</td>
  </tr>
  <tr>
    <td valign="top">includeEmptyDirs</td>
     <td valign="top">Copy any empty directories included in the FileSet(s).
     </td>
     <td valign="top" align="center">No; defaults to true.</td>
  </tr>
  <tr>
    <td valign="top">failonerror</td>
     <td valign="top">Log a warning message, but do not stop the build,
       when one of the nested filesets points to a directory that
       doesn't exist.
     </td>
     <td valign="top" align="center">No; defaults to true.</td>
  </tr>
  <tr>
    <td valign="top">verbose</td>
     <td valign="top">Log the files that are being copied.</td>
     <td valign="top" align="center">No; defaults to false.</td>
  </tr>
 </table>

 <h3>Parameters specified as nested elements</h3>

 <h4>fileset</h4>
 <p><a href="../CoreTypes/fileset.html">FileSet</a>s are used to select
 sets of files and directories.</p>

 <hr>
 <p align="center">Copyright &copy; 2003 Apache Software Foundation. All rights
 Reserved.</p>

 </body>
 </html>

--- a/docs/manual/coretasklist.html
+++ b/docs/manual/coretasklist.html
@@ -76,6 +76,7 @@
 <a href="CoreTasks/sql.html">Sql</a><br>
 <a href="CoreTasks/style.html">Style</a><br>
 <a href="CoreTasks/subant.html">Subant</a><br>
 <a href="CoreTasks/sync.html">Sync</a><br>
 <a href="CoreTasks/tar.html">Tar</a><br>
 <a href="CoreTasks/taskdef.html">Taskdef</a><br>
 <a href="CoreTasks/tempfile.html">Tempfile</a><br>
--- a/src/main/org/apache/tools/ant/taskdefs/Sync.java
+++ b/src/main/org/apache/tools/ant/taskdefs/Sync.java
@@ -323,21 +323,6 @@ public class Sync extends Task {
        _copy.addFileset(set);
    }

    /**
     * Sets the character encoding
     */
    public void setEncoding(String encoding) {
        _copy.setEncoding(encoding);
    }

    /**
     * Sets the character encoding for output files.
     */
    public void setOutputEncoding(String encoding) {
        _copy.setOutputEncoding(encoding);
    }


    /**
     * Subclass Copy in order to access it's file/dir maps.
     */