22921a859f
Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
67 lines
1.1 KiB
Groff
67 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.
|