Newton ChessPDA  v1.04 (ReadMe & Manual)  4/21/95Copyright 1995 PICA Inc.To obtain a registered copy of ChessPDA with the SAVE game feature enabledand including several 100-game and problem libraries, send $25 (U.S.) or $20(U.S) if you are a Newton User Group member (mention user group name) to:PICA Inc.Attn: Ken PresleyStar Route 1, MailBox 110AMcDaniels, KY 40152(502)257-8065(The default disk format is Macintosh, if you need DOS disk format, please send anote with your payment. Thank you!)For Newton ChessPDA Updates:Registered users of Newton ChessPDA can receive the latest update by sending$5 (U.S.) to the above address. Watch the on-line services for new features andother information concerning the latest update.DISCLAIMER===========Use this program at your own risk. I, Ken Presley, and PICA Inc., take no responsibility for any damages (monetary or otherwise) caused by, or as a result of, the use of this program. 																												INTRODUCTIONWelcome to Newton ChessPDA!   ChessPDA is a full-featured chess database for theApple Newton MessagePad (all Newton variants). ChessPDA allows you to enter gamesor chess problems (arbitrary positions) and replay them automatically or one moveat a time. You may also take back moves, temporarily mark positions for analysis,revert to previously marked positions, and much more!  ChessPDA does legal moveverification (legal verification can be turned off) and thus can be used by two playersas an electronic chessboard. You may also replay library games or chess problems.Several games and problems are included in the online version and are automaticallyloaded into the ChessPDA soup (the Newton's loose equivalent of a data file) that iscreated when ChessPDA is run for the first time.                                                       INSTALLATIONInstallation of Newton ChessPDA is simple. Just use the Newton Package Installeron the MAC diskette (or Newton Connection Kit, for MAC or DOS) to copy the NewtonChessPDA application package (Newt ChessPDA.pkg) to your Newton. You may alsooptionally copy any or all of the chess library application packages to your Newton.The chess library packages are named Newt ChessLib1.pkg (famous short games),Newt ChessLib2.pkg (Bobby Fischer's games), and Newt ChessLib3.pkg (Chess Lifechess problems). After installing the packages on your Newton, run the ChessPDApackage first which will automatically create the ChessPDA database soup withseveral sample games and problems already stored. After you take a few minutesto familiarize  yourself with ChessPDA's features, you may wish to run one of thechess library packages and transfer some or all of its games to the ChessPDA soup.After transferring some or all of the games from a chess library package to theChessPDA soup, you may remove the chess library package from your Newton, if youwish. See the SPECIAL NOTES at the end of this document for information on heapspace usage by ChessPDA and the chess library packages.																				FEATURES - THE BASICS, HOW TO USE                                   (How to Move, Replay, Save and Load a game)                                                       Making MovesThe basic operation of ChessPDA is very simple.  Whenever you launch ChessPDA onthe Newton, it is ready for you to enter a game.  To make a move, tap on the pieceyou wish to move, then tap on the move-to square (the square the piece is moving to).To make a castling move, just move the king, the rook will be moved for you (if legalmove verification is ON).  En passant pawn moves are also supported, simply tap onthe pawn to move, then tap on the normally blank en passant destination square, theenemy pawn being captured "in passing" will automatically be removed.                                              Replaying and Saving GamesAfter entering all of the moves for a game, you may replay the entire game. To replaythe game, simply tap the RESET button to return the pieces to their original startingpositions, then tap the PLAY button to replay one move at-a-time, or tap the AUTObutton to automatically replay the entire game.  When the AUTO button is hilited,simply tap it again to stop the automatic playback.  You may also save the game witha name of your choosing to the ChessPDA database soup by using the SAVE option fromthe ACTION button picker list (SAVE is enabled only in registered copies of ChessPDA).You may also take back moves at any time using the BACK button. If you are enteringan active game by tapping in moves, the BACK button takes back the last move andallows you to enter a different move (which is then recorded as the current move).If you are replaying an entire gamescore, the BACK button simply removes the lastmove from the board (i.e. the game goes in reverse to any previous move). The BACKbutton can be used repeatedly to take back an entire game's worth of moves. You mayalso start a new game at any time by tapping the NEW button.                                             Loading Library or Saved GamesTo load a previously saved or supplied library game use the LOAD option from theACTION button picker list.  When you choose the LOAD option, after a few secondsyou will be presented with a scrolling list of all games that are in the ChessPDAdatabase soup.  Simply scroll to the game of your choice (using the normal Newtonarrows at the bottom of the Newton screen) and then tap on the name of the gameto select it.  You may also navigate to a game by tapping on a letter in the special indexselector which is just below the list of games.  After selecting a game, then tap theclose box at the bottom right-hand corner of the games list screen to return to themain chessboard screen.  Then simply replay the game as described above. If the gamewas an incomplete game, you may also use the FINAL POSITION option to fast-forwardto the final position and then continue entering moves in the normal manner. Aftercompleting the moves for the game, simply SAVE it again.																				FEATURES - ADDITIONAL and ADVANCED                                (How to Mark Positions, Create and Save Problems)                                            Marking and Reverting PositionsChessPDA can be used for more advanced analysis of a game or problem by using theMARK and REVERT position features.  When creating or replaying a game, use the MARKposition option from the ACTION button picker list to temporarily save the position.This will turn off move recording and allow you to make various move "trys" or toanalyze a series of "what if moves".  After MARKing the position, make the move trysin the normal fashion.  The moves will be made on board, but will not be recorded.When you are done with the series of "side moves", use the REVERT position optionfrom the ACTION button picker list to revert the game to its previously MARKedposition.  Move recording will be turned ON again, and you can continue to record orreplay moves.  If you have another "sideline" to explore, simply MARK the positionagain.                             Creating and Saving Chess Problems or PositionsChessPDA can be used to create, store and replay chess problems that start from a certain position.  To replay a saved problem, simply use the LOAD game featuredescribed above.  The chess problem will start at the pre-determind position and youcan simply replay it as a normal game.  The supplied sample problems show you whichside is to move in the title of the problem, i.e. [W] (White) or [B] (Black) to move. Ifno additional description is supplied, it means White (or Black) to move and win.To create a chess problem or position with ChessPDA, first use the EDIT/LEGALoption from the ACTION button picker list to set up the position.  When EDIT/LEGALis selected, it toggles (ON/OFF) legal move verification.  With legal move verificationOFF, you may move the pieces to any square just by tapping on a piece, then tappingon the move-to square (just as you do in a "normal" legal move).  However, you mayalso remove a piece or "blank" a square by tapping on an empty square and then tappingon an occupied square (thus moving a "blank" square to an occupied square).  Youshould excercise care when removing a piece.  Once you remove it, it is gone and cannot be used again to help set up the current position. Of course, if you remove toomany of a certain type of piece such that you cannot setup the position, you can startover by choosing NEW game and EDIT/LEGAL again.  Once you have the position editedto your satisfaction, then choose EDIT/LEGAL to turn legal move verification back ON.The next step is to make ChessPDA "remember" the position using the RETAIN optionfrom the ACTION button picker list.  After you RETAIN the position, then make themoves for the chess problem or position in the normal manner.  If Black is to movefirst, use the "To move..." option from the ACTION button picker list to skip White'smove in the gamescore.  After recording the problem's moves, then use the SAVEoption from the ACTION button picker list as you would for a normal game (onceagain, this works only with registered copies of ChessPDA).  After SAVEing the chessproblem, you may use the LOAD option from the ACTION button picker list to load andreplay the chess problem at any time.                                          The Special Gamescore OptionsYou may wish to indicate in the gamescore how a game concluded.  Use the ACTIONbutton picker list options DRAWN game, RESIGN game, and MATE game to place one ofthese keywords as the last move in a gamescore.                                            ChessPDA Soup InformationIf you wish to examine or transfer soup entries using REMOVEIT or SLURPEE or othersimilar (and excellent!) shareware programs, here is a bit of ChessPDA soup info.A soup entry for ChessPDA consists of a frame with the following slots:{Version:1, Title:string, Moves:string, Position:string}An example ChessPDA soup frame is as follows:{Version:1, Title:"Kasparov-Karpov 1992",Moves:"f2-f4	(tab char)	e7-e6g2-g4	(tab char)	d8-h4mate",Position:"rnbqkbnrppppppppEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEPPPPPPPPRNBQKBNR"}Note that the above position string is the starting position and not the ending position.It is actually superfluous in the above example, because the example is a game (fool'smate, the shortest chess game possible) and not actually a chess problem, where thestarting position would be necessary information. Also note that the position stringcan be standard Forsythe-Edwards notation. The FEN position string for the aboveposition would be "rnbqkbnr/8p/8E/8E/8E/8E/8P/RNBQKBNR".                                                     FUTURE ENHANCEMENTSThat's about it for now.  In the future, we are planning a computer opponent option,when the Newton becomes fast enough to support it.  NewtonScript on current Newtonsis about 100 times slower than an old Mac Plus!!  But we are also the creators ofHyperNetwork CHESS for the Macintosh, and have written quite a bit of various chesssoftware, so we are trying to work around it.  We are also planning on creating moregame and problem libraries.  Please have fun!  We thank you for your support!                                                        SPECIAL NOTESAn advisory is in order here. ChessPDA uses quite a lot of Newton heap space undervarious playing conditions (also see revision history below). Under normal circum-stances the heap space requirements should prevent no problems. But if you save alarge number of games to the ChessPDA soup (more than about 100), you might ex-perience slowness or other problems. Much of this is due to the Newton OS and theway the standard scrolling proto-textlists were implemented in the Newton OS, andthus is beyond my control. We therefore recommend that you keep the number ofgames saved at any one time down to a dull roar . This also applies to the gamelibraries supplied with registered versions of ChessPDA. Since the currently suppliedlibraries total about 300 games, it would be wise when transferring them to theChessPDA soup to transfer them 50 or 100 games at a time.  We are currently tryingto work around the Newton OS and proto-textlist limititations. Subsequent versionsof ChessPDA will hopefully improve this situation. Thank you for your patience! (Youcan gain some additional heap space by closing the Extras drawer after launchingChessPDA.  Re-setting your Newton will also often reclaim "lost" heap space).                                                       REVISION HISTORYv1.01 - first release version - 3/11/95v1.02 - minor changes to help manage heap space - 3/17/95v1.03 - minor changes to various text messages - 3/25/95v1.04 - minor PLAY bug fixes, also added FINAL POSITION feature - 3/28/95