README for File::Find::Rule 0.26 =head1 NAME File::Find::Rule - Alternative interface to File::Find =head1 SYNOPSIS use File::Find::Rule; # find all the subdirectories of a given directory my @subdirs = File::Find::Rule->directory->in( $directory ); # find all the .pm files in @INC my @files = File::Find::Rule->file() ->name( '*.pm' ) ->in( @INC ); # as above, but without method chaining my $rule = File::Find::Rule->new; $rule->file; $rule->name( '*.pm' ); my @files = $rule->in( @INC ); =head1 DEPENDENCIES This module has external dependencies on the following modules: Cwd File::Find File::Spec Module::Build 0.18 Number::Compare Test::More Text::Glob =head1 INSTALLATION perl Build.PL perl Build test and if all goes well perl Build install =head1 HISTORY What changed over the last 3 revisions =over =item 0.26 Monday 10th November, 2003 Typo/thinko in File::Find::Rule::Extending corrected (spotted by Jim Cromie) Optimization to the stat-based tests. They now compile to code fragments saving much subroutine dispatch. =item 0.25 Wednesday 22nd October, 2003 applied a patch from Leon Brocard to make the tests ignore CVS dirs as well as .svn dirs. reworked part of t/File-Find-Rule.t to not assume that t/foobar will always be 10 bytes in size. (rt.cpan.org #3838) now we install the findrule script =item 0.24 Monday 6th October, 2003 when you specify an extra of C<{ follow => 1 }> File::Find stops populating $File::Find::topdir. This leads to warnings noise so instead we now track $topdir ourselves. =back =head1 AUTHOR Richard Clamp with input gained from this use.perl discussion: http://use.perl.org/~richardc/journal/6467 Additional proofreading and input provided by Kake, Greg McCarroll, and Andy Lester andy@petdance.com. =head1 COPYRIGHT Copyright (C) 2002,2003 Richard Clamp. All Rights Reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =head1 SEE ALSO L, L, L, find(1) If you want to know about the procedural interface, see L, and if you have an idea for a neat extension L