Login
809746b90d52d238ada25f55289ccb2eda04b091
[gknop/Perl-Critic.git] / Changes
1 [1.xxx_xxx] Released on 2009-xx-xx
2
3     New Policies:
4     * ValuesAndExpressions::ProhibitSpecialLiteralHeredocTerminator
5
6     Bug Fixes:
7     * ErrorHandling::RequireCarping will now allow a literal newline
8       as well as "\n".  Fixed by Kyle Hasselbacher, RT #25046
9     * ValuesAndExpressions::RequireInterpolationOfMetachars allows for escaped
10       backslashes.  Fixed by Tom Wyant, RT #38530.
11     * RequireUseStrict and RequireUseWarnings are no longer fooled
12       by a block-scoped pragma. RT #42310
13     * RequireBracedFileHandleWithPrint applies to printf as well as print.
14       Fixed by Kyle Hasselbacher, RT #42537
15     * CodeLayout::ProhibitTrailingWhitespace didn't notice cases where PPI
16       would produce instances of PPI::Token::Whitespace that contained
17       multiple lines.
18
19 [1.095_001] Released on 2009-01-18
20
21     Policy Changes:
22     * Documentation::PodSpelling now has a stop_words_file option.
23     * Modules::ProhibitEvilModules now has a modules_file option.
24
25     Bug Fixes:
26     * Fix ProhibitTwoArgOpen so it allows '-|' or '|-' as the second
27       of two arguments.  Patches from Kyle Hasselbacher and
28       Leland Johnson, RT #42384.
29     * Fix for problem in P::C::Document in dealing with underscores in
30       expressions like "use 5.009_001".  Patch by Kevin Ryde, RT #36570 and
31       #42089.
32     * Fix in extras/perlcritic.el for a radio button.  Patch by Kevin Ryde, RT
33       #42190.
34     * Fix distclean target in Makefile.PL.  Patch by Richard Soderberg,
35       RT #42088.
36     * Fix temporary files not being cleaned up after tests.  Patch by Kyle
37       Hasselbacher, RT #41443.
38
39     Documentation improvements contributed by Mark Grimes in response to RT
40     #41942.
41
42 [1.094001] Released on 2009-01-01
43
44     Bug Fixes:
45     * Tests would fail on systems without Regexp::Parser installed.
46
47 [1.094] Released on 2009-01-01
48
49     Incompatible Changes:
50     * The way that "## no critic" markers was refactored.  As
51       a result, we discovered that the syntax for the markers was pretty
52       vague.  If you didn't do it just right, it would disable all policies,
53       and not just the specific ones that you wanted.  So we've tightened this
54       up a bit.  If you followed the examples that have been in the docs for
55       the last couple years, then you should be fine.  But if you've been
56       using certain other variations in your "## no critic" markers, then you
57       might suddenly find yourself violating the new
58       ProhibtUnrestrictedNoCritic policy.  To fix this, just make sure your
59       Policy names appear in parentheses:
60
61         ## no critic Foo, Bar, Baz     # wrong!
62         ## no critic Foo Bar Baz       # wrong!
63
64
65         ## no critic (Foo, Bar, Baz)   # ok!
66         ## no critic qw(Foo Bar Baz)   # also ok!
67
68     * The deprecated $FORMAT variables for Perl::Critic::Policy and
69       Perl::Critic::Violation no longer exist.  Use the corresponding
70       get_format() and set_format() functions instead.
71
72     New Policies:
73     * Miscellanea::ProhibitUnrestrictedNoCritic
74     * Miscellanea::ProhibitUselessNoCritic
75     * NamingConventions::Capitalization
76     * Subroutines::ProhibitReturnSort
77     * Variables::ProhibitReusedNames
78
79     Removed Policies:
80     * NamingConventions::ProhibitMixedCaseSubs and
81       NamingConventions::ProhibitMixedCaseVars have been moved to a separate
82       Perl-Critic-Deprecated distribution.  The
83       NamingConventions::Capitalization policy does everything they do, plus
84       more.
85
86     Policy Changes:
87     * BuiltinFunctions::ProhibitStringyEval now has an allow_includes option
88       that makes it behave (mostly) like Ricardo SIGNES'
89       Perl::Critic::Policy::Lax::ProhibitStringyEval::ExceptForRequire.
90     * InputOutput::RequireCheckedClose, InputOutput::RequireCheckedOpen, and
91       InputOutput::RequireCheckedSyscalls now all support autodie.
92       Unfortunately, autodie is currently treated like a module and not a
93       pragma, which means that the lexical scoping is not taken into account.
94     * InputOutput::RequireCheckedSyscalls now has an exclude_functions
95       parameter.
96     * Modules::ProhibitEvilModules now allows you to specify what the
97       description of a use of a bad module should be, to, say, suggest that
98       people use autodie instead of Fatal.
99     * Subroutine::ProhibitExcessComplexity violation descriptions now include
100       the name of the subroutine, thanks to Andreas Koenig, RT #40070.
101     * TestingAndDebugging::RequireUseStrict and
102       TestingAndDebugging::RequireUseWarnings now have equivalent_modules
103       parameters that allow you to designate other modules as being equivalent
104       to the strict and warnings pragmata.  This one is for all you Moose fans
105       out there.  :]
106
107     Bug Fixes:
108     * ControlStructures::ProhibitUnreachableCode would treat package
109       statements as unreachable.  Fixed by Kevin Ryde.  RT #41734
110     * Fix warning from InputOutput::ProhibitOneArgSelect when select was
111       called with no arguments.  RT #41926
112     * Miscellanea::RequireRcsKeywords couldn't find keywords after __END__
113       that didn't look like part of POD.
114     * Modules::RequireFilenameMatchesPackage would incorrectly complain about
115       programs.  Yet more greatness contributed by Schwern.  RT #39024.
116     * If a perlcriticrc file referred to a policy that wasn't installed and
117       the profile-strictness option was set to "fatal",
118       Perl::Critic::PolicyFactory fell over instead of reporting the
119       problematic policy name.
120
121     Miscellanea:
122     * Perl::Critic::Violation will automatically strip trailing periods
123       from your Policy description and explanation strings.  This ensures that
124       the punctuation is consistent with the format specified by the user via
125       the -verbose formatting options.
126
127     New Developer Features:
128     * Perl::Critic::Policy::prepare_to_scan_document() is now checked and a
129       Policy can disable itself for just a single document, which can speed
130       things up.
131
132 [1.093_03] Released on 2008-12-11
133 [1.093_02] Released on 2008-10-30
134 [1.093_01] Released on 2008-09-07
135
136     Changes summarized into 1.094 above.  For exact details, see Changes in
137     1.093_003 on BackPAN.
138
139 [1.092] Released on 2008-09-02
140
141     Bug Fixes:
142     * Fixed POD errors that were causing build failures.  Sorry
143       about that.
144
145 [1.091] Released on 2008-09-01
146
147     New Policies:
148     * RegularExpressions::RequireDotMatchAnything
149
150     New Features:
151     * perlcritic now supports a -pager option, so you can more easily
152       send the output to your favorite pager.  You can set this option
153       on the command-line or in your .perlcriticrc file.  See the
154       perlcritic perldoc for more details.  Credit to Michael Schwern.
155     * The output from "perlcritic -doc PATTERN" will be automatically
156       sent to your pager if you have set the -pager option.
157
158     Policy Changes:
159     * CodeLayout::ProhibitQuotedWordLists no longer applies if the list
160       contains any non-words, by default.  A non-word is anything that does
161       not match /[\w-]+/.  You can restore the former behavior by setting the
162       "strict" option.  RT #37886.
163     * CodeLayout::ProhibitQuotedWordLists also now applies to the import
164       arguments of a C<use> statement.  RT #24467.
165     * ErrorHandling::RequireCheckingReturnValueOfEval now recognizes ternary
166       left-sides as valid checks.
167     * RegularExpressions::RequireExtendedFormatting gains a
168       minimum_regex_length_to_complain_about option.  Also, regexes that
169       contain only word and whitespace characters are now exempt from this
170       policy, by default; you can make it complain about them by turning on
171       the new strict option.  Contributed by Michael Schwern.  RT #38531.
172     * TestingAndDebugging::ProhibitNoWarnings now supports a
173       allow_with_category_restriction option, thanks to Michael Schwern.
174       RT #38514.
175     * CodeLayout::ProhibitHardTabs now allows leading tabs in qw() word lists
176       and regexes with the /x modifier.  You can still configure this
177       policy to forbid all hard tabs, if you like.  RT #32440
178
179     Bug Fixes:
180     * perlcritic should now work under PAR.  RT #38380.
181     * URL for our repository in META.yml now works for anonymous
182       checkout.  The password is "" (empty).  RT #38628.
183     * color for high-severity violations is now magenta because
184       it is more redable than yellow on white backgrounds.  RT #38511.
185
186 [1.090] Released on 2008-07-22
187
188     Bug Fixes:
189     * Test was incorrectly failing when Regexp::Parser wasn't installed.
190
191 [1.089] Released on 2008-07-21
192
193     Minor Enhancements:
194     * -s is now a synonym for --single-policy.
195
196     Policy Changes:
197     * Subroutines::ProhibitBuiltinHomonyms now also prohibits subroutines
198       with the same name as a Perl keyword (e.g. if, foreach, while).
199       Inspired by RT #37632.
200     * Subroutines::ProtectPrivateSubs now allows expressions like
201       "shift->_some_private_method();".  Note that this *only* applies
202       to the "shift" function -- a private method call on the right of any
203       other bareword still causes a violation.  RT #34713.
204     * Subroutines::RequireFinalReturn now includes exec in the set of things
205       that mark a successful return.  RT #37672
206     * ValuesAndExpressions::ProhibitInterpolationOfLiterals now takes a
207       allow_if_string_contains_single_quote option.  Contributed by Ed
208       Avis <ed@membled.com>.  RT #36125.
209     * ValuesAndExpressions::RequireInterpolationOfMetachars now supports a
210       rcs_keywords option to allow for the common case where those require
211       dollar signs.
212
213     Bug Fixes:
214     * BuiltinFunctions::ProhibitSleepViaSelect would complain if there were
215       three undefs as arguments to select(), but one of them was the timeout.
216       RT #37416.
217     * Reduced false positives in
218       RegularExpressions::ProhibitSingleCharAlternation.  Thanks to
219       Andy Lester and Elliot Shank test cases.
220     * RegularExpressions::ProhibitUnusedCapture would complain if there were
221       multiple captures used in a substitution, e.g. s/(.)(.)/$2$1/.
222     * Subroutines::ProhibitAmpersandSigils no longer complains about
223       "sort &foo(...)".
224     * Makefile.PL, Build.PL and other ".PL" scripts which typically do not
225       have a shebang are no longer mistaken as modules.  This prevents
226       spurious warnings from Modules::RequireEndWithOne.  RT #20481.
227
228     Internals:
229     * Tests are now self compliant.
230
231 [1.088] Released on 2008-07-04
232
233     New Policies
234     * ErrorHandling::RequireCheckingReturnValueOfEval
235
236     Policy Changes:
237     * ValuesAndExpressions::ProhibitLeadingZeros now accepts octal numbers
238       for the Unix permissions argument to chmod, dbmopen, mkdir, sysopen, or
239       umask, by default.  Use the "strict" option to get the old behavior.
240       RT #31977.
241     * Due to the consensus at YAPC::NA 2008,
242       Variables::ProhibitUnusedVariables default severity has been raised to
243       medium/3.
244
245     Minor Changes:
246     * The perlcritic "--Version" option is now "--version" in order to act
247       like the rest of the world.
248
249 [1.087] Released on 2008-06-21
250
251     Policy Changes:
252     * CodeLayout::ProhibitParensWithBuiltins no longer complains about
253       sort(foo(@x)).
254     * TestingAndDebugging::RequireUseWarnings will not complain about files
255       that contain a "use 5.005" statement or similar for perls prior to 5.6.
256       Lesson of the day: computer conferences where you can meet in the real
257       world can clarify conversations greatly.  Good to finally meet you Adam.
258     * InputOutput::ProhibitTwoArgOpen similarly will not complain if there's
259       a "use/require 5.005" statement in the file.  RT #34385.
260
261     Bug fixes:
262     * Perl::Critic can now critique a file named "0".  However, PPI will give
263       a parse error until the next version comes out.  Fixes RT #36127.
264     * Moved detection of the lack of any enabled Policies from P::C::Config
265       to Perl::Critic.  This was causing the perlcritic.t in Parrot to fail.
266       Note, however, there are plans afoot to change how Perl::Critic is
267       configured and things that depend upon that may break.  Please contact
268       users@perlcritic.tigris.org and tell us how you're using P::C::Config
269       directly so that we can take your needs into account.
270
271 [1.086] Released on 2008-06-12
272
273     Policy Changes:
274     * NamingConventions::ProhibitAmbiguousNames now specifies the name that
275       it had problems with in its violation descriptions.
276
277     Bug fixes:
278     * The color option wasn't being correctly set from a .perlcriticrc.
279       RT #36569.
280
281     Minor changes:
282     * --colour is now a synonym for --color.
283
284 [1.085] Released on 2008-06-07
285
286     New Policies:
287     * Documentation::RequirePackageMatchesPodName
288
289     Policy Changes:
290     * Variables::ProhibitUnusedVariables detects a few more cases.  It's
291       still very limited, though.
292
293     Bug fixes:
294     * ControlStructures::ProhibitUnreachableCode didn't notice "until" was an
295       conditional expression.
296
297     Minor documentation updates.
298
299 [1.084] Released on 2008-05-24
300
301     New Features:
302     * perlcritic now supports a --list-themes option.
303     * You can specify the maximum number of violations you want per Policy
304       per document.  Developers can give a default value for this for a
305       Policy by overriding default_maximum_violations_per_document().
306       See RequireUseStrict and ProhibitMagicNumbers for examples.
307
308     Policy Moved:
309     * The ValuesAndExpressions::ProhibitMagicNumbers policy has been moved
310       from Perl::Critic::More into the primary Perl::Critic distribution.
311
312     New Policies:
313     * Variables::ProhibitUnusedVariables (very dumb, limited initial
314       implementation.)
315     * ControlStructures::ProhibitLabelsWithSpecialBlockNames
316       Contributed by Mike O'Regan.  Kickin' ass, Mike.
317
318     Policy Changes:
319     * ControlStructures::ProhibitUnreachableCode now handles the perl 5.10
320       "//" and "err" operators.  RT #36080
321     * InputOutput::RequireBriefOpen now ignores opens of STDIN, STDOUT,
322       and STDERR.  You're generally trying to make long-lasting global
323       effects when manipulating these.  (RT #35774)
324     * RegularExpressions::ProhibitUnusualDelimiters now supports an
325       "allow_all_brackets" option.
326     * RegularExpressions::RequireBracesForMultiline now supports an
327       "allow_all_brackets" option.
328     * TestingAndDebugging::RequireUseStrict now accepts "use Moose::Role"
329       as equivalent to "use strict".  (RT #34838)
330     * TestingAndDebugging::RequireUseWarnings now accepts "use Moose::Role"
331       as equivalent to "use warnings".  (RT #34838)
332     * ValuesAndExpressions::ProhibitMagicNumbers now accepts constant
333       subroutines.
334     * Variables::ProhibitMatchVars no longer detects "use English;".
335       This problem is detected in a more clear way by
336       Modules::RequireNoMatchVarsWithUseEnglish.
337     * Variables::ProhibitPerl4PackageNames no longer complains about
338       $'/$POSTMATCH.  RT #36059
339     * Variables::RequireLocalizedPunctuationVars now allows the use of "my".
340       RT #33937
341
342     Bug Fixes:
343     * No longer falls over if a single file has a parse error.
344
345     New Developer Features:
346     * If a document specifies a minimum perl version, e.g. "use 5.008003",
347       P::C::Document::highest_explicit_perl_version() will tell you what it
348       is.
349     * The parameter to P::C::Policy::initialize_if_enabled is now a
350       P::C::PolicyConfig object instead of a hash reference.
351
352     Minor Changes:
353     * LOTS of documentation updates.
354     * A few more statistics are emitted by perlcritic with the --statistics
355       option.
356     * perlcritic --profile-proto now includes policy abstracts in its
357       output.
358
359     Prerequisites:
360     * Now depends upon PPI 1.203.
361     * New dependency upon version.
362
363 [1.083_006] Released on 2008-05-20
364 [1.083_005] Released on 2008-05-19
365 [1.083_004] Released on 2008-05-18
366 [1.083_003] Released on 2008-05-17
367 [1.083_002] Released on 2008-05-17
368 [1.083_001] Released on 2008-04-13
369
370     Changes summarized into 1.084 above.  For exact details, see Changes in
371     1.083_006 on BackPAN.
372
373 [1.082] Released on 2008-03-08
374
375     New Features:
376     * A new metadata system for defining policy parameters/options has been
377       added.  This makes the life of policy authors easier because
378       configuration validation and parsing can be taken care of
379       automatically, in most cases.  This allows greater integration with
380       IDEs and allows the perlcritic "--profile-proto" option to produce
381       better output.
382
383       Note: This change does NOT REQUIRE ANY CHANGES to policies outside of
384       this distribution; they should continue to work as is.  However, use
385       of this facility can reduce the size of your code and provide the
386       means for tools to discover more about your policy.  If this change
387       does break any of your policies, please let us know.
388
389       To learn how to take advantage of this facility, read
390       Perl::Critic::DEVELOPER and look at the source of any of the
391       configurable policies included in this distribution.
392
393       There is a discussion of the design considerations for this facility in
394       the source repository under doc/PolicyParameter_Notes.pod.
395
396     * Added support for "criticism-fatal" option in your perlcriticrc
397       file.  This will be used by the criticism pragma to cause execution
398       to abort if the file contains any violations.
399
400     New Policy:
401     * Module::RequireNoMatchVarsWithUseEnglish
402
403     Policy Changes:
404     * Added an allow_last_statement_to_be_comma_separated_in_map_and_grep
405       option to ValuesAndExpressions::ProhibitCommaSeparatedStatements.
406       Partial response to http://rt.cpan.org/Public/Bug/Display.html?id=27654.
407     * ControlStructures::ProhibitPostfixControls gains the ability to have
408       the flow control statements allowed to be modified.  This in response
409       to RT #29540.
410     * TestingAndDebugging::RequireUseStrict now accepts "use Moose" as
411       equivalent to "use strict".
412     * TestingAndDebugging::RequireUseWarnings now accepts "use Moose" as
413       equivalent to "use warnings".
414
415     Bug Fixes:
416     * RT #31281 perlcritic doesn't recognize "#!/bin/env perl" shebang
417     * Replace usage of Unicode property escapes with POSIX character classes
418       order to restore 5.6 compatability.
419     * RT #30388 ValuesAndExpressions::ProhibitVersionStrings complained
420       about numbered directories in "use lib".
421     * Fixed handling of badly behaved spelling programs in PodSpelling.
422
423 [1.081_006] Released on 2008-03-02
424 [1.081_005] Released on 2007-12-29
425 [1.081_004] Released on 2007-12-20
426 [1.081_003] Released on 2007-12-16
427 [1.081_002] Released on 2007-12-16
428 [1.081_001] Released on 2007-12-15
429
430     Changes summarized into 1.082 above.  For exact details, see Changes in
431     1.081_006 on BackPAN.
432
433 [1.080] Released on 2007-11-11
434
435     New Features:
436     * Allow a "## no critic" statement after a shebang on line 1 of a
437       file.  This allows users to block violations that apply to
438       whole files and still allow shebangs.
439
440     New Policies: (funded by a Perl Foundation grant)
441     * InputOutput::ProhibitExplicitStdin
442     * RegularExpressions::ProhibitFixedStringMatches
443     * RegularExpressions::RequireBracesForMultiline
444     * RegularExpressions::ProhibitUnusualDelimiters
445     * RegularExpressions::ProhibitUnusedCapture
446     * RegularExpressions::ProhibitComplexRegexes
447     * RegularExpressions::ProhibitSingleCharAlternation
448     * RegularExpressions::ProhibitEscapedMetacharacters
449     * RegularExpressions::ProhibitEnumeratedClasses
450     * InputOutput::RequireBriefOpen
451     * InputOutput::RequireCheckedSyscalls
452
453     Other New Policies
454     * ControlStructures::ProhibitNegativeExpressionsInUnlessAndUntilConditions
455
456     Policy Changes:
457     * Variables::ProhibitConditionalDeclarations now permits you to local-ize
458       variables in conditional declarations.  This makes sense, since
459       C<local> is actually a variable modifier, rather than a declaration.
460       Thanks to David Golden for reporting this.
461
462     New Developer Features:
463     * Perl::Critic::Utils::PPIRegexp encapsulates interaction with
464       the PPI Regexp token classes.  Those classes have very sparse
465       APIs, so this package hides away the ugly fiddling with PPI
466       internals.
467     * Added a new optional_modules parameter for the .run syntax.
468
469     Bug fixes:
470     * PPI::Structure::List can now contain multiple children,
471       so P::C::Utils::parse_arg_list() needs to handle it.
472
473       This was done in the process of fixing
474       http://rt.cpan.org/Ticket/Display.html?id=24924, which was a problem
475       with TestingAndDebugging::RequireTestLabels.
476
477     * ValuesAndExpressions::ProhibitLongChainsOfMethodCalls wasn't resetting
478       chain length when it ran into the end of a sub-expression.
479
480       http://rt.cpan.org/Public/Bug/Display.html?id=30040
481
482     * ValuesAndExpressions::ProhibitCommaSeparatedStatements was reporting
483       false positives when builtins which accept both no and multiple
484       arguments were involved.
485
486       http://rt.cpan.org/Public/Bug/Display.html?id=27654
487
488     Internals:
489     * Removed all use of Carp in favor of exceptions.
490
491     Prerequisites:
492     * Now requires PPI 1.201.  A number of workarounds for PPI bugs have been
493       removed.
494     * New dependency upon Exception::Class.
495
496     Installation:
497     * Use Devel::CheckOS to see whether Perl::Critic is being installed on
498       a Solaris system and warn about tar(1) chopping file names off if it
499       is.
500
501 [1.079_003]  Released on 2007-10-22
502 [1.079_002]  Released on 2007-10-21
503 [1.079_001]  Released on 2007-10-09
504
505     Changes summarized into 1.080 above.  For exact details, see Changes in
506     1.079_003 on BackPAN.
507
508 [1.078]  Released on 2007-09-19
509
510     Restore Perl::Critic::TestUtils::should_skip_author_tests() and
511     get_author_test_skip_message().  Some Perl::Critic add-on distributions
512     are using them.
513
514 [1.077]  Released on 2007-09-15
515
516     Note: if you don't have any problems installing Perl::Critic 1.076, there
517     is no need to upgrade to this version.  There are no functionality
518     changes.  This release only contains changes related to installation that
519     a few people were experiencing.
520
521     Minor changes:
522     * Removed build-time use of Readonly, again, due to problems some people
523       were having when trying to compile the code by hand, rather than using
524       CPAN(PLUS)?.
525     * Don't run author tests if there's a .svn directory present because
526       users who grabbed the code from the source repository were executing
527       them and getting failures.
528     * Don't generate optional, module-hiding test wrappers if author tests
529       are not enabled.
530
531
532 [1.076]  Released on 2007-09-07
533
534     It appears from reports on the 1.075_001 release that the subroutine
535     sigils were indeed the problem.  Release to the general populace.
536
537
538 [1.075_001]  Released on 2007-09-06
539
540     Bug Fixes:
541     Undo the changes in 1.073 and 1.074.  Instead, stop using the subroutine
542     sigil in import and export lists.  It is suspected that the problem lies
543     with Exporter stripping off ampersands.
544
545 [1.074]  Released on 2007-09-04
546
547     Bug Fixes:
548     Repeat the Makefile.PL change on
549     t/generate_without_optional_dependencies_wrappers.PL.
550     I love CPAN Testers.
551
552 [1.073]  Released on 2007-09-04
553
554     Bug Fixes:
555     Work around problems with the combination of Exporter & Readonly in
556     Makefile.PL on some machines.
557
558 [1.072]  Released on 2007-09-03
559
560     Bug Fixes:
561     * The Makefile generated by Makefile.PL was not syntactically correct
562       according to some versions of Solaris.  Thanks to Diab Jerius
563       (DJERIUS) for discovery and testing.
564     * Fixed mis-definition of "quiet" value for the "--profile-strictness"
565       option.
566     * Enhanced testing with the absence of optional modules.
567
568 [1.071]  Released on 2007-08-24
569
570     The "Brown Paper Bag" Release
571
572     Bug Fixes:
573     * Tests would not pass in environments that did not have all optional
574       dependencies installed.
575
576 [1.07]  Released on 2007-08-21
577
578     New Policies: (funded by a Perl Foundation grant)
579     * BuiltinFunctions::ProhibitBooleanGrep
580     * BuiltinFunctions::ProhibitComplexMappings
581     * Documentation::PodSpelling
582     * InputOutput::ProhibitJoinedReadline
583     * Subroutines::ProhibitManyArgs
584     * Subroutines::RequireArgUnpacking
585     * ValuesAndExpressions::ProhibitImplicitNewlines
586     * Variables::RequireLocalizedPunctuationVars
587
588     Other New Policies
589     * Subroutines::ProhibitNestedSubs
590
591     New Features:
592     * The "perlcritic --profile-proto" output now includes the "add_themes"
593       parameter for each policy.
594     * The perlcritic "--strict-profile" option has been replaced with a
595       "--profile-strictness" option.  This new option takes values of "warn"
596       (the default), "fatal", and "quiet", which controls what happens with
597       ignorable problems in a .perlcriticrc file.
598
599     New Developer Features:
600     * Perl::Critic::Policy now has an overridable initialize_if_enabled()
601       method which allows a Policy to perform expensive initialization after
602       it has been determined whether the user has it enabled or not.  Also,
603       this method allows a Policy to say that it should be disabled
604       regardless of what the user says.
605
606       Actually, use of this method is now encouraged over using a
607       constructor.
608
609     Other Stuff:
610     * Now requires the Readonly module in order to be more self-compliant.
611
612 [1.061]  Released on 2007-07-24
613
614     Bug Fixes:
615     * Fix P::C::Theme-- Exporter in Perl 5.6 does not export import(), so you
616       must subclass it.  *sigh*
617     * Fix P::C::Config::_validate_and_save_theme()-- eval of an empty string
618       does not reset $@/$EVAL_ERROR in Perl 5.6.
619
620     Big thanks to Anirvan Chatterjee for identifying and helping debug these
621     issues.
622
623 [1.06]  Released on 2007-06-27
624
625     New Features:
626     * perlcritic now emits errors for all the problems it can find for the
627       global options in the command-line parameters and .perlcriticrc file,
628       rather than bailing on the first one it encounters.
629
630     * perlcritic now has a "--strict-profile" option which will make warnings
631       about problems in a profile fatal.
632
633     * perlcritic now has a "--statistics-only" option which suppresses the
634       display of individual violations and only shows the additional output
635       produced by the "--statistics" option.
636
637     Feature requests:
638     * A value for "color" can now be specified in a .perlcriticrc.
639       http://rt.cpan.org/Ticket/Display.html?id=24877
640
641     New Policies:
642     * ValuesAndExpressions::ProhibitQuotesAsQuotelikeOperatorDelimiters
643       As suggested in http://rt.cpan.org/Ticket/Display.html?id=23290.
644     * ValuesAndExpressions::ProhibitLongChainsOfMethodCalls
645     * Modules::ProhibitExcessMainComplexity
646       As suggested in http://rt.cpan.org/Ticket/Display.html?id=24699
647
648     Minor changes:
649     * The perlcritic "--profile-proto" option now emits the short names for
650       policies, rather than the full ones.
651
652     * The "-profileproto" and "-singlepolicy" options have been renamed to
653       "-profile-proto" and "-single-policy" in order to make the growing
654       number of command-line options comprehensible.  The change of
655       "singlepolicy" also affects your F<.perlcriticrc> file.
656
657 [1.053]  Released on 2007-06-02
658
659     *DEVELOPMENT RELEASE*
660
661     Bug Fixes:
662     Fixed bug in 15_statustics.t test script, which caused the build
663     to fail on machines that don't have Perl::Tidy installed.
664
665 [1.052]  Released on 2007-06-01
666
667     *DEVELOPMENT RELEASE*
668
669     New Features:
670     * perlcritic now emits a summary about the scanned code when enabled by
671       the "-statistics" option.
672
673     Policy Enhancements:
674     * InputOutput::ProhibitBacktickOperators can now be configured to only
675       check in void contexts.
676
677     Bug Fixes:
678     * 27073: False positive in RequireUpperCaseHeredocTerminator
679     * 27065: CodeLayout::ProhibitTrailingWhitespace breaks under Perl 5.6.1
680     * 26462: ControlStructures::ProhibitCascadingIfElse pod typo
681     * ValuesAndExpressions::ProhibitCommaSeparatedStatements was complaining
682       about multiple values in the list to be iterated over by a foreach loop.
683     * Corrected PBP page numbers for some policies (Quinn Weaver).
684
685 [1.051]  Released on 2007-04-12
686
687     *DEVELOPMENT RELEASE*
688
689     No new policies.
690     No particular bug fixes.
691
692     Internals:
693     * Added several new utility functions to support the StricterSubs distro.
694       Also, some of the existing functions in Perl-Critic-Utils have
695       changed in ways that might break your custom policies.
696
697     Miscellanea:
698     * Updated Emacs plugin (Courtesy Josh ben Jore).
699       See extras/perlcritic.el for details.
700     * Added copy of BBEdit plugin (Courtesy of Josh Clark).
701       See extras/perl_critic_for_bbedit-1_0.zip for details
702
703 [1.05]  Released on 2007-03-19
704
705     Bug Fixes:
706     * 25557: t/20_policy_prohibittrailingwhitespace.t fails on Perl 5.8.0
707
708 [1.04]  Released on 2007-03-18
709
710     Bug Fixes:
711     * 25008: Subroutines::RequireFinalReturn should allow "throw"
712     * 25085: False Positive - Heredoc terminator must be quoted
713     * 18423: VERSION check does not notice Readonly::Scalar version
714     * 25449: Proposal of $VERSION declaration (DUPLICATE)
715
716     New Policies:
717     * CodeLayout::ProhibitTrailingWhitespace
718     * ValuesAndExpressions::ProhibitCommaSeparatedStatements
719     * Variables::ProhibitPerl4PackageNames
720
721     Policy Enhancements:
722     * Subroutines::RequireFinalReturn can now be configured to recognize
723       your custom functions that behave like "die" or "exit".
724     * Documentation::RequirePodSections can be configured to match
725       Module::Starter:PBP or to really match the PBP book.
726
727 [1.03]  Released on 2007-02-13
728
729     Bug Fixes:
730     * Fixed a few more problems with the %f, %F, and %r format escapes.
731     * I forgot to put Conway's perlcriticrc file in the MANIFEST. Sorry.
732
733     Interface Changes:
734     * Perl::Critic::Utils automatically exports everything.  However,
735       this is deprecated.  In the future, you must request your exports.
736
737     Policy Changes:
738     * Duplicate violations of RequireExcplicitPackage are now squelched,
739       in the same way as RequireUseStrict and RequireUseWarnings.
740
741 [1.02]  Released on 2007-02-11
742
743     Bug Fixes:
744     * "undef" incorrectly triggered ProhibitMutatingListFunctions.
745     * 24876: %f and %F escapes not working in custom "verbose" format strings.
746     * 24875: Documentation bug in TestingAndDebugging::ProhibitNoStrict
747
748     New Policies:
749     * InputOutput::RequireCheckedOpen
750     * InputOutput::RequireCheckedClose
751
752     Other Cool Stuff:
753     * Added Conway's own suggested Perl::Critic configuration as
754       examples/perlcriticrc-conway.
755
756     * See the examples/ directory for some neat demonstrations of using
757       the Perl::Critic API. Contributed by Elliot Shank.
758
759     Interface Changes:
760     * Perl::Critic::Utils no longer exports anything by default.  Policies
761       outside the distribution will need to specify what exactly they need
762       from this module.  There are a number of tags that can be used in
763       addition to individual imports.
764
765 [1.01]  Released on 2007-01-24
766
767     PRODUCTION RELEASE:  You may now consider the public Perl::Critic
768     API as "stable."  Future minor releases will focus on bug fixes,
769     new policies, and internal refactoring.
770
771     Bug Fixes:
772     * Fixed memory leak.  This was reported by the Parrot team at
773       http://rt.perl.org/rt3/Ticket/Display.html?id=41230
774
775 [0.23]  Released on 2007-01-19
776
777     Bug Fixes:
778     * 23994: Test 56 in t/05_utils.t of Perl::Critic v0.22 fails
779     * 24005: test 95 in t/13_bundled_policies fails in 0.22
780
781
782     Groovy New Features:
783     * Added '%F' to the Violation format specifications.  This will
784       give you just the name of file where the violation occurred
785       (i.e. without the path).
786
787     * Improved validation of .perlcriticrc file.  An invalid
788       default setting will now cause a fatal exception. A
789       strange-looking policy name will cause a warning.
790
791
792     Interface Changes:
793     * The syntax for theme expressions has changed.  Instead of using
794       mathematical operators qw(+ * -) you must now use the logical
795       operators qw(|| && !).  See the Perl::Critic docs for more info.
796
797     * The @GLOBALS and @BUILTINS variables are no longer exported by
798       Perl::Critic::Utils.  Use the is_perl_global() and is_perl_builtin()
799       functions instead.
800
801     * Perl::Critic::Policy::policy_parameters() has bee renamed to
802       Perl::Critic::Policy::supported_paramters().  This was an
803       undocumented feature anyway, so it shouldn't affect anyone.
804
805
806     Other Internal Changes:
807     * Perl::Critic now requires B::Keywords v1.05 or newer.
808
809     * A few internal classes have been refactored.  As a result,
810       Set::Scalar is no longer a required dependency.
811
812
813 [0.22]  Released on 2006-12-15
814
815     New Features:
816     * Introduced named severity levels: gentle, stern, harsh, cruel, brutal
817       You can use these named levels instead of the numeric ones.
818       For example: "perlcritic --severity=cruel MyModule.pm"
819       Or just:     "perlcritic --cruel MyModule.pm"
820
821     * For perlcritic, the "-List" option has been renamed to
822       "-profileproto".  The output now includes the names of the
823       parameters that each Policy supports, if any.
824
825     * Improved validation of Policy parameters in your F<.perlcriticrc>
826       Any invalid parameter now causes a fatal exception.
827
828     Major Changes:
829     * Reassigned themes for most policies.  Now there are fewer
830       themes and they are organized around programming concepts
831       instead of severity levels.  If you have assigned your own
832       themes to any Policies, they should still work as expected.
833
834     Policy Changes:
835     * ErrorHandling::RequireCarping will not complain if it can figure
836       out that the die or warn message will always end in a newline
837       ("\n").  The idea is that, if you put the newline there, you
838       don't indend for there to be any file/line/stack information
839       emitted, in which case you really don't want carp/croak.
840
841       You can restore the old strict behavior by giving the policy
842       a false value for "allow_messages_ending_with_newlines" in your
843       configuration.
844
845     Misc Changes:
846
847     Added single-letter uppercase alternatives for some perlcritic options.
848
849 [0.21_01] Released on 2006-12-03
850
851     New Policies:
852     * TestingAndDebugging::ProhibitProlongedStrictureOverride
853     * ControlStructures::ProhibitMutatingListFunctions
854
855     New Features:
856     * Say "perlcritic -List" to get an expanded listing of all Policies.
857       The format is suitable for use as your .perlcriticrc file.
858     * Say "perlcritic -doc PATTERN" to get the documentation for all
859       Policies that match m/PATTERN/imx.  This is a little easier than
860       typing in the full name of the Policy module with "perldoc".
861     * Say "perlcritic --singlepolicy PATTERN" to use one and only one
862       policy.
863     * Can now specify exceptions to Variables::ProhibitPackageVars,
864       for packages like File::Find that only interface through
865       package variables.
866
867     Bug Fixes:
868     * 21713 false positive for parens used with substr and unpack.
869     * 22890 allow Rcs keywords in POD.
870
871     Internals:
872     * Testing system overhauled.  Details on the Policy/subtest
873       framework is in t/run.t.
874     * Added Perl::Critic::Utils::words_from_string.  This is safer
875       than plain old C<split /\s+/>.
876
877 [0.21]  Released on 2006-11-05
878
879     New Policies:
880     * BuiltinFunctions::ProhibitReverseSortBlock
881     * BuiltinFunctions::ProhibitVoidGrep
882     * BuiltinFunctions::ProhibitVoidMap
883     * CodeLayout::RequireConsistentNewlines
884     * Modules::RequireFilenameMatchesPackage
885     * TestingAndDebugging::RequireTestLabels
886     * ValuesAndExpressions::ProhibitMismatchedOperators
887
888     New Features:
889     * Introduced policy "themes."  Themes are arbitrary names that can
890       be used to identify a group of related Policies.  You can select
891       your favorite policies by combining themes in a mathematic expression
892       such as "pbp * (danger + risky)".  See POD for details.
893     * perlcritic output is colorized if you have Term::ANSIColor.  This
894       only works on non-Win32 platforms.  Use -nocolor switch to disable.
895     * Say "perlcritic -count" to get just the the total number of
896       violations per file.  Use this feature to quickly identify hot-spots.
897     * Use the -only switch to choose only from policies mentioned in your
898       .perlcriticrc file.  This is useful if you usually only want to
899       work with a small subset of the policies.
900     * Default values for most of the perlcritic and Perl::Critic options
901       can now be defined in your .perlcriticrc file.  See POD for details.
902
903     Bug Fixes:
904     * 21236: wrong page number for "printing to filehandles"
905     * 21916: File handle ... wrong page reference in PBP [DUPE]
906     * 21714: false positive for capture var used in ternary condition
907     * 21718: No skip for File::Slurp in includes.t
908     * ProhibitBarewordFilehandles doesn't complain if you open
909       STDIN, STDOUT or STDERR.
910     * Parrot 40564: Subroutines::RequireFinalReturn should allow die,
911       exit, etc.
912     * Each "for" and "foreach" loop now adds one point to the McCabe
913       complexity score.
914
915     Other Stuff:
916     * The internals of Perl::Critic have been significantly refactored,
917       but should still be compatible with existing third-party Policies.
918     * Added author-only tests to the release, but disabled by default
919     * New Perl::Critic::Utils::shebang_line() method
920     * Support for filename-based policies
921     * Additional prerequisite: Set::Scalar
922     * Now requires PPI version 1.118
923
924 [0.20]  Released on 2006-09-10
925
926     Perl::Critic now requires PPI version 1.117, which fixes
927     several bugs that were introduced in version 1.116.
928
929     Bug Fixes:
930     * 21079: grep clears @SITE_POLICIES
931     * 21352: Test failures with PPI 1.117
932     * 11365: sub DESTROY detected as a builtin homonym
933
934 [0.19]  Released on 2006-08-20
935
936     New Policies:
937     * BuiltinFunctions::ProhibitStringySplit
938     * ControlStructures::ProhibitDeepNests
939     * RegularExpressions::ProhibitCaptureWithoutTest
940     * Variables::RequireLexicalLoopIterator
941
942     New Features:
943     * "perlcritic -quiet" suppresses the "source OK" message.
944     * Variables::ProhibitPunctuationVars is now configurable.
945
946     Bug Fixes:
947     * 20965: "Hard tabs used at" shouldn't check __DATA__
948     * 21070: ProhibitNoisyQuotes hates overload
949     * Punctuation variables are now exempt from ProhibitLocalVars
950
951     Other Stuff:
952     * Test coverage is now over 95%
953
954 [0.18_01]  Released on 2006-08-06
955
956     New Policies:
957     * Variables::RequireNegativeIndices
958     * InputOutput::ProhibitInteractiveTest
959     * ErrorHandling::RequireCarping
960
961     Bug Fixes:
962     * RequireTidyCode tests fail if user has custom .perltidyrc file
963     * 20612: RequirePerlTidy was ignoring HEREDOCs
964     * 20659: __END__ statement considered "unreachable"
965     * Fix for PPI::XS (no C<use overload '""'> support)
966     * Support for 'goto' in ProhibitAmpersandSigils and
967       Subroutines::RequireFinalReturn
968
969     Performance Enhancements:
970     * Introduced Perl::Critic::Document class.  This is a facade for
971       PPI::Document which internally caches search results.  This
972       reduces the running time by about 35%.  The facade should be
973       invisible, unless you are doing something really sneaky.
974     * Extraction of the 'diagnostics' information is postponed
975       until it is really needed.  Speedup has not been measured.
976     * Calls to helper-subs have been reordered for maximum efficiency.
977
978     Other Cool Stuff:
979     * Includes updated version of perlcritic mode for emacs.  See
980       "extras/perlcritic.el" for details.
981
982 [0.18]  Released on 2006-07-16
983
984     Bug Fixes:
985     * 14855: Home discovery is dangerously naive.
986     * 20060: Incorrect page numbers in ProhibitLeadingZeros
987       and RequireNumberSeparator policies.
988     * 20068: .perlrc file - inconsistent documentation
989     * 20254: "use vars qw(@EXPORT_OK)" not recognized
990     * 20463: No-case heredoc terminator incorrectly detected as lower case.
991     * ProhibitOneArgBless doesn't understand "bless {} => $class;"
992     * ProhibitExcessComplexity doesn't count 'while' and 'until' stmnts
993     * ProhibitLeadingZeros was falsely hits '.0456'
994
995     Enhancements:
996     * If File::HomeDir is available, we use it to locate the
997       .perlcriticrc file.  This should help make Perl::Critic
998       more portable to Win32 platforms.  If File::HomeDir is
999       not installed, we resort to looking at the usual
1000       environment variables.
1001
1002     Other Stuff:
1003     * Added "perlcritic.el", which is a super-cool emacs minor-mode
1004       that runs perl-critic on the current buffer and returns the
1005       results in a sexy hot-linked "compiler" window.  You can run
1006       it on demand, or have it run automatically every time you
1007       save the buffer.  You can find this in the extras/ directory.
1008       Thanks to Josh ben Jore for contributing this.
1009
1010     * Moved "Perl::Critic::TestUtils" into the installed build.  This
1011       module is only used for unit-testing Perl::Critic, but we
1012       are putting it in the installation so folks who want to
1013       extend Perl::Critic can make use of it.
1014
1015 [0.17]  Released on 2006-06-13
1016
1017     Bug Fixes:
1018     * 19836: Perl-Critic0.16 fails tests during install.  This was
1019       caused by a bug in version 3.01 of Module::Pluggable.  See
1020       http://rt.cpan.org/Ticket/Display.html?id=19857 for details.
1021     * Fixed bug in no-critic pragma parser.
1022
1023     New Policies:
1024     * ValuesAndExpressions::ProhibitEscapedCharacters
1025     * BuiltinFunctions::RequireSimpleSortBlock
1026
1027     Enhancements:
1028     * Perl::Critic can export critique() as a static function.  This
1029       may appeal to folks who dislike the object-oriented interface.
1030
1031 [0.16]  Released on 2006-05-14
1032
1033     Enhancements:
1034     * Perl::Critic->critique() now accepts a PPI::Document as the
1035       argument.  This feature creates an additional dependency on
1036       Scalar::Util, but that shouldn't be a problem because it is
1037       included with List::Util, which we already use.
1038
1039     Miscellanea:
1040     * Increased PPI dependency from v1.110 to v1.112
1041
1042 [0.15_03] Released on 2006-05-07
1043
1044     Bug Fixes:
1045     * The "## no critic" feature is now implemented without eval-ing
1046       the code.  This keeps Perl::Critic pure and safe :)
1047     * 19082: Page number for AUTOLOAD is incorrect
1048
1049     New Policies:
1050     * ControlStructures::ProhibitUnreachableCode (by Peter Guzis)
1051     * Modules::ProhibitAutomaticExportation
1052     * ValuesAndExpressions::ProhibitVersionStrings
1053
1054 [0.15_02] Released on 2006-04-26
1055
1056     Bug Fixes:
1057     * Reimplemented the '##no critic' pragmas to have effect on the
1058       line where the violation is reported, not on the line where
1059       the candidate element lives.  This is because some policies
1060       may report violations that are nowhere near the element that
1061       is being evaluated.
1062     * RequireUseStrict, RequireUseWarnings, and RequireExplcitPackage
1063       all emit violations for _every_ statement that violates the
1064       Policy.  This closes a loophole that allowed you to circumvent
1065       the Policy by using '## no critic' on just the first statement
1066       that violated the policy.
1067     * Fixed the workaround for the magic shebang that is inserted
1068       by EU::MM and M::B.  This had stopped working around version 13.
1069     * Fixed -noprofile option on 'perlcritic'.  This also had stopped
1070       working at some point.
1071
1072 [0.15_01] Released on 2006-04-16
1073
1074     Enhancements:
1075     * Added diagnostic messages if the .perlcriticrc contains entries
1076       for Policy modules that don't seem to exist.
1077     * Now you can specify which policies to disable with the
1078       "## no critic" pseudo-pragmas.  This feature is still
1079       experimental.  See docs for details.
1080     * perlcritic's directory searching now skips backup files, such
1081       as *.swp, *.bak and *~.  It also ignores version control system
1082       directories, and the blib directory in module build directories.
1083
1084     Bug Fixes:
1085     * 18386: Bad example in POD for Documentation::RequirePodSections
1086     * 18670: Test failure if Perl::Tidy is not installed
1087     * 18698: Policy idea ProhibitUniversalFunctions (see New Policies)
1088     * RequireInterpolationOfMetachars falsely hit strings like 'foo=s@'
1089       which are commonly used with Getopt::Long.
1090
1091     New Policies:
1092     * BuiltinFunctions::ProhibitUniversalCan (by Chris Dolan)
1093     * BuiltinFunctions::ProhibitUniversalIsa (by Chris Dolan)
1094
1095     Miscellanea:
1096     * All spurrious options for `perlcritic` are now fatal.
1097     * Changed several of the -verbose formats to be more readable.
1098     * Explicit -severity option now overrides -[12345] shortcuts instead
1099       of being the other way around.
1100
1101
1102
1103 [0.15] Released on 2006-03-26
1104
1105     Bug Fixes:
1106     * 17964: Insists my code is not tidy (may not be fixed for all cases)
1107
1108 [0.14_02] Released on 2006-03-19
1109
1110     Bug Fixes:
1111     * 15653: False positive in OneArgSelect (fixed for real this time)
1112
1113     New Policies:
1114     * ClassHierarchies::ProhibitAutoloading
1115     * Documentation::RequirePodSections
1116     * InputOutput::RequireBracedFileHandleWithPrint
1117     * ValuesAndExpressions::ProhibitMixedBooleanOperators
1118     * Variables::RequireInitializationForLocalVars
1119
1120 [0.14_01] Released on 2006-03-05
1121
1122     Bug Fixes:
1123     * 14731: False positive: Builtin function called with parens
1124     * 17554: False positive in CodeLayout::RequireTrailingCommas
1125
1126     New Policies:
1127     * ClassHierarchies::ProhibitExplicitISA
1128     * InputOutput::ProhibitReadlineInForLoop
1129     * Miscellanea::ProhibitFormats
1130     * Miscellanea::ProhibitTies
1131     * Variables::ProhibitConditionalDeclarations
1132
1133 [0.14] Released on 2006-01-29
1134
1135     More documentation edits.
1136
1137     New Policies:
1138     * Documentation::RequirePodAtEnd
1139     * Subroutines::ProtectPrivateSubs
1140     * Variables::ProhibitMatchVars
1141     * Variables::ProtectPrivateVars
1142
1143     Bug Fixes:
1144     * 15295: "## no critic" pragmas too aggresive on compound statements.
1145     * t/01_config.t failed in the presence of third-party policies
1146
1147 [0.13_05] Not released
1148
1149     More documentation edits.
1150
1151     Implemented workaround for failing pod_coverage tests.
1152
1153     Bug Fixes:
1154     * 16906:  tr/// created false-postives with RegularExpression polices.
1155
1156 [0.13_04] Released on 2005-12-31
1157
1158     Moved DEVELOPER.pod file into the Perl/Critic dir.
1159
1160     More documentation edits.
1161
1162 [0.13_03] Released on 20051230
1163
1164     perlcritic now prints 'source OK' if it doesn't find any
1165     violations.  This gives folks a warm fuzzy feeling.
1166
1167     Tweaked some test cases that were failing on my Solaris
1168     environment at work.
1169
1170 [0.13_02] Released on 2005-12-29
1171
1172     Fixed Config to recognize fully-qualified module names in the
1173     .perlcriticrc file.
1174
1175     Various documentation edits.
1176
1177 [0.13_01] Released on 2005-12-28
1178
1179     Replaced 'priority' concept with 'severity'.  Now each Policy module
1180     has a predefined severity level ranging from 1 to 5.  By default,
1181     perlcritic only reports the most severe violations.  You can adjust
1182     the severity threshold at the command line, and you can change
1183     the severity for any Policy using the config file.
1184
1185     Chris implemented the applies_to() mechanism, which allows each Policy
1186     class to declare the types of PPI elements that it wants to examine.
1187     When traversing the document, Perl::Critic invokes the Policy only
1188     for elements that are of the correct type.  This improves performance
1189     by about 33%.
1190
1191     Perl::Critic now uses a Plugin architecture to automatically
1192     discover Policy modules.  So if you have custom Policies, all you
1193     have to do is install them in the Perl::Critic::Policy namespace --
1194     no need to add anything to your .perlcriticrc file.  If you write
1195     policies in a different namespace, you can configure that too.  See
1196     the Perl::Critic::Config docs for details.
1197
1198     New Policies:
1199     * Modules::RequireEndWithOne
1200     * NamingConventions::ProhibitAmbiguousNames
1201     * References::ProhibitDoubleSigils
1202     * Subroutines::RequireFinalReturn
1203     * Subroutines::ProhibitAmpersandSigils
1204     * Subroutines::ProhibitExcessComplexity
1205     * TestingAndDebugging::ProhibitNoStrict
1206     * TestingAndDebugging::ProhibitNoWarnings
1207
1208     Bug Fixes:
1209     * 15101: Plugin architecture improves support for 3rd-party code
1210     * 16319: Fixed incorrect PBP page number in ProhibitBarwordFilehandle
1211     * 16321: Lists of empty quotes are now allowed by ProhibitQuotedWordLists
1212     * 16288: Empty lists caused a fatal error RequireTrailingCommas
1213     * 15653: Fixed false positive in OneArgSelect.
1214
1215 [0.13] Released on 2005-10-31
1216
1217     Official release of 0.12_03.  No code major changes.
1218
1219 [0.12_03] Not released
1220
1221     Renamed -Policy option to -include.  Added -exclude to give the
1222     opposite effect.
1223
1224     Refactored constructor of Perl::Critic.  Now, most of the work
1225     is delegated to Perl::Critic::Config.  I'm not sure I like how
1226     this turned out, but we'll see how it goes.
1227
1228     Renamed some Policy modules to be a bit more comprehensible.  Note
1229     that you may need to change your .perlcriticrc file accordingly.
1230     I also suggest removing your current Perl::Critic installation
1231     before installing this one.
1232
1233     Name Changes:
1234     * ProhibitUnpackagedCode => RequireExplicitPackage
1235     * RequireQuotedWords     => ProhibitQuotedWordLists
1236
1237     Improved error message when Perl::Critic dies because PPI can't
1238     parsee the input code.
1239
1240     Changed output of -help to be more terse.
1241
1242     Edited POD.
1243
1244 [0.12_02] Not released
1245
1246     Added -Policy option to perlcritic.  The idea is to provide a
1247     compact interface for selecting Policy modules at the command-line.
1248     This feature is experimental and subject to change.
1249
1250     Added a warning message if -verbose value looks strange.  In most
1251     applications, the -verbose option does not require a value, so people
1252     might be puzzled when they write 'perlcritic -verbose my_file.pm' and
1253     nothing seems to happen.
1254
1255     Command-line options to perlcritic are now case-sensitive.  This
1256     makes it easier to abbreviate options that start with the same letters
1257     (e.g. 'Version' and 'verbose')
1258
1259     Fixed the new Policy modules that were misnamed and misplaced in the
1260     previous distribution.
1261
1262 [0.12_01] Not released
1263
1264     Rewrote some of the ControlStructures and BuiltinFunction
1265     policies to be simpler (and probably a little faster).
1266
1267     Edited POD.  Fixed some typos.  Added PREREQUISITES section
1268     to Perl::Critic documentation.
1269
1270     Fixed the -verbose FORMAT option so that you can put metachars
1271     in the FORMAT specification.  If using perlcritic, be careful to
1272     protect them from getting munged by the shell first.
1273
1274     Replaced ProhibitRequireStatements with RequireBarewordIncludes
1275     module. Courtesy of Chris Dolan <cdolan@cpan.org>
1276
1277     Added configuration to ProhibitInterpolationOfLiterals so that
1278     certain flavors of quotes can be exempt.  This is for folks who
1279     have configured their editor to use special syntax highlighting
1280     for certain kinds of strings (SQL, for example).
1281
1282     perlcritic now accepts multiple file arguments, so now you can
1283     critique your entire distribution in one shot.  As a result, the
1284     output-formats have changed slightly.
1285
1286     New Policy modules:
1287     * BuiltinFunctions::ProhibitLvalueSubstr
1288     * BuiltinFunctions::ProhibitSleepViaSelect
1289     * ClassHierarchies::ProhibitOneArgBless
1290     * CodeLayout::RequireTrailingCommas
1291     * CodeLayout::RequireQuotedWordLists
1292     * InputOutput::ProhibitTwoArgOpen
1293     * InputOutput::ProhibitOneArgSelect
1294     * InputOutput::ProhibitBarewordFileHandles
1295     * Miscellanea::RequireRcsKeywords
1296     * Modules::RequireVersionVar
1297     * RegularExpressions::RequireExtendedFormatting
1298     * RegularExpressions::RequireLineBoundaryMatching
1299
1300
1301     Bug fixes:
1302     14923: 'require' is now permitted. See RequireBarewordIncludes.
1303     15022: Fixed false-positives when keywords are used as hash keys.
1304     15023: Fixed spurious Violations by removing magic shebang.
1305     15031: Fixed spelling mistakes (and probably added some new ones).
1306     15233: Postfix 'if' is now allowed with 'die', 'croak', etc.
1307
1308 [0.12] Released 2005-10-10
1309
1310     Redesigned the 'verbose' feature.  Now the output format
1311     can be user-defined using a sprintf-like specification.
1312     perlciritc also has a predefined output format that is
1313     compatible with grep mode in editors like vim and emacs.
1314
1315     'return' is now exempt from ProhibitParensWithBuiltins.  I may
1316     extend this exemption to all unary functions.
1317
1318     Edited POD. Added a super brief description of each policy
1319     in the main Perl::Critic documentation.  Added details about
1320     editor integration.
1321
1322     Additional Prerequisites:
1323     * String::Format
1324
1325 [0.11] Not released
1326
1327     The internal dynamics and API of Perl::Critic have changed
1328     considerably.  The result is a 300% increase in performance.
1329     See the POD in Perl::Critic::Policy for details.
1330
1331     New Features:
1332     * Added -verbose option to put more stuff in the output.  In the
1333       extreme, you can get the POD from Policy attached to each
1334       and every violation.
1335
1336     Additional Prerequisites:
1337     * IO::String
1338     * Pod::PlainText
1339
1340 [0.10] Released 2005-10-05
1341
1342     Fixed stupid bug in newest Policy modules.  They were returning
1343     PPI objects instead of Perl::Critic::Violation objects.  Doh!
1344
1345     Fixed test scripts to prevent failures if the user already has a
1346     .perlcriticrc file.
1347
1348     'ProhibitHardTabs' now allows leading tabs by default.
1349
1350     Put the Changes file in reverse-chronological order, so the most
1351     recent stuff is easy to find at the top of the file
1352
1353 [0.09] Released 2005-10-04
1354
1355     Fixed several bugs:
1356     * 14810: Now you are allowed to create your own 'import' function,
1357              since this is frequently done with fancy modules.
1358     * 14817: Parens, brackets, and braces are now excluded from
1359              'ProhibitNoisyQuotes' since they look better in quotes anyway.
1360     * 14787: $1..$9 and '_' are exempt from ProhibitPunctuationVars
1361     * 14899: Object methods with the same name as a built-in can
1362              be called with parens (ProhibitParensWithBuiltins).
1363     * 14901: Normalized the exit status of perlcritic to 0, 1, or 2.
1364              See documentation for explanation.
1365     * 14855: Partially fixed home directory discovery.  Still not
1366              completely portable, but at least doesn't create warnings.
1367
1368     New features:
1369     * 14734: Limit for number separators is now configurable
1370
1371     New Policy modules:
1372     * CodeLayout::ProhibitHardTabs
1373     * ControlStructures::ProhibitUnlessBlocks
1374     * ControlStructures::ProhibitUntilBlocks
1375     * ControlStructures::ProhibitCStyleForLoops
1376
1377     Changed the syntax for the magic comments.  Adam had the
1378     idea of using a pragma-like notation.  I liked it.
1379
1380 [0.08_2] Released 2005-09-27
1381
1382     Fixed problems with Perl::Critic::Config that caused File::Spec
1383     to emit 'uninitialized value' warnings during the build.
1384
1385     Added 1 Policy module contributed by Graham TerMarsch
1386
1387     Switched from File::Spec::Functions to plain File::Spec because
1388     I think its usage is more common.
1389
1390     Removed 'FindBin' from the test files so I can be sure that the
1391     right libraries are getting loaded.  This means I'll have to
1392     use the -l option with C<prove>.
1393
1394     Edited more POD.
1395
1396 [0.08_01] Not released
1397
1398     Fixed "ProhibitParensWithBuiltins" to allow parens to be used with
1399     object method calls that have the same name as a builtin functions.
1400
1401     Introduced magical comments that allow developers to configure
1402     Perl::Critic on-the-fly from within their code.
1403
1404     Added META.yml files and POD tests to the build.  I did this
1405     mostly just to boost the Kwalitee score on CPANTS.
1406
1407     Switched from "Config::Std" to "Config::Tiny" because it doesn't
1408     require those fancy Damian modules that don't seem to work on
1409     some older versions of Perl.
1410
1411 [0.07] Released on 2005-09-21
1412
1413     Fixed bugs in the ProhibitCascadingIfElse policy.
1414
1415     Added ProhibitExplicitReturnUndef policy
1416
1417     Made ProhibitUnpackagedCode configurable so you can exempt scripts,
1418     which typically don't have an explicit 'package' statement.
1419
1420     ProhibitPackageVars policy now exempts vars in ALL_CAPS.  This
1421     is to permit common package variables like @EXPORT and $VERSION.
1422
1423     Renamed "ProhibitStringyGrep and "ProhibitStringyMap" because
1424     the so-called string form doesn't really exist.  Now called
1425     "RequireBlockGrep" and "RequireBlockMap"
1426
1427     Corrected documentation on defining Policy names within the
1428     configuration file.  This still isn't very clear and needs
1429     to be rewritten.
1430
1431     Perl::Critic now requires PPI version 1.003, which has a few bug
1432     fixes of its own.
1433
1434     Rewrite some code just to make Perl::Critic more self-compliant.
1435
1436     Added test cases to verify the configuration functionality.  These
1437     are not completely thorough and need more work.
1438
1439 [0.06] Released on 2005-09-17
1440
1441     Now called 'Perl::Critic'.
1442
1443     Added 4 new policy modules.
1444
1445     Fixed bugs in build process.
1446
1447     Added support for Module::Build.
1448
1449 [0.05] Released on 2005-09-17
1450
1451     End of 'Perl::Review' releases.  I have changed the name to
1452     'Perl::Critic' to avoid possible confusion with "The Perl Review"
1453     magazine.
1454
1455 [0.04] Released on 2005-09-14
1456
1457     Version 0.03 was a bust because I uploaded the wrong tarball to PAUSE.
1458
1459 [0.03] Released on 2005-09-13.
1460
1461     Fixed some POD links.
1462
1463     Removed test cases for missing policy module.
1464
1465 [0.02] Released on 2005-09-13.
1466
1467     Major overhaul based on feedback from Perl community.
1468
1469     Factored coding standards into separate modules (known as
1470     Policies).  The idea here is to allow other developers to easily
1471     contribute additional coding standards.
1472
1473     Reworked Perl::Review into a simple engine for loading and running
1474     Policy modules.
1475
1476     Gave perlreview a command-line interface and configuration file
1477     for selecting which Policy modules to use.
1478
1479 [0.01] Released on 2005-08-16.
1480
1481     Initial version.
1482
1483 ##############################################################################
1484 #      $URL$
1485 #     $Date$
1486 #   $Author$
1487 # $Revision$
1488 ##############################################################################
1489
1490 # ex: set ts=8 sts=4 sw=4 tw=78 ft= expandtab shiftround :