CPAN Rel v2.2.3
Kartik Thakore [Tue, 29 Sep 2009 15:46:06 +0000 (11:46 -0400)]
Build.PL
CHANGELOG
README
lib/SDL.pm

index 17aeb1c..525de84 100644 (file)
--- a/Build.PL
+++ b/Build.PL
@@ -127,11 +127,14 @@ my $build   = SDL::Build->new(
        dist_name            => 'SDL_Perl', 
        license              => 'lgpl',
        dist_version_from    => 'lib/SDL.pm',
-       build_requires       =>
+       requires              =>
        {
+               'Module::Build' => '0.27',
+               'Alien::SDL' => '0.7',
                'Test::Simple' => '0.47',
-               'Module::Build' => '0.22',
-               'YAML'  => '0.68'
+               'YAML'  => '0.68',
+               'ExtUtils::CBuilder' => '0.260301'
+
        },
        build_recommends     =>
        {
@@ -141,12 +144,6 @@ my $build   = SDL::Build->new(
        xs_files             => \%xs,
        meta_add             =>      
        {
-       configure_requires =>
-       {
-               'Alien::SDL'    => '0.06',
-               'ExtUtils::CBuilder' => '0.260301'
-       },
-
                no_index =>  { file => [ <make/lib/SDL/*.pm>, <make/lib/SDL/Build/*.pm>, <make/lib/ExtUtils/CBuilder/*>, <make/lib/ExtUtils/*>, <make/lib/ExtUtils/CBuilder/Platform/Windows.pm> ] },
        },
        dist_author          => 'David J. Goehrig <DGOEHRIG@cpan.org>',
index 092b186..eb09298 100644 (file)
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,5 +1,9 @@
 Revision history for Perl extension SDL_perl.
 
+* v2.2.3 Sept 29 2009 Kartik Thakore <thakore.kartik@gmail.com>
+       - More Docs
+       - Experimental Mac version
+
 * Sept 11 2009 Kartik Thakore <thakore.kartik@gmail.com>
        - Moved Debian patches upstream
        - http://packages.debian.org/changelogs/pool/main/s/sdlperl/current/changelog
diff --git a/README b/README
index 4492373..65a6042 100644 (file)
--- a/README
+++ b/README
@@ -1,97 +1,52 @@
-README for SDL_Perl-2.2.2
+NAME
+    SDL_perl - Simple DirectMedia Layer for Perl
 
-What's New in 2.2.2:
+SYNOPSIS
+      use SDL;
 
-SDL_Perl-2.2.2
+DESCRIPTION
+    SDL_perl is a package of perl modules that provides both functional and
+    object orient interfaces to the Simple DirectMedia Layer for Perl 5.
+    This package does take some liberties with the SDL API, and attempts to
+    adhere to the spirit of both the SDL and Perl. This document describes
+    the low-level functional SDL_perl API. For the object oriented
+    programming interface please see the documentation provided on a per
+    class basis.
 
-       -Made App loop() faster https://rt.cpan.org/Public/Bug/Display.html?id=16988
-       -Patched support for add support for gluquadric* sub https://rt.cpan.org/Public/Bug/Display.html?id=25598
-       -Made App init slimer https://rt.cpan.org/Public/Bug/Display.html?id=16987
-       -Added faster SDL::Color alternative https://rt.cpan.org/Public/Bug/Display.html?id=17975
-       -Added better error reporting for TTFont errors
-       -Added win32 support https://rt.cpan.org/Ticket/Display.html?id=49003
-       
+The SDL Perl 2009 Development Team
+  Documentation
+            Nick: magnet
 
-Prerequisites:
+  Perl Development
+            Nick: Garu
+            Name: Breno G. de Oliveira
+            
+        Nick: Dngor
+            Name: Rocco Caputo
 
-SDL Perl recommends installing the following libraries available
-from http://www.libsdl.org/ prior to installing:
+            Nick: nferraz
+            Name: Nelson Ferraz
 
-       SDL-1.2.8
-       
-       Recommended:
-       SDL_image
-       SDL_mixer
-       SDL_ttf
-       smpeg
+  Maintainance
+            Nick: kthakore
 
-       Optional Libraries:
-       *SDL_gfx
-       *SDL_sound
-       *SDL_net
-       *SDL_svg
-       *SDL_vnc
+            Name: Kartik Thakore
 
-Additionally the following Perl modules should be installed:
-       
-       Alien-SDL-0.2
-       Module-Build-0.22
-       Test-Simple-0.62
+MacOSX Experimental Usage
+    Please get libsdl packages from Fink
 
-Installation:
+            perl Build.PL
+            perl Build test
+            perl Build Bundle
+            perl Build install
 
-       perl Build.PL
-       ./Build
-       ./Build test
-       ./Build bundle  # MacOS X only!
-       ./Build install
+  Running SDL Perl Scripts in MacOSX
+    First set the PERL5LIB environment variable to the dependencies of your
+    script
 
-Installation with Windows (Strawberry) :
+            %export PERL5LIB=$PERL5LIB:./lib
 
-       perl Build.PL
-       ./Build
-       ./Build test
-       ./Build install
+    Use the SDLPerl executable made in the bundle and call your scripts
 
+            %SDLPerl.app/Contents/MacOS/SDLPerl yourScript.pl
 
-The build process will use the new Module::Build facility
-to auto detect and build SDL Perl for your platform.  If
-the build fails please forward bugs to sdl-devel@perl.org.
-
-For MacOS X users there is a new experimental bundle, 
-that is called SDLPerl.app.  You can use this bundle
-to run perl scripts with a .spl extension, you know,
-SDL Perl files.  We will work on brining this style 
-launcher and an integrated development environment to
-all platforms shortly.
-
-Documentation:
-
-Each module now includes its own documentation, and 
-is accessible through perldoc.  Additional tutorials,
-code, and tips can be found at the website:
-
-       http://sdl.perl.org
-
-Online documentation and tutorials are available through
-perldoc module.  
-
-Contributing:
-
-Anyone wishing to contribute modules, sprite engines, documentation,
-and anything else that others might find useful, please join
-the mailing list:
-
-       sdl-devel@perl.org
-
-This is a mailing list for those interested in SDLperl development,
-both as an applications developer, and as a core contributor.
-
-I am always more than happy to take patches, bug reports, and
-helpful suggestions.  It is feedback, both good and poor, that
-keeps projects like this going.
-
-Enjoy,
-
-David J. Goehrig <dgoehrig@cpan.org>
-Kartik Thakore <kthakore@cpan.org>
index 97d65b1..8e7771a 100644 (file)
@@ -3,7 +3,7 @@
 # SDL.pm
 #
 # Copyright (C) 2005 David J. Goehrig <dgoehrig@cpan.org>
-#
+# Copyright (C) 2009 Kartik Thakore   <kthakore@cpan.org>
 # ------------------------------------------------------------------------------
 #
 # This library is free software; you can redistribute it and/or
@@ -24,8 +24,8 @@
 #
 # Please feel free to send questions, suggestions or improvements to:
 #
-#      David J. Goehrig
-#      dgoehrig@cpan.org
+#      Kartik Thakore
+#      kthakore@cpan.org
 #
 
 package SDL;
@@ -54,7 +54,7 @@ sub import {
   $self->export_to_level(1, @_);
   SDL::Constants->export_to_level(1);
 }
-$VERSION = '2.2.2.17';
+$VERSION = '2.2.3';
 
 print "$VERSION" if (defined($ARGV[0]) && ($ARGV[0] eq '--SDLperl'));
 
@@ -101,6 +101,50 @@ and Perl.  This document describes the low-level functional SDL_perl API.  For t
 object oriented programming interface please see the documentation provided on a
 per class basis.
 
+=head1 The SDL Perl 2009 Development Team
+
+=head2 Documentation
+
+       Nick: magnet
+
+=head2 Perl Development
+
+       Nick: Garu
+       Name: Breno G. de Oliveira
+       
+       Nick: Dngor
+       Name: Rocco Caputo
+
+       Nick: nferraz
+       Name: Nelson Ferraz
+
+=head2 Maintainance 
+       
+       Nick: kthakore
+
+       Name: Kartik Thakore
+
+=head1 MacOSX Experimental Usage
+
+Please get libsdl packages from Fink
+       
+       perl Build.PL
+       perl Build test
+       perl Build Bundle
+       perl Build install
+
+=head2 Running SDL Perl Scripts in MacOSX
+
+First set the PERL5LIB environment variable to the dependencies of your script
+       
+       %export PERL5LIB=$PERL5LIB:./lib
+
+Use the SDLPerl executable made in the bundle and call your scripts
+
+       %SDLPerl.app/Contents/MacOS/SDLPerl yourScript.pl
+
+=head1 Functions exported by SDL.pm
+
 =head2 Init(flags) 
 
 As with the C language API, SDL_perl initializes the SDL environment through