Import upstream version 1.26

[debian/tar] / doc / tar.info-1

diff --git a/doc/tar.info-1 b/doc/tar.info-1
index b420f633da419dc10329ac4d0885600956b5463a..3935da526b6ba01a5e6561d8dffe8dbe75e2873a 100644 (file)
--- a/doc/tar.info-1
+++ b/doc/tar.info-1
@@ -1,6 +1,6 @@
 This is tar.info, produced by makeinfo version 4.13 from tar.texi.
 
 This is tar.info, produced by makeinfo version 4.13 from tar.texi.
 

-This manual is for GNU `tar' (version 1.25, 5 November 2010), which
+This manual is for GNU `tar' (version 1.26, 12 March 2011), which

 creates and extracts files from archives.
 
    Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003,
 creates and extracts files from archives.
 
    Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003,


@@ -34,7 +34,7 @@ File: tar.info,  Node: Top,  Next: Introduction,  Up: (dir)
 GNU tar: an archiver tool
 *************************
 
 GNU tar: an archiver tool
 *************************
 

-This manual is for GNU `tar' (version 1.25, 5 November 2010), which
+This manual is for GNU `tar' (version 1.26, 12 March 2011), which

 creates and extracts files from archives.
 
    Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003,
 creates and extracts files from archives.
 
    Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003,


@@ -567,7 +567,7 @@ in version 1.11.  Thomas Bushnell, n/BSG and Amy Gorin worked on a
 tutorial and manual for GNU `tar'.  Franc,ois Pinard put version 1.11.8
 of the manual together by taking information from all these sources and
 merging them.  Melissa Weisshaus finally edited and redesigned the book
 tutorial and manual for GNU `tar'.  Franc,ois Pinard put version 1.11.8
 of the manual together by taking information from all these sources and
 merging them.  Melissa Weisshaus finally edited and redesigned the book

-to create version 1.12.  The book for versions from 1.14 up to 1.25
+to create version 1.12.  The book for versions from 1.14 up to 1.26

 were edited by the current maintainer, Sergey Poznyakoff.
 
    For version 1.12, Daniel Hagerty contributed a great deal of
 were edited by the current maintainer, Sergey Poznyakoff.
 
    For version 1.12, Daniel Hagerty contributed a great deal of


@@ -941,13 +941,12 @@ Note that you must double the hyphens properly each time.
    For example, here is an archive listing containing most of the
 special suffixes explained above:
 
    For example, here is an archive listing containing most of the
 special suffixes explained above:
 

-     V--------- 0/0          1536 2006-06-09 13:07 MyVolume--Volume Header--
-     -rw-r--r-- gray/staff 456783 2006-06-09 12:06 aspic--Continued at
-     byte 32456--
-     -rw-r--r-- gray/staff  62373 2006-06-09 12:06 apple
-     lrwxrwxrwx gray/staff      0 2006-06-09 13:01 angst -> apple
-     -rw-r--r-- gray/staff  35793 2006-06-09 12:06 blues
-     hrw-r--r-- gray/staff      0 2006-06-09 12:06 music link to blues
+     V--------- 0/0            1536 2006-06-09 13:07 MyVolume--Volume Header--
+     -rw-r--r-- gray/staff   456783 2006-06-09 12:06 aspic--Continued at byte 32456--
+     -rw-r--r-- gray/staff    62373 2006-06-09 12:06 apple
+     lrwxrwxrwx gray/staff        0 2006-06-09 13:01 angst -> apple
+     -rw-r--r-- gray/staff    35793 2006-06-09 12:06 blues
+     hrw-r--r-- gray/staff        0 2006-06-09 12:06 music link to blues

 
 
 \1f
 
 
 \1f


@@ -1285,7 +1284,7 @@ verbose member listing::.
 look like:
 
      $ tar --list --verbose --file=collection.tar folk
 look like:
 
      $ tar --list --verbose --file=collection.tar folk

-     -rw-r--r-- myself user 62 1990-05-23 10:55 folk
+     -rw-r--r-- myself/user      62 1990-05-23 10:55 folk

 
    It is important to notice that the output of `tar --list --verbose'
 does not necessarily match that produced by `tar --create --verbose'
 
    It is important to notice that the output of `tar --list --verbose'
 does not necessarily match that produced by `tar --create --verbose'


