From: Steve Hancock Date: Sat, 13 Apr 2024 14:31:29 +0000 (-0700) Subject: bump version to 20240202.05 X-Git-Tag: 20240202.05^0 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=06919ba5d1ed279c4a31f25886e7583a417b42cc;p=perltidy.git bump version to 20240202.05 --- diff --git a/CHANGES.md b/CHANGES.md index f990a656..225c96f2 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,6 +1,6 @@ # Perltidy Change Log -## 2024 02 02.04 +## 2024 02 02.05 - Add options --dump-mismatched-args (or -dma) and --warn-mismatched-arg (or -wma). These options look @@ -16,10 +16,13 @@ perltidy -wma somefile.pl - It may be customized with three additional parameters if necessary to - avoid needless warnings, --warn-mismatched-arg-types=s, - --warn-mismatched-arg-exclusion-list=s and - --warn-mismatched-arg-undercount-cutoff=n. + The -warn version may be customized with three additional parameters if + necessary to avoid needless warnings: + + --warn-mismatched-arg-types=s (or -wmat=s), + --warn-mismatched-arg-exclusion-list=s (or -wmaxl=s), and + --warn-mismatched-arg-undercount-cutoff=n (or -wmauc=n). + These are explained in the manual. - Add option --valign-wide-equals, or -vwe, for issue git #135. @@ -92,13 +95,11 @@ It makes the following checks and changes: - Repeated commas like ',,' are removed with a warning - - Repeated fat commas like '=> =>' are removed with a - warning + - Repeated fat commas like '=> =>' are removed with a warning - The combination '=>,' produces a warning but is not changed These warnings are only output if --warning-output, or -w, is set. - This is now the DEFAULT Behavior. - Use --nodelete-repeated-commas, or -ndrc, to turn this option off. + Use --nodelete-repeated-commas, or -ndrc, to retain repeated commas. - Added control --delete-interbracket-arrows, or -dia, to delete optional hash ref and array ref arrows between brackets as in the following @@ -115,7 +116,8 @@ # perltidy -aia return $self->{'commandline'}->{'arg_list'}->[0]->[0]->{'hostgroups'}; - The manual describes additional controls for selective adding and deleting. + The manual describes additional controls for adding and deleting + just selected interbracket arrows. ## 2024 02 02 diff --git a/bin/perltidy b/bin/perltidy index 44f29bf9..445eb321 100755 --- a/bin/perltidy +++ b/bin/perltidy @@ -3697,7 +3697,7 @@ Here is an example. =item B<-drc>, B<--delete-repeated-commas> -Repeated commas in a list are undesirable and can be removed with this flag. +This option causes repeated commas to be removed. For example, given this list with a repeated comma ignoreSpec( $file, "file",, \%spec, \%Rspec ); @@ -3736,7 +3736,7 @@ set. =back -This feature is on by default. Use B<-ndrc> to turn it off. +This option is on by default. Use B<-ndrc> to turn it off. =item B<--want-trailing-commas=s> or B<-wtc=s>, B<--add-trailing-commas> or B<-atc>, and B<--delete-trailing-commas> or B<-dtc> @@ -6604,7 +6604,7 @@ The perltidy binary uses the Perl::Tidy module and is installed when that module =head1 VERSION -This man page documents perltidy version 20240202.04 +This man page documents perltidy version 20240202.05 =head1 BUG REPORTS diff --git a/docs/ChangeLog.html b/docs/ChangeLog.html index 1ff1d15f..650603f8 100644 --- a/docs/ChangeLog.html +++ b/docs/ChangeLog.html @@ -1,9 +1,9 @@

Perltidy Change Log

-

2024 02 02.04

+

2024 02 02.05

- Add options --dump-mismatched-args (or -dma) and
-  --warn-mismatched-arg-types=s (or -wmat=s).  These options look
+  --warn-mismatched-arg (or -wma).  These options look
   for and report instances where the number of args expected by a
   sub appear to differ from the number passed to the sub.  The -dump
   version writes the results for a single file to standard output
@@ -14,12 +14,16 @@
   The -warn version formats as normal but reports any issues as warnings in
   the error file:
 
-     perltidy -wmat=1 somefile.pl
+     perltidy -wma somefile.pl
 
