]> granicus.if.org Git - python/commitdiff
Converted to use new macros. This example demonstrate \method{} and, more
authorFred Drake <fdrake@acm.org>
Thu, 22 Jan 1998 16:11:18 +0000 (16:11 +0000)
committerFred Drake <fdrake@acm.org>
Thu, 22 Jan 1998 16:11:18 +0000 (16:11 +0000)
importantly, \url{}.

Doc/lib/libzlib.tex
Doc/libzlib.tex

index 7d2cac9d93d0884058fdc3a29e3685ada393d540..cca35014cf35a0ffc61da52541f606a82615da7b 100644 (file)
@@ -7,7 +7,7 @@
 For applications that require data compression, the functions in this
 module allow compression and decompression, using the zlib library,
 which is based on GNU zip.  The zlib library has its own home page at
-\code{http://www.cdrom.com/pub/infozip/zlib/}.
+\url{http://www.cdrom.com/pub/infozip/zlib/}.
 Version 1.0.4 is the most recent version as of December, 1997; use a
 later version if one is available.
 
@@ -27,18 +27,19 @@ The available functions in this module are:
 
 \begin{funcdesc}{compress}{string\optional{\, level}}
 Compresses the data in \var{string}, returning a string contained
-compressed data.  \var{level} is an integer from 1 to 9 controlling
-the level of compression; 1 is fastest and produces the least
-compression, 9 is slowest and produces the most.  The default value is
-6.  Raises the \code{zlib.error} exception if any error occurs.
+compressed data.  \var{level} is an integer from \code{1} to \code{9}
+controlling the level of compression; \code{1} is fastest and produces
+the least compression, \code{9} is slowest and produces the most.  The
+default value is \code{6}.  Raises the \exception{zlib.error}
+exception if any error occurs.
 \end{funcdesc}
 
 \begin{funcdesc}{compressobj}{\optional{level}}
-Returns a compression object, to be used for compressing data streams
+  Returns a compression object, to be used for compressing data streams
   that won't fit into memory at once.  \var{level} is an integer from
-  1 to 9 controlling the level of compression; 1 is fastest and
-  produces the least compression, 9 is slowest and produces the most.
-  The default value is 6.
+  \code{1} to \code{9} controlling the level of compression; \code{1} is
+  fastest and produces the least compression, \code{9} is slowest and
+  produces the most.  The default value is \code{6}.
 \end{funcdesc}
 
 \begin{funcdesc}{crc32}{string\optional{\, value}}
@@ -52,7 +53,7 @@ Returns a compression object, to be used for compressing data streams
 
 \begin{funcdesc}{decompress}{string}
 Decompresses the data in \var{string}, returning a string containing
-the uncompressed data.  Raises the \code{zlib.error} exception if any
+the uncompressed data.  Raises the \exception{zlib.error} exception if any
 error occurs.
 \end{funcdesc}
 
@@ -69,14 +70,14 @@ Compression objects support the following methods:
 Compress \var{string}, returning a string containing compressed data
 for at least part of the data in \var{string}.  This data should be
 concatenated to the output produced by any preceding calls to the
-\code{compress()} method.  Some input may be kept in internal buffers
+\method{compress()} method.  Some input may be kept in internal buffers
 for later processing.
 \end{funcdesc}
 
 \begin{funcdesc}{flush}{}
 All pending input is processed, and an string containing the remaining
-compressed output is returned.  After calling \code{flush()}, the
-\code{compress()} method cannot be called again; the only realistic
+compressed output is returned.  After calling \method{flush()}, the
+\method{compress()} method cannot be called again; the only realistic
 action is to delete the object.
 \end{funcdesc}
 
@@ -87,14 +88,14 @@ Decompress \var{string}, returning a string containing the
 uncompressed data corresponding to at least part of the data in
 \var{string}.  This data should be concatenated to the output produced
 by any preceding calls to the
-\code{decompress()} method.  Some of the input data may be preserved
+\method{decompress()} method.  Some of the input data may be preserved
 in internal buffers for later processing.
 \end{funcdesc}
 
 \begin{funcdesc}{flush}{}
 All pending input is processed, and a string containing the remaining
-uncompressed output is returned.  After calling \code{flush()}, the
-\code{decompress()} method cannot be called again; the only realistic
+uncompressed output is returned.  After calling \method{flush()}, the
+\method{decompress()} method cannot be called again; the only realistic
 action is to delete the object.
 \end{funcdesc}
 
index 7d2cac9d93d0884058fdc3a29e3685ada393d540..cca35014cf35a0ffc61da52541f606a82615da7b 100644 (file)
@@ -7,7 +7,7 @@
 For applications that require data compression, the functions in this
 module allow compression and decompression, using the zlib library,
 which is based on GNU zip.  The zlib library has its own home page at
-\code{http://www.cdrom.com/pub/infozip/zlib/}.
+\url{http://www.cdrom.com/pub/infozip/zlib/}.
 Version 1.0.4 is the most recent version as of December, 1997; use a
 later version if one is available.
 
@@ -27,18 +27,19 @@ The available functions in this module are:
 
 \begin{funcdesc}{compress}{string\optional{\, level}}
 Compresses the data in \var{string}, returning a string contained
-compressed data.  \var{level} is an integer from 1 to 9 controlling
-the level of compression; 1 is fastest and produces the least
-compression, 9 is slowest and produces the most.  The default value is
-6.  Raises the \code{zlib.error} exception if any error occurs.
+compressed data.  \var{level} is an integer from \code{1} to \code{9}
+controlling the level of compression; \code{1} is fastest and produces
+the least compression, \code{9} is slowest and produces the most.  The
+default value is \code{6}.  Raises the \exception{zlib.error}
+exception if any error occurs.
 \end{funcdesc}
 
 \begin{funcdesc}{compressobj}{\optional{level}}
-Returns a compression object, to be used for compressing data streams
+  Returns a compression object, to be used for compressing data streams
   that won't fit into memory at once.  \var{level} is an integer from
-  1 to 9 controlling the level of compression; 1 is fastest and
-  produces the least compression, 9 is slowest and produces the most.
-  The default value is 6.
+  \code{1} to \code{9} controlling the level of compression; \code{1} is
+  fastest and produces the least compression, \code{9} is slowest and
+  produces the most.  The default value is \code{6}.
 \end{funcdesc}
 
 \begin{funcdesc}{crc32}{string\optional{\, value}}
@@ -52,7 +53,7 @@ Returns a compression object, to be used for compressing data streams
 
 \begin{funcdesc}{decompress}{string}
 Decompresses the data in \var{string}, returning a string containing
-the uncompressed data.  Raises the \code{zlib.error} exception if any
+the uncompressed data.  Raises the \exception{zlib.error} exception if any
 error occurs.
 \end{funcdesc}
 
@@ -69,14 +70,14 @@ Compression objects support the following methods:
 Compress \var{string}, returning a string containing compressed data
 for at least part of the data in \var{string}.  This data should be
 concatenated to the output produced by any preceding calls to the
-\code{compress()} method.  Some input may be kept in internal buffers
+\method{compress()} method.  Some input may be kept in internal buffers
 for later processing.
 \end{funcdesc}
 
 \begin{funcdesc}{flush}{}
 All pending input is processed, and an string containing the remaining
-compressed output is returned.  After calling \code{flush()}, the
-\code{compress()} method cannot be called again; the only realistic
+compressed output is returned.  After calling \method{flush()}, the
+\method{compress()} method cannot be called again; the only realistic
 action is to delete the object.
 \end{funcdesc}
 
@@ -87,14 +88,14 @@ Decompress \var{string}, returning a string containing the
 uncompressed data corresponding to at least part of the data in
 \var{string}.  This data should be concatenated to the output produced
 by any preceding calls to the
-\code{decompress()} method.  Some of the input data may be preserved
+\method{decompress()} method.  Some of the input data may be preserved
 in internal buffers for later processing.
 \end{funcdesc}
 
 \begin{funcdesc}{flush}{}
 All pending input is processed, and a string containing the remaining
-uncompressed output is returned.  After calling \code{flush()}, the
-\code{decompress()} method cannot be called again; the only realistic
+uncompressed output is returned.  After calling \method{flush()}, the
+\method{decompress()} method cannot be called again; the only realistic
 action is to delete the object.
 \end{funcdesc}