From: Michael G. Schwern <schwern@pobox.com>
Date: Wed, 30 Apr 2003 18:19:32 +0000 (-0700)
Subject: Deceptive POSIX exporting docs
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=90b1bb76ac33d378b485f66b5eb18e95143363c9;p=p5sagit%2Fp5-mst-13.2.git

Deceptive POSIX exporting docs
Message-ID: <20030501011932.GM701@windhund.schwern.org>

p4raw-id: //depot/perl@19382
---

diff --git a/ext/POSIX/POSIX.pod b/ext/POSIX/POSIX.pod
index d16bc32..1ba4945 100644
--- a/ext/POSIX/POSIX.pod
+++ b/ext/POSIX/POSIX.pod
@@ -19,10 +19,14 @@ POSIX - Perl interface to IEEE Std 1003.1
 
 The POSIX module permits you to access all (or nearly all) the standard
 POSIX 1003.1 identifiers.  Many of these identifiers have been given Perl-ish
-interfaces.  Things which are C<#defines> in C, like EINTR or O_NDELAY, are
-automatically exported into your namespace.  All functions are only exported
-if you ask for them explicitly.  Most likely people will prefer to use the
-fully-qualified function names.
+interfaces.
+
+I<Everything is exported by default> with the exception of any POSIX
+functions with the same name as a built-in Perl function, such as
+C<abs>, C<alarm>, C<rmdir>, C<write>, etc.., which will be exported
+only if you ask for them explicitly.  This is an unfortunate backwards
+compatiblity feature.  You can stop the exporting by saying C<use
+POSIX ()> and then use the fully qualified names (ie. C<POSIX::SEEK_END>).
 
 This document gives a condensed list of the features available in the POSIX
 module.  Consult your operating system's manpages for general information on