From: Pádraig Brady <P@draigBrady.com>
Date: Thu, 2 Jun 2011 12:00:18 +0000 (+0100)
Subject: doc: add examples to date --help
X-Git-Tag: v8.13~126
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=77d41d2e20fe18fc5830a6601680751209dddb33;p=thirdparty%2Fcoreutils.git

doc: add examples to date --help

* src/date.c (usage): Add examples for TZ handling,
and "seconds since epoch" parsing, neither of which
was mentioned in the man page until now.
* THANKS.in: Add Rick.
Suggested by Rick Stanley.
---

diff --git a/THANKS.in b/THANKS.in
index ec97e9c315..3019f4f4c9 100644
--- a/THANKS.in
+++ b/THANKS.in
@@ -490,6 +490,7 @@ Richard J. Rauenzahn                rrauenza@hairball.cup.hp.com
 Richard Neill                       rn214@hermes.cam.ac.uk
 Richard Sharman                     rsharman@magmacom.com
 Rick Sladkey                        jrs@world.std.com
+Rick Stanley                        rstanley@rsiny.com
 Rik Faith                           faith@cs.unc.edu
 Risto Kankkunen                     kankkune@lingsoft.fi
 Rob Wortman                         wyrm@haell.com
diff --git a/src/date.c b/src/date.c
index 61d481827c..6439d165ab 100644
--- a/src/date.c
+++ b/src/date.c
@@ -235,6 +235,18 @@ After any flags comes an optional field width, as a decimal number;\n\
 then an optional modifier, which is either\n\
 E to use the locale's alternate representations if available, or\n\
 O to use the locale's alternate numeric symbols if available.\n\
+"), stdout);
+      fputs (_("\
+\n\
+Examples:\n\
+Convert seconds since the epoch (1970-01-01 UTC) to a date\n\
+  $ date --date='@2147483647'\n\
+\n\
+Show the time on the west coast of the US (use tzselect(1) to find TZ)\n\
+  $ TZ='America/Los_Angeles' date\n\
+\n\
+Show the local time for 9AM next Friday on the west coast of the US\n\
+  $ date --date='TZ=\"America/Los_Angeles\" 09:00 next Fri'\n\
 "), stdout);
       emit_ancillary_info ();
     }