	     	         //  //   ///    //  //  //    ////  ////
.	                // //   //  //  //  //  //    //    //
	    .          ////    //  //  //  //  //    ////   ///
	              // //   //  //  //  //  //    //       //          .
	             //  //   ////    ////   ///// /////  ////
     *         .
				      v1.0
	.	        "The TIE FIGHTER clone for linux"     .            .
 								     *
				       by
                 .

	               //  ///  // // //  //  ///////////////////////
	.             // // // // // //  // //         
	          // // ///// ///// //  //  //   ///   ///// /////            .
       *          ///  // // // //  ////    // // //  //      //
                                          //  // //  ////    //        .      * 
	        //////////////////////////    ///   //      //

      .             .       THIS PROGRAM IS FREEWARE       .            .
*
	          		        .           .                        
	.                              / \                        *  .        
	    .          .              /   \
     *         .                     /     \    .               .        
                  .       *         /       \
	                     .     /         \           .
	     .                    /           \
       .                         /             \                            .
            *       .           /    CREDITS    \     *        .
                               /    ---------    \     .            *  .
                              Sounds by Jan Hubicka           .            .
                             Graphics by Jan Hubicka
                    *       Programing by Jan Hubicka
  .          .             Assistant:    Kamil   Toman
                          And  many  many (one)  others     *      .
                         /                             \
                        /          INTRODUCTION:        \
                       /          ---------------        \
    .       *  .      Koules are one of the greatest  games    .           .
       	             for Linux.  This SVGA version  supports
                    high resolution(up 640x480) with cool 256
                   color  graphics  and  sounds .  Koules were
                  developed from scratch by Jan Hubicka in July 
                 /                    1995.                    \
                /                                               \       .
               /                  REQUIREMENTS:                  \
    .         /		       ---------------          	  \
             A 386DX+ running Linux(You could try it on a 386SX, but 
            be aware... It  will  flicker ). A Coprocessor  welcomed.
           A   graphics   card   which   works   with   the   SVGALIB.    .
          /                     A nice keyboard...                    \
         /                                                             \
        /                           INSTALL:                            \
       /                           ----------                            \
      You  must  be  'root'  to  install  the  game. Edit  the  Makefile as 
     appropriate  for  your  system.  On a 486DX2+ with a fast graphics card
    select 640x480 version. On  slower  machines select  320x200 version. And 
   simply  run 'make  dep; make' to  compile game. Then  run 'make install' to 
  install  game. The game  consists  of  the  executable file 'koules' which is 
 placed in   /usr/games  during  installation  and   sound   files   placed   in
/usr/games/lib/koules.  This  can  be  changed  by  editing SOUNDDIR in Makefile

                                   USAGE:
                                  --------
                            koules [NO ARGUMENTS]


				   MENUS:

look at this simple hypertext diagram to understand them:

            /----------------+    
START GAME (---+      +--+   |
X PLAYER ---)--^------+  |   +-------------+
CONTROL----/   |         |                 |
GAME MODE------^---------^-----------------^------------------------------+
DIFFICULTY-----^---------^-----------------^----------------------------+ |
SOUND ON/OFF---^---------^-----------------^---------------------------+| |
QUIT-----------^---------^-----------------^--------------------------+|| |
               |         |                 |                          ||| |
+--------------+         |                 |                          ||| |
|                        +--------------+  |                          ||| |
+----Start game (The fun is beggins)    |  |                          ||| |
                                        |  |                          ||| |
+---------------------------------------+stip to (1)               (1)||| |
|								    | ||| |
+----Select number of players (up to 5 player are possible) !!!!!   | ||| |
								    | ||| |
+-------------------------------------------------------------------+ ||| |
|					  			      ||| |
PLAYER 1:(CONTROL MODE)------+					      ||| |
(CONTROL OPTIONS)------------^---+				      ||| |
PLAYER 2:(CONTROL MODE)------+   |				      ||| |
(CONTROL OPTIONS)------------^---+----------------------------------+ ||| |
PLAYER 3:(CONTROL MODE)------+   |				    | ||| |
(CONTROL OPTIONS)------------^---+				    | ||| |
   |                         |   |				    | ||| |
   v                         |    \				    | ||| |
PLAYER 5:(CONTROL MODE)------+-----)---+			    | ||| |
(CONTROL OPTIONS)-----------------/    |			    | ||| |
                                       |			    | ||| |
+--------------------------------------+			    | ||| |
|								    | ||| |
Possible selections:						    | ||| |
KEYBOARD---------------------------------------------------------+  | ||| |
ROTATION KEYBOARD----------------------------------------------+ |  | ||| |
MOUSE--------------------------------------------------------+ | |  | ||| |
JOYSTICK A *-----------------------------------------------+ | | |  | ||| |
JOYSTICK B *---------------------------------------------+ | | | |  | ||| |
                                                         | | | | |  | ||| |
