1 [1.088] Released on 2008-07-03
4 * ErrorHandling::RequireCheckingReturnValueOfEval
7 * ValuesAndExpressions::ProhibitLeadingZeros now accepts octal numbers
8 for the Unix permissions argument to chmod, dbmopen, mkdir, sysopen, or
9 umask, by default. Use the "strict" option to get the old behavior.
11 * Due to the consensus at YAPC::NA 2008,
12 Variables::ProhibitUnusedVariables default severity has been raised to
16 * The perlcritic "--Version" option is now "--version" in order to act
17 like the rest of the world.
19 [1.087] Released on 2008-06-21
22 * CodeLayout::ProhibitParensWithBuiltins no longer complains about
24 * TestingAndDebugging::RequireUseWarnings will not complain about files
25 that contain a "use 5.005" statement or similar for perls prior to 5.6.
26 Lesson of the day: computer conferences where you can meet in the real
27 world can clarify conversations greatly. Good to finally meet you Adam.
28 * InputOutput::ProhibitTwoArgOpen similarly will not complain if there's
29 a "use/require 5.005" statement in the file. RT #34385.
32 * Perl::Critic can now critique a file named "0". However, PPI will give
33 a parse error until the next version comes out. Fixes RT #36127.
34 * Moved detection of the lack of any enabled Policies from P::C::Config
35 to Perl::Critic. This was causing the perlcritic.t in Parrot to fail.
36 Note, however, there are plans afoot to change how Perl::Critic is
37 configured and things that depend upon that may break. Please contact
38 users@perlcritic.tigris.org and tell us how you're using P::C::Config
39 directly so that we can take your needs into account.
41 [1.086] Released on 2008-06-12
44 * NamingConventions::ProhibitAmbiguousNames now specifies the name that
45 it had problems with in its violation descriptions.
48 * The color option wasn't being correctly set from a .perlcriticrc.
52 * --colour is now a synonym for --color.
54 [1.085] Released on 2008-06-07
57 * Documentation::RequirePackageMatchesPodName
60 * Variables::ProhibitUnusedVariables detects a few more cases. It's
61 still very limited, though.
64 * ControlStructures::ProhibitUnreachableCode didn't notice "until" was an
65 conditional expression.
67 Minor documentation updates.
69 [1.084] Released on 2008-05-24
72 * perlcritic now supports a --list-themes option.
73 * You can specify the maximum number of violations you want per Policy
74 per document. Developers can give a default value for this for a
75 Policy by overriding default_maximum_violations_per_document().
76 See RequireUseStrict and ProhibitMagicNumbers for examples.
79 * The ValuesAndExpressions::ProhibitMagicNumbers policy has been moved
80 from Perl::Critic::More into the primary Perl::Critic distribution.
83 * Variables::ProhibitUnusedVariables (very dumb, limited initial
85 * ControlStructures::ProhibitLabelsWithSpecialBlockNames
86 Contributed by Mike O'Regan. Kickin' ass, Mike.
89 * ControlStructures::ProhibitUnreachableCode now handles the perl 5.10
90 "//" and "err" operators. RT #36080
91 * InputOutput::RequireBriefOpen now ignores opens of STDIN, STDOUT,
92 and STDERR. You're generally trying to make long-lasting global
93 effects when manipulating these. (RT #35774)
94 * RegularExpressions::ProhibitUnusualDelimiters now supports an
95 "allow_all_brackets" option.
96 * RegularExpressions::RequireBracesForMultiline now supports an
97 "allow_all_brackets" option.
98 * TestingAndDebugging::RequireUseStrict now accepts "use Moose::Role"
99 as equivalent to "use strict". (RT #34838)
100 * TestingAndDebugging::RequireUseWarnings now accepts "use Moose::Role"
101 as equivalent to "use warnings". (RT #34838)
102 * ValuesAndExpressions::ProhibitMagicNumbers now accepts constant
104 * Variables::ProhibitMatchVars no longer detects "use English;".
105 This problem is detected in a more clear way by
106 Modules::RequireNoMatchVarsWithUseEnglish.
107 * Variables::ProhibitPerl4PackageNames no longer complains about
108 $'/$POSTMATCH. RT #36059
109 * Variables::RequireLocalizedPunctuationVars now allows the use of "my".
113 * No longer falls over if a single file has a parse error.
115 New Developer Features:
116 * If a document specifies a minimum perl version, e.g. "use 5.008003",
117 P::C::Document::highest_explicit_perl_version() will tell you what it
119 * The parameter to P::C::Policy::initialize_if_enabled is now a
120 P::C::PolicyConfig object instead of a hash reference.
123 * LOTS of documentation updates.
124 * A few more statistics are emitted by perlcritic with the --statistics
126 * perlcritic --profile-proto now includes policy abstracts in its
130 * Now depends upon PPI 1.203.
131 * New dependency upon version.
133 [1.083_006] Released on 2008-05-20
134 [1.083_005] Released on 2008-05-19
135 [1.083_004] Released on 2008-05-18
136 [1.083_003] Released on 2008-05-17
137 [1.083_002] Released on 2008-05-17
138 [1.083_001] Released on 2008-04-13
140 Changes summarized into 1.084 above. For exact details, see Changes in
141 1.083_006 on BackPAN.
143 [1.082] Released on 2008-03-08
146 * A new metadata system for defining policy parameters/options has been
147 added. This makes the life of policy authors easier because
148 configuration validation and parsing can be taken care of
149 automatically, in most cases. This allows greater integration with
150 IDEs and allows the perlcritic "--profile-proto" option to produce
153 Note: This change does NOT REQUIRE ANY CHANGES to policies outside of
154 this distribution; they should continue to work as is. However, use
155 of this facility can reduce the size of your code and provide the
156 means for tools to discover more about your policy. If this change
157 does break any of your policies, please let us know.
159 To learn how to take advantage of this facility, read
160 Perl::Critic::DEVELOPER and look at the source of any of the
161 configurable policies included in this distribution.
163 There is a discussion of the design considerations for this facility in
164 the source repository under doc/PolicyParameter_Notes.pod.
166 * Added support for "criticism-fatal" option in your perlcriticrc
167 file. This will be used by the criticism pragma to cause execution
168 to abort if the file contains any violations.
171 * Module::RequireNoMatchVarsWithUseEnglish
174 * Added an allow_last_statement_to_be_comma_separated_in_map_and_grep
175 option to ValuesAndExpressions::ProhibitCommaSeparatedStatements.
176 Partial response to http://rt.cpan.org/Public/Bug/Display.html?id=27654.
177 * ControlStructures::ProhibitPostfixControls gains the ability to have
178 the flow control statements allowed to be modified. This in response
180 * TestingAndDebugging::RequireUseStrict now accepts "use Moose" as
181 equivalent to "use strict".
182 * TestingAndDebugging::RequireUseWarnings now accepts "use Moose" as
183 equivalent to "use warnings".
186 * RT #31281 perlcritic doesn't recognize "#!/bin/env perl" shebang
187 * Replace usage of Unicode property escapes with POSIX character classes
188 order to restore 5.6 compatability.
189 * RT #30388 ValuesAndExpressions::ProhibitVersionStrings complained
190 about numbered directories in "use lib".
191 * Fixed handling of badly behaved spelling programs in PodSpelling.
193 [1.081_006] Released on 2008-03-02
194 [1.081_005] Released on 2007-12-29
195 [1.081_004] Released on 2007-12-20
196 [1.081_003] Released on 2007-12-16
197 [1.081_002] Released on 2007-12-16
198 [1.081_001] Released on 2007-12-15
200 Changes summarized into 1.082 above. For exact details, see Changes in
201 1.081_006 on BackPAN.
203 [1.080] Released on 2007-11-11
206 * Allow a "## no critic" statement after a shebang on line 1 of a
207 file. This allows users to block violations that apply to
208 whole files and still allow shebangs.
210 New Policies: (funded by a Perl Foundation grant)
211 * InputOutput::ProhibitExplicitStdin
212 * RegularExpressions::ProhibitFixedStringMatches
213 * RegularExpressions::RequireBracesForMultiline
214 * RegularExpressions::ProhibitUnusualDelimiters
215 * RegularExpressions::ProhibitUnusedCapture
216 * RegularExpressions::ProhibitComplexRegexes
217 * RegularExpressions::ProhibitSingleCharAlternation
218 * RegularExpressions::ProhibitEscapedMetacharacters
219 * RegularExpressions::ProhibitEnumeratedClasses
220 * InputOutput::RequireBriefOpen
221 * InputOutput::RequireCheckedSyscalls
224 * ControlStructures::ProhibitNegativeExpressionsInUnlessAndUntilConditions
227 * Variables::ProhibitConditionalDeclarations now permits you to local-ize
228 variables in conditional declarations. This makes sense, since
229 C<local> is actually a variable modifier, rather than a declaration.
230 Thanks to David Golden for reporting this.
232 New Developer Features:
233 * Perl::Critic::Utils::PPIRegexp encapsulates interaction with
234 the PPI Regexp token classes. Those classes have very sparse
235 APIs, so this package hides away the ugly fiddling with PPI
237 * Added a new optional_modules parameter for the .run syntax.
240 * PPI::Structure::List can now contain multiple children,
241 so P::C::Utils::parse_arg_list() needs to handle it.
243 This was done in the process of fixing
244 http://rt.cpan.org/Ticket/Display.html?id=24924, which was a problem
245 with TestingAndDebugging::RequireTestLabels.
247 * ValuesAndExpressions::ProhibitLongChainsOfMethodCalls wasn't resetting
248 chain length when it ran into the end of a sub-expression.
250 http://rt.cpan.org/Public/Bug/Display.html?id=30040
252 * ValuesAndExpressions::ProhibitCommaSeparatedStatements was reporting
253 false positives when builtins which accept both no and multiple
254 arguments were involved.
256 http://rt.cpan.org/Public/Bug/Display.html?id=27654
259 * Removed all use of Carp in favor of exceptions.
262 * Now requires PPI 1.201. A number of workarounds for PPI bugs have been
264 * New dependency upon Exception::Class.
267 * Use Devel::CheckOS to see whether Perl::Critic is being installed on
268 a Solaris system and warn about tar(1) chopping file names off if it
271 [1.079_003] Released on 2007-10-22
272 [1.079_002] Released on 2007-10-21
273 [1.079_001] Released on 2007-10-09
275 Changes summarized into 1.080 above. For exact details, see Changes in
276 1.079_003 on BackPAN.
278 [1.078] Released on 2007-09-19
280 Restore Perl::Critic::TestUtils::should_skip_author_tests() and
281 get_author_test_skip_message(). Some Perl::Critic add-on distributions
284 [1.077] Released on 2007-09-15
286 Note: if you don't have any problems installing Perl::Critic 1.076, there
287 is no need to upgrade to this version. There are no functionality
288 changes. This release only contains changes related to installation that
289 a few people were experiencing.
292 * Removed build-time use of Readonly, again, due to problems some people
293 were having when trying to compile the code by hand, rather than using
295 * Don't run author tests if there's a .svn directory present because
296 users who grabbed the code from the source repository were executing
297 them and getting failures.
298 * Don't generate optional, module-hiding test wrappers if author tests
302 [1.076] Released on 2007-09-07
304 It appears from reports on the 1.075_001 release that the subroutine
305 sigils were indeed the problem. Release to the general populace.
308 [1.075_001] Released on 2007-09-06
311 Undo the changes in 1.073 and 1.074. Instead, stop using the subroutine
312 sigil in import and export lists. It is suspected that the problem lies
313 with Exporter stripping off ampersands.
315 [1.074] Released on 2007-09-04
318 Repeat the Makefile.PL change on
319 t/generate_without_optional_dependencies_wrappers.PL.
322 [1.073] Released on 2007-09-04
325 Work around problems with the combination of Exporter & Readonly in
326 Makefile.PL on some machines.
328 [1.072] Released on 2007-09-03
331 * The Makefile generated by Makefile.PL was not syntactically correct
332 according to some versions of Solaris. Thanks to Diab Jerius
333 (DJERIUS) for discovery and testing.
334 * Fixed mis-definition of "quiet" value for the "--profile-strictness"
336 * Enhanced testing with the absence of optional modules.
338 [1.071] Released on 2007-08-24
340 The "Brown Paper Bag" Release
343 * Tests would not pass in environments that did not have all optional
344 dependencies installed.
346 [1.07] Released on 2007-08-21
348 New Policies: (funded by a Perl Foundation grant)
349 * BuiltinFunctions::ProhibitBooleanGrep
350 * BuiltinFunctions::ProhibitComplexMappings
351 * Documentation::PodSpelling
352 * InputOutput::ProhibitJoinedReadline
353 * Subroutines::ProhibitManyArgs
354 * Subroutines::RequireArgUnpacking
355 * ValuesAndExpressions::ProhibitImplicitNewlines
356 * Variables::RequireLocalizedPunctuationVars
359 * Subroutines::ProhibitNestedSubs
362 * The "perlcritic --profile-proto" output now includes the "add_themes"
363 parameter for each policy.
364 * The perlcritic "--strict-profile" option has been replaced with a
365 "--profile-strictness" option. This new option takes values of "warn"
366 (the default), "fatal", and "quiet", which controls what happens with
367 ignorable problems in a .perlcriticrc file.
369 New Developer Features:
370 * Perl::Critic::Policy now has an overridable initialize_if_enabled()
371 method which allows a Policy to perform expensive initialization after
372 it has been determined whether the user has it enabled or not. Also,
373 this method allows a Policy to say that it should be disabled
374 regardless of what the user says.
376 Actually, use of this method is now encouraged over using a
380 * Now requires the Readonly module in order to be more self-compliant.
382 [1.061] Released on 2007-07-24
385 * Fix P::C::Theme-- Exporter in Perl 5.6 does not export import(), so you
386 must subclass it. *sigh*
387 * Fix P::C::Config::_validate_and_save_theme()-- eval of an empty string
388 does not reset $@/$EVAL_ERROR in Perl 5.6.
390 Big thanks to Anirvan Chatterjee for identifying and helping debug these
393 [1.06] Released on 2007-06-27
396 * perlcritic now emits errors for all the problems it can find for the
397 global options in the command-line parameters and .perlcriticrc file,
398 rather than bailing on the first one it encounters.
400 * perlcritic now has a "--strict-profile" option which will make warnings
401 about problems in a profile fatal.
403 * perlcritic now has a "--statistics-only" option which suppresses the
404 display of individual violations and only shows the additional output
405 produced by the "--statistics" option.
408 * A value for "color" can now be specified in a .perlcriticrc.
409 http://rt.cpan.org/Ticket/Display.html?id=24877
412 * ValuesAndExpressions::ProhibitQuotesAsQuotelikeOperatorDelimiters
413 As suggested in http://rt.cpan.org/Ticket/Display.html?id=23290.
414 * ValuesAndExpressions::ProhibitLongChainsOfMethodCalls
415 * Modules::ProhibitExcessMainComplexity
416 As suggested in http://rt.cpan.org/Ticket/Display.html?id=24699
419 * The perlcritic "--profile-proto" option now emits the short names for
420 policies, rather than the full ones.
422 * The "-profileproto" and "-singlepolicy" options have been renamed to
423 "-profile-proto" and "-single-policy" in order to make the growing
424 number of command-line options comprehensible. The change of
425 "singlepolicy" also affects your F<.perlcriticrc> file.
427 [1.053] Released on 2007-06-02
429 *DEVELOPMENT RELEASE*
432 Fixed bug in 15_statustics.t test script, which caused the build
433 to fail on machines that don't have Perl::Tidy installed.
435 [1.052] Released on 2007-06-01
437 *DEVELOPMENT RELEASE*
440 * perlcritic now emits a summary about the scanned code when enabled by
441 the "-statistics" option.
444 * InputOutput::ProhibitBacktickOperators can now be configured to only
445 check in void contexts.
448 * 27073: False positive in RequireUpperCaseHeredocTerminator
449 * 27065: CodeLayout::ProhibitTrailingWhitespace breaks under Perl 5.6.1
450 * 26462: ControlStructures::ProhibitCascadingIfElse pod typo
451 * ValuesAndExpressions::ProhibitCommaSeparatedStatements was complaining
452 about multiple values in the list to be iterated over by a foreach loop.
453 * Corrected PBP page numbers for some policies (Quinn Weaver).
455 [1.051] Released on 2007-04-12
457 *DEVELOPMENT RELEASE*
460 No particular bug fixes.
463 * Added several new utility functions to support the StricterSubs distro.
464 Also, some of the existing functions in Perl-Critic-Utils have
465 changed in ways that might break your custom policies.
468 * Updated Emacs plugin (Courtesy Josh ben Jore).
469 See extras/perlcritic.el for details.
470 * Added copy of BBEdit plugin (Courtesy of Josh Clark).
471 See extras/perl_critic_for_bbedit-1_0.zip for details
473 [1.05] Released on 2007-03-19
476 * 25557: t/20_policy_prohibittrailingwhitespace.t fails on Perl 5.8.0
478 [1.04] Released on 2007-03-18
481 * 25008: Subroutines::RequireFinalReturn should allow "throw"
482 * 25085: False Positive - Heredoc terminator must be quoted
483 * 18423: VERSION check does not notice Readonly::Scalar version
484 * 25449: Proposal of $VERSION declaration (DUPLICATE)
487 * CodeLayout::ProhibitTrailingWhitespace
488 * ValuesAndExpressions::ProhibitCommaSeparatedStatements
489 * Variables::ProhibitPerl4PackageNames
492 * Subroutines::RequireFinalReturn can now be configured to recognize
493 your custom functions that behave like "die" or "exit".
494 * Documentation::RequirePodSections can be configured to match
495 Module::Starter:PBP or to really match the PBP book.
497 [1.03] Released on 2007-02-13
500 * Fixed a few more problems with the %f, %F, and %r format escapes.
501 * I forgot to put Conway's perlcriticrc file in the MANIFEST. Sorry.
504 * Perl::Critic::Utils automatically exports everything. However,
505 this is deprecated. In the future, you must request your exports.
508 * Duplicate violations of RequireExcplicitPackage are now squelched,
509 in the same way as RequireUseStrict and RequireUseWarnings.
511 [1.02] Released on 2007-02-11
514 * "undef" incorrectly triggered ProhibitMutatingListFunctions.
515 * 24876: %f and %F escapes not working in custom "verbose" format strings.
516 * 24875: Documentation bug in TestingAndDebugging::ProhibitNoStrict
519 * InputOutput::RequireCheckedOpen
520 * InputOutput::RequireCheckedClose
523 * Added Conway's own suggested Perl::Critic configuration as
524 examples/perlcriticrc-conway.
526 * See the examples/ directory for some neat demonstrations of using
527 the Perl::Critic API. Contributed by Elliot Shank.
530 * Perl::Critic::Utils no longer exports anything by default. Policies
531 outside the distribution will need to specify what exactly they need
532 from this module. There are a number of tags that can be used in
533 addition to individual imports.
535 [1.01] Released on 2007-01-24
537 PRODUCTION RELEASE: You may now consider the public Perl::Critic
538 API as "stable." Future minor releases will focus on bug fixes,
539 new policies, and internal refactoring.
542 * Fixed memory leak. This was reported by the Parrot team at
543 http://rt.perl.org/rt3/Ticket/Display.html?id=41230
545 [0.23] Released on 2007-01-19
548 * 23994: Test 56 in t/05_utils.t of Perl::Critic v0.22 fails
549 * 24005: test 95 in t/13_bundled_policies fails in 0.22
553 * Added '%F' to the Violation format specifications. This will
554 give you just the name of file where the violation occurred
555 (i.e. without the path).
557 * Improved validation of .perlcriticrc file. An invalid
558 default setting will now cause a fatal exception. A
559 strange-looking policy name will cause a warning.
563 * The syntax for theme expressions has changed. Instead of using
564 mathematical operators qw(+ * -) you must now use the logical
565 operators qw(|| && !). See the Perl::Critic docs for more info.
567 * The @GLOBALS and @BUILTINS variables are no longer exported by
568 Perl::Critic::Utils. Use the is_perl_global() and is_perl_builtin()
571 * Perl::Critic::Policy::policy_parameters() has bee renamed to
572 Perl::Critic::Policy::supported_paramters(). This was an
573 undocumented feature anyway, so it shouldn't affect anyone.
576 Other Internal Changes:
577 * Perl::Critic now requires B::Keywords v1.05 or newer.
579 * A few internal classes have been refactored. As a result,
580 Set::Scalar is no longer a required dependency.
583 [0.22] Released on 2006-12-15
586 * Introduced named severity levels: gentle, stern, harsh, cruel, brutal
587 You can use these named levels instead of the numeric ones.
588 For example: "perlcritic --severity=cruel MyModule.pm"
589 Or just: "perlcritic --cruel MyModule.pm"
591 * For perlcritic, the "-List" option has been renamed to
592 "-profileproto". The output now includes the names of the
593 parameters that each Policy supports, if any.
595 * Improved validation of Policy parameters in your F<.perlcriticrc>
596 Any invalid parameter now causes a fatal exception.
599 * Reassigned themes for most policies. Now there are fewer
600 themes and they are organized around programming concepts
601 instead of severity levels. If you have assigned your own
602 themes to any Policies, they should still work as expected.
605 * ErrorHandling::RequireCarping will not complain if it can figure
606 out that the die or warn message will always end in a newline
607 ("\n"). The idea is that, if you put the newline there, you
608 don't indend for there to be any file/line/stack information
609 emitted, in which case you really don't want carp/croak.
611 You can restore the old strict behavior by giving the policy
612 a false value for "allow_messages_ending_with_newlines" in your
617 Added single-letter uppercase alternatives for some perlcritic options.
619 [0.21_01] Released on 2006-12-03
622 * TestingAndDebugging::ProhibitProlongedStrictureOverride
623 * ControlStructures::ProhibitMutatingListFunctions
626 * Say "perlcritic -List" to get an expanded listing of all Policies.
627 The format is suitable for use as your .perlcriticrc file.
628 * Say "perlcritic -doc PATTERN" to get the documentation for all
629 Policies that match m/PATTERN/imx. This is a little easier than
630 typing in the full name of the Policy module with "perldoc".
631 * Say "perlcritic --singlepolicy PATTERN" to use one and only one
633 * Can now specify exceptions to Variables::ProhibitPackageVars,
634 for packages like File::Find that only interface through
638 * 21713 false positive for parens used with substr and unpack.
639 * 22890 allow Rcs keywords in POD.
642 * Testing system overhauled. Details on the Policy/subtest
643 framework is in t/run.t.
644 * Added Perl::Critic::Utils::words_from_string. This is safer
645 than plain old C<split /\s+/>.
647 [0.21] Released on 2006-11-05
650 * BuiltinFunctions::ProhibitReverseSortBlock
651 * BuiltinFunctions::ProhibitVoidGrep
652 * BuiltinFunctions::ProhibitVoidMap
653 * CodeLayout::RequireConsistentNewlines
654 * Modules::RequireFilenameMatchesPackage
655 * TestingAndDebugging::RequireTestLabels
656 * ValuesAndExpressions::ProhibitMismatchedOperators
659 * Introduced policy "themes." Themes are arbitrary names that can
660 be used to identify a group of related Policies. You can select
661 your favorite policies by combining themes in a mathematic expression
662 such as "pbp * (danger + risky)". See POD for details.
663 * perlcritic output is colorized if you have Term::ANSIColor. This
664 only works on non-Win32 platforms. Use -nocolor switch to disable.
665 * Say "perlcritic -count" to get just the the total number of
666 violations per file. Use this feature to quickly identify hot-spots.
667 * Use the -only switch to choose only from policies mentioned in your
668 .perlcriticrc file. This is useful if you usually only want to
669 work with a small subset of the policies.
670 * Default values for most of the perlcritic and Perl::Critic options
671 can now be defined in your .perlcriticrc file. See POD for details.
674 * 21236: wrong page number for "printing to filehandles"
675 * 21916: File handle ... wrong page reference in PBP [DUPE]
676 * 21714: false positive for capture var used in ternary condition
677 * 21718: No skip for File::Slurp in includes.t
678 * ProhibitBarewordFilehandles doesn't complain if you open
679 STDIN, STDOUT or STDERR.
680 * Parrot 40564: Subroutines::RequireFinalReturn should allow die,
682 * Each "for" and "foreach" loop now adds one point to the McCabe
686 * The internals of Perl::Critic have been significantly refactored,
687 but should still be compatible with existing third-party Policies.
688 * Added author-only tests to the release, but disabled by default
689 * New Perl::Critic::Utils::shebang_line() method
690 * Support for filename-based policies
691 * Additional prerequisite: Set::Scalar
692 * Now requires PPI version 1.118
694 [0.20] Released on 2006-09-10
696 Perl::Critic now requires PPI version 1.117, which fixes
697 several bugs that were introduced in version 1.116.
700 * 21079: grep clears @SITE_POLICIES
701 * 21352: Test failures with PPI 1.117
702 * 11365: sub DESTROY detected as a builtin homonym
704 [0.19] Released on 2006-08-20
707 * BuiltinFunctions::ProhibitStringySplit
708 * ControlStructures::ProhibitDeepNests
709 * RegularExpressions::ProhibitCaptureWithoutTest
710 * Variables::RequireLexicalLoopIterator
713 * "perlcritic -quiet" suppresses the "source OK" message.
714 * Variables::ProhibitPunctuationVars is now configurable.
717 * 20965: "Hard tabs used at" shouldn't check __DATA__
718 * 21070: ProhibitNoisyQuotes hates overload
719 * Punctuation variables are now exempt from ProhibitLocalVars
722 * Test coverage is now over 95%
724 [0.18_01] Released on 2006-08-06
727 * Variables::RequireNegativeIndices
728 * InputOutput::ProhibitInteractiveTest
729 * ErrorHandling::RequireCarping
732 * RequireTidyCode tests fail if user has custom .perltidyrc file
733 * 20612: RequirePerlTidy was ignoring HEREDOCs
734 * 20659: __END__ statement considered "unreachable"
735 * Fix for PPI::XS (no C<use overload '""'> support)
736 * Support for 'goto' in ProhibitAmpersandSigils and
737 Subroutines::RequireFinalReturn
739 Performance Enhancements:
740 * Introduced Perl::Critic::Document class. This is a facade for
741 PPI::Document which internally caches search results. This
742 reduces the running time by about 35%. The facade should be
743 invisible, unless you are doing something really sneaky.
744 * Extraction of the 'diagnostics' information is postponed
745 until it is really needed. Speedup has not been measured.
746 * Calls to helper-subs have been reordered for maximum efficiency.
749 * Includes updated version of perlcritic mode for emacs. See
750 "extras/perlcritic.el" for details.
752 [0.18] Released on 2006-07-16
755 * 14855: Home discovery is dangerously naive.
756 * 20060: Incorrect page numbers in ProhibitLeadingZeros
757 and RequireNumberSeparator policies.
758 * 20068: .perlrc file - inconsistent documentation
759 * 20254: "use vars qw(@EXPORT_OK)" not recognized
760 * 20463: No-case heredoc terminator incorrectly detected as lower case.
761 * ProhibitOneArgBless doesn't understand "bless {} => $class;"
762 * ProhibitExcessComplexity doesn't count 'while' and 'until' stmnts
763 * ProhibitLeadingZeros was falsely hits '.0456'
766 * If File::HomeDir is available, we use it to locate the
767 .perlcriticrc file. This should help make Perl::Critic
768 more portable to Win32 platforms. If File::HomeDir is
769 not installed, we resort to looking at the usual
770 environment variables.
773 * Added "perlcritic.el", which is a super-cool emacs minor-mode
774 that runs perl-critic on the current buffer and returns the
775 results in a sexy hot-linked "compiler" window. You can run
776 it on demand, or have it run automatically every time you
777 save the buffer. You can find this in the extras/ directory.
778 Thanks to Josh ben Jore for contributing this.
780 * Moved "Perl::Critic::TestUtils" into the installed build. This
781 module is only used for unit-testing Perl::Critic, but we
782 are putting it in the installation so folks who want to
783 extend Perl::Critic can make use of it.
785 [0.17] Released on 2006-06-13
788 * 19836: Perl-Critic0.16 fails tests during install. This was
789 caused by a bug in version 3.01 of Module::Pluggable. See
790 http://rt.cpan.org/Ticket/Display.html?id=19857 for details.
791 * Fixed bug in no-critic pragma parser.
794 * ValuesAndExpressions::ProhibitEscapedCharacters
795 * BuiltinFunctions::RequireSimpleSortBlock
798 * Perl::Critic can export critique() as a static function. This
799 may appeal to folks who dislike the object-oriented interface.
801 [0.16] Released on 2006-05-14
804 * Perl::Critic->critique() now accepts a PPI::Document as the
805 argument. This feature creates an additional dependency on
806 Scalar::Util, but that shouldn't be a problem because it is
807 included with List::Util, which we already use.
810 * Increased PPI dependency from v1.110 to v1.112
812 [0.15_03] Released on 2006-05-07
815 * The "## no critic" feature is now implemented without eval-ing
816 the code. This keeps Perl::Critic pure and safe :)
817 * 19082: Page number for AUTOLOAD is incorrect
820 * ControlStructures::ProhibitUnreachableCode (by Peter Guzis)
821 * Modules::ProhibitAutomaticExportation
822 * ValuesAndExpressions::ProhibitVersionStrings
824 [0.15_02] Released on 2006-04-26
827 * Reimplemented the '##no critic' pragmas to have effect on the
828 line where the violation is reported, not on the line where
829 the candidate element lives. This is because some policies
830 may report violations that are nowhere near the element that
832 * RequireUseStrict, RequireUseWarnings, and RequireExplcitPackage
833 all emit violations for _every_ statement that violates the
834 Policy. This closes a loophole that allowed you to circumvent
835 the Policy by using '## no critic' on just the first statement
836 that violated the policy.
837 * Fixed the workaround for the magic shebang that is inserted
838 by EU::MM and M::B. This had stopped working around version 13.
839 * Fixed -noprofile option on 'perlcritic'. This also had stopped
840 working at some point.
842 [0.15_01] Released on 2006-04-16
845 * Added diagnostic messages if the .perlcriticrc contains entries
846 for Policy modules that don't seem to exist.
847 * Now you can specify which policies to disable with the
848 "## no critic" pseudo-pragmas. This feature is still
849 experimental. See docs for details.
850 * perlcritic's directory searching now skips backup files, such
851 as *.swp, *.bak and *~. It also ignores version control system
852 directories, and the blib directory in module build directories.
855 * 18386: Bad example in POD for Documentation::RequirePodSections
856 * 18670: Test failure if Perl::Tidy is not installed
857 * 18698: Policy idea ProhibitUniversalFunctions (see New Policies)
858 * RequireInterpolationOfMetachars falsely hit strings like 'foo=s@'
859 which are commonly used with Getopt::Long.
862 * BuiltinFunctions::ProhibitUniversalCan (by Chris Dolan)
863 * BuiltinFunctions::ProhibitUniversalIsa (by Chris Dolan)
866 * All spurrious options for `perlcritic` are now fatal.
867 * Changed several of the -verbose formats to be more readable.
868 * Explicit -severity option now overrides -[12345] shortcuts instead
869 of being the other way around.
873 [0.15] Released on 2006-03-26
876 * 17964: Insists my code is not tidy (may not be fixed for all cases)
878 [0.14_02] Released on 2006-03-19
881 * 15653: False positive in OneArgSelect (fixed for real this time)
884 * ClassHierarchies::ProhibitAutoloading
885 * Documentation::RequirePodSections
886 * InputOutput::RequireBracedFileHandleWithPrint
887 * ValuesAndExpressions::ProhibitMixedBooleanOperators
888 * Variables::RequireInitializationForLocalVars
890 [0.14_01] Released on 2006-03-05
893 * 14731: False positive: Builtin function called with parens
894 * 17554: False positive in CodeLayout::RequireTrailingCommas
897 * ClassHierarchies::ProhibitExplicitISA
898 * InputOutput::ProhibitReadlineInForLoop
899 * Miscellanea::ProhibitFormats
900 * Miscellanea::ProhibitTies
901 * Variables::ProhibitConditionalDeclarations
903 [0.14] Released on 2006-01-29
905 More documentation edits.
908 * Documentation::RequirePodAtEnd
909 * Subroutines::ProtectPrivateSubs
910 * Variables::ProhibitMatchVars
911 * Variables::ProtectPrivateVars
914 * 15295: "## no critic" pragmas too aggresive on compound statements.
915 * t/01_config.t failed in the presence of third-party policies
917 [0.13_05] Not released
919 More documentation edits.
921 Implemented workaround for failing pod_coverage tests.
924 * 16906: tr/// created false-postives with RegularExpression polices.
926 [0.13_04] Released on 2005-12-31
928 Moved DEVELOPER.pod file into the Perl/Critic dir.
930 More documentation edits.
932 [0.13_03] Released on 20051230
934 perlcritic now prints 'source OK' if it doesn't find any
935 violations. This gives folks a warm fuzzy feeling.
937 Tweaked some test cases that were failing on my Solaris
940 [0.13_02] Released on 2005-12-29
942 Fixed Config to recognize fully-qualified module names in the
945 Various documentation edits.
947 [0.13_01] Released on 2005-12-28
949 Replaced 'priority' concept with 'severity'. Now each Policy module
950 has a predefined severity level ranging from 1 to 5. By default,
951 perlcritic only reports the most severe violations. You can adjust
952 the severity threshold at the command line, and you can change
953 the severity for any Policy using the config file.
955 Chris implemented the applies_to() mechanism, which allows each Policy
956 class to declare the types of PPI elements that it wants to examine.
957 When traversing the document, Perl::Critic invokes the Policy only
958 for elements that are of the correct type. This improves performance
961 Perl::Critic now uses a Plugin architecture to automatically
962 discover Policy modules. So if you have custom Policies, all you
963 have to do is install them in the Perl::Critic::Policy namespace --
964 no need to add anything to your .perlcriticrc file. If you write
965 policies in a different namespace, you can configure that too. See
966 the Perl::Critic::Config docs for details.
969 * Modules::RequireEndWithOne
970 * NamingConventions::ProhibitAmbiguousNames
971 * References::ProhibitDoubleSigils
972 * Subroutines::RequireFinalReturn
973 * Subroutines::ProhibitAmpersandSigils
974 * Subroutines::ProhibitExcessComplexity
975 * TestingAndDebugging::ProhibitNoStrict
976 * TestingAndDebugging::ProhibitNoWarnings
979 * 15101: Plugin architecture improves support for 3rd-party code
980 * 16319: Fixed incorrect PBP page number in ProhibitBarwordFilehandle
981 * 16321: Lists of empty quotes are now allowed by ProhibitQuotedWordLists
982 * 16288: Empty lists caused a fatal error RequireTrailingCommas
983 * 15653: Fixed false positive in OneArgSelect.
985 [0.13] Released on 2005-10-31
987 Official release of 0.12_03. No code major changes.
989 [0.12_03] Not released
991 Renamed -Policy option to -include. Added -exclude to give the
994 Refactored constructor of Perl::Critic. Now, most of the work
995 is delegated to Perl::Critic::Config. I'm not sure I like how
996 this turned out, but we'll see how it goes.
998 Renamed some Policy modules to be a bit more comprehensible. Note
999 that you may need to change your .perlcriticrc file accordingly.
1000 I also suggest removing your current Perl::Critic installation
1001 before installing this one.
1004 * ProhibitUnpackagedCode => RequireExplicitPackage
1005 * RequireQuotedWords => ProhibitQuotedWordLists
1007 Improved error message when Perl::Critic dies because PPI can't
1008 parsee the input code.
1010 Changed output of -help to be more terse.
1014 [0.12_02] Not released
1016 Added -Policy option to perlcritic. The idea is to provide a
1017 compact interface for selecting Policy modules at the command-line.
1018 This feature is experimental and subject to change.
1020 Added a warning message if -verbose value looks strange. In most
1021 applications, the -verbose option does not require a value, so people
1022 might be puzzled when they write 'perlcritic -verbose my_file.pm' and
1023 nothing seems to happen.
1025 Command-line options to perlcritic are now case-sensitive. This
1026 makes it easier to abbreviate options that start with the same letters
1027 (e.g. 'Version' and 'verbose')
1029 Fixed the new Policy modules that were misnamed and misplaced in the
1030 previous distribution.
1032 [0.12_01] Not released
1034 Rewrote some of the ControlStructures and BuiltinFunction
1035 policies to be simpler (and probably a little faster).
1037 Edited POD. Fixed some typos. Added PREREQUISITES section
1038 to Perl::Critic documentation.
1040 Fixed the -verbose FORMAT option so that you can put metachars
1041 in the FORMAT specification. If using perlcritic, be careful to
1042 protect them from getting munged by the shell first.
1044 Replaced ProhibitRequireStatements with RequireBarewordIncludes
1045 module. Courtesy of Chris Dolan <cdolan@cpan.org>
1047 Added configuration to ProhibitInterpolationOfLiterals so that
1048 certain flavors of quotes can be exempt. This is for folks who
1049 have configured their editor to use special syntax highlighting
1050 for certain kinds of strings (SQL, for example).
1052 perlcritic now accepts multiple file arguments, so now you can
1053 critique your entire distribution in one shot. As a result, the
1054 output-formats have changed slightly.
1057 * BuiltinFunctions::ProhibitLvalueSubstr
1058 * BuiltinFunctions::ProhibitSleepViaSelect
1059 * ClassHierarchies::ProhibitOneArgBless
1060 * CodeLayout::RequireTrailingCommas
1061 * CodeLayout::RequireQuotedWordLists
1062 * InputOutput::ProhibitTwoArgOpen
1063 * InputOutput::ProhibitOneArgSelect
1064 * InputOutput::ProhibitBarewordFileHandles
1065 * Miscellanea::RequireRcsKeywords
1066 * Modules::RequireVersionVar
1067 * RegularExpressions::RequireExtendedFormatting
1068 * RegularExpressions::RequireLineBoundaryMatching
1072 14923: 'require' is now permitted. See RequireBarewordIncludes.
1073 15022: Fixed false-positives when keywords are used as hash keys.
1074 15023: Fixed spurious Violations by removing magic shebang.
1075 15031: Fixed spelling mistakes (and probably added some new ones).
1076 15233: Postfix 'if' is now allowed with 'die', 'croak', etc.
1078 [0.12] Released 2005-10-10
1080 Redesigned the 'verbose' feature. Now the output format
1081 can be user-defined using a sprintf-like specification.
1082 perlciritc also has a predefined output format that is
1083 compatible with grep mode in editors like vim and emacs.
1085 'return' is now exempt from ProhibitParensWithBuiltins. I may
1086 extend this exemption to all unary functions.
1088 Edited POD. Added a super brief description of each policy
1089 in the main Perl::Critic documentation. Added details about
1092 Additional Prerequisites:
1097 The internal dynamics and API of Perl::Critic have changed
1098 considerably. The result is a 300% increase in performance.
1099 See the POD in Perl::Critic::Policy for details.
1102 * Added -verbose option to put more stuff in the output. In the
1103 extreme, you can get the POD from Policy attached to each
1104 and every violation.
1106 Additional Prerequisites:
1110 [0.10] Released 2005-10-05
1112 Fixed stupid bug in newest Policy modules. They were returning
1113 PPI objects instead of Perl::Critic::Violation objects. Doh!
1115 Fixed test scripts to prevent failures if the user already has a
1118 'ProhibitHardTabs' now allows leading tabs by default.
1120 Put the Changes file in reverse-chronological order, so the most
1121 recent stuff is easy to find at the top of the file
1123 [0.09] Released 2005-10-04
1126 * 14810: Now you are allowed to create your own 'import' function,
1127 since this is frequently done with fancy modules.
1128 * 14817: Parens, brackets, and braces are now excluded from
1129 'ProhibitNoisyQuotes' since they look better in quotes anyway.
1130 * 14787: $1..$9 and '_' are exempt from ProhibitPunctuationVars
1131 * 14899: Object methods with the same name as a built-in can
1132 be called with parens (ProhibitParensWithBuiltins).
1133 * 14901: Normalized the exit status of perlcritic to 0, 1, or 2.
1134 See documentation for explanation.
1135 * 14855: Partially fixed home directory discovery. Still not
1136 completely portable, but at least doesn't create warnings.
1139 * 14734: Limit for number separators is now configurable
1142 * CodeLayout::ProhibitHardTabs
1143 * ControlStructures::ProhibitUnlessBlocks
1144 * ControlStructures::ProhibitUntilBlocks
1145 * ControlStructures::ProhibitCStyleForLoops
1147 Changed the syntax for the magic comments. Adam had the
1148 idea of using a pragma-like notation. I liked it.
1150 [0.08_2] Released 2005-09-27
1152 Fixed problems with Perl::Critic::Config that caused File::Spec
1153 to emit 'uninitialized value' warnings during the build.
1155 Added 1 Policy module contributed by Graham TerMarsch
1157 Switched from File::Spec::Functions to plain File::Spec because
1158 I think its usage is more common.
1160 Removed 'FindBin' from the test files so I can be sure that the
1161 right libraries are getting loaded. This means I'll have to
1162 use the -l option with C<prove>.
1166 [0.08_01] Not released
1168 Fixed "ProhibitParensWithBuiltins" to allow parens to be used with
1169 object method calls that have the same name as a builtin functions.
1171 Introduced magical comments that allow developers to configure
1172 Perl::Critic on-the-fly from within their code.
1174 Added META.yml files and POD tests to the build. I did this
1175 mostly just to boost the Kwalitee score on CPANTS.
1177 Switched from "Config::Std" to "Config::Tiny" because it doesn't
1178 require those fancy Damian modules that don't seem to work on
1179 some older versions of Perl.
1181 [0.07] Released on 2005-09-21
1183 Fixed bugs in the ProhibitCascadingIfElse policy.
1185 Added ProhibitExplicitReturnUndef policy
1187 Made ProhibitUnpackagedCode configurable so you can exempt scripts,
1188 which typically don't have an explicit 'package' statement.
1190 ProhibitPackageVars policy now exempts vars in ALL_CAPS. This
1191 is to permit common package variables like @EXPORT and $VERSION.
1193 Renamed "ProhibitStringyGrep and "ProhibitStringyMap" because
1194 the so-called string form doesn't really exist. Now called
1195 "RequireBlockGrep" and "RequireBlockMap"
1197 Corrected documentation on defining Policy names within the
1198 configuration file. This still isn't very clear and needs
1201 Perl::Critic now requires PPI version 1.003, which has a few bug
1204 Rewrite some code just to make Perl::Critic more self-compliant.
1206 Added test cases to verify the configuration functionality. These
1207 are not completely thorough and need more work.
1209 [0.06] Released on 2005-09-17
1211 Now called 'Perl::Critic'.
1213 Added 4 new policy modules.
1215 Fixed bugs in build process.
1217 Added support for Module::Build.
1219 [0.05] Released on 2005-09-17
1221 End of 'Perl::Review' releases. I have changed the name to
1222 'Perl::Critic' to avoid possible confusion with "The Perl Review"
1225 [0.04] Released on 2005-09-14
1227 Version 0.03 was a bust because I uploaded the wrong tarball to PAUSE.
1229 [0.03] Released on 2005-09-13.
1231 Fixed some POD links.
1233 Removed test cases for missing policy module.
1235 [0.02] Released on 2005-09-13.
1237 Major overhaul based on feedback from Perl community.
1239 Factored coding standards into separate modules (known as
1240 Policies). The idea here is to allow other developers to easily
1241 contribute additional coding standards.
1243 Reworked Perl::Review into a simple engine for loading and running
1246 Gave perlreview a command-line interface and configuration file
1247 for selecting which Policy modules to use.
1249 [0.01] Released on 2005-08-16.
1253 ##############################################################################
1254 # $URL: http://perlcritic.tigris.org/svn/perlcritic/trunk/Perl-Critic/Changes $
1255 # $Date: 2008-07-03 10:19:10 -0500 (Thu, 03 Jul 2008) $
1256 # $Author: clonezone $
1258 ##############################################################################
1260 # ex: set ts=8 sts=4 sw=4 tw=78 ft= expandtab shiftround :