summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRafael Garcia-Suarez <rgarciasuarez@gmail.com>2007-11-27 15:04:18 +0000
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2007-11-27 15:04:18 +0000
commit99d59c4d6ec779a042ed49eb48c7c7aa214343c2 (patch)
tree580954394dcdb50c5df247c1ed1d2c66826caa0d
parentf89caa8dde834be31c14e0d732dd83ec6792b94e (diff)
downloadperl-99d59c4d6ec779a042ed49eb48c7c7aa214343c2.tar.gz
Doc nits -- avoid bare "5.10" version numbers without a
third component. (Suggested by Jarkko) p4raw-id: //depot/perl@32523
-rw-r--r--pod/perl5100delta.pod3
-rw-r--r--pod/perlre.pod26
-rw-r--r--pod/perlreapi.pod2
-rw-r--r--pod/perlrebackslash.pod10
-rw-r--r--pod/perlrecharclass.pod2
5 files changed, 21 insertions, 22 deletions
diff --git a/pod/perl5100delta.pod b/pod/perl5100delta.pod
index cc92173cca..ce4892ebfb 100644
--- a/pod/perl5100delta.pod
+++ b/pod/perl5100delta.pod
@@ -1036,8 +1036,7 @@ this optimization. (Yves Orton)
B<Note:> Much code exists that works around perl's historic poor
performance on alternations. Often the tricks used to do so will disable
the new optimisations. Hopefully the utility modules used for this purpose
-will be educated about these new optimisations by the time 5.10 is
-released.
+will be educated about these new optimisations.
=item Aho-Corasick start-point optimisation
diff --git a/pod/perlre.pod b/pod/perlre.pod
index 3576364abf..015881be53 100644
--- a/pod/perlre.pod
+++ b/pod/perlre.pod
@@ -521,14 +521,14 @@ backreferences.
X<\g{1}> X<\g{-1}> X<\g{name}> X<relative backreference> X<named backreference>
In order to provide a safer and easier way to construct patterns using
-backreferences, Perl 5.10 provides the C<\g{N}> notation. The curly
-brackets are optional, however omitting them is less safe as the meaning
-of the pattern can be changed by text (such as digits) following it.
-When N is a positive integer the C<\g{N}> notation is exactly equivalent
-to using normal backreferences. When N is a negative integer then it is
-a relative backreference referring to the previous N'th capturing group.
-When the bracket form is used and N is not an integer, it is treated as a
-reference to a named buffer.
+backreferences, Perl provides the C<\g{N}> notation (starting with perl
+5.10.0). The curly brackets are optional, however omitting them is less
+safe as the meaning of the pattern can be changed by text (such as digits)
+following it. When N is a positive integer the C<\g{N}> notation is
+exactly equivalent to using normal backreferences. When N is a negative
+integer then it is a relative backreference referring to the previous N'th
+capturing group. When the bracket form is used and N is not an integer, it
+is treated as a reference to a named buffer.
Thus C<\g{-1}> refers to the last buffer, C<\g{-2}> refers to the
buffer before that. For example:
@@ -544,7 +544,7 @@ buffer before that. For example:
and would match the same as C</(Y) ( (X) \3 \1 )/x>.
-Additionally, as of Perl 5.10 you may use named capture buffers and named
+Additionally, as of Perl 5.10.0 you may use named capture buffers and named
backreferences. The notation is C<< (?<name>...) >> to declare and C<< \k<name> >>
to reference. You may also use apostrophes instead of angle brackets to delimit the
name; and you may use the bracketed C<< \g{name} >> backreference syntax.
@@ -614,7 +614,7 @@ already paid the price. As of 5.005, C<$&> is not so costly as the
other two.
X<$&> X<$`> X<$'>
-As a workaround for this problem, Perl 5.10 introduces C<${^PREMATCH}>,
+As a workaround for this problem, Perl 5.10.0 introduces C<${^PREMATCH}>,
C<${^MATCH}> and C<${^POSTMATCH}>, which are equivalent to C<$`>, C<$&>
and C<$'>, B<except> that they are only guaranteed to be defined after a
successful match that was executed with the C</p> (preserve) modifier.
@@ -740,7 +740,7 @@ X<(?|)> X<Branch reset>
This is the "branch reset" pattern, which has the special property
that the capture buffers are numbered from the same starting point
-in each alternation branch. It is available starting from perl 5.10.
+in each alternation branch. It is available starting from perl 5.10.0.
Capture buffers are numbered from left to right, but inside this
construct the numbering is restarted for each branch.
@@ -2108,9 +2108,9 @@ part of this regular expression needs to be converted explicitly
=head1 PCRE/Python Support
-As of Perl 5.10 Perl supports several Python/PCRE specific extensions
+As of Perl 5.10.0, Perl supports several Python/PCRE specific extensions
to the regex syntax. While Perl programmers are encouraged to use the
-Perl specific syntax, the following are legal in Perl 5.10:
+Perl specific syntax, the following are also accepted:
=over 4
diff --git a/pod/perlreapi.pod b/pod/perlreapi.pod
index 6e5be84dc9..f8e9984341 100644
--- a/pod/perlreapi.pod
+++ b/pod/perlreapi.pod
@@ -302,7 +302,7 @@ variables, to do this in another engine use the following callback
Perl_croak(aTHX_ PL_no_modify);
}
-Actually perl 5.10 will not I<always> croak in a statement that looks
+Actually perl will not I<always> croak in a statement that looks
like it would modify a numbered capture variable. This is because the
STORE callback will not be called if perl can determine that it
doesn't have to modify the value. This is exactly how tied variables
diff --git a/pod/perlrebackslash.pod b/pod/perlrebackslash.pod
index ac95ace136..ddd7abee38 100644
--- a/pod/perlrebackslash.pod
+++ b/pod/perlrebackslash.pod
@@ -293,7 +293,7 @@ L<perlrecharclass>.
C<\w> is a character class that matches any I<word> character (letters,
digits, underscore). C<\d> is a character class that matches any digit,
while the character class C<\s> matches any white space character.
-New in perl 5.10 are the classes C<\h> and C<\v> which match horizontal
+New in perl 5.10.0 are the classes C<\h> and C<\v> which match horizontal
and vertical white space characters.
The uppercase variants (C<\W>, C<\D>, C<\S>, C<\H>, and C<\V>) are
@@ -340,7 +340,7 @@ as well.
=head3 Relative referencing
-New in perl 5.10 is different way of referring to capture buffers: C<\g>.
+New in perl 5.10.0 is a different way of referring to capture buffers: C<\g>.
C<\g> takes a number as argument, with the number in curly braces (the
braces are optional). If the number (N) does not have a sign, it's a reference
to the Nth capture group (so C<\g{2}> is equivalent to C<\2> - except that
@@ -369,7 +369,7 @@ Mnemonic: I<g>roup.
=head3 Named referencing
-Also new in perl 5.10 is the use of named capture buffers, which can be
+Also new in perl 5.10.0 is the use of named capture buffers, which can be
referred to by name. This is done with C<\g{name}>, which is a
backreference to the capture buffer with the name I<name>.
@@ -482,7 +482,7 @@ Mnemonic: oI<C>tet.
=item \K
-This is new in perl 5.10. Anything that is matched left of C<\K> is
+This is new in perl 5.10.0. Anything that is matched left of C<\K> is
not included in C<$&> - and will not be replaced if the pattern is
used in a substitution. This will allow you to write C<s/PAT1 \K PAT2/REPL/x>
instead of C<s/(PAT1) PAT2/${1}REPL/x> or C<s/(?<=PAT1) PAT2/REPL/x>.
@@ -498,7 +498,7 @@ a newline by Unicode. This includes all characters matched by C<\v>
the newline used in Windows text files). C<\R> is equivalent with
C<< (?>\x0D\x0A)|\v) >>. Since C<\R> can match a more than one character,
it cannot be put inside a bracketed character class; C</[\R]/> is an error.
-C<\R> is introduced in perl 5.10.
+C<\R> was introduced in perl 5.10.0.
Mnemonic: none really. C<\R> was picked because PCRE already uses C<\R>,
and more importantly because Unicode recommends such a regular expression
diff --git a/pod/perlrecharclass.pod b/pod/perlrecharclass.pod
index afdf11627a..4af2c9793d 100644
--- a/pod/perlrecharclass.pod
+++ b/pod/perlrecharclass.pod
@@ -122,7 +122,7 @@ rules. It's not a character class, as it can match a multi-character
sequence. Therefore, it cannot be used inside a bracketed character
class. Details are discussed in L<perlrebackslash>.
-C<\h>, C<\H>, C<\v>, C<\V>, and C<\R> are new in perl 5.10.
+C<\h>, C<\H>, C<\v>, C<\V>, and C<\R> are new in perl 5.10.0.
Note that unlike C<\s>, C<\d> and C<\w>, C<\h> and C<\v> always match
the same characters, regardless whether the source string is in UTF-8