commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject svn commit: r1643414 - /commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java
Date Fri, 05 Dec 2014 20:17:18 GMT
Author: sebb
Date: Fri Dec  5 20:17:18 2014
New Revision: 1643414

URL: http://svn.apache.org/r1643414
Log:
Document LIST timestamp restrictions

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=1643414&r1=1643413&r2=1643414&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 Fri Dec
 5 20:17:18 2014
@@ -2926,6 +2926,12 @@ implements Configurable
      * the returned array is determined by the<code> FTPFileEntryParser </code>
      * used.
      * <p>
+     * N.B. the LIST command does not generally return very precise timestamps.
+     * For recent files, the response usually contains hours and minutes (not seconds).
+     * For older files, the output may only contain a date.
+     * If the server supports it, the MLSD command returns timestamps with a precision
+     * of seconds, and may include milliseconds. See {@link #mlistDir()}
+     * <p>
      * @param pathname  The file or directory to list.  Since the server may
      *                  or may not expand glob expressions, using them here
      *                  is not recommended and may well cause this method to
@@ -2979,6 +2985,12 @@ implements Configurable
      * the returned array is determined by the<code> FTPFileEntryParser </code>
      * used.
      * <p>
+     * N.B. the LIST command does not generally return very precise timestamps.
+     * For recent files, the response usually contains hours and minutes (not seconds).
+     * For older files, the output may only contain a date.
+     * If the server supports it, the MLSD command returns timestamps with a precision
+     * of seconds, and may include milliseconds. See {@link #mlistDir()}
+     * <p>
      * @return The list of file information contained in the current directory
      *         in the format determined by the autodetection mechanism.
      *         <p><b>
@@ -3041,6 +3053,12 @@ implements Configurable
      * the returned array is determined by the<code> FTPFileEntryParser </code>
      * used.
      * <p>
+     * N.B. the LIST command does not generally return very precise timestamps.
+     * For recent files, the response usually contains hours and minutes (not seconds).
+     * For older files, the output may only contain a date.
+     * If the server supports it, the MLSD command returns timestamps with a precision
+     * of seconds, and may include milliseconds. See {@link #mlistDir()}
+     * <p>
      * @return The list of directories contained in the current directory
      *         in the format determined by the autodetection mechanism.
      *
@@ -3082,6 +3100,12 @@ implements Configurable
      * the returned array is determined by the<code> FTPFileEntryParser </code>
      * used.
      * <p>
+     * N.B. the LIST command does not generally return very precise timestamps.
+     * For recent files, the response usually contains hours and minutes (not seconds).
+     * For older files, the output may only contain a date.
+     * If the server supports it, the MLSD command returns timestamps with a precision
+     * of seconds, and may include milliseconds. See {@link #mlistDir()}
+     * <p>
      * @return The list of directories contained in the specified directory
      *         in the format determined by the autodetection mechanism.
      *



Mime
View raw message