summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDaniel Baumann <mail@daniel-baumann.ch>2015-11-07 11:48:41 +0000
committerDaniel Baumann <mail@daniel-baumann.ch>2015-11-07 11:48:41 +0000
commit0dd2bf33fae3b42857aee4832fd3b1956a0eab74 (patch)
tree711f6d9992b4956192a3c74ef7f01746c76047aa /doc
parentAdding debian version 1.16~rc1-1. (diff)
downloadlziprecover-0dd2bf33fae3b42857aee4832fd3b1956a0eab74.tar.xz
lziprecover-0dd2bf33fae3b42857aee4832fd3b1956a0eab74.zip
Merging upstream version 1.16.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
Diffstat (limited to 'doc')
-rw-r--r--doc/lziprecover.18
-rw-r--r--doc/lziprecover.info47
-rw-r--r--doc/lziprecover.texi31
3 files changed, 55 insertions, 31 deletions
diff --git a/doc/lziprecover.1 b/doc/lziprecover.1
index b07aca4..ffd4a6d 100644
--- a/doc/lziprecover.1
+++ b/doc/lziprecover.1
@@ -1,12 +1,12 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.37.1.
-.TH LZIPRECOVER "1" "July 2014" "lziprecover 1.16-rc1" "User Commands"
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
+.TH LZIPRECOVER "1" "August 2014" "lziprecover 1.16" "User Commands"
.SH NAME
lziprecover \- recovers data from damaged lzip files
.SH SYNOPSIS
.B lziprecover
-[\fIoptions\fR] [\fIfiles\fR]
+[\fI\,options\/\fR] [\fI\,files\/\fR]
.SH DESCRIPTION
-Lziprecover \- Data recovery tool and decompressor for lzip files.
+Lziprecover \- Data recovery tool and decompressor for the lzip format.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
diff --git a/doc/lziprecover.info b/doc/lziprecover.info
index 289fec5..b97224a 100644
--- a/doc/lziprecover.info
+++ b/doc/lziprecover.info
@@ -3,7 +3,7 @@ lziprecover.texi.
INFO-DIR-SECTION Data Compression
START-INFO-DIR-ENTRY
-* Lziprecover: (lziprecover). Data recovery tool for lzip files
+* Lziprecover: (lziprecover). Data recovery tool for the lzip format
END-INFO-DIR-ENTRY

@@ -12,7 +12,7 @@ File: lziprecover.info, Node: Top, Next: Introduction, Up: (dir)
Lziprecover Manual
******************
-This manual is for Lziprecover (version 1.16-rc1, 1 July 2014).
+This manual is for Lziprecover (version 1.16, 29 August 2014).
* Menu:
@@ -27,7 +27,7 @@ This manual is for Lziprecover (version 1.16-rc1, 1 July 2014).
* Concept index:: Index of concepts
- Copyright (C) 2009, 2010, 2011, 2012, 2013, 2014 Antonio Diaz Diaz.
+ Copyright (C) 2009-2014 Antonio Diaz Diaz.
This manual is free documentation: you have unlimited permission to
copy, distribute and modify it.
@@ -62,6 +62,11 @@ into account both data integrity and decoder availability:
* Additionally lzip is copylefted, which guarantees that it will
remain free forever.
+ A nice feature of the lzip format is that a corrupt byte is easier to
+repair the nearer it is from the beginning of the file. Therefore, with
+the help of lziprecover, losing an entire archive just because of a
+corrupt byte near the beginning is a thing of the past.
+
Lziprecover is able to recover or decompress files produced by any of
the compressors in the lzip family; lzip, plzip, minilzip/lzlib, clzip
and pdlzip.
@@ -257,7 +262,7 @@ corruption.
Bit-flip happens when one bit in the file is changed from 0 to 1 or
vice versa. It may be caused by bad RAM or even by natural radiation. I
-have seen a case of bit-flip in a file stored in an USB flash drive.
+have seen a case of bit-flip in a file stored on an USB flash drive.
Repairing a file can take some time. Small files or files with the
error located near the beginning can be repaired in a few seconds. But
@@ -496,9 +501,15 @@ programs with a suitable command line syntax.
values for each byte. 'N-bit error' means any value differing from
the original value in N bit positions, not a value differing from
the original value in the bit position N.
- The number of N-bit errors per byte (N = 1 to 8) is: 8 28 56 70 56
- 28 8 1
- Examples of RANGE: 1 1,2,3 1-4 1,3-5,8 1-3,5-8
+ The number of N-bit errors per byte (N = 1 to 8) is:
+ 8 28 56 70 56 28 8 1
+
+ Examples of RANGE Tests errors of N-bit
+ 1 1
+ 1,2,3 1, 2 and 3
+ 2-4 2, 3 and 4
+ 1,3-5,8 1, 3, 4, 5 and 8
+ 1-3,5-8 1, 2, 3, 5, 6, 7 and 8
'-p BYTES'
'--position=BYTES'
@@ -560,17 +571,17 @@ Concept index

