From 761895d43c493f8583e73dda31435b595015c049 Mon Sep 17 00:00:00 2001
From: Sergey Poznyakoff <gray@gnu.org.ua>
Date: Tue, 3 Apr 2007 21:38:14 +0000
Subject: [PATCH] Update

---
 NEWS         |  5 ++++-
 doc/tar.texi | 11 ++++++++---
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/NEWS b/NEWS
index b9de750..14ec4a2 100644
--- a/NEWS
+++ b/NEWS
@@ -14,7 +14,10 @@ version 1.16.2
 
 * The options --transform and --strip-components affect hard and soft link
   targets.
-   
+
+* End-of-volume script can send the new volume name to tar by writing
+  it to the file descriptor $TAR_FD.
+     
 
 version 1.16.1
 
diff --git a/doc/tar.texi b/doc/tar.texi
index 7da3fac..fa5bf00 100644
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -10215,10 +10215,15 @@ Short option describing the operation @command{tar} is executing
 @item TAR_FORMAT
 Format of the archive being processed. @xref{Formats}, for a complete
 list of archive format names.
+
+@vrindex TAR_FD, info script environment variable
+@item TAR_FD
+File descriptor which can be used to communicate the new volume
+name to @command{tar}.
 @end table
 
 The volume script can instruct @command{tar} to use new archive name,
-by writing in to file descriptor 3 (see below for an example).
+by writing in to file descriptor @env{$TAR_FD} (see below for an example).
 
 If the info script fails, @command{tar} exits; otherwise, it begins
 writing the next volume.
@@ -10243,7 +10248,7 @@ The second method is to use the @samp{n} response to the tape-change
 prompt.
 
 Finally, the most flexible approach is to use a volume script, that
-writes new archive name to the file descriptor #3.  For example, the
+writes new archive name to the file descriptor @env{$TAR_FD}.  For example, the
 following volume script will create a series of archive files, named
 @file{@var{archive}-@var{vol}}, where @var{archive} is the name of the
 archive being created (as given by @option{--file} option) and
@@ -10262,7 +10267,7 @@ case $TAR_SUBCOMMAND in
 *)        exit 1
 esac
 
-echo $@{name:-$TAR_ARCHIVE@}-$TAR_VOLUME >&3
+echo $@{name:-$TAR_ARCHIVE@}-$TAR_VOLUME >&$TAR_FD
 @end group
 @end smallexample
 
-- 
2.44.0