NAME

       File::Slurp::WithinPolicy - Applies filesystem policies to File::Slurp

SYNOPSIS

         use File::Slurp::WithinPolicy qw(:all);

         my $text = read_file( 'filename' );
         my @lines = read_file( 'filename' );
         write_file( 'filename', $text );
         append_file( 'filename', $more_text );
         overwrite_file( 'filename', $text );
         my @files = read_dir( '/path/to/dir' );

DESCRIPTION

       This provides the File::Slurp interface within a policy defined by File::Policy.  By
       default, File::Policy is a no-op and this behaves identically to File::Slurp.  System
       administrators may want to override the default File::Policy implementation to enforce a
       local filesystem policy (see File::Policy).

FUNCTIONS

       read_dir

       See "read_dir" in File::Slurp

       read_file

       See "read_file" in File::Slurp

       write_file

       See "write_file" in File::Slurp

       append_file

       See "append_file" in File::Slurp

       overwrite_file

       See "overwrite_file" in File::Slurp

EXPORTS

       By default, nothing is exported.  The ":all" tag can be used to export everything.
       Individual methods can also be exported.

SEE ALSO

       File::Slurp, File::Policy

VERSION

       $Revision: 1.4 $ on $Date: 2005/06/15 10:40:21 $ by $Author: simonf $

AUTHOR

       John Alden <cpan _at_ bbc _dot_ co _dot_ uk>

COPYRIGHT

       (c) BBC 2005. This program is free software; you can redistribute it and/or modify it
       under the GNU GPL.

       See the file COPYING in this distribution, or http://www.gnu.org/licenses/gpl.txt