Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Increase the version number to 0.26 for release. Revise the README

for clarity, conciseness, etc.
  • Loading branch information...
commit 2d9176d1da2adbe2f3f96fec9828427cd61b7cc2 1 parent 1c8e594
@rcaputo authored
Showing with 48 additions and 51 deletions.
  1. +47 −50 README
  2. +1 −1  lib/POE.pm
View
97 README
@@ -7,41 +7,16 @@ Detailed Information
POE is bigger than this README. Please see its web site at
http://poe.perl.org/ for more information.
------------
-What POE Is
------------
-
-POE is a networking and multitasking framework for Perl. It has been
-in active development since 1996, with its first open release in 1998.
-The Perl Conference (now OSCON) named POE "Best New Module" in 1999.
-
-POE 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 tens of
-thousands.
-
-POE is compatible with perl versions as old as 5.005_03.
-
-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.
+POE includes a lot of documentation. The main POE man page includes
+references to everything else.
The CHANGES file lists all the changes in the past year. POE's web
-site includes a complete change history, separated by version number,
-going back to its first public release.
+site (http://poe.perl.org/) includes a complete change history,
+separated by version number, going back to its first public release.
--------------
Installing POE
@@ -53,21 +28,24 @@ tips, and anonymous CVS instructions.
POE may be installed through the CPAN shell in the usual CPAN shell
manner.
- perl -MCPAN -e 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 http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd
- ppm3 install http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd
+ > ppm install http://unc.dl.sourceforge.net/sourceforge/poe/POE.ppd
+
+or
+
+ > 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.
+POE is tested before each release, and afterwards by at least two
+groups of people. Each group posts its results on the web:
http://eekeek.org/poe-tests/
-- Automated test reports by users like you.
@@ -76,35 +54,54 @@ sense that they are on the web.
-- 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:
+let us know how we're doing is to "make reportupload" after building
+POE.
- make testreport
+ % make reportupload
-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/ .
+That will generate poe_report.xml and upload it to eekeek.org. If it
+fails, you can upload it manually from the form 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.
+POE's tests cover a significant portion of the distribution. A
+thumbnail sketch of POE's test coverage is available, but do not use
+it as an accurate gauge of quality.
http://poe.perl.org/?POE%27s_test_coverage_report
+-----------
+What POE Is
+-----------
+
+POE is a networking and multitasking (some say cooperative threading)
+framework for Perl. It has been in active development since 1996,
+with its first open release in 1998. O'Reilly's Perl Conference (now
+OSCON) named POE "Best New Module" in 1999.
+
+POE 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 tens of
+thousands.
+
+POE is compatible with perl versions as old as 5.005_03.
+
+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.
+
----
Bye!
----
Thanks for reading!
--- Rocco Caputo / rcaputo@cpan.org / poe.perl.org / poe.sourceforge.net
+-- Rocco Caputo / rcaputo@cpan.org / poe.perl.org
View
2  lib/POE.pm
@@ -7,7 +7,7 @@ use strict;
use Carp;
use vars qw($VERSION);
-$VERSION = '0.2503';
+$VERSION = '0.26';
sub import {
my $self = shift;
Please sign in to comment.
Something went wrong with that request. Please try again.