-  It takes a string parameter which is 1 or '*' to activate all checks.
-  It may be customized with two additional parameters if necessary to
-  avoid needless warnings, --warn-mismatched-arg-exclusion-list=s and
-  --warn-mismatched-arg-undercount-cutoff=n. These are explained in the manual.
+  The -warn version may be customized with three additional parameters if
+  necessary to avoid needless warnings:
+
+  --warn-mismatched-arg-types=s (or -wmat=s),
+  --warn-mismatched-arg-exclusion-list=s (or -wmaxl=s), and
+  --warn-mismatched-arg-undercount-cutoff=n (or -wmauc=n).
+
+  These are explained in the manual.
 
 - Add option --valign-wide-equals, or -vwe, for issue git #135.
   Setting this parameter causes the following assignment operators
@@ -91,13 +95,11 @@ my $html = $this->SUPER::genObject( $query, $bindNode, $field . ":$var",
 
   It makes the following checks and changes:
   - Repeated commas like ',,' are removed with a warning
-  - Repeated fat commas like '=> =>' are removed with a
-    warning
+  - Repeated fat commas like '=> =>' are removed with a warning
   - The combination '=>,' produces a warning but is not changed
   These warnings are only output if --warning-output, or -w, is set.
 
-  This is now the DEFAULT Behavior.
-  Use --nodelete-repeated-commas, or -ndrc, to turn this option off.
+  Use --nodelete-repeated-commas, or -ndrc, to retain repeated commas.
 
 - Added control --delete-interbracket-arrows, or -dia, to delete optional
   hash ref and array ref arrows between brackets as in the following
@@ -114,7 +116,8 @@ my $html = $this->SUPER::genObject( $query, $bindNode, $field . ":$var",
     # perltidy -aia
     return $self->{'commandline'}->{'arg_list'}->[0]->[0]->{'hostgroups'};
 
- The manual describes additional controls for selective adding and deleting.
+ The manual describes additional controls for adding and deleting
+ just selected interbracket arrows.

2024 02 02

diff --git a/docs/Tidy.html b/docs/Tidy.html index 7bc312c8..cbc9a9a5 100644 --- a/docs/Tidy.html +++ b/docs/Tidy.html @@ -399,7 +399,7 @@

VERSION

-

This man page documents Perl::Tidy version 20240202.04

+

This man page documents Perl::Tidy version 20240202.05

LICENSE

diff --git a/docs/perltidy.html b/docs/perltidy.html index b2378de5..1133e0f3 100644 --- a/docs/perltidy.html +++ b/docs/perltidy.html @@ -2942,7 +2942,7 @@
-drc, --delete-repeated-commas
-

Repeated commas in a list are undesirable and can be removed with this flag. For example, given this list with a repeated comma

+

This option causes repeated commas to be removed. For example, given this list with a repeated comma

      ignoreSpec( $file, "file",, \%spec, \%Rspec );
@@ -2972,7 +2972,7 @@ -

This feature is on by default. Use -ndrc to turn it off.

+

This option is on by default. Use -ndrc to turn it off.

--want-trailing-commas=s or -wtc=s, --add-trailing-commas or -atc, and --delete-trailing-commas or -dtc
@@ -4791,30 +4791,36 @@ -
Use --warn-mismatched-arg-types=s to produce a warning for function calls with args not matching sub declarations
+
Use --warn-mismatched-args to produce a warning for function calls with args not matching sub declarations.
-

The parameter --warn-mismatched-arg-types=s, or -wmat=s, can be used to produce a warning message when perltidy formats a file and certain of the above mismatchs is detected during formatting. Both checks may be requested with -wmat='*' or -wmat=1.

+

This is similar to the -dump parameter described above except that any mismatches are reported in the error file and otherwise formatting continues normally. Thus

-

The default is not to do any of these checks, which can also be indicated with -wmat=0.

+
    perltidy -wma somefile.pl
+ +

means format somefile.pl and report any mismatched arg errors found. Several companion controls are available to avoid unwanted error messages:

+ +
@@ -5056,21 +5067,21 @@ aws b baa baao bar bbao bbb bbc bbs bl bli boa boc bok bol bom bos bot cblx ce conv cpb cs csc cscb cscw dac dbc dbs dcbl - dcsc ddf dia dior dln dmcp dnl dop dp dpro - drc dsc dsm dsn dtc dtt duv dwic dwls dwrs - dws eos f fpva frm fs fso gcs hbc hbcm - hbco hbh hbhh hbi hbj hbk hbm hbn hbp hbpd - hbpu hbq hbs hbsc hbv hbw hent hic hicm hico - hih hihh hii hij hik him hin hip hipd hipu - hiq his hisc hiv hiw hsc html ibc icb icp - iob ipc isbc iscl kgb kgbd kgbi kis lal log - lop lp lsl mem nib ohbr okw ola olc oll - olq opr opt osbc osbr otr ple pod pvl q - sac sbc sbl scbb schb scp scsb sct se sfp - sfs skp sob sobb sohb sop sosb sot ssc st - sts t tac tbc toc tp tqw trp ts tsc - tso vbc vc viu vmll vsc vsn w wfc wia - wme wn x xbt xci xlp xs + dcsc ddf dia dior dln dma dmcp dnl dop dp + dpro drc dsc dsm dsn dtc dtt duv dwic dwls + dwrs dws eos f fpva frm fs fso gcs hbc + hbcm hbco hbh hbhh hbi hbj hbk hbm hbn hbp + hbpd hbpu hbq hbs hbsc hbv hbw hent hic hicm + hico hih hihh hii hij hik him hin hip hipd + hipu hiq his hisc hiv hiw hsc html ibc icb + icp iob ipc isbc iscl kgb kgbd kgbi kis lal + log lop lp lsl mem nib ohbr okw ola olc + oll olq opr opt osbc osbr otr ple pod pvl + q sac sbc sbl scbb schb scp scsb sct se + sfp sfs skp sob sobb sohb sop sosb sot ssc + st sts t tac tbc toc tp tqw trp ts + tsc tso vbc vc viu vmll vsc vsn vwe w + wfc wia wma wme wn x xbt xci xlp xs

Equivalently, the prefix 'no' or 'no-' on the corresponding long names may be used.

@@ -5148,7 +5159,7 @@

VERSION

-

This man page documents perltidy version 20240202.04

+

This man page documents perltidy version 20240202.05

BUG REPORTS

diff --git a/lib/Perl/Tidy.pm b/lib/Perl/Tidy.pm index 45c036d8..85b2c88e 100644 --- a/lib/Perl/Tidy.pm +++ b/lib/Perl/Tidy.pm @@ -131,7 +131,7 @@ BEGIN { # then the Release version must be bumped, and it is probably past time for # a release anyway. - $VERSION = '20240202.04'; + $VERSION = '20240202.05'; } ## end BEGIN sub DESTROY { diff --git a/lib/Perl/Tidy.pod b/lib/Perl/Tidy.pod index c68734e6..fdf186dc 100644 --- a/lib/Perl/Tidy.pod +++ b/lib/Perl/Tidy.pod @@ -469,7 +469,7 @@ The module 'Perl::Tidy' comes with a binary 'perltidy' which is installed when t =head1 VERSION -This man page documents Perl::Tidy version 20240202.04 +This man page documents Perl::Tidy version 20240202.05 =head1 LICENSE diff --git a/lib/Perl/Tidy/Debugger.pm b/lib/Perl/Tidy/Debugger.pm index 1cdad317..2ff051b3 100644 --- a/lib/Perl/Tidy/Debugger.pm +++ b/lib/Perl/Tidy/Debugger.pm @@ -8,7 +8,7 @@ package Perl::Tidy::Debugger; use strict; use warnings; use English qw( -no_match_vars ); -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use constant EMPTY_STRING => q{}; use constant SPACE => q{ }; diff --git a/lib/Perl/Tidy/Diagnostics.pm b/lib/Perl/Tidy/Diagnostics.pm index 902d382f..7da17374 100644 --- a/lib/Perl/Tidy/Diagnostics.pm +++ b/lib/Perl/Tidy/Diagnostics.pm @@ -18,7 +18,7 @@ package Perl::Tidy::Diagnostics; use strict; use warnings; use English qw( -no_match_vars ); -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use constant EMPTY_STRING => q{}; diff --git a/lib/Perl/Tidy/FileWriter.pm b/lib/Perl/Tidy/FileWriter.pm index febd6240..bb67d131 100644 --- a/lib/Perl/Tidy/FileWriter.pm +++ b/lib/Perl/Tidy/FileWriter.pm @@ -16,7 +16,7 @@ package Perl::Tidy::FileWriter; use strict; use warnings; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use constant DEVEL_MODE => 0; use constant EMPTY_STRING => q{}; diff --git a/lib/Perl/Tidy/Formatter.pm b/lib/Perl/Tidy/Formatter.pm index d81b12ba..f6283f56 100644 --- a/lib/Perl/Tidy/Formatter.pm +++ b/lib/Perl/Tidy/Formatter.pm @@ -75,7 +75,7 @@ use constant SPACE => q{ }; use Carp; use English qw( -no_match_vars ); use List::Util qw( min max first ); # min, max first are in Perl 5.8 -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; # The Tokenizer will be loaded with the Formatter ##use Perl::Tidy::Tokenizer; # for is_keyword() diff --git a/lib/Perl/Tidy/HtmlWriter.pm b/lib/Perl/Tidy/HtmlWriter.pm index 695b340c..57d9a9a8 100644 --- a/lib/Perl/Tidy/HtmlWriter.pm +++ b/lib/Perl/Tidy/HtmlWriter.pm @@ -7,7 +7,7 @@ package Perl::Tidy::HtmlWriter; use strict; use warnings; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use Carp; use English qw( -no_match_vars ); diff --git a/lib/Perl/Tidy/IOScalar.pm b/lib/Perl/Tidy/IOScalar.pm index 62b67cf3..d6842e0d 100644 --- a/lib/Perl/Tidy/IOScalar.pm +++ b/lib/Perl/Tidy/IOScalar.pm @@ -10,7 +10,7 @@ package Perl::Tidy::IOScalar; use strict; use warnings; use Carp; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use constant DEVEL_MODE => 0; use constant EMPTY_STRING => q{}; diff --git a/lib/Perl/Tidy/IOScalarArray.pm b/lib/Perl/Tidy/IOScalarArray.pm index 9eb6b78f..2ac09d6a 100644 --- a/lib/Perl/Tidy/IOScalarArray.pm +++ b/lib/Perl/Tidy/IOScalarArray.pm @@ -14,7 +14,7 @@ package Perl::Tidy::IOScalarArray; use strict; use warnings; use Carp; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use constant DEVEL_MODE => 0; diff --git a/lib/Perl/Tidy/IndentationItem.pm b/lib/Perl/Tidy/IndentationItem.pm index f4e505ac..ab1d6a39 100644 --- a/lib/Perl/Tidy/IndentationItem.pm +++ b/lib/Perl/Tidy/IndentationItem.pm @@ -9,7 +9,7 @@ package Perl::Tidy::IndentationItem; use strict; use warnings; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; BEGIN { diff --git a/lib/Perl/Tidy/Logger.pm b/lib/Perl/Tidy/Logger.pm index c9deb5b3..b4dcbddc 100644 --- a/lib/Perl/Tidy/Logger.pm +++ b/lib/Perl/Tidy/Logger.pm @@ -8,7 +8,7 @@ package Perl::Tidy::Logger; use strict; use warnings; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use Carp; use English qw( -no_match_vars ); diff --git a/lib/Perl/Tidy/Tokenizer.pm b/lib/Perl/Tidy/Tokenizer.pm index 1511bf1f..e9303f0d 100644 --- a/lib/Perl/Tidy/Tokenizer.pm +++ b/lib/Perl/Tidy/Tokenizer.pm @@ -33,7 +33,7 @@ use strict; use warnings; use English qw( -no_match_vars ); -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use Carp; diff --git a/lib/Perl/Tidy/VerticalAligner.pm b/lib/Perl/Tidy/VerticalAligner.pm index 333f03e7..6a82ba8f 100644 --- a/lib/Perl/Tidy/VerticalAligner.pm +++ b/lib/Perl/Tidy/VerticalAligner.pm @@ -5,7 +5,7 @@ use Carp; { #<<< A non-indenting brace to contain all lexical variables -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use English qw( -no_match_vars ); use Scalar::Util 'refaddr'; use Perl::Tidy::VerticalAligner::Alignment; diff --git a/lib/Perl/Tidy/VerticalAligner/Alignment.pm b/lib/Perl/Tidy/VerticalAligner/Alignment.pm index 1d5069b9..ef9cc9b3 100644 --- a/lib/Perl/Tidy/VerticalAligner/Alignment.pm +++ b/lib/Perl/Tidy/VerticalAligner/Alignment.pm @@ -9,7 +9,7 @@ package Perl::Tidy::VerticalAligner::Alignment; use strict; use warnings; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; sub new { my ( $class, $rarg ) = @_; diff --git a/lib/Perl/Tidy/VerticalAligner/Line.pm b/lib/Perl/Tidy/VerticalAligner/Line.pm index 0bd8c66c..58b949d2 100644 --- a/lib/Perl/Tidy/VerticalAligner/Line.pm +++ b/lib/Perl/Tidy/VerticalAligner/Line.pm @@ -10,7 +10,7 @@ package Perl::Tidy::VerticalAligner::Line; use strict; use warnings; -our $VERSION = '20240202.04'; +our $VERSION = '20240202.05'; use English qw( -no_match_vars ); sub AUTOLOAD {