Importing Regexp-Wildcards-0.05.tar.gz

[perl/modules/Regexp-Wildcards.git] / README

diff --git a/README b/README
index c7bd7943c1d5e2dbd77dcbb316fcb2d852224ba9..5f2233248e79ddb511d94594d23d116eca4edf9d 100644 (file)
--- a/README
+++ b/README
@@ -3,15 +3,15 @@ NAME
     expressions.
 
 VERSION
     expressions.
 
 VERSION

-    Version 0.04
+    Version 0.05

 
 SYNOPSIS
         use Regexp::Wildcards qw/wc2re/;
 
         my $re;
 
 SYNOPSIS
         use Regexp::Wildcards qw/wc2re/;
 
         my $re;

-        $re = wc2re 'a{b.,c}*' => 'unix';   # Do it Unix style.
-        $re = wc2re 'a.,b*'    => 'win32';  # Do it Windows style.
-        $re = wc2re '*{x,y}.'  => 'jokers'; # Process the jokers & escape the rest.
+        $re = wc2re 'a{b?,c}*' => 'unix';   # Do it Unix style.
+        $re = wc2re 'a?,b*'    => 'win32';  # Do it Windows style.
+        $re = wc2re '*{x,y}?'  => 'jokers'; # Process the jokers & escape the rest.

 
 DESCRIPTION
     In many situations, users may want to specify patterns to match but
 
 DESCRIPTION
     In many situations, users may want to specify patterns to match but


@@ -26,14 +26,14 @@ VARIABLES
     These variables control if the wildcards jokers and brackets must
     capture their match. They can be globally set by writing in your program
 
     These variables control if the wildcards jokers and brackets must
     capture their match. They can be globally set by writing in your program
 

-        $Regexp::Wildcards::CaptureAny = -1;
-        # From then, '*' jokers are capturing
+        $Regexp::Wildcards::CaptureSingle = 1;
+        # From then, the '?' joker is capturing

 
     or can be locally specified via "local"
 
         {
 
     or can be locally specified via "local"
 
         {

-         local $Regexp::Wildcards::CaptureAny = -1;
-         # In this block, the '*' joker is capturing.
+         local $Regexp::Wildcards::CaptureAny = 1;
+         # In this block, the '?' joker is capturing.

          ...
         }
         # Back to the situation from before the block
          ...
         }
         # Back to the situation from before the block


@@ -138,6 +138,12 @@ EXPORT
 DEPENDENCIES
     Text::Balanced, which is bundled with perl since version 5.7.3
 
 DEPENDENCIES
     Text::Balanced, which is bundled with perl since version 5.7.3
 

+CAVEATS
+    This module does not implement the strange behaviours of Windows shell
+    that result from the special handling of the three last characters (for
+    the file extension). For example, Windows XP shell matches *a like
+    ".*a", "*a?" like ".*a.?", "*a??" like ".*a.{0,2}" and so on.
+

 SEE ALSO
     Some modules provide incomplete alternatives as helper functions :
 
 SEE ALSO
     Some modules provide incomplete alternatives as helper functions :