@@ -1362,11 +1361,11 @@ the archive file `music.tar', type:
 
    `tar' responds:
 
 
    `tar' responds:
 

-     drwxrwxrwx myself user 0 1990-05-31 21:49 practice/
-     -rw-r--r-- myself user 42 1990-05-21 13:29 practice/blues
-     -rw-r--r-- myself user 62 1990-05-23 10:55 practice/folk
-     -rw-r--r-- myself user 40 1990-05-21 13:30 practice/jazz
-     -rw-r--r-- myself user 10240 1990-05-31 21:49 practice/collection.tar
+     drwxrwxrwx myself/user       0 1990-05-31 21:49 practice/
+     -rw-r--r-- myself/user      42 1990-05-21 13:29 practice/blues
+     -rw-r--r-- myself/user      62 1990-05-23 10:55 practice/folk
+     -rw-r--r-- myself/user      40 1990-05-21 13:30 practice/jazz
+     -rw-r--r-- myself/user   10240 1990-05-31 21:49 practice/collection.tar

 
    When you use a directory name as a file name argument, `tar' acts on
 all the files (including sub-directories) in that directory.
 
    When you use a directory name as a file name argument, `tar' acts on
 all the files (including sub-directories) in that directory.


@@ -1412,9 +1411,9 @@ no individual file names as arguments.  For example,
 
 produces this:
 
 
 produces this:
 

-     -rw-r--r-- me user     28 1996-10-18 16:31 jazz
-     -rw-r--r-- me user     21 1996-09-23 16:44 blues
-     -rw-r--r-- me user     20 1996-09-23 16:44 folk
+     -rw-r--r-- me/user          28 1996-10-18 16:31 jazz
+     -rw-r--r-- me/user          21 1996-09-23 16:44 blues
+     -rw-r--r-- me/user          20 1996-09-23 16:44 folk

 
 \1f
 File: tar.info,  Node: extracting files,  Next: extract dir,  Prev: extracting archives,  Up: extract
 
 \1f
 File: tar.info,  Node: extracting files,  Next: extract dir,  Prev: extracting archives,  Up: extract


@@ -1522,8 +1521,8 @@ displayed more detail about the extracted files, as shown in the
 example below:
 
      $ tar -xvvf music.tar practice/folk practice/jazz
 example below:
 
      $ tar -xvvf music.tar practice/folk practice/jazz

-     -rw-r--r-- me user     28 1996-10-18 16:31 practice/jazz
-     -rw-r--r-- me user     20 1996-09-23 16:44 practice/folk
+     -rw-r--r-- me/user          28 1996-10-18 16:31 practice/jazz
+     -rw-r--r-- me/user          20 1996-09-23 16:44 practice/folk

 
 Because you created the directory with `practice' as part of the file
 names of each of the files by archiving the `practice' directory as
 
 Because you created the directory with `practice' as part of the file
 names of each of the files by archiving the `practice' directory as


@@ -2514,7 +2513,7 @@ File: tar.info,  Node: Option Summary,  Next: Short Option Summary,  Prev: Opera
 
 `--level=N'
      Force incremental backup of level N.  As of GNU `tar' version
 
 `--level=N'
      Force incremental backup of level N.  As of GNU `tar' version

-     1.25, the option `--level=0' truncates the snapshot file, thereby
+     1.26, the option `--level=0' truncates the snapshot file, thereby

      forcing the level 0 dump.  Other values of N are effectively
      ignored.  *Note --level=0::, for details and examples.
 
      forcing the level 0 dump.  Other values of N are effectively
      ignored.  *Note --level=0::, for details and examples.
 


@@ -3058,7 +3057,7 @@ information about its name, version, origin and legal status, all on
 standard output, and then exit successfully.  For example,
 `tar --version' might print:
 
 standard output, and then exit successfully.  For example,
 `tar --version' might print:
 

-     tar (GNU tar) 1.25
+     tar (GNU tar) 1.26

      Copyright (C) 2010 Free Software Foundation, Inc.
      Copyright (C) 2010 Free Software Foundation, Inc.
      License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
      Copyright (C) 2010 Free Software Foundation, Inc.
      Copyright (C) 2010 Free Software Foundation, Inc.
      License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.


@@ -3526,11 +3525,11 @@ unknown-keyword
      `Ignoring unknown extended header keyword `%s'' 
 
 decompress-program
      `Ignoring unknown extended header keyword `%s'' 
 
 decompress-program

-     Controls verbose messages describing execution failures when trying
-     alternative decompressor programs (*note alternative decompression
-     programs::).  This warning is disabled by default (unless
-     `--verbose' is used).  A common example of what you can get when
-     using this warning is:
+     Controls verbose description of failures occurring when trying to
+     run alternative decompressor programs (*note alternative
+     decompression programs::).  This warning is disabled by default
+     (unless `--verbose' is used).  A common example of what you can get
+     when using this warning is:

 
           $ tar --warning=decompress-program -x -f archive.Z
           tar (child): cannot run compress: No such file or directory
 
           $ tar --warning=decompress-program -x -f archive.Z
           tar (child): cannot run compress: No such file or directory


@@ -3863,10 +3862,10 @@ If you now use the `--list' (`-t') operation, you will see that `rock'
 has been added to the archive:
 
      $ tar --list --file=collection.tar
 has been added to the archive:
 
      $ tar --list --file=collection.tar

-     -rw-r--r-- me user     28 1996-10-18 16:31 jazz
-     -rw-r--r-- me user     21 1996-09-23 16:44 blues
-     -rw-r--r-- me user     20 1996-09-23 16:44 folk
-     -rw-r--r-- me user     20 1996-09-23 16:44 rock
+     -rw-r--r-- me/user          28 1996-10-18 16:31 jazz
+     -rw-r--r-- me/user          21 1996-09-23 16:44 blues
+     -rw-r--r-- me/user          20 1996-09-23 16:44 folk
+     -rw-r--r-- me/user          20 1996-09-23 16:44 rock

 
 \1f
 File: tar.info,  Node: multiple,  Prev: appending files,  Up: append
 
 \1f
 File: tar.info,  Node: multiple,  Prev: appending files,  Up: append


@@ -3905,11 +3904,11 @@ name of the file being appended as it was acted on.  Now list the
 contents of the archive:
 
      $ tar --list --verbose --file=collection.tar
 contents of the archive:
 
      $ tar --list --verbose --file=collection.tar

-     -rw-r--r-- me user     28 1996-10-18 16:31 jazz
-     -rw-r--r-- me user     21 1996-09-23 16:44 blues
-     -rw-r--r-- me user     20 1996-09-23 16:44 folk
-     -rw-r--r-- me user     20 1996-09-23 16:44 rock
-     -rw-r--r-- me user     58 1996-10-24 18:30 blues
+     -rw-r--r-- me/user          28 1996-10-18 16:31 jazz
+     -rw-r--r-- me/user          21 1996-09-23 16:44 blues
+     -rw-r--r-- me/user          20 1996-09-23 16:44 folk
+     -rw-r--r-- me/user          20 1996-09-23 16:44 rock
+     -rw-r--r-- me/user          58 1996-10-24 18:30 blues

 
 The newest version of `blues' is now at the end of the archive (note
 the different creation dates and file sizes).  If you extract the
 
 The newest version of `blues' is now at the end of the archive (note
 the different creation dates and file sizes).  If you extract the


@@ -3922,7 +3921,7 @@ the archive, use `--occurrence' option, as shown in the following
 example:
 
      $ tar --extract -vv --occurrence --file=collection.tar blues
 example:
 
      $ tar --extract -vv --occurrence --file=collection.tar blues

