--- AnyEvent/lib/AnyEvent.pm	2006/01/08 04:48:52	1.9
+++ AnyEvent/lib/AnyEvent.pm	2006/07/20 08:26:00	1.13
@@ -46,7 +46,7 @@
 =head1 DESCRIPTION
 
 L<AnyEvent> provides an identical interface to multiple event loops. This
-allows module authors to utilizy an event loop without forcing module
+allows module authors to utilise an event loop without forcing module
 users to use the same event loop (as only a single event loop can coexist
 peacefully at any one time).
 
@@ -70,7 +70,7 @@
 use strict 'vars';
 use Carp;
 
-our $VERSION = '1.01';
+our $VERSION = '1.02';
 our $MODEL;
 
 our $AUTOLOAD;
@@ -137,7 +137,7 @@
 
 If you need to support another event library which isn't directly
 supported by AnyEvent, you can supply your own interface to it by
-pushing, before the first watch gets created, the package name of
+pushing, before the first watcher gets created, the package name of
 the event module and the package name of the interface to use onto
 C<@AnyEvent::REGISTRY>. You can do that before and even without loading
 AnyEvent.
@@ -146,17 +146,27 @@
 
    push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
 
-This tells AnyEvent to (literally) use the C<urxvt::anyevent::> module
-when it finds the C<urxvt> module is loaded. When AnyEvent is loaded and
-requested to find a suitable event model, it will first check for the
-urxvt module.
+This tells AnyEvent to (literally) use the C<urxvt::anyevent::>
+package/class when it finds the C<urxvt> package/module is loaded. When
+AnyEvent is loaded and asked to find a suitable event model, it will
+first check for the presence of urxvt.
+
+The class should prove implementations for all watcher types (see
+L<AnyEvent::Impl::Event> (source code), L<AnyEvent::Impl::Glib>
+(Source code) and so on for actual examples, use C<perldoc -m
+AnyEvent::Impl::Glib> to see the sources).
 
-The above isn't fictitious, the I<rxvt-unicode> (a.k.a. urxvt) uses
-the above line exactly. An interface isn't included in AnyEvent
+The above isn't fictitious, the I<rxvt-unicode> (a.k.a. urxvt)
+uses the above line as-is. An interface isn't included in AnyEvent
 because it doesn't make sense outside the embedded interpreter inside
 I<rxvt-unicode>, and it is updated and maintained as part of the
 I<rxvt-unicode> distribution.
 
+I<rxvt-unicode> also cheats a bit by not providing blocking access to
+condition variables: code blocking while waiting for a condition will
+C<die>. This still works with most modules/usages, and blocking calls must
+not be in an interactive appliation, so it makes sense.
+
 =head1 ENVIRONMENT VARIABLES
 
 The following environment variables are used by this module: