--- IO-AIO/AIO.pm	2009/06/14 20:36:59	1.155
+++ IO-AIO/AIO.pm	2009/06/16 23:41:59	1.156
@@ -32,7 +32,7 @@
  use AnyEvent::AIO;
 
  # EV integration
- my $w = EV::io IO::AIO::poll_fileno, EV::READ, \&IO::AIO::poll_cb;
+ my $aio_w = EV::io IO::AIO::poll_fileno, EV::READ, \&IO::AIO::poll_cb;
 
  # Event integration
  Event->io (fd => IO::AIO::poll_fileno,
@@ -54,7 +54,8 @@
 =head1 DESCRIPTION
 
 This module implements asynchronous I/O using whatever means your
-operating system supports.
+operating system supports. It is implemented as an interface to C<libeio>
+(L<http://software.schmorp.de/pkg/libeio.html>).
 
 Asynchronous means that operations that can normally block your program
 (e.g. reading from disk) will be done asynchronously: the operation
@@ -68,8 +69,8 @@
 
 While most of this works on all types of file descriptors (for
 example sockets), using these functions on file descriptors that
-support nonblocking operation (again, sockets, pipes etc.) is very
-inefficient. Use an event loop for that (such as the L<Event|Event>
+support nonblocking operation (again, sockets, pipes etc.) is
+very inefficient. Use an event loop for that (such as the L<EV>
 module): IO::AIO will naturally fit into such an event loop itself.
 
 In this version, a number of threads are started that execute your
@@ -89,17 +90,15 @@
 
 =head2 EXAMPLE
 
-This is a simple example that uses the Event module and loads
+This is a simple example that uses the EV module and loads
 F</etc/passwd> asynchronously:
 
    use Fcntl;
-   use Event;
+   use EV;
    use IO::AIO;
 
-   # register the IO::AIO callback with Event
-   Event->io (fd => IO::AIO::poll_fileno,
-              poll => 'r',
-              cb => \&IO::AIO::poll_cb);
+   # register the IO::AIO callback with EV
+   my $aio_w = EV::io IO::AIO::poll_fileno, EV::READ, \&IO::AIO::poll_cb;
 
    # queue the request to open /etc/passwd
    aio_open "/etc/passwd", O_RDONLY, 0, sub {
@@ -121,7 +120,7 @@
          print $contents;
 
          # exit event loop and program
-         Event::unloop;
+         EV::unloop;
       };
    };
 
@@ -129,7 +128,7 @@
    # check for sockets etc. etc.
 
    # process events as long as there are some:
-   Event::loop;
+   EV::loop;
 
 =head1 REQUEST ANATOMY AND LIFETIME
 
@@ -1210,9 +1209,9 @@
 =item $fileno = IO::AIO::poll_fileno
 
 Return the I<request result pipe file descriptor>. This filehandle must be
-polled for reading by some mechanism outside this module (e.g. Event or
-select, see below or the SYNOPSIS). If the pipe becomes readable you have
-to call C<poll_cb> to check the results.
+polled for reading by some mechanism outside this module (e.g. EV, Glib,
+select and so on, see below or the SYNOPSIS). If the pipe becomes readable
+you have to call C<poll_cb> to check the results.
 
 See C<poll_cb> for an example.
 
@@ -1229,7 +1228,8 @@
 do anything special to have it called later.
 
 Example: Install an Event watcher that automatically calls
-IO::AIO::poll_cb with high priority:
+IO::AIO::poll_cb with high priority (more examples can be found in the
+SYNOPSIS section, at the top of this document):
 
    Event->io (fd => IO::AIO::poll_fileno,
               poll => 'r', async => 1,