tar.1: convert to mandoc

- simplify usage line.
- add new flags (-m, -j and -z).
- fix typos.
This commit is contained in:
Hiltjo Posthuma 2015-01-31 14:05:23 +01:00
parent 6c2f9615ac
commit 67e374bcba
1 changed files with 57 additions and 59 deletions

116
tar.1
View File

@ -1,62 +1,60 @@
.TH TAR 1 sbase\-VERSION .Dd January 31, 2015
.SH NAME .Dt TAR 1 sbase\-VERSION
tar \- create, list or extract a tape archive .Os
.SH SYNOPSIS .Sh NAME
.B tar .Nm tar
.RB [ \-f .Nd create, list or extract a tape archive
.IR tarfile] .Sh SYNOPSIS
.RB [ \-C .Nm
.IR dir ] .Op Fl C Ar dir
.RB [ - ] x | t .Op Fl jz
.Fl x Op Fl m
.B tar |
.RB [ \-f .Fl t
.IR tarfile] .Op Fl f Ar tarfile
.RB [ \-C .Nm
.IR dir ] .Op Fl C Ar dir
.RB [ - ] c .Op Fl jz
.I dir .Fl c Ar dir
.Op Fl f Ar tarfile
.B tar .Nm
.RB [ \-C .Op Fl C Ar dir
.IR dir ] .Op Fl jz
.B cf .Fl cf
.I tarfile .Ar tarfile Ar dir
.I dir .Sh DESCRIPTION
.Nm
.B tar
.RB [ \-C
.IR dir ]
.B x|tf
.I tarfile
.SH DESCRIPTION
.B tar
is the standard file archiver. Generally the archives is the standard file archiver. Generally the archives
created with it are further compressed. created with it are further compressed.
.SH OPTIONS .Sh OPTIONS
.TP .Bl -tag -width Ds
.B x .It Fl c Ar path
extract tarball from stdin Creates tarball from
.TP .Ar path .
.B t .It Fl C Ar dir
list all files in tarball from stdin Change directory to
.TP .Ar dir
.BI c\ path
creates tarball from
.I path
and prints it to stdout
.TP
.BI f\ tarfile
Make
.I tarfile
be the archive, rather than stdin or stdout.
.TP
.BI C\ dir
Change dierctory to
.I dir
before beginning. before beginning.
.SH SEE ALSO .It Fl f Ar tarfile
.IR ar (1) Make
.IR gzip (1) .Ar tarfile
.IR bzip2 (1) be the archive, rather than stdin or stdout.
.It Fl j
Compress archive using bzip2. The
.Xr bzip2 1
utility must be installed separately.
.It Fl m
Do not preserve modification time.
.It Fl t
List all files in tarball.
.It Fl x
Extract tarball.
.It Fl z
Compress archive using gzip. The
.Xr gzip 1
utility must be installed separately.
.El
.Sh SEE ALSO
.Xr ar 1 ,
.Xr bzip2 1 ,
.Xr gzip 1