[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] Clarify touch documentation of file arguments.
From: |
Bob Proulx |
Subject: |
[PATCH] Clarify touch documentation of file arguments. |
Date: |
Tue, 21 Aug 2007 00:16:31 -0600 |
User-agent: |
Mutt/1.5.9i |
* 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.
Signed-off-by: Bob Proulx <address@hidden>
---
ChangeLog | 8 ++++++++
doc/coreutils.texi | 7 ++++---
src/touch.c | 7 +++++--
3 files changed, 17 insertions(+), 5 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 5f188d7..291b9f3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2007-08-20 Bob Proulx <address@hidden>
+
+ 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 <address@hidden>
* NEWS: The old cp -p bug affected coreutils releases before 6.0.
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index e3164a9..800ca64 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -9271,10 +9271,11 @@ touch address@hidden@dots{} @address@hidden
@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
diff --git a/src/touch.c b/src/touch.c
index 963e7ff..2540558 100644
--- a/src/touch.c
+++ b/src/touch.c
@@ -233,6 +233,11 @@ usage (int status)
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\
@@ -256,8 +261,6 @@ Mandatory arguments to long options are
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 ();
}
--
1.4.1.1