File::Util version 3.14_8
=========================

DESCRIPTION
File::Util provides a comprehensive toolbox of utilities to automate all
kinds of common tasks on file / directories.  Its purpose is to do so
in the most portable manner possible so that users of this module won't
have to worry about whether their programs will work on other OSes
and machines.


CHANGES IN LAST FEW RELEASES
(listed in reverse chronological order by date and subversion)

   3.14_8
      Thu Dec 14 20:13:03 CST 2006
      Fixed some error messages to be more clear.  Tweaked the 
		File::Util::readlimit() method to provide better error messages if 
		called incorrectly.  Modified File::Util::make_dir() to include 
		the --if-not-exists option.

		Fixed a broken test case in "make test" that was causing it to fail
		falsely.

      More documentation added for various methods whose documentation had
      yet to be written.

		Releasing this version as an official release and NOT a developer's
		release only.

   3.14_7
      Sat Jan 31 13:36:24 CST 2004
      Changes to method File::Util::flock_rules() to output helpful error
      message if specification of invalid file locking policy attempted.

      More documentation added for various methods whose documentation had
      yet to be written.

   3.14_6
      Mon Sep 22 11:10:46 CDT 2003
      Changes to methods File::Util::list_dir() and
      File::Util::escape_filename() increase efficiency and fix some bugs.
      Both methods retain the same interface and return values in the same
      manner.

      Added new method File::Util::return_path() (see documentation).

      Method File::Util::last_mod changed to File::Util::last_modified for
      clarity, better readability, and consistency with other similar methods
      in the File::Util namespace. (eg- File::Util::last_access, etc)

      Added the following methods to @EXPORT_OK
         File::Util::return_path()
         File::Util::created()
         File::Util::last_access()
         File::Util::last_modified()

      Much more documentation added.  Test suite revisited to reflect changes
      to the methods mentioned above.

   3.14_2
      1/14/03, 12:05 am
      Much more documentation added.  Various methods slightly altered to stay
      in keeping with the docs and with standard conventions.  Test suite
      revisited somewhat.


INSTALLATION
To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

On windows machines use nmake rather than make; those running cygwin don't have
to worry about this.  If you don't know what cygwin is, use nmake and check out
<URL: http://cygwin.com/> after you're done installing this module if you want
to find out.


DEPENDENCIES
This module requires these other modules and libraries:

   Class::OOorNO        v0.01_0 or better
   Exception::Handler   v1.00_0 or better


AUTHOR
   Tommy Butler <cpan@atrixnet.com>


COPYRIGHT
   Copyright (C) Tommy Butler 2001-2002, all rights reserved.


LICENCE

   This library is free software, you may redistribute it and/or modify it
   under the same terms as Perl itself.

