Re: [perl #35420] localtime corruption

Message-ID: <20050526203938.GG11558@windhund.schwern.org>

p4raw-id: //depot/perl@24593

2 files changed, 15 insertions, 0 deletions

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 5414e324d4..9732bdb66c 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -2186,6 +2186,8 @@ This scalar value is B<not> locale dependent (see L<perllocale>), but is
 instead a Perl builtin.  To get somewhat similar but locale dependent date
 strings, see the example in L</localtime>.
 
+See L<perlport/gmtime> for portability concerns.
+
 =item goto LABEL
 
 =item goto EXPR
@@ -2583,6 +2585,8 @@ try for example:
 Note that the C<%a> and C<%b>, the short forms of the day of the week
 and the month of the year, may not necessarily be three characters wide.
 
+See L<perlport/localtime> for portability concerns.
+
 =item lock THING
 
 This function places an advisory lock on a shared variable, or referenced
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 36a87050ba..8b5ea518d0 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -1773,6 +1773,10 @@ Not implemented. (S<Plan 9>)
 This operator is implemented via the File::Glob extension on most
 platforms.  See L<File::Glob> for portability information.
 
+=item gmtime
+
+Same portability caveats as L<localtime>.
+
 =item ioctl FILEHANDLE,FUNCTION,SCALAR
 
 Not implemented. (VMS)
@@ -1806,6 +1810,13 @@ Link count not updated because hard links are not quite that hard
 Hard links are implemented on Win32 (Windows NT and Windows 2000)
 under NTFS only.
 
+=item localtime
+
+Because Perl currently relies on the native standard C localtime()
+function, it is only safe to use times between 0 and (2**31)-1.  Times
+outside this range may result in unexpected behavior depending on your
+operating system's implementation of localtime().
+
 =item lstat
 
 Not implemented. (VMS, S<RISC OS>)