This file describes the binary distributions of xgospel 1.12d, an IGS client for Unix. The author of xgospel, Ton Hospel, does not have time to maintain xgospel currently, so with his permission I made changes to xgospel 1.10d and released this as 1.12d. The changes are documented below. To install xgospel from a binary distribution, you should just have to: - extract the tar.gz file with: gunzip < xgospel-1.12d.xxx.tar.gz | tar xvf - where xxx is the name of your system. gzip binaries are available from my site http://www.gzip.org - upate the resource file XGospel.res, changing at least user and password, and probably the window sizes too. If you are updating from a previous version of xgospel, you may prefer adapting your old resource file; look at least at the resources *preferredPaneSize to get the scrollable windows with correct default sizes, and the resource *playerToWidget to highlight your friends in the players and games window. - if you have never used xgospel before, you may have to load the resource file from your .xinitrc or your .xsession. If you don't know what a resource file is, try: cd $HOME; grep xrdb .xinitrc .xsession .Xclient If this shows something, your resource file is the parameter of xrdb; add the contents of XGospel.res at the end. Otherwise just add the line xrdb XGospel.res in your file .xinitrc, .xsession or .Xclient (whichever is used). For recent versions of X, it may be sufficient to copy XGospel.res to the directory $XAPPLRESDIR (usually ~/app-defaults) and rename it as XGospel For HP-UX, the library libXaw.sl may be missing from /usr/lib/X11R5. In this case, you must do: ln -s /usr/lib/X11R4/libX[am]?.sl . before running xgospel. You may also get the warning "Cannot convert string "builtin(CheckMark)" to type Pixmap" but you can ignore it, for example using "xgospel 2> /dev/null &" (ksh, bash) or "xgospel >& /dev/null" (csh, tcsh). xgospel sources and binaries for Linux, Solaris, SGI IRIX, HPUX and AIX are available on my go page http://www.teaser.fr/~jlgailly/go.html The XPM library (available in all Linux repositories and in ftp://ftp.x.org/contrib/libraries/xpm-3.4i.tar.gz) allows the nice board with a wooden aspect (xboard.xpm). I provide it for Solaris and AIX on http://www.teaser.fr/~jlgailly/go.html Put the library (libXpm.so.4.10 or libXpm.a) in a directory somewhere in your LD_LIBRARY_PATH. If you don't have an environment $LD_LIBRARY_PATH yet, set one with: setenv LD_LIBRARY_PATH /full_dir_containing_libXpm_so (for csh, tcsh) export LD_LIBRARY_PATH=/full_dir_containing_libXpm_so (for ksh, bash) Because of increasing incompatibilities between IGS and NNGS, xgospel 1.12d only works with IGS. If someone manages to make an xgospel version compatible with both servers, please send me the necessary patches. Frequently Asked Questions: 1) The games and players windows don't display properly. They draw a graph instead of listing the games or users. Read again the above paragraph about XGospel.res and the resources *preferredPaneSize 2) The Broadcast or Tell windows do not scroll properly Read again the xgospel README file and in particular: All text widgets in the program will scroll automatically as long as the caret is at the end of all text (and it will keep it at the end). So click at the end of all text to get correct scrolling. Create empty lines if necessary by scrolling the text with the scrollbar, then click somewhere in the empty lines. 3) I get full boards displayed in ASCII in the main window instead of a nice board window. You have incorrectly typed "toggle verbose on" or "toggle client off". Type "toggle client on" in the main window. 4) I have too much netlag. How can I reduce the traffic with IGS to the strict minimum? Set the resources *gamesTimeout and *whoTimeout to 0. If you really want to reduce traffic even further, add the command toggle quiet on in your file ~/.xgospelrc. You will then have to click expliclitly on the Update button to refresh the games list or the players list, or whenever xgospel hast lost sync with the server. (In particular if you are playing and your game is adjourned, xgospel can get in a bad state if quiet is on, so don't complain about xgospel if you have set quiet on.) 5) I get "Warning: Cannot convert string "#FFA54F" to type Pixel" You do not have enough color cells available. If possible start X in 16 or 24 bit mode to avoid this. On Linux, use "startx -- -bpp 16". If you have to stay in 8-bit mode, exit Netscape or other color-greedy programs before starting xgospel. (You can also start netscape with the -install option to force a private color map in netscape and thus avoid eating colors in the shared color map.) 6) xgospel crashes, both with the precompiled version on http://gailly.net/go.html and the version I recompiled. Make sure that you have not replaced libXaw with a a version from Xaw3d. Use the standard libXaw. If you are on Linux, type: ldd xgospel If you get a line such as: libXaw.so.6 => /usr/X11R6/lib/Xaw3d/libXaw.so.6 (0x40028000) then you have the problem. Either use the standard libXaw, or recompile xgospel with: make clean ./configure --with-xaw3d make Jean-loup Gailly xgospel@gailly.net jl on IGS Version 1.12d (Gabriel de Dietrich, 27 Oct 1999) - add resource *board.flipBoard to see the board from white's position instead of black - add command history with the up and down arrow keys in the main window - suppress the komi menu when playing, add "even" and "no komi" in the handicap menu. Version 1.12c2 (Jean-loup Gailly, 22 sept 1999) - work around undocumented change in IGS protocol for undo (avoid parse error for undo of a capture). - avoid parse error with "game saved" message after the third pass - explain how to ignore tells from someone at the end of the README file - add description of resource *serverTimeout in XGospel.res Version 1.12c1 (Jean-loup Gailly, 22 Jan 1999) - take into account new prisonners for the Copy command in analyse boards (glukichipote) - enable the Score command for analyse boards only for boards copied from the most recent position (to get correct count of prisonners) - raise a tell window on beep by default (Minh Quy) - support undo of multiple moves in teach games - conform to the SGF FF[4] specification when writing SGF files http://www.sbox.tu-graz.ac.at/home/h/hollosi/sgf/ - deal with an undocumented change in IGS protocol which caused a parse error for bets (Jan Ramon) - deal with change in IGS protocol for adjourned games (display adjourn in game window only, not in main) - work around an IGS 'feature' (impossible to use teach on a 'request' game) - for automatic replay of teach game, send "forward" commands only for "teach sgfname" not "teach 19". - require the Enter key to change a game title or channel title - avoid compilation warnings on SGI Version 1.12c (Jean-loup Gailly, 10 Jan 1999) - click control-left on entry in games window to get the stats of both players, alt-left to get the stats in the main window. - if autoReply is set, do not popup a game status board when the game terminates - add keyboard shortcut alt-a to toggle autoreply (Minh Quy) - add keyboard shortcuts alt-o to toggle open and alt-l to toggle looking. Note that these two can also be changed with the mouse in the stats window for yourself (obtained with the Commands menu of the main window). - move "quit" shortcut to alt-q for uniformity (was control-c) - add menus to set handicap and komi when I'm playing (Steve Cahill) - fix handling of komi management protocol Version 1.12b3 (Jean-loup Gailly, 7 Jan 1999) - use 210.134.78.91 as default site (igs.joyjoy.net deconnects too often) - avoid segmentation fault after quit (glukimet3lunes%apercevoir) - remove debug output for stats, left by mistake Version 1.12b2 (Jean-loup Gailly, 4 Jan 1999) - add the time for messages received while auto-reply is set (Minh Quy) - do not duplicate the results lines for repeated stats (Mark Vytlacil) - nicer xgospel icon (Gabriel de Dietrich) - support the "name" IGS command - adapt to documented change in the IGS protocol for illegal moves - avoid a parse error for future extensions of the IGS protocol Version 1.12b1 (Jean-loup Gailly, 16 Dec 1998) - allow automatic replay of "teach sgfname" games with the replay option, without having to click on the "Forw" button for each move. - deal with an undocumented change in the IGS protocol which caused a parse error for the "time" command. - avoid parse error after an illegal move (documented change in IGS protocol) (Cyril Banderier) - do not popup a challenge window when autoReply is set. (Minh Quy) - add resource *minButtonTime to avoid clickos: the button up event must be at the same intersection as the button down event and separated by at least minButtonTime milliseconds (default 50 ms) to be sent as a move. If you are subject to frequent clickos, increase this to 200 or 300. If you want to force yourself to think at least one second before a move, set it to 1000. - shorten the icon name for tells. You can change it with the resource *tell.iconName (default %N[%n]%A to get name, strength and *). (glukenveutoujoursplus) - better documentation of the IGS protocol in goserver.l - support the cmatch (capture match) command - support hidden channels (which can be created by pros for teaching games) Version 1.12b (Jean-loup Gailly, 23 Nov 1998) - deal with an undocumented change in IGS protocol which caused "say" messages to appear in the main window. - deal with an undocumented change in IGS protocol which caused a parse error for an adjourn request made by the opponent - Activates tell button on stats window. Restores toggle action of tell button on challenge window (Mark Vytlacil) - set "raise" default to be false everywhere except for tell windows. - explain how to mark players permanently in XGospel.res and the online help (see the resource *playerToWidget). - in analyse boards, the Copy button did not reset the prisonners count (glue) - in the online help for my stats, warn that Quiet and Verbose should Off, and Client should be On. - add help for shift+left button on my info in my stats window. - avoid warnings for redeclaration of _StringList and for static functions. - suppress duplicate "on" in "Logging into IGS on on" Version 1.12a (Jean-loup Gailly, 21 Oct 1998) - add the Help button (Cyril Banderier) - add help on the changeable fields in my own stats (info and all toggles) - click with control-left button on a player in the players window to mark this player, changing its widget color. Marking a player can be used to remember a player who declined a game request, or who escaped, etc... Use the resources *players*set*playerEntryMarked.background and foreground to change the default marking colors. (Challenging a player has been moved to control-right button.) - Ctrl-C quits the server and xgospel (Minh Quy) - to avoid retyping an old command, click somewhere in the line of the old command in the main window then press Enter (glulaflemmarde) - Echo a command in ~/.xgospelrc if it starts with > Force a prompt after execution of ~/.xgospelrc (User button). - Display the 4 names in the board title for team games - avoid "assumed adjourned" when observing team games - avoid parse error for undo in team games. However igs still has a bug undo in team games (does not notify all players of the undo). - bug fix (correction de cafard) in exact rating display - avoid sending duplicate "observe" commands which sometimes result in unobserve. (observe shouldn't be a toggle since the unobserve command exists) - ignore resource *useSay when playing in a team game (tell not allowed). - At the end of a teach game, display "There are no more moves" in game window instead of main window. - update the default window sizes to take into account the new buttons - use more reasonable defaults for many resources (beep off, etc...) - use the nice board.xpm as default background. If you get a message "Cannot convert string "board.xpm" to type Pixmap" then move the file board.xpm to your current directory before starting xgospel, or add the following resource in your resource file (update "full_directory_here"): xgospel*board.backgroundPixmap: pixmap(/full_directory_here/board.xpm) - add some variety in the cursors for the buttons of the main window - do not keep the Update button highlighted in Games and Players windows Version 1.12 (Jean-loup Gailly, 8 Oct 1998) - Add a Score button to analyze boards. To score, click on the Score button, then click on dead stones. The current score is displayed in the board title. If you clicked on a wrong point, click on Undo; to start scoring again from the current game position, click on Copy. (Minh Quy & glukidicasraibiensi) - Add resources *markTerritories and *markDame (default true), used when scoring. To change the dame color use *board*dameColor (default green). - Enter scoring mode after 3 passes in my own game. Check all dames (shown in green by default) and the score (displayed in the window title) before clicking on Done. To avoid entering in scoring mode after 3 passes, set *autoScore to false (default true). If you want to score your own game before the 3 passes, use the "analyze" command and click on the Score button of the Analyze board. To switch between scoring mode and normal mode in your game window, toggle "score" in the Options menu. The old "score" button has been renamed "server score". (The server score and the local score should be identical so you should no longer have to check the server score.) - In the analyze board, the left button now removes a single stone if there is one, or a stone group in scoring mode. The middle button adds a black stone, the right button adds a white stone. - display the game result in the analyze board of finished games. - Set default site to igs.joyjoy.net. To use igs.nuri.net until the server moves, start xgospel with "xgospel -site igs.nuri.net &" or add the line "xgospel*site: igs.nuri.net" (wihout the quotes) in your resource file. - Pop up the players window if an important person connects to IGS and if *players*raise.state is true. A person is important if its importance is >= minImportantRank. (See resource *playerImportance). - display exact rating even when using an alias for "stats" (glukisuggere) - display move number for pass, undo, etc... (glukidemandencore) - add resource *useSay. Set it to false if you do not want your conversation with your opponent to be saved in the game record. (glukinaretpas) - pop up the stats window earlier, update exact rating and number of stored games when the IGS answers come back. - avoid parse errors for illegal move and done message (Cyril Banderier) - avoid parse error for "teach invalid-game" (Minh Quy) - define RAND_MAX for SunOS 4.x (Cyril Banderier) - comment out resources with correct default values in XGospel.res - fix creation/update of stones_gc in GoBoard.c - fix DownFromBottom error when reloading a game containing multiple passes.