Tree [5f4a27] v0_1702 /

HTTPS access

File Date Author Commit
 docs 2000-01-24 Rocco Caputo Rocco Caputo [12d9e3] Document compression mode in Changes
 lib 2002-01-04 Rocco Caputo Rocco Caputo [5f4a27] fix my e-mail address
 mylib 2001-07-28 Rocco Caputo Rocco Caputo [c7c73c] try forward and back slashes just in case File:...
 samples 2002-01-04 Rocco Caputo Rocco Caputo [5f4a27] fix my e-mail address
 tests 2002-01-04 Rocco Caputo Rocco Caputo [01890f] increase the timeout to make tests more robust
 HISTORY 1998-11-23 Rocco Caputo Rocco Caputo [bfdcb0] pointless...
 MANIFEST 2001-11-13 Rocco Caputo Rocco Caputo [f7dba9] Updated CHANGES. Added new files to MANIFEST. ...
 Makefile.PL 2002-01-04 Rocco Caputo Rocco Caputo [3b2444] fix e-mail address
 NEEDS 2001-06-07 Rocco Caputo Rocco Caputo [818102] change Changes case; add TODO
 README 2002-01-04 Rocco Caputo Rocco Caputo [f1cac6] fix some minor typos
 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 multitasking programs in Perl.
It has been actively developed for over three years.  It has been used
in mission-critical systems such as internetworked financial markets,
file systems, and commerce servers.

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.

POE includes components and libraries for making quick work of network
clients, servers, and peers.  A well "hello, world" web application
takes fewer than 50 lines of code.

Documentation Roadmap

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

The CHANGES file lists all the changes in the past year.  Changes back
to August 1998 are available on the web.

Distribution Details

This distribution includes several sample and tutorial programs.  They
are in the "samples" directory.  These programs take up a considerable
chunk of POE's download size, but they are NOT installed.

The test programs, in directory "t", may also be interesting examples,
but they're aimed more at exercising POE than illustrating good coding
practices.  The tests also aren't installed, in case you were

All in all, the actual installed bits of POE are probably around a
third of the total distribution, and about a quarter of B<that> is
documentation.  Most of the installed code is optional, so the parts
of POE people usually use tend to be relatively small.

Installing POE

See for complete 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
  install POE

To install on a Win32 machine using ActiveState's PPM:

  ppm install

POE can also be installed manually, and the latest versions of things
are available in CVS.  Instructions are on POE's web site.

Test Results

POE's test results are large and constantly changing.  They have been
moved to the web site for easier maintenance.  POE is tested severely
before even the limited-distribution development releases.

In the unlikely event that POE's tests fail, please consider reporting
the failure.  Open source has always relied on the kindness of

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 / / /

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks