+2007-08-20 Bob Proulx <bob@proulx.com>
+
+ Clarify touch documentation of file arguments.
+ * src/touch.c (usage): Improve wording of documentation regarding
+ file argument handling and special handling of - argument.
+ * doc/coreutils.texi (touch invocation): Likewise.
+ Documentation problem reported by Vincent Lefevre.
+
2007-08-20 Paul Eggert <eggert@cs.ucla.edu>
* NEWS: The old cp -p bug affected coreutils releases before 6.0.
@end example
@cindex empty files, creating
-Any @var{file} that does not exist is created empty.
+Any @var{file} argument that does not exist is created empty.
-A @var{file} of @samp{-} causes @command{touch} to change the
-times of the file associated with standard output.
+A @var{file} argument string of @samp{-} is handled specially and
+causes @command{touch} to change the times of the file associated with
+standard output.
@cindex permissions, for changing file timestamps
If changing both the access and modification times to the current
fputs (_("\
Update the access and modification times of each FILE to the current time.\n\
\n\
+A FILE argument that does not exist is created empty.\n\
+\n\
+A FILE argument string of - is handled specially and causes touch to\n\
+change the times of the file associated with standard output.\n\
+\n\
"), stdout);
fputs (_("\
Mandatory arguments to long options are mandatory for short options too.\n\
fputs (_("\
\n\
Note that the -d and -t options accept different time-date formats.\n\
-\n\
-If a FILE is -, touch standard output.\n\
"), stdout);
emit_bug_reporting_address ();
}