Perl::CriPteircl::::PCorliitciyc::::RUPesogelurilcaCyro:En:xtRprerigebusulstaierodEnxsPp:er:reRlsesqDiuooicnrusem:Be:rnRatecaqetusiiForonerBMrualcteislFionreM(u3l)tiline(3)



NNAAMMEE
       Perl::Critic::Policy::RegularExpressions::RequireBracesForMultiline -
       Use "{" and "}" to delimit multi-line regexps.

AAFFFFIILLIIAATTIIOONN
       This Policy is part of the core Perl::Critic distribution.

DDEESSCCRRIIPPTTIIOONN
       Long regular expressions are hard to read.  A good practice is to use
       the "x" modifier and break the regex into multiple lines with comments
       explaining the parts.  But, with the usual "//" delimiters, the
       beginning and end can be hard to match, especially in a "s///" regexp.
       Instead, try using "{}" characters to delimit your expressions.

       Compare these:

           s/
              <a \s+ href="([^"]+)">
               (.*?)
              </a>
            /link=$1, text=$2/xms;

       vs.

           s{
              <a \s+ href="([^"]+)">
               (.*?)
              </a>
            }
            {link=$1, text=$2}xms;

       Is that an improvement?  Marginally, but yes.  The curly braces lead
       the eye better.

CCOONNFFIIGGUURRAATTIIOONN
       There is one option for this policy, "allow_all_brackets".  If this is
       true, then, in addition to allowing "{}", the other matched pairs of
       "()", "[]", and "<>" are allowed.

CCRREEDDIITTSS
       Initial development of this policy was supported by a grant from the
       Perl Foundation.

AAUUTTHHOORR
       Chris Dolan <cdolan@cpan.org>

CCOOPPYYRRIIGGHHTT
       Copyright (c) 2007-2010 Chris Dolan.  Many rights reserved.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.  The full text of this license can
       be found in the LICENSE file included with this module



perl v5.1P2e.r2l::Critic::Policy::Regu2l0a1r1E-x0p8r-e1s4sions::RequireBracesForMultiline(3)
