X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Ftar.info-1;h=3935da526b6ba01a5e6561d8dffe8dbe75e2873a;hb=1a44d77d50f4fb37c0410eed04b82303624ea2ec;hp=b420f633da419dc10329ac4d0885600956b5463a;hpb=dda6367c9eac71da8f2ab1c60b3df60f19ce4755;p=debian%2Ftar diff --git a/doc/tar.info-1 b/doc/tar.info-1 index b420f633..3935da52 100644 --- 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 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, @@ -34,7 +34,7 @@ File: tar.info, Node: Top, Next: Introduction, Up: (dir) 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, @@ -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 -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 @@ -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: - 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  @@ -1285,7 +1284,7 @@ verbose member listing::. 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' @@ -1362,11 +1361,11 @@ the archive file `music.tar', type: `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. @@ -1412,9 +1411,9 @@ no individual file names as arguments. For example, 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  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 - -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 @@ -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 - 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. @@ -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: - 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 . @@ -3526,11 +3525,11 @@ unknown-keyword `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 @@ -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 - -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  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 - -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 @@ -3922,7 +3921,7 @@ the archive, use `--occurrence' option, as shown in the following 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. @@ -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 - -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 - -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': @@ -6123,7 +6122,7 @@ difficult to catch using text editors. 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