ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libev/ev.pod
(Generate patch)

Comparing libev/ev.pod (file contents):
Revision 1.360 by root, Mon Jan 17 12:11:12 2011 UTC vs.
Revision 1.361 by root, Sun Jan 23 18:53:06 2011 UTC

1378 1378
1379Before a watcher can be registered with the event looop it has to be 1379Before a watcher can be registered with the event looop it has to be
1380initialised. This can be done with a call to C<ev_TYPE_init>, or calls to 1380initialised. This can be done with a call to C<ev_TYPE_init>, or calls to
1381C<ev_init> followed by the watcher-specific C<ev_TYPE_set> function. 1381C<ev_init> followed by the watcher-specific C<ev_TYPE_set> function.
1382 1382
1383In this state it is simply some block of memory that is suitable for use 1383In this state it is simply some block of memory that is suitable for
1384in an event loop. It can be moved around, freed, reused etc. at will. 1384use in an event loop. It can be moved around, freed, reused etc. at
1385will - as long as you either keep the memory contents intact, or call
1386C<ev_TYPE_init> again.
1385 1387
1386=item started/running/active 1388=item started/running/active
1387 1389
1388Once a watcher has been started with a call to C<ev_TYPE_start> it becomes 1390Once a watcher has been started with a call to C<ev_TYPE_start> it becomes
1389property of the event loop, and is actively waiting for events. While in 1391property of the event loop, and is actively waiting for events. While in
1417latter will clear any pending state the watcher might be in, regardless 1419latter will clear any pending state the watcher might be in, regardless
1418of whether it was active or not, so stopping a watcher explicitly before 1420of whether it was active or not, so stopping a watcher explicitly before
1419freeing it is often a good idea. 1421freeing it is often a good idea.
1420 1422
1421While stopped (and not pending) the watcher is essentially in the 1423While stopped (and not pending) the watcher is essentially in the
1422initialised state, that is it can be reused, moved, modified in any way 1424initialised state, that is, it can be reused, moved, modified in any way
1423you wish. 1425you wish (but when you trash the memory block, you need to C<ev_TYPE_init>
1426it again).
1424 1427
1425=back 1428=back
1426 1429
1427=head2 WATCHER PRIORITY MODELS 1430=head2 WATCHER PRIORITY MODELS
1428 1431

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines