From defe6b257a3839c9df99336785e41fad883b7f24 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Thu, 13 May 2010 02:39:29 -0400 Subject: [PATCH] Awesome new zgz man page! --- debian/changelog | 1 + zgz.pod | 29 ++++++++++++----------------- 2 files changed, 13 insertions(+), 17 deletions(-) diff --git a/debian/changelog b/debian/changelog index 8a55f35..aaf96df 100644 --- 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 70aa9be..64149f3 100644 --- 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 [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(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(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 -- 2.7.4