"Release notes" for the chess snippet. 1. Compatibility ---------------- The snippet has been compiled and verified against stock Circle 3.1 only, and the installation instructions are written accordingly. 2. Installation instructions ---------------------------- a. Put the files screen.h, chess.c and chess.h into the src/ directory. screen.h should be overwritten (it contains additional background color support), so answer yes if asked. b. Add compilation instructions for chess.c into the Makefile: If you have a virgin Makefile, run "patch Makefile Makefile.patch" in the src directory and cross your fingers, otherwise (or if the patch failed) do the following manually in the Makefile: 1. Tag on "chess.o" to the list of o-files (OBJFILES) 2. Tag on "chess.c" to the list of c-files (CXREF_FILES) 3. Add the following two lines at the end: chess.o: chess.c chess.h structs.h handler.h utils.h sysdep.h screen.h $(CC) -c $(CFLAGS) chess.c The usual warning about tabs-to-spaces applies when copy-pasting them. c. Add the following lines into interpreter.c: Into the list of external ACMDs, add: ACMD(do_chess); and into the master command list, cmd_info, add: { "chess" , POS_DEAD , do_chess , 0, 0 }, d. Add the following line into the end of the #include list of db.c: #include "chess.h" and in the same file, the following line in function free_char: free_game_of_chess(ch->player_specials->chess); e. Add the following line into the end of struct player_special_data in structs.h struct game_of_chess *chess; f. type "make". 3. Known bugs and limitations ----------------------------- * The en passant move is not implemented. * The game does not recognize check mate or when the king has fallen; ending the game is up to the players by resigning explicitly. * Promotion is always to queen. * Clients without color support will find the layout to be ugly. * The game has no save or replay capability. * This was written a long time ago, so the code is most likely... err... suboptimal. Feel free to improve, and remember to share. 4. Licensing ------------ This code is released in the Public Domain. 5. PS ----- Live long and prosper. /Fredrik 051030 (fredrik_lannergren@yahoo.com)