svn commit: r1531857 - /commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/arj/ArjArchiveEntry.java

[bo...@apache.org]

Author: bodewig
Date: Mon Oct 14 11:22:59 2013
New Revision: 1531857

URL: http://svn.apache.org/r1531857
Log:
document ARJ's strange time handling

Modified:
    commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/arj/ArjArchiveEntry.java

Modified: commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/arj/ArjArchiveEntry.java
URL: http://svn.apache.org/viewvc/commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/arj/ArjArchiveEntry.java?rev=1531857&r1=1531856&r2=1531857&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/arj/ArjArchiveEntry.java (original)
+++ commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/arj/ArjArchiveEntry.java Mon Oct 14 11:22:59 2013
@@ -71,6 +71,16 @@ public class ArjArchiveEntry implements 
 
     /**
      * The last modified date of the entry.
+     *
+     * <p>Note the interpretation of time is different depending on
+     * the HostOS that has created the archive.  While an OS that is
+     * {@link #isHostOsUnix considered to be Unix} stores time in a
+     * timezone independent manner, other platforms only use the local
+     * time.  I.e. if an archive has been created at midnight UTC on a
+     * machine in timezone UTC this method will return midnight
+     * regardless of timezone if the archive has been created on a
+     * non-Unix system and a time taking the current timezone into
+     * account if the archive has beeen created on Unix.</p>
      */
     public Date getLastModifiedDate() {
         long ts = isHostOsUnix() ? (localFileHeader.dateTimeModified * 1000l)