ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/lib/AnyEvent.pm
(Generate patch)

Comparing AnyEvent/lib/AnyEvent.pm (file contents):
Revision 1.248 by root, Sat Jul 18 22:27:10 2009 UTC vs.
Revision 1.251 by root, Mon Jul 20 22:39:57 2009 UTC

1=head1 NAME 1=head1 NAME
2 2
3AnyEvent - provide framework for multiple event loops 3AnyEvent - events independent of event loop implementation
4 4
5EV, Event, Glib, Tk, Perl, Event::Lib, Qt and POE are various supported 5EV, Event, Glib, Tk, Perl, Event::Lib, Qt and POE are various supported
6event loops. 6event loops.
7 7
8=head1 SYNOPSIS 8=head1 SYNOPSIS
… …
40=head1 INTRODUCTION/TUTORIAL 40=head1 INTRODUCTION/TUTORIAL
41 41
42This manpage is mainly a reference manual. If you are interested 42This manpage is mainly a reference manual. If you are interested
43in a tutorial or some gentle introduction, have a look at the 43in a tutorial or some gentle introduction, have a look at the
44L<AnyEvent::Intro> manpage. 44L<AnyEvent::Intro> manpage.
45
46=head1 SUPPORT
47
48There is a mailinglist for discussing all things AnyEvent, and an IRC
49channel, too.
50
51See the AnyEvent project page at the B<Schmorpforge Ta-Sa Software
52Respository>, at L<http://anyevent.schmorp.de>, for more info.
45 53
46=head1 WHY YOU SHOULD USE THIS MODULE (OR NOT) 54=head1 WHY YOU SHOULD USE THIS MODULE (OR NOT)
47 55
48Glib, POE, IO::Async, Event... CPAN offers event models by the dozen 56Glib, POE, IO::Async, Event... CPAN offers event models by the dozen
49nowadays. So what is different about AnyEvent? 57nowadays. So what is different about AnyEvent?
… …
509Condition variables are similar to callbacks, except that you can 517Condition variables are similar to callbacks, except that you can
510optionally wait for them. They can also be called merge points - points 518optionally wait for them. They can also be called merge points - points
511in time where multiple outstanding events have been processed. And yet 519in time where multiple outstanding events have been processed. And yet
512another way to call them is transactions - each condition variable can be 520another way to call them is transactions - each condition variable can be
513used to represent a transaction, which finishes at some point and delivers 521used to represent a transaction, which finishes at some point and delivers
514a result. 522a result. And yet some people know them as "futures" - a promise to
523compute/deliver something that you can wait for.
515 524
516Condition variables are very useful to signal that something has finished, 525Condition variables are very useful to signal that something has finished,
517for example, if you write a module that does asynchronous http requests, 526for example, if you write a module that does asynchronous http requests,
518then a condition variable would be the ideal candidate to signal the 527then a condition variable would be the ideal candidate to signal the
519availability of results. The user can either act when the callback is 528availability of results. The user can either act when the callback is
… …
1058 1067
1059BEGIN { AnyEvent::common_sense } 1068BEGIN { AnyEvent::common_sense }
1060 1069
1061use Carp (); 1070use Carp ();
1062 1071
1063our $VERSION = 4.85; 1072our $VERSION = 4.86;
1064our $MODEL; 1073our $MODEL;
1065 1074
1066our $AUTOLOAD; 1075our $AUTOLOAD;
1067our @ISA; 1076our @ISA;
1068 1077

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines