iThink Files

iThink - word game
(c) 2010 Badri/Gowrish/Karthik/Koushik

Version 1.0 (release)

RELEASE NOTES
=============

iThink - word game developed in Python. To build it, you need to download 
the source code for iThink, which can be found at

		https://sourceforge.net/projects/ithink/

(you must follow the link to the download page). 


REQUIREMENTS
============

iThink requires Python 2.5 to work. Previous versions of Python are 
not supported.

iThink is platform independent, its currently tested on Windows XP/Vista/7 
and Fedora Linux 12.

iThink also required the PyQt4 (for GUI), PyCLIPS, Pyttsx, Pywin32 and py2exe (for 
windows users only) to compile.

The above mentioned libraries may be downloaded at following sites:
	Python 2.5 - (http://www.python.org/download/releases/2.5.4/)
	PyQt4 - (http://www.riverbankcomputing.co.uk/software/pyqt/download)
	PyCLIPS - (http://sourceforge.net/projects/pyclips/files/)
	Pyttsx - (http://pypi.python.org/pypi/pyttsx/1.0)
	Linux users only:
		espeak/libespeak-dev - audio support
		python-setuptools-devel/python-toolkit - for 'easy_install' command 
	Windows users only:
		Pywin32 - (http://sourceforge.net/projects/pywin32/) 
		py2exe - (http://sourceforge.net/projects/py2exe/files/)


INSTALLATION
============

1) using the prebuilt installer
-------------------------------

	For Windows users:
	------------------
		Download 'iThink_XXXX_1.0.exe' under 'Windows' from the following url.
		'XXXX' - represents the respective windows version

			https://sourceforge.net/projects/ithink/files/

		Double click downloaded executable to install the application,
		followed that a shortcut link to the application should be 
		available at Desktop and Start Menu.

2) from the source
------------------

Installing from the 'source' should be simple, as the module uses distutils
in the usual way. 

The sequence of operations should be as follows:

	For Windows users:
	------------------
		1. extract iThink-1.0.tar.gz
	# from command prompt go to unzipped path
		2. cd iThink 
		3. python setup.py build 
		4. python setup.py install
	# to start application
		$ cd bin
		$ python iThink

	For Fedora linux users:
	-----------------------
		$ tar -xvf iThink-1.0.tar.gz
		$ cd iThink 
	# <please comment 'import py2exe' at setup.py as its unavailable for linux>
		$ python setup.py build 
		$ su -c "python setup.py install"
	# to start application
		$ cd bin
		$ su -c "python iThink"

3. to create windows binary for application
-------------------------------------------

	For Windows users:
	------------------
		1. extract iThink-1.0.tar.gz
	# from command prompt go to unzipped path
		2. cd iThink 
		3. python setup.py py2exe 
		
	'dist' folder will contain windows binary for distribution
		
		4. With 'nullsoft scriptable install system' run the iThink.nsi to 
		create installable iThink.exe

LICENSE
=======

iThink is released under the General Public License (GPL): a copy
of the license text is included.
However the license can be found in the usual place, that is at the 
GNU's web site (http://www.gnu.org/licenses/gpl.txt).


CONTACT INFORMATION
===================

I can be reached for suggestions, criticisms and reports about any annoyance
at the following e-mail address:

	gowrishg -at- gmail -dot- com
	karthik.pan -at- gmail -dot- com
	badrinarayanan.rangarajan -at- gmail -dot- com
	s2k.koushik -at- gmail -dot- com


---