docs: update parse-datetime history

* doc/parse-datetime.texi (Authors of parse_datetime): Better
documentation of this function's history and alternatives.

Signed-off-by: Eric Blake <eblake@redhat.com>

diff --git a/ChangeLog b/ChangeLog
index 7257a90..f3ca2ca 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2010-10-07  Eric Blake  <eblake@redhat.com>
 
+       docs: update parse-datetime history
+       * doc/parse-datetime.texi (Authors of parse_datetime): Better
+       documentation of this function's history and alternatives.
+
        cygwin: use more robust version check
        * m4/memmem.m4 (gl_FUNC_MEMMEM_SIMPLE, gl_FUNC_MEMMEM): Don't
        exclude an eventual cygwin 1.9.1.

diff --git a/doc/parse-datetime.texi b/doc/parse-datetime.texi
index b0a8340..8218d9f 100644 (file)
--- a/doc/parse-datetime.texi
+++ b/doc/parse-datetime.texi
@@ -543,15 +543,19 @@ libc, The GNU C Library}.
 @cindex MacKenzie, David
 @cindex Meyering, Jim
 @cindex Eggert, Paul
-@code{parse_datetime} was originally implemented by Steven M. Bellovin
+@code{parse_datetime} started life as @code{getdate}, as originally
+implemented by Steven M. Bellovin
 (@email{smb@@research.att.com}) while at the University of North Carolina
 at Chapel Hill.  The code was later tweaked by a couple of people on
 Usenet, then completely overhauled by Rich $alz (@email{rsalz@@bbn.com})
 and Jim Berets (@email{jberets@@bbn.com}) in August, 1990.  Various
 revisions for the @sc{gnu} system were made by David MacKenzie, Jim Meyering,
-Paul Eggert and others, including renaming it to @code{get_date} and
-then to @code{parse_datetime}
-to avoid confusion with the Posix function @code{getdate}.
+Paul Eggert and others, including renaming it to @code{get_date} to
+avoid a conflict with the alternative Posix function @code{getdate},
+and a later rename to @code{parse_datetime}.  The Posix function
+@code{getdate} can parse more locale-specific dates using
+@code{strptime}, but relies on an environment variable and external
+file, and lacks the thread-safety of @code{parse_datetime}.
 
 @cindex Pinard, F.
 @cindex Berry, K.