This is 0.04

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

diff --git a/README b/README
index 674535ce4fa6ddc4fa36a5de8d0e87b8250d4026..58b2590fefaa6d05af1d1d98f3a47da9eaea7783 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.04

 
 SYNOPSIS
         {
 
 SYNOPSIS
         {


@@ -16,7 +16,7 @@ SYNOPSIS
          foo->meth;       # "'foo'->meth" if you have use'd foo somewhere,
                           #  or "foo()->meth" otherwise
          print foo 'wut'; # print to the filehandle foo if it's actually one,
          foo->meth;       # "'foo'->meth" if you have use'd foo somewhere,
                           #  or "foo()->meth" otherwise
          print foo 'wut'; # print to the filehandle foo if it's actually one,

-                          #  or "foo()->print('wut')" otherwise
+                          #  or "print(foo('wut'))" otherwise

         } # ... but function calls will fail at run-time if you don't
           # actually define foo somewhere
     
         } # ... but function calls will fail at run-time if you don't
           # actually define foo somewhere
     


@@ -28,6 +28,19 @@ 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.
+
+    This module is not a source filter.
+

 EXPORT
     None.
 
 EXPORT
     None.
 


@@ -41,6 +54,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.