|
1 | 1 | .\" zip_set_file_compression.mdoc -- set compression method and its flags |
2 | | -.\" Copyright (C) 2012-2016 Dieter Baron and Thomas Klausner |
| 2 | +.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner |
3 | 3 | .\" |
4 | 4 | .\" This file is part of libzip, a library to manipulate ZIP files. |
5 | 5 | .\" The authors can be contacted at <libzip@nih.at> |
|
29 | 29 | .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN |
30 | 30 | .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
31 | 31 | .\" |
32 | | -.Dd May 1, 2012 |
| 32 | +.Dd April 6, 2017 |
33 | 33 | .Dt ZIP_SET_FILE_COMPRESSION 3 |
34 | 34 | .Os |
35 | 35 | .Sh NAME |
@@ -63,21 +63,26 @@ default compression; currently the same as |
63 | 63 | .Dv ZIP_CM_DEFLATE . |
64 | 64 | .It Dv ZIP_CM_STORE |
65 | 65 | Store the file uncompressed. |
| 66 | +.It Dv ZIP_CM_BZIP2 |
| 67 | +Compress the file using the |
| 68 | +.Xr bzip2 1 |
| 69 | +algorithm. |
66 | 70 | .It Dv ZIP_CM_DEFLATE |
67 | 71 | Deflate the file with the |
68 | 72 | .Xr zlib 3 |
69 | 73 | algorithm and default options |
70 | 74 | .El |
71 | 75 | .Pp |
| 76 | +.Em NOTE : |
| 77 | +Only the deflate and store methods can be assumed to be universally |
| 78 | +supported. |
| 79 | +.Pp |
72 | 80 | The |
73 | 81 | .Ar comp_flags |
74 | | -argument is currently ignored. |
75 | | -.\" For the comp_flags argument, the lower 4 bits define the compression |
76 | | -.\" level. |
77 | | -.\" 0 is fastest compression, 15 is highest compression |
78 | | -.\" .Dv ZIP_COMP_FL_DEFAULT |
79 | | -.\" can be used to specify that the default shall be used. |
80 | | -.\" Further compression method specific flags will be added over time. |
| 82 | +argument defines the compression level, 1 being fastest compression |
| 83 | +and 9 highest. |
| 84 | +Allowed values are 1-9, other values are undefined. |
| 85 | +Further compression method specific flags might be added over time. |
81 | 86 | .Pp |
82 | 87 | The current compression method for a file in a zip archive can be |
83 | 88 | determined using |
|
0 commit comments