commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bode...@apache.org
Subject svn commit: r1571660 - in /commons/proper/compress/trunk/src: changes/changes.xml main/java/org/apache/commons/compress/archivers/sevenz/SevenZMethodConfiguration.java site/xdoc/examples.xml
Date Tue, 25 Feb 2014 12:10:44 GMT
Author: bodewig
Date: Tue Feb 25 12:10:43 2014
New Revision: 1571660

URL: http://svn.apache.org/r1571660
Log:
COMPRESS-266 document changes

Modified:
    commons/proper/compress/trunk/src/changes/changes.xml
    commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZMethodConfiguration.java
    commons/proper/compress/trunk/src/site/xdoc/examples.xml

Modified: commons/proper/compress/trunk/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/compress/trunk/src/changes/changes.xml?rev=1571660&r1=1571659&r2=1571660&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/changes/changes.xml (original)
+++ commons/proper/compress/trunk/src/changes/changes.xml Tue Feb 25 12:10:43 2014
@@ -84,6 +84,11 @@ The <action> type attribute can be add,u
         streaming for the format.  This currently only applies to the
         7z format.
       </action>
+      <action issue="COMPRESS-266" type="add" date="2014-02-25">
+        SevenZOutputFile now supports chaining multiple
+        compression/encryption/filter methods and passing options to
+        the methods.
+      </action>
     </release>
     <release version="1.7" date="2014-01-20"
              description="Release 1.7">

Modified: commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZMethodConfiguration.java
URL: http://svn.apache.org/viewvc/commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZMethodConfiguration.java?rev=1571660&r1=1571659&r2=1571660&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZMethodConfiguration.java
(original)
+++ commons/proper/compress/trunk/src/main/java/org/apache/commons/compress/archivers/sevenz/SevenZMethodConfiguration.java
Tue Feb 25 12:10:43 2014
@@ -19,6 +19,18 @@ package org.apache.commons.compress.arch
 
 /**
  * Combines a SevenZMethod with configuration options for the method.
+ *
+ * <p>The exact type and interpretation of options depends on the
+ * method being configured.  Currently supported are:</p>
+ *
+ * <table>
+ * <tr><th>Method</th><th>Option Type</th><th>Description</th></tr>
+ * <tr><td>BZIP2</td><td>Number</td><td>Block Size -
an number between 1 and 9</td></tr>
+ * <tr><td>DEFLATE</td><td>Number</td><td>Compression
Level - an number between 1 and 9</td></tr>
+ * <tr><td>LZMA2</td><td>Number</td><td>Dictionary Size
- a number between 4096 and 768 MiB (768 &lt;&lt; 20)</td></tr>
+ * <tr><td>LZMA2</td><td>org.tukaani.xz.LZMA2Options</td><td>Whole
set of LZMA2 options.</td></tr>
+ * </table>
+ *
  * @Immutable
  * @since 1.8
  */

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=1571660&r1=1571659&r2=1571660&view=diff
==============================================================================
--- commons/proper/compress/trunk/src/site/xdoc/examples.xml (original)
+++ commons/proper/compress/trunk/src/site/xdoc/examples.xml Tue Feb 25 12:10:43 2014
@@ -489,11 +489,24 @@ lzmaIn.close();
 
         <p>Multipart archives are not supported at all.</p>
 
+        <p>7z archives can use multiple compression and encryption
+        methods as well as filters combined as a pipeline of methods
+        for its entries.  Prior to Compress 1.8 you could only specify
+        a single method when creating archives - reading archives
+        using more than one method has been possible before.  Starting
+        with Compress 1.8 it is possible to configure the full
+        pipeline using the <code>setContentMethods</code> method of
+        <code>SevenZOutputFile</code>.  Methods are specified in the
+        order they appear inside the pipeline when creating the
+        archive, you can also specify certain parameters for some of
+        the methods - see the Javadocs of
+        <code>SevenZMethodConfiguration</code> for details.</p>
+
         <p>Currently solid compression - compressing multiple files
         as a single block to benefit from patterns repeating accross
         files - is only supported when reading archives.  This also
         means compression ratio will likely be worse when using
-        Commons Compress.</p>
+        Commons Compress compared to the native 7z executable.</p>
 
         <p>Adding an entry to a 7z archive:</p>
 <source><![CDATA[



Mime
View raw message