[sdlgit/SDL_perl.git] / README

README for SDL_Perl-2.2.2

What's New in 2.2.2:

SDL_Perl-2.2.2

	-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
	

Prerequisites:

SDL Perl recommends installing the following libraries available
from http://www.libsdl.org/ prior to installing:

	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

Additionally the following Perl modules should be installed:

	Module-Build-0.22
	Test-Simple-0.62

Installation:

	perl Build.PL
	./Build
	./Build test
	./Build bundle	# MacOS X only!
	./Build install

Installation with Windows + MinGW:

	set SDL_INST_DIR=Absolute/Path/to/SDLdir
	perl Build.PL
	./Build
	./Build test
	./Build install


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>
Commit	Line	Data
57450fae	1	README for SDL_Perl-2.2.2
bfd90409	2
57450fae	3	What's New in 2.2.2:
bfd90409	4
57450fae	5	SDL_Perl-2.2.2
	6
	7	-Made App loop() faster https://rt.cpan.org/Public/Bug/Display.html?id=16988
	8	-Patched support for add support for gluquadric* sub https://rt.cpan.org/Public/Bug/Display.html?id=25598
	9	-Made App init slimer https://rt.cpan.org/Public/Bug/Display.html?id=16987
	10	-Added faster SDL::Color alternative https://rt.cpan.org/Public/Bug/Display.html?id=17975
	11	-Added better error reporting for TTFont errors
	12	-Added win32 support https://rt.cpan.org/Ticket/Display.html?id=49003
	13
bfd90409	14
	15	Prerequisites:
	16
	17	SDL Perl recommends installing the following libraries available
	18	from http://www.libsdl.org/ prior to installing:
	19
	20	SDL-1.2.8
	21	smpeg-0.4.5
	22	SDL_image-1.2.4
	23	SDL_mixer-1.2.6
	24	SDL_sound-1.0.1
	25	SDL_net-1.2.5
	26	SDL_gfx-2.0.13
	27	SDL_ttf-2.0.7
	28	SDL_svg-1.1.9
	29	SDL_vnc-1.0.0
	30
	31	Additionally the following Perl modules should be installed:
	32
	33	Module-Build-0.22
	34	Test-Simple-0.62
	35
	36	Installation:
	37
	38	perl Build.PL
	39	./Build
	40	./Build test
8c726daf	41	./Build bundle # MacOS X only!
bfd90409	42	./Build install
bfd90409	43
1e93f803	44	Installation with Windows + MinGW:
	45
	46	set SDL_INST_DIR=Absolute/Path/to/SDLdir
	47	perl Build.PL
	48	./Build
	49	./Build test
	50	./Build install
	51
	52
bfd90409	53	The build process will use the new Module::Build facility
1e93f803	54	to auto detect and build SDL Perl for your platform. If
bfd90409	55	the build fails please forward bugs to sdl-devel@perl.org.
bfd90409	56
8c726daf	57	For MacOS X users there is a new experimental bundle,
	58	that is called SDLPerl.app. You can use this bundle
	59	to run perl scripts with a .spl extension, you know,
	60	SDL Perl files. We will work on brining this style
	61	launcher and an integrated development environment to
	62	all platforms shortly.
	63
bfd90409	64	Documentation:
	65
	66	Each module now includes its own documentation, and
	67	is accessible through perldoc. Additional tutorials,
	68	code, and tips can be found at the website:
	69
	70	http://sdl.perl.org
	71
	72	Online documentation and tutorials are available through
	73	perldoc module.
	74
	75	Contributing:
	76
	77	Anyone wishing to contribute modules, sprite engines, documentation,
	78	and anything else that others might find useful, please join
	79	the mailing list:
	80
	81	sdl-devel@perl.org
	82
	83	This is a mailing list for those interested in SDLperl development,
	84	both as an applications developer, and as a core contributor.
	85
	86	I am always more than happy to take patches, bug reports, and
	87	helpful suggestions. It is feedback, both good and poor, that
	88	keeps projects like this going.
	89
	90	Enjoy,
	91
	92	David J. Goehrig <dgoehrig@cpan.org>
	93