From 4b2126b14346d29e15ddd4867930e96c857e168c Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 7 Nov 2015 14:46:00 +0100 Subject: Merging upstream version 1.3. Signed-off-by: Daniel Baumann --- doc/lzlib.info | 58 ++++++++++++++++++++++++++++++++++------------------------ 1 file changed, 34 insertions(+), 24 deletions(-) (limited to 'doc/lzlib.info') diff --git a/doc/lzlib.info b/doc/lzlib.info index e502f6b..bfa5a82 100644 --- a/doc/lzlib.info +++ b/doc/lzlib.info @@ -12,7 +12,7 @@ File: lzlib.info, Node: Top, Next: Introduction, Up: (dir) Lzlib Manual ************ -This manual is for Lzlib (version 1.2, 25 October 2011). +This manual is for Lzlib (version 1.3, 29 February 2012). * Menu: @@ -30,7 +30,7 @@ This manual is for Lzlib (version 1.2, 25 October 2011). * Concept Index:: Index of concepts - Copyright (C) 2009, 2010, 2011 Antonio Diaz Diaz. + Copyright (C) 2009, 2010, 2011, 2012 Antonio Diaz Diaz. This manual is free documentation: you have unlimited permission to copy, distribute and modify it. @@ -44,11 +44,11 @@ File: lzlib.info, Node: Introduction, Next: Library Version, Prev: Top, Up: Lzlib is a data compression library providing in-memory LZMA compression and decompression functions, including integrity checking of the decompressed data. The compressed data format used by the library is the -lzip format. +lzip format. Lzlib is written in C. The functions and variables forming the interface of the compression library are declared in the file `lzlib.h'. Usage examples of the -library are given in the files `main.cc' and `bbexample.cc' from the +library are given in the files `main.c' and `bbexample.c' from the source distribution. Compression/decompression is done by repeatedly calling a couple of @@ -189,7 +189,7 @@ verified by calling `LZ_compress_errno' before using it. MEMBER_SIZE sets the member size limit in bytes. Minimum member size limit is 100kB. Small member size may degrade compression - ratio, so use it only when needed. To produce a single member data + ratio, so use it only when needed. To produce a single-member data stream, give MEMBER_SIZE a value larger than the amount of data to be produced, for example LLONG_MAX. @@ -210,7 +210,7 @@ verified by calling `LZ_compress_errno' before using it. -- Function: int LZ_compress_restart_member ( struct LZ_Encoder * const ENCODER, const long long MEMBER_SIZE ) - Use this function to start a new member, in a multimember data + Use this function to start a new member, in a multi-member data stream. Call this function only after `LZ_compress_member_finished' indicates that the current member has been fully read (with the `LZ_compress_read' function). @@ -262,8 +262,8 @@ verified by calling `LZ_compress_errno' before using it. -- Function: int LZ_compress_member_finished ( struct LZ_Encoder * const ENCODER ) - Returns 1 if the current member, in a multimember data stream, has - been fully read and `LZ_compress_restart_member' can be safely + Returns 1 if the current member, in a multi-member data stream, + has been fully read and `LZ_compress_restart_member' can be safely called. Otherwise it returns 0. -- Function: long long LZ_compress_data_position ( struct LZ_Encoder * @@ -542,7 +542,7 @@ with no additional information before, between, or after them. `Member size (8 bytes)' Total size of the member, including header and trailer. This - facilitates safe recovery of undamaged members from multimember + facilitates safe recovery of undamaged members from multi-member files. @@ -554,10 +554,15 @@ File: lzlib.info, Node: Examples, Next: Problems, Prev: Data Format, Up: Top This chapter shows the order in which the library functions should be called depending on what kind of data stream you want to compress or -decompress. See the file `bbexample.cc' in the source distribution for +decompress. See the file `bbexample.c' in the source distribution for an example of how buffer-to-buffer compression/decompression can be implemented using lzlib. + Note that lzlib's interface is symmetrical. That is, the code for +normal compression and decompression is identical except because one +calls LZ_compress* functions while the other calls LZ_decompress* +functions. + Example 1: Normal compression (MEMBER_SIZE > total output). @@ -607,7 +612,7 @@ Example 4: Decompression using LZ_decompress_write_size. 7) LZ_decompress_close -Example 5: Multimember compression (MEMBER_SIZE < total output). +Example 5: Multi-member compression (MEMBER_SIZE < total output). 1) LZ_compress_open 2) go to step 5 if LZ_compress_write_size returns 0 @@ -621,7 +626,7 @@ Example 5: Multimember compression (MEMBER_SIZE < total output). 10) LZ_compress_close -Example 6: Multimember compression (user-restarted members). +Example 6: Multi-member compression (user-restarted members). 1) LZ_compress_open 2) LZ_compress_write @@ -704,17 +709,22 @@ Concept Index  Tag Table: Node: Top219 -Node: Introduction1311 -Node: Library Version3136 -Node: Buffering3781 -Node: Parameter Limits4901 -Node: Compression Functions5858 -Node: Decompression Functions11955 -Node: Error Codes18027 -Node: Error Messages19966 -Node: Data Format20545 -Node: Examples22553 -Node: Problems26419 -Node: Concept Index26991 +Node: Introduction1318 +Node: Library Version3164 +Node: Buffering3809 +Node: Parameter Limits4929 +Node: Compression Functions5886 +Node: Decompression Functions11985 +Node: Error Codes18057 +Node: Error Messages19996 +Node: Data Format20575 +Node: Examples22584 +Node: Problems26667 +Node: Concept Index27239  End Tag Table + + +Local Variables: +coding: iso-8859-15 +End: -- cgit v1.2.3