File-Rename version 1.20
========================

File::Rename provides an implementation of Larry Wall's eg/rename
command.  All I have done is add some error checking and (more recently)
add the File/Rename.pm module.

An earlier version of the script is out in the Internet and is included
with some linuxes, and the original eg/rename is not included in the
Perl distribution, so I have put this up on CPAN.

A revised version of the earlier script is now on the Internet,
which includes more options.  This script, distinguished by
"Getopt::Long::Configure('bundling')", was not written by me; I think
the author is Aristotle Pagaltzis.  Version 0.10 of this distribution
has similar options to the revised script.

For Windows, the script is called file-rename to avoid clashes with
existing rename command.

In 1.00, File::Require::Options is a separate module, 
and is not made visible by C<require File::Rename>. 

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

or if you have Module::Build

   perl Build.PL
   perl Build
   perl Build test
   perl Build install

    
DEPENDENCIES

This module requires these other modules and libraries:
File::Basename File::Path File::Spec Getopt::Long
(all included with Perl). 

Unicode support depends on Perl version 5.12.0.

Testing requires File::Temp and Test::More which are
available with perl 5.6.0.  I have successfully installed
those modules for perl 5.005_05 and tested this module.

LIMITATIONS

File::Rename treats strings as filenames. The original code expected
filenames to be ascii.  This module (and Perl itself) does not 
upgrade filenames to unicode (encoded as utf8) by default.

COPYRIGHT AND LICENCE

Copyright (C) 2005, 2006, 2007, 2011, 2018, 2020, 2021 by Robin Barker

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.4 or,
at your option, any later version of Perl 5 you may have available.

