FAQ.html

   1 <HTML><HEAD><TITLE>
   2 XBoard and WinBoard: Frequently Asked Questions</TITLE></HEAD>
   3 <BODY>
   4 <H1>XBoard and WinBoard: Frequently Asked Questions</H1>
   5
   6 This document answers some frequently asked questions about the
   7 graphical chess interfaces XBoard and WinBoard.
   8 A hyperlinked version of this FAQ is available on
   9 the Web through the page
  10 <A HREF=
  11 "http://www.tim-mann.org/chess.html"
  12 >http://www.tim-mann.org/chess.html</A>.
  13
  14 <HR>
  15 <H2>Outline</H2>
  16
  17 <UL>
  18 <LI><A HREF="#[A0]">[A] Introduction and hot topics</A></LI>
  19 <LI><A HREF="#[B0]">[B] XBoard and WinBoard</A></LI>
  20 <LI><A HREF="#[C0]">[C] XBoard and WinBoard, bugs and problems</A></LI>
  21 <LI><A HREF="#[D0]">[D] Crafty and other topics</A></LI>
  22 </UL>
  23
  24 <HR>
  25 <H2>Detailed contents</H2>
  26
  27 <UL>
  28 <LI><A NAME="[A0]" HREF="#[A]">[A] Introduction and hot topics</A></LI>
  29 <UL>
  30 <LI><a href="#[A.1]">[A.1] What are XBoard and WinBoard?</a></li>
  31 <LI><A HREF="#[A.2]">[A.2] Where can I get chess information and chess
  32   software?</A></LI>
  33 <LI><A HREF="#[A.3]">[A.3] What are the current version numbers for
  34   XBoard and WinBoard?</A></LI>
  35 <LI><A HREF="#[A.4]">[A.4] Who is working on this project?</A></LI>
  36 <LI><A HREF="#[A.5]">[A.5] How do I report bugs, offer help, etc.?</A></LI>
  37 <LI><a href="#[A.6]">[A.6] What are the future plans for XBoard and
  38   WinBoard?</A></LI>
  39 </UL>
  40
  41 <LI><A NAME="[B0]" HREF="#[B]">[B] XBoard and WinBoard</A></LI>
  42 <UL>
  43 <LI><A HREF="#[B.1]">[B.1] What is XBoard?</A></LI>
  44 <LI><A HREF="#[B.2]">[B.2] Is there an XBoard for Microsoft Windows?  What is
  45   WinBoard?  How do I install WinBoard?</A></LI>
  46 <LI><A HREF="#[B.3]">[B.3] Is there an XBoard for the Amiga?  What is
  47   AmyBoard?</A></LI>
  48 <LI><A HREF="#[B.4]">[B.4] Is there an XBoard for the Macintosh?</A></LI>
  49 <LI><A HREF="#[B.5]">[B.5] Does XBoard run on VMS?</A></LI>
  50 <LI><A HREF="#[B.6]">[B.6] What is cmail?</A></LI>
  51 <LI><A HREF="#[B.7]">[B.7] How do I build XBoard?  Do I have to have
  52   gcc?</A></LI>
  53 <LI><A HREF="#[B.8]">[B.8] Can I use XBoard or WinBoard to play a game
  54   of chess with another human?</A></LI>
  55 <LI><A HREF="#[B.9]">[B.9] Will WinBoard run on Windows 3.1?
  56   How about Windows CE (also known as Pocket PC)?</A></LI>
  57 <LI><A HREF="#[B.10]">[B.10] How do I use XBoard or WinBoard as an external
  58   viewer for PGN files with my Web browser?</A></LI>
  59 <LI><A HREF="#[B.11]">[B.11] How do I use WinBoard as an external viewer for
  60   PGN files with the MS Windows File Manager or Explorer?</A></LI>
  61 <LI><A HREF="#[B.12]">[B.12] How do I use ICC timestamp or FICS timeseal
  62   with XBoard?</A></LI>
  63 <LI><A HREF="#[B.13]">[B.13] How do I use ICC timestamp or FICS timeseal
  64   with WinBoard?</A></LI>
  65 <LI><A HREF="#[B.14]">[B.14] How do I play bughouse with XBoard or WinBoard?
  66 </A></LI>
  67 <li><a href="#[B.16]">[B.16]
  68   What is Zippy?  How can I interface a chess program to the Internet
  69   Chess Servers?</a></li>
  70 <li><a href="#[B.17]">[B.17]
  71   How can I interface my own chess program to XBoard or WinBoard?</a></li>
  72 <li><a href="#[B.18]">[B.18]
  73   How can I recompile WinBoard from source?</a></li>
  74 <li><a href="#[B.19]">[B.19]
  75   How can I use XBoard or WinBoard to talk
  76   to an Internet Chess Server through a firewall or proxy?</a></li>
  77 <li><a href="#[B.20]">[B.20]
  78   How can I use XBoard or WinBoard on chess.net with accuclock?</a></li>
  79 <li><a href="#[B.21]">[B.21]
  80   Can I get Zippy to do one or more ICS commands automatically at the
  81   start or end of each game?</a></li>
  82 <li><a href="#[B.22]">[B.22]
  83   How do I print from WinBoard?</a></li>
  84 <li><a href="#[B.23]">[B.23]
  85   Can I get Zippy to automatically reconnect to ICS when its connection
  86   breaks?</a></li>
  87 <li><a href="#[B.24]">[B.24]
  88   The chess engines are too strong and always beat me.  How can I adjust
  89   the difficulty level to make them weaker?</a></li>
  90 <li><a href="#[B.25]">[B.25]
  91   May I use the piece bitmaps from XBoard/WinBoard in my own program?</a></li>
  92
  93 </UL>
  94
  95 <LI><A NAME="[C0]" HREF="#[C]">[C] XBoard and WinBoard, bugs and
  96   problems</A></LI>
  97 <UL>
  98 <LI><A HREF="#[C.1]">[C.1] I can't build XBoard because the
  99   X11/Xaw/... include files are not found.</A></LI>
 100 <LI><A HREF="#[C.2]">[C.2] Configuring or building XBoard fails due to
 101   missing header files, missing libraries, or undefined symbols.</a></li>
 102 <LI><A HREF="#[C.3]">[C.3] I have problems using WinBoard on ICS with a modem.
 103   I'm not running SLIP or PPP, but just dialing in to an ordinary login account
 104 ("shell account").</A></LI>
 105 <LI><A HREF="#[C.4]">[C.4]
 106   I have problems using WinBoard on ICS with Windows 95 and SLIP
 107   or PPP.  When trying to start up, it gets the error "Address family
 108   not supported by protocol family" (or some equally strange message).
 109 </A></LI>
 110 <LI><A HREF="#[C.5]">[C.5] When I try to run WinBoard, I get the message
 111   "Failed to start chess program gnuchess on localhost: NO LANGFILE (file
 112   gnuchess.lan not found)".</A></LI>
 113 <LI><A HREF="#[C.6]">[C.6] I want to use XBoard or WinBoard as an Internet
 114   Chess Server interface, but the ICS Client option is grayed out on the
 115   menu.</A></LI>
 116 <LI><A HREF="#[C.7]">[C.7] How do I give command-line options to
 117   a Windows program like WinBoard?</A></LI>
 118 <LI><A HREF="#[C.9]">[C.9]
 119   When I exit from WinBoard after using it to play against a chess
 120   program on my machine, the chess program keeps running in the background.
 121 </A></LI>
 122 <li><a href="#[C.12]">[C.12]
 123   Why do my ICS
 124   opponents often get extra time after they make their moves?
 125   Why do I sometimes lose time off my clock after I make my move?
 126 </a></li>
 127 <li><a href="#[C.13]">[C.13]
 128   I can't run WinBoard unless I delete the WinBoard.ini file each time!
 129 </a></li>
 130 <li><a href="#[C.15]">[C.15]
 131   I get errors compiling XBoard's parser.c.
 132 </a></li>
 133 <li><a href="#[C.16]">[C.16]
 134   I get an error building WinBoard from source because "flex" is not found.
 135 </a></li>
 136 <li><a href="#[C.17]">[C.17]
 137   XBoard hangs shortly after connecting to an ICS when used with dxterm,
 138   cmdtool, dtterm, kterm, konsole, or other substitutes for xterm.
 139 </a></li>
 140 <li><a href="#[C.18]">[C.18]
 141   The WinBoard pieces show up in the wrong colors, appear distorted,
 142   or are not visible at all.
 143 </a></li>
 144 <LI><A HREF="#[C.19]">[C.19] XBoard or WinBoard tells me
 145 "Error: first chess program (...) exited unexpectedly".</A></LI>
 146 <li><a href="#[C.20]">[C.20]
 147   XBoard tells me "Warning: Cannot allocate colormap entry", or
 148   "too few colors available; trying monochrome mode", or
 149   "XPM pieces cannot be used in monochrome mode".
 150 </a></li>
 151 <li><a href="#[C.21]">[C.21]
 152   When I log in to freechess.org, the Enter key doesn't work, and I
 153   have to use Ctrl+J instead.  But when I use WinBoard, Ctrl+J doesn't
 154   work either, so I'm stuck.
 155 </a></li>
 156 <li><a href="#[C.22]">[C.22]
 157   XBoard says, "Failed to start first chess program gnuchessx
 158   on localhost: gnuchessx: No such file or directory."
 159 </a></li>
 160 </UL>
 161
 162 <LI><A NAME="[D0]" HREF="#[D]">[D] Crafty and other topics</A></LI>
 163 <UL>
 164 <LI><A HREF="#[D.1]">[D.1] What is XChess?</A></LI>
 165 <LI><A HREF="#[D.2]">[D.2] What is Winsock Chess?</A></LI>
 166 <LI><A HREF="#[D.3]">[D.3] What is Crafty?</A></LI>
 167 <LI><A HREF="#[D.4]">[D.4] How do I use Crafty with XBoard?</A></LI>
 168 <LI><A HREF="#[D.5]">[D.5] How do I use Crafty with WinBoard?</A></LI>
 169 <LI><A HREF="#[D.6]">[D.6] How do I use GNU Chess 5 with XBoard?</A></LI>
 170 </UL>
 171 </UL>
 172
 173 <HR>
 174 <H2><A NAME="[A]">[A] Introduction and hot topics</A></H2>
 175 <HR>
 176 <H3><A NAME="[A.1]">[A.1] What are XBoard and WinBoard?</A></H3>
 177
 178 XBoard and WinBoard are graphical user interfaces for chess.
 179 XBoard runs with the X Window System on Unix systems (including
 180 GNU/Linux); see topic
 181 <A HREF="#[B.1]">[B.1]</A>.
 182 WinBoard runs on true 32-bit Microsoft Windows operating
 183 systems, such as Windows 95, 98, NT,
 184 2000, ME, XP, and should continue to work
 185 on future 32-bit Windows systems.  It does
 186 not work on Windows CE (also known as Pocket PC), nor does it work on
 187 16-bit Windows systems such as Windows 3.1.  See topic
 188 <A HREF="#[B.2]">[B.2]</A>.
 189
 190 <HR>
 191 <H3><A NAME="[A.2]">[A.2] Where can I get chess information and chess
 192 software?</A></H3>
 193
 194 As a shortcut to most things mentioned in this FAQ, try my Chess Web page,
 195 <A HREF=
 196 "http://www.tim-mann.org/chess.html"
 197 >http://www.tim-mann.org/chess.html</A>.
 198 My Web page is the best place to get the latest versions of XBoard and WinBoard
 199 and the most up-to-date version of this FAQ.
 200
 201 <p>If you have other questions about XBoard/WinBoard that aren't answered
 202 in this FAQ, you can try Aaron Tay's WinBoard and Chess Engines FAQ, at
 203 <a href="http://www.aarontay.per.sg/Winboard/"
 204 >http://www.aarontay.per.sg/Winboard/</a>.
 205
 206 <P>For general news and information about chess, try the newsgroup hierarchy
 207 rec.games.chess.*, especially the groups rec.games.chess.misc and
 208 rec.games.chess.computer.  Both of the latter groups have very informative
 209 FAQs maintained by Steve Pribut; look for them on the newsgroups or at
 210 <A HREF=
 211 "http://www.clark.net/pub/pribut/chess.html"
 212 >http://www.clark.net/pub/pribut/chess.html</A>.
 213
 214 <P>Like other GNU software, you can get XBoard, and
 215 WinBoard by anonymous FTP from
 216 <A HREF=
 217 "ftp://ftp.gnu.org/pub/gnu/"
 218 >ftp://ftp.gnu.org/pub/gnu/</A>
 219 and its many mirror sites.  Look in the subdirectories xboard, and winboard.
 220 The .tar.gz suffix on the files there indicates they were packed with tar
 221 and compressed with gzip.  The .exe or .zip suffixes indicate files that
 222 were packed and compressed with zip.
 223
 224 <P>For other chess software, try the Internet Chess Library.  Use anonymous FTP
 225 to connect to ftp.freechess.org, or go to the Web page
 226 <A HREF=
 227 "http://www.freechess.org/"
 228 >http://www.freechess.org/</A>.
 229 You can get chess software, game
 230 collections, the FAQ file for rec.games.chess, and other chess-related
 231 material there, in the directory pub/chess.  The FTP server can
 232 automatically decompress files for you as you download them, useful if you
 233 don't have gzip.
 234
 235 <P>Here is a sample anonymous ftp session.  Some of the ftp server's responses
 236 are abbreviated, but all the commands you must type are included.
 237
 238 <p><PRE>
 239     % ftp ftp.gnu.org
 240     Connected to ftp.gnu.org
 241     Name: anonymous
 242     Password: your-email-address@your-site
 243     ftp&gt; binary
 244     200 Type set to I.
 245     ftp&gt; cd /pub/gnu/xboard
 246     ftp&gt; dir
 247     -rw-r--r-- 1 14910 wheel  1057625 May 20 00:25 xboard-4.2.7.tar.gz
 248     ftp&gt; get xboard-4.2.7.tar.gz
 249     150 BINARY connection for xboard-4.2.7.tar.gz (1057625 bytes).
 250     226 Transfer complete.
 251     ftp&gt; quit
 252 </PRE>
 253
 254 <HR>
 255 <H3><A NAME="[A.3]">[A.3] What are the current version numbers for
 256 XBoard and WinBoard?</A></H3>
 257
 258 At this writing, the current version numbers are:
 259
 260 <UL>
 261 <LI>XBoard 4.2.7</LI>
 262 <LI>WinBoard 4.2.7</LI>
 263 </UL>
 264
 265 <HR>
 266 <H3><A NAME="[A.4]">[A.4] Who is working on this project?</A></H3>
 267
 268 Tim Mann maintains this FAQ and is the lead developer on XBoard and
 269 WinBoard, but he has little time to work on the project.  Many others
 270 occasionally contribute suggestions and snippets of code, for which we
 271 are grateful.
 272
 273 <HR>
 274 <H3><A NAME="[A.5]">[A.5] How do I report bugs, offer help, etc.?</A></H3>
 275
 276 <P>At present, bug reports, suggestions, and offers to help on XBoard
 277 or WinBoard should be sent directly to
 278 tim<a name="nospam">@</a>tim-mann.org (Tim Mann).
 279 Beginner questions and discussion about the program may get faster
 280 answers on the WinBoard Forum at <a
 281 href="http://f11.parsimony.net/forum16635/"
 282 >http://f11.parsimony.net/forum16635/</a>.  If you are developing a
 283 chess engine that works with XBoard or WinBoard (or an alternative
 284 GUI that works with such engines), see the Chess Engines mailing
 285 list, hosted at
 286 <a href="http://groups.yahoo.com/group/chess-engines"
 287 >http://groups.yahoo.com/group/chess-engines</a>.
 288
 289 <P>Any time you want to report a possible bug in XBoard or WinBoard,
 290 we need to know exactly what you did, and exactly what error (or
 291 other) messages you got.
 292
 293 <P>If you are using Unix, run the "script" program, run XBoard with
 294 the -debug flag (if you get as far as running it), do whatever is
 295 necessary to reproduce the problem, type "exit" to the shell, and mail
 296 us the resulting typescript file.  We also need to know what
 297 hardware/operating system combination you are using.  The command
 298 "uname -a" will usually tell you this; include its output in your
 299 typescript.
 300
 301 <P>If you are using MS Windows, run WinBoard with the -debug flag, and
 302 send us a copy of the WinBoard.debug file.  If you aren't sure how to
 303 add command-line flags to WinBoard, you can hit Ctrl+Alt+F12 to create
 304 a WinBoard.debug file after WinBoard starts, but that is not as good,
 305 because a few messages that would have been printed at the start are
 306 lost.
 307
 308 <p>Either way, please send us the exact text of the commands you typed
 309 and the output you got, not just your recollection of approximately
 310 what they were.  The messages may seem meaningless to you, but they
 311 are very meaningful to us and essential for diagnosing problems.
 312
 313 <hr>
 314 <h3><a name="[A.6]">[A.6] What are the future plans for XBoard and
 315   WinBoard?</a></h3>
 316
 317 <p>There are no firm plans. As with most free software projects, the
 318 next release will happen when it happens -- or it may never happen.
 319 This has always been the policy for XBoard/WinBoard.  Releases have
 320 never been promised in specific time frames.
 321
 322 <p>Currently, there are few developments in the pipeline, they have
 323 not gotten far, and they are moving along very slowly, if at all.
 324 This is mainly because I no longer enjoy working on the project.  I
 325 have many other things to do that are more important, more fun, or
 326 both, and they more than fill my waking hours.  If another qualified
 327 programmer would like to take over the project, I'd welcome that.
 328 Please contact me if you're interested.
 329
 330 <p>That said, here are some items that have a nonzero probability of
 331 happening in finite time.  Most of the probabilities are actually
 332 pretty small.
 333
 334 <ul>
 335 <li>Small bug fixes.  Occasionally someone sends me a fix, or reports
 336 a small bug very clearly so that I'm able to fix it in a few minutes
 337 work.  At this writing (May 26, 2003), all the bug fixes I've made
 338 in my sources are included in version 4.2.7.<p>
 339
 340 <li>Protocol version 3.  The members of the chess engine authors'
 341 mailing list and I discussed a set of proposed features for the next
 342 version of the XBoard/WinBoard chess engine communication protocol.
 343 This project has gotten only as far as that discussion took it: I've
 344 saved the proposal that I posted and all the comments on it, but I've
 345 done roughly nothing on revising the protocol spec to fold in the
 346 changes, and nothing on implementing any of them.  This is too bad;
 347 revising the engine protocol was the last part of the project that I
 348 really thought was important.  It is perhaps less important now with
 349 the increasing popularity of the UCI protocol, but it would still be
 350 nice to clean up some remaining deficiencies of the XBoard/WinBoard
 351 protocol.<p>
 352
 353 <li>Contributed features.  Several people have mailed me code to
 354 add various features.  I've had some these contributions for over a
 355 year and haven't found time to even try them, much less integrate them
 356 into a release.  Recently I've put them all up on my Web site in case
 357 others would like to try them out.<p>
 358
 359 <li>Code move into CVS on Savannah.  I've done nothing on this so far,
 360 but it would be nice in order to facilitate others working on the
 361 code.  It would also provide an easier way for people to get bug fixes
 362 that I haven't rolled into a release yet.  This wouldn't be terribly
 363 useful for most WinBoard users, though, since the average WinBoard
 364 user would have absolutely no idea how to download code from CVS and
 365 compile it.<p> </ul>
 366
 367 <p>There is nothing else in the works.
 368
 369 <HR>
 370 <H2><A NAME="[B]">[B] XBoard and WinBoard</A></H2>
 371 <HR>
 372 <H3><A NAME="[B.1]">[B.1] What is XBoard?</A></H3>
 373
 374 XBoard is a graphical user interface for chess.  It displays a
 375 chessboard on the screen, accepts moves made with the mouse, and loads
 376 and saves games in Portable Game Notation (PGN).  XBoard is free software.
 377 It serves as a front-end for many different chess services, including:
 378
 379 <p><strong>Chess engines</strong> that will run on your machine and
 380 play a game against you or help you analyze, such as GNU Chess and
 381 Crafty (topic <A HREF="#[D.3]">[D.3]</A> below).
 382
 383 <p><strong>Chess servers</strong> on the Internet, where you can
 384 connect to play chess with people from all over the world, watch other
 385 users play, or just hang out and chat.
 386
 387 <p><strong>Correspondence chess</strong> played by electronic
 388 mail. The cmail program (topic <A HREF="#[B.6]">[B.6]</A> below)
 389 automates the tasks of parsing email from your opponent, playing his
 390 moves out on your board, and mailing your reply move after you've
 391 chosen it.
 392
 393 <p><strong>The Web</strong> and your own saved games. You can use
 394 XBoard as a helper application to view PGN games in your
 395 Web browser, or to load and save your own PGN files.
 396
 397 <P>XBoard runs under Unix or Unix-compatible systems.  It requires the
 398 X Window System, version X11R4 or later.  There are also ports of
 399 XBoard to 32-bit Microsoft Windows and to
 400 the Amiga.  See topics <A HREF="#[B.2]">[B.2]</A> and <A
 401 HREF="#[B.3]">[B.3]</A> respectively.
 402
 403 <HR>
 404 <H3><A NAME="[B.2]">[B.2] Is there an XBoard for Microsoft Windows?  What is WinBoard?  How do I install WinBoard?</A></H3>
 405
 406 WinBoard is a port of XBoard to 32-bit Microsoft Windows systems, such
 407 as Windows 95, 98, NT, 2000, ME, and XP.  It uses the same back end
 408 chess code as XBoard, but the front end graphics code is a complete
 409 rewrite.  WinBoard is free software.
 410
 411 <P>The WinBoard distribution includes a port of GNU Chess to Win32.
 412 The GNU Chess port is distributed in executable form, with instructions for
 413 rebuilding it from the standard GNU Chess sources (available separately).  You
 414 should have at least 16 to 24 MB of memory to run GNU Chess with WinBoard.
 415
 416 <P>The WinBoard distribution also includes the ICC timestamp and FICS
 417 timeseal programs (topic <A HREF="#[B.12]">[B.12]</A>).
 418
 419 <P>cmail (topic <A HREF="#[B.6]">[B.6]</A>) has not been ported to
 420 Windows.  All the other XBoard functions are included in WinBoard.
 421 The International Email Chess Group web site at <a
 422 href="http://www.iecg.org/" >http://www.iecg.org/</a> recommends
 423 ECTool (<a href="http://www.ectool.nu/" >http://www.ectool.nu/</a>)
 424 for playing correspondence chess under Windows.
 425
 426 <p>You install WinBoard as follows. Download the WinBoard package to
 427 your PC (see topic <A HREF="#[A.2]">[A.2]</A>).  It will be a file
 428 with a name like winboard-4_0_0.exe.  Double-click on this file
 429 in the Explorer or File Manager to run it. Follow the on-screen
 430 prompts.
 431
 432 <HR>
 433 <H3><A NAME="[B.3]">[B.3] Is there an XBoard for the Amiga?  What is AmyBoard?</A></H3>
 434
 435 AmyBoard is a port of XBoard to the Amiga, by Jochen Wiedmann.
 436 The distribution includes a port of GNU Chess.
 437 AmyBoard is free software.
 438
 439 <p>The current version of AmyBoard is 330.5 (based on XBoard 3.3.0).
 440 No one is currently maintaining it.
 441
 442 <P>System requirements:
 443
 444 <UL>
 445 <LI>An Amiga (obviously :-), running OS 2.04 or later, 2Mb RAM or more.</LI>
 446 <LI>MUI 2.0 or later.</LI>
 447 <LI>Workbench or another screen with no less than 640x400 pixels (adjustable
 448   with the MUI-Prefs); this restriction is just because we don't have
 449   bitmaps with less than 40x40 pixels per square. If someone contributes
 450   bitmaps with 20x20 or 20x25, they will work with any Hires mode.</LI>
 451 </UL>
 452 <P>
 453 If you would like to use an ICS, you need an Internet connection via either
 454
 455 <UL>
 456 <LI>a telnet-like program, or</LI>
 457 <LI>a terminal program reading from stdin and writing to stdout.</LI>
 458 </UL>
 459 <P>
 460 AmyBoard is available in the Internet Chess Library (topic <A HREF="#[A.2]">[A.2]</A>).
 461
 462 <HR>
 463 <H3><A NAME="[B.4]">[B.4] Is there an XBoard for the Macintosh?</A></H3>
 464
 465 Because MacOS X has a Unix base, XBoard will compile and run on it.
 466 You do need an X11 (X Window System) server and client libraries.
 467 These do not come with Mac OS, but both free and commercial versions
 468 are available.  Once you install the X11 package, XBoard is reported
 469 to compile and run without changes.  I am not a Mac user and have not
 470 tried this myself, so I cannot answer questions about it.
 471
 472 Version 4.2.6 and earlier of XBoard come with an old copy of the
 473 config.sub utility that does not recognize Mac OS X, so to build
 474 XBoard, you'll have to tell the configure program what OS you are
 475 running.  Follow the instructions in topic <A HREF="#[B.7]">[B.7]</A>
 476 of this FAQ, but add the argument <tt>--host=powerpc-apple-bsd</tt> to
 477 the end of the "configure" command line.
 478
 479 There is no version of XBoard or WinBoard that runs with the native
 480 (non-X11) Mac graphical interface, and none that runs on MacOS 9 or
 481 earlier.
 482
 483
 484 <HR>
 485 <H3><A NAME="[B.5]">[B.5] Does XBoard run on VMS?</A></H3>
 486
 487 No.  This port would probably be a lot easier than the Win32 and Amiga
 488 ports were, because VMS has the X Window system (under the name
 489 DECwindows) and is now POSIX compliant.  However, I don't know enough
 490 about VMS to do the port myself, and I don't have time.  If you do,
 491 give it a try!  Send mail to me,
 492 tim<a name="nospam2">@</a>tim-mann.org (Tim Mann), if you're
 493 working on this.
 494
 495 <HR>
 496 <H3><A NAME="[B.6]">[B.6] What is cmail?</A></H3>
 497
 498 cmail is a program that helps you play and keep track of electronic mail
 499 correspondence chess games using XBoard.  It is distributed with XBoard and
 500 has its own manual page.  cmail is free software.  It was written by
 501 Even Welsh.  cmail has not been ported to Windows; sorry.
 502
 503 <HR>
 504 <H3><A NAME="[B.7]">[B.7] How do I build XBoard?  Do I need gcc?</A></H3>
 505
 506 The first step to building XBoard is to get the distribution file.  See topic
 507 <A HREF="#[A.2]">[A.2]</A> for places you can ftp the software from.
 508
 509 <P>Next, decide what directory tree you are going to install XBoard
 510 in.  The default is /usr/local, but you probably don't have write
 511 access to that directory unless you are a system administrator.  If
 512 you do, type the following to install it there:
 513
 514 <p><PRE>
 515     gzip -cd xboard-*.tar.gz | tar -xvf -
 516     cd xboard-*/
 517     ./configure
 518     make
 519     su
 520     make install
 521 </PRE>
 522
 523 If you want to install xboard in your personal home directory ($HOME/bin),
 524 type this:
 525
 526 <p><PRE>
 527     gzip -cd xboard-*.tar.gz | tar -xvf -
 528     cd xboard-*/
 529     ./configure --prefix=$HOME
 530     make
 531     make install
 532 </PRE>
 533
 534 <P>If the first step above fails because you don't have gzip, see
 535 topic <A HREF="#[A.2]">[A.2]</A>, and ask a local Unix expert if you
 536 need more help.  If you have any problems with the last two steps,
 537 read the READ_ME and INSTALL files in the xboard-*/ directory.  You
 538 will also find this FAQ there.
 539
 540 <P>You don't need to have gcc to build XBoard.  Almost any Unix C
 541 compiler should do.
 542
 543 <HR>
 544 <H3><A NAME="[B.8]">[B.8] Can I use XBoard or WinBoard to play a game
 545   of chess with another human?</A></H3>
 546
 547 The only way for two humans on different machines to play chess in
 548 real time using XBoard/WinBoard is to use an Internet Chess Server
 549 as an intermediary.  That is, each player runs his own copy of XBoard
 550 or WinBoard, both of them log into an ICS, and they play a game there.
 551 Two copies of XBoard/WinBoard cannot communicate with each other
 552 directly.
 553
 554 <P>Instructions on how to get started with Internet chess are included
 555 with the XBoard and WinBoard distributions.  The network addresses
 556 included in the distribution may not always be current.  The oldest
 557 and largest ICS is the Internet Chess Club at chessclub.com, which now
 558 has a fee for registered use, but still allows free unregistered use.
 559 There are also many newer sites with no fees, using the Free Internet
 560 Chess Server implementation (FICS).  The most active FICS site is
 561 freechess.org.  On these and most other chess servers,
 562 the port number to use is 5000.
 563
 564 <P>If you don't have network connectivity to any ICS site, you
 565 can run your own server using a version of the FICS code, but this
 566 is not easy.  See <a href="http://www.tim-mann.org/ics.html#ownics"
 567 >http://www.tim-mann.org/ics.html#ownics</a> for advice and pointers.
 568
 569 <P>The cmail program included with XBoard lets you play email postal games with
 570 another human; see topic <A HREF="#[B.6]">[B.6]</A>.
 571
 572 <P>Two humans can play chess on the same machine using one copy of
 573 XBoard/WinBoard in
 574 Edit Game mode, but the clocks don't run in this mode, so it's of limited
 575 usefulness.
 576
 577 <P>See also topic <A HREF="#[D.2]">[D.2]</A>, Winsock Chess.
 578
 579 <HR>
 580 <H3><A NAME="[B.9]">[B.9] Will WinBoard run on Windows 3.1?
 581   How about Windows CE (also known as Pocket PC)?
 582 </A></H3>
 583
 584 WinBoard does not run on Windows 3.1, Windows for Workgroups 3.11, etc.,
 585 not even with the Win32s compatibility package.  The main problem is
 586 that Win32s does not have threads or real concurrent processes.  A
 587 port of WinBoard to Windows 3.1 is possible in theory, but it would be
 588 difficult and messy, and no one is going to do it.
 589
 590 <p>WinBoard does not run on Windows CE (also
 591 known as Pocket PC).  I don't know what would be required to port it.
 592
 593 <P>WinBoard does run well on full 32-bit versions of Windows, such as
 594 Windows 95, 98, NT, 2000, ME, and XP, and should continue to work
 595 on future 32-bit Windows systems.
 596
 597 <HR>
 598 <H3><A NAME="[B.10]">[B.10] How do I use XBoard or WinBoard as an external viewer for PGN files
 599   with my Web browser?</A></H3>
 600
 601 1) On Unix systems:
 602 <P>
 603 - Add the following line to the file .mime.types in your home directory.
 604 (Create the file if it doesn't exist already.)
 605 <PRE>
 606     application/x-chess-pgn    pgn
 607 </PRE>
 608 <P>
 609 - Add the following line to the file .mailcap in your home directory.
 610 (Create the file if it doesn't exist already.)
 611 <PRE>
 612     application/x-chess-pgn; xboard -ncp -lgf %s
 613 </PRE>
 614 <P>
 615 - Exit from your Web browser and restart it.
 616
 617 <P>2) On MS Windows systems:
 618
 619 <P>The exact procedure depends on which Web browser you are using.
 620 The current version of WinBoard automatically configures itself as
 621 your PGN viewer for local files, Netscape 4.x and later, and Internet
 622 Explorer.  This automatic setup probably works for all other current Web
 623 browsers, too.
 624
 625 <HR>
 626 <H3><A NAME="[B.11]">[B.11] How do I use WinBoard as an external viewer
 627   for PGN files with the MS Windows File Manager or Explorer?</A></H3>
 628
 629 WinBoard sets this up automatically when you install it, except on old
 630 versions of Windows NT (prior to 4.0).  On Windows NT 3.51 or earlier,
 631 go to the File Manager, click on the File menu, select Associate,
 632 enter "pgn" as the extension, and use the Browse button to find your
 633 copy of WinBoard and set up the association.
 634
 635 <HR>
 636 <H3><A NAME="[B.12]">[B.12] How do I use ICC timestamp or FICS timeseal
 637 with XBoard?</A></H3>
 638
 639 First, get the appropriate version of timestamp or timeseal for your
 640 machine from ftp.chessclub.com or ftp.freechess.org.
 641 Second, be sure that you can connect using XBoard <I>without</I>
 642 timestamp/timeseal.  Third, be sure that you can connect using
 643 timestamp/timeseal without XBoard.  See the help files on ICC and FICS
 644 or ask people online if you have problems.
 645
 646 <P>If you are in a completely ordinary situation, where your machine
 647 is directly on the Internet and you can connect to ICC or FICS
 648 without timestamp/timeseal using
 649 just the command "xboard -ics" or "xboard -ics -icshost freechess.org",
 650 change that command to one of the following:
 651
 652 <p><PRE>
 653     xboard -ics -icshost 204.178.125.65 -icshelper timestamp
 654
 655     xboard -ics -icshost 164.58.253.13 -icshelper timeseal
 656 </PRE>
 657
 658 <p>If you have a firewall between your machine and the ICS, see topic
 659 <A HREF="#[B.19]">[B.19]</A>.
 660
 661 <P>If you normally have to use the "/icscomm" command line option on
 662 xboard to log into a second machine, and then telnet to ICC or FICS
 663 from there, you are going to have to run the Unix version of timestamp
 664 or timeseal on the second machine.  (If the second machine is not
 665 running Unix, you are out of luck.)  Get the appropriate version of
 666 timestamp or timeseal onto the shell machine via FTP; see the help
 667 files on ICC and FICS for instructions.  Then simply run it when you
 668 would normally run telnet.  In this configuration you are not
 669 protected against lag between your PC and the shell machine, or for
 670 lag caused by heavy load on the shell machine itself from other users.
 671
 672 <P>For further information on timestamp and timeseal, see the help
 673 files on ICC and FICS.
 674
 675 <HR>
 676 <H3><A NAME="[B.13]">[B.13] How do I use ICC timestamp or FICS timeseal
 677 with WinBoard?</A></H3>
 678
 679 <P>If you select an ICS from either the WinBoard Startup dialog or the
 680 Windows Start submenu that WinBoard installs, WinBoard automatically
 681 runs timestamp or timeseal if the ICS you chose is known to support it.
 682
 683 <P>If you are constructing a WinBoard command line by hand, add the
 684 option "/icshelper timestamp" or "/icshelper timeseal" to the WinBoard
 685 command line to use timestamp or timeseal.  Both timestamp.exe and
 686 timeseal.exe are included in the WinBoard distribution.  They both
 687 function identically to the Unix versions, as documented in "help
 688 timestamp" on ICC and "help timeseal" on FICS.
 689
 690 <p>If you have a firewall between your machine and the ICS, see topic
 691 <A HREF="#[B.19]">[B.19]</A>.
 692
 693 <P>If you normally have to use the "/icscomm" command line option on
 694 WinBoard to log into a shell account, and then telnet to ICC or FICS
 695 from there, you are going to have to run the Unix version of timestamp
 696 or timeseal on the shell machine.  (If the shell account is not on a
 697 Unix machine, you are out of luck.)  Get the appropriate version of
 698 timestamp or timeseal onto the shell machine via FTP; see the help
 699 files on ICC and FICS for instructions.  Then simply run it when you
 700 would normally run telnet.  In this configuration you are not protected
 701 against lag between your PC and the shell machine, or for lag caused by
 702 heavy load on the shell machine itself from other users.
 703
 704 <P>For further information on timestamp and timeseal, see the help
 705 files on ICC and FICS.
 706
 707 <HR>
 708 <H3><A NAME="[B.14]">[B.14] How do I play bughouse with XBoard or WinBoard?
 709 </A></H3>
 710
 711 XBoard and WinBoard have simple but effective bughouse support.
 712 Offboard piece holdings are shown in the board window's banner, and
 713 you drop offboard pieces using the right mouse button.  Press it over
 714 the destination square to pop up a menu of pieces.
 715
 716 <P>XBoard and WinBoard can display only one board at a time, but you
 717 can observe your partner's game by running a second copy of the
 718 program and logging in as a guest.  (Unfortunately, this is not
 719 possible if you are using the /icscomm option.)  To observe your
 720 partner's games automatically, use the "follow" or "pfollow" ICS
 721 command; see the ICS online help for details.
 722
 723 <HR>
 724 <h3><a name="[B.16]">[B.16] What is Zippy?  How can I interface a
 725 chess program to the Internet Chess Servers?</a></h3>
 726
 727 Zippy is an interface that lets a compatible chess engine (such as GNU
 728 Chess or Crafty) act as a computer
 729 player on an Internet Chess Server.  Zippy is included in both the
 730 XBoard and WinBoard distributions.  It is implemented as a small
 731 amount of additional code within XBoard or WinBoard.
 732 For documentation, see the file
 733 zippy.README, included in both distributions or available
 734 from my chess Web page,
 735 <A HREF=
 736 "http://www.tim-mann.org/chess.html"
 737 >http://www.tim-mann/chess.html</A>.
 738 The version of zippy.README on my Web page is often more up-to-date
 739 than those in the XBoard/WinBoard distributions.
 740 You'll also find a "biography" of Zippy and pointers to the original
 741 Zippy the Pinhead comic strips on my Web page.
 742 Please read zippy.README carefully before you ask me any questions about Zippy.
 743
 744 <p>Using a computer to choose your moves on a chess server is
 745 considered cheating unless your account is on the computer (C) list.
 746 Read "help computer" on your favorite server for details on their
 747 policy.  Most of the servers have plenty of computers running now, so they
 748 will not be excited about having you run a new one unless you have
 749 written your own chess engine.  They don't really need yet another
 750 Crafty or GNU Chess clone.
 751
 752 <HR>
 753 <h3><a name="[B.17]">[B.17] How can I interface my own chess program
 754 to XBoard or WinBoard?</a></h3>
 755
 756 This is a non-trivial task.  XBoard and WinBoard were not designed
 757 with a clean interface for talking to chess programs; they were
 758 written to work with an existing version of GNU Chess that expects to
 759 be talking to a person.  Your program has to emulate GNU Chess's
 760 rather idiosyncratic command structure to work with XBoard and
 761 WinBoard.  We are gradually cleaning up, improving, and documenting
 762 the interface as newer versions of XBoard and WinBoard come out,
 763 however.
 764
 765 <p>For documentation, see the file engine-intf.html, included in both
 766 distributions or available from my chess Web page, <A HREF=
 767 "http://www.tim-mann.org/chess.html"
 768 >http://www.tim-mann.org/chess.html</A>.
 769 The version of engine-intf.html on my Web page is often more up-to-date
 770 than those in the XBoard/WinBoard distributions.
 771
 772 <HR>
 773 <h3><a name="[B.18]">[B.18] How can I recompile WinBoard from source?</a></h3>
 774
 775 The source code for WinBoard is available from the author's Web page,
 776 <A HREF=
 777 "http://www.tim-mann.org/chess.html"
 778 >http://www.tim-mann.org/chess.html</A>.
 779
 780 <p>WinBoard is currently developed using Microsoft Visual C++ 5.0.
 781 You can build the program from the MSVC++ GUI by opening the project
 782 file (winboard.dsp) and telling MSVC++ to build the project.  You can
 783 also build it from the the command line by using the nmake program
 784 supplied with MSVC++.
 785
 786 <p>To build WinBoard with the free Cygwin tools, available from <a
 787 href= "http://www.cygwin.com/" >http://www.cygwin.com/</a>), use the
 788 command "make -f cygwin.mak".  WinBoard 4.2.5 was successfully
 789 compiled with the net release of Cygwin as downloaded on 20-March-2001
 790 (cygwin1.dll 1.1.8, gcc 2.95.2-6, binutils 20001221-1, flex 2.5.4-1),
 791 but exhibits a command-line parsing bug; see item 511 in the ToDo file
 792 that comes with WinBoard.  WinBoard 4.1.0 does not compile with
 793 Cygwin.  WinBoard 4.0.7 is known to compile with Cygwin BL20.1.
 794
 795 <p>To build WinBoard with Borland C++ 4.5, use "borland.mak", supplied
 796 with the WinBoard sources, as the Makefile.  Support for Borland C++
 797 was contributed by Don Fong and has not been tested by the author of WinBoard.
 798
 799 <p>WinBoard is a Win32 application, so you definitely need a compiler
 800 and tool set that supports Win32.  In particular, older versions of
 801 DJGPP can build only 32-bit MSDOS programs; that is, programs that use
 802 a DOS extender to get a 32-bit address space and do not make any
 803 Windows calls.  The latest versions of DJGPP are said to be able to
 804 build Win32 programs when used with the proper extension package(s),
 805 but this is not known to work with WinBoard.  Use Cygwin instead.
 806
 807 <p>See also topic <A HREF="#[C.16]">[C.16]</A>.
 808
 809 <HR>
 810 <H3><A NAME="[B.19]">[B.19]
 811 How can I use XBoard or WinBoard to talk
 812 to an Internet Chess Server through a firewall or proxy?
 813 </A></H3>
 814
 815 <p>There is no single answer to this question, because there are many
 816 different kinds of firewalls in use.  They work in various different
 817 ways and have various different security policies.  This answer can
 818 only provide hints.
 819
 820 <p>Note that you can't access Internet Chess Servers through a Web proxy,
 821 because they are not a Web service.  You talk to them through a raw
 822 TCP connection, not an HTTP connection.  If you can only access the
 823 Web through a proxy, there may be a firewall that stops you from
 824 making direct TCP connections, but there may also be a way through it.
 825 Read on for hints, and contact your local system administrator if you
 826 need more information about your local configuration.
 827
 828 <p>A helpful user mailed me the following explanation of how to use
 829 WinBoard with WinGate:
 830 <blockquote>
 831 "I have managed to setup WinBoard though my WinGate proxy.  I have the
 832 Office version.  What I needed to do was to setup the TCP/IP
 833 connection to add the User/Host name and my provider service name for
 834 the DNS, but I had to leave the HOST IP address blank.  I have not
 835 played with all the variations, so it may be just that I have the DNS
 836 lookup enabled."
 837 </blockquote>
 838 I hope this helps, though I don't find it very clear.  I don't have
 839 a copy of WinGate myself and can't help if you have questions about it.
 840
 841 <p>If you are using some other non-SOCKS firewall, read the FIREWALLS section
 842 in your XBoard or WinBoard documentation (man page, info document, or
 843 Help file).  If you can telnet to a chess server in some way, then you
 844 can almost certainly connect to it with xboard/WinBoard, though in
 845 some cases you may not be able to run timestamp or timeseal.  The
 846 timestamp and timeseal protocols require a clean, 8-bit wide TCP
 847 connection from your machine to the ICS, which some firewalls do not
 848 provide.
 849
 850 <p>If you have a SOCKS firewall and are using <strong>XBoard</strong>,
 851 you should be able to SOCKSify xboard and use it.  See <a
 852 href="http://www.socks.nec.com/">http://www.socks.nec.com/</a> for
 853 information about SOCKS and socksification.  However, if you do this,
 854 you can't use timestamp or timeseal; what you really need is a
 855 socksified version of timestamp or timeseal.  This is hard because the
 856 source code for timestamp and timeseal is proprietary; the folks
 857 running the chess servers don't give it out because that would make it
 858 too easy to cheat.  On some versions of Unix, you may be able to
 859 socksify a program that you don't have the source code to by running
 860 it with an appropriate dynamic library; see <a
 861 href="http://www.socks.nec.com/">http://www.socks.nec.com/</a>.  For
 862 others, you might be able to get a pre-built socksified version from
 863 the chess server administrators.  For timeseal versions, see <a
 864 href="ftp://ftp.freechess.org/pub/chess/timeseal/"
 865 >ftp://ftp.freechess.org/pub/chess/timeseal/</a>.  For timestamp
 866 versions, the directory would be <a
 867 href="ftp://ftp.chessclub.com/pub/icc/timestamp/"
 868 >ftp://ftp.chessclub.com/pub/icc/timestamp/</a>, but at this writing
 869 there don't seem to be any socksified timestamps there.  Once you have
 870 a socksified timestamp or timeseal, simply run it with a normal,
 871 non-socksified xboard in place of the standard timestamp or timeseal.
 872
 873 <p>If you have a SOCKS firewall and you are using
 874 <strong>WinBoard</strong>, we now know how to make this configuration
 875 work, complete with timestamp or timeseal!
 876
 877 <p>Start by getting SocksCap32.  This software is freely available
 878 from <a href="http://www.socks.nec.com/">http://www.socks.nec.com/</a>.
 879 Install it on your machine, read the documentation, and learn to use
 880 it.  You may find it useful with many other programs besides WinBoard.
 881
 882 <p>Next, <strong>don't</strong> socksify WinBoard.  Socksifying
 883 WinBoard itself doesn't let you use it with timestamp or timeseal.
 884 For some reason I don't understand -- something strange that
 885 SocksCap32 does -- the socksified WinBoard runs but does nothing, and
 886 timestamp/timeseal runs all by itself in its own window.
 887
 888 <p>Instead, use the following workaround.  Follow the instructions
 889 exactly; don't try to skip steps or simplify things.
 890
 891 <p>First, make SocksCap32 application profiles for timestamp and
 892 timeseal.  Use the following command lines in the SocksCap32
 893 profiles. Name the first profile "timestamp" and the second
 894 "timeseal".
 895
 896 <p><pre>
 897     "c:\program files\winboard\timestamp.exe" chessclub.com 5000 -p 5000
 898     "c:\program files\winboard\timeseal.exe" freechess.org 5000 -p 5000
 899 </pre>
 900
 901 <p>Second, run timestamp or timeseal by itself, socksified, using its
 902 profile.  This will open an unneeded, black window that will not
 903 respond to typing.  Minimize it to the task bar and ignore it. It will
 904 go away when you exit from WinBoard.
 905
 906 <p>Next, run WinBoard using the following command line.  Make a shortcut
 907 or type this command into an MS-DOS Prompt box.  Don't run WinBoard
 908 itself socksified, just run it directly.
 909
 910 <p><pre>
 911     "c:\program files\winboard.exe" /ics /icshost=localhost /icsport=5000
 912 </pre>
 913
 914 <p>After you get this working, you can try getting the timestamp window to
 915 auto-minimize by starting it from a shortcut instead of from the
 916 SocksCap32 control window. As it says in the SocksCap32 help file, put
 917 the following in the Target field of a shortcut's Properties page:
 918
 919 <p><pre>
 920     "c:\program files\sockscap32\sc32.exe" timestamp
 921 </pre>
 922
 923 Then select "Run: Minimized" on the same page.  Do the same for timeseal.
 924
 925 <p>Another method that can work is to use a .bat file to start both
 926 timestamp and WinBoard.  It would look something like this:
 927
 928 <p><pre>
 929     REM --
 930     REM -- icc.bat
 931     REM -- Start timestamp under SocksCap32 and use WinBoard to connect to it.
 932     REM -- The string "timestamp" refers to a SocksCap32 profile for timestamp.
 933     REM --  Do not change it to the filename of the timestamp program!
 934     REM --
 935     start /minimized "c:\program files\sockscap32\sc32.exe" timestamp
 936     cd "c:\program files\winboard"
 937     winboard /ics /icshost=localhost /icsport=5000
 938 </pre>
 939
 940 <p>This workaround has a problem if you want to run two copies of
 941 WinBoard at once, talking to the same chess server twice (for
 942 bughouse) or to two different chess servers. If you need to do that,
 943 you will need to run a separate copy of timestamp with <i>a different
 944 port number</i> for each connection.  You'll need to make a second set of
 945 profile entries with a different value after the -p flag (say, 5001)
 946 and you'll need to change the WinBoard command line /icsport=5000 for
 947 the second WinBoard to match.
 948
 949 <HR>
 950 <H3><A NAME="[B.20]">[B.20]
 951 How can I use XBoard or WinBoard on chess.net with accuclock?
 952 </A></H3>
 953
 954 <p>I believe chess.net provides a Win32 command-line version of
 955 accuclock that will work with WinBoard.  Please see the documentation
 956 on the chess.net server itself; don't ask the author of WinBoard.
 957
 958 <p>I don't know whether chess.net provides versions of accuclock for
 959 Unix at this time.  Ask them.
 960
 961 <hr>
 962 <h3><a name="[B.21]">[B.21]
 963   Can I get Zippy to do one or more ICS commands automatically at the
 964   start or end of each game?</a></h3>
 965
 966 <p>By default, Zippy automatically sends the command "gameend" to ICS
 967 at the end of each game.  You can alias this command (using the ICS
 968 "alias" feature) to anything you want.  On ICC, you can use the
 969 "multi" feature to alias gameend to several commands, but other
 970 servers don't have that feature.  Zippy doesn't send anything at the
 971 start of the game by default.
 972
 973 <p>You can get Zippy to send one or more commands of your choosing, at
 974 the start and/or end of each game, by using the -zippyGameStart and
 975 -zippyGameEnd command line options, newly added in version 4.0.3.
 976 Both xboard and WinBoard have (somewhat obscure) ways of getting
 977 newlines into this option to send several commands.  Here is an
 978 example of one way to do it for each.
 979
 980 <p><pre>
 981     xboard -ics -zp -xrm '*zippyGameStart: say hi\nsay prepare to die\n'
 982
 983     WinBoard /ics /zp /zippyGameEnd='say thanks\nseek 5 0\nseek 2 12\n'
 984 </pre>
 985
 986 <hr>
 987 <h3><a name="[B.22]">[B.22]
 988   How do I print from WinBoard?
 989 </a></h3>
 990
 991 WinBoard does not have built-in printing functionality.
 992 If you want to print a picture of the board, press Alt+PrintScrn, run the
 993 standard Windows application Paintbrush, select Paste, and print from there.
 994 If you want to print a list of moves, save your game as a PGN file,
 995 then open the PGN file with Notepad or any other plain text editor and
 996 print it from there.
 997
 998 <hr>
 999 <h3><a name="[B.23]">[B.23]
1000   Can I get Zippy to automatically reconnect to ICS when its connection
1001   breaks?</a></h3>
1002
1003 <p>There isn't a perfect solution to this problem yet, but a pretty
1004 good one is to write a shell script (for xboard) or .bat script (for
1005 WinBoard) that automatically restarts the program whenever it exits.
1006 Use the -xexit flag so that you don't get a popup dialog that must be
1007 dismissed with the OK button before the program will exit.  The gap in
1008 this solution is that your connection to ICS can sometimes get into a
1009 state where the program does not notice that the connection is broken
1010 until the next time it tries to send a command.  Perhaps some future
1011 version of xboard/WinBoard will have an option to send a harmless
1012 command every five minutes or so.
1013
1014 <p>Anyway, here is a sample Windows .bat file that restarts WinBoard each
1015 time it exits.  Thanks to Jason Williamson.  It assumes that you have put
1016 your computer account's name and password in a file named logon.ini.
1017
1018 <pre>
1019 REM --
1020 REM -- wbrecon.bat
1021 REM -- Start WinBoard in Zippy mode, and restart it each time it exits.
1022 REM -- Add or change parameters as needed for your application.
1023 REM --
1024 :loop
1025 start /w winboard /zp /ics /icslogon logon.ini /xexit /xautoraise
1026 REM -- The next line is to have a short delay setup for 139 seconds.
1027 REM -- Leave it out if it doesn't work on the version of Windows you use.
1028 TYPE NUL | CHOICE.COM /N /CY /TY,99 &gt;NUL
1029 goto loop
1030 </pre>
1031
1032 <p>Here is a Unix shell script to do the same thing for xboard.
1033 It's a bit more elaborate.  It is based on the script I use for the
1034 original Zippy.  It logs all ICS output to a file named zippy.out,
1035 and it lets you type commands to Zippy by running "cat &gt; zippy.fifo".
1036
1037 <pre>
1038 #! /bin/sh
1039 host="204.178.125.65 -icsport 5000 -telnet -telnetProgram timestamp"
1040 #host="164.58.253.13 -icsport 5000 -telnet -telnetProgram timeseal"
1041 out=zippy.out
1042 fifo=zippy.fifo
1043 ZIPPYPASSWORD='something'
1044 export ZIPPYPASSWORD
1045 ZIPPYPASSWORD2='orother'
1046 export ZIPPYPASSWORD2
1047 ZIPPYLINES=`pwd`/all.lines
1048 export ZIPPYLINES
1049 ZIPPYGAMEEND='say Yow, that was FUN!
1050 gameend'
1051 export ZIPPYGAMEEND
1052 zippylogon=`pwd`/logon.ini
1053 DISPLAY=`hostname`:0.0
1054 export DISPLAY
1055 mv -f $out ${out}.old
1056 rm -f $fifo
1057 mkfifo $fifo
1058 pid=$$
1059 ( while [ true ] ; do cat -u $fifo ; done ) | \
1060       ( while [ true ] ; do
1061           xboard -iconic -ics -icshost $host \
1062                  -zt -zp -xbell -xanimate \
1063                  -xautosave -xquiet -fcp "gnuchessx -h" \
1064                  -icslogon $zippylogon -xexit -autoflag -xautoraise $*
1065           sleep 600
1066         done ) &gt; $out 2&gt;&amp;1 &amp;
1067 </pre>
1068
1069 <hr>
1070 <h3><a name="[B.24]">[B.24]
1071   The chess engines are too strong and always beat me.  How can I adjust
1072   the difficulty level to make them weaker?</a></h3>
1073
1074 <p>The simplest way to get that effect is to make sure the
1075 XBoard/WinBoard Auto Flag option is off, set a very fast time control
1076 so that the chess engine can't think for long, but take as much time
1077 over your own moves as you want. Also feel free to use Retract Move if
1078 you make a blunder.
1079
1080 <p>Many chess coaches will let you switch sides after
1081 they get a stronger position so that you can get experience playing
1082 positions where you are winning.  You can try this with XBoard/WinBoard
1083 by using the Machine White or Machine Black menu command to make the
1084 machine take over your position.
1085
1086 <p>The -depth command-line option to XBoard/WinBoard can also be used to
1087 weaken the engine (see the man page or Help file).  It's a bit of a
1088 nuisance to set command line options in Windows, but see topic <A
1089 HREF="#[C.7]">[C.7]</A> for instructions.
1090
1091 <p>Other ways of weakening engines are engine-specific.  Many of them
1092 let you adjust various parameters, and if you choose bad settings, the
1093 engine will play more poorly.  Consult whatever documentation came with
1094 the engine you are using.
1095
1096 <hr>
1097 <h3><a name="[B.25]">[B.25]
1098   May I use the piece bitmaps from XBoard/WinBoard in my own program?</a></h3>
1099
1100 <p>The piece bitmaps used in XBoard and WinBoard were designed by
1101 Elmar Bartel.  He released them under the <a
1102 href="http://www.gnu.org/copyleft/gpl.html">GNU General Public
1103 License</a>.  This means that if your program is also free software
1104 distributed under the GPL, you can use them freely.  If your program
1105 is distributed under some other license, including commercial,
1106 shareware, or non-GPL freeware, then you cannot use the bitmaps unless
1107 you obtain special permission from Elmar.  See the file README.bitmaps
1108 that comes with the XBoard and WinBoard source code for more
1109 information and an email address you can write to.
1110
1111 <HR><H2><A NAME="[C]">[C] XBoard and WinBoard, bugs and problems</A></H2>
1112
1113 <HR><H3><A NAME="[C.1]">[C.1] I can't build XBoard
1114 because the X11/Xaw/...  include files are not found.</A></H3>
1115
1116 These are the header files for the Athena Widgets library, which XBoard uses
1117 heavily.  Some versions of Unix don't supply these files, but they are part of
1118 the standard X distribution, freely available from MIT.
1119
1120 <P>For general information on getting missing X sources, see the FAQ on
1121 comp.windows.x.  Note that you may be missing only the header files, or you
1122 may be missing the libraries themselves too.
1123
1124 <P>HP-UX users are missing only the header files.  You can get them by
1125 anonymous FTP as follows.  (But first check with your system
1126 administrator to see if someone else at your site has already done
1127 this.)  Get the archive file /hpux9/X11R5/Core/Xaw-5.00.tar.gz (Xaw
1128 header files) via anonymous FTP from the site hpux.csc.liv.ac.uk
1129 (138.253.42.172), or one of the other official sites---Germany:
1130 hpux.ask.uni-karlsruhe.de (129.13.200.57), US: hpux.cae.wisc.edu
1131 (144.92.4.15), France: hpux.cict.fr (192.70.79.53) or Netherlands:
1132 hpux.ced.tudelft.nl (130.161.140.100). Unpack the archive using gzip
1133 and follow the instructions in its README and/or HPUX.Install files.
1134 Thanks to Richard Lloyd for this information.
1135
1136 <P>If you have the Xaw header files installed in a different place
1137 than the other X11 headers, you may need to configure XBoard with an
1138 extra flag to help it find them.  For example, if yours are in
1139 /foo/bar/X11/Xaw, try this:
1140
1141 <p><PRE>
1142     rm config.cache
1143     (setenv CFLAGS -I/foo/bar ; configure)
1144 </PRE>
1145 <P>
1146 Also see topic <A HREF="#[C.2]">[C.2]</A>.
1147
1148 <HR>
1149 <H3><A NAME="[C.2]">[C.2] Configuring or building XBoard fails due to
1150 missing header files, missing libraries, or undefined symbols.
1151 </A></H3>
1152
1153 Perhaps you have the X server and client programs installed on your
1154 machine, but not the X header files and link-time libraries.  If so,
1155 you can run existing X programs, but you cannot compile a new X
1156 program from source code.  In this case the XBoard configure script
1157 will fail and will tell you to look at this question in the FAQ.  Many
1158 GNU/Linux distributions put the headers and libraries in a separate
1159 package, which you might not have installed.  If you are using RedHat,
1160 install the XFree86-devel package.  If you are using some other
1161 kind of Unix, ask your system administrator where to find the X header
1162 files and link-time libraries.  If this is not your problem, read on.
1163
1164 <p>The configure script for XBoard looks for X libraries and header
1165 files in some common places.  Sometimes it fails: If yours are
1166 installed in an odd place, it may not find them at all.  If you have
1167 more than one version of X installed on your system, it may find the
1168 "wrong" one, or occasionally it may find libraries from one version
1169 and incompatible header files from another.  You can work around these
1170 problems by telling the configure script where the files are.  For
1171 example:
1172
1173 <p><PRE>
1174     configure --x-includes=/odd/place/include \
1175               --x-libraries=/odd/place/lib
1176 </PRE>
1177
1178 <P>The directory named in the argument to --x-includes must have a
1179 subdirectory "X11" that contains the actual .h files.  That is, if
1180 your X.h file has full pathname /odd/place/X11R6/include/X11/X.h, then
1181 you must give the argument --x-includes=/odd/place/X11R6/include.
1182
1183 <P>Some linkers have bugs that cause bogus error messages when you try
1184 to link X programs.  The configure script includes a workaround for a
1185 bug of this kind that exists in some SunOS 4.x.x installations.  See
1186 the FAQ on comp.windows.x for more information about problems of this
1187 kind.
1188
1189 <P>If all else fails, check whether anyone else at your site has been able to
1190 compile any X programs on your system.  Your X installation might be buggy.
1191 If so, the system administrator at your site might know how to fix or work
1192 around the problem.
1193
1194 <P>Also see topic <A HREF="#[C.1]">[C.1]</A>.
1195
1196 <HR><H3><A NAME="[C.3]">[C.3] I have problems using WinBoard on ICS
1197 with a modem.  I'm not running SLIP or PPP, but just dialing in to an
1198 ordinary login account ("shell account").</A></H3>
1199
1200 Here are solutions to some common problems in this area.
1201
1202 <P>Some people want to connect to ICS through HyperTerminal or some other
1203 terminal program first, then run WinBoard.  This is not how it works.
1204 WinBoard wants to talk directly with your modem, acting as a terminal program
1205 itself.  Start out with the modem "on hook" (not making a call).
1206
1207 <P>Run WinBoard with a command line like this (adding more options if desired):
1208
1209 <p><PRE>
1210     WinBoard /ics /icscom com1
1211 </PRE>
1212
1213 Use com2, com3, or com4 in place of com1 if your modem is connected to one of
1214 those ports.
1215
1216 <P>After you start WinBoard, you may need to change some of the options in the
1217 Communications dialog (on the Options menu).  The dialog has the usual options
1218 for talking to modems: bits per second, bits per byte, parity, number of stop
1219 bits.  You will probably want to use Save Settings Now when you're done.
1220
1221 <P>Next, type dialing commands to your modem in the text window that WinBoard
1222 creates.  You may need to turn off Local Line Editing on the Options menu
1223 while you are typing commands to your modem.  Turn it back on when you're
1224 done.  See the WinBoard Help file for instructions if you see your typing
1225 echoed an extra time after you hit Enter.
1226
1227 <HR>
1228 <H3><A NAME="[C.4]">[C.4]
1229 I have problems using WinBoard on ICS with Windows 95 and SLIP
1230 or PPP.  When trying to start up, it gets the error "Address family
1231 not supported by protocol family" (or some equally strange message).
1232 </A></H3>
1233
1234 WinBoard is a 32-bit application, but some Winsock (TCP/IP) implementations
1235 support only 16-bit applications.  You get a strange looking error message
1236 if you try to use a 32-bit application because
1237 there is no standard Winsock error code number
1238 for "32-bit application not supported."
1239
1240 <P>Microsoft TCP/IP works with both 16-bit and
1241 32-bit applications, supports SLIP, PPP, Ethernet, etc., and is included
1242 with Windows 95 and later Windows systems.
1243 If possible, I recommend that you uninstall
1244 whatever Winsock you are using and install Microsoft TCP/IP instead.
1245 For more information, see
1246 <A HREF=
1247 "http://walden.mo.net/~rymabry/95winfaq.html"
1248 >http://walden.mo.net/~rymabry/95winfaq.html (the Win95-L FAQ)</A>.
1249
1250 <P>Trumpet Winsock 2.1 (and earlier) supports only 16-bit
1251 applications, and hence does not work with WinBoard.  But there is a
1252 beta-test release available that does support 32-bit applications.
1253 I have not tried it with WinBoard, but it
1254 should work.  See Trumpet's Web page
1255 <A HREF=
1256 "http://www.trumpet.com.au/wsk/winsock.htm"
1257 >http://www.trumpet.com.au/wsk/winsock.htm</A>
1258 for more information.
1259
1260 <P>The 16-bit versions of America On-Line's software do not support
1261 32-bit Winsock applications.  Get the 32-bit version.  At one time the
1262 32-bit version was called "AOL for Windows 95," but I imagine that has
1263 changed.  Hopefully the current versions are all 32-bit.
1264
1265 <P>A few versions of Winsock may have bugs that prevent
1266 Windows timestamp/timeseal from working with them.  I'm not sure if
1267 such bugs exist in any versions that actually have 32-bit support,
1268 so this point might be moot.  Again, Microsoft TCP/IP is known to work.
1269
1270 <HR><H3><A NAME="[C.5]">[C.5] When I try to run WinBoard, I get the
1271 message "Failed to start chess program gnuchess on localhost: NO
1272 LANGFILE (file gnuchess.lan not found)".</A></H3>
1273
1274 <p>This message means that WinBoard is trying to run GNU Chess, but
1275 GNU Chess cannot find a file that it needs, named gnuchess.lan.
1276 If you see it, you've probably customized WinBoard's /fcp, /fd, /scp,
1277 and/or /sd options and made a mistake in the process.  Review what
1278 you did, and see the WinBoard help file.
1279
1280 <HR>
1281 <H3><A NAME="[C.6]">[C.6] I want to use XBoard or WinBoard as an Internet
1282 Chess Server interface, but the ICS Client option is grayed out on the
1283 menu.</A></H3>
1284
1285 XBoard and WinBoard have three major modes that can't be changed from the
1286 menus: local chess engine mode,
1287 ICS mode, and standalone mode.
1288
1289 <p>With XBoard, you have to set the mode using command-line options.
1290 Local chess engine mode is the default, -ics selects ICS mode, and
1291 -ncp ("no chess program") selects standalone mode.
1292
1293 <p>With WinBoard, if you don't set the mode using command-line
1294 options, you get a dialog box asking which mode you want.  To bypass
1295 the dialog box, use -cp ("chess program") for local chess engine mode,
1296 or -ics or -ncp as with XBoard.  Also see topic <A HREF="#[C.7]">[C.7]</A>.
1297
1298 <HR>
1299 <H3><A NAME="[C.7]">[C.7] How do I give command-line options to
1300 a Windows program like WinBoard?</A></H3>
1301
1302 <P>There are many ways; pick your favorite:
1303
1304 <P><UL>
1305 <LI>Type the command line into an MS-DOS Prompt box.  Example:
1306 "WinBoard -ics".
1307
1308 <LI>Make a Windows shortcut for WinBoard.  You can do this by
1309 right-dragging WinBoard.exe to the desktop and selecting "Create
1310 Shortcut(s) Here" from the menu that appears.  Right-click on the
1311 shortcut, select Properties, and click the Shortcut tab.  The
1312 command-line text box is labelled "Target" instead of "Command line"
1313 just to confuse you.  Edit the text in this box, adding the command
1314 line options to the end.</LI>
1315
1316 <LI>Choose Run from the Start menu, or File / Run from the Program
1317 Manager or File Manager, and type the command line into the dialog you
1318 get.  You may have to give WinBoard's full drivespec and filename if
1319 it is not in a directory on your search path.</LI>
1320
1321 <LI>Make a Program Manager icon for WinBoard.  You can do this by
1322 dragging WinBoard.exe from the File Manager into the Program Manager,
1323 or by using File / New in the Program Manager.  Select the icon and
1324 choose File / Properties.  Edit the Command Line text box to add the
1325 command-line options to the end.</LI>
1326 </UL>
1327
1328 <HR>
1329 <H3><A NAME="[C.9]">[C.9]
1330 When I exit from WinBoard after using it to play against a chess
1331 program on my machine, the chess program keeps running in the background.
1332 </A></H3>
1333
1334 <p>Be sure you have the current versions of WinBoard and the chess
1335 engine you are using.  WinBoard 3.4.1 and earlier had a bug that
1336 caused this problem to occur with all chess engines.  A buggy chess
1337 engine that does not respond to the "quit" command will also cause
1338 this.
1339
1340 <p>If you still see this problem, you can stop the rogue chess engine
1341 by pressing Ctrl+Alt+Del, selecting the chess engine process from the
1342 menu, and pressing the End Task button.
1343
1344 <hr>
1345 <h3><a name="[C.12]">[C.12]
1346 Why do my ICS
1347 opponents often get extra time after they make their moves?
1348 Why do I sometimes lose time off my clock after I make my move?
1349 </a></h3>
1350
1351 If you are playing with the ICS incremental clock, both you and your
1352 opponent get a set amount of extra time after each move.
1353
1354 <p>If your or your opponent has netlag, your opponent might appear to
1355 get extra time, especially if your opponent is using timestamp or
1356 timeseal.  The ICS charges each player who is using timestamp or
1357 timeseal only for the time between when the player received his
1358 opponent's move and the time he sent his own move.  Thus delays in
1359 network transmission do not count against either player.  But WinBoard
1360 counts down the display of your opponent's clock on your screen under
1361 the assumption that there is no netlag.  When his move comes in, if
1362 there was netlag, the ICS may not have really charged him for that
1363 much time, and WinBoard corrects the clock to what the ICS says it
1364 should read.
1365
1366 <p>If you are not using timestamp or timeseal, you may appear to lose
1367 time off your clock at some point after you make your move.  In this
1368 case, the ICS charges you for the time between when it sent you your
1369 opponent's move and the time it received your move.  Thus delays in
1370 network transmission count against you.  WinBoard stops counting down
1371 the display of your clock on your screen (and starts your opponent's)
1372 when you make your move.  When the ICS echoes your move back to you, it
1373 may have charged you for more time than that, and WinBoard corrects
1374 the clocks to what the ICS says they should read.
1375
1376 <p>See "help lag" and "help timestamp" or "help timeseal" on your ICS for
1377 more detailed information.
1378
1379 <hr>
1380 <h3><a name="[C.13]">[C.13]
1381 I can't run WinBoard unless I delete the WinBoard.ini file each time!
1382 </a></h3>
1383
1384 <p>Most people don't have this problem, but two or three people using
1385 Windows NT 4.0 with Service Pack 3 or 4 have reported it.  I have no
1386 idea what causes this problem.  Contrary to what was reported in a
1387 previous version of this FAQ, reinstalling the service pack after
1388 installing WinBoard does not seem to solve the problem.
1389
1390 <hr>
1391 <h3><a name="[C.15]">[C.15]
1392 I get errors compiling XBoard's parser.c.
1393 </a></h3>
1394
1395 <p>The file parser.c is automatically generated from parser.l.  The
1396 copy included with XBoard 4.0.2 was generated by lex on Tru64 Unix and
1397 has problems compiling and linking on current GNU/Linux versions.  The
1398 copy included with XBoard 4.0.3 was generated by flex on a GNU/Linux
1399 machine, but it too won't necessarily work on other versions of Unix.
1400 If you have this problem, you can fix it by deleting parser.c and
1401 letting the Makefile re-create it from parser.l.  This will work if
1402 you have either lex or flex on your system.  Flex is available in all
1403 GNU/Linux distributions and can be obtained at no charge from the Free
1404 Software Foundation, www.fsf.org.
1405
1406 <hr>
1407 <h3><a name="[C.16]">[C.16]
1408 I get an error building WinBoard from source because "flex" is not found.
1409 </a></h3>
1410
1411 <p>The file parser.c is automatically generated from parser.l.  The
1412 Makefile included with the WinBoard source kit has a rule for
1413 generating parser.c using the program "flex", which will fail if you
1414 don't have flex.  However, the source kit also includes a ready-made
1415 copy of parser.c, so you don't really need flex unless you have made
1416 changes to parser.l.  Check that you still have a copy of parser.c; if
1417 you don't, unpack the WinBoard source zip file again to get one.
1418 Either set the last-modified time of parser.c to be later than that of
1419 parser.l, delete parser.l, or comment out the Makefile rule for
1420 building parser.c from parser.l, and then try building WinBoard again.
1421
1422 <p>If you do want to change parser.l and rebuild parser.c, you can get
1423 flex as part of the free Cygwin kit from
1424 <a href="http://sourceware.cygnus.com/cygwin/"
1425 >http://sourceware.cygnus.com/cygwin/</a>.  You can
1426 probably also get flex for Windows by itself from various other places
1427 around the Internet.  It is free software distributed by the Free
1428 Software Foundation, www.fsf.org.
1429
1430 <hr>
1431 <h3><a name="[C.17]">[C.17]
1432   XBoard hangs shortly after connecting to an ICS when used with dxterm,
1433  cmdtool, dtterm, kterm, konsole, or other substitutes for xterm.
1434 </a></h3>
1435
1436 <p>After connecting to a chess server, XBoard 4.0.2 and later sends an
1437 escape sequence to its terminal that is meant to display your handle
1438 and the ICS host name (for example, "user@chessclub.com") in the
1439 terminal's banner and icon.  It seems that several of the alternative
1440 X terminal programs have a bug that makes them hang when sent this
1441 escape sequence.
1442
1443 <p>You can work
1444 around the problem by using xterm, nxterm, rxvt, aterm, xiterm, or
1445 gnome-terminal, all of which seem to work fine.  In fact, current
1446 versions of kterm and konsole seem to work fine too, so if you are
1447 having problems with one of them, be sure you are not running an
1448 outdated version.
1449
1450 <p>Alternatively, you can disable this feature by commenting out the
1451 body of DisplayIcsInteractionTitle in xboard.c and recompling xboard.
1452
1453 <hr>
1454 <h3><a name="[C.18]">[C.18]
1455   The WinBoard pieces show up in the wrong colors, appear distorted,
1456   or are not visible at all.
1457 </a></h3>
1458
1459 <p>This can happen if you have a bug in your Windows display driver.
1460 Check with the manufacturer of your display card, the manufacturer of
1461 your computer, or Microsoft to see if there is an updated driver
1462 available.  You can usually download updated drivers from the Web.
1463
1464 <p>If you can't find an updated driver, you can try running Windows
1465 using a different number of colors and/or disabling some of the
1466 hardware acceleration features on your display card.  To change the
1467 number of colors, go to Windows Start / Settings / Control Panel /
1468 Display / Settings / Color Palette.  To disable hardware acceleration
1469 features, go to Windows Start / Settings / Control Panel / Display /
1470 Settings / Advanced Properties / Performance / Hardware Acceleration.
1471
1472 <p>It's also possible that Windows has the right driver for your
1473 hardware already but you are not using it.  It may help to reinstall
1474 your driver.  Go to Windows Start / Settings / Control Panel / System
1475 and delete your display card (maybe even your monitor too), then
1476 reboot.  Windows should automatically re-detect your card and monitor
1477 and re-install the drivers; if it doesn't, run Start / Settings /
1478 Control Panel / Add New Hardware to force it to.
1479
1480 <p>If all else fails, try Monochrome mode.  On WinBoard's menus, go
1481 to Options / Color and check Monochrome.  WinBoard will display in black
1482 and white.
1483
1484 <HR>
1485 <H3><A NAME="[C.19]">[C.19] XBoard or WinBoard tells me "Error: first chess
1486   program (...) exited unexpectedly".</A></H3>
1487
1488 <p>This message means that your chess engine crashed, probably due to
1489 a bug in the engine, or because you have it configured incorrectly.
1490 You can try running XBoard or WinBoard again with the "-debug" flag on
1491 the command line.  This will print out all the messages received from
1492 the chess engine.  (With WinBoard, the messages go into a file called
1493 WinBoard.debug; with XBoard, they go to the xterm that you started
1494 XBoard from.)
1495
1496 <P>If you are using GNU Chess and you see this problem as soon as it
1497 starts up, most likely GNU Chess is exiting with an error message.  If
1498 you see the message "NO LANGFILE", it means that you did not install
1499 GNU Chess correctly, and it is unable to find the file gnuchess.lang.
1500 Make sure that you defined LIBDIR in the gnuchess Makefile, and that
1501 gnuchess.lang is in that directory.  If gnuchess.lang is not there,
1502 you probably didn't type "make install" in the gnuchess src directory;
1503 you must do this to install gnuchess.lang (and the gnuchess book).  If
1504 you defined LIBDIR to something that is not an absolute pathname (that
1505 is, to something that does not start with a "/"), GNU Chess will work
1506 only if you run it from the GNU Chess "src" directory where you built
1507 it.
1508
1509 <hr><h3><a name="[C.20]">[C.20]
1510   XBoard tells me "Warning: Cannot allocate colormap entry", or
1511   "too few colors available; trying monochrome mode", or
1512   "XPM pieces cannot be used in monochrome mode".
1513 </a></h3>
1514
1515 <p>You are running your X server with 8-bit color depth, and you are running
1516 some program that has used up all 256 of your colors.  Netscape tends
1517 to do this, or maybe you have a background image that uses up all of
1518 your colors.
1519
1520 <p>If you have a modern machine, you probably have enough display
1521 memory to run your X server with 16-, 24-, or 32-bit color depth.  If
1522 you're using "startx" to start the X server, try giving the command as
1523 "<tt>startx -- -bpp 24</tt>" (or 16, or 32).  On newer X servers you
1524 may have to use -depth instead of -bpp.  Further details on
1525 configuring your X server are beyond the scope of this FAQ.
1526
1527 <p>If you must run in 8-bit mode, try the following:
1528 Avoid background images that use up all your colors.  If you
1529 run Netscape, try starting it up with the <tt>-install</tt> command-line
1530 option; this gives Netscape its own private colormap that X will
1531 switch to when Netscape has the keyboard focus.
1532
1533 <P>If all else fails, another possibility is to run xboard in
1534 monochrome (black and white) mode by giving it the <tt>-mono</tt>
1535 command-line option.  XBoard will try this by itself in some cases.
1536 Monochrome mode works only with bitmap pieces, not pixmap pieces, so
1537 trying to use it may give you the error "XPM pieces cannot be used in
1538 monochrome mode".  To get around this, either use the -bitmapDirectory
1539 command line option to point XBoard to the directory containing the
1540 bitmap pieces included with the XBoard source code, or rebuild XBoard
1541 with pixmap support disabled, using "./configure --disable-xpm ; make
1542 clean ; make".
1543
1544 <hr><h3><a name="[C.21]">[C.21]
1545   When I log in to freechess.org, the Enter key doesn't work, and I
1546   have to use Ctrl+J instead.  But when I use WinBoard, Ctrl+J doesn't
1547   work either, so I'm stuck.
1548 </a></h3>
1549
1550 <p>This is a pretty rare problem.  It should only arise if you have to
1551 reach freechess.org by telnetting (or connecting with WinBoard
1552 /icsport=23) from a Windows PC to a Unix box, and then telnetting from
1553 there to freechess.org.  The Enter key should always work when
1554 connecting directly from your PC to freechess.org.
1555
1556 <p>The best way to get around the problem is to run timeseal on the
1557 intermediate Unix box instead of telnet.  Get the appropriate version
1558 of timeseal for your box from ftp.freechess.org and follow the
1559 directions in the help files on FICS.
1560
1561 <p>If you can't run timeseal for some reason, there are some things
1562 you can do to make telnet stay in line mode instead of going to
1563 character mode.  Then the Enter key will work.  First, try "telnet
1564 freechess.org 5000" instead of "telnet freechess.org."
1565 If that still doesn't work, then when the Enter key stops working,
1566 type the following.  Here <tt>&lt;</tt> and <tt>&gt;</tt> surround the
1567 names of keys.
1568
1569 <p><pre>
1570     &lt;Ctrl+S&gt;&lt;Ctrl+]&gt;mode line&lt;Enter&gt;
1571 </pre>
1572
1573 <hr><h3><a name="[C.22]">[C.22]
1574   XBoard says, "Failed to start first chess program gnuchessx
1575   on localhost: gnuchessx: No such file or directory."
1576 </a></h3>
1577
1578 <p>XBoard is looking for GNU Chess 4.0.  If you didn't want to use
1579 XBoard with GNU Chess, please see topic <A HREF="#[C.6]">[C.6]</A>.
1580 If you did want to use GNU Chess 4.0, be sure you have it installed and
1581 that it is on your $PATH.  If you wanted to use GNU Chess 5 instead,
1582 see topic <A HREF="#[D.6]">[D.6]</A>.
1583
1584 <HR>
1585 <H2><A NAME="[D]">[D] Crafty and other topics</A></H2>
1586 <HR>
1587 <H3><A NAME="[D.1]">[D.1] What is XChess?</A></H3>
1588
1589 XChess is an older chessboard program that is no longer supported.  XChess was
1590 written for X version 10, and you may or may not be able to build and run it
1591 on an X11 system.
1592
1593 <P>XChess has only one significant feature that is not present in XBoard: Two
1594 humans can play chess using XChess on different machines, without using the
1595 Internet Chess Server as an intermediary.  This feature is of interest only if
1596 you don't have network connectivity to the Internet Chess Server.
1597
1598 <P>Note: There actually have been several different programs called "XChess" in
1599 circulation at various times.  The above describes one that was associated
1600 with GNU Chess.
1601
1602 <HR>
1603 <H3><A NAME="[D.2]">[D.2] What is Winsock Chess?</A></H3>
1604
1605 Winsock Chess is a program that lets two people play chess across a
1606 network.  It runs only under Microsoft Windows.  Some of the code in
1607 Winsock Chess is derived from GNU Chess, but it is not maintained by
1608 the GNU Chess team.  You can get a copy from the Internet Chess
1609 Library; see topic <A HREF="#[A.2]">[A.2]</A>.  For more information,
1610 contact its author, Donald Munro, ccahdm@beluga.upe.ac.za.
1611
1612 <HR>
1613 <H3><A NAME="[D.3]">[D.3] What is Crafty?</A></H3>
1614
1615 Crafty is a freely-available chess program written by Bob Hyatt.
1616 Bob is the main author of the well-known chess program Cray
1617 Blitz.  Crafty is a very strong program, its code is available, commented
1618 and fairly readable, and its author is actively working on improvements.
1619
1620 <p>You can download Crafty from <a
1621 href="ftp://ftp.cis.uab.edu/pub/hyatt/"
1622 >ftp://ftp.cis.uab.edu/pub/hyatt/</a>.  Start by getting the <a
1623 href="ftp://ftp.cis.uab.edu/pub/hyatt/read.me" >read.me</a> file and
1624 reading it.  Among other things, this file contains instructions on
1625 how to install Crafty as a command-line application on your machine.
1626
1627 <p>There is a Crafty mailing list.
1628 To subscribe, send email to majordomo@cis.uab.edu, with
1629 "subscribe crafty-list" in the body.
1630
1631 <HR>
1632 <H3><A NAME="[D.4]">[D.4] How do I use Crafty with XBoard?</A></H3>
1633
1634 <p>First, you need to get Crafty and install it as a command-line
1635 application on your machine.  See topic <A HREF="#[D.3]">[D.3]</A>.
1636
1637 <p>To use Crafty with XBoard, give the -fcp
1638 parameter like this:
1639
1640 <p><PRE>
1641     xboard -fcp "./crafty" -fd <I>crafty_directory</I>
1642 </PRE>
1643
1644 Here <I>crafty_directory</I> is the directory where you installed Crafty.
1645 You can add more xboard options at the end of the command line.
1646
1647 <p>Crafty 15.14 or later is required to work properly with XBoard
1648 4.0.0 or later.  We generally recommend using the latest versions of
1649 both XBoard and Crafty.
1650
1651 <HR>
1652 <H3><A NAME="[D.5]">[D.5] How do I use Crafty with WinBoard?</A></H3>
1653
1654 <p>First, you need to get Crafty and install it as a command-line
1655 application on your machine.  See topic <A HREF="#[D.3]">[D.3]</A>.
1656 It is best to use the latest version of Crafty with the latest version
1657 of WinBoard to make sure all features are compatible and function
1658 correctly.  You can install Crafty in any directory you like.
1659
1660 <p>You also need to get WinBoard and install it in the normal way
1661 using its built-in installer.  You can do that either before or after
1662 you install Crafty.
1663
1664 <p>After both Crafty and WinBoard are installed separately, follow the
1665 directions in the WinBoard Help file (included with WinBoard) for
1666 connecting new chess engines to WinBoard.
1667
1668 <p>If you want to have Crafty act as an automated computer player on a
1669 chess server, see topic <A HREF="#[B.16]">[B.16]</A>.  Before you try
1670 to get that working, be sure you can play against Crafty locally,
1671 first without WinBoard, then with it.  Also be sure you can use
1672 WinBoard to play on the chess server yourself, without having Crafty
1673 connected to it.  You have to crawl before you can walk!
1674
1675 <HR>
1676 <H3><A NAME="[D.6]">[D.6] How do I use GNU Chess 5 with XBoard?</A></H3>
1677
1678 <p>By default, XBoard still tries to use GNU Chess 4 by running the
1679 command "gnuchessx".  That's why if you don't have GNU Chess 4, you
1680 get the error message "Failed to start first chess program gnuchessx
1681 on localhost: gnuchessx: No such file or directory."
1682
1683 <p>If you have GNU Chess 5, the command should be "gnuchess xboard"
1684 instead.  To make XBoard use this command, give the -fcp parameter
1685 like this:
1686
1687 <p><PRE>
1688     xboard -fd <I>gnuchess_directory</I> -fcp "./gnuchess xboard"
1689 </PRE>
1690
1691 Here <I>gnuchess_directory</I> is the directory where you installed
1692 GNU Chess 5 and its book.  You can add more xboard options at the
1693 end of the command line.
1694
1695 <p><HR>
1696 $Id$<br>
1697 ** End of XBoard/WinBoard FAQ **
1698 </BODY></HTML>