Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 146 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/bzme.1 b/upstream/mageia-cauldron/man1/bzme.1
new file mode 100644
index 00000000..cdf06eaf
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/bzme.1
@@ -0,0 +1,146 @@
+.PU
+.TH bzip2 1
+.SH NAME
+bzme \- recompress gziped, ziped, ... files into bzip2
+
+.SH SYNOPSIS
+.ll +8
+.B bzmz
+.RB [ " \-fh " ]
+[
+.I "filenames \&..."
+]
+
+.SH DESCRIPTION
+.I bzme
+recompresses files using the Burrows-Wheeler block sorting text compression
+algorithm, and Huffman coding.  Compression is generally considerably better
+than that achieved by more conventional LZ77/LZ78-based compressors,
+and approaches the performance of the PPM family of statistical compressors.
+
+.I bzme
+expects a list of file names to accompany the command-line flags.
+Each file is replaced by a recompressed version of itself, with the name
+as described in 
+.B "NEW NAMES"
+section.
+
+.I bzme
+won't overwrite by default existing files.  If you want this to happen, specify
+the \-f flag.
+
+.SH "NEW NAMES"
+.I bzip2
+attempts to guess the filename for the decompressed file 
+from that of the compressed file as follows:
+
+       filename.tgz    becomes   filename.tar.bz2
+       filename.tar.gz becomes   filename.tar.bz2
+       filename.zip    becomes   filename.tar.bz2
+       filename.z      becomes   filename.bz2
+       filename.Z      becomes   filename.bz2
+       filename.gz     becomes   filename.bz2
+
+If the file does not end in one of the recognised endings, \fI.tgz\fP, 
+
+or \fI.zip\fP,
+.I bzme 
+complains that it cannot guess if the name of the recompressed file (ie it
+doesn't detect the original name to be a file compressed in a known format)
+
+.SH OPTIONS
+.TP
+.B \-f
+Force overwrite of output files, even if
+.I -k
+is used.  Normally,
+.I bzip2 
+will not overwrite existing output files.
+
+.TP
+.B \-k
+Keep (don't delete) input files during compression
+or decompression.
+.".TP
+.".B \-q --quiet
+."Suppress non-essential warning messages.  Messages pertaining to
+."I/O errors and other critical events will not be suppressed.
+.".TP
+.".B \-v --verbose
+."Verbose mode -- dysplay space gain (default)
+.".TP
+.".B \-L --license -V --version
+."Display the software version, license terms and conditions.
+
+.SH SECURITY
+.I bzme
+will keep source file if there's an error while decompressing source file
+or recompressing new file (or
+.I -k
+option is used of course).
+
+.I bzme
+won't overwite the target file, even if
+.I -k
+option is used, if the source file doesn't exists.
+
+As a self-check for your protection, 
+.I bzip2
+uses 32-bit CRCs to make sure that the decompressed version of a file is
+identical to the original.
+.BR
+This offers a better protection against corruption
+of the compressed data than offered by gzip.
+
+.SH SPACE GAIN
+Compression is only performed if the compressed file is smaller than the
+original: the original file is only removed if the newly compressed file
+is smaller, else the new recompressed file is deleted.
+
+Text (aka non binary) files're quite nearly always better compressed
+by bzip2 rather than gzip.
+
+.SH MEMORY VS SPACE TRADEOFF
+There're two things :
+.TP
+.B Consumed CPU time
+The needed cpu time is reduced by decompressing only one time.
+Files to recompress were compressed through compress or gzip, used to be
+decompressed by gunzip -t in order to check that the original file was ok.
+This resulted in passing two times the data in the decompression process
+(one to check integrity, one to recompress).
+temporary space usage will be zero since bzme will use a pipe
+rather than a temporary file as it does in the early ages.
+Source error're detected through bash PIPESTATUS feature.
+.TP
+.B Occupied space
+While recompressing files, if they were compressed through compress or gzip,
+temporary space usage will be zero since bzme will use a pipe
+rather than a temporary file as it did in the early ages.
+Source error're detected through bash PIPESTATUS feature.
+Zip files're still fully decompressed on disk.
+
+As for the recompressed file and original file, only the smallest file
+is kept.
+
+.SH RETURN VALUES
+0 for a normal exit.
+1 will be returned if an unknown option is passed.
+
+.SH BUGS
+Bash getopt (which is used to analyse options) isn't gnu style aware, ie cmd
+opt1 file1 file2 opt2 will result in ignoring opt2 option.
+
+Solaris/SunOs du doesn't supports gnu option, and thus, bzme won't
+work on those OSes unless GNU fileutils got installed.
+.BR
+I had once a day patched bzme to use right options for solaris but i had
+lost my changes.
+.LP
+So solaris remains unsupported.
+
+.SH "SEE ALSO"
+bzip2(1), bunzip2(1)
+
+.SH AUTHOR
+Thierry Vignaud <tvignaud@mandrakesoft.com>, 1999-2002