Tree [5e0721] v0_1008 /
 History



File Date Author Commit
 docs 2000-01-24 Rocco Caputo Rocco Caputo [12d9e3] Document compression mode in Changes
 lib 2000-06-14 Rocco Caputo Rocco Caputo [5e0721] version 0.1008 final
 mylib 2000-06-08 Rocco Caputo Rocco Caputo [de98f3] 0.1007 is in the can
 samples 2000-05-23 Rocco Caputo Rocco Caputo [1635ac] better tk test; need to move to os/2 for plain ...
 tests 2000-06-14 Rocco Caputo Rocco Caputo [b5cccc] garbage collection fixes
 Changes 2000-06-14 Rocco Caputo Rocco Caputo [5e0721] version 0.1008 final
 HISTORY 1998-11-23 Rocco Caputo Rocco Caputo [bfdcb0] pointless...
 MANIFEST 2000-06-06 Rocco Caputo Rocco Caputo [b79f2d] have Event feed into the child reap loop, too; ...
 Makefile.PL 2000-06-03 Rocco Caputo Rocco Caputo [1b3c88] many signal changes
 README 2000-06-03 Rocco Caputo Rocco Caputo [1b3c88] many signal changes

Read Me

$Id$


The bulk of this README's information has migrated to the POE manpage.

------------------------------
Compatibility Between Versions
------------------------------

As POE moves closer towards the Common Sense axis, it sometimes
diverges away from the Backwards Compatible axis.  If this version is
being installed over a previous one, please check the Changes file to
see what it might break.  Interface changes usually are documented.

------------------
Basic Installation
------------------

POE may be installed through the CPAN shell in the usual CPAN shell
manner.  It typically is:

  perl -MCPAN -e 'install POE'

It involves a little more work if you have an older CPAN shell:

  perl -MCPAN -e shell
  install POE

-------------------
Manual Installation
-------------------

POE can also be installed manually.  The latest CPAN version can be
found at <ftp://ftp.cpan.org/pub/CPAN/authors/id/R/RC/RCAPUTO/> or in
a similarl named directory at your favorite CPAN mirror.  The most
recent development snapshot, which only rarely contains heinous
showstopper bugs, is available from the author's web site at
<http://www.newts.org/~troc/poe.html>.

Downloading and unpacking the distribution are left as an exercise for
the reader.  To "build" and test it afterwards:

  perl Makefile.PL
  make test

The POE manpage discusses system requirements and compatibility
issues.  You can preview it with:

  perldoc ./POE.pm

There are several sample programs in the samples subdirectory.  The
POE manpage briefly explains them.

  ls -l samples

Finally you can install it:

  make install

-------------------------
Test Results and Coverage
-------------------------

POE's development after 0.1005 consists of a big push to test
everything.  To further this effort, the author wrote a test coverage
reporting program; then he discovered Devel::Coverage.  Oh well!
Anyway, here's the test coverage summary for this version:

  Source File                         =   Ran / Total = Covered
  POE.pm                              =    19 /    19 = 100.00%
  POE/Component/Server/TCP.pm         =    23 /    23 = 100.00%
  POE/Driver/SysRW.pm                 =    36 /    54 =  66.67%
  POE/Filter/HTTPD.pm                 =    11 /    85 =  12.94%
  POE/Filter/Line.pm                  =    15 /    20 =  75.00%
  POE/Filter/Reference.pm             =     4 /    66 =   6.06%
  POE/Filter/Stream.pm                =     2 /    11 =  18.18%
  POE/Kernel.pm                       =   616 /   908 =  67.84%
  POE/Preprocessor.pm                 =   119 /   134 =  88.81%
  POE/Session.pm                      =    88 /   194 =  45.36%
  POE/Wheel/FollowTail.pm             =     5 /    65 =   7.69%
  POE/Wheel/ListenAccept.pm           =     5 /    43 =  11.63%
  POE/Wheel/ReadWrite.pm              =    99 /   183 =  54.10%
  POE/Wheel/SocketFactory.pm          =   187 /   267 =  70.04%
  All Told                            =  1229 /  2072 =  59.31%


Good luck, and thank you for reading!


-- Rocco Caputo / troc@netrus.net