NAME
    Dpchrist::File::Append - append to file or filehandle

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

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

  SUBROUTINES
   fappend
        fappend FILEHANDLE, LIST
        fappend FILENAME, LIST

    If first argument is a filehandle or a string beginning with '*', writes
    LIST to specified FILEHANDLE via print() and returns true. Whether the
    file is clobbered or appended is determined by how the caller opened the
    filehandle.

    Otherwise, assumes first argument is a file name, appends LIST to file
    via File::Slurp::write_file() and returns true.

    LIST is optional in either case, but fappend() will write to filehandle
    or append to file regardless, creating the file if it did not exist.

    Calls Carp::confess() on error.

  EXPORT
    None by default.

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

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

INSTALLATION
    Old school:

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

    Minimal:

        $ cpan Dpchrist::File::Append

    Complete:

        $ cpan Bundle::Dpchrist

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

SEE ALSO
        Perl Cookbook, 2 e., recipe 7.5

AUTHOR
    David Paul Christensen dpchrist@holgerdanske.com

COPYRIGHT AND LICENSE
    Copyright 2010 by David Paul Christensen 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.