summaryrefslogtreecommitdiffstats
path: root/doc/lzlib.info
diff options
context:
space:
mode:
authorDaniel Baumann <mail@daniel-baumann.ch>2015-11-07 13:45:54 +0000
committerDaniel Baumann <mail@daniel-baumann.ch>2015-11-07 13:45:54 +0000
commit53eee7f4e2ef4d4211df3e860e3c787fbd83c3e8 (patch)
treecff02b70b5a48f7cefa4a5ad4c4ab745e2b64dd6 /doc/lzlib.info
parentAdding upstream version 1.2. (diff)
downloadlzlib-upstream/1.3.tar.xz
lzlib-upstream/1.3.zip
Adding upstream version 1.3.upstream/1.3
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
Diffstat (limited to 'doc/lzlib.info')
-rw-r--r--doc/lzlib.info58
1 files changed, 34 insertions, 24 deletions
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: