                MANCALA!! FOR THE TI-82

System Requirements:
        Memory:
                VAR TYPE        NAMES                   SIZE(bytes)
                --------        -----                   -----------
                Prgm            MANBOARD,MANCALA        MANCALA = 2689
                                                        MANBOARD= +512
                                                                  ----
                                                                  3201

                Real            C,F,G,H,I,J,K,N,P,R,W   195
                                X,Y

                List            L1                      134

                Pic             Pic1                    764
                             (May be deleted, but should
                                be regenerated with 
                                MANBOARD to play.)

                GDB             GDB6                    764
                             (May be deleted at any time
                                used only during program)


Installation:
        1. Download this file (MANCALA.UUE) to your computer.
        2. Uudecode the file by typing

                UUD20 MANCALA.UUE

                in a path with MANCALA.UUE and UUD20.EXE.

        2. Run LINK82.EXE (DOS) or WLINK82.EXE (Windows) to send the program
                to your calculator.

Running:
        The first time you run MANCALA, and any other time when Pic1 has been
        deleted or over written, follow steps 1-5, otherwise start at step 6.

        1. Press [CLEAR] from the homescreen to make sure there is nothing
                on the current line.
        2. Press [PRGM].
        3. Select MANBOARD from the EXEC column and press [ENTER].
        4. Press [ENTER] after "prgmMANBOARD" is displayed on the screen.
        5. Press [ENTER] again to generate the MANCALA board, and store it to
                Pic1
        6. Press [CLEAR] from the homescreen to make sure there is nothing
                on the current line.
        7. Press [PRGM].
        8. Select MANBOARD from the EXEC column and press [ENTER].
        9. Press [ENTER] after "prgmMANBOARD" is displayed on the screen.
        
