Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Rely on POE::Test::Loops 1.021, which should be everywhere by now.

Update links in documentation.
  • Loading branch information...
commit eb6532b60f8b894b98558b9199343adbedb2b20b 1 parent f3b0b58
@rcaputo authored
Showing with 27 additions and 28 deletions.
  1. +26 −27 lib/POE.pm
  2. +1 −1  mylib/PoeBuildInfo.pm
View
53 lib/POE.pm
@@ -7,7 +7,7 @@ use strict;
use Carp qw( croak );
use vars qw($VERSION $REVISION);
-$VERSION = '1.006_90'; # NOTE - Should be #.### (three decimal places)
+$VERSION = '1.007'; # NOTE - Should be #.### (three decimal places)
$REVISION = do {my($r)=(q$Revision$=~/(\d+)/);sprintf"1.%04d",$r};
sub import {
@@ -72,7 +72,7 @@ __END__
=head1 NAME
-POE - portable multitasking and networking framework for Perl
+POE - portable multitasking and networking framework for any event loop
=head1 SYNOPSIS
@@ -117,27 +117,31 @@ POE is a framework for cooperative, event driven multitasking and
networking in Perl. Other languages have similar frameworks. Python
has Twisted. TCL has "the event loop".
-POE originally was developed as the core of a persistent object server
-and runtime environment. It has since evolved into something much
-more generic and widely useful.
-
POE provides a unified interface for several other event loops,
-including select(), L<IO::Poll|IO::Poll>, L<Glib>, L<Gtk>, L<Tk>, L<Wx>,
-L<Gtk2>, and so on.
-Check the CPAN for the full list of L<POE::Loop|POE::Loop> modules.
-
-POE is designed in layers, each building atop the lower level ones.
-Programs are free to use POE at any level of abstraction, and
+including select(), L<IO::Poll|IO::Poll>, L<Glib>, L<Gtk>, L<Tk>,
+L<Wx>, and L<Gtk2>. Many of these event loop interfaces were written
+by others, with the help of POE::Test::Loops. They may be found on
+the CPAN.
+
+POE achieves its its high degree of portability to different operating
+systems and Perl versions by being written entirely in Perl. CPAN
+hosts optional XS modules for POE if speed is more desirable than
+portability.
+
+POE is designed in layers. Each layer builds atop the lower level
+ones. Programs are free to use POE at any level of abstraction, and
different levels can be mixed and matched seamlessly within a single
-program.
+program. Remember, though, that higher-level abstractions often
+require more resources than lower-level ones. The conveniences they
+provide are not free.
POE's bundled abstraction layers are the tip of a growing iceberg.
-L<Sprocket>, L<POE::Stage|POE::Stage>, and other CPAN distributions build upon this
-work. You're encouraged to look around.
+L<Sprocket>, L<POE::Stage|POE::Stage>, and other CPAN distributions
+build upon this work. You're encouraged to look around.
No matter how high you go, though, it all boils down to calls to
-L<POE::Kernel|POE::Kernel>. So your down-to-earth code can easily cooperate
-with stratospheric systems.
+L<POE::Kernel|POE::Kernel>. So your down-to-earth code can easily
+cooperate with stratospheric systems.
=head2 Layer 1: Kernel and Sessions
@@ -462,10 +466,6 @@ an e-mail via his CPAN address.
Broken down by abstraction layer.
-TODO - Link to web resources.
-
-TODO - Verify this is complete.
-
=head2 Layer 1
L<POE::Kernel>, L<POE::Session>, L<POE::NFA>
@@ -504,20 +504,19 @@ L<POE::Resource::Sessions>, L<POE::Resource::Signals>
L<POE::Pipe>, L<POE::Pipe::OneWay>, L<POE::Pipe::TwoWay>
-=head1 BUGS
+=head2 Home Page
-The tests only cover about 70% of POE. Getting higher coverage is
-really hard.
+http://poe.perl.org/
-=head1 BUG TRACKER
+=head2 Bug Tracker
https://rt.cpan.org/Dist/Display.html?Status=Active&Queue=POE
-=head1 REPOSITORY
+=head2 Repository
https://poe.svn.sourceforge.net/svnroot/poe/trunk/poe
-=head1 OTHER RESOURCES
+=head2 Other Resources
http://search.cpan.org/dist/POE/
View
2  mylib/PoeBuildInfo.pm
@@ -27,7 +27,7 @@ use vars qw(@EXPORT_OK);
sub CONFIG_REQUIREMENTS () {
(
- "POE::Test::Loops" => 1.020,
+ "POE::Test::Loops" => 1.021,
)
}
Please sign in to comment.
Something went wrong with that request. Please try again.