diff options
author | June McEnroe <june@causal.agency> | 2018-11-09 14:30:03 -0500 |
---|---|---|
committer | June McEnroe <june@causal.agency> | 2018-11-09 14:30:03 -0500 |
commit | b9eb3d6f23df0669e7dccda38fac58c991284607 (patch) | |
tree | 80b0a784f226eb09267981303b326d220aed52b1 | |
parent | Add FreeBSD Makefile (diff) | |
download | zlib-man-pages-b9eb3d6f23df0669e7dccda38fac58c991284607.tar.gz zlib-man-pages-b9eb3d6f23df0669e7dccda38fac58c991284607.zip |
Use Pq/Po/Pc more
-rw-r--r-- | adler32.3 | 3 | ||||
-rw-r--r-- | deflate.3 | 29 | ||||
-rw-r--r-- | uncompress.3 | 6 |
3 files changed, 23 insertions, 15 deletions
diff --git a/adler32.3 b/adler32.3 index bf03a7b..061edce 100644 --- a/adler32.3 +++ b/adler32.3 @@ -72,8 +72,7 @@ and Note that the .Vt z_off_t type -(like -.Vt off_t ) +.Pq like Vt off_t is a signed integer. If .Fa len2 diff --git a/deflate.3 b/deflate.3 index b3b498b..f25b78e 100644 --- a/deflate.3 +++ b/deflate.3 @@ -51,7 +51,7 @@ or between 0 and 9: 1 gives best speed, 9 gives best compression, 0 gives no compression at all -(the input data is sumply copied a block at a time). +(the input data is simply copied a block at a time). .Dv Z_DEFAULT_COMPRESSION requests a default compromise between speed and compression (currently equivalent to level 6). @@ -161,10 +161,12 @@ is set to all pending output is flushed to the output buffer and the output is aligned on a byte boundary, so that the decompressor can get all input data available so far. -(In particular +.Po +In particular .Fa avail_in is zero after the call if enough output space -has been provided before the call.) +has been provided before the call. +.Pc Flushing may degrade compression for some compression algorithms and so it should be used only when necessary. This completes the current deflate block @@ -279,8 +281,7 @@ or this function must be called again with .Dv Z_FINISH and more output space -(updated -.Fa avail_out ) +.Pq updated Fa avail_out but no more input data, until it returns with .Dv Z_STREAM_END @@ -321,9 +322,11 @@ sets .Fa strm->adler to the Adler-32 checksum of all input read so far -(that is, +.Po +that is, .Fa total_in -bytes). +bytes +.Pc . If a gzip stream is being generated, then .Fa strm->adler @@ -392,22 +395,26 @@ is set to .Pc , .Dv Z_STREAM_ERROR if the stream state was inconsistent -(for example if +.Po +for example if .Fa next_in or .Fa next_out was .Dv Z_NULL or the state was inadvertently written over -by the application), +by the application +.Pc , or .Dv Z_BUF_ERROR if no progress is possible -(for example +.Po +for example .Fa avail_in or .Fa avail_out -was zero). +was zero +.Pc . Note that .Dv Z_BUF_ERROR is not fatal, diff --git a/uncompress.3 b/uncompress.3 index 04a082a..1b7c11a 100644 --- a/uncompress.3 +++ b/uncompress.3 @@ -37,10 +37,12 @@ Upon entry, .Fa destLen is the total size of the destination buffer, which must be large enough to hold the entire uncompressed data. -(The size of the uncompressed data +.Po +The size of the uncompressed data must have been saved previously by the compressor and transmitted to the decompressor -by some mechanism outside the scope of this compression library.) +by some mechanism outside the scope of this compression library. +.Pc Upon exit, .Fa destLen is the actual size of the uncompressed data. |