date doc: warn at -d about LC_TIME
authorjidanni@jidanni.org <jidanni@jidanni.org>
Thu, 29 Jan 2009 15:04:46 +0000 (23:04 +0800)
committerJim Meyering <meyering@redhat.com>
Mon, 2 Feb 2009 07:40:18 +0000 (08:40 +0100)
We also warn here about LC_TIME, so the user will know even if he
doesn't look in the @xref{Date input formats}.

doc/coreutils.texi

index 07986e8..c3a1164 100644 (file)
@@ -13485,6 +13485,11 @@ format.  It can contain month names, time zones, @samp{am} and @samp{pm},
 14:19:13.489392193 +0530"} specifies the instant of time that is
 489,392,193 nanoseconds after February 27, 2004 at 2:19:13 PM in a
 time zone that is 5 hours and 30 minutes east of @acronym{UTC}.@*
+Note: input currently must be in locale independent format. E.g., the
+LC_TIME=C below is needed to print back the correct date in many locales:
+@example
+date -d "$(LC_TIME=C date)"
+@end example
 @xref{Date input formats}.
 
 @item -f @var{datefile}