mirror of
git://git.suckless.org/sbase
synced 2025-01-02 21:12:15 +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.
67 lines
1.1 KiB
Groff
67 lines
1.1 KiB
Groff
.Dd October 8, 2015
|
|
.Dt TOUCH 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm touch
|
|
.Nd set file timestamps
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl acm
|
|
.Op Fl d Ar time | Fl r Ar ref_file | Fl T Ar time | Fl t Ar time
|
|
.Ar file ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
sets the access and modification time of each
|
|
.Ar file
|
|
to the current time of day.
|
|
If
|
|
.Ar file
|
|
doesn't exist, it is created with default permissions.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Ds
|
|
.It Fl a | Fl m
|
|
Set the access | modification time of
|
|
.Ar file.
|
|
.It Fl c
|
|
Don't create
|
|
.Ar file
|
|
if it doesn't exist, not affecting exit status.
|
|
.It Fl d Ar time
|
|
Set the
|
|
.Ar time
|
|
of the format YYYY-MM-DDThh:mm:SS[Z] used for
|
|
.Op Fl am .
|
|
.It Fl r Ar ref_file
|
|
Set the
|
|
.Ar time
|
|
used for
|
|
.Op Fl am
|
|
to the modification time of
|
|
.Ar ref_file .
|
|
.It Fl T Ar time
|
|
Set the
|
|
.Ar time
|
|
used for
|
|
.Op Fl am
|
|
given as the number of seconds since the
|
|
Unix epoch 1970-01-01T00:00:00Z.
|
|
.It Fl t Ar time
|
|
Set the
|
|
.Ar time
|
|
of the format [[CC]YY]MMDDhhmm[.SS] used for
|
|
.Op Fl am .
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr date 1
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is compliant with the
|
|
.St -p1003.1-2013
|
|
specification except from fractional seconds with
|
|
.Op Fl d .
|
|
.Pp
|
|
The
|
|
.Op Fl T
|
|
flag is an extension to that specification.
|