NAME
   File::List - Perl extension for crawling directory trees and
   compiling lists of files

SYNOPSIS
     use File::List;

     my $search = new File::List("/usr/local");
     $search->show_empty_dirs();                   # toggle include empty directories in output
     my @files  = @{ $search->find("\.pl\$") };    # find all perl scripts in /usr/local

DESCRIPTION
   This module crawls the directory tree starting at the provided
   base directory and can return files (and directories if desired)
   matching a regular expression

INTERFACE
   The following methods are available in this module.

 new($base);

   This creates a new File::List object and starts crawling the
   tree from this base

   It takes a scalar base directory as an argument and returns an
   object reference

 find($regexp);

   This method accepts a scalar regular expression to search for.

   It returns a reference to an array containing the full path to
   files matching the expression (under this base).

 debug($level);

   This sets the debug level for find

 show_empty_dirs();

   Toggle display of empty directories

 show_only_dirs();

   Allows user to only display directories, no files

AUTHOR
   Dennis Opacki, [email protected]

SEE ALSO
   perl(1).