This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Deprecate unescaped literal "{" in regex patterns
authorKarl Williamson <khw@cpan.org>
Fri, 13 Jun 2014 03:50:29 +0000 (21:50 -0600)
committerKarl Williamson <khw@cpan.org>
Fri, 13 Jun 2014 04:32:32 +0000 (22:32 -0600)
commit412f55bbce575aecc79b1ca79fd2856893dd8738
treea033fdcf6ed906fa1b4170fea5d491e635d32724
parent4a7e65afe24af2e709b485d8bb4a67fe3d047ada
Deprecate unescaped literal "{" in regex patterns

This commit also causes escaped (by a backslash) "(", "[", and "{" to be
considered literally.  In the previous 2 Perl versions, the escaping was
ignored, and a (default-on) deprecation warning was raised.  Now that we
have warned for 2 release cycles, we can change the meaning.of escaping
to actually do something

Warning when a literal left brace is not escaped by a backslash, will
allow us to eventually use this character in more contexts as being
meta, allowing us to extend the language.  For example, the lower limit
of a quantifier could be omited, and better error checking instituted,
or things like \w could be followed by a {...} indicating some special
word character, like \w{Greek} to restrict to just Greek word
characters.

We tried to do this in v5.16, and many CPAN modules changed to backslash
their left braces at that time.  However we had to back out that change
before 5.16 shipped because it turned out that escaping a left brace in
some contexts didn't work, namely when the brace would normally be a
metacharacter (for example surrounding a quantifier), and the pattern
delimiters were { }.  Instead we raised the useless backslash warning
mentioned above, which has now been there for the requisite 2 cycles.

This patch partially reverts 2 patches.  The first,
e62d0b1335a7959680be5f7e56910067d6f33c1f, partially reverted
the deprecation of unescaped literal left brace.  The other,
4d68ffa0f7f345bc1ae6751744518ba4bc3859bd, instituted the deprecation of
the useless left-characters.

Note that, as in the original attempt to deprecate,  we don't raise a
warning if the left brace is the first character in the pattern.  This
is because in that position it can't be a metacharacter, so we don't
require any disambiguation, and we found that if we did raise an error,
there were quite a few places where this occurred.
18 files changed:
dquote_static.c
embed.fnc
embed.h
handy.h
l1_char_class_tab.h
lib/B/Deparse-core.t
pod/perldelta.pod
pod/perldiag.pod
pod/perlre.pod
proto.h
regcomp.c
regen/mk_PL_charclass.pl
t/lib/warnings/toke
t/op/kvhslice.t
t/re/pat.t
t/re/pat_advanced.t
t/re/reg_mesg.t
toke.c