Update

diff --git a/ChangeLog b/ChangeLog
index 068f8cc72073e73d7b646aa82e6a6abefed89481..7149001bc76896bfac652ac24ef15733caeffbf1 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2007-10-31  Sergey Poznyakoff  <gray@gnu.org.ua>
+
+       * src/checkpoint.c: New actions: bell and ttyout
+       * src/system.c (sys_exec_info_script)
+       (sys_exec_checkpoint_script): pass the current blocking factor in
+       TAR_BLOCKING_FACTOR environment variable.
+       * doc/tar.texi: Update
+       * NEWS: Update
+       
 2007-10-30  Sergey Poznyakoff  <gray@gnu.org.ua>
 
        * doc/Makefile.am: Use texi2html and the CVS version of gendocs.sh

diff --git a/NEWS b/NEWS
index 394925c4a040fa662e25b97007059fe6abee8f0a..f454e4ca5f36f2351f9ff3a61820539353586be3 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-GNU tar NEWS - User visible changes. 2007-10-29
+GNU tar NEWS - User visible changes. 2007-10-31
 Please send GNU tar bug reports to <bug-tar@gnu.org>
 
 \f
@@ -26,6 +26,11 @@ echo=string, and sleep=value.  Any number of `--checkpoint-action'
 options can be specified, the actions will be executed in order of
 their appearance in the command line.  
 
+* Info (end-of-volume) scripts
+
+The value of the blocking factor is made available to info and
+checkpoint scripts via environment variable TAR_BLOCKING_FACTOR.
+
 \f
 version 1.19 - Sergey Poznyakoff, 2007-10-10
 

diff --git a/doc/tar.texi b/doc/tar.texi
index 1084e47696f2dbb93508a914eba38510073558a5..777d233b64012ce547ea57ecf7c4bab52bb5a402 100644 (file)
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -2460,6 +2460,13 @@ for a complete description.
 The @var{action} argument can be one of the following:
 
 @table @asis
+@item bell
+Produce an audible bell on the console.
+
+@item dot
+@itemx .
+Print a single dot on the standard listing stream.
+
 @item echo
 Display a textual message on the standard error, with the status and
 number of the checkpoint.  This is the default.
@@ -2468,15 +2475,14 @@ number of the checkpoint.  This is the default.
 Display @var{string} on the standard error.  Before output, the string
 is subject to meta-character expansion.
 
-@item dot
-@itemx .
-Print a single dot on the standard listing stream.
+@item exec=@var{command}
+Execute the given @var{command}.
 
 @item sleep=@var{time}
 Wait for @var{time} seconds.
 
-@item exec=@var{command}
-Execute the given @var{command}.
+@item ttyout=@var{string}
+Output @var{string} on the current console (@file{/dev/tty}).
 @end table
 
 Several @option{--checkpoint-action} options can be specified.  The
@@ -3805,6 +3811,26 @@ audible bell and the message described above at each checkpoint:
 --checkpoint-action='echo=\aHit %s checkpoint #%u'
 @end smallexample
 
+@cindex @code{bell}, checkpoint action
+There is also a special action which produces an audible signal:
+@samp{bell}.  It is not equivalent to @samp{echo='\a'}, because
+@samp{bell} sends the bell directly to the console (@file{/dev/tty}),
+whereas @samp{echo='\a'} sends it to the standard error.  
+
+@cindex @code{ttyout}, checkpoint action
+The @samp{ttyout=@var{string}} action outputs @var{string} to
+@file{/dev/tty}, so it can be used even if the standard output is
+redirected elsewhere.  The @var{string} is subject to the same
+modifications as with @samp{echo} action.  In contrast to the latter,
+@samp{ttyout} does not prepend @command{tar} executable name to the
+string, nor does it output a newline after it.  For example, the
+following action will print the checkpoint message at the same screen
+line, overwriting any previous message:
+
+@smallexample
+--checkpoint-action="ttyout=\rHit %s checkpoint #%u"
+@end smallexample
+
 @cindex @code{dot}, checkpoint action
 Another available checkpoint action is @samp{dot} (or @samp{.}).  It
 instructs @command{tar} to print a single dot on the standard listing
@@ -3849,6 +3875,10 @@ additional arguments.  Its exit code is ignored.  It gets a copy of
 @item TAR_ARCHIVE
 The name of the archive @command{tar} is processing.
 
+@vrindex TAR_BLOCKING_FACTOR, checkpoint script environment
+@item TAR_BLOCKING_FACTOR
+Current blocking factor (@pxref{Blocking}. 
+
 @vrindex TAR_CHECKPOINT, checkpoint script environment
 @item TAR_CHECKPOINT
 The checkpoint number.
@@ -10621,6 +10651,10 @@ environment variables:
 @item TAR_ARCHIVE
 The name of the archive @command{tar} is processing.
 
+@vrindex TAR_BLOCKING_FACTOR, info script environment variable
+@item TAR_BLOCKING_FACTOR
+Current blocking factor (@pxref{Blocking}. 
+
 @vrindex TAR_VOLUME, info script environment variable
 @item TAR_VOLUME
 Ordinal number of the volume @command{tar} is about to start.