From a17b2d91d862b84c0f77b1e23c02359945ed69ca Mon Sep 17 00:00:00 2001 From: Nicholas Clark Date: Thu, 1 Sep 2011 21:51:41 +0200 Subject: [PATCH] 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. --- ext/POSIX/lib/POSIX.pod | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/ext/POSIX/lib/POSIX.pod b/ext/POSIX/lib/POSIX.pod index c2ca1c9..f935ae0 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, C, C, C, 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 and then use the fully qualified names (ie. C). +POSIX ()> and then use the fully qualified names (ie. C), +or by giving an explicit import list. If you do neither, and opt for the +default, C 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 -- 2.7.4