From: François Pinard Date: Wed, 16 Nov 1994 02:52:10 +0000 (+0000) Subject: *** empty log message *** X-Git-Url: https://git.brokenzipper.com/gitweb?a=commitdiff_plain;h=0190e903f539024edfa736bd6f0aead634f0a505;p=chaz%2Ftar *** empty log message *** --- diff --git a/doc/tar.texi b/doc/tar.texi index 8467f2b..932eef1 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -10,26 +10,7 @@ @c Search for comments marked with !! or <<< (or >>>) -@c <<< CONVENTIONS: this manual refers to "ordinary files" , "directory -files" (or "directories"), "archive files", "archive members", and -various I/O devices (which have names and file names).>>> - -@c <<< it's "file name" (not filename) unless we are talking about an -argument, ie. @var{file-name}. also, you "use" a "file-name argument" -to "specify" a "file".>>> - -@c <<< @code{tar} is always lower case, in bold. >>> - -@c <<< it's "operations of tar", "options to tar" also, it's " @samp{tar ---foo}" or "the @samp{--foo} operation". MIB doesn't like using -operations and options as separate concepts. I disagree --- would be a -mess to explain otherwise - -@c <<< (don't forget to comment these out in final draft) -ringo - -@c <<< please dont' change this without sending me e-mail. some things -@c are in progress or waiting to be edited in hardcopy. -ringo -@c smallbook +@smallbook @iftex @c finalout @@ -54,9 +35,7 @@ Copyright (C) 1992 Free Software Foundation, Inc. DRAFT! @subtitle DRAFT @c subtitle insert month here when ready -@author Amy Gorin, Michael I. Bushnell, and Jay Fenlason -@c <<>>> +@author Michael I. Bushnell and Amy Gorin @page @vskip 0pt plus 1filll @@ -97,32 +76,6 @@ version 1.12. * Concept Index:: Concept Index @end menu -@node Introduction, Invoking @code{tar}, Top, Top -@chapter @code{tar}: The GNU Tape Archiver - -You can use @code{tar} to create an @dfn{archive}---a single file -which contains other files' contents as well as a listing of those -files' characteristics. You can also use @code{tar} to read, add to, -or manipulate already existing archives. Because an archive created -by @code{tar} is capable of preserving file information and directory -structure, @code{tar} is ideal for performing full and incremental -backups, as well as for transferring groups of files between disks and -over networks. - -The name @code{tar} comes from the words ``Tape ARchiver'', but -@code{tar} can actually process archives wherever they are stored; on -tapes and disk files, for example. In addition, tar can read archives -from standard input or write them to standard output. (This is often -useful if redirected another program with a pipe.) - -@c <<< this menu will conflict with menu above in info mode. -ringo -@menu -* Invoking @code{tar}:: How to invoke @code{tar} and specify arguments. -* Tutorial:: An introduction to @code{tar}. -* Operations:: What you can use @code{tar} to do. -* Options:: How to change the way @code{tar} behaves. -* Problems:: Common problems with @code{tar}. -@end menu @chapter Tutorial Introduction to @code{tar} This chapter guides you through some basic examples of @code{tar} @@ -184,7 +137,7 @@ However, this manual consistently uses the terminology above in referring to files and archive members, to make it easier to learn how to use @code{tar}. -@section Creating Archives +@section How to Create Archives To create a new archive, use @samp{tar --create}. You should generally use the @samp{--file} option to specify the name the tar archive will @@ -260,7 +213,7 @@ is using a default value for @samp{--file}. You should generally specify a @samp{--file} argument whenever you use @code{tar}, rather than relying on a default. -@section Listing Archives +@section How to List Archives Use @samp{tar --list} to print the names of members stored in an archive. Use a @samp{--file} option just as with @samp{tar --create} to @@ -301,7 +254,7 @@ file names @file{baloons} and @file{./baloons} name the same file, member names are compared using a simplistic name comparison, in which an exact match is necessary. -@section Extracting Members from an Archive +@section How to Extract Members from an Archive In order to extract members from an archive, use @samp{tar --extract}. Specify the name of the archive with @samp{--file}. To extract specific @@ -331,7 +284,7 @@ will extract all the members of the archive. If you give the @samp{--verbose} option, then @samp{tar --extract} will print the names of the archive members as it extracts them. -@section Adding Files to Existing Archives +@section How to Add Files to Existing Archives If you want to add files to an existing archive, then don't use @samp{tar --create}. That will erase the archive and create a new one @@ -352,7 +305,7 @@ complex. @xref{Multiple Members with the Same Name}. If you want to replace an archive member, use @samp{tar --delete} first, and then use @samp{tar --append}. -@section Deleting Members from Archives +@section How to Delete Members from Archives You can delete members from an archive using @samp{tar --delete}. Specify the name of the archive with @samp{--file}. List the member @@ -367,7 +320,7 @@ Archives}). The @samp{tar --delete} command only works with archives stored on disk. You cannot delete members from an archive stored on a tape. -@section Directories +@section How to Archive Directories When the names of files or members specify directories, the operation of @code{tar} is more complex. Generally, when a directory is named, @@ -405,7 +358,7 @@ The command @samp{tar --extract --file=@var{archive-name} .} will not extract all the contents of the archive, but only those members whose member names begin with @samp{./}. -@section Shorthand names +@section Shorthand Names Most of the options to @code{tar} come in both long forms and short forms. The options described in this tutorial have the following @@ -671,7 +624,24 @@ modify the way these names are interpreted, @pxref{Specifying Names to @code{tar}}). If you name no members, then @samp{--list} will list the names of all the members of the archive. -To see more th +To see more than just the names of the members, use the @samp{--verbose} +option to cause @code{tar} to print out a listing similar to that of +@samp{ls -l}. + +@section Extracting Archive Members + +Use @samp{--extract} (or @samp{--get}, or @samp{-x}) to extract members +from an archive. For each member named (or for the entire archive if no +members are named) on the command line (or with @samp{--files-from}) the +a file is created with the contents of the archive member. The name of +the file is the same as the member name. + +The @samp{--same-permissions} (or @samp{--preserve-permissions}, or +@samp{-p}) options cause @code{tar} to cause the new file to have the +same permissions, owner, and so forth, as the original file did when it +was placed in the archive. + +The @samp{--mo @chapter Specifying Names to @code{tar}