--- AnyEvent/lib/AnyEvent.pm	2009/06/29 21:00:32	1.223
+++ AnyEvent/lib/AnyEvent.pm	2009/07/08 13:46:46	1.231
@@ -178,7 +178,7 @@
 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) to watch
+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,
@@ -870,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
 
@@ -891,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>
 
@@ -929,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.
+AnyEvent based XMPP (Jabber protocol) module family (replacing the older
+Net::XMPP2>.
+
+=item L<AnyEvent::IGS>
+
+A non-blocking interface to the Internet Go Server protocol (used by
+L<App::IGS>).
 
 =item L<Net::FCP>
 
@@ -955,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
@@ -970,7 +967,7 @@
 
 use Carp;
 
-our $VERSION = 4.45;
+our $VERSION = 4.801;
 our $MODEL;
 
 our $AUTOLOAD;
@@ -1125,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
 
@@ -1473,6 +1468,25 @@
 The maximum number of child processes that C<AnyEvent::Util::fork_call>
 will create in parallel.
 
+=item C<PERL_ANYEVENT_MAX_OUTSTANDING_DNS>
+
+The default value for the C<max_outstanding> parameter for the default DNS
+resolver - this is the maximum number of parallel DNS requests that are
+sent to the DNS server.
+
+=item C<PERL_ANYEVENT_RESOLV_CONF>
+
+The file to use instead of F</etc/resolv.conf> (or OS-specific
+configuration) in the default resolver. When set to the empty string, no
+default config will be used.
+
+=item C<PERL_ANYEVENT_CA_FILE>, C<PERL_ANYEVENT_CA_PATH>.
+
+When neither C<ca_file> nor C<ca_path> was specified during
+L<AnyEvent::TLS> context creation, and either of these environment
+variables exist, they will be used to specify CA certificate locations
+instead of a system-dependent default.
+
 =back
 
 =head1 SUPPLYING YOUR OWN EVENT MODEL INTERFACE
@@ -2104,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