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.

Version 0.15:
- Switched from WeakRef to Scalar::Util, which is included in recent versions
  of Perl.
- Fixed a bug involving pipes and tell(), where tell() would cause following
  operations to fail.
- Added new_from_fd support
- Fixed a bug in which <$fh> would always behave as if called in a list
  context after the first such call.

DEPENDENCIES

- WeakRef

The modules can be found here:

WeakRef:                 http://search.cpan.org/search?dist=WeakRef

Installation can also be done automatically using the CPAN module:

  perl -MCPAN -e 'install WeakRef'


INSTALLATION

  % perl Makefile.PL
  % make
  % make test
  % make install

The "perl Makefile.PL" command will prompt you for an installation location if
you run it interactively, and will use the default values if it is run
non-iteractively. You will be asked to select the locations of certain
external compression programs.

You can force it to run non-interactively by specifying the following:

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

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


INSTALLATION PROBLEMS

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

http://fh-unget.sourceforge.net/


REPORTING BUGS

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


PRIMARY AUTHOR

Written by David Coppit (david@coppit.org, http://coppit.org/), with the
generous help of many kind people. See the file CHANGES for detailed
information.


LICENSE

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