summaryrefslogtreecommitdiff
path: root/ext/POSIX
diff options
context:
space:
mode:
authorJames E Keenan <jkeenan@cpan.org>2017-09-26 08:52:15 -0400
committerJames E Keenan <jkeenan@cpan.org>2017-09-26 08:52:15 -0400
commitdc416353138cab69d334678ddd9a81b590030ef2 (patch)
tree33e7035d8fda34e8ab550310f838e34a36c96dec /ext/POSIX
parent60dfa515ef51ddf3e702d92aee4fffb166ad4d38 (diff)
downloadperl-dc416353138cab69d334678ddd9a81b590030ef2.tar.gz
Document that POSIX::localtime needs explicit argument.
For: RT #132145
Diffstat (limited to 'ext/POSIX')
-rw-r--r--ext/POSIX/lib/POSIX.pod12
1 files changed, 10 insertions, 2 deletions
diff --git a/ext/POSIX/lib/POSIX.pod b/ext/POSIX/lib/POSIX.pod
index d3f9e8934f..9d2c0320d6 100644
--- a/ext/POSIX/lib/POSIX.pod
+++ b/ext/POSIX/lib/POSIX.pod
@@ -24,7 +24,7 @@ interfaces.
This document gives a condensed list of the features available in the POSIX
module. Consult your operating system's manpages for general information on
most features. Consult L<perlfunc> for functions which are noted as being
-identical to Perl's builtin functions.
+identical or almost identical to Perl's builtin functions.
The first section describes POSIX functions from the 1003.1 specification.
The second section describes some classes for signal objects, TTY objects,
@@ -958,7 +958,15 @@ POSIX.1-2008 and are only available on systems that support them.
=item C<localtime>
This is identical to Perl's builtin C<localtime()> function for
-converting seconds since the epoch to a date see L<perlfunc/localtime>.
+converting seconds since the epoch to a date see L<perlfunc/localtime> except
+that C<POSIX::localtime()> must be provided an explicit value (rather than
+relying an implicit C<$_>:
+
+ @localtime = POSIX::localtime(time); # Good
+
+ @localtime = localtime(); # Good
+
+ @localtime = POSIX::localtime(); # Throws exception
=item C<log>