Updated SDL::Event docs

[sdlgit/SDL_perl.git] / lib / SDL / Event.pm

diff --git a/lib/SDL/Event.pm b/lib/SDL/Event.pm
index bbdb5e8..0501172 100644 (file)
--- a/lib/SDL/Event.pm
+++ b/lib/SDL/Event.pm
@@ -1,14 +1,39 @@
-#      Event.pm
+#!/usr/bin/env perl
 #
-#      A package for handling SDL_Event *
+# Event.pm
 #
-#      Copyright (C) 2000,2001,2002 David J. Goehrig
-#      Copyright (C) 2009 Kartik Thakore
-#      see the file COPYING for terms of use
+# Copyright (C) 2005 David J. Goehrig <dgoehrig@cpan.org>
+#
+# ------------------------------------------------------------------------------
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+# 
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+#
+# ------------------------------------------------------------------------------
+#
+# Please feel free to send questions, suggestions or improvements to:
+#
+#      David J. Goehrig
+#      dgoehrig@cpan.org
 #
 
 package SDL::Event;
+
 use strict;
+use warnings;
+use Carp;
+
 use SDL;
 
 sub new {
@@ -180,6 +205,8 @@ SDL::Event - a SDL perl extension
 
  use SDL::Event;
  my $event = new SDL::Event;             # create a new event
+ $event->pump();                        # pump all events from SDL Event Queue
+ $event->poll();                        # Get the top one from the queue
  while ($event->wait()) {
        my $type = $event->type();      # get event type
        # ... handle event
@@ -222,12 +249,8 @@ available.
 
 =head2 pump()
 
-Pumps the event loop, gathering events from the input devices.
-
 =head2 poll()
 
-Polls for currently pending events
-
 =head2 wait()
 
 Waits for an event end returns then. Always returns true.