Subject: misc/23674: man2mdoc - patches for upgrading gzip man pages
To: None <gnats-bugs@gnats.netbsd.org>
From: None <sobrado@string1.ciencias.uniovi.es>
List: netbsd-bugs
Date: 12/06/2003 17:48:31
>Number: 23674
>Category: misc
>Synopsis: man2mdoc - patches for upgrading gzip man pages
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: misc-bug-people
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Sat Dec 06 16:49:00 UTC 2003
>Closed-Date:
>Last-Modified:
>Originator: Igor Sobrado
>Release: NetBSD 1.6.1
>Organization:
University of Oviedo
>Environment:
System: NetBSD ns1.v6.x0.priv 1.6.1 NetBSD 1.6.1 (GENERIC_LAPTOP) #0: Tue Apr 8 12:21:37 UTC 2003 autobuild@tgm.daemon.org:/autobuild/netbsd-1-6/i386/OBJ/autobuild/netbsd-1-6/src/sys/arch/i386/compile/GENERIC_LAPTOP i386
Architecture: i386
Machine: i386
>Description:
This is a set of patches developed as a part of our project of
porting the Unix (-man) pages to the new BSD macros (-mdoc).
Information about the project status can be found at:
http://condmat1.ciencias.uniovi.es/~sobrado/man2mdoc.html
I have introduced some changes non related with porting the man
pages source to the BSD macros. A description of these changes:
gzip(1) - the line:
file: already has .gz suffix -- no change
has been changed to:
file: already has .suf suffix -- unchanged
because both (1) gzip accepts other extensions when identifying
previously compressed files, for example:
$ cat > test.txt
I will rename this file before compressing
^D
$ mv test.txt test.txt.Z (now it looks as a compressed file)
$ gzip test.txt.Z
gzip: test.txt.Z already has .Z suffix -- unchanged
and (2) gzip now returns "unchanged" instead of "no change".
On the other hand, strings(1) shows that the suffix
returned by gzip is not hardcoded:
$ strings /usr/bin/gzip | grep "already has"
%s: %s already has %s suffix -- unchanged
zdiff(1) - changed "If only 1 file is specified" to "If only one
file is specified". I am not a native english speaker, but
I believe that it is a good improvement.
>How-To-Repeat:
Looking at the man pages. IMHO, the BSD macros are better.
>Fix:
*** patch for gzexe(1)
--- gzexe.1 Thu Dec 4 17:45:07 2003
+++ gzexe.1.mdoc Sat Dec 6 10:35:44 2003
@@ -1,44 +1,64 @@
-.\" $Id: gzexe.1,v 1.3 1993/10/15 23:05:35 jtc Exp $
-.TH GZEXE 1
-.SH NAME
-gzexe \- compress executable files in place
-.SH SYNOPSIS
-.B gzexe
-[ name ... ]
-.SH DESCRIPTION
+.\" $Id: gzexe.1,v 1.3 1993/10/15 23:05:35 jtc Exp $
+.Dd June 16, 1993
+.Dt GZEXE 1
+.Os
+.Sh NAME
+.Nm gzexe
+.Nd compress executable files in place
+.Sh SYNOPSIS
+.Nm
+.Op Ar name ...
+.Sh DESCRIPTION
The
-.I gzexe
+.Nm
utility allows you to compress executables in place and have them
automatically uncompress and execute when you run them (at a penalty
-in performance). For example if you execute ``gzexe /bin/cat'' it
-will create the following two files:
-.nf
-.br
- -r-xr-xr-x 1 root bin 9644 Feb 11 11:16 /bin/cat
- -r-xr-xr-x 1 bin bin 24576 Nov 23 13:21 /bin/cat~
-.fi
-/bin/cat~ is the original file and /bin/cat is the self-uncompressing
-executable file. You can remove /bin/cat~ once you are sure that
-/bin/cat works properly.
-.PP
+in performance). For example if you execute
+.Do
+gzexe /bin/cat
+.Dc
+it will create the following two files:
+.Bd -literal -offset indent
+-r-xr-xr-x 1 root bin 9644 Feb 11 11:16 /bin/cat
+-r-xr-xr-x 1 bin bin 24576 Nov 23 13:21 /bin/cat~
+.Ed
+.Pp
+.Pa /bin/cat~
+is the original file and
+.Pa /bin/cat
+is the self-uncompressing executable file. You can remove
+.Pa /bin/cat~
+once you are sure that
+.Pa /bin/cat
+works properly.
+.Pp
This utility is most useful on systems with very small disks.
-.SH OPTIONS
-.TP
-.B \-d
+.Sh OPTIONS
+.Bl -tag -width flag
+.It Fl d
Decompress the given executables instead of compressing them.
-.SH "SEE ALSO"
-gzip(1), znew(1), zmore(1), zcmp(1), zforce(1)
-.SH CAVEATS
-The compressed executable is a shell script. This may create some
-security holes. In particular, the compressed executable relies
-on the PATH environment variable to find
-.I gzip
+.El
+.Sh SEE ALSO
+.Xr gzip 1 ,
+.Xr znew 1 ,
+.Xr zmore 1 ,
+.Xr zcmp 1 ,
+.Xr zforce 1
+.Sh CAVEATS
+The compressed executable is a shell script. This may create some
+security holes. In particular, the compressed executable relies on the
+.Ev PATH
+environment variable to find
+.Nm gzip
and some other utilities
-.I (tail, chmod, ln, sleep).
-.SH "BUGS"
-.I gzexe
+.Nm ( tail ,
+.Nm chmod ,
+.Nm ln ,
+.Nm sleep ) .
+.Sh BUGS
+.Nm
attempts to retain the original file attributes on the compressed executable,
but you may have to fix them manually in some cases, using
-.I chmod
+.Nm chmod
or
-.I chown.
+.Nm chown .
*** patch for gzip(1)
--- gzip.1 Tue Dec 2 21:44:15 2003
+++ gzip.1.mdoc Sat Dec 6 10:55:43 2003
@@ -1,478 +1,577 @@
.\" $Id: gzip.1,v 1.9 2003/03/30 20:55:47 wiz Exp $
-.PU
-.TH GZIP 1
-.SH NAME
-gzip, gunzip, gzcat, zcat \- compress or expand files
-.SH SYNOPSIS
-.ll +8
-.B gzip
-.RB [ " \-acdfhlLnNrtvV19 " ]
-.RB [ \-S\ suffix ]
-[
-.I "name \&..."
-]
-.ll -8
-.br
-.B gunzip
-.RB [ " \-acfhlLnNrtvV " ]
-.RB [ \-S\ suffix ]
-[
-.I "name \&..."
-]
-.br
-.B zcat
-.RB [ " \-fhLV " ]
-[
-.I "name \&..."
-]
-.SH DESCRIPTION
-.I Gzip
+.Dd August 18, 1993
+.Dt GZIP 1
+.Os
+.Sh NAME
+.Nm gzip ,
+.Nm gunzip ,
+.Nm gzcat ,
+.Nm zcat
+.Nd compress or expand files
+.Sh SYNOPSIS
+.Nm
+.Op Fl acdfhlLnNrtvV19
+.Op Fl S Ar suffix
+.Op Ar name ...
+.Nm gunzip
+.Op Fl acfhlLnNrtvV
+.Op Fl S Ar suffix
+.Op Ar name ...
+.Nm zcat
+.Op Fl fhLV
+.Op Ar name ...
+.Sh DESCRIPTION
+.Nm
reduces the size of the named files using Lempel-Ziv coding (LZ77).
-Whenever possible,
-each file is replaced by one with the extension
-.B "\&.gz,"
+Whenever possible, each file is replaced by one with the extension
+.Pa .gz ,
while keeping the same ownership modes, access and modification times.
(The default extension is
-.B "\-gz"
+.Pa -gz
for VMS,
-.B "z"
-for MSDOS, OS/2 FAT, Windows NT FAT and Atari.)
-If no files are specified, or if a file name is "-", the standard input is
-compressed to the standard output.
-.I Gzip
-will only attempt to compress regular files.
-In particular, it will ignore symbolic links.
-.PP
+.Pa z
+for MSDOS, OS/2 FAT, Windows NT FAT and Atari.) If no files are specified, or
+if a file name is
+.Do
+-
+.Dc ,
+the standard input is compressed to the standard output.
+.Nm
+will only attempt to compress regular files. In particular, it will ignore
+symbolic links.
+.Pp
If the compressed file name is too long for its file system,
-.I gzip
+.Nm
truncates it.
-.I Gzip
+.Nm
attempts to truncate only the parts of the file name longer than 3 characters.
-(A part is delimited by dots.) If the name consists of small parts only,
-the longest parts are truncated. For example, if file names are limited
-to 14 characters, gzip.msdos.exe is compressed to gzi.msd.exe.gz.
+(A part is delimited by dots.) If the name consists of small parts only,
+the longest parts are truncated. For example, if file names are limited
+to 14 characters,
+.Pa gzip.msdos.exe
+is compressed to
+.Pa gzi.msd.exe.gz .
Names are not truncated on systems which do not have a limit on file name
length.
-.PP
+.Pp
By default,
-.I gzip
-keeps the original file name and timestamp in the compressed file. These
+.Nm
+keeps the original file name and timestamp in the compressed file. These
are used when decompressing the file with the
-.B \-N
-option. This is useful when the compressed file name was truncated or
+.Fl N
+option. This is useful when the compressed file name was truncated or
when the time stamp was not preserved after a file transfer.
-.PP
+.Pp
Compressed files can be restored to their original form using
-.I gzip -d
+.Nm
+.Fl d
or
-.I gunzip
+.Nm gunzip
or
-.I zcat.
+.Nm zcat .
If the original name saved in the compressed file is not suitable for its
file system, a new name is constructed from the original one to make it
legal.
-.PP
-.I gunzip
-takes a list of files on its command line and replaces each
-file whose name ends with .gz, -gz, .z, -z, _z or .Z
+.Pp
+.Nm gunzip
+takes a list of files on its command line and replaces each file whose name
+ends with
+.Pa .gz ,
+.Pa -gz ,
+.Pa .z ,
+.Pa -z ,
+.Pa _z
+or
+.Pa .Z
and which begins with the correct magic number with an uncompressed
file without the original extension.
-.I gunzip
+.Nm gunzip
also recognizes the special extensions
-.B "\&.tgz"
+.Pa .tgz
and
-.B "\&.taz"
+.Pa .taz
as shorthands for
-.B "\&.tar.gz"
+.Pa .tar.gz
and
-.B "\&.tar.Z"
-respectively.
-When compressing,
-.I gzip
+.Pa .tar.Z
+respectively. When compressing,
+.Nm
uses the
-.B "\&.tgz"
+.Pa .tgz
extension if necessary instead of truncating a file with a
-.B "\&.tar"
+.Pa .tar
extension.
-.PP
-.I gunzip
+.Pp
+.Nm gunzip
can currently decompress files created by
-.I gzip, zip, bzip2, compress, compress -H
+.Nm ,
+.Nm zip ,
+.Nm bzip2 ,
+.Nm compress ,
+.Nm compress
+.Fl H
or
-.I pack.
-The detection of the input format is automatic. When using
-the first three formats,
-.I gunzip
-checks a 32 bit CRC. For
-.I pack, gunzip
-checks the uncompressed length. The standard
-.I compress
-format was not designed to allow consistency checks. However
-.I gunzip
-is sometimes able to detect a bad .Z file. If you get an error
-when uncompressing a .Z file, do not assume that the .Z file is
-correct simply because the standard
-.I uncompress
-does not complain. This generally means that the standard
-.I uncompress
-does not check its input, and happily generates garbage output.
-The SCO compress -H format (lzh compression method) does not include a CRC
-but also allows some consistency checks.
-.PP
+.Nm pack .
+The detection of the input format is automatic. When using the first three
+formats,
+.Nm gunzip
+checks a 32 bit CRC. For
+.Nm pack ,
+.Nm gunzip
+checks the uncompressed length. The standard
+.Nm compress
+format was not designed to allow consistency checks. However
+.Nm gunzip
+is sometimes able to detect a bad
+.Pa .Z
+file. If you get an error when uncompressing a
+.Pa .Z
+file, do not assume that the
+.Pa .Z
+file is correct simply because the standard
+.Nm uncompress
+does not complain. This generally means that the standard
+.Nm uncompress
+does not check its input, and happily generates garbage output. The SCO
+.Nm compress
+.Fl H
+format (lzh compression method) does not include a CRC but also allows some
+consistency checks.
+.Pp
Files created by
-.I zip
-can be uncompressed by gzip only if they have a single member compressed
-with the 'deflation' method. This feature is only intended to help
-conversion of tar.zip files to the tar.gz format. To extract zip files
-with several members, use
-.I unzip
+.Nm zip
+can be uncompressed by
+.Nm
+only if they have a single member compressed with the
+.So
+deflation
+.Sc
+method. This feature is only intended to help conversion of
+.Pa tar.zip
+files to the
+.Pa tar.gz
+format. To extract zip files with several members, use
+.Nm unzip
instead of
-.I gunzip.
-.PP
-.I zcat
+.Nm gunzip .
+.Pp
+.Nm zcat
is identical to
-.I gunzip
-.B \-c.
+.Nm gunzip
+.Fl c .
(On some systems,
-.I zcat
+.Nm zcat
may be installed as
-.I gzcat
+.Nm gzcat
to preserve the original link to
-.I compress.)
-.I zcat
+.Nm compress . )
+.Nm zcat
uncompresses either a list of files on the command line or its
standard input and writes the uncompressed data on standard output.
-.I zcat
-will uncompress files that have the correct magic number whether
-they have a
-.B "\&.gz"
+.Nm zcat
+will uncompress files that have the correct magic number whether they have a
+.Pa .gz
suffix or not.
-.PP
-.I Gzip
+.Pp
+.Nm
uses the Lempel-Ziv algorithm used in
-.I zip
-and PKZIP.
-The amount of compression obtained depends on the size of the
-input and the distribution of common substrings.
-Typically, text such as source code or English
-is reduced by 60\-70%.
-Compression is generally much better than that achieved by
-LZW (as used in
-.IR compress ),
+.Nm zip
+and
+.Nm PKZIP .
+The amount of compression obtained depends on the size of the input and the
+distribution of common substrings. Typically, text such as source code or
+English is reduced by 60\-70%. Compression is generally much better than
+that achieved by LZW (as used in
+.Nm compress ) ,
Huffman coding (as used in
-.IR pack ),
+.Nm pack ) ,
or adaptive Huffman coding
-.RI ( compact ).
-.PP
+.Nm ( compact ) .
+.Pp
Compression is always performed, even if the compressed file is
-slightly larger than the original. The worst case expansion is
+slightly larger than the original. The worst case expansion is
a few bytes for the gzip file header, plus 5 bytes every 32K block,
-or an expansion ratio of 0.015% for large files. Note that the actual
+or an expansion ratio of 0.015% for large files. Note that the actual
number of used disk blocks almost never increases.
-.I gzip
+.Nm
preserves the mode, ownership and timestamps of files when compressing
or decompressing.
-.SH OPTIONS
-.TP
-.B \-a --ascii
-Ascii text mode: convert end-of-lines using local conventions. This option
-is supported only on some non-Unix systems. For MSDOS, CR LF is converted
+.Sh OPTIONS
+.Bl -tag -width flag
+.It Fl a -ascii
+ASCII text mode: convert end-of-lines using local conventions. This option
+is supported only on some non-Unix systems. For MSDOS, CR LF is converted
to LF when compressing, and LF is converted to CR LF when decompressing.
-.TP
-.B \-c --stdout --to-stdout
+.It Fl c -stdout -to-stdout
Write output on standard output; keep original files unchanged.
If there are several input files, the output consists of a sequence of
-independently compressed members. To obtain better compression,
+independently compressed members. To obtain better compression,
concatenate all input files before compressing them.
-.TP
-.B \-d --decompress --uncompress
+.It Fl d -decompress -uncompress
Decompress.
-.TP
-.B \-f --force
+.It Fl f -force
Force compression or decompression even if the file has multiple links
or the corresponding file already exists, or if the compressed data
-is read from or written to a terminal. If the input data is not in
+is read from or written to a terminal. If the input data is not in
a format recognized by
-.I gzip,
-and if the option --stdout is also given, copy the input data without change
-to the standard output: let
-.I zcat
+.Nm ,
+and if the option
+.Fl -stdout
+is also given, copy the input data without change to the standard output: let
+.Nm zcat
behave as
-.I cat.
+.Nm cat .
If
-.B \-f
-is not given,
-and when not running in the background,
-.I gzip
+.Fl f
+is not given, and when not running in the background,
+.Nm
prompts to verify whether an existing file should be overwritten.
-.TP
-.B \-h --help
+.It Fl h -help
Display a help screen and quit.
-.TP
-.B \-l --list
+.It Fl l -list
For each compressed file, list the following fields:
-
- compressed size: size of the compressed file
- uncompressed size: size of the uncompressed file
- ratio: compression ratio (0.0% if unknown)
- uncompressed_name: name of the uncompressed file
-
-The uncompressed size is given as -1 for files not in gzip format,
-such as compressed .Z files. To get the uncompressed size for such a file,
-you can use:
-
- zcat file.Z | wc -c
-
-In combination with the --verbose option, the following fields are also
-displayed:
-
- method: compression method
- crc: the 32-bit CRC of the uncompressed data
- date \*[Am] time: time stamp for the uncompressed file
-
-The compression methods currently supported are deflate, compress, lzh
-(SCO compress -H) and pack. The crc is given as ffffffff for a file
-not in gzip format.
-
-With --name, the uncompressed name, date and time are
-those stored within the compress file if present.
-
-With --verbose, the size totals and compression ratio for all files
-is also displayed, unless some sizes are unknown. With --quiet,
+.Bd -literal -offset indent
+compressed size: size of the compressed file
+uncompressed size: size of the uncompressed file
+ratio: compression ratio (0.0% if unknown)
+uncompressed_name: name of the uncompressed file
+.Ed
+.Pp
+The uncompressed size is given as -1 for files not in
+.Nm
+format, such as compressed
+.Pa .Z
+files. To get the uncompressed size for such a file, you can use:
+.Bd -literal -offset indent
+zcat file.Z | wc -c
+.Ed
+.Pp
+In combination with the
+.Fl -verbose
+option, the following fields are also displayed:
+.Bd -literal -offset indent
+method: compression method
+crc: the 32-bit CRC of the uncompressed data
+date \*[Am] time: time stamp for the uncompressed file
+.Ed
+.Pp
+The compression methods currently supported are deflate, compress, lzh (SCO
+.Nm compress
+.Fl H )
+and
+.Nm pack .
+The crc is given as ffffffff for a file not in
+.Nm
+format.
+
+With
+.Fl -name ,
+the uncompressed name, date and time are those stored within the compress
+file if present.
+
+With
+.Fl -verbose ,
+the size totals and compression ratio for all files is also displayed, unless
+some sizes are unknown. With
+.Fl -quiet ,
the title and totals lines are not displayed.
-.TP
-.B \-L --license
+.It Fl L -license
Display the
-.I gzip
+.Nm
license and quit.
-.TP
-.B \-n --no-name
+.It Fl n -no-name
When compressing, do not save the original file name and time stamp by
-default. (The original name is always saved if the name had to be
-truncated.) When decompressing, do not restore the original file name
+default. (The original name is always saved if the name had to be
+truncated.) When decompressing, do not restore the original file name
if present (remove only the
-.I gzip
+.Nm
suffix from the compressed file name) and do not restore the original
-time stamp if present (copy it from the compressed file). This option
+time stamp if present (copy it from the compressed file). This option
is the default when decompressing.
-.TP
-.B \-N --name
+.It Fl N -name
When compressing, always save the original file name and time stamp; this
-is the default. When decompressing, restore the original file name and
-time stamp if present. This option is useful on systems which have
+is the default. When decompressing, restore the original file name and
+time stamp if present. This option is useful on systems which have
a limit on file name length or when the time stamp has been lost after
a file transfer.
-.TP
-.B \-q --quiet
+.It Fl q -quiet
Suppress all warnings.
-.TP
-.B \-r --recursive
-Travel the directory structure recursively. If any of the file names
+.It Fl r -recursive
+Travel the directory structure recursively. If any of the file names
specified on the command line are directories,
-.I gzip
+.Nm
will descend into the directory and compress all the files it finds there
(or decompress them in the case of
-.I gunzip
-).
-.TP
-.B \-S .suf --suffix .suf
-Use suffix .suf instead of .gz. Any suffix can be given, but suffixes
-other than .z and .gz should be avoided to avoid confusion when files
-are transferred to other systems. A null suffix forces gunzip to try
-decompression on all given files regardless of suffix, as in:
-
- gunzip -S "" * (*.* for MSDOS)
-
-Previous versions of gzip used
-the .z suffix. This was changed to avoid a conflict with
-.IR pack "(1)".
-.TP
-.B \-t --test
-Test. Check the compressed file integrity.
-.TP
-.B \-v --verbose
-Verbose. Display the name and percentage reduction for each file compressed
+.Nm gunzip ) .
+.It Fl S Pa .suf Fl -suffix Pa .suf
+Use suffix
+.Pa .suf
+instead of
+.Pa .gz .
+Any suffix can be given, but suffixes other than
+.Pa .z
+and
+.Pa .gz
+should be avoided to avoid confusion when files are transferred to other
+systems. A null suffix forces
+.Nm gunzip
+to try decompression on all given files regardless of suffix, as in:
+.Bd -literal -offset indent
+gunzip -S "" * (*.* for MSDOS)
+.Ed
+.Pp
+Previous versions of
+.Nm
+used the
+.Pa .z
+suffix. This was changed to avoid a conflict with
+.Xr pack 1 .
+.It Fl t -test
+Test. Check the compressed file integrity.
+.It Fl v -verbose
+Verbose. Display the name and percentage reduction for each file compressed
or decompressed.
-.TP
-.B \-V --version
-Version. Display the version number and compilation options then quit.
-.TP
-.B \-# --fast --best
+.It Fl V -version
+Version. Display the version number and compilation options then quit.
+.It Fl Ar # Fl -fast -best
Regulate the speed of compression using the specified digit
-.IR # ,
+.Ar # ,
where
-.B \-1
+.Fl 1
or
-.B \-\-fast
-indicates the fastest compression method (less compression)
-and
-.B \-9
+.Fl -fast
+indicates the fastest compression method (less compression) and
+.Fl 9
or
-.B \-\-best
-indicates the slowest compression method (best compression).
-The default compression level is
-.BR \-6
+.Fl -best
+indicates the slowest compression method (best compression). The default
+compression level is
+.Fl 6
(that is, biased towards high compression at expense of speed).
-.SH "ADVANCED USAGE"
-Multiple compressed files can be concatenated. In this case,
-.I gunzip
-will extract all members at once. For example:
-
- gzip -c file1 \*[Gt] foo.gz
- gzip -c file2 \*[Gt]\*[Gt] foo.gz
-
+.El
+.Sh ADVANCED USAGE
+Multiple compressed files can be concatenated. In this case,
+.Nm gunzip
+will extract all members at once. For example:
+.Bd -literal -offset indent
+gzip -c file1 \*[Gt] foo.gz
+gzip -c file2 \*[Gt]\*[Gt] foo.gz
+.Ed
+.Pp
Then
- gunzip -c foo
-
+.Bd -literal -offset indent
+gunzip -c foo
+.Ed
+.Pp
is equivalent to
-
- cat file1 file2
-
-In case of damage to one member of a .gz file, other members can
-still be recovered (if the damaged member is removed). However,
-you can get better compression by compressing all members at once:
-
- cat file1 file2 | gzip \*[Gt] foo.gz
-
+.Bd -literal -offset indent
+cat file1 file2
+.Ed
+.Pp
+In case of damage to one member of a
+.Pa .gz
+file, other members can still be recovered (if the damaged member is
+removed). However, you can get better compression by compressing all members
+at once:
+.Bd -literal -offset indent
+cat file1 file2 | gzip \*[Gt] foo.gz
+.Ed
+.Pp
compresses better than
-
- gzip -c file1 file2 \*[Gt] foo.gz
-
+.Bd -literal -offset indent
+gzip -c file1 file2 \*[Gt] foo.gz
+.Ed
+.Pp
If you want to recompress concatenated files to get better compression, do:
-
- gzip -cd old.gz | gzip \*[Gt] new.gz
-
+.Bd -literal -offset indent
+gzip -cd old.gz | gzip \*[Gt] new.gz
+.Ed
+.Pp
If a compressed file consists of several members, the uncompressed
-size and CRC reported by the --list option applies to the last member
-only. If you need the uncompressed size for all members, you can use:
-
- gzip -cd file.gz | wc -c
-
+size and CRC reported by the
+.Fl -list
+option applies to the last member only. If you need the uncompressed size
+for all members, you can use:
+.Bd -literal -offset indent
+gzip -cd file.gz | wc -c
+.Ed
+.Pp
If you wish to create a single archive file with multiple members so
-that members can later be extracted independently, use an archiver
-such as tar or zip. GNU tar supports the -z option to invoke gzip
-transparently. gzip is designed as a complement to tar, not as a
-replacement.
-.SH "ENVIRONMENT"
+that members can later be extracted independently, use an archiver such as
+.Nm tar
+or
+.Nm zip .
+GNU
+.Nm tar
+supports the
+.Fl z
+option to invoke
+.Nm
+transparently.
+.Nm
+is designed as a complement to
+.Nm tar ,
+not as a replacement.
+.Sh ENVIRONMENT
The environment variable
-.B GZIP
+.Ev GZIP
can hold a set of default options for
-.I gzip.
+.Nm .
These options are interpreted first and can be overwritten by
-explicit command line parameters. For example:
- for sh: GZIP="-8v --name"; export GZIP
- for csh: setenv GZIP "-8v --name"
- for MSDOS: set GZIP=-8v --name
-
-On VAX/VMS, the name of the environment variable is GZIP_OPT, to
-avoid a conflict with the symbol set for invocation of the program.
-.SH "SEE ALSO"
-znew(1), zcmp(1), zmore(1), zforce(1), gzexe(1), zip(1), unzip(1), bzip2(1),
-compress(1), pack(1), compact(1)
-.SH "DIAGNOSTICS"
+explicit command line parameters. For example:
+.Bd -literal -offset indent
+for sh: GZIP="-8v --name"; export GZIP
+for csh: setenv GZIP "-8v --name"
+for MSDOS: set GZIP=-8v --name
+.Ed
+.Pp
+On VAX/VMS, the name of the environment variable is
+.Ev GZIP_OPT ,
+to avoid a conflict with the symbol set for invocation of the program.
+.Sh SEE ALSO
+.Xr znew 1 ,
+.Xr zcmp 1 ,
+.Xr zmore 1 ,
+.Xr zforce 1 ,
+.Xr gzexe 1 ,
+.Xr zip 1 ,
+.Xr unzip 1 ,
+.Xr bzip2 1 ,
+.Xr compress 1 ,
+.Xr pack 1 ,
+.Xr compact 1
+.Sh DIAGNOSTICS
Exit status is normally 0;
-if an error occurs, exit status is 1. If a warning occurs, exit status is 2.
-.PP
-Usage: gzip [-cdfhlLnNrtvV19] [-S suffix] [file ...]
+if an error occurs, exit status is 1. If a warning occurs, exit status is 2.
+.Pp
+usage: gzip [-cdfhlLnNrtvV19] [-S suffix] [file ...]
.in +8
Invalid options were specified on the command line.
.in -8
-.IR file :
+.Ar file :
not in gzip format
.in +8
The file specified to
-.I gunzip
+.Nm gunzip
has not been compressed.
.in -8
-.IR file:
-Corrupt input. Use zcat to recover some data.
+.Ar file :
+corrupt input. Use zcat to recover some data.
.in +8
-The compressed file has been damaged. The data up to the point of failure
+The compressed file has been damaged. The data up to the point of failure
can be recovered using
.in +8
-zcat file \*[Gt] recover
+.Nm zcat
+.Ar file
+\*[Gt]
+.Ar recover
.in -16
-.IR file :
-compressed with
-.I xx
-bits, can only handle
-.I yy
+.Ar file :
+compressed with
+.Ar xx
+bits, can only handle
+.Ar yy
bits
.in +8
-.I File
-was compressed (using LZW) by a program that could deal with
-more
-.I bits
-than the decompress code on this machine.
-Recompress the file with gzip, which compresses better and uses
-less memory.
+.Ar File
+was compressed (using LZW) by a program that could deal with more
+.Ar bits
+than the decompress code on this machine. Recompress the file with
+.Nm ,
+which compresses better and uses less memory.
.in -8
-.IR file :
-already has .gz suffix -- no change
+.Ar file :
+already has
+.Pa .suf
+suffix -- unchanged
.in +8
-The file is assumed to be already compressed.
-Rename the file and try again.
+The file is assumed to be already compressed. Rename the file and try again.
.in -8
-.I file
+.Ar file
already exists; do you wish to overwrite (y or n)?
.in +8
-Respond "y" if you want the output file to be replaced; "n" if not.
+Respond
+.Do y
+.Dc
+if you want the output file to be replaced;
+.Do n
+.Dc
+if not.
.in -8
gunzip: corrupt input
.in +8
-A SIGSEGV violation was detected which usually means that the input file has
+A
+.Dv SIGSEGV
+violation was detected which usually means that the input file has
been corrupted.
.in -8
-.I "xx.x%"
+.Ar xx.x%
.in +8
-Percentage of the input saved by compression.
-(Relevant only for
-.BR \-v
+Percentage of the input saved by compression. (Relevant only for
+.Fl v
and
-.BR \-l \.)
+.Fl l )
.in -8
-- not a regular file or directory: ignored
.in +8
-When the input file is not a regular file or directory,
-(e.g. a symbolic link, socket, FIFO, device file), it is
-left unaltered.
+When the input file is not a regular file or directory, (e.g. a symbolic
+link, socket, FIFO, device file), it is left unaltered.
.in -8
--- has
-.I xx
+-- has
+.Ar xx
other links: unchanged
.in +8
The input file has links; it is left unchanged. See
-.IR ln "(1)"
-for more information. Use the
-.B \-f
+.Xr ln 1
+for more information. Use the
+.Fl f
flag to force compression of multiply-linked files.
.in -8
-.SH CAVEATS
+.Sh CAVEATS
When writing compressed data to a tape, it is generally necessary to
-pad the output with zeroes up to a block boundary. When the data is
+pad the output with zeroes up to a block boundary. When the data is
read and the whole block is passed to
-.I gunzip
+.Nm gunzip
for decompression,
-.I gunzip
+.Nm gunzip
detects that there is extra trailing garbage after the compressed data
-and emits a warning by default. You have to use the --quiet option to
-suppress the warning. This option can be set in the
-.B GZIP
+and emits a warning by default. You have to use the
+.Fl -quiet
+option to
+suppress the warning. This option can be set in the
+.Ev GZIP
environment variable as in:
- for sh: GZIP="-q" tar -xfz --block-compress /dev/rst0
- for csh: (setenv GZIP -q; tar -xfz --block-compr /dev/rst0
-
-In the above example, gzip is invoked implicitly by the -z option of
-GNU tar. Make sure that the same block size (-b option of tar) is used
-for reading and writing compressed data on tapes. (This example
-assumes you are using the GNU version of tar.)
-.SH BUGS
-The --list option reports sizes as -1 and crc as ffffffff if the
+.Bd -literal -offset indent
+for sh: GZIP="-q" tar -xfz --block-compress /dev/rst0
+for csh: (setenv GZIP -q; tar -xfz --block-compr /dev/rst0)
+.Ed
+.Pp
+In the above example,
+.Nm
+is invoked implicitly by the
+.Fl z
+option of
+GNU
+.Nm tar .
+Make sure that the same block size
+.Fl ( b
+option of
+.Nm tar )
+is used for reading and writing compressed data on tapes. (This example
+assumes you are using the GNU version of
+.Nm tar . )
+.Sh BUGS
+The
+.Fl -list
+option reports sizes as -1 and crc as ffffffff if the
compressed file is on a non seekable media.
-In some rare cases, the --best option gives worse compression than
-the default compression level (-6). On some highly redundant files,
-.I compress
+In some rare cases, the
+.Fl -best
+option gives worse compression than the default compression level
+.Fl ( 6 ) .
+On some highly redundant files,
+.Nm compress
compresses better than
-.I gzip.
+.Nm .
*** patch for zdiff(1)
--- zdiff.1 Sat Dec 6 10:09:55 2003
+++ zdiff.1.mdoc Sat Dec 6 10:17:46 2003
@@ -1,45 +1,57 @@
.\" $Id: zdiff.1,v 1.3 1993/10/15 23:05:58 jtc Exp $
-.TH ZDIFF 1
-.SH NAME
-zcmp, zdiff \- compare compressed files
-.SH SYNOPSIS
-.B zcmp
-[ cmp_options ] file1
-[ file2 ]
-.br
-.B zdiff
-[ diff_options ] file1
-[ file2 ]
-.SH DESCRIPTION
-.I Zcmp
+.Dd June 16, 1993
+.Dt ZDIFF 1
+.Os
+.Sh NAME
+.Nm zcmp ,
+.Nm zdiff
+.Nd compare compressed files
+.Sh SYNOPSIS
+.Nm
+.Op cmp_options
+.Ar file1
+.Op Ar file2
+.Nm zdiff
+.Op diff_options
+.Ar file1
+.Op Ar file2
+.Sh DESCRIPTION
+.Nm
and
-.I zdiff
+.Nm zdiff
are used to invoke the
-.I cmp
+.Nm cmp
or the
-.I diff
+.Nm diff
program on compressed files. All options specified are passed directly to
-.I cmp
+.Nm cmp
or
-.IR diff "."
-If only 1 file is specified, then the files compared are
-.I file1
+.Nm diff .
+If only one file is specified, then the files compared are
+.Ar file1
and an uncompressed
-.IR file1 ".gz."
+.Ar file1 Ns Pa .gz .
If two files are specified, then they are uncompressed if necessary and fed to
-.I cmp
+.Nm cmp
or
-.IR diff "."
+.Nm diff .
The exit status from
-.I cmp
+.Nm cmp
or
-.I diff
+.Nm diff
is preserved.
-.SH "SEE ALSO"
-cmp(1), diff(1), zmore(1), zgrep(1), znew(1), zforce(1), gzip(1), gzexe(1)
-.SH BUGS
+.Sh SEE ALSO
+.Xr cmp 1 ,
+.Xr diff 1 ,
+.Xr zmore 1 ,
+.Xr zgrep 1 ,
+.Xr znew 1 ,
+.Xr zforce 1 ,
+.Xr gzip 1 ,
+.Xr gzexe 1
+.Sh BUGS
Messages from the
-.I cmp
+.Nm cmp
or
-.I diff
+.Nm diff
programs refer to temporary filenames instead of those specified.
*** patch for zforce(1)
--- zforce.1 Thu Dec 4 20:40:00 2003
+++ zforce.1.mdoc Sat Dec 6 11:10:57 2003
@@ -1,21 +1,36 @@
.\" $Id: zforce.1,v 1.3 1993/10/15 23:05:59 jtc Exp $
-.TH ZFORCE 1
-.SH NAME
-zforce \- force a '.gz' extension on all gzip files
-.SH SYNOPSIS
-.B zforce
-[ name ... ]
-.SH DESCRIPTION
-.I zforce
-forces a .gz extension on all
-.I gzip
+.Dd June 16, 1993
+.Dt ZFORCE 1
+.Os
+.Sh NAME
+.Nm zforce
+.Nd force a '.gz' extension on all gzip files
+.Sh SYNOPSIS
+.Nm
+.Op Ar name ...
+.Sh DESCRIPTION
+.Nm
+forces a
+.Pa .gz
+extension on all
+.Nm gzip
files so that
-.I gzip
-will not compress them twice.
-This can be useful for files with names truncated after a file transfer.
-On systems with a 14 char limitation on file names, the original name
-is truncated to make room for the .gz suffix. For example,
-12345678901234 is renamed to 12345678901.gz. A file name such as foo.tgz
+.Nm gzip
+will not compress them twice. This can be useful for files with names
+truncated after a file transfer. On systems with a 14 char limitation on
+file names, the original name is truncated to make room for the
+.Pa .gz
+suffix. For example,
+.Pa 12345678901234
+is renamed to
+.Pa 12345678901.gz .
+A file name such as
+.Pa foo.tgz
is left intact.
-.SH "SEE ALSO"
-gzip(1), znew(1), zmore(1), zgrep(1), zdiff(1), gzexe(1)
+.Sh SEE ALSO
+.Xr gzip 1 ,
+.Xr znew 1 ,
+.Xr zmore 1 ,
+.Xr zgrep 1 ,
+.Xr zdiff 1 ,
+.Xr gzexe 1
*** patch for zgrep(1)
--- zgrep.1 Wed Dec 3 10:02:36 2003
+++ zgrep.1.mdoc Sat Dec 6 11:14:17 2003
@@ -1,45 +1,60 @@
.\" $Id: zgrep.1,v 1.3 1993/10/15 23:06:00 jtc Exp $
-.TH ZGREP 1
-.SH NAME
-zgrep \- search possibly compressed files for a regular expression
-.SH SYNOPSIS
-.B zgrep
-[ grep_options ]
-.BI [\ -e\ ] " pattern"
-.IR filename ".\|.\|."
-.SH DESCRIPTION
-.IR Zgrep
+.Dd June 16, 1993
+.Dt ZGREP 1
+.Os
+.Sh NAME
+.Nm zgrep
+.Nd search possibly compressed files for a regular expression
+.Sh SYNOPSIS
+.Nm
+.Op grep_options
+.Op Fl e
+.Ar pattern
+.Ar filename ...
+.Sh DESCRIPTION
+.Nm
is used to invoke the
-.I grep
-on compress'ed or gzip'ed files. All options specified are passed directly to
-.I grep.
-If no file is specified, then the standard input is decompressed
-if necessary and fed to grep.
-Otherwise the given files are uncompressed if necessary and fed to
-.I grep.
-.PP
+.Nm grep
+on compress'ed or gzip'ed files. All options specified are passed directly to
+.Nm grep .
+If no file is specified, then the standard input is decompressed if necessary
+and fed to grep. Otherwise the given files are uncompressed if necessary and
+fed to
+.Nm grep .
+.Pp
If
-.I zgrep
+.Nm
is invoked as
-.I zegrep
+.Nm zegrep
or
-.I zfgrep
+.Nm zfgrep
then
-.I egrep
+.Nm egrep
or
-.I fgrep
+.Nm fgrep
is used instead of
-.I grep.
-If the GREP environment variable is set,
-.I zgrep
+.Nm grep .
+If the
+.Ev GREP
+environment variable is set,
+.Nm
uses it as the
-.I grep
-program to be invoked. For example:
-
- for sh: GREP=fgrep zgrep string files
- for csh: (setenv GREP fgrep; zgrep string files)
-.SH AUTHOR
+.Nm grep
+program to be invoked. For example:
+.Bd -literal -offset indent
+for sh: GREP=fgrep zgrep string files
+for csh: (setenv GREP fgrep; zgrep string files)
+.Ed
+.Pp
+.Sh AUTHOR
Charles Levert (charles@comm.polymtl.ca)
-.SH "SEE ALSO"
-grep(1), egrep(1), fgrep(1), zdiff(1), zmore(1), znew(1), zforce(1),
-gzip(1), gzexe(1)
+.Sh SEE ALSO
+.Xr grep 1 ,
+.Xr egrep 1 ,
+.Xr fgrep 1 ,
+.Xr zdiff 1 ,
+.Xr zmore 1 ,
+.Xr znew 1 ,
+.Xr zforce 1 ,
+.Xr gzip 1 ,
+.Xr gzexe 1
*** patch for zmore(1)
--- zmore.1 Thu Dec 4 17:59:39 2003
+++ zmore.1.mdoc Sat Dec 6 11:27:42 2003
@@ -1,146 +1,178 @@
.\" $Id: zmore.1,v 1.5 2002/02/08 01:26:50 ross Exp $
-.TH ZMORE 1
-.SH NAME
-zmore \- file perusal filter for crt viewing of compressed text
-.SH SYNOPSIS
-.B zmore
-[ name ... ]
-.SH DESCRIPTION
-.I Zmore
+.Dd June 16, 1993
+.Dt ZMORE 1
+.Os
+.Sh NAME
+.Nm zmore
+.Nd file perusal filter for crt viewing of compressed text
+.Sh SYNOPSIS
+.Nm
+.Op Ar name ...
+.Sh DESCRIPTION
+.Nm
is a filter which allows examination of compressed or plain text files
one screenful at a time on a soft-copy terminal.
-.I zmore
+.Nm
works on files compressed with
-.I compress, pack
+.Nm compress ,
+.Nm pack
or
-.I gzip,
-and also on uncompressed files.
-If a file does not exist,
-.I zmore
-looks for a file of the same name with the addition of a .gz, .z or .Z suffix.
-.PP
-.I Zmore
-normally pauses after each screenful, printing --More--
-at the bottom of the screen.
-If the user then types a carriage return, one more line is displayed.
-If the user hits a space,
-another screenful is displayed. Other possibilities are enumerated later.
-.PP
-.I Zmore
+.Nm gzip ,
+and also on uncompressed files. If a file does not exist,
+.Nm
+looks for a file of the same name with the addition of a
+.Pa .gz ,
+.Pa .z
+or
+.Pa .Z
+suffix.
+.Pp
+.Nm
+normally pauses after each screenful, printing
+.Li --More--
+at the bottom of the screen. If the user then types a carriage return, one
+more line is displayed. If the user hits a space, another screenful is
+displayed. Other possibilities are enumerated later.
+.Pp
+.Nm
looks in the file
-.I /usr/share/misc/termcap
-to determine terminal characteristics,
-and to determine the default window size.
-On a terminal capable of displaying 24 lines,
-the default window size is 22 lines.
-To use a pager other than the default
-.I more,
-set environment variable PAGER to the name of the desired program, such as
-.I less.
-.PP
+.Pa /usr/share/misc/termcap
+to determine terminal characteristics, and to determine the default window
+size. On a terminal capable of displaying 24 lines, the default window size
+is 22 lines. To use a pager other than the default
+.Nm more ,
+set environment variable
+.Ev PAGER
+to the name of the desired program, such as
+.Nm less .
+.Pp
Other sequences which may be typed when
-.I zmore
-pauses, and their effects, are as follows (\fIi\fP is an optional integer
-argument, defaulting to 1) :
-.PP
-.IP \fIi\|\fP\*[Lt]space\*[Gt]
+.Nm
+pauses, and their effects, are as follows
+.Ar ( i
+is an optional integer argument, defaulting to 1):
+.Bl -tag -width "!command"
+.It Ar i Ns \*[Lt]space\*[Gt]
display
-.I i
+.Ar i
more lines, (or another screenful if no argument is given)
-.PP
-.IP ^D
-display 11 more lines (a ``scroll'').
+.It ^D
+display 11 more lines (a
+.Do
+scroll
+.Dc ) .
If
-.I i
-is given, then the scroll size is set to \fIi\|\fP.
-.PP
-.IP d
+.Ar i
+is given, then the scroll size is set to
+.Ar i .
+.It d
same as ^D (control-D)
-.PP
-.IP \fIi\|\fPz
-same as typing a space except that \fIi\|\fP, if present, becomes the new
-window size. Note that the window size reverts back to the default at the
-end of the current file.
-.PP
-.IP \fIi\|\fPs
-skip \fIi\|\fP lines and print a screenful of lines
-.PP
-.IP \fIi\|\fPf
-skip \fIi\fP screenfuls and print a screenful of lines
-.PP
-.IP "q or Q"
+.It Ar i Ns z
+same as typing a space except that
+.Ar i ,
+if present, becomes the new window size. Note that the window size reverts
+back to the default at the end of the current file.
+.It Ar i Ns s
+skip
+.Ar i
+lines and print a screenful of lines
+.It Ar i Ns f
+skip
+.Ar i
+screenfuls and print a screenful of lines
+.It q or Q
quit reading the current file; go on to the next (if any)
-.PP
-.IP "e or q"
-When the prompt --More--(Next file:
-.IR file )
+.It e or q
+When the prompt
+.Li --More--(Next file:
+.Pa file )
is printed, this command causes zmore to exit.
-.PP
-.IP s
-When the prompt --More--(Next file:
-.IR file )
+.It s
+When the prompt
+.Li --More--(Next file:
+.Pa file )
is printed, this command causes zmore to skip the next file and continue.
-.PP
-.IP =
+.It =
Display the current line number.
-.PP
-.IP \fIi\|\fP/expr
-search for the \fIi\|\fP-th occurrence of the regular expression \fIexpr.\fP
+.It Ar i Ns /expr
+search for the
+.Ar i Ns -th
+occurrence of the regular expression
+.Ar expr .
If the pattern is not found,
-.I zmore
-goes on to the next file (if any).
-Otherwise, a screenful is displayed, starting two lines before the place
-where the expression was found.
-The user's erase and kill characters may be used to edit the regular
-expression.
+.Nm
+goes on to the next file (if any). Otherwise, a screenful is displayed,
+starting two lines before the place where the expression was found. The
+user's erase and kill characters may be used to edit the regular expression.
Erasing back past the first column cancels the search command.
-.PP
-.IP \fIi\|\fPn
-search for the \fIi\|\fP-th occurrence of the last regular expression entered.
-.PP
-.IP !command
-invoke a shell with \fIcommand\|\fP.
-The character `!' in "command" are replaced with the
-previous shell command. The sequence "\\!" is replaced by "!".
-.PP
-.IP ":q or :Q"
-quit reading the current file; go on to the next (if any)
-(same as q or Q).
-.PP
-.IP .
+.It Ar i Ns n
+search for the
+.Ar i Ns -th
+occurrence of the last regular expression entered.
+.It ! Ns Ar command
+invoke a shell with
+.Ar command .
+The character
+.So
+!
+.Sc
+in
+.Do
+.Ar command
+.Dc
+are replaced with the previous shell command. The sequence
+.Do
+\\!
+.Dc
+is replaced by
+.Do
+!
+.Dc .
+.It :q or :Q
+quit reading the current file; go on to the next (if any) (same as q or Q).
+.It .
(dot) repeat the previous command.
-.PP
-The commands take effect immediately, i.e., it is not necessary to
-type a carriage return.
-Up to the time when the command character itself is given,
-the user may hit the line kill character to cancel the numerical
-argument being formed.
-In addition, the user may hit the erase character to redisplay the
---More-- message.
-.PP
+.El
+.Pp
+The commands take effect immediately, i.e., it is not necessary to type a
+carriage return. Up to the time when the command character itself is given,
+the user may hit the line kill character to cancel the numerical argument
+being formed. In addition, the user may hit the erase character to redisplay
+the
+.Li --More--
+message.
+.Pp
At any time when output is being sent to the terminal, the user can
hit the quit key (normally control\-\\).
-.I Zmore
-will stop sending output, and will display the usual --More--
-prompt.
-The user may then enter one of the above commands in the normal manner.
-Unfortunately, some output is lost when this is done, due to the
+.Nm
+will stop sending output, and will display the usual
+.Li --More--
+prompt. The user may then enter one of the above commands in the normal
+manner. Unfortunately, some output is lost when this is done, due to the
fact that any characters waiting in the terminal's output queue
are flushed when the quit signal occurs.
-.PP
+.Pp
The terminal is set to
-.I noecho
-mode by this program so that the output can be continuous.
-What you type will thus not show on your terminal, except for the / and !
-commands.
-.PP
+.Nm noecho
+mode by this program so that the output can be continuous. What you type
+will thus not show on your terminal, except for the / and
+! commands.
+.Pp
If the standard output is not a teletype, then
-.I zmore
+.Nm
acts just like
-.I zcat,
+.Nm zcat ,
except that a header is printed before each file.
-.SH FILES
-.DT
-/usr/share/misc/termcap Terminal data base
-.SH "SEE ALSO"
-more(1), gzip(1), zdiff(1), zgrep(1), znew(1), zforce(1), gzexe(1)
+.Sh FILES
+.Bl -tag -width "/usr/share/misc/termcap" -compact
+.It Pa /usr/share/misc/termcap
+Terminal data base
+.El
+.Sh SEE ALSO
+.Xr more 1 ,
+.Xr gzip 1 ,
+.Xr zdiff 1 ,
+.Xr zgrep 1 ,
+.Xr znew 1 ,
+.Xr zforce 1 ,
+.Xr gzexe 1
*** patch for znew(1)
--- znew.1 Wed Dec 3 01:02:32 2003
+++ znew.1.mdoc Sat Dec 6 11:30:36 2003
@@ -1,40 +1,70 @@
.\" $Id: znew.1,v 1.3 1993/10/15 23:06:05 jtc Exp $
-.TH ZNEW 1
-.SH NAME
-znew \- recompress .Z files to .gz files
-.SH SYNOPSIS
-.B znew
-[ -ftv9PK] [ name.Z ... ]
-.SH DESCRIPTION
-.I Znew
-recompresses files from .Z (compress) format to .gz (gzip) format.
-If you want to recompress a file already in gzip format, rename the file
-to force a .Z extension then apply znew.
-.SH OPTIONS
-.TP
-.B \-f
-Force recompression from .Z to .gz format even if a .gz file already exists.
-.TP
-.B \-t
+.Dd June 16, 1993
+.Dt ZNEW 1
+.Os
+.Sh NAME
+.Nm znew
+.Nd recompress .Z files to .gz files
+.Sh SYNOPSIS
+.Nm
+.Op Fl ftv9PK
+.Op Ar name.Z ...
+.Sh DESCRIPTION
+.Nm
+recompresses files from
+.Pa .Z
+.Nm ( compress )
+format to
+.Pa .gz
+.Nm ( gzip )
+format. If you want to recompress a file already in
+.Nm gzip
+format, rename the file to force a
+.Pa .Z
+extension then apply
+.Nm .
+.Sh OPTIONS
+.Bl -tag -width flag
+.It Fl f
+Force recompression from
+.Pa .Z
+to
+.Pa .gz
+format even if a
+.Pa .gz
+file already exists.
+.It Fl t
Tests the new files before deleting originals.
-.TP
-.B \-v
-Verbose. Display the name and percentage reduction for each file compressed.
-.TP
-.B \-9
+.It Fl v
+Verbose. Display the name and percentage reduction for each file compressed.
+.It Fl 9
Use the slowest compression method (optimal compression).
-.TP
-.B \-P
+.It Fl P
Use pipes for the conversion to reduce disk space usage.
-.TP
-.B \-K
-Keep a .Z file when it is smaller than the .gz file
-.SH "SEE ALSO"
-gzip(1), zmore(1), zdiff(1), zgrep(1), zforce(1), gzexe(1), compress(1)
-.SH BUGS
-.I Znew
-does not maintain the time stamp with the -P option if
-.I cpmod(1)
+.It Fl K
+Keep a
+.Pa .Z
+file when it is smaller than the
+.Pa .gz
+file.
+.El
+.Pp
+.Sh SEE ALSO
+.Xr gzip 1 ,
+.Xr zmore 1 ,
+.Xr zdiff 1 ,
+.Xr zgrep 1 ,
+.Xr zforce 1 ,
+.Xr gzexe 1 ,
+.Xr compress 1
+.Sh BUGS
+.Nm
+does not maintain the time stamp with the
+.Fl P
+option if
+.Xr cpmod 1
is not available and
-.I touch(1)
-does not support the -r option.
+.Xr touch 1
+does not support the
+.Fl r
+option.
>Release-Note:
>Audit-Trail:
>Unformatted: