X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=d7ba2fe53ff00482320e82efb1bb05202e5d99a1;hb=f825104623bfefa14894e11935cdf3f19aa6bd2f;hp=51a5614ee393b528ef839e53919529e42ec96876;hpb=5bcec1c99b6f7b377d6baadeeff39c8eb5a06b9a;p=catagits%2FTest-EOL.git diff --git a/README b/README index 51a5614..d7ba2fe 100644 --- a/README +++ b/README @@ -8,6 +8,11 @@ SYNOPSIS use Test::EOL tests => 1; eol_unix_ok( 'lib/Module.pm', 'Module is ^M free'); + and to add checks for trailing whitespace: + + use Test::EOL tests => 1; + eol_unix_ok( 'lib/Module.pm', 'Module is ^M and trailing whitespace free', { trailing_whitespace => 1 }); + Module authors can include the following in a t/eol.t and have "Test::EOL" automatically find and check all perl files in a module distribution: @@ -20,6 +25,16 @@ SYNOPSIS use Test::EOL; all_perl_files_ok( @mydirs ); + and if authors would like to check for trailing whitespace: + + use Test::EOL; + all_perl_files_ok({ trailing_whitespace => 1 }); + + or + + use Test::EOL; + all_perl_files_ok({ trailing_whitespace => 1 }, @mydirs ); + DESCRIPTION This module scans your project/distribution for any perl files (scripts, modules, etc) for the presence of windows line endings. @@ -29,7 +44,7 @@ EXPORT you don't export anything, such as for a purely object-oriented module. FUNCTIONS - all_perl_files_ok( [ @directories ] ) + all_perl_files_ok( [ \%options ], [ @directories ] ) Applies "eol_unix_ok()" to all perl files found in @directories (and sub directories). If no <@directories> is given, the starting point is one level above the current running script, that should cover all the files @@ -43,7 +58,7 @@ FUNCTIONS the total number of files tested must be specified. - eol_unix_ok( $file [, $text] ) + eol_unix_ok( $file [, $text] [, \%options ] ) Run a unix EOL check on $file. For a module, the path (lib/My/Module.pm) or the name (My::Module) can be both used.