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 b343c95dc773e73937fad2f33929974879ca9320..28771e92142138297dbc1331e8dfa0949036eff1 100644 (file)
--- 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}