home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computer Studio 1997 July & August / Amiga_Computer_studio_07-08-1998.7z / Amiga_Computer_studio_07-08-1998.iso / games / shareware / gnuchess-4.0.pl77 / faq next >
Internet Message Format  |  1996-05-16  |  67KB
  1. From: mann@pa.dec.com (Tim Mann)
  2. Newsgroups: gnu.chess,rec.games.chess.computer,alt.chess.ics,alt.answers,rec.answers,news.answers
  3. Subject: FAQ -- GNU Chess and XBoard Frequently Asked Questions
  4. Followup-To: gnu.chess
  5. Reply-To: bug-gnu-chess@prep.ai.mit.edu
  6. Approved: news-answers-request@MIT.EDU
  7. Summary: Answers to frequently asked questions in the gnu.chess
  8.   newsgroup, covering the chess-playing program GNU Chess, the chess
  9.   interfaces XBoard, WinBoard, and AmyBoard, and other chess topics.
  10.  
  11. Archive-name: games/chess/gnu-faq
  12. Version: $Id: FAQ.html,v 1.69 1996/05/07 05:16:56 mann Exp $
  13. Posting-frequency: monthly
  14.  
  15. GNU Chess and XBoard:
  16. Frequently Asked Questions
  17.  
  18. Here is the list of frequently asked questions and answers for the
  19. gnu.chess newsgroup, covering the chess-playing program GNU Chess, the
  20. chess interfaces XBoard, WinBoard, and AmyBoard, and a few other chess
  21. topics. In addition to the plain text version that is posted to the
  22. newsgroups, a hyperlinked version of this FAQ is available on the Web
  23. through the page
  24. http://www.research.digital.com/SRC/personal/Tim_Mann/chess.html .
  25. _______________________________________________________________________
  26.  
  27. Outline
  28.  
  29.    * [A] Introduction and hot topics
  30.    * [B] GNU Chess
  31.    * [C] GNU Chess bugs and problems
  32.    * [D] XBoard, WinBoard, and AmyBoard
  33.    * [E] XBoard, WinBoard, and AmyBoard bugs and problems
  34.    * [F] Miscellaneous
  35. _______________________________________________________________________
  36.  
  37. Detailed contents
  38.  
  39.    * [A] Introduction and hot topics
  40.         * [A.1] What are the gnu.chess newsgroup and info-gnu-chess
  41.           mailing list for?
  42.         * [A.2] How do I subscribe or unsubscribe?
  43.         * [A.3] Where can I get chess information and chess software?
  44.         * [A.4] What are the current version numbers for GNU Chess,
  45.           XBoard, etc.?
  46.         * [A.5] Who is working on this project?
  47.         * [A.6] How do I report bugs, offer help, etc.?
  48.    * [B] GNU Chess
  49.         * [B.1] What is GNU Chess?
  50.         * [B.2] What is GNU Chess's rating?
  51.         * [B.3] Does GNU Chess run on a PC under DOS (or Windows, or
  52.           OS/2)?
  53.         * [B.4] Does GNU Chess run on an Amiga?
  54.         * [B.5] Does GNU Chess run on a Macintosh?
  55.         * [B.6] Does GNU Chess run on VMS?
  56.         * [B.7] How do I build GNU Chess? Do I have to have gcc?
  57.    * [C] GNU Chess bugs and problems
  58.         * [C.1] XBoard tells me "Error: first chess program (gnuchessx)
  59.           exited unexpectedly".
  60.         * [C.2] Sometimes GNU Chess plays an extra, bogus move after the
  61.           game is over.
  62.         * [C.3] XBoard sometimes hangs when I'm using it to play against
  63.           GNU Chess on a position that I've modified with Edit Position.
  64.         * [C.4] GNU Chess lets its flag fall a move or two before the
  65.           time control.
  66.         * [C.5] GNU Chess (used with XBoard) freezes after it gets out
  67.           of its opening book.
  68.         * [C.6] GNU Chess (used with XBoard) sometimes tells me that a
  69.           legal move is illegal.
  70.         * [C.7] GNU Chess crashes when I try to compile and run it on
  71.           the DEC Alpha.
  72.         * [C.8] Running (or building) GNU Chess fails with a message
  73.           about FIONREAD.
  74.         * [C.9] Building GNU Chess fails with a message that
  75.           "setlinebuf" is undefined.
  76.         * [C.10] Building GNU Chess fails with a message that _tgetent,
  77.           etc., are undefined.
  78.         * [C.11] GNU Chess runs way too slow and makes my disk seek
  79.           wildly.
  80.    * [D] XBoard, WinBoard, and AmyBoard
  81.         * [D.1] What is XBoard?
  82.         * [D.2] Is there an XBoard for Microsoft Windows? What is
  83.           WinBoard?
  84.         * [D.3] Is there an XBoard for the Amiga? What is AmyBoard?
  85.         * [D.4] Is there an XBoard for the Macintosh?
  86.         * [D.5] Does XBoard run on VMS?
  87.         * [D.6] What is cmail?
  88.         * [D.7] How do I build XBoard? Do I have to have gcc?
  89.         * [D.8] Can I use XBoard to play a game of chess with another
  90.           human?
  91.         * [D.9] Will WinBoard run on Windows 3.1?
  92.         * [D.10] How do I use XBoard or WinBoard as an external viewer
  93.           for PGN files with my Web browser?
  94.         * [D.11] How do I use WinBoard as an external viewer for PGN
  95.           files with the MS Windows File Manager or Explorer?
  96.         * [D.12] How do I use ICC timestamp or FICS timeseal with
  97.           XBoard?
  98.         * [D.13] How do I use ICC timestamp or FICS timeseal with
  99.           WinBoard?
  100.         * [D.14] How do I play bughouse with XBoard or WinBoard?
  101.         * [D.15] How can I scroll back in the WinBoard console?
  102.    * [E] XBoard, WinBoard, and AmyBoard bugs and problems
  103.         * [E.1] I can't build XBoard because xmkmf and imake are not
  104.           present on my system.
  105.         * [E.2] I can't build XBoard because the X11/Xaw/... include
  106.           files are not found.
  107.         * [E.3] Building XBoard fails due to undefined symbols or
  108.           missing include files.
  109.         * [E.4] I have problems using WinBoard on ICS with a modem. I'm
  110.           not running SLIP or PPP, but just dialing in to an ordinary
  111.           login account ("shell account").
  112.         * [E.5] I have problems using WinBoard on ICS with Windows 95
  113.           and SLIP or PPP. When trying to start up, it gets the error
  114.           "Address family not supported by protocol family" (or some
  115.           equally strange message).
  116.         * [E.6] When I try to run WinBoard, I get the message "Failed to
  117.           start chess program gnuchesx on localhost: NO LANGFILE (file
  118.           gnuchess.lang not found)".
  119.         * [E.7] I want to use XBoard or WinBoard as an Internet Chess
  120.           Server interface, but the ICS Client option is grayed out on
  121.           the menu.
  122.         * [E.8] How do I give command-line options to a Windows program
  123.           like WinBoard?
  124.         * [E.9] When I try to log in to ICC using timestamp (or to FICS
  125.           using timeseal) with XBoard, it accepts my handle, but just
  126.           beeps at me when I type my password.
  127.         * [E.10] When I exit from WinBoard after using it to play
  128.           against GNU Chess or Crafty, the chess program keeps running
  129.           in the background.
  130.    * [F] Miscellaneous
  131.         * [F.1] What is XChess?
  132.         * [F.2] What is Winsock Chess?
  133.         * [F.3] What is Crafty?
  134.         * [F.4] How do I use Crafty with XBoard or WinBoard?
  135. _______________________________________________________________________
  136.  
  137. [A] Introduction and hot topics
  138.  
  139. _______________________________________________________________________
  140.  
  141. [A.1] What are the gnu.chess newsgroup and info-gnu-chess mailing list
  142. for?
  143.  
  144. The newsgroup gnu.chess and the mailing list
  145. info-gnu-chess@prep.ai.mit.edu are for the discussion of GNU Chess,
  146. XBoard, and related free chess software.
  147.  
  148. gnu.chess and info-gnu-chess are not for general chess or computer chess
  149. discussion. You won't be flamed if you post such messages here, but you
  150. will find more information in other places. See topic [A.3] below.
  151.  
  152. PLEASE DO NOT try to start or play chess games by posting messages to
  153. gnu.chess. Instead, read the rec.games.chess FAQ to learn about the
  154. IECG, the IECC, and other groups that you can join to find opponents,
  155. and send one or more of them email to join.
  156.  
  157. The newsgroup and mailing list are gatewayed bidirectionally; that is,
  158. any article posted on the newsgroup is automatically forwarded to the
  159. mailing list, and any mail sent to the list is automatically forwarded
  160. to the newsgroup. There is some question about whether this gatewaying
  161. will continue, however. I think it is best to use the newsgroup and not
  162. the mailing list.
  163. _______________________________________________________________________
  164.  
  165. [A.2] How do I subscribe or unsubscribe?
  166.  
  167. The simplest way is to either choose to read gnu.chess in your
  168. newsreader, or choose not to.
  169.  
  170. If you want to be added to or deleted from the mailing list, mail to
  171. info-gnu-chess-request@prep.ai.mit.edu (not to the list or newsgroup
  172. itself).
  173. _______________________________________________________________________
  174.  
  175. [A.3] Where can I get chess information and chess software?
  176.  
  177. As a shortcut to most things mentioned in this FAQ, try my Chess Web
  178. page, http://www.research.digital.com/SRC/personal/Tim_Mann/chess.html .
  179.  
  180. For general news and information about chess, try the newsgroup
  181. hierarchy rec.games.chess.*, especially the groups rec.games.chess.misc
  182. and rec.games.chess.computer. Both of the latter groups have very
  183. informative FAQs maintained by Steve Pribut; look for them on the
  184. newsgroups or at http://www.clark.net/pub/pribut/chess.html .
  185.  
  186. Like other GNU software, you can get GNU Chess and XBoard by anonymous
  187. FTP from ftp://prep.ai.mit.edu/pub/gnu/ and its many mirror sites. Look
  188. for files matching the patterns gnuchess-*.gz and xboard-*.gz. The .gz
  189. suffix indicates the files were compressed with gzip. You can get gzip
  190. from prep.ai.mit.edu also. The GNU FTP sites carry Unix-compatible
  191. versions of GNU software only, so you won't find WinBoard or AmyBoard
  192. there.
  193.  
  194. For other chess software, try the Internet Chess Library. Use anonymous
  195. FTP to connect to caissa.onenet.net, or go to the Web page
  196. http://caissa.onenet.net/chess/ . You can get chess software, game
  197. collections, the FAQ file for rec.games.chess, and other chess-related
  198. material there, in the directory pub/chess. Sometimes new XBoard
  199. versions arrive on this site before they make it to prep. The FTP server
  200. can automatically decompress files for you as you download them, useful
  201. if you don't have gzip. Note that caissa.onenet.net is no longer the
  202. same machine as ics.onenet.net!
  203.  
  204. You can get WinBoard from the Internet Chess Library, in directory
  205. pub/chess/Win3.
  206.  
  207. Here is a sample anonymous ftp session. Some of the ftp server's
  208. responses are abbreviated, but all the commands you must type are
  209. included.
  210.  
  211. % ftp prep.ai.mit.edu
  212. Connected to prep.ai.mit.edu
  213. Name: anonymous
  214. Password: your-email-address@your-site
  215. ftp> binary
  216. 200 Type set to I.
  217. ftp> cd /pub/gnu
  218. 250 CWD command successful.
  219. ftp> dir gnuchess-*.gz
  220. -rw-r--r-- 1 14910 wheel 1448657 Feb 21 22:17 gnuchess-4.0.pl75.tar.gz
  221. ftp> get gnuchess-4.0.pl75.tar.gz
  222. 150 BINARY connection for gnuchess-4.0.pl75.tar.gz (1448657 bytes).
  223. 226 Transfer complete.
  224. ftp> dir xboard-*.gz
  225. -rw-r--r-- 1 14910 wheel  312553 Aug 07 20:53 xboard-3.4.pl1.tar.gz
  226. ftp> get xboard-3.4.pl1.tar.gz
  227. 150 BINARY connection for xboard-3.4.pl1.tar.gz (312553 bytes).
  228. 226 Transfer complete.
  229. ftp> quit
  230.  
  231. _______________________________________________________________________
  232.  
  233. [A.4] What are the current version numbers for GNU Chess, XBoard, etc.?
  234.  
  235. At this writing, the current version numbers are:
  236.    * GNU Chess 4.0 patchlevel 75. Patchlevel 77 should be out soon; 76
  237.      was never publicly released.
  238.    * XBoard 3.4 patchlevel 1
  239.    * WinBoard 3.4 patchlevel 1
  240.    * AmyBoard 330.5 (based on XBoard 3.3 patchlevel 0)
  241. _______________________________________________________________________
  242.  
  243. [A.5] Who is working on this project?
  244.  
  245. Stuart Cracraft is the GNU Chess project coordinator. Currently Chua
  246. Kong Sian seems to be the only person working the GNU Chess engine
  247. itself. Conor McCarthy is responsible for GNU Chess 4.00 for Windows.
  248. Tim Mann maintains this FAQ and is the main developer on XBoard and
  249. WinBoard, but he has little time to spend on the project. Carsten Meyer
  250. has officially taken over maintenance of AmyBoard, but has not released
  251. a new version yet. Evan Welsh, the author of cmail, is not actively
  252. working on it but does fix bugs when they are reported.
  253. _______________________________________________________________________
  254.  
  255. [A.6] How do I report bugs, offer help, etc.?
  256.  
  257. Any time you want to report a possible bug in GNU Chess, XBoard, etc.,
  258. we need to know exactly what you did, and exactly what error (or other)
  259. messages you got. If you're using XBoard, WinBoard, or AmyBoard, run it
  260. with the -debug flag to see all the messages it exchanges with GNU Chess
  261. or the Internet Chess Server.
  262.  
  263. If you are using Unix, run the "script" program, do whatever is
  264. necessary to reproduce the problem, type "exit" to the shell, and mail
  265. us the resulting typescript file. We also need to know what
  266. hardware/operating system combination you are using. The command "uname
  267. -a" will usually tell you this; include its output in your typescript.
  268.  
  269. If you are using MS Windows or the Amiga, you may have to write down all
  270. the messages with pencil and paper and type them into your mail message.
  271. Or you may be able to use cut-and-paste in your console window. Either
  272. way, please transcribe the messsages carefully. They may seem
  273. meaningless to you, but they are meaningful to us and essential for
  274. diagnosing problems.
  275.  
  276. You should be able to contact all the members of the project by sending
  277. mail to bug-gnu-chess@prep.ai.mit.edu. If you don't trust this list, you
  278. can send mail about XBoard, WinBoard, or the FAQ to mann@pa.dec.com (Tim
  279. Mann); mail about AmyBoard to DarkSide@darkness.gun.de (Carsten Meyer);
  280. mail about cmail to R.E.Welsh@quadstone.co.uk (Evan Welsh). Comments
  281. that are of interest to all users of the software should be posted to
  282. the gnu.chess newsgroup.
  283. _______________________________________________________________________
  284.  
  285. [B] GNU Chess
  286.  
  287. _______________________________________________________________________
  288.  
  289. [B.1] What is GNU Chess?
  290.  
  291. GNU Chess is a free chess-playing program developed as part of the GNU
  292. project of the Free Software Foundation (FSF).
  293.  
  294. GNU Chess is a communal chess program. Contributors donate their time
  295. and effort in order to make it a stronger, better, sleeker program.
  296. Contributions take many forms: interfaces to high-resolution displays,
  297. opening book treatises, speedups of the underlying algorithms, additions
  298. of extra heuristics. These contributions are then distributed to the
  299. large user-base so that all may enjoy the fruits of our labor.
  300.  
  301. GNU Chess is intended to run under Unix or Unix-compatible systems. It
  302. is written in C and should be portable to other systems.
  303.  
  304. For a test drive, try WebChess, a World Wide Web interface to GNU Chess
  305. provided by DJ Delorie. The URL is
  306. http://www.delorie.com/game-room/chess/ .
  307. _______________________________________________________________________
  308.  
  309. [B.2] What is GNU Chess's rating?
  310.  
  311. It would be irresponsible to answer this question with a number, without
  312. first explaining a few things about ratings.
  313.  
  314. The ratings that are commonly given for computer chess players are less
  315. meaningful than they may seem. Most computer chess players (including
  316. GNU Chess) do not play in tournaments against humans, or do so only
  317. rarely, so they do not have official ratings from FIDE, USCF, or other
  318. chess organizations.
  319.  
  320. Some people have methods for rating chess programs approximately by
  321. giving them a set of problems to work on and seeing how they do, or by
  322. having them play tournaments against each other. Any rating number
  323. produced by such means should be taken with a grain of salt; it may be
  324. only a rough approximation to the rating the program would achieve in
  325. over-the-board tournament competition against humans. The chess skills
  326. required for solving problems or playing against other computers are not
  327. necessarily the same as those required for play against humans. Also, of
  328. course, tournaments among computers can rate the computers only relative
  329. to one another, not relative to humans. Some of the computers need to be
  330. rated by other means to give the ratings a basis to start from.
  331.  
  332. Compared with human players, computer players are strong tactically but
  333. weak strategically, and are much better at blitz chess than at slow
  334. chess. These differences make it more difficult to assign a meaningful
  335. rating too.
  336.  
  337. Several computers do play regularly on the Internet chess servers and
  338. have achieved ratings there. These ratings have the advantage of being
  339. based on many games. On the other hand, ICS ratings are only roughly
  340. comparable to USCF or FIDE ratings. Many players have ICS ratings that
  341. are hundreds of points higher or lower than their USCF or FIDE ratings.
  342.  
  343. Finally, unlike dedicated chess machines, or PC chess programs that run
  344. on only a few different models of Intel processors, GNU Chess runs on
  345. many different kinds of CPU at many different speeds. Thus its strength
  346. depends on how fast a machine you run it on and how much optimization
  347. your C compiler does. Some people have formulas for estimating how a
  348. computer player's rating varies on faster or slower machines---see the
  349. rec.games.chess FAQ for more information---but these need to be taken
  350. with a grain of salt too.
  351.  
  352. All that said, here are some numbers.
  353.  
  354. - On the Internet Chess Club, a copy of GNU Chess running on an SGI Onyx
  355. R4400 under the handle MaxII has achieved a blitz rating of over 2500
  356. and a standard rating of over 2300.
  357.  
  358. - Wolfgang Gabriel ran the Bednorz-Toennissen Test BT2630 with GNU Chess
  359. 4.0 pl74 on a 60 MHz Pentium with 16 MB of RAM. The test gave an
  360. estimated rating of 2213. He also ran Fritz-2 on the same hardware and
  361. got an estimated rating of 2311.
  362. _______________________________________________________________________
  363.  
  364. [B.3] Does GNU Chess run on a PC under DOS (or Windows, or OS/2)?
  365.  
  366. Yes. There are several versions available.
  367.  
  368. WinBoard provides a graphical user interface to GNU Chess that runs on
  369. Windows 95 and Windows NT. See topic [D.2] . The WinBoard distribution
  370. includes a GNU Chess executable for the Intel architecture, plus
  371. instructions and patches (when necessary) for recompiling GNU Chess from
  372. the official sources, available separately.
  373.  
  374. GNU Chess 4.00 for Windows bundles GNU Chess and a custom graphical
  375. interface into a single program. Unlike WinBoard, it runs on Windows 3.1
  376. if you have the Win32s compatibility package installed (available free
  377. from Microsoft). You can get GNU Chess 4.00 for Windows from
  378. ftp://prep.ai.mit.edu/pub/gnu/gnuchessPC-4.0.pl75.zip . The distribution
  379. includes complete sources and an Intel executable.
  380.  
  381. The standard GNU Chess 4.0 distribution can be compiled for MS-DOS, and
  382. will run under Windows in a DOS box, but with no graphical interface.
  383. Depending on what patchlevel of GNU Chess you get and what C compiler
  384. you have, you may need to make minor source changes to get it to
  385. compile. Some precompiled versions are available in the Internet Chess
  386. Library; the most recent I'm aware of is rather old:
  387. ftp://chess.onenet.net/pub/chess/DOS/OLD-STUFF/gnu40-62.exe .
  388.  
  389. Here is a listing of GNU Chess files for the PC in the Internet Chess
  390. Library (topic [A.3] ). They are scattered among the directories
  391. /pub/chess/Win3, /pub/chess/DOS, and (don't forget)
  392. /pub/chess/DOS/OLD-STUFF. This listing may be outdated; see the library
  393. itself to look for additions.
  394.  
  395. MS-DOS:
  396.   gnu40-62.exe     1323260  Probably GNU Chess 4.0.pl62 for MS-DOS
  397.   gnu40dos.exe T    317072  GNU Chess 4.0pl60 by Free Software Foundation
  398.                          -  compiled for DOS, executables only
  399.   gnu40src.exe      307786  GNU Chess 4.0pl60 by Free Software Foundation
  400.                          -  sources only
  401.   gnuchs31.exe T    270559  GNU Chess 3.1 by Free Software Foundation
  402.                          -  compiled for DOS, sources and executables
  403.   gnuchs40.exe T    355494  GNU Chess 4.0pl60 by Free Software Foundation
  404.                          -  compiled for 80386er, executables only
  405.  
  406. Windows:
  407.   chess321.exe W  M 238185  GNU Chess 3.21 ported by Daryl K. Baker
  408.  
  409. OS/2:
  410.   gpl65os2.zip      677824  gnuchess-4.0.pl65 compiled for os2.
  411.   gc-os2-m.zip      578032  gnuchess 4.0 for os2 with mouse support.
  412.   gnu40os2.zip     1303602  Executables for running gnuchess 4.0 pl62
  413.                          -  under OS/2. 
  414.   pmchs.exe    W  M  92004  OS/2 PM Chess 1.01 (GNU Chess 3.1 Windows by
  415.                          -  Daryl K. Baker) port to OS/2 by Kent Cedola
  416.   pmchssrc.exe      110279  OS/2 PM Chess 1.01 (GNU Chess 3.1 Windows by
  417.                          -  Daryl K. Baker) sources only
  418.  
  419. Porting GNU software to PCs is not a major focus of the GNU project, and
  420. these ports are not supported by the FSF. Contact the people who did the
  421. ports if you have questions or problems.
  422. _______________________________________________________________________
  423.  
  424. [B.4] Does GNU Chess run on an Amiga?
  425.  
  426. There are at least three ports of GNU Chess to the Amiga. As with the PC
  427. ports, these ports are not supported by the FSF; contact the people who
  428. did the ports if you have problems or questions.
  429.  
  430. The AmyBoard port (probably the best) is discussed in topic [D.3] .
  431.  
  432. UChess and AmigaGnuChess are available in the Internet Chess Library
  433. (topic [A.3] ), in the directory /pub/chess/Amiga. UChess is the newer
  434. of the two.
  435.  
  436. -r--r--r--  1 chess    chess   204025 Mar 31  1993 AmigaGnuChess.lha
  437. -r--r--r--  1 chess    chess    10122 Mar 31  1993 AmigaGnuChess.readme
  438.  
  439. -r--r--r--  1 chess    chess   705327 May  7 10:28 UChess283.lha
  440. -r--r--r--  1 chess    chess    21478 May  7 10:26 UChess283.readme
  441. -r--r--r--  1 chess    chess   199387 May  7 10:27 UChess283Patch.lha
  442. -r--r--r--  1 chess    chess    21589 May  7 10:26 UChess283Patch.readme
  443.  
  444. _______________________________________________________________________
  445.  
  446. [B.5] Does GNU Chess run on a Macintosh?
  447.  
  448. There is a port of GNU Chess 4.0 to the Macintosh. It's available from
  449. the Internet Chess Library (topic [A.3] ) under /pub/chess/Macintosh or
  450. /pub/chess/uploads/Macintosh, in the following files:
  451.  
  452.     GnuChessMac40b5.hqx  - executable binary
  453.     GCMsource40b5.hqx    - source
  454.  
  455. As with the PC ports, the Macintosh port is not supported by the Free
  456. Software Foundation. If you have questions or problems, contact Dan
  457. Oetting, oetting@gldfs.cr.usgs.gov.
  458.  
  459. If you have the old Mac port of GNU Chess 3.0, be sure to get 4.0
  460. instead. GNU Chess has come a long way since version 3.0!
  461. _______________________________________________________________________
  462.  
  463. [B.6] Does GNU Chess run on VMS?
  464.  
  465. An old VAX VMS version is available at ada.cenaath.cena.dgac.fr in the
  466. [.VMS] directory:
  467.  
  468. Directory CENA10:[ANONYMOUS.VMS]
  469.  
  470. GNUCHESS.ZIP;1                     307  21-MAR-1994 18:42:05.13
  471.  
  472. It's only a character cell version for VT100, VT200, etc. terminals.
  473. Thanks to Patrick Moreau for this information.
  474. _______________________________________________________________________
  475.  
  476. [B.7] How do I build GNU Chess? Do I need gcc?
  477.  
  478. The first step to building GNU Chess is to get the distribution file and
  479. unpack it. See topic [A.3] for places you can ftp the distribution from.
  480.  
  481. To unpack the gnuchess distribution, gnuchess-*.tar.gz, put it into a
  482. new, empty directory, cd there, and give this Unix command:
  483.  
  484.     gzip -cd gnuchess-*.tar.gz | tar -xvf -
  485.  
  486. If this command fails because you don't have gzip, see topic [A.3] , and
  487. ask a local Unix expert if you need more help.
  488.  
  489. The above command will unpack all the files into a new directory. Next,
  490. cd into this new directory.
  491.  
  492. *** Patchlevel 74 and earlier ***
  493. You will find some instructions in a file named INSTALL. You will also
  494. need to read and edit the Makefile in the src subdirectory before you
  495. build; it may contain information missing from the INSTALL file.
  496.  
  497. You must run all three of the following commands to fully build GNU
  498. Chess:
  499.  
  500.     make
  501.     make gnuchess.data
  502.     make install
  503.  
  504. The first make command compiles the GNU Chess programs. (You can edit
  505. the "all:" line in the Makefile if you don't want to build all the
  506. programs. gnuchessr must always be built. gnuchessx is required if you
  507. will be using XBoard. The others are optional.) The "make gnuchess.data"
  508. command builds the book. The "make install" command copies the results
  509. to the BINDIR and LIBDIR you specified so that the different pieces can
  510. find each other.
  511. *** End patchlevel 74 and earlier ***
  512.  
  513. *** Patchlevel 75 and later ***
  514. First, if you have patchlevel 75, make the following correction to
  515. Makefile.in to fix a bug in "make install". This correction will be in
  516. patchlevel 77.
  517.    * Delete the line "LIBDIR = ."
  518.    * Below the line beginning "prefix =", insert the line "LIBDIR =
  519.      $(prefix)/lib"
  520.  
  521. Decide what directory tree you are going to install GNU Chess in. The
  522. default is /usr/local. If you have write access to this directory tree,
  523. make sure that it contains subdirectories bin, lib, and man. (If you
  524. must "su" to get write access to /usr/local, you don't need to do so
  525. until just before the "make install" below.) Type the following:
  526.  
  527.     configure
  528.     make
  529.     make install
  530.  
  531. If you are going to install GNU Chess under your home directory for
  532. personal use, do this instead:
  533.  
  534.     mkdir $HOME/bin $HOME/lib $HOME/man
  535.     configure --prefix=$HOME
  536.     make
  537.     make install
  538.  
  539. If you have problems or special requirements, see the files README,
  540. INSTALL, Makefile.in, and configure.in for more information.
  541. *** End patchlevel 75 and later ***
  542.  
  543. You don't need to have gcc to build GNU Chess. However, GNU Chess is
  544. written in ANSI C. If you have only an old K&R C compiler, be sure you
  545. have the current patchlevel of GNU Chess, and get "unproto" by:
  546.  
  547. Wietse Venema
  548. wietse@wzv.win.tue.nl
  549. Mathematics and Computing Science
  550. Eindhoven University of Technology
  551. The Netherlands
  552.  
  553. It was released in comp.sources.misc Vol 27 with patches in vol 28 and
  554. vol 38. Among other places, it can be found on unix.hensa.ac.uk in
  555. pub/uunet/usenet/comp.sources.misc/volume27/unproto.
  556.  
  557. Compile it and copy the cpp it produces into the gnuchess src directory
  558. before you type "make" there.
  559. _______________________________________________________________________
  560.  
  561. [C] GNU Chess bugs and problems
  562.  
  563. _______________________________________________________________________
  564.  
  565. [C.1] XBoard tells me "Error: first chess program (gnuchessx) exited
  566. unexpectedly".
  567.  
  568. Try running XBoard again with the "-debug" flag on the command line.
  569. This will print out all the messages received from GNU Chess.
  570.  
  571. If you see this problem as soon as GNU Chess starts up, most likely GNU
  572. Chess is exiting with an error message. If you see the message "NO
  573. LANGFILE", it means that you did not install GNU Chess correctly, and it
  574. is unable to find the file gnuchess.lang. Make sure that you defined
  575. LIBDIR in the gnuchess Makefile, and that gnuchess.lang is in that
  576. directory. If gnuchess.lang is not there, you probably didn't type "make
  577. install" in the gnuchess src directory; you must do this to install
  578. gnuchess.lang (and the gnuchess book). If you defined LIBDIR to
  579. something that is not an absolute pathname (that is, to something that
  580. does not start with a "/"), GNU Chess will work only if you run it from
  581. the GNU Chess "src" directory where you built it.
  582.  
  583. If the problem happens while GNU Chess is running, you may have hit a
  584. GNU Chess bug. There is a bug that can corrupt the stack and cause the
  585. program to exit, sometimes with a nonsensical message first, sometimes
  586. with no message. It is especially evident on Linux. The following new
  587. patch from Chua Kong Sian is believed to fix it. It will be included in
  588. 4.0.pl77.
  589.  
  590. Somewhere near line 960 in search.c, there is this line:
  591.     g->gmove = -1;
  592.  
  593. Change it to:
  594.     g->gmove = 0;
  595.  
  596. _______________________________________________________________________
  597.  
  598. [C.2] Sometimes GNU Chess plays an extra, bogus move after the game is
  599. over.
  600.  
  601. There have been bugs in some versions of GNU Chess that caused this
  602. symptom. We believe they are all fixed in 4.0 pl74 and later.
  603. _______________________________________________________________________
  604.  
  605. [C.3] XBoard sometimes hangs when I'm using it to play against GNU Chess
  606. on a position that I've modified with Edit Position.
  607.  
  608. You need to get the latest version of GNU Chess. A few recent versions
  609. of GNU Chess contained a subtle change to the behavior of the "new"
  610. command that made them incompatible with previous versions and with
  611. XBoard. There is no way to restore compatibility by changing XBoard, so
  612. instead, GNU Chess has been changed back. See topic [A.4] .
  613. _______________________________________________________________________
  614.  
  615. [C.4] GNU Chess lets its flag fall a move or two before the time
  616. control.
  617.  
  618. GNU Chess is known to be a bit too aggressive in using its clock time
  619. and sometimes lets its flag fall. Some bugs that caused this symptom
  620. have been fixed, but more work on the problem may be needed.
  621. _______________________________________________________________________
  622.  
  623. [C.5] GNU Chess (used with XBoard) freezes after it gets out of its
  624. opening book.
  625.  
  626. First, be sure you have the latest versions of GNU Chess and XBoard; see
  627. topic [A.4] above. If you do, and you still have this problem, check the
  628. following.
  629.  
  630. a) Perhaps the feature in GNU Chess that lets you stop it thinking on
  631. your time by just entering your move is not working. This feature relies
  632. on the FIONREAD ioctl, which seems to be broken on some versions of
  633. Unix. XBoard uses this feature if the flag -DATTENTION is not present on
  634. the DEFINES line of the XBoard Makefile. XBoard 3.1 and later are
  635. distributed with this flag already set, so you should not have a problem
  636. unless you have removed it.
  637.  
  638. b) You might have built your GNU Chess with the wrong -D options. With
  639. some versions of GNU Chess, this can cause GNU Chess and XBoard to
  640. disagree about what units time is measured in, causing GNU Chess to
  641. think for 100 times as long as it should. Look at your GNU Chess
  642. Makefile and check that the line of options marked "normal", not the
  643. line marked "gnufour ICS client", is uncommented, something like this:
  644.  
  645. # gnufour ICS client
  646. #
  647. #OPT= -DUSEINT -DCACHE -DCLIENT -DGDX -DHASGETTIMEOFDAY -DNULLMOVE \
  648.       -DQUIETBACKGROUND -DBAREBONES -DWAY4PL64 -DHISTORY -DAGING 
  649. # normal
  650. OPT= -DUSEINT -DCACHE -DGDX -DHASGETTIMEOFDAY -DNULLMOVE \
  651.      -DQUIETBACKGROUND -DSEMIQUIETBOOKGEN -DWAY4PL64 -DHISTORY \
  652.      -DHASHSTATS -DAGING 
  653.  
  654. c) You might have a persistent transposition table (hashfile) that has
  655. been corrupted. Look in the LIBDIR directory you defined in the GNU
  656. Chess Makefile, and if you find a file named gnuchess.hash there, remove
  657. it. Do not use the hashfile if you are running multiple copies of GNU
  658. Chess at the same time (for instance, with Two Machines mode in XBoard).
  659. In fact, it is probably best not to use the hashfile under any
  660. circumstances.
  661. _______________________________________________________________________
  662.  
  663. [C.6] GNU Chess (used with XBoard) sometimes tells me that a legal move
  664. is illegal.
  665.  
  666. a) First, be sure you have the latest versions of GNU Chess and XBoard;
  667. see topic [A.4] above. Several different bugs that could cause this
  668. symptom existed in old versions but have been fixed in the latest ones.
  669.  
  670. b) Another possibility is that you have a persistent transposition table
  671. (hashfile) that has been corrupted. Look in the LIBDIR directory you
  672. defined in the GNU Chess Makefile, and if you find a file named
  673. gnuchess.hash there, remove it. Do not use the hashfile if you are
  674. running multiple copies of GNU Chess at the same time (for instance,
  675. with Two Machines mode in XBoard). In fact, it is probably best not to
  676. use the hashfile under any circumstances.
  677. _______________________________________________________________________
  678.  
  679. [C.7] GNU Chess crashes when I try to compile and run it on the DEC
  680. Alpha.
  681.  
  682. Get the latest version of GNU Chess. Some bugs that showed up only on
  683. the Alpha are fixed in version 4.0 patchlevel 73 and later. If you still
  684. have problems, try compiling with the -migrate flag or the -O1 flag.
  685. Some versions of the Alpha C compiler have optimizer bugs that affect
  686. GNU Chess.
  687. _______________________________________________________________________
  688.  
  689. [C.8] Running (or building) GNU Chess fails with a message about
  690. FIONREAD.
  691.  
  692. The message looks something like this:
  693.  
  694.     FIONREAD: Operation not supported on socket
  695.     You probably have a non-ANSI ioctl.h; see README. -1 45 4004787f
  696.  
  697. If you are using gcc to compile, the solution to this error message is
  698. usually to go to the GNU Chess Makefile, find the line that starts
  699. "CFLAGS=" (with no # character in front of it), and append the flag
  700. "-traditional-cpp" to the end of the line. Then do
  701.  
  702.     rm dspcom*.o gnuan.o
  703.     make
  704.     make install
  705.  
  706. to rebuild gnuchess.
  707.  
  708. If you aren't using gcc, we don't really understand why this should
  709. happen, but we do have a brute-force workaround: You can simply disable
  710. the gnuchess feature that uses FIONREAD. Find all the places in dspcom.c
  711. (and gnuan.c) where the line "#ifdef FIONREAD" occurs. Change each of
  712. them to "#ifdef NOTDEF". Then recompile gnuchess.
  713.  
  714. With this code disabled, if you tell gnuchess to think on your time
  715. ("hard" mode), you will have to type ^C to make it stop thinking when
  716. you want to make your move. The current version of XBoard does this
  717. automatically, so disabling the code has no effect on XBoard.
  718. _______________________________________________________________________
  719.  
  720. [C.9] Building GNU Chess fails with a message that "setlinebuf" is
  721. undefined.
  722.  
  723. GNU Chess is trying to use a library function that is not present in
  724. your C library (namely, setlinebuf). There are two things to try as
  725. possible solutions:
  726.  
  727. 1) Add -DSYSV to the CFLAGS= line in the Makefile. (To the CFLAGS line
  728. that doesn't start with a # sign, that is.) Then do "rm nondsp.o; make".
  729.  
  730. 2) If (1) doesn't work, leaving you with a similar error, but citing
  731. setvbuf instead of setlinebuf, try the following. Remove the -DSYSV
  732. again, go into nondsp.c, and edit the line of code where setlinebuf is
  733. called to read "setbuf(stdout, NULL);" instead.
  734.  
  735. This problem will be fixed in GNU Chess 4.0.pl77.
  736. _______________________________________________________________________
  737.  
  738. [C.10] Building GNU Chess fails with a message that _tgetent, etc., are
  739. undefined.
  740.  
  741. If GNU Chess is statically linked, the library -lcurses must come
  742. *before* -ltermcap in the link command line (the last gcc command line
  743. you see before the error messages). Edit your Makefile to correct the
  744. order, or edit Makefile.in and rerun configure. This bug exists only in
  745. 4.0.pl75 and will be fixed in 4.0.pl77.
  746. _______________________________________________________________________
  747.  
  748. [C.11] GNU Chess runs way too slow and makes my disk seek wildly.
  749.  
  750. This happens if you don't have enough real memory (RAM) to run GNU
  751. Chess. You may need 16MB or more. You can reduce GNU Chess's memory
  752. requirements by reconfiguring it, or just buy more memory. Some (rather
  753. out of date) suggestions are in the file doc/PORTING from the GNU Chess
  754. source tree.
  755.  
  756. The following is from Nikhil Nair:
  757.  
  758.      It is perfectly possible to run gnuchess on an 8Mb system. I
  759.      would suggest that you don't edit the source (though the
  760.      defaults are the definitions of ttblsz or something like that
  761.      in src/ttable.h and DEFETABS in src/gnuchess.h), but rather
  762.      use the -C and -T command-line options (which even work for
  763.      gnuan, though not documented in the manpage). The defaults are
  764.      `-C 18001 -T 150001' (for MS-DOS, -T 8001). On my Linux
  765.      system, this uses just over 9Mb. From memory, `-C 6001 -T
  766.      40001' uses around 3Mb. Fiddle with these and see what results
  767.      you get.
  768.  
  769. Why does GNU Chess use so much memory? The extra memory lets it keep
  770. large hash tables that speed up its search and make it play better, and
  771. a large on-line book that improves opening play. If you have lots of
  772. memory you may want to reconfigure GNU Chess to use *more* than the
  773. default amount.
  774. _______________________________________________________________________
  775.  
  776. [D] XBoard, WinBoard, and AmyBoard
  777.  
  778. _______________________________________________________________________
  779.  
  780. [D.1] What is XBoard?
  781.  
  782. XBoard is a graphical chessboard that can serve as a user interface for
  783. GNU Chess, for the Internet Chess Servers, or for email correspondence
  784. chess, or can be used by itself. XBoard is free software.
  785.  
  786. As an interface to GNU Chess, XBoard lets you play a game against the
  787. machine, set up arbitrary positions, force variations, or watch a game
  788. between two machines.
  789.  
  790. As an interface to the Internet Chess Servers, XBoard lets you play
  791. against other ICS users, observe games they are playing, or review games
  792. that have recently finished. You don't need GNU Chess for this.
  793.  
  794. To play email correspondence chess with XBoard, you use it with the
  795. cmail program. See topic [D.6] below.
  796.  
  797. You can also use XBoard as a chessboard to play through games. It will
  798. read and write game files and allow you to play through variations
  799. manually. You can use it to browse games off the net, or to review GNU
  800. Chess, ICS, and email correspondence games you have saved. It saves
  801. games in PGN (portable game notation), and can read almost any game in
  802. algebraic notation. These features are available at all times, even if
  803. you do not have access to GNU Chess or an ICS.
  804.  
  805. XBoard runs under Unix or Unix-compatible systems. It requires the X
  806. Window System, version X11R4 or later. There are also ports of XBoard to
  807. Microsoft Win32 (that is, Windows NT or Windows 95) and to the Amiga.
  808. See topics [D.2] and [D.3] respectively.
  809. _______________________________________________________________________
  810.  
  811. [D.2] Is there an XBoard for Microsoft Windows? What is WinBoard?
  812.  
  813. WinBoard is a port of XBoard to true Microsoft Win32 systems, such as
  814. Windows NT and Windows 95. It uses the same back end chess code as
  815. XBoard, but the front end graphics code is a complete rewrite. WinBoard
  816. is free software.
  817.  
  818. The WinBoard distribution now includes a port of GNU Chess itself to
  819. Win32. The GNU Chess port is distributed in executable form, with
  820. instructions for rebuilding it from the standard GNU Chess sources
  821. (available separately). You should have at least 16 to 24 MB of memory
  822. to run GNU Chess with WinBoard.
  823.  
  824. cmail (topic [D.6] ) has not been ported to Win32. All the other XBoard
  825. functions are included in WinBoard.
  826. _______________________________________________________________________
  827.  
  828. [D.3] Is there an XBoard for the Amiga? What is AmyBoard?
  829.  
  830. AmyBoard is a port of XBoard to the Amiga, originally by Jochen
  831. Wiedmann, now maintained by Carsten Meyer. The distribution includes a
  832. port of GNU Chess. AmyBoard is free software.
  833.  
  834. System requirements:
  835.    * An Amiga (obviously :-), running OS 2.04 or later, 2Mb RAM or more.
  836.    * MUI 2.0 or later.
  837.    * Workbench or another screen with no less than 640x400 pixels
  838.      (adjustable with the MUI-Prefs); this restriction is just because
  839.      we don't have bitmaps with less than 40x40 pixels per square. If
  840.      someone contributes bitmaps with 20x20 or 20x25, they will work
  841.      with any Hires mode.
  842.  
  843. If you would like to use an ICS, you need an Internet connection via
  844. either
  845.    * a telnet-like program, or
  846.    * a terminal program reading from stdin and writing to stdout.
  847.  
  848. AmyBoard is available in the Internet Chess Library (topic [A.3] ).
  849. _______________________________________________________________________
  850.  
  851. [D.4] Is there an XBoard for the Macintosh?
  852.  
  853. No. But porting XBoard to the Mac should not be much harder than porting
  854. it to Win32 or the Amiga was. I can't do it because I don't have a Mac,
  855. I don't know how to program Macs, and I don't have time. If you do, feel
  856. free to give it a try! Send mail to me, mann@pa.dec.com (Tim Mann), if
  857. you're working on this.
  858. _______________________________________________________________________
  859.  
  860. [D.5] Does XBoard run on VMS?
  861.  
  862. No. This port would probably be a lot easier than the Win32 and Amiga
  863. ports were, because VMS has the X Window system (under the name
  864. DECwindows) and is now Posix compliant. However, in spite of the fact
  865. that I work for Digital, I don't know enough about VMS to do the port
  866. myself. And I don't have time. If you do, give it a try! Send mail to
  867. me, mann@pa.dec.com (Tim Mann), if you're working on this.
  868. _______________________________________________________________________
  869.  
  870. [D.6] What is cmail?
  871.  
  872. cmail is a program that helps you play and keep track of electronic mail
  873. correspondence chess games using XBoard. It is distributed with XBoard
  874. and has its own manual page. cmail is free software.
  875. _______________________________________________________________________
  876.  
  877. [D.7] How do I build XBoard? Do I need gcc?
  878.  
  879. The first step to building XBoard is to get the distribution file. See
  880. topic [A.3] for places you can ftp the software from.
  881.  
  882. To unpack and build the xboard distribution, xboard-*.tar.gz, give these
  883. Unix commands:
  884.  
  885.     gzip -cd xboard-*.tar.gz | tar -xvf -
  886.     cd xboard-*/
  887.     configure
  888.     make
  889.  
  890. If the first step above fails because you don't have gzip, see topic
  891. [A.3] , and ask a local Unix expert if you need more help. If you have
  892. any problems with the last two steps, read the READ_ME and INSTALL files
  893. in the xboard-*/ directory. You will also find this FAQ there.
  894.  
  895. You don't need to have gcc to build XBoard, and your C compiler doesn't
  896. have to be ANSI-compliant.
  897. _______________________________________________________________________
  898.  
  899. [D.8] Can I use XBoard to play a game of chess with another human?
  900.  
  901. The only way for two humans on different machines to play chess in real
  902. time using XBoard is to use an Internet Chess Server as an intermediary.
  903. That is, each player runs his own copy of XBoard, both of them log into
  904. an ICS, and they play a game there. Two copies of XBoard cannot
  905. communicate with each other directly.
  906.  
  907. Instructions on how to get started with Internet chess are included with
  908. the XBoard distribution. The network addresses included in the XBoard
  909. distribution may not always be current. The oldest ICS is the Internet
  910. Chess Club at chess.lm.com, which now has a fee for registered use, but
  911. still allows free unregistered use. There are also many newer sites with
  912. no fees, using the Free Internet Chess Server implementation (FICS).
  913. Current FICS sites include ics.onenet.net (the most active),
  914. eics.daimi.aau.dk, dics.dds.nl, holly.csv.warwick.ac.uk, and
  915. chess.unix-ag.uni-kl.de. On all these machines, the port number to use
  916. is 5000. Try "finger chess@ics.onenet.net" for more address information.
  917.  
  918. Note: If you don't have network connectivity to any ICS site, you can
  919. run your own server using the FICS code. You can get a copy by anonymous
  920. ftp from the Internet Chess Library (topic [A.3] ). The code is changing
  921. rapidly, so send mail to chess@ics.onenet.net and/or log into the FICS
  922. server at ics.onenet.net and ask the administrators there for current
  923. information.
  924.  
  925. The cmail program included with XBoard lets you play email postal games
  926. with another human; see topic [D.6] .
  927.  
  928. Two humans can play chess on the same machine using one copy of XBoard
  929. in Edit Game mode, but the clocks don't run in this mode, so it's of
  930. limited usefulness.
  931.  
  932. See also topic [F.2] , Winsock Chess.
  933. _______________________________________________________________________
  934.  
  935. [D.9] Will WinBoard run on Windows 3.1?
  936.  
  937. WinBoard basically does not run on Windows 3.1 or Windows for Workgroups
  938. 3.11. Although you can use the program as a PGN viewer/editor under the
  939. Win32s compatibility package, the major features (interfacing to GNU
  940. Chess and to ICS) do not work. The main problem is that Win32s does not
  941. have threads or real concurrent processes. A port of WinBoard to Windows
  942. 3.1 is possible in theory, but it would be difficult and messy, and no
  943. one is going to do it.
  944.  
  945. WinBoard runs well on both Windows 95 and Windows NT.
  946. _______________________________________________________________________
  947.  
  948. [D.10] How do I use XBoard or WinBoard as an external viewer for PGN
  949. files with my Web browser?
  950.  
  951. 1) On Unix systems:
  952.  
  953. - Add the following line to the file .mime.types in your home directory.
  954. (Create the file if it doesn't exist already.)
  955.  
  956.     application/x-chess-pgn    pgn
  957.  
  958. - Add the following line to the file .mailcap in your home directory.
  959. (Create the file if it doesn't exist already.)
  960.  
  961.     application/x-chess-pgn; xboard -ncp -lgf %s
  962.  
  963. - Exit from your Web browser and restart it.
  964.  
  965. 2) On MS Windows systems:
  966.  
  967. The exact procedure depends on which Web browser you are using.
  968. Generally, you need to select something like Helper Applications or File
  969. Types from an Options menu or dialog, click the button that makes a new
  970. type, and fill in the boxes:
  971.  
  972.     Extension: pgn
  973.     Mime type: application/x-chess-pgn
  974.     Application command line: WinBoard -ncp
  975.  
  976. You will probably have to give a full pathname for WinBoard; you will
  977. probably be able to use a Browse button in the configuration dialog to
  978. look for it.
  979.  
  980. If your Web browser doesn't let you include arguments on the application
  981. command line, you'll need to put a file named WinBoard.ini in the
  982. working directory where the browser starts up WinBoard, containing the
  983. string -ncp . Without the -ncp, WinBoard will try to start up GNU Chess
  984. whenever you use it as a viewer. This will work if you have GNU Chess
  985. installed, and you might even prefer it if you want to have GNU Chess
  986. available to analyze the games you view.
  987.  
  988. 3) To confirm that your external viewer configuration is working, open
  989. one of the following URLs and click on any of the game names shown.
  990.    * http://www.research.digital.com/SRC/personal/Tim_Mann/chess.html#PGN
  991.    * http://www.ub.uit.no/chess/pgn/gamelist.html
  992.    * http://www.traveller.com/scripts/chess_players?Kasparov
  993.  
  994. Games at www.traveller.com don't cause XBoard to be started when you are
  995. using Netscape, but they do work with NCSA Mosaic. This seems to be due
  996. to a missing feature in Netscape, but unfortunately it will probably
  997. have to be fixed on the server end, given Netscape's status as the de
  998. facto standard.
  999. _______________________________________________________________________
  1000.  
  1001. [D.11] How do I use WinBoard as an external viewer for PGN files with
  1002. the MS Windows File Manager or Explorer?
  1003.  
  1004. For the File Manager on Windows 3.11, Windows NT 3.51, etc., select
  1005. Associate from the File menu, enter "pgn" as the extension, and use the
  1006. Browse button to find your copy of WinBoard and set up the association.
  1007.  
  1008. For the Explorer on Windows 95, follow the same procedure as in topic
  1009. [D.10] . You only have to follow the procedure once to configure both
  1010. Microsoft's Internet Explorer and the file system Explorer.
  1011. _______________________________________________________________________
  1012.  
  1013. [D.12] How do I use ICC timestamp or FICS timeseal with XBoard?
  1014.  
  1015. First, be sure that you can connect using XBoard without
  1016. timestamp/timeseal. Second, be sure that you can connect using
  1017. timestamp/timeseal without XBoard. See the help files on ICC and FICS or
  1018. ask people online if you have problems.
  1019.  
  1020. If you are in a completely ordinary situation, where your machine is
  1021. directly on the Internet and you can connect to ICC or FICS without
  1022. timestamp/timeseal using just the command "xboard -ics" or "xboard -ics
  1023. -icshost ics.onenet.net", change that command to one of the following:
  1024.  
  1025.     xboard -ics -icshost 192.231.221.16 -telnet -telnetProgram timestamp
  1026.  
  1027.     xboard -ics -icshost 164.58.253.10 -telnet -telnetProgram timeseal
  1028.  
  1029. If you have a firewall between your machine and the ICS, or if for any
  1030. reason you already have to use the -icscomm, -telnet, or -gateway option
  1031. to connect to ICS even when you are not running timestamp/timeseal, you
  1032. are going to have a harder time. The timestamp and timeseal protocols do
  1033. not work through firewalls, across serial lines, or across telnet
  1034. connections. You have to run the timestamp or timeseal program on a
  1035. machine that can make a direct TCP connection to the ICS. You may or may
  1036. not be permitted to do this, depending on your firewall's security
  1037. policy. See the section on FIREWALLS in the XBoard man page or info
  1038. file, and where it says to run "telnet" on your firewall machine, run
  1039. timestamp or timeseal instead. In this configuration you are not
  1040. protected against lag between your machine and the firewall, or lag
  1041. caused by heavy load on the firewall itself from other users.
  1042.  
  1043. For further information, see the help files on ICC and FICS. Also see
  1044. topic [E.9] .
  1045. _______________________________________________________________________
  1046.  
  1047. [D.13] How do I use ICC timestamp or FICS timeseal with WinBoard?
  1048.  
  1049. First, be sure that you can connect using WinBoard without
  1050. timestamp/timeseal. See the help files or ask people online if you have
  1051. problems.
  1052.  
  1053. If your machine is directly on the Internet and you can connect to ICC
  1054. or FICS without timestamp/timeseal using just the command line "WinBoard
  1055. -ics" or "WinBoard -ics -icshost ics.onenet.net", do the following
  1056. instead.
  1057.  
  1058.    1 Run the Windows timestamp (tmstamp) or Windows timeseal (tmseal)
  1059.      program. Both these programs were written by Don Fong and are
  1060.      available by anonymous FTP from chess.lm.com or the Internet Chess
  1061.      Library (topic [A.3] ). See the help files on ICC and FICS if you
  1062.      need to know more about them.
  1063.    2 Start WinBoard with the following command line. This causes
  1064.      WinBoard to talk to the timestamp/timeseal program running on your
  1065.      own machine ("localhost") instead of talking directly to the ICS.
  1066.  
  1067.          WinBoard -ics -icshost localhost
  1068.  
  1069.    3 After you are logged in, be sure that timestamp is really active.
  1070.      If you got the previous steps wrong, it won't be. On ICC, type
  1071.      "ping". On FICS, type "finger".
  1072.  
  1073. If you normally have to use the "-icscomm" command line option on
  1074. WinBoard to log into a shell account, and then telnet to ICC or FICS
  1075. from there, you are going to have to run the Unix version of timestamp
  1076. or timeseal on the shell machine. (If the shell account is not on a Unix
  1077. machine, you are out of luck.) Get the appropriate version of timestamp
  1078. or timeseal onto the shell machine via FTP; see the help files on ICC
  1079. and FICS for instructions. Then simply run it when you would normally
  1080. run telnet. In this configuration you are not protected against lag
  1081. between your PC and the shell machine, or for lag caused by heavy load
  1082. on the shell machine itself from other users.
  1083.  
  1084. If you have a firewall between your machine and the ICS, you may have a
  1085. harder time. The timestamp and timeseal protocols do not work through
  1086. firewalls, across serial lines, or across telnet connections. You have
  1087. to run the timestamp or timeseal program on a machine that can make a
  1088. direct TCP connection to the ICS. You may or may not be permitted to do
  1089. this, depending on your firewall's security policy. See the section on
  1090. FIREWALLS in the WinBoard help file, and where it says to run "telnet"
  1091. on your firewall machine, run timestamp or timeseal instead. In this
  1092. configuration you are not protected against lag between your PC and the
  1093. firewall, or for lag caused by heavy load on the firewall itself from
  1094. other users.
  1095.  
  1096. For further information, see the help files on ICC and FICS.
  1097. _______________________________________________________________________
  1098.  
  1099. [D.14] How do I play bughouse with XBoard or WinBoard?
  1100.  
  1101. XBoard/WinBoard 3.4 has simple but effective bughouse support. Offboard
  1102. piece holdings are shown in the board window's banner, and you drop
  1103. offboard pieces using the right mouse button. Press it over the
  1104. destination square to pop up a menu of pieces.
  1105.  
  1106. XBoard/WinBoard can display only one board at a time, but you can
  1107. observe your partner's game by running a second copy of XBoard and
  1108. logging in as a guest. (Unfortunately, this is not possible if you are
  1109. using the -icscomm option.) To observe your partner's games
  1110. automatically, turn on Auto Observe in the second XBoard's Options menu,
  1111. and put your partner on your ICS gnotify list. Or on ICC, use the
  1112. "follow" command to follow your partner's games.
  1113. _______________________________________________________________________
  1114.  
  1115. [D.15] How can I scroll back in the WinBoard console?
  1116.  
  1117. Under Windows NT, you can increase the number of lines in the console
  1118. window's buffer to whatever you want, using the system menu in the upper
  1119. left corner of the console window itself. If you resize the window to be
  1120. smaller than the buffer, a scroll bar appears.
  1121.  
  1122. Microsoft chose not to provide this feature in the consoles of Windows
  1123. 95, so there is no way to scroll back in them. Sorry. If you have time
  1124. to write code to work around this problem and would like to donate it,
  1125. please do so!
  1126. _______________________________________________________________________
  1127.  
  1128. [E] XBoard, WinBoard, and AmyBoard bugs and problems
  1129.  
  1130. _______________________________________________________________________
  1131.  
  1132. [E.1] I can't build XBoard because xmkmf and imake are not present on my
  1133. system.
  1134.  
  1135. This one is easy now. Beginning with XBoard 3.2, xmkmf and imake are no
  1136. longer required.
  1137. _______________________________________________________________________
  1138.  
  1139. [E.2] I can't build XBoard because the X11/Xaw/... include files are not
  1140. found.
  1141.  
  1142. These are the header files for the Athena Widgets library, which XBoard
  1143. uses heavily. Some versions of Unix don't supply these files, but they
  1144. are part of the standard X distribution, freely available from MIT.
  1145.  
  1146. For general information on getting missing X sources, see the FAQ on
  1147. comp.windows.x. Note that you may be missing only the header files, or
  1148. you may be missing the libraries themselves too.
  1149.  
  1150. HP-UX users are missing only the header files. You can get them by
  1151. anonymous FTP as follows. (But first check with your system
  1152. administrator to see if someone else at your site has already done
  1153. this.) Get the archive files /hpux9/X11R5/Core/imake-5.04.tar.gz (imake
  1154. and xmkmf, optional but useful) and /hpux9/X11R5/Core/Xaw-5.00.tar.gz
  1155. (Xaw header files) via anonymous FTP from the site hpux.csc.liv.ac.uk
  1156. (138.253.42.172), or one of the other official sites---Germany:
  1157. hpux.ask.uni-karlsruhe.de (129.13.200.57), US: hpux.cae.wisc.edu
  1158. (144.92.4.15), France: hpux.cict.fr (192.70.79.53) or Netherlands:
  1159. hpux.ced.tudelft.nl (130.161.140.100). Unpack the archives using gzip
  1160. and follow the instructions in their README and HPUX.Install files.
  1161. Thanks to Richard Lloyd for this information.
  1162.  
  1163. If you have the Xaw header files installed in a different place than the
  1164. other X11 headers, you may need to configure XBoard with an extra flag
  1165. to help it find them. For example, if yours are in /foo/bar/X11/Xaw, try
  1166. this:
  1167.  
  1168.     rm config.cache
  1169.     (setenv CFLAGS -I/foo/bar ; configure)
  1170.  
  1171. Also see topic [E.3] .
  1172. _______________________________________________________________________
  1173.  
  1174. [E.3] Building XBoard fails due to undefined symbols or missing include
  1175. files.
  1176.  
  1177. The configure script for XBoard looks for X libraries and header files
  1178. in some common places. Sometimes it fails: If yours are installed in an
  1179. odd place, it may not find them at all. If you have more than one
  1180. version of X installed on your system, it may find the "wrong" one, or
  1181. occasionally it may find libraries from one version and incompatible
  1182. header files from another. You can work around these problems by telling
  1183. the configure script where the files are. For example:
  1184.  
  1185.     configure --x-includes=/odd/place/include \
  1186.               --x-libraries=/odd/place/lib
  1187.  
  1188. The directory named in the argument to --x-includes must have a
  1189. subdirectory "X11" that contains the actual .h files.
  1190.  
  1191. Some linkers have bugs that cause bogus error messages when you try to
  1192. link X programs. The configure script includes a workaround for a bug of
  1193. this kind that exists in some SunOS 4.x.x installations. See the FAQ on
  1194. comp.windows.x for more information about problems of this kind.
  1195.  
  1196. If you have X11R6, the configure script for XBoard 3.2.pl2 and earlier
  1197. may not find all the link libraries you need. This bug is fixed in
  1198. XBoard 3.3.
  1199.  
  1200. If all else fails, check whether anyone else at your site has been able
  1201. to compile any X programs on your system. Your X installation might be
  1202. buggy. If so, the system administrator at your site might know how to
  1203. fix or work around the problem.
  1204.  
  1205. Also see topic [E.2] .
  1206. _______________________________________________________________________
  1207.  
  1208. [E.4] I have problems using WinBoard on ICS with a modem. I'm not
  1209. running SLIP or PPP, but just dialing in to an ordinary login account
  1210. ("shell account").
  1211.  
  1212. Here are solutions to some common problems in this area.
  1213.  
  1214. Some people want to connect to ICS through HyperTerminal or some other
  1215. terminal program first, then run WinBoard. This is not how it works.
  1216. WinBoard wants to talk directly with your modem, acting as a terminal
  1217. program itself. Start out with the modem "on hook" (not making a call).
  1218.  
  1219. Run WinBoard with a command line like this (adding more options if
  1220. desired):
  1221.  
  1222.     start WinBoard /ics /icscomm com1
  1223.  
  1224. Use com2, com3, or com4 in place of com1 if your modem is connected to
  1225. one of those ports. Leave out the "start" if this is the command line in
  1226. an icon you are making for WinBoard.
  1227.  
  1228. After you start WinBoard, you may need to change some of the options in
  1229. the Communications dialog (on the Options menu). The dialog has the
  1230. usual options for talking to modems: bits per second, bits per byte,
  1231. parity, number of stop bits. If you have to change anything in this
  1232. dialog, you'll have to change it every time you run WinBoard; there is
  1233. currently no way to save these options or specify them on the command
  1234. line. Sorry.
  1235.  
  1236. Next, type dialing commands to your modem in the text window that
  1237. WinBoard creates. You may need to turn off Local Line Editing on the
  1238. Options menu while you are typing commands to your modem. Turn it back
  1239. on when you're done. See the WinBoard Help file for instructions if you
  1240. see your typing echoed an extra time after you hit Enter.
  1241. _______________________________________________________________________
  1242.  
  1243. [E.5] I have problems using WinBoard on ICS with Windows 95 and SLIP or
  1244. PPP. When trying to start up, it gets the error "Address family not
  1245. supported by protocol family" (or some equally strange message).
  1246.  
  1247. WinBoard is a 32-bit application, but some Winsock (TCP/IP)
  1248. implementations support only 16-bit applications. You get a strange
  1249. looking error message if you try to use a 32-bit application because
  1250. there is no standard Winsock error code number for "32-bit application
  1251. not supported."
  1252.  
  1253. Microsoft TCP/IP works with both 16-bit and 32-bit applications,
  1254. supports SLIP, PPP, Ethernet, etc., and is included with Windows 95. If
  1255. possible, I recommend that you uninstall whatever Winsock you are using
  1256. and install Microsoft TCP/IP instead. For more information, see
  1257. http://walden.mo.net/~rymabry/95winfaq.html (the Win95-L FAQ) .
  1258.  
  1259. Trumpet Winsock 2.1 (and earlier) supports only 16-bit applications, and
  1260. hence does not work with WinBoard. But there is a beta-test release
  1261. available that does support 32-bit applications. I have not tried it
  1262. with WinBoard, but it should work. See Trumpet's Web page
  1263. http://www.trumpet.com.au/wsk/winsock.htm for more information.
  1264.  
  1265. A few versions of Winsock may have bugs that prevent Windows
  1266. timestamp/timeseal from working with them. I'm not sure if such bugs
  1267. exist in any versions that actually have 32-bit support, so this point
  1268. might be moot. Again, Microsoft TCP/IP is known to work.
  1269. _______________________________________________________________________
  1270.  
  1271. [E.6] When I try to run WinBoard, I get the message "Failed to start
  1272. chess program gnuchesx on localhost: NO LANGFILE (file gnuchess.lang not
  1273. found)".
  1274.  
  1275. This problem should not occur with WinBoard 3.4.pl1 and later. It used
  1276. to happen because some unzip programs (notably pkunzip) do not
  1277. understand long file names, so they would unzip gnuchess.lang as
  1278. gnuchess.lan and gnuchess.data as gnuchess.dat. I have changed the GNU
  1279. Chess port included with WinBoard to use the shorter names. However, if
  1280. you want to recompile WinBoard, you still need to use an unzip that
  1281. understands long file names, because some of the WinBoard source files
  1282. still have long names.
  1283. _______________________________________________________________________
  1284.  
  1285. [E.7] I want to use XBoard or WinBoard as an Internet Chess Server
  1286. interface, but the ICS Client option is grayed out on the menu.
  1287.  
  1288. XBoard and WinBoard have three major modes that can't be changed from
  1289. the menus; they can only be selected with command-line options: GNU
  1290. Chess mode, ICS mode, and standalone mode. GNU Chess mode is the
  1291. default. You need to give the -ics option on the command line for ICS
  1292. mode, or the -ncp ("no chess program") option for standalone mode. See
  1293. topic [E.8] .
  1294. _______________________________________________________________________
  1295.  
  1296. [E.8] How do I give command-line options to a Windows program like
  1297. WinBoard?
  1298.  
  1299. There are many ways; pick your favorite:
  1300.  
  1301.    * Type the command line into an MS-DOS Prompt box. Add the command
  1302.      "start" in front of it to avoid tying up the box the whole time
  1303.      WinBoard is running. Example: "start WinBoard -ics". Starting
  1304.      Windows programs from an MS-DOS Prompt box works only on Windows 95
  1305.      or Windows NT, but then, WinBoard itself works only on those
  1306.      systems.
  1307.    * Choose File|Run from the Program Manager, choose File|Run from the
  1308.      File Manager, or choose Run from the Windows 95 Start menu. Type
  1309.      the command line into the dialog you get. You may have to give
  1310.      WinBoard's full drivespec and filename if it is not in a directory
  1311.      on your search path.
  1312.    * Make a Program Manager icon for WinBoard. You can do this by
  1313.      dragging WinBoard.exe from the File Manager into the Program
  1314.      Manager, or by using File|New in the Program Manager. Select the
  1315.      icon and choose File|Properties. Edit the Command Line text box to
  1316.      add the command-line options to the end.
  1317.    * Make a Windows 95 shortcut for WinBoard. You can do this by
  1318.      right-dragging WinBoard.exe to the desktop and selecting "Create
  1319.      Shortcut(s) Here" from the menu that appears. Then right-click on
  1320.      the shortcut, select Properties, and click the Shortcut tab. The
  1321.      command-line text box is labelled "Target" instead of "Command
  1322.      line" just to confuse you. Edit this box, adding the command line
  1323.      options to the end.
  1324.    * Bonus alternative, WinBoard only: Make a file called winboard.ini
  1325.      in WinBoard's working directory or a directory on your search path.
  1326.      Put all the command line options in it. Don't put the word
  1327.      "WinBoard" in the file, just the options.
  1328. _______________________________________________________________________
  1329.  
  1330. [E.9] When I try to log in to ICC using timestamp (or to FICS using
  1331. timeseal) with XBoard, it accepts my handle, but just beeps at me when I
  1332. type my password.
  1333.  
  1334. I don't really understand why this happens, but several people have
  1335. reported it. They were all using SunOS 5.x (Solaris 2). The following
  1336. workaround has been reported to fix it. Recompile XBoard with the
  1337. commands:
  1338.  
  1339.     configure --disable-ptys
  1340.     make
  1341.  
  1342. If you needed additional flags on the configure command line the first
  1343. time you did it, add them here too.
  1344.  
  1345. This workaround may solve strange and mysterious problems on other
  1346. platforms too. I'm not sure that the pty code (which is disabled by the
  1347. above command) is really needed at all, but it was included in XBoard
  1348. 1.2 by the original authors, and I don't have access to any of the kinds
  1349. of machines where it is supposed to be needed, so I can't test for
  1350. myself.
  1351. _______________________________________________________________________
  1352.  
  1353. [E.10] When I exit from WinBoard after using it to play against GNU
  1354. Chess or Crafty, the chess program keeps running in the background.
  1355.  
  1356. This is a bug in WinBoard, not yet fixed in the current version (3.4
  1357. patchlevel 1). To work around it, always exit from WinBoard by selecting
  1358. the Exit item on WinBoard's File menu. Do not select Close from the
  1359. system menu in the upper left corner of the window banner, do not
  1360. double-click in the upper left corner of the banner, and do not press
  1361. the Windows 95 [X] button in the upper right corner of the banner. In
  1362. the latter cases, WinBoard does not take control and kill off the chess
  1363. program before exiting.
  1364.  
  1365. Also, if you are using Crafty, be certain to get the version compiled
  1366. for Win32 (wcrafty.exe), not the version compiled for MS-DOS
  1367. (crafty.exe).
  1368. _______________________________________________________________________
  1369.  
  1370. [F] Miscellaneous
  1371.  
  1372. _______________________________________________________________________
  1373.  
  1374. [F.1] What is XChess?
  1375.  
  1376. XChess is an older chessboard program that is no longer supported.
  1377. XChess was written for X version 10, and you may or may not be able to
  1378. build and run it on an X11 system.
  1379.  
  1380. XChess has only one significant feature that is not present in XBoard:
  1381. Two humans can play chess using XChess on different machines, without
  1382. using the Internet Chess Server as an intermediary. This feature is of
  1383. interest only if you don't have network connectivity to the Internet
  1384. Chess Server.
  1385.  
  1386. Note: There actually have been several different programs called
  1387. "XChess" in circulation at various times. The above describes one that
  1388. was associated with GNU Chess.
  1389. _______________________________________________________________________
  1390.  
  1391. [F.2] What is Winsock Chess?
  1392.  
  1393. Winsock Chess is a program that lets two people play chess across a
  1394. network. It runs only under Microsoft Windows. Some of the code in
  1395. Winsock Chess is derived from GNU Chess, but it is not maintained by the
  1396. GNU Chess team. You can get a copy from the Internet Chess Library; see
  1397. topic [A.3] . For more information, contact its author, Donald Munro,
  1398. ccahdm@beluga.upe.ac.za.
  1399. _______________________________________________________________________
  1400.  
  1401. [F.3] What is Crafty?
  1402.  
  1403. Crafty is a freely-available chess program written by Bob Hyatt. Bob is
  1404. the main author of the well-known chess program Cray Blitz. Crafty is
  1405. already a much better chess program than GNU Chess on many dimensions:
  1406. it plays better, the code is commented and readable, and the author is
  1407. actively working on improvements.
  1408. _______________________________________________________________________
  1409.  
  1410. [F.4] How do I use Crafty with XBoard or WinBoard?
  1411.  
  1412. This information comes from Bob Hyatt, author of Crafty; I have not
  1413. verified it personally. Crafty (as of version 9.25) now works well with
  1414. XBoard and WinBoard, though there are still some minor problems. If you
  1415. have an older version of Crafty, upgrade to the current one before
  1416. trying it with XBoard or WinBoard. Known problems and restrictions with
  1417. 9.25 are listed below. Please do not report them to us.
  1418.    * Move Now command may cause problems occasionally, especially in Two
  1419.      Machines mode.
  1420.    * Book command does nothing.
  1421.    * With WinBoard, you must use the version of Crafty compiled for
  1422.      Win32 (wcrafty.exe), not the version compiled for MS-DOS
  1423.      (crafty.exe). The MS-DOS version may appear to work, but it will
  1424.      generally fail to exit when WinBoard tries to kill it. This happens
  1425.      even if you select File|Exit to exit (topic [E.10] ).
  1426.  
  1427. Run XBoard with the following flags to use Crafty as the first and/or
  1428. second chess program. (The second chess program plays White in Two
  1429. Machines mode.) You can add more Crafty command line flags inside the
  1430. quotes; see Crafty's documentation to find out what they are.
  1431.  
  1432.     -fcp "crafty xboard"
  1433.     -scp "crafty xboard"
  1434.  
  1435. The xboard option puts Crafty into XBoard compatibility mode. With
  1436. WinBoard, use wcrafty instead of crafty in these commands, but do not
  1437. change xboard to winboard .
  1438.  
  1439. You can find the latest version of Crafty on Bob Hyatt's FTP server,
  1440. ftp://willis.cis.uab.edu/pub/hyatt/ . If you have trouble connecting to
  1441. this server with your Web browser, run the ftp program and connect to it
  1442. by hand.
  1443. _______________________________________________________________________
  1444.  
  1445. ** End of GNU Chess FAQ **
  1446.