*)available only when JOYSTICK support enabled           | | | | |  | ||| |
+--------------------------------------------------------+ | | | |  | ||| |
|							   | | | |  | ||| |
use second Joystick to control player.			   | | | |  | ||| |
use stick to rotate and button to accelerate		   | | | |  | ||| |
see also JOYSTICK SUPPORT,CONTROL MODE			   | | | |  | ||| |
+----------------------------------------------------------+ | | |  | ||| |
|							     | | |  | ||| |
use first Joystick to control player.			     | | |  | ||| |
use stick to rotate and button to accelerate		     | | |  | ||| |
see also JOYSTICK SUPPORT,CONTROL MODE			     | | |  | ||| |
+------------------------------------------------------------+ | |  | ||| |
|							       | |  | ||| |
use mouse to control player.                                   | |  | ||| |
use pointer to rotate and button to accelerate                 | |  | ||| |
mouse must be configured in				       | |  | ||| |
usr/local/lib/libvga.conf read this file for more              | |  | ||| |
informations.                                                  | |  | ||| |
use arrow to rotate player and button to accelerate.           | |  | ||| |
mouse can be also use to control menus!                        | |  | ||| |
there are no CONTROL OPTIONS supported                         | |  | ||| |
+--------------------------------------------------------------+ |  | ||| |
|                                                                |  | ||| |
use keyboard to control player                                   |  | ||| |
3 keys are used:ACCELERATE,ROTATE LEFT,ROTATE RIGHT              |  | ||| |
note:there are no predefined settings! use CONTROL OPTIONS       |  | ||| |
to set keys!                                                     |  | ||| |
see also: CONTROL OPTIONS , KEYBOARD PROBLEM                     |  | ||| |
+----------------------------------------------------------------+  | ||| |
|                                                                   | ||| |
use koyboard to control player                                      | ||| |
4 keys are used:LEFT RIGHT UP AND DOWN                              | ||| |
there are predefined settings:                                      | ||| |
player 1:cursor box                                                 | ||| |
player 2:Arrows on keypad.                                          | ||| |
player 3: there are no predefined settings! use CONTROL OPTIONS     | ||| |
player 4: there are no predefined settings! use CONTROL OPTIONS     | ||| |
see also: CONTROL OPTIONS , KEYBOARD PROBLEM                        | ||| |
+-------------------------------------------------------------------+ ||| |
|								      ||| |
(CONTROL OPTIONS)may be on of following:			      ||| |
CHANGE KEYS-------------------+					      ||| |
CALIBRATE JOYSTICK A-------+  |					      ||| |
CALIBRATE JOYSTICK B----+  |  +---------------------------------+     ||| |
			|  +---------------------------------+  |     ||| |
+-----------------------+                                    |  |     ||| |
select it to calibrate second joystick.			     |  |     ||| |
if you still see same menu your joystick is broken           |  |     ||| |
or joystick toolkit is not initialized(see JOYSTICK SUPPORT) |  |     ||| |
otherwise you will see:                                      |  |     ||| |
Move joystick to lower right corner                          |  |     ||| |
look at your joystick:                                       |  |     ||| |
(it is usually futuristic designed black thing)              |  |     ||| |
there is black stick.                                        |  |     ||| |
get it and move it into lower right corner.then press        |  |     ||| |
red button on joystick or space key.                         |  |     ||| |
                                                             |  |     ||| |
then you will see:                                           |  |     ||| |
       Center joystick                                       |  |     ||| |
and press either button or space                             |  |     ||| |
                                                             |  |     ||| |
Place joystick on your desk.center the stick.                |  |     ||| |
and smoothly and slowly press space key.                     |  |     ||| |
+------------------------------------------------------------+  |     ||| |
|								|     ||| |
select it to calibrate first joystick.			        |     ||| |
if you still see same menu your joystick is broken              |     ||| |
or joystick toolkit is not initialized(see JOYSTICK SUPPORT)    |     ||| |
otherwise you will see:                                         |     ||| |
Move joystick to lower right corner                             |     ||| |
look at your joystick:                                          |     ||| |
(it is usually futuristic designed black thing)                 |     ||| |
there is black stick.                                           |     ||| |
get it and move it into lower right corner.then press           |     ||| |
red button on joystick or space key.                            |     ||| |
                                                                |     ||| |
then you will see:                                              |     ||| |
       Center joystick                                          |     ||| |
and press either button or space                                |     ||| |
                                                                |     ||| |
