summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBob Proulx <bob@proulx.com>2008-01-28 22:19:21 -0700
committerJim Meyering <meyering@redhat.com>2008-01-29 14:27:06 +0100
commit69b1a35c6df3327e557b995cc1f2b5473b52bae3 (patch)
tree02d77a0d618b8c790a0731aac852352b09a4c3bf
parentc1c51585f67d64bae62d5805cc3aac31984fe44d (diff)
downloadcoreutils-69b1a35c6df3327e557b995cc1f2b5473b52bae3.tar.xz
Improve the man pages of --date=STRING for 'date' and 'touch'.
* man/date.x: Add a compact description of the --date=STRING. * man/touch.x: Likewise. Reported by A. Costa in http://bugs.debian.org/363011
-rw-r--r--ChangeLog7
-rw-r--r--man/date.x9
-rw-r--r--man/touch.x9
3 files changed, 25 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 8415d3d88..1ef732b2e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-01-29 Bob Proulx <bob@proulx.com>
+
+ Improve the man pages of --date=STRING for 'date' and 'touch'.
+ * man/date.x: Add a compact description of the --date=STRING.
+ * man/touch.x: Likewise.
+ Reported by A. Costa in http://bugs.debian.org/363011
+
2008-01-29 Michael Stone <mstone@debian.org>
Improve the description of when dd outputs its final statistics.
diff --git a/man/date.x b/man/date.x
index bae08ac98..c6e3a6570 100644
--- a/man/date.x
+++ b/man/date.x
@@ -2,3 +2,12 @@
date \- print or set the system date and time
[DESCRIPTION]
.\" Add any additional description here
+[DATE STRING]
+.\" NOTE: keep this paragraph in sync with the one in touch.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". If empty the string indicates the beginning of
+the day. The string may contain calendar date items, time of day
+items, time zone items, day of week items, relative items, and pure
+numbers. The date string format is more complex than is easily
+documented here but is fully described in the info documentation.
diff --git a/man/touch.x b/man/touch.x
index 64b99dfa1..71f405bf6 100644
--- a/man/touch.x
+++ b/man/touch.x
@@ -2,3 +2,12 @@
touch \- change file timestamps
[DESCRIPTION]
.\" Add any additional description here
+[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". If empty the string indicates the beginning of
+the day. The string may contain calendar date items, time of day
+items, time zone items, day of week items, relative items, and pure
+numbers. The date string format is more complex than is easily
+documented here but is fully described in the info documentation.