sbase

suckless unix tools
git clone git://git.2f30.org/sbase
Log | Files | Refs | README | LICENSE

commit 67e374bcba2c40aebd4a82353c967e1bfeedf003
parent 6c2f9615ac5f63c72a9b9b1646e1d4fcafef2555
Author: Hiltjo Posthuma <hiltjo@codemadness.org>
Date:   Sat, 31 Jan 2015 14:05:23 +0100

tar.1: convert to mandoc

- simplify usage line.
- add new flags (-m, -j and -z).
- fix typos.

Diffstat:
Mtar.1 | 114+++++++++++++++++++++++++++++++++++++++----------------------------------------
1 file changed, 56 insertions(+), 58 deletions(-)

diff --git a/tar.1 b/tar.1 @@ -1,62 +1,60 @@ -.TH TAR 1 sbase\-VERSION -.SH NAME -tar \- create, list or extract a tape archive -.SH SYNOPSIS -.B tar -.RB [ \-f -.IR tarfile] -.RB [ \-C -.IR dir ] -.RB [ - ] x | t - -.B tar -.RB [ \-f -.IR tarfile] -.RB [ \-C -.IR dir ] -.RB [ - ] c -.I dir - -.B tar -.RB [ \-C -.IR dir ] -.B cf -.I tarfile -.I dir - -.B tar -.RB [ \-C -.IR dir ] -.B x|tf -.I tarfile - -.SH DESCRIPTION -.B tar +.Dd January 31, 2015 +.Dt TAR 1 sbase\-VERSION +.Os +.Sh NAME +.Nm tar +.Nd create, list or extract a tape archive +.Sh SYNOPSIS +.Nm +.Op Fl C Ar dir +.Op Fl jz +.Fl x Op Fl m +| +.Fl t +.Op Fl f Ar tarfile +.Nm +.Op Fl C Ar dir +.Op Fl jz +.Fl c Ar dir +.Op Fl f Ar tarfile +.Nm +.Op Fl C Ar dir +.Op Fl jz +.Fl cf +.Ar tarfile Ar dir +.Sh DESCRIPTION +.Nm is the standard file archiver. Generally the archives created with it are further compressed. -.SH OPTIONS -.TP -.B x -extract tarball from stdin -.TP -.B t -list all files in tarball from stdin -.TP -.BI c\ path -creates tarball from -.I path -and prints it to stdout -.TP -.BI f\ tarfile +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl c Ar path +Creates tarball from +.Ar path . +.It Fl C Ar dir +Change directory to +.Ar dir +before beginning. +.It Fl f Ar tarfile Make -.I tarfile +.Ar tarfile be the archive, rather than stdin or stdout. -.TP -.BI C\ dir -Change dierctory to -.I dir -before beginning. -.SH SEE ALSO -.IR ar (1) -.IR gzip (1) -.IR bzip2 (1) +.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