NAME
    Dpchrist::File::LimitPath - limit path lengths

DESCRIPTION
    This documentation describes module revision $Revision: 1.34 $.

    This is alpha test level software and may change or disappear at any
    time.

  SUBROUTINES
   limit_path
        limit_path LIST

    Checks path length of each item in LIST and shortens file names to keep
    path length less than or equal to a prescribed limit (default 220). If a
    list item is a directory, processes contained files recursively. Returns
    true (1).

    Prints the names of shortened files. Use the "-quiet" option to
    suppress.

    Options may be set via %Dpchrist::File::LimitPath::opt:

    -delete => [0|1]
        Delete files that are too long but can't be shortened. Delete files
        that, if renamed, would collide with other files (previously
        existing or another renamed file).

    -dry_run => [0|1]
        Check files, but don't rename any.

    -limit => LIMIT
        Maximum path length in characters. Must be between the longest LIST
        item length and 32767 (inclusive).

    -quiet => [0|1]
        Only output error messages.

    Calls Carp::confess() on errors, including:

    *   LIST is empty.

    *   -limit option is less than longest list item length.

    *   Shortening file name would reduce file name to less than 1 character
        plus tilde plus dot plus extension. Use the "-delete" option to
        delete such files instead.

    *   Shortening file name would result in a file name collision. Use the
        "-delete" option to delete such files instead.

  EXPORT
    None by default.

    All of the subroutines may be imported by using the ':all' tag:

        use Dpchrist::File::LimitPath    qw( :all );

    See 'perldoc Export' for everything in between.

INSTALLATION
    Old school:

        $ perl Makefile.PL
        $ make
        $ make test
        $ make install

    Minimal:

        $ cpan Dpchrist::File::LimitPath

    Complete:

        $ cpan Bundle::Dpchrist

    The following warning may be safely ignored:

        Can't locate Dpchrist/Module/MakefilePL.pm in @INC (@INC contains: /
        etc/perl /usr/local/lib/perl/5.10.0 /usr/local/share/perl/5.10.0 /us
        r/lib/perl5 /usr/share/perl5 /usr/lib/perl/5.10 /usr/share/perl/5.10
        /usr/local/lib/site_perl .) at Makefile.PL line 22.

  PREREQUISITES
    See Makefile.PL in the source distribution root directory.

SEE ALSO
        limitpath(1)

AUTHOR
    David Paul Christensen dpchrist@holgerdanske.com

COPYRIGHT AND LICENSE
    Copyright 2010 by David Paul Chirstensen dpchrist@holgerdanske.com

    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by the
    Free Software Foundation; version 2.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
    Public License for more details.

    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

