sbase/tar.1

.Dd February 8, 2015
.Dt TAR 1
.Os sbase
.Sh NAME
.Nm tar
.Nd create, list or extract a tape archive
.Sh SYNOPSIS
.Nm
.Op Fl C Ar dir
.Op Fl j | Fl z
.Fl x Op Fl m | Fl t
.Op Fl f Ar file
.Nm
.Op Fl C Ar dir
.Op Fl h
.Op Fl j | Fl z
.Fl c Ar dir
.Op Fl f Ar file
.Nm
.Op Fl C Ar dir
.Op Fl h
.Op Fl j | Fl z
.Fl cf
.Ar file Ar dir
.Sh DESCRIPTION
.Nm
is the standard file archiver.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl c Ar path
Create archive from
.Ar path .
.It Fl C Ar dir
Change directory to
.Ar dir
before beginning.
.It Fl f Ar file
Set
.Ar file
as input | output archive instead of stdin | stdout.
.It Fl m
Do not preserve modification time.
.It Fl t
List all files in the archive.
.It Fl x
Extract archive.
.It Fl h
Always dereference symbolic links while recursively traversing directories.
.It Fl j | Fl z
Use bzip2 | gzip compression. The
.Xr bzip2 1 |
.Xr gzip 1
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
.Sh SEE ALSO
.Xr ar 1 ,
.Xr bzip2 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.
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Dd February 8, 2015`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 13:20:02 +00:00			`.Dt TAR 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 19:37:03 +00:00			`.Os sbase`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Sh NAME`
			`.Nm tar`
			`.Nd create, list or extract a tape archive`
			`.Sh SYNOPSIS`
			`.Nm`
			`.Op Fl C Ar dir`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Op Fl j \| Fl z`
			`.Fl x Op Fl m \| Fl t`
			`.Op Fl f Ar file`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Nm`
			`.Op Fl C Ar dir`
tar.1: add symbolic link dereferencing to manpage 2015-02-09 21:42:56 +00:00			`.Op Fl h`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Op Fl j \| Fl z`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Fl c Ar dir`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Op Fl f Ar file`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Nm`
			`.Op Fl C Ar dir`
tar.1: add symbolic link dereferencing to manpage 2015-02-09 21:42:56 +00:00			`.Op Fl h`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Op Fl j \| Fl z`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Fl cf`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Ar file Ar dir`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Sh DESCRIPTION`
			`.Nm`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`is the standard file archiver.`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
			`.It Fl c Ar path`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`Create archive from`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Ar path .`
			`.It Fl C Ar dir`
			`Change directory to`
			`.Ar dir`
			`before beginning.`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.It Fl f Ar file`
			`Set`
			`.Ar file`
			`as input \| output archive instead of stdin \| stdout.`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.It Fl m`
			`Do not preserve modification time.`
			`.It Fl t`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`List all files in the archive.`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.It Fl x`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`Extract archive.`
tar.1: add symbolic link dereferencing to manpage 2015-02-09 21:42:56 +00:00			`.It Fl h`
			`Always dereference symbolic links while recursively traversing directories.`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.It Fl j \| Fl z`
			`Use bzip2 \| gzip compression. The`
			`.Xr bzip2 1 \|`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.Xr gzip 1`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`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`
tar.1: convert to mandoc - simplify usage line. - add new flags (-m, -j and -z). - fix typos. 2015-01-31 13:05:23 +00:00			`.El`
			`.Sh SEE ALSO`
			`.Xr ar 1 ,`
			`.Xr bzip2 1 ,`
			`.Xr gzip 1`
Refactor tar(1) manpage 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. 2015-02-08 22:16:27 +00:00			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the UStar (Uniform Standard Tape ARchive)`
			`format defined in the`
			`.St -p1003.1-88`
			`specification.`