Made improvements based on changes just made and comments from

Bernhard Reiter <bernhard@csd.uwm.edu>.
This commit is contained in:
Fred Drake 1999-04-05 19:00:54 +00:00
parent fa1591c129
commit 1dc3a501a6
1 changed files with 11 additions and 6 deletions

View File

@ -11,7 +11,10 @@ with that used by the GNU compression program \program{gzip}.
Accordingly, the \module{gzip} module provides the \class{GzipFile}
class to read and write \program{gzip}-format files, automatically
compressing or decompressing the data so it looks like an ordinary
file object.
file object. Note that additional file formats which can be
decompressed by the \program{gzip} and \program{gunzip} programs, such
as those produced by \program{compress} and \program{pack}, are not
supported by this module.
The module defines the following items:
@ -34,10 +37,12 @@ to the filename of \var{fileobj}, if discernible; otherwise, it
defaults to the empty string, and in this case the original filename
is not included in the header.
The \var{mode} argument can be either \code{'r'} or \code{'w'},
depending on whether the file will be read or written. The default is
the mode of \var{fileobj} if discernible; otherwise, the default is
\code{'r'}.
The \var{mode} argument can be any of \code{'r'}, \code{'rb'},
\code{'a'}, \code{'ab'}, \code{'w'}, or \code{'wb'}, depending on
whether the file will be read or written. The default is the mode of
\var{fileobj} if discernible; otherwise, the default is \code{'rb'}.
Be aware that only the \code{'rb'}, \code{'ab'}, and \code{'wb'}
values should be used for cross-platform portability.
The \var{compresslevel} argument is an integer from \code{1} to
\code{9} controlling the level of compression; \code{1} is fastest and
@ -55,7 +60,7 @@ object's \method{getvalue()} method.
\begin{funcdesc}{open}{filename\optional{, mode\optional{, compresslevel}}}
This is a shorthand for \code{GzipFile(\var{filename},}
\code{\var{mode},} \code{\var{compresslevel})}. The \var{filename}
argument is required; \var{mode} defaults to \code{'r'} and
argument is required; \var{mode} defaults to \code{'rb'} and
\var{compresslevel} defaults to \code{9}.
\end{funcdesc}