"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "bin/perltidy" between
Perl-Tidy-20191203.tar.gz and Perl-Tidy-20200110.tar.gz

About: Perltidy is a Perl script indenter and reformatter (beautifier).

perltidy  (Perl-Tidy-20191203):perltidy  (Perl-Tidy-20200110)
skipping to change at line 3090 skipping to change at line 3090
n=0 remove terminal semicolons in one-line blocks having a single statement n=0 remove terminal semicolons in one-line blocks having a single statement
n=1 stable; keep input file placement of terminal semicolons [DEFAULT ] n=1 stable; keep input file placement of terminal semicolons [DEFAULT ]
n=2 add terminal semicolons in all one-line blocks n=2 add terminal semicolons in all one-line blocks
Note that the B<n=2> option has no effect if adding semicolons is prohibited Note that the B<n=2> option has no effect if adding semicolons is prohibited
with the B<-nasc> flag. Also not that while B<n=2> adds missing semicolons to with the B<-nasc> flag. Also not that while B<n=2> adds missing semicolons to
all one-line blocks, regardless of complexity, the B<n=0> option only removes all one-line blocks, regardless of complexity, the B<n=0> option only removes
ending semicolons which terminate one-line blocks containing just one ending semicolons which terminate one-line blocks containing just one
semicolon. So these two options are not exact inverses. semicolon. So these two options are not exact inverses.
=item B<-olbn=n>, B<--one-line-block-nesting=n>
Nested one-line blocks are lines with code blocks which themselves contain code
blocks. For example, the following line is a nested one-line block.
foreach (@list) { if ($_ eq $asked_for) { last } ++$found }
The default behavior is to break such lines into multiple lines, but this
behavior can be controlled with this flag. The values of n are:
n=0 break nested one-line blocks into multiple lines [DEFAULT]
n=1 stable: keep existing nested-one line blocks intact
For the above example, the default formatting (B<-olbn=0>) is
foreach (@list) {
if ( $_ eq $asked_for ) { last }
++$found;
}
If the parameter B<-olbn=1> is given, then the line will be left intact if it
is a single line in the source, or it will be broken into multiple lines if it
is broken in multiple lines in the source.
=back =back
=head2 Controlling Vertical Alignment =head2 Controlling Vertical Alignment
Vertical alignment refers to lining up certain symbols in list of consecutive Vertical alignment refers to lining up certain symbols in list of consecutive
similar lines to improve readability. For example, the "fat commas" are similar lines to improve readability. For example, the "fat commas" are
aligned in the following statement: aligned in the following statement:
$data = $pkg->new( $data = $pkg->new(
PeerAddr => join( ".", @port[ 0 .. 3 ] ), PeerAddr => join( ".", @port[ 0 .. 3 ] ),
skipping to change at line 3789 skipping to change at line 3813
there there are (1) warning messages in the standard error output related to there there are (1) warning messages in the standard error output related to
parameter errors or problems and/or (2) warning messages in the perltidy error parameter errors or problems and/or (2) warning messages in the perltidy error
file(s) relating to possible syntax errors in one or more of the source file(s) relating to possible syntax errors in one or more of the source
script(s) being tidied. When multiple files are being processed, an error script(s) being tidied. When multiple files are being processed, an error
detected in any single file will produce this type of exit condition. detected in any single file will produce this type of exit condition.
=head1 SEE ALSO =head1 SEE ALSO
perlstyle(1), Perl::Tidy(3) perlstyle(1), Perl::Tidy(3)
=head1 INSTALLATION
The perltidy binary uses the Perl::Tidy module and is installed when that module
is installed. The module name is case-sensitive. For example, the basic comma
nd for installing with cpanm is 'cpanm Perl::Tidy'.
=head1 VERSION =head1 VERSION
This man page documents perltidy version 20191203 This man page documents perltidy version 20200110
=head1 BUG REPORTS =head1 BUG REPORTS
A list of current bugs and issues can be found at the CPAN site L<https://rt.cpa n.org/Public/Dist/Display.html?Name=Perl-Tidy> A list of current bugs and issues can be found at the CPAN site L<https://rt.cpa n.org/Public/Dist/Display.html?Name=Perl-Tidy>
To report a new bug or problem, use the link on this page. To report a new bug or problem, use the link on this page.
The source code repository is at L<https://github.com/perltidy/perltidy>. The source code repository is at L<https://github.com/perltidy/perltidy>.
=head1 COPYRIGHT =head1 COPYRIGHT
Copyright (c) 2000-2018 by Steve Hancock Copyright (c) 2000-2020 by Steve Hancock
=head1 LICENSE =head1 LICENSE
This package is free software; you can redistribute it and/or modify it This package is free software; you can redistribute it and/or modify it
under the terms of the "GNU General Public License". under the terms of the "GNU General Public License".
Please refer to the file "COPYING" for details. Please refer to the file "COPYING" for details.
=head1 DISCLAIMER =head1 DISCLAIMER
 End of changes. 4 change blocks. 
2 lines changed or deleted 32 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)