Change the synopsis in POSIX.pod to stress use POSIX ();

Explicitly warn that the default of importing everything means that
use POSIX; has to import 553 symbols. Hence it's probably better to use
an explicit import list, or import nothing.

1 files changed, 4 insertions, 2 deletions

diff --git a/ext/POSIX/lib/POSIX.pod b/ext/POSIX/lib/POSIX.pod
index c2ca1c92ee..f935ae0574 100644
--- a/ext/POSIX/lib/POSIX.pod
+++ b/ext/POSIX/lib/POSIX.pod
@@ -4,7 +4,7 @@ POSIX - Perl interface to IEEE Std 1003.1
 
 =head1 SYNOPSIS
 
-    use POSIX;
+    use POSIX ();
     use POSIX qw(setsid);
     use POSIX qw(:errno_h :fcntl_h);
 
@@ -26,7 +26,9 @@ 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
 compatibility feature.  You can stop the exporting by saying C<use
-POSIX ()> and then use the fully qualified names (ie. C<POSIX::SEEK_END>).
+POSIX ()> and then use the fully qualified names (ie. C<POSIX::SEEK_END>),
+or by giving an explicit import list.  If you do neither, and opt for the
+default, C<use POSIX;> has to import I<553 symbols>.
 
 This document gives a condensed list of the features available in the POSIX
 module.  Consult your operating system's manpages for general information on