BSD 4_3 release

[unix-history] / usr / man / man1 / tar.1

diff --git a/usr/man/man1/tar.1 b/usr/man/man1/tar.1
index ff49dc0..782647b 100644 (file)
--- a/usr/man/man1/tar.1
+++ b/usr/man/man1/tar.1
@@ -1,4 +1,7 @@
-.TH TAR 1 "13 January 1983"
+.\"    @(#)tar.1       6.5 (Berkeley) 5/12/86
+.\"
+.TH TAR 1 "May 12, 1986"
+.AT 3

 .SH NAME
 tar \- tape archiver
 .SH SYNOPSIS
 .SH NAME
 tar \- tape archiver
 .SH SYNOPSIS


@@ -49,7 +52,10 @@ already there or have been modified since last put on the tape.
 Create a new tape; writing begins on the beginning of the tape
 instead of after the last file.  This command implies
 .BR r .
 Create a new tape; writing begins on the beginning of the tape
 instead of after the last file.  This command implies
 .BR r .

-.TP 8
+.PP
+The following characters may be used in addition to the letter
+which selects the function desired.
+.TP 10

 .B o
 On output, tar normally places information specifying owner and modes
 of directories in the archive.  Former versions of tar, when encountering
 .B o
 On output, tar normally places information specifying owner and modes
 of directories in the archive.  Former versions of tar, when encountering


@@ -57,17 +63,14 @@ this information will give error message of the form
 .br
        "<name>/: cannot create".
 .br
 .br
        "<name>/: cannot create".
 .br

-This option will suppress the directory information.
-.TP 8
+This modifier will suppress the directory information.
+.TP 10

 .B p
 .B p

-This option says to restore files to their original modes,
+This modifier says to restore files to their original modes,

 ignoring the present
 .IR umask (2).
 Setuid and sticky information
 will also be restored to the super-user.
 ignoring the present
 .IR umask (2).
 Setuid and sticky information
 will also be restored to the super-user.

-.PP
-The following characters may be used in addition to the letter
-which selects the function desired.

 .TP 10
 .B 0, ..., 9
 This modifier selects an alternate drive on which the tape is mounted.
 .TP 10
 .B 0, ..., 9
 This modifier selects an alternate drive on which the tape is mounted.


@@ -78,9 +81,9 @@ Normally
 .I tar
 does its work silently.  The
 .B v
 .I tar
 does its work silently.  The
 .B v

-(verbose) option make
+(verbose) option makes

 .I tar
 .I tar

-type the name of each file it treats preceded by the function
+print the name of each file it treats preceded by the function

 letter.  With the
 .B t
 function, the verbose option
 letter.  With the
 .B t
 function, the verbose option


@@ -117,7 +120,7 @@ when reading tapes (key letters `x' and `t').
 tells 
 .I tar
 to complain if it cannot resolve all of the links to the
 tells 
 .I tar
 to complain if it cannot resolve all of the links to the

-files dumped. If this is not specified, no error messages are printed.
+files dumped.  If this is not specified, no error messages are printed.

 .TP 10
 .B m
 tells 
 .TP 10
 .B m
 tells 


@@ -139,7 +142,8 @@ was added so that
 .I tar
 can work across a communications channel where the blocking may not
 be maintained.
 .I tar
 can work across a communications channel where the blocking may not
 be maintained.

-.PP
+.TP 10
+.B C

 If a file name is preceded by 
 .BR \-C ,
 then 
 If a file name is preceded by 
 .BR \-C ,
 then 


@@ -161,6 +165,8 @@ inability to properly handle blocked archives have been lifted.
 /dev/rmt?
 .br
 /tmp/tar*
 /dev/rmt?
 .br
 /tmp/tar*

+.SH "SEE ALSO"
+tar(5)

 .SH DIAGNOSTICS
 Complaints about bad key characters and tape read/write errors.
 .br
 .SH DIAGNOSTICS
 Complaints about bad key characters and tape read/write errors.
 .br


@@ -178,4 +184,10 @@ option can be slow.
 .br
 The current limit on file name length is 100 characters.
 .br
 .br
 The current limit on file name length is 100 characters.
 .br

-There is no way to selectively follow symbolic links.
+There is no way selectively to follow symbolic links.
+.br
+When extracting tapes created with the
+.B r
+or
+.B u
+options, directory modification times may not be set correctly.