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.247 by root, Sat Jul 18 22:24:17 2009 UTC vs.
Revision 1.250 by root, Mon Jul 20 07:12:38 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
… …
2313 2322
2314=item L<JSON> and L<JSON::XS> 2323=item L<JSON> and L<JSON::XS>
2315 2324
2316This module is required when you want to read or write JSON data via 2325This module is required when you want to read or write JSON data via
2317L<AnyEvent::Handle>. It is also written in pure-perl, but can take 2326L<AnyEvent::Handle>. It is also written in pure-perl, but can take
2318advantage of the ulta-high-speed L<JSON::XS> module when it is installed. 2327advantage of the ultra-high-speed L<JSON::XS> module when it is installed.
2319 2328
2320In fact, L<AnyEvent::Handle> will use L<JSON::XS> by default if it is 2329In fact, L<AnyEvent::Handle> will use L<JSON::XS> by default if it is
2321installed. 2330installed.
2322 2331
2323=item L<Net::SSLeay> 2332=item L<Net::SSLeay>

Diff Legend

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