Add ARM files
[dh-make-perl] / dev / arm / libio-stringy-perl / io-stringy-2.110 / debian / libio-stringy-perl / usr / share / doc / libio-stringy-perl / html / Stringy.pm.html
diff --git a/dev/arm/libio-stringy-perl/io-stringy-2.110/debian/libio-stringy-perl/usr/share/doc/libio-stringy-perl/html/Stringy.pm.html b/dev/arm/libio-stringy-perl/io-stringy-2.110/debian/libio-stringy-perl/usr/share/doc/libio-stringy-perl/html/Stringy.pm.html
new file mode 100644 (file)
index 0000000..07121d8
--- /dev/null
@@ -0,0 +1,504 @@
+<HTML>
+<HEAD>
+  <TITLE>IO-stringy 2.109</TITLE>
+</HEAD>
+<BODY 
+       bgcolor="#FFFFFF" link="#CC3366" vlink="#993366" alink="#FF6666">
+<FONT FACE="sans-serif" SIZE=-1><A HREF="http://www.zeegee.com" TARGET="_top"><IMG SRC="icons/zeegee.gif" ALT="ZeeGee Software" ALIGN="RIGHT" BORDER="0"></A><A NAME="__TOP__"><H1>IO-stringy 2.109</H1>
+</A><UL>
+<LI> <A NAME="menu:NAME"><A HREF="#NAME">NAME</A></A>
+<LI> <A NAME="menu:SYNOPSIS"><A HREF="#SYNOPSIS">SYNOPSIS</A></A>
+<LI> <A NAME="menu:DESCRIPTION"><A HREF="#DESCRIPTION">DESCRIPTION</A></A>
+<LI> <A NAME="menu:WARNINGS"><A HREF="#WARNINGS">WARNINGS</A></A>
+<LI> <A NAME="menu:INSTALLATION"><A HREF="#INSTALLATION">INSTALLATION</A></A>
+<UL>
+<LI> <A NAME="menu:Requirements"><A HREF="#Requirements">Requirements</A></A>
+<LI> <A NAME="menu:Directions"><A HREF="#Directions">Directions</A></A>
+</UL>
+<LI> <A NAME="menu:VERSION"><A HREF="#VERSION">VERSION</A></A>
+<LI> <A NAME="menu:TO_DO"><A HREF="#TO_DO">TO DO</A></A>
+<LI> <A NAME="menu:CHANGE_LOG"><A HREF="#CHANGE_LOG">CHANGE LOG</A></A>
+<UL>
+<LI> <A NAME="menu:item:Version_2_109_2003_12_21"><A HREF="#item:Version_2_109_2003_12_21">Version 2.109   (2003/12/21)</A></A>
+<LI> <A NAME="menu:item:Version_2_108_2001_08_20"><A HREF="#item:Version_2_108_2001_08_20">Version 2.108   (2001/08/20)</A></A>
+<LI> <A NAME="menu:item:Version_2_105_2001_08_09"><A HREF="#item:Version_2_105_2001_08_09">Version 2.105   (2001/08/09)</A></A>
+<LI> <A NAME="menu:item:Version_2_103_2001_08_08"><A HREF="#item:Version_2_103_2001_08_08">Version 2.103   (2001/08/08)</A></A>
+<LI> <A NAME="menu:item:Version_2_101_2001_08_07"><A HREF="#item:Version_2_101_2001_08_07">Version 2.101   (2001/08/07)</A></A>
+<LI> <A NAME="menu:item:Version_1_221_2001_08_07"><A HREF="#item:Version_1_221_2001_08_07">Version 1.221   (2001/08/07)</A></A>
+<LI> <A NAME="menu:item:Version_1_220_2001_04_03"><A HREF="#item:Version_1_220_2001_04_03">Version 1.220   (2001/04/03)</A></A>
+<LI> <A NAME="menu:item:Version_1_219_2001_02_23"><A HREF="#item:Version_1_219_2001_02_23">Version 1.219   (2001/02/23)</A></A>
+<LI> <A NAME="menu:item:Version_1_218_2001_02_23"><A HREF="#item:Version_1_218_2001_02_23">Version 1.218   (2001/02/23)</A></A>
+<LI> <A NAME="menu:item:Version_1_216_2000_09_28"><A HREF="#item:Version_1_216_2000_09_28">Version 1.216   (2000/09/28)</A></A>
+<LI> <A NAME="menu:item:Version_1_215_2000_09_05"><A HREF="#item:Version_1_215_2000_09_05">Version 1.215   (2000/09/05)</A></A>
+<LI> <A NAME="menu:item:Version_1_214_2000_09_03"><A HREF="#item:Version_1_214_2000_09_03">Version 1.214   (2000/09/03)</A></A>
+<LI> <A NAME="menu:item:Version_1_213_2000_08_16"><A HREF="#item:Version_1_213_2000_08_16">Version 1.213   (2000/08/16)</A></A>
+<LI> <A NAME="menu:item:Version_1_212_2000_06_02"><A HREF="#item:Version_1_212_2000_06_02">Version 1.212   (2000/06/02)</A></A>
+<LI> <A NAME="menu:item:Version_1_210_2000_04_17"><A HREF="#item:Version_1_210_2000_04_17">Version 1.210   (2000/04/17)</A></A>
+<LI> <A NAME="menu:item:Version_1_209_2000_03_17"><A HREF="#item:Version_1_209_2000_03_17">Version 1.209   (2000/03/17)</A></A>
+<LI> <A NAME="menu:item:Version_1_208_2000_03_14"><A HREF="#item:Version_1_208_2000_03_14">Version 1.208   (2000/03/14)</A></A>
+<LI> <A NAME="menu:item:Version_1_206_1999_04_18"><A HREF="#item:Version_1_206_1999_04_18">Version 1.206   (1999/04/18)</A></A>
+<LI> <A NAME="menu:item:Version_1_205_1999_01_15"><A HREF="#item:Version_1_205_1999_01_15">Version 1.205   (1999/01/15)</A></A>
+<LI> <A NAME="menu:item:Version_1_202_1998_04_18"><A HREF="#item:Version_1_202_1998_04_18">Version 1.202   (1998/04/18)</A></A>
+<LI> <A NAME="menu:item:Version_1_110"><A HREF="#item:Version_1_110">Version 1.110   </A></A>
+<LI> <A NAME="menu:item:Version_1_107"><A HREF="#item:Version_1_107">Version 1.107   </A></A>
+<LI> <A NAME="menu:item:Version_1_105"><A HREF="#item:Version_1_105">Version 1.105   </A></A>
+</UL>
+<LI> <A NAME="menu:AUTHOR"><A HREF="#AUTHOR">AUTHOR</A></A>
+</UL>
+
+
+<P><HR>
+<A NAME="NAME"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> NAME</H2></A>
+
+
+<P>IO-stringy - I/O on in-core objects like strings and arrays
+
+
+
+<P><HR>
+<A NAME="SYNOPSIS"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> SYNOPSIS</H2></A>
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    IO::
+    ::AtomicFile   adpO  Write a file which is updated atomically     ERYQ
+    ::Lines        bdpO  I/O handle to read/write to array of lines   ERYQ
+    ::Scalar       RdpO  I/O handle to read/write to a string         ERYQ
+    ::ScalarArray  RdpO  I/O handle to read/write to array of scalars ERYQ
+    ::Wrap         RdpO  Wrap old-style FHs in standard OO interface  ERYQ
+    ::WrapTie      adpO  Tie your handles &amp; retain full OO interface  ERYQ
+</PRE></FONT>
+
+
+<P><HR>
+<A NAME="DESCRIPTION"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> DESCRIPTION</H2></A>
+
+
+<P>This toolkit primarily provides modules for performing both traditional 
+and object-oriented i/o) on things <I>other</I> than normal filehandles; 
+in particular, <A HREF="../IO/Scalar.pm.html">IO::Scalar</A>, <A HREF="../IO/ScalarArray.pm.html">IO::ScalarArray</A>, 
+and <A HREF="../IO/Lines.pm.html">IO::Lines</A>.
+
+
+<P>In the more-traditional IO::Handle front, we 
+have <A HREF="../IO/AtomicFile.pm.html">IO::AtomicFile</A>
+which may be used to painlessly create files which are updated
+atomically.
+
+
+<P>And in the &quot;this-may-prove-useful&quot; corner, we have <A HREF="../IO/Wrap.pm.html">IO::Wrap</A>, 
+whose exported wraphandle() function will clothe anything that's not
+a blessed object in an IO::Handle-like wrapper... so you can just
+use OO syntax and stop worrying about whether your function's caller
+handed you a string, a globref, or a FileHandle.
+
+
+
+<P><HR>
+<A NAME="WARNINGS"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> WARNINGS</H2></A>
+
+
+<P>Perl's TIEHANDLE spec was incomplete prior to 5.005_57;
+it was missing support for <CODE>seek()</CODE>, <CODE>tell()</CODE>, and <CODE>eof()</CODE>.
+Attempting to use these functions with an IO::Scalar, IO::ScalarArray,
+IO::Lines, etc. <B>will not work</B> prior to 5.005_57.  
+None of the relevant methods will be invoked by Perl; 
+and even worse, this kind of bug can lie dormant for a while.
+If you turn warnings on (via <CODE>$^W</CODE> or <CODE>perl -w</CODE>), and you see 
+something like this...
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    seek() on unopened file
+</PRE></FONT>
+
+<P>...then you are probably trying to use one of these functions
+on one of our IO:: classes with an old Perl.  The remedy is to simply
+use the OO version; e.g.:
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    $SH-&gt;seek(0,0);    ### GOOD: will work on any 5.005
+    seek($SH,0,0);     ### WARNING: will only work on 5.005_57 and beyond
+</PRE></FONT>
+
+
+<P><HR>
+<A NAME="INSTALLATION"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> INSTALLATION</H2></A>
+
+
+
+<P><HR>
+<A NAME="Requirements"><H3><A HREF="#__TOP__"><IMG SRC="icons/h2bullet.gif" ALT="Top" BORDER="0"></A> Requirements</H3></A>
+
+
+<P>As of version 2.x, this toolkit requires Perl 5.005 for 
+the IO::Handle subclasses, and 5.005_57 or better is
+<B>strongly</B> recommended.  See <A HREF="#WARNINGS">WARNINGS</A> for details.
+
+
+
+<P><HR>
+<A NAME="Directions"><H3><A HREF="#__TOP__"><IMG SRC="icons/h2bullet.gif" ALT="Top" BORDER="0"></A> Directions</H3></A>
+
+
+<P>Most of you already know the drill...
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    perl Makefile.PL
+    make
+    make test
+    make install
+</PRE></FONT>
+
+<P>For everyone else out there...
+if you've never installed Perl code before, or you're trying to use
+this in an environment where your sysadmin or ISP won't let you do
+interesting things, <B>relax:</B> since this module contains no binary 
+extensions, you can cheat.  That means copying the directory tree
+under my &quot;./lib&quot; directory into someplace where your script can &quot;see&quot; 
+it.  For example, under Linux:
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    cp -r IO-stringy-1.234/lib/* /path/to/my/perl/
+</PRE></FONT>
+
+<P>Now, in your Perl code, do this:
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    use lib &quot;/path/to/my/perl&quot;;
+    use IO::Scalar;                   ### or whatever
+</PRE></FONT>
+
+<P>Ok, now you've been told.  At this point, anyone who whines about
+not being given enough information gets an unflattering haiku 
+written about them in the next change log.  I'll do it.  
+Don't think I won't.
+
+
+
+<P><HR>
+<A NAME="VERSION"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> VERSION</H2></A>
+
+
+<P>$Id: Stringy.pm,v 2.109 2003/12/21 18:51:45 eryq Exp $
+
+
+
+<P><HR>
+<A NAME="TO_DO"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> TO DO</H2></A>
+
+
+
+<DL>
+<P><DT><B><A NAME="item:2000_08_02_Finalize_support">(2000/08/02)  Finalize $/ support</A></B></DT>
+<DD>
+Graham Barr submitted this patch half a <I>year</I> ago; 
+Like a moron, I lost his message under a ton of others,
+and only now have the experimental implementation done.
+
+
+<P>Will the sudden sensitivity to $/ hose anyone out there?
+I'm worried, so you have to enable it explicitly in 1.x.
+It will be on by default in 2.x, though only IO::Scalar
+has been implemented.
+
+<P><DT><B><A NAME="item:2000_09_28_Separate_read_write_cursors">(2000/09/28)  Separate read/write cursors?</A></B></DT>
+<DD>
+Binkley sent me a very interesting variant of IO::Scalar which
+maintains two separate cursors on the data, one for reading
+and one for writing.  Quoth he:
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    Isn't it the case that real operating system file descriptors 
+    maintain an independent read and write file position (and 
+    seek(2) resets them both)? 
+</PRE></FONT>
+
+<P>(My answer: perhaps, but stdio's fseek/ftell manpages seem to
+imply a single file position indicator, and I'm trying to be IO::-ish.)
+Binkley also pointed out some issues with his implementation:  
+
+<FONT SIZE=3 FACE="courier"><PRE>
+    For example, what does eof or tell return?  The read position or 
+    the write position?  (I assumed read position was more important). 
+</PRE></FONT>
+
+<P>Your opinions on this are most welcome.
+(Me, I'm just squeamish that this will break some code
+which depends on the existing behavior, and that attempts to
+maintain backwards-compatibility will slow down the code.)
+
+<P><DT><B><A NAME="item:2001_08_08_Remove_IO_WrapTie_from_new_IO_classes">(2001/08/08)  Remove IO::WrapTie from new IO:: classes</A></B></DT>
+<DD>
+It's not needed.  Backwards compatibility could be maintained
+by having new_tie() be identical to new().  Heck, I'll bet
+that IO::WrapTie should be reimplemented so the returned 
+object is just like an IO::Scalar in its use of globrefs.
+
+</DL>
+
+
+
+<P><HR>
+<A NAME="CHANGE_LOG"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> CHANGE LOG</H2></A>
+
+
+
+<DL>
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_2_109_2003_12_21">Version 2.109   (2003/12/21)</A></A></B></DT>
+<DD>
+IO::Scalar::getline now works with ref to int.
+<I>Thanks to Dominique Quatravaux for this patch.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_2_108_2001_08_20">Version 2.108   (2001/08/20)</A></A></B></DT>
+<DD>
+The terms-of-use have been placed in the distribution file &quot;COPYING&quot;.  
+Also, small documentation tweaks were made.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_2_105_2001_08_09">Version 2.105   (2001/08/09)</A></A></B></DT>
+<DD>
+Added support for various seek() whences to IO::ScalarArray.
+
+
+<P>Added support for consulting $/ in IO::Scalar and IO::ScalarArray.
+The old <CODE>use_RS()</CODE> is not even an option.  
+Unsupported record separators will cause a croak().
+
+
+<P>Added a lot of regression tests to supoprt the above.
+
+
+<P>Better on-line docs (hyperlinks to individual functions).
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_2_103_2001_08_08">Version 2.103   (2001/08/08)</A></A></B></DT>
+<DD>
+After sober consideration I have reimplemented IO::Scalar::print() 
+so that it once again always seeks to the end of the string.
+Benchmarks show the new implementation to be just as fast as
+Juergen's contributed patch; until someone can convince me otherwise,
+the current, safer implementation stays.
+
+
+<P>I thought more about giving IO::Scalar two separate handles,
+one for reading and one for writing, as suggested by Binkley.
+His points about what tell() and eof() return are, I think,
+show-stoppers for this feature.  Even the manpages for stdio's fseek()
+seem to imply a <I>single</I> file position indicator, not two.
+So I think I will take this off the TO DO list.  
+<B>Remedy:</B> you can always have two handles open on the same
+scalar, one which you only write to, and one which you only read from.
+That should give the same effect.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_2_101_2001_08_07">Version 2.101   (2001/08/07)</A></A></B></DT>
+<DD>
+<B>Alpha release.</B>
+This is the initial release of the &quot;IO::Scalar and friends are
+now subclasses of IO::Handle&quot;.  I'm flinging it against the wall.  
+Please tell me if the banana sticks.  When it does, the banana
+will be called 2.2x. 
+
+
+<P>First off, <I>many many thanks to Doug Wilson</I>, who
+has provided an <I>invaluable</I> service by patching IO::Scalar
+and friends so that they (1) inherit from IO::Handle, (2) automatically
+tie themselves so that the <CODE>new()</CODE> objects can be used in native i/o
+constructs, and (3) doing it so that the whole damn thing passes
+its regression tests.  As Doug knows, my globref Kung-Fu was not
+up to the task; he graciously provided the patches.  This has earned
+him a seat at the <A HREF="#AUTHOR">Co-Authors</A> table, and the 
+right to have me address him as <I>sensei</I>.
+
+
+<P>Performance of IO::Scalar::print() has been improved by as much as 2x
+for lots of little prints, with the cost of forcing those
+who print-then-seek-then-print to explicitly seek to end-of-string
+before printing again.
+<I>Thanks to Juergen Zeller for this patch.</I>
+
+
+<P>Added the COPYING file, which had been missing from prior versions.  
+<I>Thanks to Albert Chin-A-Young for pointing this out.</I>
+
+
+<P>IO::Scalar consults $/ by default (1.x ignored it by default).
+Yes, I still need to support IO::ScalarArray.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_221_2001_08_07">Version 1.221   (2001/08/07)</A></A></B></DT>
+<DD>
+I threatened in <A HREF="#INSTALLATION">INSTALLATION</A> to write an unflattering haiku
+about anyone who whined that I gave them insufficient information...
+but it turns out that I left out a crucial direction.  D'OH!
+<I>Thanks to David Beroff for the &quot;patch&quot; and the haiku...</I>
+
+<FONT SIZE=3 FACE="courier"><PRE>
+       Enough info there?
+         Here's unflattering haiku:
+       Forgot the line, &quot;make&quot;!  ;-)
+</PRE></FONT>
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_220_2001_04_03">Version 1.220   (2001/04/03)</A></A></B></DT>
+<DD>
+Added untested SEEK, TELL, and EOF methods to IO::Scalar 
+and IO::ScalarArray to support corresponding functions for
+tied filehandles: untested, because I'm still running 5.00556 
+and Perl is complaining about &quot;tell() on unopened file&quot;.
+<I>Thanks to Graham Barr for the suggestion.</I>
+
+
+<P>Removed not-fully-blank lines from modules; these were causing
+lots of POD-related warnings.  
+<I>Thanks to Nicolas Joly for the suggestion.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_219_2001_02_23">Version 1.219   (2001/02/23)</A></A></B></DT>
+<DD>
+IO::Scalar objects can now be made sensitive to $/ .
+Pains were taken to keep the fast code fast while adding this feature.
+<I>Cheers to Graham Barr for submitting his patch; 
+jeers to me for losing his email for 6 months.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_218_2001_02_23">Version 1.218   (2001/02/23)</A></A></B></DT>
+<DD>
+IO::Scalar has a new sysseek() method.
+<I>Thanks again to Richard Jones.</I>
+
+
+<P>New &quot;TO DO&quot; section, because people who submit patches/ideas should 
+at least know that they're in the system... and that I won't lose
+their stuff.  Please read it.  
+
+
+<P>New entries in <A HREF="#AUTHOR">AUTHOR</A>.  
+Please read those too.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_216_2000_09_28">Version 1.216   (2000/09/28)</A></A></B></DT>
+<DD>
+<B>IO::Scalar and IO::ScalarArray now inherit from IO::Handle.</B>
+I thought I'd remembered a problem with this ages ago, related to
+the fact that these IO:: modules don't have &quot;real&quot; filehandles,
+but the problem apparently isn't surfacing now.  
+If you suddenly encounter Perl warnings during global destruction
+(especially if you're using tied filehandles), then please let me know!
+<I>Thanks to B. K. Oxley (binkley) for this.</I>
+
+
+<P><B>Nasty bug fixed in IO::Scalar::write().</B>
+Apparently, the offset and the number-of-bytes arguments were,
+for all practical purposes, <I>reversed.</I>  You were okay if
+you did all your writing with print(), but boy was <I>this</I> a stupid bug!  
+<I>Thanks to Richard Jones for finding this one.  
+For you, Rich, a double-length haiku:</I>
+
+<FONT SIZE=3 FACE="courier"><PRE>
+       Newspaper headline
+          typeset by dyslexic man
+       loses urgency
+</PRE></FONT>
+<FONT SIZE=3 FACE="courier"><PRE>
+       BABY EATS FISH is
+          simply not equivalent   
+       to FISH EATS BABY
+</PRE></FONT>
+
+<P><B>New sysread and syswrite methods for IO::Scalar.</B>
+<I>Thanks again to Richard Jones for this.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_215_2000_09_05">Version 1.215   (2000/09/05)</A></A></B></DT>
+<DD>
+Added 'bool' overload to '&quot;&quot;' overload, so object always evaluates 
+to true.  (Whew.  Glad I caught this before it went to CPAN.)
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_214_2000_09_03">Version 1.214   (2000/09/03)</A></A></B></DT>
+<DD>
+Evaluating an IO::Scalar in a string context now yields
+the underlying string.
+<I>Thanks to B. K. Oxley (binkley) for this.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_213_2000_08_16">Version 1.213   (2000/08/16)</A></A></B></DT>
+<DD>
+Minor documentation fixes.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_212_2000_06_02">Version 1.212   (2000/06/02)</A></A></B></DT>
+<DD>
+Fixed IO::InnerFile incompatibility with Perl5.004.
+<I>Thanks to many folks for reporting this.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_210_2000_04_17">Version 1.210   (2000/04/17)</A></A></B></DT>
+<DD>
+Added flush() and other no-op methods.
+<I>Thanks to Doru Petrescu for suggesting this.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_209_2000_03_17">Version 1.209   (2000/03/17)</A></A></B></DT>
+<DD>
+Small bug fixes.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_208_2000_03_14">Version 1.208   (2000/03/14)</A></A></B></DT>
+<DD>
+Incorporated a number of contributed patches and extensions,
+mostly related to speed hacks, support for &quot;offset&quot;, and
+WRITE/CLOSE methods.
+<I>Thanks to Richard Jones, Doru Petrescu, and many others.</I>
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_206_1999_04_18">Version 1.206   (1999/04/18)</A></A></B></DT>
+<DD>
+Added creation of ./testout when Makefile.PL is run.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_205_1999_01_15">Version 1.205   (1999/01/15)</A></A></B></DT>
+<DD>
+Verified for Perl5.005.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_202_1998_04_18">Version 1.202   (1998/04/18)</A></A></B></DT>
+<DD>
+New IO::WrapTie and IO::AtomicFile added.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_110">Version 1.110</A></A></B></DT>
+<DD>
+Added IO::WrapTie.
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_107">Version 1.107</A></A></B></DT>
+<DD>
+Added IO::Lines, and made some bug fixes to IO::ScalarArray. 
+Also, added getc().
+
+<P><DT><B><A HREF="#__TOP__"><IMG SRC="icons/itembullet.gif" ALT="Top" BORDER="0"></A> <A NAME="item:Version"><A NAME="item:Version_1_105">Version 1.105</A></A></B></DT>
+<DD>
+No real changes; just upgraded IO::Wrap to have a $VERSION string.
+
+</DL>
+
+
+
+<P><HR>
+<A NAME="AUTHOR"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> AUTHOR</H2></A>
+
+
+
+<DL>
+<P><DT><B><A NAME="item:Primary_Maintainer">Primary Maintainer</A></B></DT>
+<DD>
+Eryq (<I><FILE><A HREF="mailto:eryq@zeegee.com">eryq@zeegee.com</A></FILE></I>).
+President, ZeeGee Software Inc (<I><FILE><A HREF="http://www.zeegee.com">http://www.zeegee.com</A></FILE></I>).
+
+<P><DT><B><A NAME="item:Co-Authors">Co-Authors</A></B></DT>
+<DD>
+For all their bug reports and patch submissions, the following
+are officially recognized:
+
+<FONT SIZE=3 FACE="courier"><PRE>
+     Richard Jones
+     B. K. Oxley (binkley) 
+     Doru Petrescu 
+     Doug Wilson (for picking up the ball I dropped, and doing tie() right)
+</PRE></FONT>
+</DL>
+
+
+<P>Go to <I><FILE><A HREF="http://www.zeegee.com">http://www.zeegee.com</A></FILE></I> for the latest downloads
+and on-line documentation for this module. 
+
+
+<P>Enjoy.  Yell if it breaks.
+
+<P><HR>
+<ADDRESS><FONT SIZE=-1>
+Generated Sun Dec 21 13:54:37 2003 by cvu_pod2html
+</FONT></ADDRESS>
+</FONT></BODY>
+</HTML>