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.
*
