File::Util version 3.14_6
=========================

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_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.

   3.14_1
      1/2/03, 3:47 am
      Added a substantial amount of new documentation.  Spelling errors in
      documentation files corrected.

      Previously available method, File::Util::os(), has been dropped from the
      namespace and is no longer part of the module.

      Method File::Util::file_type() no longer includes the 'tty' keyword among
      its list of recognized file types, as the native Perl file test for
      divining a TTY file can only be used on open file handles.

      The keywords returned by this method are all upper case strings as of
      version 3.13_9, though the release notes for that version errantly did
      not include this statement.  The list of keywords otherwise remains
      unchanged:
         PLAIN       TEXT
         BINARY      DIRECTORY
         SYMLINK     PIPE
         SOCKET      BLOCK
         CHARACTER


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.

