From 0dd2bf33fae3b42857aee4832fd3b1956a0eab74 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 7 Nov 2015 12:48:41 +0100 Subject: Merging upstream version 1.16. Signed-off-by: Daniel Baumann --- doc/lziprecover.1 | 8 ++++---- doc/lziprecover.info | 47 +++++++++++++++++++++++++++++------------------ doc/lziprecover.texi | 31 ++++++++++++++++++++++--------- 3 files changed, 55 insertions(+), 31 deletions(-) (limited to 'doc') 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} -- cgit v1.2.3