e51a2e6d2f
The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
66 lines
1.1 KiB
Groff
66 lines
1.1 KiB
Groff
.Dd 2015-10-08
|
|
.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.
|