[hackers] [sbase] tar.1: convert to mandoc || Hiltjo Posthuma

From: <git_AT_suckless.org>
Date: Sat, 31 Jan 2015 20:14:56 +0100 (CET)

commit 80ada290d2076eca71318aea22c1738fa17d2510
Author: Hiltjo Posthuma <hiltjo_AT_codemadness.org>
Date: Sat Jan 31 14:05:23 2015 +0100

    tar.1: convert to mandoc
    
    - simplify usage line.
    - add new flags (-m, -j and -z).
    - fix typos.

diff --git a/tar.1 b/tar.1
index 3addae4..3f13c85 100644
--- a/tar.1
+++ b/tar.1
_AT_@ -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
Received on Sat Jan 31 2015 - 20:14:56 CET