.gitignore Ignoring /build/ paths

Fixes issue #1.

.gitignore

@@ -137,7 +137,6 @@ Desktop.ini
 *.egg
 *.egg-info
 dist
-build
 eggs
 parts
 bin

sphere/build/linux/engine.ini

@@ -0,0 +1,65 @@
+[Audio]
+Driver=oss
+Preference=0
+
+[Main]
+Language=1
+
+[Network]
+AllowNetworking=1
+
+[Player1]
+AllowJoypadInput=1
+AllowKeyboardInput=1
+KeyA=KEY_DELETE
+KeyB=KEY_END
+KeyDown=KEY_DOWN
+KeyLeft=KEY_LEFT
+KeyMenu=KEY_ESCAPE
+KeyRight=KEY_RIGHT
+KeyUp=KEY_UP
+KeyX=KEY_INSERT
+KeyY=KEY_HOME
+
+[Player2]
+AllowJoypadInput=1
+AllowKeyboardInput=1
+KeyA=KEY_F
+KeyB=KEY_E
+KeyDown=KEY_S
+KeyLeft=KEY_A
+KeyMenu=KEY_ESCAPE
+KeyRight=KEY_D
+KeyUp=KEY_W
+KeyX=KEY_Y
+KeyY=KEY_X
+
+[Player3]
+AllowJoypadInput=1
+AllowKeyboardInput=1
+KeyA=KEY_H
+KeyB=KEY_U
+KeyDown=KEY_K
+KeyLeft=KEY_J
+KeyMenu=KEY_ESCAPE
+KeyRight=KEY_L
+KeyUp=KEY_I
+KeyX=KEY_N
+KeyY=KEY_M
+
+[Player4]
+AllowJoypadInput=1
+AllowKeyboardInput=1
+KeyA=KEY_NUM_1
+KeyB=KEY_NUM_2
+KeyDown=KEY_NUM_5
+KeyLeft=KEY_NUM_4
+KeyMenu=KEY_ESCAPE
+KeyRight=KEY_NUM_6
+KeyUp=KEY_NUM_8
+KeyX=KEY_NUM_7
+KeyY=KEY_NUM_9
+
+[Video]
+Driver=sdl32.so
+

sphere/docs/build/aaulia_changelog.txt

@@ -0,0 +1,27 @@
+Sphere Source Code ChangeLog (Date format is dd/mm/yy)
+
+18/08/06 :
+[-] wxEditor and Editor project from Sphere workspace.
+[-] Removing some (unused) directory.
+[+] Restructure some directory and output target.
+[+] Formating the source code with AStyle (through CodeBlocks).
+[+] Update the third party libs (Corona, Audiere, SpiderMonkey<JS>) to the latest (that I have).
+[+] Update the project file to VC++ 7.1 (VS 2003).
+[*] Fix various error in the source due to the update and reformating.
+
+19/08/06 :
+[+] ported to VC Express 2005 (8.0)
+[+] added dx8 libs and header to third party directory, update dx8 driver project.
+[+] fix some directory issue
+[+] added XP_WIN to preprcessor definition in engine to enable new JS
+
+20/08/06 :
+[*] fix some directory, header issue. After this changes hopefully this package will
+    compile and build 'out of the box' (you still need PSDK and VC Express ;| ).
+
+some known issue about this version :
+1. security warning, this is generated by default by MSVC Express 2005 due to their new secure CRT
+   lib. ignore if you get lot's of warning (or simply set the pragma warning where appropriate)
+2. the engine build produces engine.lib and engine.exp, I dunno bout this, could some track down the compiler
+   option that causes this ?? AFAIK it doesn't bother the binary, it still runs fine.
+

sphere/docs/build/aaulia_readme.txt

@@ -0,0 +1,25 @@
+This is the sphere source code (from the CVS) that I modified to be more friendly and 
+compileable. read the changelog.txt for more information.
+
+What you need to have (and do) to compile this package:
+
+1. Microsoft Visual C++ Express 2005
+2. Platform SDK (latest would be better, I use MS Platform SDK For Windows 2003 R2)
+3. Add <Path to your Platform SDK>\include\mfc to tools->options->Projects and Solutions->VC++ Directories->Include
+
+how you compile it ??? open Sphere.sln, and hit F7 :D
+
+Hope this could be usefull for everyone intersted in developing sphere.
+
+PS: 
+21-08-06 - Building complete (runable) sphere package from this source on windows
+
+1. The package will be in './Sphere' directory of the source tree.
+2. Build solution in release mode, ALL the binary will be outputed to './Sphere' and ALL the video driver will be
+   outputed to './Sphere/system/video/'
+3. Copy directory './Startup' to './Sphere' (overwrite if already exist).
+4. Copy directory './system' to './Sphere' (overwrite if already exist, but makesure you do not overwrite the video
+   sub-directory).
+5. Copy the './docs' to './Sphere'
+
+thats it you get the complete sphere package (minus the editor).