-     -rw-r--r-- me user     21 1996-09-23 16:44 blues
+     -rw-r--r-- me/user          21 1996-09-23 16:44 blues

 
    *Note Writing::, for more information on `--extract' and see *note
 -occurrence: Option Summary, for a description of `--occurrence' option.
 
    *Note Writing::, for more information on `--extract' and see *note
 -occurrence: Option Summary, for a description of `--occurrence' option.


@@ -4027,11 +4026,11 @@ If you like, You can run `tar --list' to make sure the archives contain
 what they are supposed to:
 
      $ tar -tvf bluesrock.tar
 what they are supposed to:
 
      $ tar -tvf bluesrock.tar

-     -rw-r--r-- melissa user    105 1997-01-21 19:42 blues
-     -rw-r--r-- melissa user     33 1997-01-20 15:34 rock
+     -rw-r--r-- melissa/user    105 1997-01-21 19:42 blues
+     -rw-r--r-- melissa/user     33 1997-01-20 15:34 rock

      $ tar -tvf jazzfolk.tar
      $ tar -tvf jazzfolk.tar

-     -rw-r--r-- melissa user     20 1996-09-23 16:44 folk
-     -rw-r--r-- melissa user     65 1997-01-30 14:15 jazz
+     -rw-r--r-- melissa/user     20 1996-09-23 16:44 folk
+     -rw-r--r-- melissa/user     65 1997-01-30 14:15 jazz

 
    We can concatenate these two archives with `tar':
 
 
    We can concatenate these two archives with `tar':
 


@@ -6123,7 +6122,7 @@ difficult to catch using text editors.
      systems: `CVS', `RCS', `SCCS', `SVN', `Arch', `Bazaar',
      `Mercurial', and `Darcs'.
 
      systems: `CVS', `RCS', `SCCS', `SVN', `Arch', `Bazaar',
      `Mercurial', and `Darcs'.
 

-     As of version 1.25, the following files are excluded:
+     As of version 1.26, the following files are excluded:

 
         * `CVS/', and everything under it
 
 
         * `CVS/', and everything under it