--- AnyEvent/lib/AnyEvent.pm	2009/07/08 01:11:12	1.228
+++ AnyEvent/lib/AnyEvent.pm	2009/07/08 13:46:46	1.231
@@ -178,9 +178,9 @@
 You can create an I/O watcher by calling the C<< AnyEvent->io >> method
 with the following mandatory key-value pairs as arguments:
 
-C<fh> is the Perl I<file handle> (I<not> file descriptor, see below) to
-watch for events (AnyEvent might or might not keep a reference to this
-file handle). Note that only file handles pointing to things for which
+C<fh> is the Perl I<file handle> (or a naked file descriptor) to watch
+for events (AnyEvent might or might not keep a reference to this file
+handle). Note that only file handles pointing to things for which
 non-blocking operation makes sense are allowed. This includes sockets,
 most character devices, pipes, fifos and so on, but not for example files
 or block devices.
@@ -211,29 +211,6 @@
       undef $w;
    });
 
-=head3 GETTING A FILE HANDLE FROM A FILE DESCRIPTOR
-
-It is not uncommon to only have a file descriptor, while AnyEvent requires
-a Perl file handle.
-
-There are basically two methods to convert a file descriptor into a file handle. If you own
-the file descriptor, you can open it with C<&=>, as in:
-
-   open my $fh, "<&=$fileno" or die "xxx: §!";
-
-This will "own" the file descriptor, meaning that when C<$fh> is
-destroyed, it will automatically close the C<$fileno>. Also, note that
-the open mode (read, write, read/write) must correspond with how the
-underlying file descriptor was opened.
-
-In many cases, taking over the file descriptor is now what you want, in
-which case the only alternative is to dup the file descriptor:
-
-   open my $fh, "<&$fileno" or die "xxx: $!";
-
-This has the advantage of not closing the file descriptor and the
-disadvantage of making a slow copy.
-
 =head2 TIME WATCHERS
 
 You can create a time watcher by calling the C<< AnyEvent->timer >>
@@ -893,9 +870,9 @@
 =head1 OTHER MODULES
 
 The following is a non-exhaustive list of additional modules that use
-AnyEvent and can therefore be mixed easily with other AnyEvent modules
-in the same program. Some of the modules come with AnyEvent, some are
-available via CPAN.
+AnyEvent as a client and can therefore be mixed easily with other AnyEvent
+modules and other event loops in the same program. Some of the modules
+come with AnyEvent, most are available via CPAN.
 
 =over 4
 
@@ -914,7 +891,7 @@
 
 Provide read and write buffers, manages watchers for reads and writes,
 supports raw and formatted I/O, I/O queued and fully transparent and
-non-blocking SSL/TLS.
+non-blocking SSL/TLS (via L<AnyEvent::TLS>.
 
 =item L<AnyEvent::DNS>
 
@@ -952,18 +929,19 @@
 
 A non-blocking interface to gpsd, a daemon delivering GPS information.
 
-=item L<AnyEvent::IGS>
-
-A non-blocking interface to the Internet Go Server protocol (used by
-L<App::IGS>).
-
 =item L<AnyEvent::IRC>
 
 AnyEvent based IRC client module family (replacing the older Net::IRC3).
 
-=item L<Net::XMPP2>
+=item L<AnyEvent::XMPP>
+
+AnyEvent based XMPP (Jabber protocol) module family (replacing the older
+Net::XMPP2>.
+
+=item L<AnyEvent::IGS>
 
-AnyEvent based XMPP (Jabber protocol) module family.
+A non-blocking interface to the Internet Go Server protocol (used by
+L<App::IGS>).
 
 =item L<Net::FCP>
 
@@ -978,10 +956,6 @@
 
 Has special support for AnyEvent via L<Coro::AnyEvent>.
 
-=item L<IO::Lambda>
-
-The lambda approach to I/O - don't ask, look there. Can use AnyEvent.
-
 =back
 
 =cut
@@ -993,7 +967,7 @@
 
 use Carp;
 
-our $VERSION = 4.8;
+our $VERSION = 4.801;
 our $MODEL;
 
 our $AUTOLOAD;
@@ -1148,12 +1122,10 @@
    my ($poll, $fh, $r, $w) = @_;
 
    # cygwin requires the fh mode to be matching, unix doesn't
-   my ($rw, $mode) = $poll eq "r" ? ($r, "<")
-                   : $poll eq "w" ? ($w, ">")
-                   : Carp::croak "AnyEvent->io requires poll set to either 'r' or 'w'";
+   my ($rw, $mode) = $poll eq "r" ? ($r, "<") : ($w, ">");
 
-   open my $fh2, "$mode&" . fileno $fh
-      or die "cannot dup() filehandle: $!,";
+   open my $fh2, "$mode&", $fh
+      or die "AnyEvent->io: cannot dup() filehandle in mode '$poll': $!,";
 
    # we assume CLOEXEC is already set by perl in all important cases
 
@@ -2146,16 +2118,18 @@
 Implementations: L<AnyEvent::Impl::EV>, L<AnyEvent::Impl::Event>,
 L<AnyEvent::Impl::Glib>, L<AnyEvent::Impl::Tk>, L<AnyEvent::Impl::Perl>,
 L<AnyEvent::Impl::EventLib>, L<AnyEvent::Impl::Qt>,
-L<AnyEvent::Impl::POE>.
+L<AnyEvent::Impl::POE>, L<AnyEvent::Impl::IOAsync>.
 
 Non-blocking file handles, sockets, TCP clients and
-servers: L<AnyEvent::Handle>, L<AnyEvent::Socket>.
+servers: L<AnyEvent::Handle>, L<AnyEvent::Socket>, L<AnyEvent::TLS>.
 
 Asynchronous DNS: L<AnyEvent::DNS>.
 
-Coroutine support: L<Coro>, L<Coro::AnyEvent>, L<Coro::EV>, L<Coro::Event>,
+Coroutine support: L<Coro>, L<Coro::AnyEvent>, L<Coro::EV>,
+L<Coro::Event>,
 
-Nontrivial usage examples: L<Net::FCP>, L<Net::XMPP2>, L<AnyEvent::DNS>.
+Nontrivial usage examples: L<AnyEvent::GPSD>, L<AnyEvent::XMPP>,
+L<AnyEvent::HTTP>.
 
 
 =head1 AUTHOR