Awesome new zgz man page!

diff --git a/debian/changelog b/debian/changelog
index 8a55f35623cd9006fa7ef9580998d8463fba8451..aaf96dfcccb7f2255c6943bf582b02764c579555 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ pristine-tar (1.02) unstable; urgency=low
     and is the overwhelming reason for failures to reproduce bz2 files
     in the Debian archive. Closes: #560170, #579657, #525128, #576119
     (Special thanks to Laszlo Ersek for tracking this down.)
+  * Awesome new zgz man page!
   * Faster generation of bzip2 deltas: Do not repeatedly decompress
     input file.
   * pristine-bz2 -t can be used to make it try harder to generate

diff --git a/zgz.pod b/zgz.pod
index 70aa9beed23c7d3196a8b19f127245317765551d..64149f3145b70b96901fb575dbaef2afba837e0f 100644 (file)
--- a/zgz.pod
+++ b/zgz.pod
@@ -1,6 +1,6 @@
 =head1 NAME
 
-zgz - libz based gz creator
+zgz - Frankenstein's compressor
 
 =head1 SYNOPSIS
 
@@ -8,23 +8,13 @@ B<zgz> [options] < file > file.gz
 
 =head1 DESCRIPTION
 
-zgz is a modified version of a BSD gzip program. Unlike gzip(1), it
-uses libz for compression.
+This program is an unholy combination of the BSD gzip program (using libz for
+compression), a modified GNU L<gzip>(1) that supports setting an arbitrary file
+name and timestamp, and an old, rotting version of bzip2 that we dug up
+somewhere at midnight. Only the bits to do with file compression were kept.
 
-BSD gzip is a drop-in replacement for GNU gzip(1). You can refer to GNU gzip's
-manpage for the command-line arguments.
-However, this is a modified version that removes support for some options, most
-notably decompression (-d) and recursive (-r).
-
-zgz can also build GNU gzip files with the --gnu option. zgz incorporates parts
-of GNU gzip to support this option.
-
-zgz can also generate bzip2 output, as generated by version 0.9.5d, 
-with the --old-bzip2 option. zgz incorporates parts of bzip2 to support
-that option.
-
-This version supports a variety of special options which aid pristine-gz(1) in
-reproducing builds of gz files that are bit-identical to the originals.
+There are many arcane options which aid L<pristine-gz>(1) in re-animating
+files. Use --help to see all the gory details.
 
 =head1 AUTHOR
 
@@ -35,4 +25,9 @@ Faidon Liambotis,
 Josh Triplett,
 Joey Hess
 
+Note that several of the above donors would be very suprised at finding
+parts of themselves ... er, their work ... shambling around here. Please
+direct correspondance and/or flaming pitchforks to the pristine-tar
+maintainers.
+
 =cut