Author: autrijus
Date: Sun Feb 26 01:32:17 2006
New Revision: 7874
Modified:
doc/trunk/design/syn/S11.pod
Log:
* S11: Import from pseudo-packages like GLOBAL and CALLER.
Modified: doc/trunk/design/syn/S11.pod
==============================================================================
--- doc/trunk/design/syn/S11.pod (original)
+++ doc/trunk/design/syn/S11.pod Sun Feb 26 01:32:17 2006
@@ -155,6 +155,21 @@
require Sense;
Sense.import; # goes to the OUR scope by default, not MY
+=head1 Importing from a pseudo-package
+
+You may also import symbols from the various pseudo-packages listed in S02.
+They behave as if all their symbols are in the C<:ALL> export list:
+
+ use GLOBAL <$IN $OUT $ERR>;
+ require CALLER <$x $y>;
+
+ # Same as:
+ # my ($IN, $OUT, $ERR) ::= ($*IN, $*OUT, $*ERR)
+ # my ($x, $y) := ($CALLER::x, $CALLER::y)
+
+As pseudo-packages are always already preloaded, C<use> and C<require> will
+never attempt to load, for example, C<GLOBAL.pm> from an external source.
+
=head1 Versioning
When at the top of a file you say something like
