From: Fred Drake <fdrake@acm.org>
Date: Sat, 23 Sep 2000 04:36:14 +0000 (+0000)
Subject: Added warnings about platform vagaries to the strptime() documentation.
X-Git-Tag: v2.0b2~101
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c32741d1abc170129d2be40853e91b14ea131d5d;p=python

Added warnings about platform vagaries to the strptime() documentation.
This closes SourceForge bug #115146.
---

diff --git a/Doc/lib/libtime.tex b/Doc/lib/libtime.tex
index b343c95dc7..28771e9214 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}