Author: bodewig
Date: Sat Jul 23 03:04:09 2011
New Revision: 1149786
URL: http://svn.apache.org/viewvc?rev=1149786&view=rev
Log:
we can read the GNU variant of long file names in AR. COMPRESS-141
Modified:
commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/ar/ArArchiveEntry.java
commons/proper/compress/trunk/src/site/xdoc/examples.xml
Modified:
commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/ar/ArArchiveEntry.java
URL:
http://svn.apache.org/viewvc/commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/ar/ArArchiveEntry.java?rev=1149786&r1=1149785&r2=1149786&view=diff
==============================================================================
---
commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/ar/ArArchiveEntry.java
(original)
+++
commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/ar/ArArchiveEntry.java
Sat Jul 23 03:04:09 2011
@@ -42,10 +42,10 @@ import org.apache.commons.compress.archi
*
* This specifies that an ar archive entry header contains 60 bytes.
*
- * Due to the limitation of the file name length to 16 bytes GNU and BSD has
- * their own variants of this format. This formats are currently not supported
- * and file names with a bigger size than 16 bytes are not possible at the
- * moment.
+ * Due to the limitation of the file name length to 16 bytes GNU and
+ * BSD has their own variants of this format. Currently Commons
+ * Compress can read but not write the GNU variant and doesn't support
+ * the BSD variant at all.
*
* @see http://www.freebsd.org/cgi/man.cgi?query=ar&sektion=5
*
@@ -62,7 +62,7 @@ public class ArArchiveEntry implements A
/**
* SVR4/GNU adds a trailing / to names; BSD does not.
* They also vary in how names longer than 16 characters are represented.
- * (Not yet supported by this implementation)
+ * (Not yet fully supported by this implementation)
*/
private final String name;
private final int userId;
Modified: commons/proper/compress/trunk/src/site/xdoc/examples.xml
URL:
http://svn.apache.org/viewvc/commons/proper/compress/trunk/src/site/xdoc/examples.xml?rev=1149786&r1=1149785&r2=1149786&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/site/xdoc/examples.xml (original)
+++ commons/proper/compress/trunk/src/site/xdoc/examples.xml Sat Jul 23
03:04:09 2011
@@ -95,6 +95,14 @@ LOOP UNTIL entry.getSize() HAS BEEN READ
}
]]></source>
+ <p>Traditionally the AR format doesn't allow file names longer
+ than 16 characters. There are two variants that circumvent
+ this limitation in different ways, the GNU/SRV4 and the BSD
+ variant. Currently Commons Compress can only read archives
+ using the GNU/SRV4 variant, it doesn't support writing
+ archives with file names longer than 16 characters at
+ all.</p>
+
</subsection>
<subsection name="cpio">
