changeset 13775:2654d3d40f47

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>
author Eric Blake <eblake@redhat.com>
date Thu, 07 Oct 2010 08:06:44 -0600
parents e53ef64052ed
children 2285cf35fa15
files ChangeLog doc/parse-datetime.texi
diffstat 2 files changed, 12 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- 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.
--- a/doc/parse-datetime.texi
+++ b/doc/parse-datetime.texi
@@ -543,15 +543,19 @@
 @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.