File::Stream version 2.20
=========================

Perl filehandles are streams, but sometimes they just aren't powerful enough.
This module offers to have streams from filehandles searched with regexes
and allows the global input record separator variable to contain regexes.

Thus, readline() and the <> operator can now return records delimited
by regular expression matches.

Please see the POD documentation in the module file for important CAVEATS.

INSTALLATION

To install this module type the following:

   perl Build.PL
   ./Build
   ./Build test
   ./Build install

On platforms that don't support the "./" notation, that would be:

   perl Build.PL
   perl Build
   perl Build test
   perl Build install

If you wish, you may use the old MakeMaker style instead:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  Carp
  Test::More
  YAPE::Regex

CONTRIBUTIONS

Many thanks go to Simon Cozens for the original idea and much valuable
input. It was great fun talking about some of the weirder features of Perl.
Equally many thanks to Autrijus Tang for much help with the fiendish regexes
I couldn't handle and Ben Tilly for suggesting the use of the ${} regex
construct.

Also, I owe thanks to Jeff 'japhy' Pinyan for writing the YAPE::Regex
module which made my life much easier.

COPYRIGHT AND LICENCE

Copyright (C) 2003-2008 Steffen Mller
Author can be reached at stream-module at steffen-mueller dot net.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.