svn commit: r1361522 - in /commons/proper/net/trunk/src: changes/changes.xml main/java/org/apache/commons/net/ftp/FTPClient.java

[se...@apache.org]

Author: sebb
Date: Sat Jul 14 11:14:42 2012
New Revision: 1361522

URL: http://svn.apache.org/viewvc?rev=1361522&view=rev
Log:
NET-475 FtpClient sends REST when calling listFiles

Modified:
    commons/proper/net/trunk/src/changes/changes.xml
    commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java

Modified: commons/proper/net/trunk/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/changes/changes.xml?rev=1361522&r1=1361521&r2=1361522&view=diff
==============================================================================
--- commons/proper/net/trunk/src/changes/changes.xml (original)
+++ commons/proper/net/trunk/src/changes/changes.xml Sat Jul 14 11:14:42 2012
@@ -65,6 +65,9 @@ The <action> type attribute can be add,u
         <release version="3.2" date="TBA" description="
 TBA
         ">
+            <action issue="NET-475" dev="sebb" type="fix">
+            FtpClient sends REST when calling listFiles. Clarified Javadoc.
+            </action>
             <action issue="NET-465" dev="sebb" type="add" due-to="Bogdan Drozdowski">
             FTPClient setSendBufferSize and setReceiveBufferSize on data socket.
             </action>

Modified: commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java?rev=1361522&r1=1361521&r2=1361522&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java (original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java Sat Jul 14 11:14:42 2012
@@ -2393,10 +2393,17 @@ implements Configurable
     }
 
     /**
-     * Sets the restart offset.  The restart command is sent to the server
-     * only before sending the file transfer command.  When this is done,
-     * the restart marker is reset to zero.
+     * Sets the restart offset for file transfers.
+     * <p>  
+     * The restart command is not sent to the server immediately.
+     * It is sent when a data connection is created as part of a 
+     * subsequent command.
+     * The restart marker is reset to zero after use.
+     * </p>
      * <p>
+     * <b>Note: This method should only be invoked immediately prior to
+     * the transfer to which it applies.</b>
+     * 
      * @param offset  The offset into the remote file at which to start the
      *           next file transfer.  This must be a value greater than or
      *           equal to zero.