mirror of
git://git.suckless.org/sbase
synced 2024-12-22 15:04:53 +00:00
d458fa2c7b
When viewing sbase's man pages the date displayed at the bottom is
the current date rather than the date entered in the <program>.1
file.
According to this:
https://mandoc.bsd.lv/mdoc/details/date.html
The traditional man date format used by sbase (.Dd year-month-day)
is no longer recommended and no longer supported by GNU troff or
Heirloom Docs and as a result the current date is displayed instead.
Although this format is still accepted by mandoc for backward
compatibility.
For portability it states the standard mdoc date format should be
used instead: .Dd month day, year
I applied the following patch to sbase's last commit b30fb56 and
it fixes the issue.
70 lines
1.5 KiB
Groff
70 lines
1.5 KiB
Groff
.Dd October 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 a | Fl j | Fl z
|
|
.Fl x Op Fl m | Fl t
|
|
.Op Fl f Ar file
|
|
.Op Ar file ...
|
|
.Nm
|
|
.Op Fl C Ar dir
|
|
.Op Fl J | Fl Z | Fl a | Fl j | Fl z
|
|
.Op Fl h
|
|
.Fl c Ar path ...
|
|
.Op Fl f Ar file
|
|
.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.
|
|
If '-', stdin | stdout is used.
|
|
.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 | Fl a | Fl j | Fl z
|
|
Use xz | compress | lzma | bzip2 | gzip compression or decompression.
|
|
These utilities must be installed separately.
|
|
Using these flags is discouraged in favour of the flexibility
|
|
and clarity of pipes:
|
|
.Bd -literal -offset indent
|
|
$ bzip2 -cd archive.tar.bz2 | tar -x
|
|
$ gzip -cd 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.
|