Place joystick on your desk.center the stick.                   |     ||| |
and smoothly and slowly press space key.                        |     ||| |
+---------------------------------------------------------------+     ||| |
|								      ||| |
define your keys:                                                     ||| |
if you see ACCELERATION skip to b)                                    ||| |
if you see UP skip to a)                                              ||| |
a)you have selected KEYBOARD                                          ||| |
  press a key what you want use to move up			      ||| |
  then you will see:                                                  ||| |
  DOWN                                                                ||| |
  press a key what you want use to move down			      ||| |
  then you will see:                                                  ||| |
  LEFT                                                                ||| |
  press a key what you want use to move left			      ||| |
  then you will see:                                                  ||| |
  RIGHT                                                               ||| |
  press key what you want use to move right			      ||| |
  then a you will see:                                                ||| |
see also:KEYBOARD PROBLEMS                                            ||| |
b)you have slected ROTATION KEYBOARD                                  ||| |
  press a key what you want use to accelerate   		      ||| |
  then you will see:                                                  ||| |
  ROTATE LEFT                                                         ||| |
  press a key what you want use to rotate left			      ||| |
  then you will see:                                                  ||| |
  ROTATE RIGHT                                                        ||| |
  press a key what you want use to rotate right			      ||| |
  then you will see:                                                  ||| |
see also:KEYBOARD PROBLEMS                                            ||| |
+---------------------------------------------------------------------+|| |
|								       || |
back to the reality						       || |
NOT RECOMENDED!!!! VERY DANGEROUS				       || |
RISK OF THE PSYCHICAL ( PHYSICAL ? ) SHOCK              	       || |
+----------------------------------------------------------------------+| |
|								        | |
turns the space sound on/off						| |
+-----------------------------------------------------------------------+ |
menu:									  |
EASY----------------------------+					  |
MEDIUM------------------+	|					  |
HARD-------------+	|	|					  |
                 |	|	|					  |
+----------------+	|	|					  |
|			|	|					  |
only for professionals!	|	|					  |
+-----------------------+	|					  |
|				|					  |
recomended mode			|					  |
+-------------------------------+					  |
|									  |
less fun								  |
+-------------------------------------------------------------------------+
|
menu:
DEATH MATCH(doom)---------------+
COOPERATIVE---------+		|
		    |		|
+-------------------+		|
|				|
default mode.			|
operates in both		|
multiplayer and			|
monoplayer modes		|
many levels!			|
+-------------------------------+
|
for doom maniacs  -try to kill each other and stay alive!




VERY VERY EASY, isn't it? :)
                                 -----
                                /     \
                               | o | o |     
===========================OO==============OO=============================

			    KEYBOARD PROBLEMS
			   -------------------
If you feel week go away! I have to tell you a story about stupidity of your 
keyboard controller. Once open a time ?BM (alias Little Yellow) made a stupid
keyboard which is not able to handle more than 4 keys at a time...
... and they lived happily ever after.


			    JOYSTICK SUPPORT
			   ------------------
requires joystick toolkit.in distribution is patch for joystick-0.7.1 to 
compile  under newer version of kernel(1.3.x) instalation:
tar xzvf joystick-0.7.1.tar.gz
patch -p0 <  <home directory of koules sources>patch
cd joystick-0.7.1
cp joystick.h /usr/include/linux
make joystick.o

before you run game enter
insmod joystick.o
you will see:
js_init: found <number> joysticks

number must be 1 or 2!!!

			     SOUND SUPPORT
			    ---------------
koules support voxware sound driver and pcsnd pcspeaker driver.

			         FAQ
				-----

Q:  Sounds not running.
A:  You entered invalid path edit makefile.
    Note on spaces and / at end of path.

Q:  Why this stupid game don't run on my machine?
A:  Your stupid machine is not supported. Buy another one.

Q:  Why game run s l o w l y ?
A:  Try 320x200 version(edit makefile).

Q:  Why game still run s l o w l y ?
A:  Buy sextium ;)

			       COPYING
			      ---------
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


			         BUGS
				------
There is bug in my svgalib.1.2.6:
switch to another console, switch back and press enter it will crash your
computer.It is not koules bug!!! Test it on svgalib/demos/keytest!

Koules from the top:

                             .              
		 ---       .  .                    O
		/   \        . .
	       |     |    . . .. ---
	        \   /           /   \        X           O
                 ---           |    O|
                                \  O/
                                 ---       ---
		.       O                 /O O\
	     . . . .                     |     |
	      . . .                       \   /
            .  .X.  .          O           ---
              . . .                         .
             . . . .                       ...
                .                         . . .
                                         . . . .
                                        .   .   .
			H A V E
			  FUN
                           !


If you have any comments, problems, suggestions, donations, flames,
send them to:
email:
hubicka@limax.paru.cas.cz

smail:
Jan Hubicka
Dukelskych bojovniku 1944
Tabor 39001
Czech Republic

