From: Michael G. Schwern Date: Thu, 26 May 2005 13:39:38 +0000 (-0700) Subject: Re: [perl #35420] localtime corruption X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=62aa563719d028e176ee9e4eb16701b5a2193e4c;p=p5sagit%2Fp5-mst-13.2.git Re: [perl #35420] localtime corruption Message-ID: <20050526203938.GG11558@windhund.schwern.org> p4raw-id: //depot/perl@24593 --- diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 5414e32..9732bdb 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -2186,6 +2186,8 @@ This scalar value is B locale dependent (see L), but is instead a Perl builtin. To get somewhat similar but locale dependent date strings, see the example in L. +See L 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 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 36a8705..8b5ea51 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -1773,6 +1773,10 @@ Not implemented. (S) This operator is implemented via the File::Glob extension on most platforms. See L for portability information. +=item gmtime + +Same portability caveats as L. + =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)