1.fp 5 CW
2.de Af
3.ds ;G \\*(;G\\f\\$1\\$3\\f\\$2
4.if !\\$4 .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
5..
6.de aF
7.ie \\$3 .ft \\$1
8.el \{\
9.ds ;G \&
10.nr ;G \\n(.f
11.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
12\\*(;G
13.ft \\n(;G \}
14..
15.de L
16.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
17..
18.de LR
19.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
20..
21.de RL
22.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
23..
24.de EX		\" start example
25.ta 1i 2i 3i 4i 5i 6i
26.PP
27.RS 
28.PD 0
29.ft 5
30.nf
31..
32.de EE		\" end example
33.fi
34.ft
35.PD
36.RE
37.PP
38..
39.TH TOUCH 3
40.SH NAME
41touch \- set file access and modify times
42.SH SYNOPSIS
43.L "#include <ast.h>"
44.sp
45.L "int touch(const char* path, time_t atime, time_t mtime, int force);"
46.SH DESCRIPTION
47.L touch
48sets the access and modify times of the file named by
49.LR path .
50If
51.L "force != 0"
52then the file is created if it doesn't exist;
53otherwise the file is not created and
54.L \-1
55is returned.
56If
57.L "force < 0"
58then
59.L atime
60and
61.L mtime
62are taken verbatim; otherwise
63.L "(time_t)(-1)"
64retains the current value for the file and
65.L "(time_t)(0)"
66uses the current time.
67.SH CAVEATS
68By default the change time is always changed to the current time.
69