Added info for GP2X port.

git-svn-id: svn://svn.code.sf.net/p/stella/code/trunk@977 8b62c5a3-ac7e-4cc8-8f21-d9a121418aba

stella/README-GP2X.txt

@@ -0,0 +1,98 @@
+---------------------------------------
+Stella 2.1:
+Ported to GP2X by Alex Zaballa
+Contact: alex.zaballa@gmail.com
+Homepage: http://stella.sourceforge.net
+---------------------------------------
+
+--------
+Changes:
+--------
+>From 2.0.1:
+Stopped using the ROM Script (No more ROM limit. 'Single binary' zip support available.)
+Opened up the Native GUI for use through Joymouse Emulation
+SOUND!
+Diagonals
+Snapshots
+Some button mapping (but still comfortably familiar)
+
+-----------
+Known Bugs:
+-----------
+2nd exit bug (yes, it's still there.... but, you can play many games before that second exit, lest we
+	forget save state. Fix coming soon.)
+
+------------------------------
+Known GP2X Performance Issues:
+------------------------------
+Pitfall 2 runs slow due to extra hardware emulation. (Steve foresees this being fixed in the future.)
+Phosphorus effect disabled at the moment due to dragging software video mode. (A version that writes
+	directly to hardware is in the works.)
+
+---------------------
+Installation to GP2X:
+---------------------
+Place files stella.gpe and stella.pro into a chosen directory. Upon first run, Stella will ask for your
+ROM directory and snapshot directory. Remember that the path to the sd card is '/mnt/sd'.
+
+-----------
+Navigation:
+-----------
+The joystick moves the mouse cursor in all menus except the ROM Launcher, with any button acting as a click.
+In the ROM Launcher, up/down scrolls through the ROM list and left/right selects options across the bottom, with any
+button serving as a click.
+
+-------------
+GP2X Mapping:
+-------------
+  A      = Snapshot
+  B      = Fire
+  X      = Pause
+  Y      = Settings Menu
+  L      = Console Reset
+  R      = Console Select
+  START  = Launcher Menu
+  SELECT = Command Menu
+
+Note: Nothing has been taken away by changing this mapping. Save, Change, and Load State are all available
+through the Command Menu (SELECT).
+
+Caution: Changing video and audio settings could lead to a non-working Stella setup. If you do feel the need
+to change the settings (as we all do) and happen to cause a crash or hang, delete the 'stellarc' file and that should
+clear up the problem. If anyone finds any settings that give better performance in sound and gameplay,
+let me know and I might incorporate them into the next build. Happy tinkering.
+
+-------------
+Compile Info:
+-------------
+Since the GP2X branch was so graciously added to Stella, GP2X compilation is now built in. If you plan on doing a
+compile yourself, you need the GP2X devkit pro and SDL Open2X libs with zlib support. I recommend theoddbot's
+Open2X libraries which work very nicely for this. Any questions, email me.
+
+Make sure your path includes your arm-linux compilers:
+export PATH=<your arm-linux compiler path>:$PATH
+
+This is what my configure line looks like:
+./configure --prefix=<your destination folder> --enable-zlib --disable-developer --host=gp2x --with-zlib-prefix=<your
+gp2x zlib path> --with-png-prefix=<your gp2x png path> --with-sdl-prefix=<your sdl config path> --x-libraries=<your X11
+libraries path>
+
+Then:
+make
+
+Then strip the exec:
+make gp2x-strip
+
+You should get an exec ~2mb in size. Much better than 7mb right?
+
+Place stella.gpe and stella.pro (available in ../src/emucore) into your destination directory on the GP2X and run.
+
+---------------
+Special Thanks:
+---------------
+... to Steve Anthony for the major improvements in the port and incorporating the GP2X. Not to mention the
+	wealth of information and help... did I mention patience? ;-)
+... to Eckhard Stolberg for making me known to the Stella Team.
+... to the Stella Team for the excellent emulator and the hospitality.
+... to theoddbot for the excellent Open2X toolchain libs.
+... to the community for all of the interest.