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

AUTHOR
    Dennis Opacki, dopacki@internap.com

SEE ALSO
    perl(1).

