FileHandle::Unget - A FileHandle which supports ungetting of multiple bytes

FileHandle::Unget is a drop-in replacement for FileHandle which allows more
than one byte to be placed back on the input. It supports an ungetc(ORD) which
can be called more than once in a row, and an ungets(SCALAR) which places a
string of bytes back on the input.


NEW IN THIS VERSION

Version 0.1621: Sun Feb 6 2005
- Improved compatibility with versions of Perl older than 5.6.0, by replacing
  "use bytes" with "use ExtUtils::MakeMaker::bytes".
- Fixed test case error reporting for tests that fail to fork.
- Fixed unexpected success of binmode_bug.t test on Windows 2000. (Thanks to
  Max Maischein for the bug report.)
- Fixed a bug in stdin_tell_bug.t. (Thanks to Max Maischein for the bug
  report.)


MODULE DEPENDENCIES
 
To use this module, you will need to install:

- Scalar::Util

You should be prompted to install this module automatically when you run "perl
Makefile.PL".


INSTALLATION

To install this package, change to the directory where you unarchived this
distribution and type the following:

  perl Makefile.PL
  make
  make test
  make install

You can install this package into a non-default location by appending one of
the following to the "perl Makefile.PL" command:

- "PREFIX=/installation/path" (for installation into a custom location),
- "INSTALLDIRS=site" (for installation into site-specific Perl directories)
- "INSTALLDIRS=perl" (for installation into standard Perl directories).

If you make the installation into your own directory, then remember that you
must tell perl where to search for modules before trying to 'use' them. For
example:

  use lib '/home/userid/lib';
  use FileHandle::Unget;

If make test fails, please see the INSTALLATION PROBLEMS section below.


INSTALLATION PROBLEMS

If you get warnings about weak references not being implemented in your
version of Perl, try upgrading your installation of Scalar::Util.

If "make test" fails, run

  make test TEST_VERBOSE=1

and see which test(s) are failing. Please email the results to the address
below, or submit a bug report on the project website as described in the
section REPORTING BUGS below.

For other bugs, see the section REPORTING BUGS below.


SECURITY NOTE

On Windows, this module will use a temporary file to decompress a file handle
when necessary. This could pose a security risk.


DOCUMENTATION

Just "perldoc FileHandle::Unget". After installation on Unix systems,
you can also do "man FileHandle::Unget".


HOMEPAGE

Visit http://fh-unget.sourceforge.net/ for the latest version, mailing lists,
discussion forums, CVS access, and more.


REPORTING BUGS

You can report bugs by filing a bug report at the project homepage. 


COPYRIGHT

Copyright (c) 1998-Sep 1 2000 Broc Seib. Copyright (c) Sep 1 2000-2004 David
Coppit. All rights reserved, save those granted by the license.


LICENSE

This code is distributed under the GNU General Public License (GPL).  See
the file LICENSE included in the distribution.


AUTHOR

David Coppit <david@coppit.org>