Menu:

        The mancala main menu looks as follows:

        MAIN MENU
        1:PLAY
        2:PLAYER OPTIONS
        3:ROCKS PER HOLE
        4:QUIT

        Selections:

        1:PLAY
        The Mancala board will be displayed, and you can start playing.

        2:PLAYER OPTIONS
        One of two menus will be displayed:
                PLAYER OPTIONS
                1:HUMAN VS HUMAN
                2:CALC VS CALC
                3:MAIN MENU

                        or

                PLAYER OPTIONS
                1:HUMAN VS HUMAN
                2:CALC VS CALC
                3:WHO'S FIRST?
                4:MAIN MENU

                Selections:

                1: HUMAN VS HUMAN

                Will set the play mode to two people playing on the same
                calculator, handing the calculator off each turn. (Or one
                person against him/herself :))  Will also take off the
                "WHO'S FIRST?" option, since PLAYER 1 will always be first.

                2: CALC VS CALC

                Will set the play mode to two people playing linked from one
                TI-82 to another.  Will also add the "WHO'S FIRST?" option to
                the menu.

                [3:WHO'S FIRST?] (OPTIONAL)

                Is displayed if the mode is set to "CALC VS CALC"
                A menu will be displayed upon selection:
                NOTE: MANCALA the calculators must be set to different options
                        for a successful linked game.

                        WHO'S FIRST?
                        1:ME
                        2:OPPONENT

                        Selections:

                        1:ME

                        Specifies that this calculator will play first when
                        the game is initiated.

                        2:OPPONENT

                        Specifies that this calculator will play second when
                        the game is initiated.

                3 or 4:MAIN MENU

                Returns the user to the main menu.

        3:ROCKS PER HOLE

        Lets the user input the number of rocks per hole (3-8) in the mancala
        game.
        NOTE: In CALC VS CALC mode, if the number-of-rocks settings are
                different, the number from the player who goes first will be
                used.

        4:QUIT

        Ends MANCALA, and returns the user to the homescreen.

Keys:
        Key(s):                 Action:
        -------                 -------
        left, right             Moves selection arrow.

        [ENTER]                 Plays the hole specified
                                by the selection arrow.

        [MODE]                  Aborts game, and returns
                                the user to the main menu.
                                (Note, in CALC VS CALC mode,
                                when it's the opponent's
                                turn, you may have to hold
                                this key down for a while)

Notes on CALC VS CALC mode:
        1. When connecting, the player who goes first should press enter
                when her/his opponent calculator displays "SUCCESS..."

        2. After each move (in the CALC VS CALC mode), you must press enter,
                as usual once, but you will have to press it again, because
                it is hard to use the calculator's "Get(" command without
                having one calculator paused.  Make sure you leave a
                sufficient amount of time between keypresses, since the
                other calculator must have enough time to get the information
                it needs.  If you realize somewhere through your game, that
                the numbers of rocks on your boards are different, or that
                both calculators say "OPPONENT" or "YOU" at the top, it is
                probably due to not leaving enough time between the enters.
                You will then have to press [MODE] and start again.  For this
                reason, it is a good idea to check a few of the numbers
                (for example the store houses) at each turn, and to exaggerate
                the length of time between the enters.

RULES FOR MANCALA (briefly!):
        Here are the rules to mancala, very briefly (if you still have
        questions, send E-mail to me (Sam Davies), davies@d-e.pvt.k12.nj.us)

        Object:
                To have the most rocks in your storehouse at the end of the
                game.

        Board layout:
                            Player 2           'o' = hole
                       +-----------------+     'O' = storehouse
Player 2's storehouse >|O o o o o o o o  |
                       |  o o o o o o o O|< Player 1's storehouse
                       +-----------------+
                            Player 1

        Play:
                Players alternate turns until the game is over
                On a turn:
                        The player whose turn it is, selects one of the
                        holes on his/her side (not storehouses) to play.
                        (in the game, by using the <- and -> arrows and
                        [ENTER])  When a player selects a hole to play,
                        she/he takes all of the rocks out of his/her hole,
                        and distributes one to each hole after that (in a
                        counter clockwise direction, including the player's
                        storehouse, but not the opponent's storehouse.)
                        
                        If the last rock distributed lands in the
                        player's storehouse, then the player gets a free turn,
                        and she/he may choose another hole to play on his/her
                        side.

                        If the player has an empty hole on her/his side, and
                        he/she puts a rock in it, then she/he captures
                        the contents of the hole at the same location on the
                        opponent's side, and puts them directly into his/her
                        storehouse.

                        EXAMPLE:
                        The board looks like this:

                      Player 2
                        +---------------+
                        |2 2 2 3 1 5 1  |
                        |  3 2 4 3 0 8 1|
                        +---------------+
                      Player 1   ^

                      Player 1 plays the hole indicated with a '^'.  The
                        result is the following, and a free turn for Player 1.

                      Player 2
                        +---------------+
                        |2 2 2 3 1 0 1  |
                        |  3 2 4 0 1 9 2|
                        +---------------+
                      Player 1       ^

                      For Player 1's free turn, he/she chooses the hole
                        indicated with a '^'.  The result is the following,
                        and an end to Player 1's turn (no free turn is given).

                      Player 2
                        +---------------+
                        |2 3 3 4 2 1 2  |
                        |  4 3 4 0 1 0 3|
                        +---------------+
                      Player 1       
                      
                        This should help with the sublties of the rules.  Make
                        sure you learn the rules before you just go in and
                        let the calculator figure out where the rocks should
                        go for you.

        Ending the game:            
                The game ends when all of the holes are empty on one side of
                the board.  When this happens, all of the left over rocks
                on the opposing side go directly into the storehouse of that
                side.
                The number of rocks in each storehouse are compared, and the
                player with the highest number of rocks wins.

        (ok, maybe the instructions weren't so breif after all :))

        Mancala is a great game, with a lot of strategy, once you get the hang
        of it.  I hope you like it!

        Questions/Comments/Corrections/Suggestions/Additions/etc.? please
        write me (Sam Davies) at davies@d-e.pvt.k12.nj.us .

Note: Just wanted to draw your attention to the fact that (correct me if I'm
        wrong) the first linked game in the archives that actually works
        linked.  If you want to know how it works, edit the program, or ask
        me.  Feel free to edit the program, but please don't distribute a
        modified version of this program.

PLEASE, GIVE PROGRAM TO EVERYONE YOU KNOW (who has an '82)
        THANX!          :-)
