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)
