fbt/sbase
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Refactor tar(1) manpage

Browse Source 
and mark it as finished in the README.
Specifically, add a small section on the compression flags, which
are basically an infected GNU limb which should be removed from
the face of the earth as soon as possible.
This commit is contained in:
FRIGN 2015-02-08 23:16:27 +01:00
parent 1df65f4af4
commit 5699d5fb64
2 changed files with 38 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README
View File

@ -65,7 +65,7 @@ The following tools are implemented ('*' == finished, '#' == UTF-8 support,
strings no -a, -n, -t strings no -a, -n, -t
=* sync non-posix none =* sync non-posix none
= tail no -c, -f = tail no -c, -f
= tar non-posix none =* tar non-posix none
=* tee yes none =* tee yes none
test yes none test yes none
= touch no -r = touch no -r

63
tar.1
View File

@ -1,4 +1,4 @@
.Dd January 31, 2015 .Dd February 8, 2015
.Dt TAR 1 .Dt TAR 1
.Os sbase .Os sbase
.Sh NAME .Sh NAME
@ -7,54 +7,65 @@
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm .Nm
.Op Fl C Ar dir .Op Fl C Ar dir
.Op Fl jz .Op Fl j | Fl z
.Fl x Op Fl m .Fl x Op Fl m | Fl t
| .Op Fl f Ar file
.Fl t
.Op Fl f Ar tarfile
.Nm .Nm
.Op Fl C Ar dir .Op Fl C Ar dir
.Op Fl jz .Op Fl j | Fl z
.Fl c Ar dir .Fl c Ar dir
.Op Fl f Ar tarfile .Op Fl f Ar file
.Nm .Nm
.Op Fl C Ar dir .Op Fl C Ar dir
.Op Fl jz .Op Fl j | Fl z
.Fl cf .Fl cf
.Ar tarfile Ar dir .Ar file Ar dir
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is the standard file archiver. Generally the archives is the standard file archiver.
created with it are further compressed.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl c Ar path .It Fl c Ar path
Creates tarball from Create archive from
.Ar path . .Ar path .
.It Fl C Ar dir .It Fl C Ar dir
Change directory to Change directory to
.Ar dir .Ar dir
before beginning. before beginning.
.It Fl f Ar tarfile .It Fl f Ar file
Make Set
.Ar tarfile .Ar file
be the archive, rather than stdin or stdout. as input | output archive instead of stdin | stdout.
.It Fl j
Compress archive using bzip2. The
.Xr bzip2 1
utility must be installed separately.
.It Fl m .It Fl m
Do not preserve modification time. Do not preserve modification time.
.It Fl t .It Fl t
List all files in tarball. List all files in the archive.
.It Fl x .It Fl x
Extract tarball. Extract archive.
.It Fl z .It Fl j | Fl z
Compress archive using gzip. The Use bzip2 | gzip compression. The
.Xr bzip2 1 |
.Xr gzip 1 .Xr gzip 1
utility must be installed separately. utilities must be installed separately.
Using these flags is discouraged in favour of the flexibility
and clarity of pipes:
.Bd -literal -offset indent
$ bzcat archive.tar.bz2 | tar -x
$ zcat archive.tar.gz | tar -x
.Ed
.Bd -literal -offset indent
$ tar -c file ... | bzip2 > archive.tar.bz2
$ tar -c file ... | gzip2 > archive.tar.gz
.Ed
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr ar 1 , .Xr ar 1 ,
.Xr bzip2 1 , .Xr bzip2 1 ,
.Xr gzip 1 .Xr gzip 1
.Sh STANDARDS
The
.Nm
utility is compliant with the UStar (Uniform Standard Tape ARchive)
format defined in the
.St -p1003.1-88
specification.