NAME
   CGI::AppBuilder::File - File module

SYNOPSIS
     use CGI::AppBuilder::File;

     my $ab = CGI::AppBuilder::File->new(
        'ifn', 'my_init.cfg', 'opt', 'vhS:a:');
     my ($q, $ar, $ar_log) = $ab->start_app($0, \%ARGV);
     my $fn = 'test.txt';
     print $ab->disp_file($fn, $ar);

DESCRIPTION
   This class provides methods for reading and parsing configuration files.

 new (ifn => 'file.cfg', opt => 'hvS:')
   This is a inherited method from CGI::AppBuilder. See the same method in
   CGI::AppBuilder for more details.

 disp_file ($fn, $ar)
   Input variables:

     $q    - CGI object
     $ar   - array ref for parameters
     $fn   - file name
     $rt   - whether to return the text to caller
     $st   - search text

   Variables used or routines called: N/A

   How to use:

     print     $self->disp_file($ar,'test.txt');
     my $txt = $self->disp_file($ar,'test.txt',1);

   Return: none or text

 prt_bin_file ($fn)
   Input variables:

     $fn   - file name

   Variables used or routines called: N/A

   How to use:

     print     $self->prt_bin_file('test.tar');

   Return: none or text

 copy_file ($f1, $f2, $txt)
   Input variables:

     $f1   - source file name
     $f2   - target file name
     $txt  - text to be appended to $f2

   Variables used or routines called:

     File::Copy
       copy - copy files

   How to use:

     my $f1 = 'text1.txt';
     my $f2 = 'text1.out';
     # duplicate the file and add 'quit' in the end
     $self->copy_file($f1, $f2, 'quit');

   Return: none

HISTORY
   *   Version 0.10

       This version extracts the disp_form method from CGI::Getopt class,
       inherits the new constructor from CGI::AppBuilder, and adds new
       methods of replace_named_variables, explode_variable, and
       explode_html.

   *   Version 0.20

SEE ALSO (some of docs that I check often)
   Oracle::Loader, Oracle::Trigger, CGI::Getopt, File::Xcopy,
   CGI::AppBuilder, CGI::AppBuilder::Message, CGI::AppBuilder::Log,
   CGI::AppBuilder::Config, etc.

AUTHOR
   Copyright (c) 2005 Hanming Tu. All rights reserved.

   This package is free software and is provided "as is" without express or
   implied warranty. It may be used, redistributed and/or modified under
   the terms of the Perl Artistic License (see
   http://www.perl.com/perl/misc/Artistic.html)

POD ERRORS
   Hey! The above document had some coding errors, which are explained
   below:

   Around line 252:
       You forgot a '=back' before '=head1'