# This is free software, you should be able to use, modify,
# and redistribute non-commercially freely, as long as you grant
# these same rights to anyone who wishes to have them... or so... :-)

2008-10-26
Parallel2 - a way to learn Lojban
version 0.4

* Installation

If you can read this text file, you have unpacked the archive correctly. Congrats,
that's all there is to it, installation is complete! 

However, to run, some support programs need to exist on your machine:

Python (2.4 or higher) http://www.python.org/
Pygame http://www.pygame.org/news.html
A sound player, recommended is mplayer http://www.mplayerhq.hu/design7/news.html
The data files of the program (if your downloaded the archive, you have them already)

See the install instructions for each part on how to install them. 


* Running the program

To run, give the command at a command prompt:

python parallel.py

The program should start. If not, you must set your operating system's PYTHONPATH to 
wherever your Python executable is located. Since this varies with OS, best search
the net for how to do that for your system, it shouldn't be hard. 

You use the keyboard to navigate, the available
commands are visible at the bottom of the screen at all times. 

* Configuration

If you open the parallel.py file in a text editor (like emacs, vi, Notepad, whatever), you
will find three fields you can change at the top of this file.

DATAPATH : This sets the root location of the data files. If you have the data files in the
           same place as your parallel.py file, you should be fine. 
PLAYERCOMMAND : This is the command given to your chosen sound player. The default is for 
                mplayer. If you want to use another player you need to change this string
                to match.
WINSIZE : This number-pair sets the size of the program window, in pixels. The default size is usually 
          enough, but you can increase it if you want. Making it smaller is not recommended
	  since parts of the interface might not be able to fit in the window. 


* Credits 

Scan the top of the parallel.py file for a list of the people who have contributed to Parallel.
