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
 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
 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.  
 
 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
 
 \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
 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.
 @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.
 
 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 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
 @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
 
 --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
 @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.
 
 @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.
 @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.
 
 @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.
 @vrindex TAR_VOLUME, info script environment variable
 @item TAR_VOLUME
 Ordinal number of the volume @command{tar} is about to start.