pygame / symbian / how_to_build.txt

== Instructions to build pygame for PyS60. ==

Basic requirements:
- S60 3rd or 5th ed. SDK 
- SVN client

=== Getting necessary libraries ===

Run ' --no-code-docs'
- This regenerates pygame module documentation without documentation in code.

Create symbian/deps directory

Checkout ogg to symbian/deps/ogg
- IMPORTANT: Revision 7524
- SVN: 

Checkout vorbis to symbian/deps/vorbis
- IMPORTANT: Revision 7543
- SVN:

Get SDL for Series60
- Available at:
- Follow the instructions and copy the pathced SDL S60 folder to symbian/deps/SDL

Get SDL_mixer to symbian/deps/SDL_mixer

Get SDL_ttf to symbian/deps/SDL_ttf

Get Symbian FreeType2 port to symbian/deps/sft2
- SVN:

Get SDL_image to symbian/deps/SDL_image

Checkout jpeg library to symbian/deps/jpeg

- The build scripts use SCons for Symbian. 
-- Follow the installation instructions

=== Building ===

==== Using the release building script ====
- Go to pygame/symbian directory

The pygame can be built against the official(or any) pys60 version. 
Initialize the release script by giving it information about the python dll to be linked with
and the sis file to be embedded with it's UID.
- TODO: Not implemented yet!!
- --pythondll=python222 --pys60-embed=Python_1.4.5_3rdEd.sis
- --pythondll=python25  --pys60-embed=Python_1.9.0_3rdEd.sis


- Use script to build the 'pygame_python' with PyS60 Community Edition,
  the depended libraries and the pygame itself. All in one.
- Give the path to the PyS60 CE's 'src' directory as a parameter for the script 
- The CE version is used to do some customizations for the Python installation. 
- The above parameters are handled automatically in that case.
- Of course, you can build the PyS60 CE manually and configure the build script as above. --pys60-ce=\projects\pys60ce\trunk\src

==== Do the build ====

- Run: 

- Run: compiler=gcce release=urel cert=mycert.cer privkey=mycert.key passphprase=mypassword gcce_options="-O2 -fno-unit-at-a-time"
-- NOTE: The gcce_options are optional but recommended to reduce the binary size.

=== Misc info ===

pygame library
- The pygame is implemented as static library to be statically linked to pygame application.

About selecting Python:
- You can select the python.dll to link against by giving scons parameter 'pythondll' 
- ex. scons pythondll=Python222
- default is "pygame_python"