Test ampersand calls

[perl/modules/subs-auto.git] / README

diff --git a/README b/README
index 674535ce4fa6ddc4fa36a5de8d0e87b8250d4026..b96f000b2892d09cb5ca948cc0b05ffd0fadc9a9 100644 (file)
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ NAME
     subs::auto - Read barewords as subroutine names.
 
 VERSION
     subs::auto - Read barewords as subroutine names.
 
 VERSION

-    Version 0.01
+    Version 0.03

 
 SYNOPSIS
         {
 
 SYNOPSIS
         {


@@ -28,6 +28,17 @@ DESCRIPTION
     (expected to be class names) or whose symbol table entry has a IO slot
     (expected to be filehandles).
 
     (expected to be class names) or whose symbol table entry has a IO slot
     (expected to be filehandles).
 

+    You can pass options to "import" as key / value pairs :
+
+    *   "in => $pkg"
+
+        Specifies on which package the pragma should act. Setting $pkg to
+        "Some::Package" allows you to resolve all functions name of the type
+        "Some::Package::func ..." in the current scope. You can use the
+        pragma several times with different package names to allow
+        resolution of all the corresponding barewords. Defaults to the
+        current package.
+

 EXPORT
     None.
 
 EXPORT
     None.
 


@@ -41,6 +52,10 @@ CAVEATS
     outside (or by actually defining "foo", which is ultimately why you use
     this pragma, right ?).
 
     outside (or by actually defining "foo", which is ultimately why you use
     this pragma, right ?).
 

+    You have to open global filehandles outside of the scope of this pragma
+    if you want them not to be treated as function calls. Or just use
+    lexical filehandles and default ones as you should be.
+

 DEPENDENCIES
     perl 5.10.0.
 
 DEPENDENCIES
     perl 5.10.0.