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'