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

2 files changed, 18 insertions, 0 deletions

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.