Adding upstream version 0.12.upstream/0.12

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

1 files changed, 28 insertions, 14 deletions

diff --git a/doc/tarlz.texi b/doc/tarlz.texi
index 6026fe3..56c4dab 100644
--- a/doc/tarlz.texi
+++ b/doc/tarlz.texi
@@ -6,8 +6,8 @@
 @finalout
 @c %**end of header
 
-@set UPDATED 13 February 2019
-@set VERSION 0.11
+@set UPDATED 22 February 2019
+@set VERSION 0.12
 
 @dircategory Data Compression
 @direntry
@@ -69,7 +69,7 @@ tar, which treat it like any other tar.lz archive. Tarlz can append files to
 the end of such compressed archives.
 
 Tarlz can create tar archives with five levels of compression granularity;
-per file, per block, per directory, appendable solid, and solid.
+per file, per block (default), per directory, appendable solid, and solid.
 
 @noindent
 Of course, compressing each file (or each directory) individually can't
@@ -130,7 +130,7 @@ appended or concatenated, and skips it.
 
 On extraction and listing, tarlz removes leading @samp{./} strings from
 member names in the archive or given in the command line, so that
-@w{@code{tarlz -xf foo ./bar baz}} extracts members @samp{bar} and
+@w{@samp{tarlz -xf foo ./bar baz}} extracts members @samp{bar} and
 @samp{./baz} from archive @samp{foo}.
 
 If several compression levels or @samp{--*solid} options are given, the last
@@ -162,10 +162,10 @@ specified. Tarlz can't concatenate uncompressed tar archives.
 @anchor{--data-size}
 @item -B @var{bytes}
 @itemx --data-size=@var{bytes}
-Set target size of input data blocks for the @samp{--bsolid} option. Valid
-values range from @w{8 KiB} to @w{1 GiB}. Default value is two times the
-dictionary size, except for option @samp{-0} where it defaults to @w{1 MiB}.
-@xref{Minimum archive sizes}.
+Set target size of input data blocks for the @samp{--bsolid} option.
+@xref{--bsolid}. Valid values range from @w{8 KiB} to @w{1 GiB}. Default
+value is two times the dictionary size, except for option @samp{-0} where it
+defaults to @w{1 MiB}. @xref{Minimum archive sizes}.
 
 @item -c
 @itemx --create
@@ -186,6 +186,19 @@ Note that a process can only have one current working directory (CWD).
 Therefore multi-threading can't be used to create an archive if a @samp{-C}
 option appears after a relative filename in the command line.
 
+@item -d
+@itemx --diff
+Find differences between archive and file system. For each tar member in the
+archive, verify that the corresponding file exists and is of the same type
+(regular file, directory, etc). Report the differences found in type, mode
+(permissions), owner and group IDs, modification time, file size, file
+contents (of regular files), target (of symlinks) and device number (of
+block/character special files).
+
+@item --ignore-ids
+Make @samp{--diff} ignore differences in owner and group IDs. This option is
+useful when comparing an @samp{--anonymous} archive.
+
 @item -f @var{archive}
 @itemx --file=@var{archive}
 Use archive file @var{archive}. @samp{-} used as an @var{archive}
@@ -205,7 +218,7 @@ Multi-threaded extraction of files from an archive is not yet implemented.
 Note that the number of usable threads is limited during compression to
 @w{ceil( uncompressed_size / data_size )} (@pxref{Minimum archive sizes}),
 and during decompression to the number of lzip members in the tar.lz
-archive, which you can find by running @w{@code{lzip -lv archive.tar.lz}}.
+archive, which you can find by running @w{@samp{lzip -lv archive.tar.lz}}.
 
 @item -q
 @itemx --quiet
@@ -255,6 +268,10 @@ it creates, reducing the amount of memory required for decompression.
 @item -9 @tab 32 MiB @tab 273 bytes
 @end multitable
 
+@item --uncompressed
+With @samp{--create}, don't compress the created tar archive. Create an
+uncompressed tar archive instead.
+
 @item --asolid
 When creating or appending to a compressed archive, use appendable solid
 compression. All the files being added to the archive are compressed into a
@@ -262,6 +279,7 @@ single lzip member, but the end-of-file blocks are compressed into a
 separate lzip member. This creates a solidly compressed appendable archive.
 Solid archives can't be created nor decoded in parallel.
 
+@anchor{--bsolid}
 @item --bsolid
 When creating or appending to a compressed archive, use block compression.
 Tar members are compressed together in a lzip member until they approximate
@@ -329,10 +347,6 @@ headers preceding a ustar header, or several records with the same
 keyword appearing in the same block of extended records.
 @end ignore
 
-@item --uncompressed
-With @samp{--create}, don't compress the created tar archive. Create an
-uncompressed tar archive instead.
-
 @end table
 
 Exit status: 0 for a normal exit, 1 for environmental problems (file not
@@ -871,7 +885,7 @@ for all eternity, if not longer.
 
 If you find a bug in tarlz, please send electronic mail to
 @email{lzip-bug@@nongnu.org}. Include the version number, which you can
-find by running @w{@code{tarlz --version}}.
+find by running @w{@samp{tarlz --version}}.
 
 
 @node Concept index