Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

file 107 lines (74 sloc) 3.075 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107
$Id$

--------------------
Detailed Information
--------------------

POE is bigger than this README. Please see http://poe.perl.org/ for
much more information.

-----------
What POE Is
-----------

POE is a mature framework for creating networking and 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 of code to nearly 20,000.

POE is compatible with perl 5.005_03 and up.

POE includes an evolving component framework. Components are
high-level, 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 http://poe.perl.org/?Where_to_Get_POE for download sites, Windows
tips, and anonymous CVS instructions.

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

  perl -MCPAN -e shell
  cpan> install POE

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

  ppm install http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd
  ppm3 install http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd

------------
Test Results
------------

POE's test results are large and constantly changing, so it makes more
sense that they are on the web.

  http://eekeek.org/poe-tests/
    -- Automated test reports by users like you.

  http://testers.cpan.org/search?request=dist&dist=POE
    -- CPAN testers' reports.

POE's ongoing improvement relies on your feedback. The easiest way to
do that is included in the POE distribution itself.

To generate "poe_report.xml" with a summary of POE's test results:

  make testreport

To upload that summary so we can tell if there are problems:

  make reportupload

If 'make reportupload' fails, you can upload poe_report.xml from the
form at http://eekeek.org/poe-tests/ .

Uploaded test results can be viewed at http://eekeek.org/poe-tests/ .

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

  http://poe.perl.org/?POE%27s_test_coverage_report

----
Bye!
----

Thanks for reading!

-- Rocco Caputo / rcaputo@cpan.org / poe.perl.org / poe.sourceforge.net
Something went wrong with that request. Please try again.