            Omnigo DOS Mode Chess Version 1.0
                 (C) 1997 R.S. Kinder

A derivative of Gnuchess specifically ported for the Hewlett Packard
OmniGo 100/120 computer. Portions Copyright:
 (C) 1986, 1987, 1988, 1989, 1990, 1997 Free Software Foundation, Inc.
 (C) 1988, 1989, 1990  John Stanback


Hello OmniGo user!

 Here is a chess program that you can use on your OmniGo
computer. This game features a two dimensional graphical
chess board, a powerful computer opponent and the ability
to save and load games in progress. Major drawbacks are that you
must run this program in DOS mode and also this program is large:
161K (or 110K without the opening book library). This is a document
that came with gnuchess that I adapted to this release for the
OmniGo.

Have Fun!

R.S. Kinder


----------- CONTENTS -----------

  I.... INSTALLATION

  II... QUICK START!

  III.. DESCRIPTION

  IV... A WORD ABOUT COORDINATES

  V.... COMMANDS

  VI... BUGS
  
  VII.. SOURCE CODE
  
  VIII. SUPPORT

  IX... LICENSE, COPYRIGHT AND 'WARRANTY' INFORMATION


 
I. INSTALLATION

 Install the 3 gnuchess files into the same drive and directory
on your OmniGo.

 These files are required:
                gnuchess.exe (DOS executable)
                gnuchess.bin (chess graphics)

 This file is optional:
                gnuchess.boo (opening book library)


II. QUICK START!

 Log to the drive and directory where you installed
 this program.

 At the command prompt type: gnuchess 5

           (computer will take 5 seconds per move)

 To enter your move type the FROM and TO coordinates. For 
 example to move a piece from the d2 square to the d4 square
 you would type: d2d4 (must be typed in lower case letters)

 Basic commands to know to get started quickly:
 (See 'V. COMMANDS' for a complete list of commands)

 NOTE: All commands must be typed in lower case [small] letters.

 help -- Displays a summary of the commands and game status info.

 bd -- (Board Draw) Redraws the board. This is helpful when the
       board is scrolled or otherwise disturbed.

 quit -- Quits the program.

 save -- Saves the game in progress for later resume.

 get -- Loads a previously saved game to resume play.


III. DESCRIPTION
GnuChess plays a game of chess against the user or it plays against itself.
The program gets its opening moves from the file gnuchess.boo which
should be located in the same directory as gnuchess (the program will
still operate without gnuchess.boo).

To invoke the program, type 'gnuchess'.

The 'gnuchess' command can be followed by up to 2 command line arguments.
If one argument is given it determines the programs search time in
seconds.  If two arguments are given, they will be used to set tournament
time controls with the first argument being the number of moves and the second
being the total clock time in minutes.  Thus, entering 'gnuchess 60 5' will set
the clocks for 5 minutes (300 seconds) for the first 60 moves.
If no argument is given the program will prompt the user for level of
play.

Once GnuChess is invoked, the program will display the board and prompt the user
for a move. To enter a move, use the notation 'e2e4' where the first
letter-number pair indicates the origination square
and the second letter-number pair indicates the destination square
(See 'IV. A WORD ABOUT COORDINATES' for an explanation of coordinates).
An alternative is to use the notation 'nf3' where
the first letter indicates the piece type (p,n,b,r,q,k).
To castle, type the origin and destination squares
of the king just as you would do for a regular move, or type
"o-o" for kingside castling and "o-o-o" for queenside.

 IMPORTANT NOTE: When the computer wins (either against itself or
a human opponent) it will print out it's mating move above the
chess board, but it will not make it's move graphically.


IV. A WORD ABOUT COORDINATES
  To reference a square you need to know the Chess Board
 coordinates: 

  Columns are numbered from left to right starting
 with the letter 'a' and ending with the letter 'h'. Rows are
 numbered from the bottom to the top starting with the number
 '1' and ending with the number '8'. 

  At the beginning of the game the white king is on the 'e1'
 square and the pawn above it is on the 'e2' square.


V. COMMANDS
In addition to legal moves, the following commands are available as responses.

beep -- causes the program to beep after each move.

bd -- updates the current board position on the display.

book -- turns off use of the opening library.

both -- causes the computer to play both sides of a chess game. Press FN+C on
the OmniGo to interrupt computer play (Equivalent to CTRL+C on the PC).

black -- causes the computer to take the black pieces with the move
and begin searching.

level -- allows the user to set time controls such as
60 moves in 5 minutes etc.  In tournament mode, the program will
vary the time it takes for each
move depending on the situation.  If easy mode is disabled (using
the 'easy' command), the program
will often respond with its move immediately, saving time on
its clock for use later on.

depth -- allows the user to change the
search depth of the program.  The maximum depth is 29 ply.
Normally the depth is set to 29 and the computer terminates
its search based on elapsed time rather than depth.
Using the depth command allows setting depth to say
4 ply and setting response time to a large number such as
9999 seconds. The program will then search until all moves
have been examined to a depth of 4 ply (with extensions up
to 11 additional ply for sequences of checks and captures). 

easy -- toggles easy mode (thinking on opponents time)
on and off. The default is easy mode ON.  If easy mode is disabled,
the user must enter a 'break' or '^C' (FN + C on the OmniGo) to get
the programs attention before entering each move.

edit -- allows the user to set up a board position.
In this mode, the '#' command will clear the board, the 'c'
command will toggle piece color, and the '.' command will exit
setup mode.  Pieces are entered by typing a letter (p,n,b,r,q,k) for
the piece followed by the coordinate.  For example "pb3" would
place a pawn on square b3. To delete a piece use the letter 'd'
followed by the board coordinates. For example "dg6" would
remove a piece from square g6.

force -- allows the user to enter moves for both
sides. To get the program to play after a sequence of moves
has been entered use the 'white' or 'black' commands.

get -- retrieves a game from disk.  The program will
prompt the user for a file name.

help -- displays a short description of the commands.

hint -- causes the program to supply the user with
its predicted move.

list -- writes the game moves and some statistics
on search depth, nodes, and time to the file 'chess.lst'.

new -- starts a new game.

post (disabled) -- causes the program to display the principle
variation and the score during the search.  A score of
100 is equivalent to a 1 pawn advantage for the computer.

random -- causes the program to randomize its move
selection slightly.

reverse -- causes the board display to be reversed.  That
is, the white pieces will now appear at the top of the board.

quit -- exits the game.

save -- saves a game to disk.  The program will prompt
the user for a file name.

switch -- causes the program to switch places with
the opponent and begin searching.

undo -- undoes the last move whether it was the computer's
or the human's. You may also type "remove". This is equivalent
to two "undo's" (e.g. retract one move for each side).

white -- causes the computer to take the white pieces
with the move and begin searching.


VI. BUGS
Pawn promotion to pieces other than a queen is not allowed.
The transposition table may not work properly in some
positions so the default is to turn this off. 


VII. SOURCE CODE
'C' Source Code for this version of GnuChess is contained in an
archive named OGC1-SRC.ZIP.  It is currently available at this 
Web Page: http://www.concentric.net/~rkinder/ogo.shtml.


VIII. SUPPORT
You can send comments, questions or problems to me via my
email address: rkinder@cris.com

Also, look for future upgrade information on my Web Page:
http://www.concentric.net/~rkinder/ogo.shtml


IX. LICENSE, COPYRIGHT AND 'WARRANTY' INFORMATION
See included file 'COPYING' for detailed information.
(This program is not warranted in any way.)
 