Change 30234 by [EMAIL PROTECTED] on 2007/02/12 17:46:46
Subject: Re: [PATCH - provisional] H. Merijn Brands idea of buffer
numbering.
From: Paul Johnson <[EMAIL PROTECTED]>
Date: Sat, 10 Feb 2007 23:10:31 +0100
Message-ID: <[EMAIL PROTECTED]>
Affected files ...
... //depot/perl/README.hpux#55 edit
... //depot/perl/pod/perlre.pod#124 edit
Differences ...
==== //depot/perl/pod/perlre.pod#124 (text) ====
Index: perl/pod/perlre.pod
--- perl/pod/perlre.pod#123~30169~ 2007-02-08 00:19:24.000000000 -0800
+++ perl/pod/perlre.pod 2007-02-12 09:46:46.000000000 -0800
@@ -716,18 +716,23 @@
This is the "branch reset" pattern, which has the special property
that the capture buffers are numbered from the same starting point
-in each branch.
+in each branch. It is available starting from perl 5.10.
-Normally capture buffers in a pattern are number sequentially, left
-to right in the pattern. Inside of this construct this behaviour is
-overriden so that the captures buffers in each branch share the same
-numbers. The numbering in each branch will be as normal, and any
-buffers following the use of this pattern will be numbered as though
-the construct contained only one branch, that being the one with the
-most capture buffers in it.
+Normally capture buffers in a pattern are numbered sequentially,
+from left to right. Inside this construct that behaviour is
+overridden so that the capture buffers are shared between all the
+branches and take their values from the branch that matched.
+
+The numbering within each branch will be as normal, and any buffers
+following this construct will be numbered as though the construct
+contained only one branch, that being the one with the most capture
+buffers in it.
-Consider the following pattern. The numbers underneath are which
-buffer number the captured content will be stored in.
+This construct will be useful when you want to capture one of a
+number of alternative matches.
+
+Consider the following pattern. The numbers underneath show in
+which buffer the captured content will be stored.
# before ---------------branch-reset----------- after
End of Patch.
