X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=65a60426038e337ca52e16f663d2d3027733b24a;hb=HEAD;hp=cd87cf572d8d6f606ecdf65e8cb31ad92a830eb2;hpb=7b6a53a1f5064ca5b8ab0243f7bcf6209e6bf5a4;p=sdlgit%2FSDL_perl.git diff --git a/README b/README index cd87cf5..65a6042 100644 --- a/README +++ b/README @@ -1,72 +1,52 @@ -README for SDL_Perl-2.2.0 +NAME + SDL_perl - Simple DirectMedia Layer for Perl -What's New in 2.2.0: +SYNOPSIS + use SDL; -SDL_Perl-2.2.0 adds support for a few new modules, fixes a few more -bugs, and improves the error handling of the object layer. Additional -support for SDL_sound, SDL_svg, and SDL_vnc has been added. In the -OO layer, all constructors now die when they fail to construct an object -with a valid underlying datastructure pointer. +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. -Prerequisites: +The SDL Perl 2009 Development Team + Documentation + Nick: magnet -SDL Perl recommends installing the following libraries available -from http://www.libsdl.org/ prior to installing: + Perl Development + Nick: Garu + Name: Breno G. de Oliveira + + Nick: Dngor + Name: Rocco Caputo - SDL-1.2.8 - smpeg-0.4.5 - SDL_image-1.2.4 - SDL_mixer-1.2.6 - SDL_sound-1.0.1 - SDL_net-1.2.5 - SDL_gfx-2.0.13 - SDL_ttf-2.0.7 - SDL_svg-1.1.9 - SDL_vnc-1.0.0 + Nick: nferraz + Name: Nelson Ferraz -Additionally the following Perl modules should be installed: + Maintainance + Nick: kthakore - Module-Build-0.22 - Test-Simple-0.62 + Name: Kartik Thakore -Installation: +MacOSX Experimental Usage + Please get libsdl packages from Fink - perl Build.PL - ./Build - ./Build test - ./Build install + perl Build.PL + perl Build test + perl Build Bundle + perl Build install -The build process will use the new Module::Build facility -to autodetect and build SDL Perl for your platform. If -the build fails please forward bugs to sdl-devel@perl.org. + Running SDL Perl Scripts in MacOSX + First set the PERL5LIB environment variable to the dependencies of your + script -Documentation: + %export PERL5LIB=$PERL5LIB:./lib -Each module now includes its own documentation, and -is accessible through perldoc. Additional tutorials, -code, and tips can be found at the website: + Use the SDLPerl executable made in the bundle and call your scripts - 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 + %SDLPerl.app/Contents/MacOS/SDLPerl yourScript.pl