Permalink
Browse files

Add deprecation warnings to Reflex::Handle and its subclasses.

  • Loading branch information...
rcaputo committed Jul 1, 2010
1 parent a6d52ce commit 156542b1d8bf595663a5e26ba7ee774098d80000
Showing with 29 additions and 0 deletions.
  1. +8 −0 lib/Reflex/Client.pm
  2. +8 −0 lib/Reflex/Connector.pm
  3. +5 −0 lib/Reflex/Handle.pm
  4. +8 −0 lib/Reflex/Listener.pm
View
@@ -120,6 +120,14 @@ eg/eg-35-tcp-client.pl available at the time of this writing.
=head1 DESCRIPTION
+Reflex::Client is scheduled for substantial changes. One of its base
+classes, Reflex::Handle, will be deprecated in favor of
+Reflex::Role::Readable and Reflex::Role::Writable. Hopefully
+Reflex::Client's interfaces won't change much as a result, but
+there are no guarantees.
+Your ideas and feedback for Reflex::Client's future implementation
+are welcome.
+
Reflex::Client is a high-level base class for non-blocking socket
clients. As with other Reflex::Base classes, this one may be
subclassed, composed with "has", or driven inline with promises.
View
@@ -142,6 +142,14 @@ eg/eg-38-promise-client.pl in the distribution.
=head1 DESCRIPTION
+Reflex::Connector is scheduled for substantial changes. Its base
+class, Reflex::Handle, will be deprecated in favor of
+Reflex::Role::Readable and Reflex::Role::Writable. Hopefully
+Reflex::Connector's interfaces won't change much as a result, but
+there are no guarantees.
+Your ideas and feedback for Reflex::Connector's future implementation
+are welcome.
+
Reflex::Connector performs a non-blocking connect() object on a plain
socket. It extends Reflex::Handle to wait for the connection without
blocking the rest of a program.
View
@@ -180,6 +180,11 @@ Reflex::Handle - Watch a filehandle for read- and/or writability.
=head1 DESCRIPTION
+Reflex::Handle is scheduled to be deprecated.
+Please see Reflex::Role::Readable and Reflex::Role::Writable, which
+allow the creation of read- and write-only classes.
+Your ideas and feedback for Reflex::Handle's replacement are welcome.
+
Reflex::Handle watches a filehandle and emits events when it has data
to be read, is ready to be written upon, or has some exceptional
condition to be addressed.
View
@@ -76,6 +76,14 @@ Reflex::Listener - Generate connected client sockets from a listening server soc
=head1 DESCRIPTION
+Reflex::Listener is scheduled for substantial changes. Its base
+class, Reflex::Handle, will be deprecated in favor of
+Reflex::Role::Readable and Reflex::Role::Writable. Hopefully
+Reflex::Listener's interfaces won't change much as a result, but
+there are no guarantees.
+Your ideas and feedback for Reflex::Listener's future implementation
+are welcome.
+
Reflex::Listener extends Reflex::Handle. It watches listening server
sockets for new client connections. When they arrive, it accept()s
them and emits them in "accepted" events.

0 comments on commit 156542b

Please sign in to comment.