X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lib%2FPerl%2FTidy.pod;h=dbbf01b8bc911bd6c0997d682b003e2ac2acbf28;hb=7f27e55dce5925b2bbe8fcfca64f385e917a52be;hp=23c8b02bd102590096795812211ed8bb13e23f5b;hpb=657098da8da16dccd551721ffc180956d8aab7fc;p=perltidy.git diff --git a/lib/Perl/Tidy.pod b/lib/Perl/Tidy.pod index 23c8b02..dbbf01b 100644 --- a/lib/Perl/Tidy.pod +++ b/lib/Perl/Tidy.pod @@ -188,17 +188,21 @@ B in the perltidy distribution. =head1 ERROR HANDLING -Perltidy will return with an error flag indicating if the process had to be -terminated early due to errors in the input parameters. This can happen for -example if a parameter is misspelled or given an invalid value. The calling -program should check this flag because if it is set the destination stream will -be empty or incomplete and should be ignored. Error messages in the B -stream will indicate the cause of any problem. - -If the error flag is not set then perltidy ran to completion. However there -may still be warning messages in the B stream related to control -parameters, and there may be warning messages in the B stream -relating to possible syntax errors in the source code being tidied. +An exit value of 0, 1, or 2 is returned by perltidy to indicate the status of the result. + +A exit value of 0 indicates that perltidy ran to completion with no error messages. + +An exit value of 1 indicates that the process had to be terminated early due to +errors in the input parameters. This can happen for example if a parameter is +misspelled or given an invalid value. The calling program should check for +this flag because if it is set the destination stream will be empty or +incomplete and should be ignored. Error messages in the B stream will +indicate the cause of any problem. + +An exit value of 2 indicates that perltidy ran to completion but there there +are warning messages in the B stream related to parameter errors or +conflicts and/or warning messages in the B stream relating to +possible syntax errors in the source code being tidied. In the event of a catastrophic error for which recovery is not possible B terminates by making calls to B or B to help the @@ -408,9 +412,13 @@ C in Tidy.pm. &perltidy +=head1 INSTALLATION + +The module 'Perl::Tidy' comes with a binary 'perltidy' which is installed when the module is installed. The module name is case-sensitive. For example, the basic command for installing with cpanm is 'cpanm Perl::Tidy'. + =head1 VERSION -This man page documents Perl::Tidy version 20190601 +This man page documents Perl::Tidy version 20200110 =head1 LICENSE