Tag Table:
-Node: Top226
-Node: Introduction1098
-Node: Invoking lziprecover3856
-Node: Repairing files9294
-Node: Merging files10484
-Node: File format12255
-Node: Examples14765
-Ref: ddrescue-example15966
-Node: Unzcrash17075
-Node: Problems19447
-Node: Concept index19997
+Node: Top231
+Node: Introduction1077
+Node: Invoking lziprecover4105
+Node: Repairing files9543
+Node: Merging files10733
+Node: File format12504
+Node: Examples15014
+Ref: ddrescue-example16215
+Node: Unzcrash17324
+Node: Problems19876
+Node: Concept index20426

End Tag Table
diff --git a/doc/lziprecover.texi b/doc/lziprecover.texi
index a460607..80d6eb4 100644
--- a/doc/lziprecover.texi
+++ b/doc/lziprecover.texi
@@ -6,19 +6,19 @@
@finalout
@c %**end of header
-@set UPDATED 1 July 2014
-@set VERSION 1.16-rc1
+@set UPDATED 29 August 2014
+@set VERSION 1.16
@dircategory Data Compression
@direntry
-* Lziprecover: (lziprecover). Data recovery tool for lzip files
+* Lziprecover: (lziprecover). Data recovery tool for the lzip format
@end direntry
@ifnothtml
@titlepage
@title Lziprecover
-@subtitle Data recovery tool for lzip files
+@subtitle Data recovery tool for the lzip format
@subtitle for Lziprecover version @value{VERSION}, @value{UPDATED}
@author by Antonio Diaz Diaz
@@ -47,8 +47,7 @@ This manual is for Lziprecover (version @value{VERSION}, @value{UPDATED}).
@end menu
@sp 1
-Copyright @copyright{} 2009, 2010, 2011, 2012, 2013, 2014
-Antonio Diaz Diaz.
+Copyright @copyright{} 2009-2014 Antonio Diaz Diaz.
This manual is free documentation: you have unlimited permission
to copy, distribute and modify it.
@@ -87,6 +86,11 @@ Additionally lzip is copylefted, which guarantees that it will remain
free forever.
@end itemize
+A nice feature of the lzip format is that a corrupt byte is easier to
+repair the nearer it is from the beginning of the file. Therefore, with
+the help of lziprecover, losing an entire archive just because of a
+corrupt byte near the beginning is a thing of the past.
+
Lziprecover is able to recover or decompress files produced by any of
the compressors in the lzip family; lzip, plzip, minilzip/lzlib, clzip
and pdlzip.
@@ -287,7 +291,7 @@ forms of data corruption.
Bit-flip happens when one bit in the file is changed from 0 to 1 or vice
versa. It may be caused by bad RAM or even by natural radiation. I have
-seen a case of bit-flip in a file stored in an USB flash drive.
+seen a case of bit-flip in a file stored on an USB flash drive.
Repairing a file can take some time. Small files or files with the error
located near the beginning can be repaired in a few seconds. But
@@ -564,8 +568,17 @@ Test N-bit errors only, instead of testing all the 255 wrong values for
each byte. @samp{N-bit error} means any value differing from the
original value in N bit positions, not a value differing from the
original value in the bit position N.@*
-The number of N-bit errors per byte (N = 1 to 8) is: 8 28 56 70 56 28 8 1@*
-Examples of @var{range}: 1 1,2,3 1-4 1,3-5,8 1-3,5-8
+The number of N-bit errors per byte (N = 1 to 8) is:
+@w{8 28 56 70 56 28 8 1}
+
+@multitable {Examples of @var{range}} {1, 2, 3, 5, 6, 7 and 8}
+@item Examples of @var{range} @tab Tests errors of N-bit
+@item 1 @tab 1
+@item 1,2,3 @tab 1, 2 and 3
+@item 2-4 @tab 2, 3 and 4
+@item 1,3-5,8 @tab 1, 3, 4, 5 and 8
+@item 1-3,5-8 @tab 1, 2, 3, 5, 6, 7 and 8
+@end multitable
@item -p @var{bytes}
@itemx --position=@var{bytes}