SourceForge has been redesigned. Learn more.

Tree [8fde4c] before_removing_macros /

HTTPS access

File Date Author Commit
 docs 2000-01-24 Rocco Caputo Rocco Caputo [12d9e3] Document compression mode in Changes
 lib 2002-09-17 Rocco Caputo Rocco Caputo [8fde4c] Explanation of the ErrorEvent parameters. Patc...
 mylib 2002-09-10 Rocco Caputo Rocco Caputo [03d78d] Compatibility enhancements for running test rep...
 samples 2002-08-30 Rocco Caputo Rocco Caputo [d78f70] Replaced three sample programs with pointers to...
 tests 2002-09-13 Rocco Caputo Rocco Caputo [55324f] Fix a misleading skip message (Tk *is* supporte...
 HISTORY 1998-11-23 Rocco Caputo Rocco Caputo [bfdcb0] pointless...
 MANIFEST 2002-09-03 Rocco Caputo Rocco Caputo [4d4471] Added cvs-log.perl; added the report upload uti...
 Makefile.PL 2002-05-17 Matt Cashner Matt Cashner [773db7] drop the spurious warn from the makefile
 NEEDS 2002-06-11 Rocco Caputo Rocco Caputo [652851] Peter Chen noticed that the NEEDS file did not ...
 README 2002-09-12 Rocco Caputo Rocco Caputo [cb1142] Bring it up to date with what's going on.
 TODO 2001-10-12 Rocco Caputo Rocco Caputo [4a6ece] move unessential information to the web

Read Me


Detailed Information

POE is bigger than this README.  Please see for
much more information.

What POE Is

POE is a mature framework for creating networking or multitasking
programs in Perl.  It has been in active, open development since
August 1998.  It has been used in mission-critical systems such as
internetworked financial markets, file systems, commerce and
application servers.  It has been used in projects ranging from a few
lines to nearly 20,000.

POE is compatible with perl 5.005_03 through 5.6.1 and beyond.

POE includes functions for creating and using components.  Components
are modular, reusable pieces of programs.  Several components have
been published on the CPAN, and more are listed on POE's web site.

POE includes components and libraries for making quick work of network
clients, servers, and peers.  A simple stand-alone web application
takes about 30 lines of code, most of which is your own custom logic.

Documentation Roadmap

POE includes so much documentation that the main man page includes an
index to the rest.  See the "SEE ALSO" section in "man POE", or your
system's equivalent.

The CHANGES file lists all the changes in the past year.  POE's web
site includes a complete change history, broken down by release.

Installing POE

See for download sites, Windows
tips, and anonymous CVS instructions.

POE may be installed through the CPAN shell in the usual CPAN shell

  perl -MCPAN -e 'install POE'

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

  perl -MCPAN -e shell
  cpan> install POE

To install on a Win32 machine using ActiveState's PPM.  If PPM fails,
try PPM3:

  ppm install
  ppm3 install

Test Results

POE's test results are large and constantly changing, so it makes more
sense that they are on the web.
    -- Automated test reports by users like you.
    -- CPAN testers' reports.

POE's ongoing improvement relies on your feedback.  The easiest way to
do that is included in the POE distribution itself.  The Makefile
includes two targets: 'testreport' and 'reportupload'.

  make testreport
  make reportupload

Running 'make testreport' will run the test suite and generate an XML
file summarizing the test results named 'poe_report.xml'.  If you have
an active non-proxied internet connection, running 'make reportupload'
will transmit your test results to the POE test server.

If 'make reportupload' fails, you can upload poe_report.xml from the
form at .

Uploaded test results can be viewed at

Test Coverage

POE's test coverage report has also moved onto the 'web.  It gives a
very rough idea of the amount of POE that's been at least cursorily
tested, but it should not be used as an accurate gauge of quality.


Thanks for reading!

-- Rocco Caputo / / /