summaryrefslogtreecommitdiffstats
path: root/doc/tarlz.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/tarlz.1')
-rw-r--r--doc/tarlz.122
1 files changed, 13 insertions, 9 deletions
diff --git a/doc/tarlz.1 b/doc/tarlz.1
index 4308fc2..83325dd 100644
--- a/doc/tarlz.1
+++ b/doc/tarlz.1
@@ -1,5 +1,5 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
-.TH TARLZ "1" "April 2019" "tarlz 0.15" "User Commands"
+.TH TARLZ "1" "October 2019" "tarlz 0.16" "User Commands"
.SH NAME
tarlz \- creates tar archives with multimember lzip compression
.SH SYNOPSIS
@@ -8,15 +8,19 @@ tarlz \- creates tar archives with multimember lzip compression
.SH DESCRIPTION
Tarlz is a massively parallel (multi\-threaded) combined implementation of
the tar archiver and the lzip compressor. Tarlz creates, lists and extracts
-archives in a simplified posix pax format compressed with lzip, keeping the
-alignment between tar members and lzip members. This method adds an indexed
-lzip layer on top of the tar archive, making it possible to decode the
-archive safely in parallel. The resulting multimember tar.lz archive is
-fully backward compatible with standard tar tools like GNU tar, which treat
-it like any other tar.lz archive. Tarlz can append files to the end of such
-compressed archives.
+archives in a simplified and safer variant of the POSIX pax format
+compressed with lzip, keeping the alignment between tar members and lzip
+members. The resulting multimember tar.lz archive is fully backward
+compatible with standard tar tools like GNU tar, which treat it like any
+other tar.lz archive. Tarlz can append files to the end of such compressed
+archives.
.PP
-The tarlz file format is a safe posix\-style backup format. In case of
+Keeping the alignment between tar members and lzip members has two
+advantages. It adds an indexed lzip layer on top of the tar archive, making
+it possible to decode the archive safely in parallel. It also minimizes the
+amount of data lost in case of corruption.
+.PP
+The tarlz file format is a safe POSIX\-style backup format. In case of
corruption, tarlz can extract all the undamaged members from the tar.lz
archive, skipping over the damaged members, just like the standard
(uncompressed) tar. Moreover, the option '\-\-keep\-damaged' can be used to