sphere/docs/build/build-cygwin.txt

@@ -0,0 +1,52 @@
+How to Build Sphere in Windows with Cygwin
+--------
+
+Chad Austin ([email protected])
+Spherical (http://www.spheredev.org/)
+2006.08.27 (Version 1.12)
+
+
+
+Requirements
+--------
+
+An Internet Connection
+Cygwin (www.cygwin.com)
+SCons (www.scons.org)
+
+
+
+Getting the Source Code
+--------
+
+Using your favorite CVS client, download the sphere module from CVS.
+Instructions are at <https://sourceforge.net/cvs/?group_id=1551>.
+
+
+Getting Third-party Headers, Libraries, and DLLs
+--------
+
+Sphere depends on a lot of external code.  You can download them all
+individually, or get prebuilt libraries and headers for mingw on the
+SourceForge downloads page
+(https://sourceforge.net/project/showfiles.php?group_id=1551).
+
+After you have all of the headers and libraries, put them in
+SPHERE_ROOT/third-party-mingw
+
+There should be two directories inside of
+SPHERE_ROOT/third-party-mingw...  include and lib.
+
+
+Compiling
+--------
+
+Open a Cygwin prompt, cd to the sphere directory, and type:
+
+scons compiler=mingw
+
+If you have troubles, send me an e-mail (address at the top of the
+document). NB: Since the writing of this document, Chad has passed
+the Sphere project to Brian Robb (a.k.a. Flikky). Since he hasn't
+been around too often either, your best bet for help is the Spherical
+community (http://www.spheredev.org/). Ask at the forums.

sphere/docs/build/build-linux-old.txt

@@ -0,0 +1,217 @@
+Sphere Linux HOWTO
+
+To compile the sphere engine under linux you need several other libraries.
+(okay, a lot of other libraries)
+
+Where I show filenames below, they are the ones I installed.
+If newer versions are available, you should probably install those instead.
+
+You need:
+
+a C++ compiler, such as g++
+corona  -  http://corona.sf.net/
+audiere  -  http://audiere.sf.net/
+spidermonkey  -  http://www.mozilla.org/js/spidermonkey/
+  or the spidermonkey.tar.gz found at the files page at http://sf.net/projects/sphere/
+SDL  -  http://www.libsdl.org/
+libmng  -  http://www.libmng.com/
+libpng  -  http://www.libpng.org/
+scons  -  http://www.scons.org/
+
+zlib (compression library, http://www.gzip.org/zlib/)
+
+Optionally, you can also get:
+
+libvorbis  -  http://www.vorbis.com
+libjpeg  -  http://www.ijg.org/ or ftp://ftp.uu.net/graphics/jpeg/ 
+
+To also install wxeditor, you will need:
+
+wxwidgets (formally wxwindows)  -  http://www.wxwidgets.org/
+
+(Once you've got the engine compiling and working compiling
+ wxeditor shouldn't be too difficult, just install wxwidgets
+ and type "scons")
+
+-----------------------------------------------------------
+
+Gentoo Linux:
+The following section is for gentoo linux users,
+mainly how to install libraries using portage...
+
+-----------------------------------------------------------
+
+Gentoo users can install SDL, libpng, libmng and scons using portage...
+(They can also optionally install zlib, libjpeg, and libvorbis using portage aswell...)
+(Note that gentoo users still have to follow the "Everyone else" section for SpiderMonkey, audiere and corona...)
+
+Before you merge these, you should make sure you have the
+following USE flags set (just to make sure) in your make.conf:
+ogg vorbis mp3 mng png jpeg sdl
+
+Then run the following commands:
+
+For SDL:    emerge libsdl
+For libpng: emerge libpng
+For libmng: emerge libmng
+For scons:  emerge scons
+
+And optionally:
+
+For zlib:      emerge zlib
+For libjpeg:   emerge libjpeg
+For libvorbis: emerge libvorbis
+
+Also, when it comes to running the engine, if you use the aRts sound server,
+you can use the aRts dsp wrapper as follows to route the dsp output to aRts:
+artsdsp -m ./engine
+
+-----------------------------------------------------------
+
+Everyone else:
+The following install commands are based on using rpm on mandrake linux.
+(But should work on suse linux and redhat linux...)
+
+-----------------------------------------------------------
+
+To install SDL:
+You need the SDL development library RPM, and so you do something like:
+
+rpm -i libSDL1.2-devel-1.2.5-5mdk
+
+-----------------------------------------------------------
+
+To install libmng:
+You download the libmng.rpm file, and so you do something like:
+
+rpm -i libmng1-devel-1.0.3-2mdk
+
+-----------------------------------------------------------
+
+To install SCons:
+You'll need the scons RPM, and then you can do something like:
+
+rpm -i scons-0.13-1.noarch.rpm
+
+If you prefer using the tar.gz version, installing it looks like:
+
+gunzip scons-0.13-1.tar.gz
+tar -xf scons-0.13-1.tar
+cd scons-0.13-1
+python setup.py install
+
+-----------------------------------------------------------
+
+To install SpiderMonkey:
+You download the SpiderMonkey.tar.gz file, and you do something like:
+
+gunzip SpiderMonkey-1.5.0.tar.gz
+tar -xf SpiderMonkey-1.5.0.tar
+cd SpiderMonkey-1.5.0
+./configure
+make
+make install
+
+-----------------------------------------------------------
+
+To install corona:
+You download the corona.tar.gz file, and so you do something like:
+
+gunzip corona-1.0.0.tar.gz
+tar -xf corona-1.0.0.tar
+cd corona-1.0.0
+./configure
+make
+make install
+
+The next step may just be me... but you need to make sure the lib is properly installed, so:
+
+cd src
+cd .libs
+cp libcorona-1.0.0.so /lib # or cp libcorona-1.0.0.so /usr/lib
+
+This is just a check you can do, feel free to skip it, but I like to make sure corona supports png, so you do:
+cd ..
+cd .. # we should be back in corona-1.0.0 now
+cd examples/formats
+./formats
+
+If it says png is supported? Good news, if not, sphere pretty much wont run.
+
+Then run ldconfig to update your library path details.
+
+su
+ldconfig
+
+-----------------------------------------------------------
+
+To install audiere:
+You download the audiere.tar.gz file, and you do something like:
+
+gunzip audiere-1.9.2.gz
+tar -xf audiere-1.9.2.tar
+cd audiere-1.9.2
+./configure
+make
+make install
+
+
+The next step may just be me... but you need to make sure the lib is properly installed, so:
+
+cd src
+cd .libs
+cp libaudiere-1.9.2.so /lib # or cp libaudiere-1.9.2.so /usr/lib
+
+Then run ldconfig to update your library path details.
+
+su
+ldconfig
+
+-----------------------------------------------------------
+
+If all goes well, you now should be able to move onto installing sphere.
+
+Getting the source
+
+Using your favorite CVS client, download the sphere module from CVS.
+Instructions are at <https://sourceforge.net/cvs/?group_id=1551>.
+
+  They should be either:
+
+  cvs -d:pserver:[email protected]:/cvsroot/sphere login  
+  cvs -z3 -d:pserver:[email protected]:/cvsroot/sphere co sphere
+
+  Or:
+
+  export CVS_RSH=ssh
+  cvs -z3 -d:ext:[email protected]:/cvsroot/sphere co sphere
+
+Once you've done that, goto into the top level sphere directory and run scons
+
+cd sphere
+scons
+
+You should get the first few lines looking like:
+
+[brian@localhost sphere]$ scons
+scons: Reading SConscript files ...
+Using compiler: linux
+Found sdl-config: /usr/bin/sdl-config
+Using subsystem:  unix
+
+Not that if it doesn't say "Using compiler: linux"
+you'll have to use "scons compiler=linux" rather than just "scons"
+
+
+Hopefully, if all goes well, you'll be able to open the engine.
+
+cd sphere
+cd build
+cd linux
+./engine
+
+
+
+If you feel I missed something out, please let me know.
+
+-- Flik.