[prev in list] [next in list] [prev in thread] [next in thread] 

List:       jakarta-commons-dev
Subject:    svn commit: r1642598 - /commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.
From:       sebb () apache ! org
Date:       2014-11-30 19:16:07
Message-ID: 20141130191607.7A15D2389206 () eris ! apache ! org
[Download RAW message or body]

Author: sebb
Date: Sun Nov 30 19:16:07 2014
New Revision: 1642598

URL: http://svn.apache.org/r1642598
Log:
Add example config item

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

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=1642598&r1=1642597&r2=1642598&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 \
Sun Nov 30 19:16:07 2014 @@ -69,6 +69,7 @@ import org.apache.commons.net.io.Util;
  *    FTPClient ftp = new FTPClient();
  *    FTPClientConfig config = new FTPClientConfig();
  *    config.setXXX(YYY); // change required options
+ *    // for example config.setServerTimeZoneId("Pacific/Pitcairn")
  *    ftp.configure(config );
  *    boolean error = false;
  *    try {
@@ -1911,10 +1912,12 @@ implements Configurable
      * InputStream will convert line separators in the file to
      * the local representation.  You must close the InputStream when you
      * finish reading from it.  The InputStream itself will take care of
-     * closing the parent data connection socket upon being closed.  To
-     * finalize the file transfer you must call
+     * closing the parent data connection socket upon being closed.
+     * <p> 
+     * <b>To finalize the file transfer you must call
      * {@link #completePendingCommand  completePendingCommand } and
-     * check its return value to verify success.
+     * check its return value to verify success.</b>
+     * If this is not done, subsequent commands may behave unexpectedly.
      * <p>
      * Note: if you have used {@link #setRestartOffset(long)},
      * the file data will start from the selected offset.
@@ -2005,9 +2008,12 @@ implements Configurable
      * create a special OutputStream to do this).  You must close the
      * OutputStream when you finish writing to it.  The OutputStream itself
      * will take care of closing the parent data connection socket upon being
-     * closed.  To finalize the file transfer you must call
+     * closed.
+     * <p> 
+     * <b>To finalize the file transfer you must call
      * {@link #completePendingCommand  completePendingCommand } and
-     * check its return value to verify success.
+     * check its return value to verify success.</b>
+     * If this is not done, subsequent commands may behave unexpectedly.
      * <p>
      * @param remote  The name to give the remote file.
      * @return An OutputStream through which the remote file can be written.  If
@@ -2066,9 +2072,12 @@ implements Configurable
      * create a special OutputStream to do this).  You must close the
      * OutputStream when you finish writing to it.  The OutputStream itself
      * will take care of closing the parent data connection socket upon being
-     * closed.  To finalize the file transfer you must call
+     * closed.
+     * <p> 
+     * <b>To finalize the file transfer you must call
      * {@link #completePendingCommand  completePendingCommand } and
-     * check its return value to verify success.
+     * check its return value to verify success.</b>
+     * If this is not done, subsequent commands may behave unexpectedly.
      * <p>
      * @param remote  The name of the remote file.
      * @return An OutputStream through which the remote file can be appended.
@@ -2130,9 +2139,12 @@ implements Configurable
      * create a special OutputStream to do this).  You must close the
      * OutputStream when you finish writing to it.  The OutputStream itself
      * will take care of closing the parent data connection socket upon being
-     * closed.  To finalize the file transfer you must call
+     * closed.
+     * <p> 
+     * <b>To finalize the file transfer you must call
      * {@link #completePendingCommand  completePendingCommand } and
-     * check its return value to verify success.
+     * check its return value to verify success.</b>
+     * If this is not done, subsequent commands may behave unexpectedly.
      * <p>
      * @param remote  The name on which to base the unique name given to
      *                the remote file.
@@ -2191,9 +2203,12 @@ implements Configurable
      * create a special OutputStream to do this).  You must close the
      * OutputStream when you finish writing to it.  The OutputStream itself
      * will take care of closing the parent data connection socket upon being
-     * closed.  To finalize the file transfer you must call
+     * closed.
+     * <p> 
+     * <b>To finalize the file transfer you must call
      * {@link #completePendingCommand  completePendingCommand } and
-     * check its return value to verify success.
+     * check its return value to verify success.</b>
+     * If this is not done, subsequent commands may behave unexpectedly.
      * <p>
      * @return An OutputStream through which the remote file can be written.  If
      *      the data connection cannot be opened (e.g., the file does not


[prev in list] [next in list] [prev in thread] [next in thread]