Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 111 lines (76 sloc) 3.213 kB
f022983 @rcaputo Initial revision
authored
1 $Id$
2
324b184 @rcaputo revise for imminent 0.1702 release
authored
3 --------------------
4 Detailed Information
5 --------------------
6
2b2bea6 @rcaputo Finalize things for the imminent 0.25 release.
authored
7 POE is bigger than this README. Please see its web site at
8 http://poe.perl.org/ for more information.
324b184 @rcaputo revise for imminent 0.1702 release
authored
9
6221c66 @rcaputo revise README
authored
10 -----------
11 What POE Is
12 -----------
53cd540 @rcaputo explained more about what the hell this is
authored
13
6ca17b3 @rcaputo Pre-release tweaks.
authored
14 POE is a networking and multitasking framework for Perl. It has been
15 in active development since 1996, with its first open release in 1998.
16 The Perl Conference (now OSCON) named POE "Best New Module" in 1999.
17
18 POE has been used in mission-critical systems such as internetworked
19 financial markets, file systems, commerce and application servers. It
20 has been used in projects ranging from a few lines of code to tens of
21 thousands.
324b184 @rcaputo revise for imminent 0.1702 release
authored
22
2b2bea6 @rcaputo Finalize things for the imminent 0.25 release.
authored
23 POE is compatible with perl versions as old as 5.005_03.
324b184 @rcaputo revise for imminent 0.1702 release
authored
24
6991db4 @rcaputo Minor edits before 0.2302 is tarred up.
authored
25 POE includes an evolving component framework. Components are
26 high-level, modular, reusable pieces of programs. Several components
27 have been published on the CPAN, and more are listed on POE's web
28 site.
324b184 @rcaputo revise for imminent 0.1702 release
authored
29
30 POE includes components and libraries for making quick work of network
cb1142b @rcaputo Bring it up to date with what's going on.
authored
31 clients, servers, and peers. A simple stand-alone web application
32 takes about 30 lines of code, most of which is your own custom logic.
1268917 @rcaputo reinvented it all again
authored
33
c377104 @rcaputo touch-up distribution files for Wheel::Run and pipes
authored
34 ---------------------
35 Documentation Roadmap
36 ---------------------
37
f1cac60 @rcaputo fix some minor typos
authored
38 POE includes so much documentation that the main man page includes an
cb1142b @rcaputo Bring it up to date with what's going on.
authored
39 index to the rest. See the "SEE ALSO" section in "man POE", or your
324b184 @rcaputo revise for imminent 0.1702 release
authored
40 system's equivalent.
c377104 @rcaputo touch-up distribution files for Wheel::Run and pipes
authored
41
cb1142b @rcaputo Bring it up to date with what's going on.
authored
42 The CHANGES file lists all the changes in the past year. POE's web
2b2bea6 @rcaputo Finalize things for the imminent 0.25 release.
authored
43 site includes a complete change history, separated by version number,
44 going back to its first public release.
324b184 @rcaputo revise for imminent 0.1702 release
authored
45
46 --------------
47 Installing POE
48 --------------
670c4b3 @rcaputo tiny tweaks for next release
authored
49
d41c89d @rcaputo Final preparations for releasing POE 0.20.
authored
50 See http://poe.perl.org/?Where_to_Get_POE for download sites, Windows
51 tips, and anonymous CVS instructions.
1268917 @rcaputo reinvented it all again
authored
52
d8788af @rcaputo Big documentation rewrite
authored
53 POE may be installed through the CPAN shell in the usual CPAN shell
324b184 @rcaputo revise for imminent 0.1702 release
authored
54 manner.
1268917 @rcaputo reinvented it all again
authored
55
d8788af @rcaputo Big documentation rewrite
authored
56 perl -MCPAN -e shell
d41c89d @rcaputo Final preparations for releasing POE 0.20.
authored
57 cpan> install POE
1268917 @rcaputo reinvented it all again
authored
58
cb1142b @rcaputo Bring it up to date with what's going on.
authored
59 To install on a Win32 machine using ActiveState's PPM. If PPM fails,
60 try PPM3:
6221c66 @rcaputo revise README
authored
61
cb1142b @rcaputo Bring it up to date with what's going on.
authored
62 ppm install http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd
63 ppm3 install http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd
f2789c3 @rcaputo updated documentation for new contributions
authored
64
5225b6b @rcaputo readme fixes
authored
65 ------------
66 Test Results
67 ------------
1db9198 @rcaputo lots of testing changes and additions
authored
68
e445966 @rcaputo Last minute tweaks.
authored
69 POE's test results are large and constantly changing, so it makes more
70 sense that they are on the web.
324b184 @rcaputo revise for imminent 0.1702 release
authored
71
f512910 @sungo document the test server and the makefile targets
sungo authored
72 http://eekeek.org/poe-tests/
e445966 @rcaputo Last minute tweaks.
authored
73 -- Automated test reports by users like you.
74
d41c89d @rcaputo Final preparations for releasing POE 0.20.
authored
75 http://testers.cpan.org/search?request=dist&dist=POE
e445966 @rcaputo Last minute tweaks.
authored
76 -- CPAN testers' reports.
77
78 POE's ongoing improvement relies on your feedback. The easiest way to
6991db4 @rcaputo Minor edits before 0.2302 is tarred up.
authored
79 do that is included in the POE distribution itself.
80
81 To generate "poe_report.xml" with a summary of POE's test results:
e445966 @rcaputo Last minute tweaks.
authored
82
83 make testreport
84
6991db4 @rcaputo Minor edits before 0.2302 is tarred up.
authored
85 To upload that summary so we can tell if there are problems:
86
87 make reportupload
e445966 @rcaputo Last minute tweaks.
authored
88
71ab3b1 @rcaputo Remove the link to the deprecated stinky hand-maintained test results.
authored
89 If 'make reportupload' fails, you can upload poe_report.xml from the
90 form at http://eekeek.org/poe-tests/ .
d41c89d @rcaputo Final preparations for releasing POE 0.20.
authored
91
6991db4 @rcaputo Minor edits before 0.2302 is tarred up.
authored
92 Uploaded test results can be viewed at http://eekeek.org/poe-tests/ .
c5c96e7 @rcaputo partial pty code in wheel::run... need to move to another machine
authored
93
a710504 @rcaputo Tweak README and Makefile.PL
authored
94 -------------
95 Test Coverage
96 -------------
97
324b184 @rcaputo revise for imminent 0.1702 release
authored
98 POE's test coverage report has also moved onto the 'web. It gives a
99 very rough idea of the amount of POE that's been at least cursorily
100 tested, but it should not be used as an accurate gauge of quality.
4a6ecea @rcaputo move unessential information to the web
authored
101
d41c89d @rcaputo Final preparations for releasing POE 0.20.
authored
102 http://poe.perl.org/?POE%27s_test_coverage_report
103
4a6ecea @rcaputo move unessential information to the web
authored
104 ----
105 Bye!
106 ----
f2789c3 @rcaputo updated documentation for new contributions
authored
107
ad3be79 @rcaputo gtk debugged... moving to os/2 for testing
authored
108 Thanks for reading!
0d6f19d @rcaputo Revised all the manpages. Split the manpages into separate PODs, and
authored
109
324b184 @rcaputo revise for imminent 0.1702 release
authored
110 -- Rocco Caputo / rcaputo@cpan.org / poe.perl.org / poe.sourceforge.net
Something went wrong with that request. Please try again.