From c32741d1abc170129d2be40853e91b14ea131d5d Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Sat, 23 Sep 2000 04:36:14 +0000
Subject: Added warnings about platform vagaries to the strptime()
 documentation. This closes SourceForge bug #115146.

---
 Doc/lib/libtime.tex | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/Doc/lib/libtime.tex b/Doc/lib/libtime.tex
index b343c95..28771e9 100644
--- a/Doc/lib/libtime.tex
+++ b/Doc/lib/libtime.tex
@@ -237,7 +237,15 @@ directives as those used by \function{strftime()}; it defaults to
 returned by \function{ctime()}.  The same platform caveats apply; see
 the local \UNIX{} documentation for restrictions or additional
 supported directives.  If \var{string} cannot be parsed according to
-\var{format}, \exception{ValueError} is raised.
+\var{format}, \exception{ValueError} is raised.  Values which are not
+provided as part of the input string are filled in with default
+values; the specific values are platform-dependent as the XPG standard
+does not provide sufficient information to constrain the result.
+
+\strong{Note:} This function relies entirely on the underlying
+platform's C library for the date parsing, and some of these libraries
+are buggy.  There's nothing to be done about this short of a new,
+portable implementation of \cfunction{strptime()}.
 
 Availability: Most modern \UNIX{} systems.
 \end{funcdesc}
-- 
cgit v0.12

