[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Improve the man pages of --date=STRING for 'date' and 'touch'.
From: |
Bob Proulx |
Subject: |
Improve the man pages of --date=STRING for 'date' and 'touch'. |
Date: |
Mon, 28 Jan 2008 22:39:34 -0700 |
User-agent: |
Mutt/1.5.13 (2006-08-11) |
In an attempt to improve the 'date' and 'touch' man pages here is a
proposal for a concise description of --date=STRING.
Bob
git fetch --no-tags git://git.proulx.com/coreutils date-string:date-string
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
---
ChangeLog | 7 +++++++
man/date.x | 8 ++++++++
man/touch.x | 8 ++++++++
3 files changed, 23 insertions(+), 0 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index f89f684..b82f11a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-01-28 Bob Proulx <address@hidden>
+
+ 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-26 Jim Meyering <address@hidden>
Work around Darwin9's set-GID-like group ownership inheritance.
diff --git a/man/date.x b/man/date.x
index bae08ac..13d52cf 100644
--- a/man/date.x
+++ b/man/date.x
@@ -2,3 +2,11 @@
date \- print or set the system date and time
[DESCRIPTION]
.\" Add any additional description here
+[DATE STRING]
+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 64b99df..361a99e 100644
--- a/man/touch.x
+++ b/man/touch.x
@@ -2,3 +2,11 @@
touch \- change file timestamps
[DESCRIPTION]
.\" Add any additional description here
+[DATE STRING]
+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.
--
1.4.4.4