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 <[EMAIL PROTECTED]> + + 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 <[EMAIL PROTECTED]> 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 -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
