Improve the man pages of --date=STRING for 'date' and 'touch'.

[Bob Proulx]

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