mirror of
git://git.suckless.org/sbase
synced 2026-01-26 13:43:17 +00:00
a0998d0252
From ed5e4d34a16436a37c0e084666fcfb77cc4859c3 Mon Sep 17 00:00:00 2001 From: Hiltjo Posthuma <hiltjo@codemadness.org> Date: Thu, 31 Jul 2025 14:42:59 +0200 Subject: [PATCH 4/4] improve man pages and some warnings. Checking for warnings: mandoc -Tlint *.1 - Swap .St -p1003.1-2013 macro with text: mdoc does not support this macro and some texts were changed, like commit d4dfd42d3580ad36bedfdc5b8924ff6683981f53 - Typo fixes: exeption -> exception. - xargs.1: document -P extension. - sed.1: remove use of .Pp of .Ss. - Wrap lines to less than 80 characters and use a new sentence for each line. - find.1: Xr reference C library functions.
64 lines
1.1 KiB
Groff
64 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
|
|
POSIX.1-2013.
|
|
Except for fractional seconds with
|
|
.Op Fl d .
|
|
.Pp
|
|
The
|
|
.Op Fl T
|
|
flag is an extension to that specification.
|