Re: PATCH: documentation improvements

On Sun, 2004-11-28 at 16:45 +0000, Zefram wrote:
> @@ -166,10 +217,16 @@
>  
>  Activate the watcher.  Watchers refuse to C<start()> without
>  sufficient configuration information to generate events.  Constructors
> -always invoke C<start()> unless the C<parked=>1> option is requested.
> +always invoke C<start()> unless the C<< parked=>1 >> option is requested.
>  You will need to set the parked option if you preallocate unconfigured
>  watchers.
>  
> +Note that this does not check for unreified asynchronous events.
> +If you are starting a signal watcher, it may therefore see and
> +act on signals that were actually received before it was started.
> +Call C<Event::_queue_pending()> immediately before starting a signal
> +watcher if you need to avoid this.

Huh?  Can you prove this?  If so then it's a bug.

As far as I can tell from the code, signal counting starts when the
watcher is started.  When the watcher is stopped, any pending counted
signals are zero'd.

-- 
A new cognitive theory of emotion, http://openheartlogic.org

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQBBquqgqcqnlKSmC70RAsGXAJ4+usuP8STqHXAZwO+koEtDgpJcJACfVE6n
TGH6zGrNgq17LIkV+UR0GoE=
=tCnb
-----END PGP SIGNATURE-----