README for cgoban 1.9.13 ------------------------ Cgoban (Complete Goban) is for Unix systems with X11. It has the ability to be a computerized go board, view and edit smart-go files, and connect to go servers on the Internet. I'm keeping a mailing list of people interested in cgoban. I will keep the traffic very low. All I send out are announcements when new versions are ready, along with a description of what is new/fixed in the new version. If you want these announcements, then please send me mail at "wms@igoweb.org". HOW TO BUILD ------------ Cgoban uses the Gnu autoconf utility. To build and run it, follow these steps: 1) Unpack it. You must have done this already to read this file. Make sure that you "cd" into the cgoban directory (the directory that has this README in it). 2) Type "./configure". 3) Type "make". 4) Type "./cgoban". If all went well you should be running cgoban. Directions on using cgoban are all available through the "help" buttons. For a list of command line switches available, try "./cgoban -help". 5) You can copy the cgoban executable to a directory on your PATH after you have built it. Then you can delete all the rest of the files - once you have built the binary, you don't need anything else. INSTALLING ---------- cgoban's build directories (that is, the directory that has this README in it and all the subdirectories) take up a lot of disk space. After you build it, you need nothing but the binary. You can install it by running "make install" in the build directory; if you want to put it somewhere besides "/usr/games/bin", then you should edit the Makefile, set "PREFIX" to the place to put cgoban, then run "make install". After you've installed the binary, feel free to delete everything but the binary. IF YOU HAVE TROUBLE ------------------- The section below this lists some systems that are known to have trouble building. Check there to see if your system is on the list. The most common problem is systems that need special switches to run "cc". Your C compiler MUST be an ansi-compatible c compiler. If you have trouble with "./configure" or if you have trouble compiling, try setting your environment variable "CC" to be how to run your C compiler. For example, on some HP/UX systems "make" will break unless you set "CC" to be "cc -Aa -D_HPUX_SOURCE". On a csh-based system, you set this with: $ setenv CC "cc -Aa -D_HPUX_SOURCE" and on an sh-based system you need to type two lines: $ CC="cc -Aa -D_HPUX_SOURCE" $ export CC After setting CC, run "./configure" again and then "make" again to see if it works better. Another problem is finding the X11 includes and/or libraries. If they aren't founds when you are compiling, try running configure again, but this time try "./configure --x-includes=<DIR> --x-libraries=<DIR>" to tell configure where your X includes and X libraries are. KNOWN PROBLEM SYSTEMS --------------------- HP/UX Needs CC set as above, and sometimes needs the X directory set by hand (also as shown above). Linux Elf Old Linux Elf libcs have a bug in sscanf that prevents cgoban from working correctly. If you can see the "games" window in client mode, then everything is fine. If you get an error window when you press the "games" button on the client main window, then you need to get a newer version of libc and recompile. I've heard that libc 5.3.12 works, so if you get that version or later you should be OK. VAX/Ultrix Some systems have broken long longs. If you get an error referring to "__ll_lshift" when you try to build, then edit obj-*/configure.h to change "SIZEOF_LONG_LONG" to 0, then do a "make clean" then a "make". AIX There seems to be some broken AIX compilers out there (or it may be a bug in Cgoban that only shows up on AIX). If your AIX system doesn't work correctly try editing the Makefile and changing the CFLAGS line to have no "-O" switch. Then do a "make clean" then "make" and see if it works better. SPARC There are some Sparc X systems that have a bug. When you start up cgoban, your whole X server crashes. If this happens to you, get an upgrade from Sun (they do have a bug fix out that will fix this). FIREWALLS --------- See the help for the "setup" window. NOTE ---- Everybody complains that you can't resize the boards. Well, I'm working on it. In the meantime, PLEASE see the man page about the "cgoban -fontHeight" switch. With this you _can_ change the size of the board, but just not "on the fly". For example, "cgoban -fontHeight 14" will make the boards a little bit bigger (12 is the default); "cgoban -fontHeight 10" will make the boards a little bit smaller. ARENA MODE ---------- This is just for testing out go modem protocol programs. Run it like: $ cgoban -arena.games 4 -arena.size 9 -arena.komi 5.5 -arena.prog1 "myprog-new" -arena.prog2 "myprog-old" This will play myprog-new against myprog-old for four games, alternating who plays white and who plays black. The output will look like: 0 12.5 1 0.5 0 30.5 0 3.5 Which means that myprog-new won the first, third, and fourth games by 12.5, 30.5, and 3.5 points, while myprog-old won the second game by 0.5 points. Note that myprog-new and myprog-old *MUST* play until all dead stones are removed from the game, since the scoring function does *NOT* remove dead stones in arena mode. Scoring is done with Chinese rules so playing until all the dead stones are gone won't count against your score. Arena mode is kind of hacked in mostly for my benefit, so sorry but it isn't real user-friendly. THE grab_cgoban SHELL SCRIPT ---------------------------- If you use cgoban with a 12 point font, then the grab_cgoban shell script will nicely take a snapshot of a cgoban board and save it as a .gif file. For this script to work, you must have either the "imagemagick" or "pbmplus" packages installed. REVISION HISTORY ---------------- If the patchlevel changes, then it's just bug fixes. So for example 1.4.2 is just like 1.4.0 but some things that were broken are fixed. 0.0.0 Alpha version. Not all features are present. 0.1.0 First beta version. All features for the 1.0.0 release are present, but there are still some blatant bugs. 1.0.0 First full release. 1.1.0 Lots-O-bug fixes! Tons of them! Added support for "look" client command. Added a prompt for the client. Added ability to shift-click on a client game to move easily to a specific move number. Added "Say/Both/Kibitz" radio button. Improved games list window to show flags, be more resizable, and not crush columns together. 1.2.0 Spiffed up the configure window and added connect-with-telnet support for the firewalled folks out there. 1.3.0 Added the ability to try out variations on server games that you are observing or playing in. 1.4.0 Added file selector window, game info window, "Edit Game" buttons, and keeping server game info around after the game ends. 1.5.2 Added support for more than two servers, arena mode, and the anti-slip option. Also made it automatically run with no color if it can't get enough instead of just whining about it. 1.6.3 Added server "match" GUI. 1.9.12 Added patches submitted by Jeremy Cooper to record window size and fix an IGS bug. 1.9.13 Moved to Sourceforge. Various patches submitted by other people. $Source: /cvsroot/cgoban1/cgoban1/README,v $ $Revision: 1.7 $ $Date: 2002/06/13 17:51:02 $
