 *************  ***** *****  ************  ****    ****   **********   **********
*****     **** ****     ****    ******    ************** ****    **** ************
************** *************    ******    ************** ****    **** ***      ***
 ****                 *****      ****      ****    ****   **********   **      **
                **********                                                2.4.2

 ************
*Description:*
 ************

This is a quick GP2X version of Python 2.4.2 I made, based on TheOddBot's version. You can find out more about Python at www.python.org.

 *********************************
*For those who don't read manuals:*
 *********************************

You should start now :) The main thing to remember is:
 
					***********************************
					*  set PYTHONHOME=/mnt/sd/python  *
					*  Instructions are included in   *
					*   the "Known Issues" section.   *
					***********************************

 ******************************************
*What's Different from TheOddBot's version?*
 ******************************************

* I have compiled and included the full Python standard library (which was missing). The other libraries which were included with the previous Python are unchanged. This was made possible thanks to a patch by Daniel Goertzen I found on sourceforge which changes a few things in some headers and the configure script so that Python may be cross-compiled successfully.

 *********************
*So how do I use this?*
 *********************

First, extract the archive and copy its contents to the root of your sd card.

There are three ways you can run Python on the GP2X:

* Run it in a terminal emulator such as Sterm. This allows you to use the interpreter in a command-line interface on your GP2X with a virtual keyboard.

* Telnet into your GP2X from your computer and run it on the command prompt. A full explanation of what telnet is and how to use it is available on wiki.gp2x.org.

* Run it in a script file (.gpe or .gpu). This is how you need to run Python when you are using for an application which you wish to later release. Users may simply select the script on their GP2X, and it will have Python run your application. Guides on how to make shell scripts are available around the net, for example there is one on wiki.gp2x.org.

 *************
*Known Issues:*
 *************

To use the Python Standard Library, you will need to set the environment variable $PYTHONHOME to /mnt/sd/python. To do this use the following command:

export PYTHONHOME=/mnt/sd/python

 ************
*What's Next?*
 ************

I'll probably try to build Python 2.5 sometime later. I've tried it and its not easy, but I think I could do it given some time.

I also was going to use Orkie's GP2X package manager, but I found its not really ready for this yet.

 ********
*Contact:*
 ********

If you have any problems, questions, bugs, etc, with this package, please contact me at:

 ***********************
*spacecoyote17@gmail.com*
 ***********************

You can also find me around the gp32x.com forums as "Blah" <-- Yeah I know, its a dumb name...

Keep the dream alive :),

Josh
