Debian Codegraph @

README

raw
1 NAME
2 Acme::POE::Knee - Time sliced pony race using the POE kernel.
3
4 VERSION
5 version 1.12
6
7 SYNOPSIS
8 #!/usr/bin/perl -w
9 use strict;
10
11 # Use POEny!
12 use Acme::POE::Knee;
13
14 # Every Acme::POE::Knee race will require a set of arguments.
15 # There are defaults but it's just more fun to set these
16 # yourselves. We set a distance the ponies must run and of course
17 # we name our race ponies! You'll have to specify the maximum
18 # delay a pony can have before reaching the next stage.
19 # The lower the delay, the higher the chances are the pony will
20 # win the race.
21
22 my $pony = new Acme::POE::Knee (
23 dist => 20,
24 ponies => {
25 'dngor' => 5,
26 'Abigail' => 5.2,
27 'Co-Kane' => 5.4,
28 'MJD' => 5.6,
29 'acme' => 5.8,
30 },
31 );
32
33 # start the race
34 $pony->race( );
35
36 exit;
37
38 DESCRIPTION
39 POE::Knee is an acronym of "Pony". We all like ponies. And wouldn't we
40 love to race ponies? Well, that's what Acme::POE::Knee is for!
41
42 It's great for those friday afternoons at the office, where you wonder
43 who will pay the beer tab. Whoever 'wins' the race, loses!
44
45 You specify a distance the ponies must run, and a maximum delay before
46 the pony will reach the next step. So, the bigger the delay, the bigger
47 the distance between multiple ponies can be.
48
49 Of course this wouldn't be any fun if we couldn't name the ponies
50 ourselves. Here, we simply put all our race ponies in an array reference
51 and the Acme::POE::Knee module will take care of the rest.
52
53 QUICK LINKS
54 Please see the samples directory in POE's distribution for several
55 well-commented sample and tutorial programs.
56
57 Please see <http://www.perl.com/pub/2001/01/poe.html> for an excellent,
58 and more importantly: gradual, introduction to POE.
59
60 USING Acme::POE::Knee
61 Using Acme::POE::Knee is really easy. This simple progam would already
62 suffice:
63
64 use strict;
65 use Acme::POE::Knee;
66
67 my $pony = new Acme::POE::Knee;
68 $pony->race();
69 exit;
70
71 This will use the defaults of the POE::Knee module, but you can of
72 course specify your own arguments, as shown in the synopsis.
73
74 The Use of Acme::POE::Knee
75 Use, yes... Usefull? Probably not. This was written in response to a
76 rather persistant meme on #perl (you know who you are!). Basicly, we all
77 wanted ponies. Well folks, here it is.
78
79 Its source might be interesting to look at for newcomers to POE to see
80 how this time slicing works.
81
82 Learning more about POE
83 The POE Mailing List
84 POE has a mailing list at perl.org. You can receive subscription
85 information by sending e-mail:
86
87 To: [email protected]
88 Subject: (anything will do)
89
90 The message body is ignored.
91
92 All forms of feedback are welcome.
93
94 The POE Web Site
95 POE has a web site where the latest development snapshot, along with
96 the Changes file and other stuff may be found: <http://poe.perl.org/>
97
98 AUTHORS
99 * Jos Boumans <[email protected]>
100
101 * Rocco Caputo <[email protected]>
102
103 COPYRIGHT AND LICENSE
104 This software is copyright (c) 2011 by Jos Boumans.
105
106 This is free software; you can redistribute it and/or modify it under
107 the same terms as the Perl 5 programming language system itself.
108