Make immutable private field final. Javadoc

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/net/branches/NET_2_0@963320 13f79535-47bb-0310-9956-ffa450edef68

Author: sebbASF

src/main/java/org/apache/commons/net/ftp/FTPClient.java

@@ -270,7 +270,7 @@ public class FTPClient extends FTP
     private int __dataConnectionMode, __dataTimeout;
     private int __passivePort;
     private String __passiveHost;
-    private Random __random;
+    private final Random __random;
     private int __activeMinPort, __activeMaxPort;
     private InetAddress __activeExternalHost;
     private int __fileType, __fileFormat, __fileStructure, __fileTransferMode;
@@ -1378,6 +1378,8 @@ public boolean completePendingCommand() throws IOException
      * If the current file type is ASCII, line separators in the file are
      * converted to the local representation.
      * <p>
+     * Note: if you have used {@link #setRestartOffset(long)}, 
+     * the file data will start from the selected offset.
      * @param remote  The name of the remote file.
      * @param local   The local OutputStream to which to write the file.
      * @return True if successfully completed, false if not.
@@ -1439,6 +1441,9 @@ public boolean retrieveFile(String remote, OutputStream local)
      * {@link #completePendingCommand  completePendingCommand } and
      * check its return value to verify success.
      * <p>
+     * Note: if you have used {@link #setRestartOffset(long)}, 
+     * the file data will start from the selected offset.
+     *  
      * @param remote  The name of the remote file.
      * @return An InputStream from which the remote file can be read.  If
      *      the data connection cannot be opened (e.g., the file does not