diff options
Diffstat (limited to 'man/touch.1')
| -rw-r--r-- | man/touch.1 | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/man/touch.1 b/man/touch.1 new file mode 100644 index 0000000..152707d --- /dev/null +++ b/man/touch.1 @@ -0,0 +1,84 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3. +.TH TOUCH "1" "March 2020" "GNU coreutils 8.32" "User Commands" +.SH NAME +touch \- change file timestamps +.SH SYNOPSIS +.B touch +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Update the access and modification times of each FILE to the current time. +.PP +A FILE argument that does not exist is created empty, unless \fB\-c\fR or \fB\-h\fR +is supplied. +.PP +A FILE argument string of \- is handled specially and causes touch to +change the times of the file associated with standard output. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR +change only the access time +.TP +\fB\-c\fR, \fB\-\-no\-create\fR +do not create any files +.TP +\fB\-d\fR, \fB\-\-date\fR=\fI\,STRING\/\fR +parse STRING and use it instead of current time +.TP +\fB\-f\fR +(ignored) +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect each symbolic link instead of any referenced +file (useful only on systems that can change the +timestamps of a symlink) +.TP +\fB\-m\fR +change only the modification time +.TP +\fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR +use this file's times instead of current time +.TP +\fB\-t\fR STAMP +use [[CC]YY]MMDDhhmm[.ss] instead of current time +.TP +\fB\-\-time\fR=\fI\,WORD\/\fR +change the specified time: +WORD is access, atime, or use: equivalent to \fB\-a\fR +WORD is modify or mtime: equivalent to \fB\-m\fR +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Note that the \fB\-d\fR and \fB\-t\fR options accept different time\-date formats. +.SH "DATE STRING" +.\" NOTE: keep this paragraph in sync with the one in date.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. +.SH AUTHOR +Written by Paul Rubin, Arnold Robbins, Jim Kingdon, +David MacKenzie, and Randy Smith. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2020 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/touch> +.br +or available locally via: info \(aq(coreutils) touch invocation\(aq |