This file is indexed.

/usr/share/doc/xboard/FAQ.html is in xboard 4.7.3-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

   1
   2
   3
   4
   5
   6
   7
   8
   9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76
  77
  78
  79
  80
  81
  82
  83
  84
  85
  86
  87
  88
  89
  90
  91
  92
  93
  94
  95
  96
  97
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114
 115
 116
 117
 118
 119
 120
 121
 122
 123
 124
 125
 126
 127
 128
 129
 130
 131
 132
 133
 134
 135
 136
 137
 138
 139
 140
 141
 142
 143
 144
 145
 146
 147
 148
 149
 150
 151
 152
 153
 154
 155
 156
 157
 158
 159
 160
 161
 162
 163
 164
 165
 166
 167
 168
 169
 170
 171
 172
 173
 174
 175
 176
 177
 178
 179
 180
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196
 197
 198
 199
 200
 201
 202
 203
 204
 205
 206
 207
 208
 209
 210
 211
 212
 213
 214
 215
 216
 217
 218
 219
 220
 221
 222
 223
 224
 225
 226
 227
 228
 229
 230
 231
 232
 233
 234
 235
 236
 237
 238
 239
 240
 241
 242
 243
 244
 245
 246
 247
 248
 249
 250
 251
 252
 253
 254
 255
 256
 257
 258
 259
 260
 261
 262
 263
 264
 265
 266
 267
 268
 269
 270
 271
 272
 273
 274
 275
 276
 277
 278
 279
 280
 281
 282
 283
 284
 285
 286
 287
 288
 289
 290
 291
 292
 293
 294
 295
 296
 297
 298
 299
 300
 301
 302
 303
 304
 305
 306
 307
 308
 309
 310
 311
 312
 313
 314
 315
 316
 317
 318
 319
 320
 321
 322
 323
 324
 325
 326
 327
 328
 329
 330
 331
 332
 333
 334
 335
 336
 337
 338
 339
 340
 341
 342
 343
 344
 345
 346
 347
 348
 349
 350
 351
 352
 353
 354
 355
 356
 357
 358
 359
 360
 361
 362
 363
 364
 365
 366
 367
 368
 369
 370
 371
 372
 373
 374
 375
 376
 377
 378
 379
 380
 381
 382
 383
 384
 385
 386
 387
 388
 389
 390
 391
 392
 393
 394
 395
 396
 397
 398
 399
 400
 401
 402
 403
 404
 405
 406
 407
 408
 409
 410
 411
 412
 413
 414
 415
 416
 417
 418
 419
 420
 421
 422
 423
 424
 425
 426
 427
 428
 429
 430
 431
 432
 433
 434
 435
 436
 437
 438
 439
 440
 441
 442
 443
 444
 445
 446
 447
 448
 449
 450
 451
 452
 453
 454
 455
 456
 457
 458
 459
 460
 461
 462
 463
 464
 465
 466
 467
 468
 469
 470
 471
 472
 473
 474
 475
 476
 477
 478
 479
 480
 481
 482
 483
 484
 485
 486
 487
 488
 489
 490
 491
 492
 493
 494
 495
 496
 497
 498
 499
 500
 501
 502
 503
 504
 505
 506
 507
 508
 509
 510
 511
 512
 513
 514
 515
 516
 517
 518
 519
 520
 521
 522
 523
 524
 525
 526
 527
 528
 529
 530
 531
 532
 533
 534
 535
 536
 537
 538
 539
 540
 541
 542
 543
 544
 545
 546
 547
 548
 549
 550
 551
 552
 553
 554
 555
 556
 557
 558
 559
 560
 561
 562
 563
 564
 565
 566
 567
 568
 569
 570
 571
 572
 573
 574
 575
 576
 577
 578
 579
 580
 581
 582
 583
 584
 585
 586
 587
 588
 589
 590
 591
 592
 593
 594
 595
 596
 597
 598
 599
 600
 601
 602
 603
 604
 605
 606
 607
 608
 609
 610
 611
 612
 613
 614
 615
 616
 617
 618
 619
 620
 621
 622
 623
 624
 625
 626
 627
 628
 629
 630
 631
 632
 633
 634
 635
 636
 637
 638
 639
 640
 641
 642
 643
 644
 645
 646
 647
 648
 649
 650
 651
 652
 653
 654
 655
 656
 657
 658
 659
 660
 661
 662
 663
 664
 665
 666
 667
 668
 669
 670
 671
 672
 673
 674
 675
 676
 677
 678
 679
 680
 681
 682
 683
 684
 685
 686
 687
 688
 689
 690
 691
 692
 693
 694
 695
 696
 697
 698
 699
 700
 701
 702
 703
 704
 705
 706
 707
 708
 709
 710
 711
 712
 713
 714
 715
 716
 717
 718
 719
 720
 721
 722
 723
 724
 725
 726
 727
 728
 729
 730
 731
 732
 733
 734
 735
 736
 737
 738
 739
 740
 741
 742
 743
 744
 745
 746
 747
 748
 749
 750
 751
 752
 753
 754
 755
 756
 757
 758
 759
 760
 761
 762
 763
 764
 765
 766
 767
 768
 769
 770
 771
 772
 773
 774
 775
 776
 777
 778
 779
 780
 781
 782
 783
 784
 785
 786
 787
 788
 789
 790
 791
 792
 793
 794
 795
 796
 797
 798
 799
 800
 801
 802
 803
 804
 805
 806
 807
 808
 809
 810
 811
 812
 813
 814
 815
 816
 817
 818
 819
 820
 821
 822
 823
 824
 825
 826
 827
 828
 829
 830
 831
 832
 833
 834
 835
 836
 837
 838
 839
 840
 841
 842
 843
 844
 845
 846
 847
 848
 849
 850
 851
 852
 853
 854
 855
 856
 857
 858
 859
 860
 861
 862
 863
 864
 865
 866
 867
 868
 869
 870
 871
 872
 873
 874
 875
 876
 877
 878
 879
 880
 881
 882
 883
 884
 885
 886
 887
 888
 889
 890
 891
 892
 893
 894
 895
 896
 897
 898
 899
 900
 901
 902
 903
 904
 905
 906
 907
 908
 909
 910
 911
 912
 913
 914
 915
 916
 917
 918
 919
 920
 921
 922
 923
 924
 925
 926
 927
 928
 929
 930
 931
 932
 933
 934
 935
 936
 937
 938
 939
 940
 941
 942
 943
 944
 945
 946
 947
 948
 949
 950
 951
 952
 953
 954
 955
 956
 957
 958
 959
 960
 961
 962
 963
 964
 965
 966
 967
 968
 969
 970
 971
 972
 973
 974
 975
 976
 977
 978
 979
 980
 981
 982
 983
 984
 985
 986
 987
 988
 989
 990
 991
 992
 993
 994
 995
 996
 997
 998
 999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">

<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:webmasters@gnu.org" />
<link rel="icon" type="image/png" href="/graphics/gnu-head-mini.png" />
<meta name="ICBM" content="42.256233,-71.006581" />
<meta name="DC.title" content="gnu.org" />

<title>XBoard and WinBoard: Frequently Asked Questions</title>
<style type="text/css" media="all">
@import url('/style.css');
</style>

<style type="text/css" media="print">
@import url('/print.css');
</style>

</head>

<body>
<h1>XBoard and WinBoard: Frequently Asked Questions</h1>

<p>This document answers some frequently asked questions about the
graphical chess interfaces XBoard and WinBoard.
A hyperlinked version of this FAQ is available on
the Web through the page
<a href="http://www.gnu.org/software/xboard/FAQ.html">
http://www.gnu.org/software/xboard/FAQ.html</a>.</p>

<p><i>This FAQ is in need of revision.  Please contact us if you'd like
to help update it.</i></p>

<hr />
<h2>Outline</h2>

<ul>
<li><a href="#tag-A0">[A] Introduction and hot topics</a></li>
<li><a href="#tag-B0">[B] XBoard and WinBoard</a></li>
<li><a href="#tag-C0">[C] XBoard and WinBoard, bugs and problems</a></li>
<li><a href="#tag-D0">[D] Crafty and other topics</a></li>
</ul>

<hr />
<h2>Detailed contents</h2>

<ul>
  <li><a name="tag-A0" href="#tag[A">[A] Introduction and hot topics</a>
    <ul>
      <li><a href="#tag-A.1">[A.1] What are XBoard and WinBoard?</a></li>
      <li><a href="#tag-A.2">[A.2] Where can I get chess information and chess software?</a></li> 
      <li><a href="#tag-A.3">[A.3] What are the current version numbers for XBoard and WinBoard?</a></li> 
      <li><a href="#tag-A.4">[A.4] Who is working on this project?</a></li>
      <li><a href="#tag-A.5">[A.5] How do I report bugs, offer help, etc.?</a></li>
      <li><a href="#tag-A.6">[A.6] What are the future plans for XBoard and WinBoard?</a></li>
  </ul></li> 
  
  <li><a name="tag-B0" href="#tag[B">[B] XBoard and WinBoard</a>
    <ul>
      <li><a href="#tag-B.1">[B.1] What is XBoard?</a></li>
      <li><a href="#tag-B.2">[B.2] Is there an XBoard for Microsoft Windows?  What is WinBoard?  How do I install WinBoard?</a></li>
      <li><a href="#tag-B.3">[B.3] Is there an XBoard for the Amiga?  What is AmyBoard?</a></li>
      <li><a href="#tag-B.4">[B.4] Is there an XBoard for the Macintosh?</a></li>
      <li><a href="#tag-B.5">[B.5] Does XBoard run on VMS?</a></li>
      <li><a href="#tag-B.6">[B.6] What is cmail?</a></li>
      <li><a href="#tag-B.7">[B.7] How do I build XBoard?  Do I have to have gcc?</a></li>
      <li><a href="#tag-B.8">[B.8] Can I use XBoard or WinBoard to play a game of chess with another human?</a></li>
      <li><a href="#tag-B.9">[B.9] Will WinBoard run on Windows 3.1?  How about Windows CE (also known as Pocket PC)?</a></li>
      <li><a href="#tag-B.10">[B.10] How do I use XBoard or WinBoard as an external viewer for PGN files with my Web browser?</a></li>
      <li><a href="#tag-B.11">[B.11] How do I use WinBoard as an external viewer for PGN files with the MS Windows File Manager or Explorer?</a></li>
      <li><a href="#tag-B.12">[B.12] How do I use ICC timestamp or FICS timeseal with XBoard?</a></li>
      <li><a href="#tag-B.13">[B.13] How do I use ICC timestamp or FICS timeseal with WinBoard?</a></li>
      <li><a href="#tag-B.14">[B.14] How do I play bughouse with XBoard or WinBoard?</a></li>
      <li><a href="#tag-B.16">[B.16] What is Zippy?  How can I interface a chess program to the Internet Chess Servers?</a></li> 
      <li><a href="#tag-B.17">[B.17] How can I interface my own chess program to XBoard or WinBoard?</a></li>
      <li><a href="#tag-B.18">[B.18] How can I recompile WinBoard from source?</a></li>
      <li><a href="#tag-B.19">[B.19] How can I use XBoard or WinBoard to talk to an Internet Chess Server through a firewall or proxy?</a></li>
      <li><a href="#tag-B.20">[B.20] How can I use XBoard or WinBoard on chess.net with accuclock?</a></li>
      <li><a href="#tag-B.21">[B.21] Can I get Zippy to do one or more ICS commands automatically at the start or end of each game?</a></li>
      <li><a href="#tag-B.22">[B.22] How do I print from WinBoard?</a></li>
      <li><a href="#tag-B.23">[B.23] Can I get Zippy to automatically reconnect to ICS when its connection breaks?</a></li>
      <li><a href="#tag-B.24">[B.24] The chess engines are too strong and always beat me.  How can I adjust the difficulty level to make them weaker?</a></li>
      <li><a href="#tag-B.25">[B.25] May I use the piece bitmaps from XBoard/WinBoard in my own program?</a></li>
      <li><a href="#tag-B.26">[B.26] How can I get rid of these silly logos that this new WinBoard displays above the board?</a></li>
      <li><a href="#tag-B.27">[B.27] How can I install logos for other engines, Internet Chess Servers or Human users?</a></li>
      <li><a href="#tag-B.28">[B.28] Is there readline support for XBoard?</a></li>
  </ul></li> 
  
  <li><a name="tag-C0" href="#tag-C">[C] XBoard and WinBoard, bugs and problems</a>
    <ul>
      <li><a href="#tag-C.1">[C.1] I can't build XBoard because the X11/Xaw/... include files are not found.</a></li>
      <li><a href="#tag-C.2">[C.2] Configuring or building XBoard fails due to missing header files, missing libraries, or undefined symbols.</a></li>
      <li><a href="#tag-C.3">[C.3] I have problems using WinBoard on ICS with a modem. I'm not running SLIP or PPP, but just dialing in to an ordinary login account("shell account").</a></li>
      <li><a href="#tag-C.4">[C.4] I have problems using WinBoard on ICS with Windows 95 and SLIP or PPP.  When trying to start up, it gets the error "Address family not supported by protocol family" (or some equally strange message).</a></li> 
      <li><a href="#tag-C.5">[C.5] When I try to run WinBoard, I get the message "Failed to start chess program gnuchess on localhost: NO LANGFILE (file gnuchess.lan not found)".</a></li>
      <li><a href="#tag-C.6">[C.6] I want to use XBoard or WinBoard as an Internet Chess Server interface, but the ICS Client option is grayed out on the menu.</a></li> 
      <li><a href="#tag-C.7">[C.7] How do I give command-line options to a Windows program like WinBoard?</a></li>
      <li><a href="#tag-C.9">[C.9] When I exit from WinBoard after using it to play against a chess program on my machine, the chess program keeps running in the background.</a></li>
      <li><a href="#tag-C.12">[C.12] Why do my ICS opponents often get extra time after they make their moves? Why do I sometimes lose time off my clock after I make my move?</a></li>
      <li><a href="#tag-C.13">[C.13] I can't run WinBoard unless I delete the WinBoard.ini file each time!</a></li>
      <li><a href="#tag-C.15">[C.15] I get errors compiling XBoard's parser.c.</a></li>
      <li><a href="#tag-C.16">[C.16] I get an error building WinBoard from source because "flex" is not found.</a></li>
      <li><a href="#tag-C.17">[C.17] XBoard hangs shortly after connecting to an ICS when used with dxterm, cmdtool, dtterm, kterm, konsole, or other substitutes for xterm.</a></li>
      <li><a href="#tag-C.18">[C.18] The WinBoard pieces show up in the wrong colors, appear distorted, or are not visible at all.</a></li>
      <li><a href="#tag-C.19">[C.19] XBoard or WinBoard tells me "Error: first chess program (...) exited unexpectedly".</a></li> 
      <li><a href="#tag-C.20">[C.20] XBoard tells me "Warning: Cannot allocate colormap entry", or "too few colors available; trying monochrome mode", or "XPM pieces cannot be used in monochrome mode".</a></li>
      <li><a href="#tag-C.21">[C.21] When I log in to freechess.org, the Enter key doesn't work, and I  have to use Ctrl+J instead.  But when I use WinBoard, Ctrl+J doesn't work either, so I'm stuck.</a></li>
      <li><a href="#tag-C.22">[C.22] XBoard says, "Failed to start first chess program fairymax on localhost: fairymax: No such file or directory."</a></li>
  </ul></li>
  
  <li><a name="tag-D0" href="#tag-D">[D] Crafty and other topics</a>
    <ul>
      <li><a href="#tag-D.1">[D.1] What is XChess?</a></li>
      <li><a href="#tag-D.2">[D.2] What is Winsock Chess?</a></li>
      <li><a href="#tag-D.3">[D.3] What is Crafty?</a></li>
      <li><a href="#tag-D.4">[D.4] How do I use Crafty with XBoard?</a></li>
      <li><a href="#tag-D.5">[D.5] How do I use Crafty with WinBoard?</a></li>
      <li><a href="#tag-D.6">[D.6] How do I use GNU Chess with XBoard?</a></li>
      <li><a href="#tag-D.7">[D.7] How do I use GNU Chess with WinBoard?</a></li>
      <li><a href="#tag-D.8">[D.8] What is Fairy-Max?</a></li>
      <li><a href="#tag-D.9">[D.9] What is UCI? What is Polyglot?</a></li>
      <li><a href="#tag-D.10">[D.10] How do I use an UCI engine with XBoard / WinBoard?</a></li>
  </ul></li>
</ul>

<hr />
<h2><a name="tag-A">[A] Introduction and hot topics</a></h2>

<hr />
<h3><a name="tag-A.1">[A.1] What are XBoard and WinBoard?</a></h3>

<p>XBoard and WinBoard are graphical user interfaces for chess.
  XBoard runs with the X Window System on Unix systems (including
  GNU/Linux); see topic <a href="#tag-B.1">[B.1]</a>.  WinBoard runs
  on true 32-bit Microsoft Windows operating systems, such as Windows
  95, 98, NT, 2000, ME, XP, Vista, and should continue to work on future
  32-bit Windows systems.  It does not work on Windows CE (also known
  as Pocket PC), nor does it work on 16-bit Windows systems such as
  Windows 3.1.  See topic <a href="#tag-B.2">[B.2]</a>.</p>
  
<hr />
<h3><a name="tag-A.2">[A.2] Where can I get chess information and chess 
    software?</a></h3>

<p>As a shortcut to most things mentioned in this FAQ, try Tim Mann's
  Chess Web page, <a href= "http://www.tim-mann.org/chess.html"
  >http://www.tim-mann.org/chess.html</a>.
  This page page is currently a very bad place to get the latest released 
  versions of XBoard and WinBoard and the most up-to-date version of this 
  FAQ, though.   A better place is the 
  <a href=
  "http://www.open-aurec.com/wbforum">WinBoard forum</a>.
  Also see our Savannah
  project pages at <a href="https://savannah.gnu.org/projects/xboard/"
  >https://savannah.gnu.org/projects/xboard/</a>.</p>

<p>If you have other questions about XBoard/WinBoard that aren't
  answered in this FAQ, you can try Aaron Tay's WinBoard and Chess
  Engines FAQ,
  at<a href="http://www.aarontay.per.sg/Winboard/">defunct
  URL</a>.</p>

<p>For general news and information about chess, try the 
<a href="http://www.talkchess.com/forum">CCC forum</a>
or the 
  <a href=
  "http://www.open-aurec.com/wbforum">WinBoard forum</a>.
Anothe possibility is the newsgroup hierarchy
rec.games.chess.*, especially the groups rec.games.chess.misc and
rec.games.chess.computer.  Both of the latter groups have very informative
FAQs maintained by Steve Pribut; look for them on the newsgroups or at
<a href="http://www.clark.net/pub/pribut/chess.html">defunct URL</a>.</p>

<p>Like other GNU software, you can get XBoard, and WinBoard by anonymous FTP from 
<a href="ftp://ftp.gnu.org/pub/gnu/">ftp://ftp.gnu.org/pub/gnu/</a>
and its many mirror sites.  Look in the subdirectories xboard, and winboard.
The .tar.gz suffix on the files there indicates they were packed with tar
and compressed with gzip.  The .exe or .zip suffixes indicate files that
were packed and compressed with zip.</p>

<p>For other chess software, try the Internet Chess Library.  Use
anonymous FTP to connect to ftp.freechess.org, or go to the Web page
<a href="http://www.freechess.org/">http://www.freechess.org/</a>.
You can get chess software, game
collections, the FAQ file for rec.games.chess, and other chess-related
material there, in the directory pub/chess.  The FTP server can
automatically decompress files for you as you download them, useful if you
don't have gzip.</p>

<p>Here is a sample anonymous ftp session.  Some of the ftp server's responses
are abbreviated, but all the commands you must type are included.</p>

<pre>
    % ftp ftp.gnu.org
    Connected to ftp.gnu.org
    Name: anonymous
    Password: your-email-address@your-site
    ftp&gt; binary
    200 Type set to I.
    ftp&gt; cd /pub/gnu/xboard
    ftp&gt; dir
    -rw-r--r-- 1 14910 wheel  1057625 May 20 00:25 xboard-4.2.7.tar.gz
    ftp&gt; get xboard-4.2.7.tar.gz
    150 BINARY connection for xboard-4.2.7.tar.gz (1057625 bytes).
    226 Transfer complete.
    ftp&gt; quit
</pre>

<hr />
<h3><a name="tag-A.3">[A.3] What are the current version numbers for 
XBoard and WinBoard?</a></h3>

<p>At this writing, the current version numbers are:</p>

<ul>
<li>XBoard 4.4.0</li>
<li>WinBoard 4.4.0</li>
</ul>

<hr />
<h3><a name="tag-A.4">[A.4] Who is working on this project?</a></h3>

Please see our Savannah project pages
at <a href="https://savannah.gnu.org/projects/xboard/">https://savannah.gnu.org/projects/xboard/</a>
for a list of active developers.  Many others occasionally contribute
suggestions and snippets of code, for which we are grateful.

<hr />
<h3><a name="tag-A.5">[A.5] How do I report bugs, offer help, etc.?</a></h3>

<p>Bug reports, suggestions, and offers to help on XBoard
or WinBoard should be sent to bug-xboard<a name="nospam01">&#x40;</a>gnu.org.</p>

<p>Beginner questions and discussion about the program may get faster
answers on the WinBoard Forum at <a
href="http://www.open-aurec.com/wbforum/"
>http://www.open-aurec.com/wbforum/</a>.
This forum also constains a section dedicated to propose and discuss
new features for WinBoard / XBoard or WinBoard protocol,
and reposrt bugs,
and offers downloads of pre-installed packages of WinBoard
bundled with other software,
useful for conducting computer-computer tournaments.</p>

<p>If you are developing a
chess engine that works with XBoard or WinBoard (or an alternative
GUI that works with such engines), see the Chess Engines mailing
list, hosted at
<a href="http://groups.yahoo.com/group/chess-engines"
>http://groups.yahoo.com/group/chess-engines</a>.
For better response, join the above-mentioned WinBoard forum,
or the <a href="http://www.talkchess.com/forum">CCC forum</a>.</p>


<p>Any time you want to report a possible bug in XBoard or WinBoard,
we need to know exactly what you did, and exactly what error (or
other) messages you got.</p>

<p>If you are using Unix, run the "script" program, run XBoard with
the -debug flag (if you get as far as running it), do whatever is
necessary to reproduce the problem, type "exit" to the shell, and mail
us the resulting typescript file.  We also need to know what
hardware/operating system combination you are using.  The command
"uname -a" will usually tell you this; include its output in your
typescript.</p>

<p>If you are using MS Windows, run WinBoard with the -debug flag, and
send us a copy of the WinBoard.debug file.  If you aren't sure how to
add command-line flags to WinBoard, you can hit Ctrl+Alt+F12 to create
a WinBoard.debug file after WinBoard starts, but that is not as good,
because a few messages that would have been printed at the start are
lost.</p>

<p>Either way, please send us the exact text of the commands you typed
and the output you got, not just your recollection of approximately
what they were.  The messages may seem meaningless to you, but they
are very meaningful to us and essential for diagnosing problems.</p>

<hr />
<h3><a name="tag-A.6">[A.6] What are the future plans for XBoard and
  WinBoard?</a></h3>

<p>Our plans are always in flux.  As with most free software projects,
the next release will happen when it happens -- or it may never
happen.  This has always been the policy for XBoard/WinBoard.
Releases have never been promised in specific time frames.</p>

<p>Starting in November 2003, several new developers have joined the
project, and work is now hosted at <a
href="https://savannah.gnu.org/projects/xboard/"
>https://savannah.gnu.org/projects/xboard/</a>.  Lots of work is just
getting underway, but nothing is far along yet.</p>

<p>Here is a partial list of items that have a nonzero probability of
happening in finite time.</p>

<ul>
<li>Small bug fixes.  Occasionally someone sends us a fix, or reports
a small bug very clearly so that we're able to fix it in a few minutes
work.</li>

<li>Protocol version 3.  The members of the chess engine authors'
mailing list discussed a set of proposed features for the next version
of the XBoard/WinBoard chess engine communication protocol.
The WinBoard 4.3 fork has taken the protocol in a different direction,
though, extending version 2 with new features as they were needed,
rather than upgrading to a new protocol in a single sweep.
It does not seem likely that there will be a v3 protocol in the
foreseeable future.
</li>

<li>Contributed features.  Several people have mailed me code to add
various features.  Most of this code is available on the
XBoard/WinBoard extensions page
at <a href="http://www.tim-mann.org/extensions.html">
http://www.tim-mann.org/extensions.html</a>,
but it is not in any official releases yet.  We are in the process of
getting folks to formally assign the copyrights on their contributions
to the Free Software Foundation so that we can include it in official
releases in the future.</li>

<li>Internationalization.  Several people have expressed interest in
internationalizing XBoard/WinBoard. Version 4.4 implements
internationalization in its XBoard branch, and includes (partial)
Turkish and German translations.  For WinBoard a suitable way for
internationalization still has to be found, as all menu strings there
are not in the C code, but in a Windows resource file. In any case, we
will need more translators, to update the existing translations (for
version 4.2.7) to the current version, and to provide translaions for
oter languages.  Watch for news on the xboard-devel mailing list on
our Savannah pages.</li>

</ul>

<hr />
<H2><a name="tag-B">[B] XBoard and WinBoard</a></H2>
<hr />
<h3><a name="tag-B.1">[B.1] What is XBoard?</a></h3>

<p>XBoard is a graphical user interface for chess.  It displays a
chessboard on the screen, accepts moves made with the mouse, and loads
and saves games in Portable Game Notation (PGN).  XBoard is free software.
It serves as a front-end for many different chess services, including:</p>

<p><strong>Chess engines</strong> that will run on your machine and
play a game against you or help you analyze, such as GNU Chess and
Crafty (topic <a href="#tag-D.3">[D.3]</a> below).</p>

<p><strong>Chess servers</strong> on the Internet, where you can
connect to play chess with people from all over the world, watch other
users play, or just hang out and chat.</p>

<p><strong>Correspondence chess</strong> played by electronic
mail. The cmail program (topic <a href="#tag-B.6">[B.6]</a> below)
automates the tasks of parsing email from your opponent, playing his
moves out on your board, and mailing your reply move after you've
chosen it.</p>

<p><strong>The Web</strong> and your own saved games. You can use
XBoard as a helper application to view PGN games in your
Web browser, or to load and save your own PGN files.</p>

<p>XBoard runs under Unix or Unix-compatible systems.  It requires the
X Window System, version X11R4 or later.  There are also ports of
XBoard to 32-bit Microsoft Windows and to
the Amiga.  See topics <a href="#tag-B.2">[B.2]</a> and <a
HREF="#tag-B.3">[B.3]</a> respectively.</p>

<hr />
<h3><a name="tag-B.2">[B.2] Is there an XBoard for Microsoft Windows?  What is WinBoard?  How do I install WinBoard?</a></h3>

<p>WinBoard is a port of XBoard to 32-bit Microsoft Windows systems, such
as Windows 95, 98, NT, 2000, ME, and XP.  It uses the same back end
chess code as XBoard, but the front end graphics code is a complete
rewrite.  WinBoard is free software.</p>

<p>The WinBoard distribution includes a sample Chess engine.</p>

<p>The WinBoard distribution also includes the ICC timestamp and FICS
timeseal programs (topic <a href="#tag-B.12">[B.12]</a>).</p>

<p>cmail (topic <a href="#tag-B.6">[B.6]</a>) has not been ported to
Windows.  All the other XBoard functions are included in WinBoard.
The International Email Chess Group web site at <a
href="http://www.iecg.org/" >http://www.iecg.org/</a> recommends
ECTool (<a href="http://www.ectool.nu/" >http://www.ectool.nu/</a>)
for playing correspondence chess under Windows.</p>

<p>You install WinBoard as follows. Download the WinBoard package to
your PC (see topic <a href="#tag-A.2">[A.2]</a>).  It will be a file
with a name like winboard-4_0_0.exe.  Double-click on this file
in the Explorer or File Manager to run it. Follow the on-screen
prompts.</p>

<hr />
<h3><a name="tag-B.3">[B.3] Is there an XBoard for the Amiga?  What is AmyBoard?</a></h3>

<p>AmyBoard is a port of XBoard to the Amiga, by Jochen Wiedmann.
The distribution includes a port of GNU Chess.
AmyBoard is free software.</p>

<p>The current version of AmyBoard is 330.5 (based on XBoard 3.3.0).
No one is currently maintaining it.</p>

<p>System requirements:</p>

<ul>
<li>An Amiga (obviously :-), running OS 2.04 or later, 2Mb RAM or more.</li>
<li>MUI 2.0 or later.</li>
<li>Workbench or another screen with no less than 640x400 pixels (adjustable
  with the MUI-Prefs); this restriction is just because we don't have
  bitmaps with less than 40x40 pixels per square. If someone contributes
  bitmaps with 20x20 or 20x25, they will work with any Hires mode.</li>
</ul>

<p>If you would like to use an ICS, you need an Internet connection via either</p>

<ul>
<li>a telnet-like program, or</li>
<li>a terminal program reading from stdin and writing to stdout.</li>
</ul>

<p>AmyBoard is available in the Internet Chess Library (topic <a href="#tag-A.2">[A.2]</a>).</p>

<hr />
<h3><a name="tag-B.4">[B.4] Is there an XBoard for the Macintosh?</a></h3>

<p>Note: I am not a Mac user and have not tried this myself, so I cannot 
answer questions about it. </p>
 
<p>Because MacOS X has a Unix base, XBoard will compile and run on it. 
You do need an X11 (X Window System) server and client libraries. I'm 
told that these come standard with MacOS X 10.3 and later. Once you 
install the X11 package, XBoard is reported to compile and run without 
changes.</p>
 
<p>You can avoid having to compile XBoard (and GNU Chess) yourself by 
using the Fink sofware packaging system. See 
http://fink.sourceforge.net/ and 
http://finkcommander.sourceforge.net/ for more info on Fink.</p>
 
<p>There is no version of XBoard or WinBoard that runs with the native
(non-X11) Mac graphical interface, and none that runs on MacOS 9 or
earlier.</p>


<hr />
<h3><a name="tag-B.5">[B.5] Does XBoard run on VMS?</a></h3>

<p>No.  This port would probably be a lot easier than the Win32 and Amiga
ports were, because VMS has the X Window system (under the name
DECwindows) and is now POSIX compliant. If you are working on this, 
send mail to bug-xboard<a name="nospam02">&#x40;</a>gnu.org to let us know.</p>


<hr />
<h3><a name="tag-B.6">[B.6] What is cmail?</a></h3>

<p>cmail is a program that helps you play and keep track of electronic mail
correspondence chess games using XBoard.  It is distributed with XBoard and
has its own manual page.  cmail is free software.  It was written by
Even Welsh.  cmail has not been ported to Windows; sorry.</p>

<hr />
<h3><a name="tag-B.7">[B.7] How do I build XBoard?  Do I need gcc?</a></h3>

<p>The first step to building XBoard is to get the distribution file.  See topic
<a href="#tag-A.2">[A.2]</a> for places you can ftp the software from.</p>

<p>Next, decide what directory tree you are going to install XBoard
in.  The default is /usr/local, but you probably don't have write
access to that directory unless you are a system administrator.  If
you do, type the following to install it there:</p>

<pre>
    gzip -cd xboard-*.tar.gz | tar -xvf -
    cd xboard-*/
    ./configure
    make
    su
    make install
</pre>

<p>If you want to install xboard in your personal home directory ($HOME/bin),
type this:</p>

<pre>
    gzip -cd xboard-*.tar.gz | tar -xvf -
    cd xboard-*/
    ./configure --prefix=$HOME
    make
    make install
</pre>

<p>If the first step above fails because you don't have gzip, see
topic <a href="#tag-A.2">[A.2]</a>, and ask a local Unix expert if you
need more help.  If you have any problems with the last two steps,
read the READ_ME and INSTALL files in the xboard-*/ directory.  You
will also find this FAQ there.</p>

<p>You don't need to have gcc to build XBoard.  Almost any Unix C
compiler should do.</p>

<hr />
<h3><a name="tag-B.8">[B.8] Can I use XBoard or WinBoard to play a game
  of chess with another human?</a></h3>

<p>The only way for two humans on different machines to play chess in
real time using XBoard/WinBoard is to use an Internet Chess Server
as an intermediary.  That is, each player runs his own copy of XBoard
or WinBoard, both of them log into an ICS, and they play a game there.
Two copies of XBoard/WinBoard cannot communicate with each other
directly.</p>

<p>Instructions on how to get started with Internet chess are included
with the XBoard and WinBoard distributions.  The network addresses
included in the distribution may not always be current.  The oldest
and largest ICS is the Internet Chess Club at chessclub.com, which now
has a fee for registered use, but still allows free unregistered use.
There are also many newer sites with no fees, using the Free Internet
Chess Server implementation (FICS).  The most active FICS site is
freechess.org.  On these and most other chess servers,
the port number to use is 5000.</p>

<p>If you don't have network connectivity to any ICS site, you
can run your own server using a version of the FICS code, but this
is not easy.  See <a href="http://www.tim-mann.org/ics.html#ownics"
>http://www.tim-mann.org/ics.html#ownics</a> for advice and pointers.</p>

<p>The cmail program included with XBoard lets you play email postal games with
another human; see topic <a href="#tag-B.6">[B.6]</a>.</p>

<p>Two humans can play chess on the same machine using one copy of
XBoard/WinBoard in
Edit Game mode, but the clocks don't run in this mode, so it's of limited
usefulness.</p>

<p>See also topic <a href="#tag-D.2">[D.2]</a>, Winsock Chess.</p>

<hr />
<h3><a name="tag-B.9">[B.9] Will WinBoard run on Windows 3.1?
  How about Windows CE (also known as Pocket PC)?
</a></h3>

<p>WinBoard does not run on Windows 3.1, Windows for Workgroups 3.11, etc.,
not even with the Win32s compatibility package.  The main problem is
that Win32s does not have threads or real concurrent processes.  A
port of WinBoard to Windows 3.1 is possible in theory, but it would be
difficult and messy, and no one is going to do it.</p>

<p>WinBoard does not run on Windows CE (also
known as Pocket PC).  I don't know what would be required to port it.</p>

<p>WinBoard does run well on full 32-bit versions of Windows, such as
Windows 95, 98, NT, 2000, ME, XP, and Vista, and should continue to work
on future 32-bit Windows systems.
To use the help files in Vista, you will need to install the WinHlp32.exe
from MicroSoft on your Vista system.
</p>

<hr />
<h3><a name="tag-B.10">[B.10] How do I use XBoard or WinBoard as an external viewer for PGN files
  with my Web browser?</a></h3>

<ol>
<li> On Unix systems:
<ul>
<li> Add the following line to the file .mime.types in your home directory.
(Create the file if it doesn't exist already.)
<pre>
    application/x-chess-pgn    pgn
</pre>
</li>
<li>
Add the following line to the file .mailcap in your home directory.
(Create the file if it doesn't exist already.)
<pre>
    application/x-chess-pgn; xboard -ncp -lgf %s
</pre>
</li>
<li>
 Exit from your Web browser and restart it.
</li>
</ul>
</li>
<li> On MS Windows systems:
<p>The exact procedure depends on which Web browser you are using.
The current version of WinBoard automatically configures itself as
your PGN viewer for local files, Netscape 4.x and later, and Internet
Explorer.  This automatic setup probably works for all other current Web
browsers, too.</p>
</li>
</ol>

<hr />
<h3><a name="tag-B.11">[B.11] How do I use WinBoard as an external viewer
  for PGN files with the MS Windows File Manager or Explorer?</a></h3>

<p>WinBoard sets this up automatically when you install it, except on old
versions of Windows NT (prior to 4.0).  On Windows NT 3.51 or earlier,
go to the File Manager, click on the File menu, select Associate,
enter "pgn" as the extension, and use the Browse button to find your
copy of WinBoard and set up the association.</p>

<hr />
<h3><a name="tag-B.12">[B.12] How do I use ICC timestamp or FICS timeseal
with XBoard?</a></h3>

<p>First, get the appropriate version of timestamp or timeseal for your
machine from ftp.chessclub.com or ftp.freechess.org.
Second, be sure that you can connect using XBoard <I>without</I>
timestamp/timeseal.  Third, be sure that you can connect using
timestamp/timeseal without XBoard.  See the help files on ICC and FICS
or ask people online if you have problems.</p>

<p>If you are in a completely ordinary situation, where your machine
is directly on the Internet and you can connect to ICC or FICS 
without timestamp/timeseal using
just the command "xboard -ics" or "xboard -ics -icshost freechess.org",
change that command to one of the following:</p>

<pre>
    xboard -ics -icshost chessclub.com -icshelper timestamp

    xboard -ics -icshost freechess.org -icshelper timeseal
</pre>

<p>If you have a firewall between your machine and the ICS, see topic
<a href="#tag-B.19">[B.19]</a>.</p>

<p>If you normally have to use the "/icscomm" command line option on
xboard to log into a second machine, and then telnet to ICC or FICS
from there, you are going to have to run the Unix version of timestamp
or timeseal on the second machine.  (If the second machine is not
running Unix, you are out of luck.)  Get the appropriate version of
timestamp or timeseal onto the shell machine via FTP; see the help
files on ICC and FICS for instructions.  Then simply run it when you
would normally run telnet.  In this configuration you are not
protected against lag between your PC and the shell machine, or for
lag caused by heavy load on the shell machine itself from other users.</p>

<p>For further information on timestamp and timeseal, see the help
files on ICC and FICS.</p>

<hr />
<h3><a name="tag-B.13">[B.13] How do I use ICC timestamp or FICS timeseal
with WinBoard?</a></h3>

<p>If you select an ICS from either the WinBoard Startup dialog or the
Windows Start submenu that WinBoard installs, WinBoard automatically
runs timestamp or timeseal if the ICS you chose is known to support it.</p>

<p>If you are constructing a WinBoard command line by hand, add the
option "/icshelper timestamp" or "/icshelper timeseal" to the WinBoard
command line to use timestamp or timeseal.  Both timestamp.exe and
timeseal.exe are included in the WinBoard distribution.  They both
function identically to the Unix versions, as documented in "help
timestamp" on ICC and "help timeseal" on FICS.</p>

<p>If you have a firewall between your machine and the ICS, see topic
<a href="#tag-B.19">[B.19]</a>.</p>

<p>If you normally have to use the "/icscomm" command line option on
WinBoard to log into a shell account, and then telnet to ICC or FICS
from there, you are going to have to run the Unix version of timestamp
or timeseal on the shell machine.  (If the shell account is not on a
Unix machine, you are out of luck.)  Get the appropriate version of
timestamp or timeseal onto the shell machine via FTP; see the help
files on ICC and FICS for instructions.  Then simply run it when you
would normally run telnet.  In this configuration you are not protected
against lag between your PC and the shell machine, or for lag caused by
heavy load on the shell machine itself from other users.</p>

<p>For further information on timestamp and timeseal, see the help
files on ICC and FICS.</p>

<hr />
<h3><a name="tag-B.14">[B.14] How do I play bughouse with XBoard or WinBoard?
</a></h3>

<p>XBoard and WinBoard have full bughouse support.
Offboard piece holdings are shown next to the board, and
you drop offboard pieces by dragging them with the mouse 
(holding the left button down) to their drop square,
or left-click the piece and the drop square, just like when you enter
any ordinary move.</p>

<p>XBoard and WinBoard can display only one board at a time, but you
can observe your partner's game by running a second copy of the
program and logging in as a guest.  (Unfortunately, this is not
possible if you are using the /icscomm option.)  To observe your
partner's games automatically, use the "follow" or "pfollow" ICS
command; see the ICS online help for details.</p>

<hr />
<h3><a name="tag-B.16">[B.16] What is Zippy?  How can I interface a 
chess program to the Internet Chess Servers?</a></h3>

<p>Zippy is an interface that lets a compatible chess engine (such as GNU
Chess or Crafty) act as a computer
player on an Internet Chess Server.  Zippy is included in both the
XBoard and WinBoard distributions.  It is implemented as a small
amount of additional code within XBoard or WinBoard.  
For documentation, see the file
zippy.README, included in both distributions or available
from my chess Web page,
<a href=
"http://www.tim-mann.org/chess.html"
>http://www.tim-mann/chess.html</a>.
The version of zippy.README on my Web page is often more up-to-date
than those in the XBoard/WinBoard distributions.
You'll also find a "biography" of Zippy and pointers to the original
Zippy the Pinhead comic strips on my Web page.
Please read zippy.README carefully before you ask me any questions about Zippy.</p>

<p>Using a computer to choose your moves on a chess server is
considered cheating unless your account is on the computer (C) list.
Read "help computer" on your favorite server for details on their
policy.  Most of the servers have plenty of computers running now, so they
will not be excited about having you run a new one unless you have
written your own chess engine.  They don't really need yet another 
Crafty or GNU Chess clone.</p>

<hr />
<h3><a name="tag-B.17">[B.17] How can I interface my own chess program
to XBoard or WinBoard?</a></h3>

<p>This is a non-trivial task.  XBoard and WinBoard were not designed
with a clean interface for talking to chess programs; they were
written to work with an existing version of GNU Chess that expects to
be talking to a person.  Your program has to emulate GNU Chess's
rather idiosyncratic command structure to work with XBoard and
WinBoard.  We are gradually cleaning up, improving, and documenting
the interface as newer versions of XBoard and WinBoard come out,
however.</p>

<p>For documentation, see the file engine-intf.html, included in both
distributions or available from Tim Mann's chess Web page, <a href=
"http://www.tim-mann.org/chess.html"
>http://www.tim-mann.org/chess.html</a>.
The version of engine-intf.html on Tim's Web page might totally obsolete,
though.
To know how the current WinBoard or XBoard version communicate with their
engines, use the documentation in the XBoard/WinBoard distributions,
or on the <a href=
"http://www.open-aurec.com/wbforum/WinBoard/engine-intf.html"
>WinBoard forum</a>.</p>

<hr />
<h3><a name="tag-B.18">[B.18] How can I recompile WinBoard from source?</a></h3>

<p>The source code for WinBoard is available from the author's Web page,
<a href=
"http://www.tim-mann.org/chess.html"
>http://www.tim-mann.org/chess.html</a>.</p>

<p>WinBoard is currently developed using gcc under Cygwin.
To build WinBoard with the free Cygwin tools, available from <a
href= "http://www.cygwin.com/" >http://www.cygwin.com/</a>), use the
command "make -f makefile.gcc" from the winboard directory of the
source distribution.</p>
<p>You can build the program from the MSVC++ GUI by opening the project
file (winboard.dsp) and telling MSVC++ to build the project.  You can
also build it from the the command line by using the nmake program
supplied with MSVC++.
The makefile for MSVC is makefile.ms in the winboard directory.</p>

<p>WinBoard 4.2.5 was successfully
compiled with the net release of Cygwin as downloaded on 20-March-2001
(cygwin1.dll 1.1.8, gcc 2.95.2-6, binutils 20001221-1, flex 2.5.4-1),
but exhibits a command-line parsing bug; see item 511 in the ToDo file
that comes with WinBoard.  WinBoard 4.1.0 does not compile with
Cygwin.  WinBoard 4.0.7 is known to compile with Cygwin BL20.1.</p>

<p>To build WinBoard with Borland C++ 4.5, use "borland.mak", supplied
with the WinBoard sources, as the Makefile.  Support for Borland C++
was contributed by Don Fong and has not been tested by the author of WinBoard.</p>

<p>WinBoard is a Win32 application, so you definitely need a compiler
and tool set that supports Win32.  In particular, older versions of
DJGPP can build only 32-bit MSDOS programs; that is, programs that use
a DOS extender to get a 32-bit address space and do not make any
Windows calls.  The latest versions of DJGPP are said to be able to 
build Win32 programs when used with the proper extension package(s),
but this is not known to work with WinBoard.  Use Cygwin instead.</p>

<p>See also topic <a href="#tag-C.16">[C.16]</a>.</p>

<hr />
<h3><a name="tag-B.19">[B.19] 
How can I use XBoard or WinBoard to talk
to an Internet Chess Server through a firewall or proxy?
</a></h3>

<p>There is no single answer to this question, because there are many
different kinds of firewalls in use.  They work in various different
ways and have various different security policies.  This answer can
only provide hints.</p>

<p>Note that you can't access Internet Chess Servers through a Web proxy,
because they are not a Web service.  You talk to them through a raw
TCP connection, not an HTTP connection.  If you can only access the
Web through a proxy, there may be a firewall that stops you from
making direct TCP connections, but there may also be a way through it.
Read on for hints, and contact your local system administrator if you
need more information about your local configuration.</p>

<p>A helpful user mailed me the following explanation of how to use
WinBoard with WinGate:</p>
<blockquote>
"I have managed to setup WinBoard though my WinGate proxy.  I have the
Office version.  What I needed to do was to setup the TCP/IP
connection to add the User/Host name and my provider service name for
the DNS, but I had to leave the HOST IP address blank.  I have not
played with all the variations, so it may be just that I have the DNS
lookup enabled."
</blockquote>
<p>I hope this helps, though I don't find it very clear.  I don't have
a copy of WinGate myself and can't help if you have questions about it.</p>

<p>If you are using some other non-SOCKS firewall, read the FIREWALLS section
in your XBoard or WinBoard documentation (man page, info document, or
Help file).  If you can telnet to a chess server in some way, then you
can almost certainly connect to it with xboard/WinBoard, though in
some cases you may not be able to run timestamp or timeseal.  The
timestamp and timeseal protocols require a clean, 8-bit wide TCP
connection from your machine to the ICS, which some firewalls do not
provide.</p>

<p>If you have a SOCKS firewall and are using <strong>XBoard</strong>,
you should be able to SOCKSify xboard and use it.  See <a
href="http://www.socks.nec.com/">http://www.socks.nec.com/</a> for
information about SOCKS and socksification.  However, if you do this,
you can't use timestamp or timeseal; what you really need is a
socksified version of timestamp or timeseal.  This is hard because the
source code for timestamp and timeseal is proprietary; the folks
running the chess servers don't give it out because that would make it
too easy to cheat.  On some versions of Unix, you may be able to
socksify a program that you don't have the source code to by running
it with an appropriate dynamic library; see <a
href="http://www.socks.nec.com/">http://www.socks.nec.com/</a>.  For
others, you might be able to get a pre-built socksified version from
the chess server administrators.  For timeseal versions, see <a
href="ftp://ftp.freechess.org/pub/chess/timeseal/"
>ftp://ftp.freechess.org/pub/chess/timeseal/</a>.  For timestamp
versions, the directory would be <a
href="ftp://ftp.chessclub.com/pub/icc/timestamp/"
>ftp://ftp.chessclub.com/pub/icc/timestamp/</a>, but at this writing
there don't seem to be any socksified timestamps there.  Once you have
a socksified timestamp or timeseal, simply run it with a normal,
non-socksified xboard in place of the standard timestamp or timeseal.</p>

<p>If you have a SOCKS firewall and you are using
<strong>WinBoard</strong>, we now know how to make this configuration
work, complete with timestamp or timeseal!</p>

<p>Start by getting SocksCap32.  This software is freely available
from <a href="http://www.socks.nec.com/">http://www.socks.nec.com/</a>.
Install it on your machine, read the documentation, and learn to use
it.  You may find it useful with many other programs besides WinBoard.</p>

<p>Next, <strong>don't</strong> socksify WinBoard.  Socksifying
WinBoard itself doesn't let you use it with timestamp or timeseal.
For some reason I don't understand -- something strange that
SocksCap32 does -- the socksified WinBoard runs but does nothing, and
timestamp/timeseal runs all by itself in its own window.</p>

<p>Instead, use the following workaround.  Follow the instructions
exactly; don't try to skip steps or simplify things.</p>

<p>First, make SocksCap32 application profiles for timestamp and
timeseal.  Use the following command lines in the SocksCap32
profiles. Name the first profile "timestamp" and the second
"timeseal".</p>

<pre>
    "c:\program files\winboard\timestamp.exe" chessclub.com 5000 -p 5000
    "c:\program files\winboard\timeseal.exe" freechess.org 5000 -p 5000
</pre>

<p>Second, run timestamp or timeseal by itself, socksified, using its
profile.  This will open an unneeded, black window that will not
respond to typing.  Minimize it to the task bar and ignore it. It will
go away when you exit from WinBoard.</p>
  
<p>Next, run WinBoard using the following command line.  Make a shortcut
or type this command into an MS-DOS Prompt box.  Don't run WinBoard
itself socksified, just run it directly.</p>

<pre>
    "c:\program files\winboard.exe" /ics /icshost=localhost /icsport=5000
</pre>

<p>After you get this working, you can try getting the timestamp window to
auto-minimize by starting it from a shortcut instead of from the
SocksCap32 control window. As it says in the SocksCap32 help file, put
the following in the Target field of a shortcut's Properties page:</p>

<pre>
    "c:\program files\sockscap32\sc32.exe" timestamp
</pre>

<p>Then select "Run: Minimized" on the same page.  Do the same for timeseal.</p>

<p>Another method that can work is to use a .bat file to start both
timestamp and WinBoard.  It would look something like this:</p>

<pre>
    REM --
    REM -- icc.bat
    REM -- Start timestamp under SocksCap32 and use WinBoard to connect to it.
    REM -- The string "timestamp" refers to a SocksCap32 profile for timestamp.
    REM --  Do not change it to the filename of the timestamp program!
    REM --
    start /minimized "c:\program files\sockscap32\sc32.exe" timestamp
    cd "c:\program files\winboard"
    winboard /ics /icshost=localhost /icsport=5000
</pre>

<p>This workaround has a problem if you want to run two copies of
WinBoard at once, talking to the same chess server twice (for
bughouse) or to two different chess servers. If you need to do that,
you will need to run a separate copy of timestamp with <i>a different
port number</i> for each connection.  You'll need to make a second set of
profile entries with a different value after the -p flag (say, 5001)
and you'll need to change the WinBoard command line /icsport=5000 for
the second WinBoard to match.</p>

<hr />
<h3><a name="tag-B.20">[B.20] 
How can I use XBoard or WinBoard on chess.net with accuclock?
</a></h3>

<p>I believe chess.net provides a Win32 command-line version of
accuclock that will work with WinBoard.  Please see the documentation
on the chess.net server itself; don't ask the author of WinBoard.</p>

<p>I don't know whether chess.net provides versions of accuclock for
Unix at this time.  Ask them.</p>

<hr />
<h3><a name="tag-B.21">[B.21]
  Can I get Zippy to do one or more ICS commands automatically at the 
  start or end of each game?</a></h3>

<p>By default, Zippy automatically sends the command "gameend" to ICS
at the end of each game.  You can alias this command (using the ICS
"alias" feature) to anything you want.  On ICC, you can use the
"multi" feature to alias gameend to several commands, but other
servers don't have that feature.  Zippy doesn't send anything at the
start of the game by default.</p>

<p>You can get Zippy to send one or more commands of your choosing, at
the start and/or end of each game, by using the -zippyGameStart and
-zippyGameEnd command line options, newly added in version 4.0.3.
Both xboard and WinBoard have (somewhat obscure) ways of getting
newlines into this option to send several commands.  Here is an
example of one way to do it for each.</p>

<pre>
    xboard -ics -zp -xrm '*zippyGameStart: say hi\nsay prepare to die\n'

    WinBoard /ics /zp /zippyGameEnd='say thanks\nseek 5 0\nseek 2 12\n'
</pre>

<hr />
<h3><a name="tag-B.22">[B.22]
  How do I print from WinBoard?
</a></h3>

<p>WinBoard does not have built-in printing functionality.
If you want to print a picture of the board, press Alt+PrintScrn, run the
standard Windows application Paintbrush, select Paste, and print from there.
If you want to print a list of moves, save your game as a PGN file,
then open the PGN file with Notepad or any other plain text editor and
print it from there.</p>

<p>WinBoard 4.4 has a menu item "Save Diagram..." in the file menu,
which saves the board part of the display as a Windows .bmp file,
but only if the board size is not too big.</p>

<hr />
<h3><a name="tag-B.23">[B.23]
  Can I get Zippy to automatically reconnect to ICS when its connection 
  breaks?</a></h3>

<p>There isn't a perfect solution to this problem yet, but a pretty
good one is to write a shell script (for xboard) or .bat script (for
WinBoard) that automatically restarts the program whenever it exits.
Use the -xexit flag so that you don't get a popup dialog that must be
dismissed with the OK button before the program will exit.  The gap in
this solution is that your connection to ICS can sometimes get into a
state where the program does not notice that the connection is broken
until the next time it tries to send a command.  Perhaps some future
version of xboard/WinBoard will have an option to send a harmless
command every five minutes or so.</p>

<p>Anyway, here is a sample Windows .bat file that restarts WinBoard each
time it exits.  Thanks to Jason Williamson.  It assumes that you have put
your computer account's name and password in a file named logon.ini.</p>

<pre>
REM --
REM -- wbrecon.bat
REM -- Start WinBoard in Zippy mode, and restart it each time it exits.
REM -- Add or change parameters as needed for your application.
REM --
:loop
start /w winboard /zp /ics /icslogon logon.ini /xexit /xautoraise
REM -- The next line is to have a short delay setup for 139 seconds.
REM -- Leave it out if it doesn't work on the version of Windows you use.
TYPE NUL | CHOICE.COM /N /CY /TY,99 &gt;NUL
goto loop
</pre>

<p>Here is a Unix shell script to do the same thing for xboard.
It's a bit more elaborate.  It is based on the script I use for the
original Zippy.  It logs all ICS output to a file named zippy.out,
and it lets you type commands to Zippy by running "cat &gt; zippy.fifo".</p>

<pre>
#! /bin/sh
host="204.178.125.65 -icsport 5000 -telnet -telnetProgram timestamp"
#host="164.58.253.13 -icsport 5000 -telnet -telnetProgram timeseal"
out=zippy.out
fifo=zippy.fifo
ZIPPYPASSWORD='something'
export ZIPPYPASSWORD
ZIPPYPASSWORD2='orother'
export ZIPPYPASSWORD2
ZIPPYLINES=`pwd`/all.lines
export ZIPPYLINES
ZIPPYGAMEEND='say Yow, that was FUN!
gameend'
export ZIPPYGAMEEND
zippylogon=`pwd`/logon.ini
DISPLAY=`hostname`:0.0
export DISPLAY
mv -f $out ${out}.old
rm -f $fifo
mkfifo $fifo
pid=$$
( while [ true ] ; do cat -u $fifo ; done ) | \
      ( while [ true ] ; do
          xboard -iconic -ics -icshost $host \
                 -zt -zp -xbell -xanimate \
                 -xautosave -xquiet -fcp "gnuchessx -h" \
                 -icslogon $zippylogon -xexit -autoflag -xautoraise $*
          sleep 600
        done ) &gt; $out 2&gt;&amp;1 &amp;
</pre>

<hr />
<h3><a name="tag-B.24">[B.24]
  The chess engines are too strong and always beat me.  How can I adjust
  the difficulty level to make them weaker?</a></h3>

<p>The best way is to get a weaker chess engine.
On the <a href="http://www.open-aurec.com/chesswar">ChessWar</a> website
you will find a rating list of virtually all engines that are able to
play under XBoard/WinBoard, from super-humanly strong to ridculously weak.
Most of them can be downloaded for free from the internet.</p>

<p>A way to get that effect is to limit the time the engine can use for
deciding on its move. The time-odds options or menu items in the 
time-control dialog) can be used to this end. This is only of limited 
help, as engines do not weeken that much at faster time-control,
and there is a practical limit to how fast you can order the engine
to go. Also feel free to use Retract Move if
you make a blunder. </p>

<p>Many chess coaches will let you switch sides after
they get a stronger position so that you can get experience playing
positions where you are winning.  You can try this with XBoard/WinBoard
by using the Machine White or Machine Black menu command to make the
machine take over your position.</p>

<p>The -depth command-line option to XBoard/WinBoard can also be used to
weaken the engine (see the man page or Help file).  It's a bit of a
nuisance to set command line options in Windows, but see topic <a
href="#tag-C.7">[C.7]</a> for instructions.</p>

<p>Other ways of weakening engines are engine-specific.  Many of them
let you adjust various parameters, and if you choose bad settings, the
engine will play more poorly.  Consult whatever documentation came with
the engine you are using.</p>

<hr />
<h3><a name="tag-B.25">[B.25]
  May I use the piece bitmaps from XBoard/WinBoard in my own program?</a></h3>

<p>The piece bitmaps used in XBoard and WinBoard were designed by
Elmar Bartel.  He released them under the <a
href="http://www.gnu.org/copyleft/gpl.html">GNU General Public
License</a>.  This means that if your program is also free software
distributed under the GPL, you can use them freely.  If your program
is distributed under some other license, including commercial,
shareware, or non-GPL freeware, then you cannot use the bitmaps unless
you obtain special permission from Elmar.  See the file README.bitmaps
that comes with the XBoard and WinBoard source code for more
information and an email address you can write to.</p>

<hr />
<h3><a name="tag-B.26">[B.26]
  How can I get rid of these silly logos that this new WinBoard displays above the board?</a></h3>

<p>WinBoard 4.4.0 has an option /autoLogo, which makes is search for bitmap files to display as logo, 
in the engine directory or in the folder "logos".
If you see logos without having asked for them, the settings in your winboard.ini file probably contains the line</p>
<pre>/autoLogo=true</pre>
<p>Just change that to /autoLogo=false.
You can also achieve that by starting WinBoard through the startup dialog (from the start menu),
and then tick "additional options" at the bottom,
and type /autoLogo=false in the edit field, before pressing OK.
If you then later select "Save Settings Now" from the Option menu,
or when "Save Settings on Exit" is on, and you close WinBoard,
this will automatically end up in your settings field.
</p><p>
When /autoLogo=false, logos will only be displayed if you explicitly ask for them,
by running WinBoard with the option /firstLogo=FILENAME.bmp or /secondLogo=FILENAME.bmp.
(Which will not be stored in the winboard.ini,
but might of course be hidden somewhere in a settings file mentioned on the command line as @SETTINGSFILE.ini.)
</p>

<hr />
<h3><a name="tag-B.27">[B.27]
  How can I install logos for other engines, Internet Chess Servers or Human users?</a></h3>

<p>With the option /autoLogo=true, (which is remembered in your settings file),
WinBoard automatically looks into the engine folder 
(specified by the /fd="..." or /sd="..." option), for a file called "logo.bmp". 
If it is found, it is used as a logo for the engine when it plays.
So all you have to do is put a logo.bmp file there.
Popular logo formats are 100x50 and 130x65; many engine logos are available from
<a href="http://www.geocities.com/davedahlem/my_logos.html">David Dahlem</a> or
<a href="http://kirill-kryukov.com/chess/discussion-board/viewtopic.php?t=545&f=7">Graham Banks</a>
</p><p>
It is possible to overrule the /autoLogo by explicitly using a /firstLogo="FILENAME.bmp" 
or /secondLogo="FILENAME.bmp" with the engine on the engine line in the startup dialog.
This is useful for engines that run with an adapter like Polyglot,
when you have only one polyglot on your system, used by many engines.
E.g. for Fruit the engine line to be typed in or selected from the combo box is
<pre>
"polyglot fruit.ini" /firstLogo="D:\Engines\Fruit\logo.bmp" /fd="D:\Engines\Polyglot"
</pre>
This prevents WinBoard looking for the logo in the Polyglot folder.
</p>
For Internet Chess Servers and Human users the logos should be in the "logos"
sub-folder of the folder where WinBoard is installed.
With /autoLogo=true, WinBoard would look for a logo file in that folder with
the same name as the ICS, suffixed with .bmp (e.g. freechess.org.bmp)
or the Human username 
(specified by the /userName="..." option or taken from the system), 
suffixed by .bmp, e.g. administrator.bmp)
</p>

<hr />
<h3><a name="tag-B.28">[B.28] Is there readline/history support for the input in XBoard/Winboard? </a></h3>

<p>There is a special ICS input box that has history support which is
the standard in Winboard and can be used in XBoard too.</p>
<p>Another good tip from Michel van der Bergh is to use the rlwarp
program together with XBoard which gives you full readline support.
Just run "rlwrap xboard" instead of just "xboard". The rlwarp program
should be available for most linux distributions or can be downloaded
at:
<a href="http://utopia.knoware.nl/~hlub/uck/rlwrap/">http://utopia.knoware.nl/~hlub/uck/rlwrap/</a>.
</p>


<hr /><h2><a name="tag-C">[C] XBoard and WinBoard, bugs and problems</a></h2>

<hr /><h3><a name="tag-C.1">[C.1] I can't build XBoard
because the X11/Xaw/...  include files are not found.</a></h3>

<p>These are the header files for the Athena Widgets library, which XBoard uses
heavily.  Some versions of Unix don't supply these files, but they are part of
the standard X distribution, freely available from MIT.  </p>

<p>For general information on getting missing X sources, see the FAQ on
comp.windows.x.  Note that you may be missing only the header files, or you
may be missing the libraries themselves too.</p>

<p>HP-UX users are missing only the header files.  You can get them by
anonymous FTP as follows.  (But first check with your system
administrator to see if someone else at your site has already done
this.)  Get the archive file /hpux9/X11R5/Core/Xaw-5.00.tar.gz (Xaw
header files) via anonymous FTP from the site hpux.csc.liv.ac.uk
(138.253.42.172), or one of the other official sites---Germany:
hpux.ask.uni-karlsruhe.de (129.13.200.57), US: hpux.cae.wisc.edu
(144.92.4.15), France: hpux.cict.fr (192.70.79.53) or Netherlands:
hpux.ced.tudelft.nl (130.161.140.100). Unpack the archive using gzip
and follow the instructions in its README and/or HPUX.Install files.
Thanks to Richard Lloyd for this information.</p>

<p>If you have the Xaw header files installed in a different place
than the other X11 headers, you may need to configure XBoard with an
extra flag to help it find them.  For example, if yours are in
/foo/bar/X11/Xaw, try this:</p>

<pre>
    rm config.cache
    (setenv CFLAGS -I/foo/bar ; configure)
</pre>

<p>Also see topic <a href="#tag-C.2">[C.2]</a>.</p>

<hr />
<h3><a name="tag-C.2">[C.2] Configuring or building XBoard fails due to
missing header files, missing libraries, or undefined symbols.
</a></h3>

<p>Perhaps you have the X server and client programs installed on your
machine, but not the X header files and link-time libraries.  If so,
you can run existing X programs, but you cannot compile a new X
program from source code.  In this case the XBoard configure script
will fail and will tell you to look at this question in the FAQ.  Many
GNU/Linux distributions put the headers and libraries in a separate
package, which you might not have installed.  If you are using RedHat,
install the XFree86-devel package.  If you are using some other
kind of Unix, ask your system administrator where to find the X header
files and link-time libraries.  If this is not your problem, read on.</p>

<p>The configure script for XBoard looks for X libraries and header
files in some common places.  Sometimes it fails: If yours are
installed in an odd place, it may not find them at all.  If you have
more than one version of X installed on your system, it may find the
"wrong" one, or occasionally it may find libraries from one version
and incompatible header files from another.  You can work around these
problems by telling the configure script where the files are.  For
example:</p>

<pre>
    configure --x-includes=/odd/place/include \
              --x-libraries=/odd/place/lib
</pre>

<p>The directory named in the argument to --x-includes must have a
subdirectory "X11" that contains the actual .h files.  That is, if
your X.h file has full pathname /odd/place/X11R6/include/X11/X.h, then
you must give the argument --x-includes=/odd/place/X11R6/include.</p>

<p>Some linkers have bugs that cause bogus error messages when you try
to link X programs.  The configure script includes a workaround for a
bug of this kind that exists in some SunOS 4.x.x installations.  See
the FAQ on comp.windows.x for more information about problems of this
kind.</p>

<p>If all else fails, check whether anyone else at your site has been able to
compile any X programs on your system.  Your X installation might be buggy.
If so, the system administrator at your site might know how to fix or work
around the problem.</p>

<p>Also see topic <a href="#tag-C.1">[C.1]</a>.</p>

<hr /><h3><a name="tag-C.3">[C.3] I have problems using WinBoard on ICS
with a modem.  I'm not running SLIP or PPP, but just dialing in to an
ordinary login account ("shell account").</a></h3>

<p>Here are solutions to some common problems in this area.</p>

<p>Some people want to connect to ICS through HyperTerminal or some other
terminal program first, then run WinBoard.  This is not how it works.
WinBoard wants to talk directly with your modem, acting as a terminal program
itself.  Start out with the modem "on hook" (not making a call).</p>

<p>Run WinBoard with a command line like this (adding more options if desired):</p>

<pre>
    WinBoard /ics /icscom com1
</pre>

<p>Use com2, com3, or com4 in place of com1 if your modem is connected to one of those ports.</p>

<p>After you start WinBoard, you may need to change some of the options in the
Communications dialog (on the Options menu).  The dialog has the usual options
for talking to modems: bits per second, bits per byte, parity, number of stop
bits.  You will probably want to use Save Settings Now when you're done.</p>

<p>Next, type dialing commands to your modem in the text window that WinBoard
creates.  You may need to turn off Local Line Editing on the Options menu
while you are typing commands to your modem.  Turn it back on when you're
done.  See the WinBoard Help file for instructions if you see your typing
echoed an extra time after you hit Enter.</p>

<hr />
<h3><a name="tag-C.4">[C.4]
I have problems using WinBoard on ICS with Windows 95 and SLIP
or PPP.  When trying to start up, it gets the error "Address family
not supported by protocol family" (or some equally strange message).
</a></h3>

<p>WinBoard is a 32-bit application, but some Winsock (TCP/IP) implementations
support only 16-bit applications.  You get a strange looking error message
if you try to use a 32-bit application because
there is no standard Winsock error code number
for "32-bit application not supported."</p>

<p>Microsoft TCP/IP works with both 16-bit and
32-bit applications, supports SLIP, PPP, Ethernet, etc., and is included
with Windows 95 and later Windows systems.
If possible, I recommend that you uninstall
whatever Winsock you are using and install Microsoft TCP/IP instead.
For more information, see
<a href=
"http://walden.mo.net/~rymabry/95winfaq.html"
>http://walden.mo.net/~rymabry/95winfaq.html (the Win95-L FAQ)</a>.</p>

<p>Trumpet Winsock 2.1 (and earlier) supports only 16-bit
applications, and hence does not work with WinBoard.  But there is a
beta-test release available that does support 32-bit applications.  
I have not tried it with WinBoard, but it 
should work.  See Trumpet's Web page
<a href=
"http://www.trumpet.com.au/wsk/winsock.htm"
>http://www.trumpet.com.au/wsk/winsock.htm</a>
for more information.</p>

<p>The 16-bit versions of America On-Line's software do not support
32-bit Winsock applications.  Get the 32-bit version.  At one time the
32-bit version was called "AOL for Windows 95," but I imagine that has
changed.  Hopefully the current versions are all 32-bit.</p>

<p>A few versions of Winsock may have bugs that prevent
Windows timestamp/timeseal from working with them.  I'm not sure if
such bugs exist in any versions that actually have 32-bit support,
so this point might be moot.  Again, Microsoft TCP/IP is known to work.</p>

<hr />
<h3><a name="tag-C.5">[C.5] When I try to run WinBoard, I get the
message "Failed to start chess program gnuchess on localhost: NO
LANGFILE (file gnuchess.lan not found)".</a></h3>

<p>This message means that WinBoard is trying to run GNU Chess, but
GNU Chess cannot find a file that it needs, named gnuchess.lan.
If you see it, you've probably customized WinBoard's /fcp, /fd, /scp,
and/or /sd options and made a mistake in the process.  Review what
you did, and see the WinBoard help file.</p>

<hr />
<h3><a name="tag-C.6">[C.6] I want to use XBoard or WinBoard as an Internet
Chess Server interface, but the ICS Client option is grayed out on the
menu.</a></h3> 

<p>XBoard and WinBoard have three major modes that can't be changed from the
menus: local chess engine mode,
ICS mode, and standalone mode.</p>

<p>With XBoard, you have to set the mode using command-line options.
Local chess engine mode is the default, -ics selects ICS mode, and
-ncp ("no chess program") selects standalone mode.</p>

<p>With WinBoard, if you don't set the mode using command-line
options, you get a dialog box asking which mode you want.  To bypass
the dialog box, use -cp ("chess program") for local chess engine mode,
or -ics or -ncp as with XBoard.  Also see topic <a href="#tag-C.7">[C.7]</a>.</p>

<hr />
<h3><a name="tag-C.7">[C.7] How do I give command-line options to
a Windows program like WinBoard?</a></h3>

<p>There are many ways; pick your favorite:</p>

<ul>
<li>Type the command line into an MS-DOS Prompt box.  Example:
"WinBoard -ics".</li>

<li>Make a Windows shortcut for WinBoard.  You can do this by
right-dragging WinBoard.exe to the desktop and selecting "Create
Shortcut(s) Here" from the menu that appears.  Right-click on the
shortcut, select Properties, and click the Shortcut tab.  The
command-line text box is labelled "Target" instead of "Command line"
just to confuse you.  Edit the text in this box, adding the command
line options to the end.</li>

<li>Choose Run from the Start menu, or File / Run from the Program
Manager or File Manager, and type the command line into the dialog you
get.  You may have to give WinBoard's full drivespec and filename if
it is not in a directory on your search path.</li>

<li>Make a Program Manager icon for WinBoard.  You can do this by
dragging WinBoard.exe from the File Manager into the Program Manager,
or by using File / New in the Program Manager.  Select the icon and
choose File / Properties.  Edit the Command Line text box to add the
command-line options to the end.</li>
</ul>

<hr />
<h3><a name="tag-C.9">[C.9]
When I exit from WinBoard after using it to play against a chess
program on my machine, the chess program keeps running in the background.
</a></h3>

<p>Be sure you have the current versions of WinBoard and the chess
engine you are using.  WinBoard 3.4.1 and earlier had a bug that
caused this problem to occur with all chess engines.  A buggy chess
engine that does not respond to the "quit" command will also cause
this.</p>

<p>If you still see this problem, you can stop the rogue chess engine
by pressing Ctrl+Alt+Del, selecting the chess engine process from the
menu, and pressing the End Task button.</p>

<hr />
<h3><a name="tag-C.12">[C.12]
Why do my ICS 
opponents often get extra time after they make their moves?
Why do I sometimes lose time off my clock after I make my move?
</a></h3>

<p>If you are playing with the ICS incremental clock, both you and your
opponent get a set amount of extra time after each move.</p>

<p>If your or your opponent has netlag, your opponent might appear to
get extra time, especially if your opponent is using timestamp or
timeseal.  The ICS charges each player who is using timestamp or
timeseal only for the time between when the player received his
opponent's move and the time he sent his own move.  Thus delays in
network transmission do not count against either player.  But WinBoard
counts down the display of your opponent's clock on your screen under
the assumption that there is no netlag.  When his move comes in, if
there was netlag, the ICS may not have really charged him for that
much time, and WinBoard corrects the clock to what the ICS says it
should read.</p>

<p>If you are not using timestamp or timeseal, you may appear to lose
time off your clock at some point after you make your move.  In this
case, the ICS charges you for the time between when it sent you your
opponent's move and the time it received your move.  Thus delays in
network transmission count against you.  WinBoard stops counting down
the display of your clock on your screen (and starts your opponent's)
when you make your move.  When the ICS echoes your move back to you, it
may have charged you for more time than that, and WinBoard corrects
the clocks to what the ICS says they should read.</p>

<p>See "help lag" and "help timestamp" or "help timeseal" on your ICS for
more detailed information.</p>

<hr />
<h3><a name="tag-C.13">[C.13]
I can't run WinBoard unless I delete the WinBoard.ini file each time!
</a></h3>

<p>Most people don't have this problem, but two or three people using
Windows NT 4.0 with Service Pack 3 or 4 have reported it.  I have no
idea what causes this problem.  Contrary to what was reported in a
previous version of this FAQ, reinstalling the service pack after
installing WinBoard does not seem to solve the problem.</p>

<hr />
<h3><a name="tag-C.15">[C.15]
I get errors compiling XBoard's parser.c.
</a></h3>

<p>The file parser.c is automatically generated from parser.l.  The
copy included with XBoard 4.0.2 was generated by lex on Tru64 Unix and
has problems compiling and linking on current GNU/Linux versions.  The
copy included with XBoard 4.0.3 was generated by flex on a GNU/Linux
machine, but it too won't necessarily work on other versions of Unix.
If you have this problem, you can fix it by deleting parser.c and
letting the Makefile re-create it from parser.l.  This will work if
you have either lex or flex on your system.  Flex is available in all
GNU/Linux distributions and can be obtained at no charge from the Free
Software Foundation, www.fsf.org.</p>

<hr />
<h3><a name="tag-C.16">[C.16]
I get an error building WinBoard from source because "flex" is not found.
</a></h3>

<p>The file parser.c is automatically generated from parser.l.  The
Makefile included with the WinBoard source kit has a rule for
generating parser.c using the program "flex", which will fail if you
don't have flex.  However, the source kit also includes a ready-made
copy of parser.c, so you don't really need flex unless you have made
changes to parser.l.  Check that you still have a copy of parser.c; if
you don't, unpack the WinBoard source zip file again to get one.
Either set the last-modified time of parser.c to be later than that of
parser.l, delete parser.l, or comment out the Makefile rule for
building parser.c from parser.l, and then try building WinBoard again.</p>

<p>If you do want to change parser.l and rebuild parser.c, you can get
flex as part of the free Cygwin kit from 
<a href="http://sourceware.cygnus.com/cygwin/"
>http://sourceware.cygnus.com/cygwin/</a>.  You can
probably also get flex for Windows by itself from various other places
around the Internet.  It is free software distributed by the Free
Software Foundation, www.fsf.org.</p>

<hr />
<h3><a name="tag-C.17">[C.17]
  XBoard hangs shortly after connecting to an ICS when used with dxterm,
 cmdtool, dtterm, kterm, konsole, or other substitutes for xterm.
</a></h3>

<p>After connecting to a chess server, XBoard 4.0.2 and later sends an
escape sequence to its terminal that is meant to display your handle
and the ICS host name (for example, 
"user<a name="nospam03">&#x40;</a>chessclub.com") in the
terminal's banner and icon.  It seems that several of the alternative
X terminal programs have a bug that makes them hang when sent this
escape sequence.</p>

<p>You can work
around the problem by using xterm, nxterm, rxvt, aterm, xiterm, or
gnome-terminal, all of which seem to work fine.  In fact, current
versions of kterm and konsole seem to work fine too, so if you are
having problems with one of them, be sure you are not running an
outdated version.  </p>

<p>Alternatively, you can disable this feature by commenting out the
body of DisplayIcsInteractionTitle in xboard.c and recompling xboard.</p>

<hr />
<h3><a name="tag-C.18">[C.18]
  The WinBoard pieces show up in the wrong colors, appear distorted,
  or are not visible at all.
</a></h3>

<p>This can happen if you have a bug in your Windows display driver.
Check with the manufacturer of your display card, the manufacturer of
your computer, or Microsoft to see if there is an updated driver
available.  You can usually download updated drivers from the Web.</p>

<p>If you can't find an updated driver, you can try running Windows
using a different number of colors and/or disabling some of the
hardware acceleration features on your display card.  To change the
number of colors, go to Windows Start / Settings / Control Panel /
Display / Settings / Color Palette.  To disable hardware acceleration
features, go to Windows Start / Settings / Control Panel / Display /
Settings / Advanced Properties / Performance / Hardware Acceleration.</p>

<p>It's also possible that Windows has the right driver for your
hardware already but you are not using it.  It may help to reinstall
your driver.  Go to Windows Start / Settings / Control Panel / System
and delete your display card (maybe even your monitor too), then
reboot.  Windows should automatically re-detect your card and monitor
and re-install the drivers; if it doesn't, run Start / Settings /
Control Panel / Add New Hardware to force it to.</p>

<p>If all else fails, try Monochrome mode.  On WinBoard's menus, go
to Options / Color and check Monochrome.  WinBoard will display in black
and white.</p>

<hr />
<h3><a name="tag-C.19">[C.19] XBoard or WinBoard tells me "Error: first chess
  program (...) exited unexpectedly".</a></h3>

<p>This message means that your chess engine crashed, probably due to
a bug in the engine, or because you have it configured incorrectly.
You can try running XBoard or WinBoard again with the "-debug" flag on
the command line.  This will print out all the messages received from
the chess engine.  (With WinBoard, the messages go into a file called
WinBoard.debug; with XBoard, they go to the xterm that you started
XBoard from.)</p>

<p>If you are using GNU Chess and you see this problem as soon as it
starts up, most likely GNU Chess is exiting with an error message.  If
you see the message "NO LANGFILE", it means that you did not install
GNU Chess correctly, and it is unable to find the file gnuchess.lang.
Make sure that you defined LIBDIR in the gnuchess Makefile, and that
gnuchess.lang is in that directory.  If gnuchess.lang is not there,
you probably didn't type "make install" in the gnuchess src directory;
you must do this to install gnuchess.lang (and the gnuchess book).  If
you defined LIBDIR to something that is not an absolute pathname (that
is, to something that does not start with a "/"), GNU Chess will work
only if you run it from the GNU Chess "src" directory where you built
it.</p>

<hr /><h3><a name="tag-C.20">[C.20]
  XBoard tells me "Warning: Cannot allocate colormap entry", or
  "too few colors available; trying monochrome mode", or
  "XPM pieces cannot be used in monochrome mode".
</a></h3>

<p>You are running your X server with 8-bit color depth, and you are running
some program that has used up all 256 of your colors.  Netscape tends
to do this, or maybe you have a background image that uses up all of
your colors.</p>

<p>If you have a modern machine, you probably have enough display
memory to run your X server with 16-, 24-, or 32-bit color depth.  If
you're using "startx" to start the X server, try giving the command as
"<tt>startx -- -bpp 24</tt>" (or 16, or 32).  On newer X servers you
may have to use -depth instead of -bpp.  Further details on
configuring your X server are beyond the scope of this FAQ.</p>

<p>If you must run in 8-bit mode, try the following:
Avoid background images that use up all your colors.  If you
run Netscape, try starting it up with the <tt>-install</tt> command-line
option; this gives Netscape its own private colormap that X will
switch to when Netscape has the keyboard focus.  </p>

<p>If all else fails, another possibility is to run xboard in
monochrome (black and white) mode by giving it the <tt>-mono</tt>
command-line option.  XBoard will try this by itself in some cases.
Monochrome mode works only with bitmap pieces, not pixmap pieces, so
trying to use it may give you the error "XPM pieces cannot be used in
monochrome mode".  To get around this, either use the -bitmapDirectory
command line option to point XBoard to the directory containing the
bitmap pieces included with the XBoard source code, or rebuild XBoard
with pixmap support disabled, using "./configure --disable-xpm ; make
clean ; make".</p>

<hr /><h3><a name="tag-C.21">[C.21]
  When I log in to freechess.org, the Enter key doesn't work, and I 
  have to use Ctrl+J instead.  But when I use WinBoard, Ctrl+J doesn't
  work either, so I'm stuck.
</a></h3>

<p>This is a pretty rare problem.  It should only arise if you have to
reach freechess.org by telnetting (or connecting with WinBoard
/icsport=23) from a Windows PC to a Unix box, and then telnetting from
there to freechess.org.  The Enter key should always work when
connecting directly from your PC to freechess.org.</p>

<p>The best way to get around the problem is to run timeseal on the
intermediate Unix box instead of telnet.  Get the appropriate version
of timeseal for your box from ftp.freechess.org and follow the
directions in the help files on FICS.</p>

<p>If you can't run timeseal for some reason, there are some things
you can do to make telnet stay in line mode instead of going to
character mode.  Then the Enter key will work.  First, try "telnet
freechess.org 5000" instead of "telnet freechess.org."
If that still doesn't work, then when the Enter key stops working,
type the following.  Here <tt>&lt;</tt> and <tt>&gt;</tt> surround the
names of keys.</p>

<pre>
    &lt;Ctrl+S&gt;&lt;Ctrl+]&gt;mode line&lt;Enter&gt;
</pre>

<hr /><h3><a name="tag-C.22">[C.22]
  XBoard says, "Failed to start first chess program fairymax
  on localhost: fairymax: No such file or directory."
</a></h3>

<p>XBoard is looking for the Fairy-Max chess engine.  
If you didn't want to use XBoard with Fairy-Max, please see topic 
<a href="#tag-C.6">[C.6]</a>.
If you did want to use Fairy-Max, be sure you have it installed and
that it is on your $PATH.  If you wanted to use GNU Chess instead,
see topic <a href="#tag-D.6">[D.6]</a>.</p>

<hr />
<h2><a name="tag-D">[D] Crafty and other topics</a></h2>
<hr />
<h3><a name="tag-D.1">[D.1] What is XChess?</a></h3>

<p>XChess is an older chessboard program that is no longer supported.  XChess was
written for X version 10, and you may or may not be able to build and run it
on an X11 system.</p>

<p>XChess has only one significant feature that is not present in XBoard: Two
humans can play chess using XChess on different machines, without using the
Internet Chess Server as an intermediary.  This feature is of interest only if
you don't have network connectivity to the Internet Chess Server.</p>

<p>Note: There actually have been several different programs called "XChess" in
circulation at various times.  The above describes one that was associated
with GNU Chess.</p>

<hr />
<h3><a name="tag-D.2">[D.2] What is Winsock Chess?</a></h3>

<p>Winsock Chess is a program that lets two people play chess across a
network.  It runs only under Microsoft Windows.  Some of the code in
Winsock Chess is derived from GNU Chess, but it is not maintained by
the GNU Chess team.  You can get a copy from the Internet Chess
Library; see topic <a href="#tag-A.2">[A.2]</a>.  For more information,
contact its author, Donald Munro, 
ccahdm<a name="nospam04">&#x40;</a>beluga.upe.ac.za.</p>

<hr />
<h3><a name="tag-D.3">[D.3] What is Crafty?</a></h3>

<p>Crafty is a freely-available chess program written by Bob Hyatt.  
Bob is the main author of the well-known chess program Cray
Blitz.  Crafty is a very strong program, its code is available, commented
and fairly readable, and its author is actively working on improvements.</p>

<p>You can download Crafty from <a
href="ftp://ftp.cis.uab.edu/pub/hyatt/"
>ftp://ftp.cis.uab.edu/pub/hyatt/</a>.  Start by getting the <a
href="ftp://ftp.cis.uab.edu/pub/hyatt/read.me" >read.me</a> file and
reading it.  Among other things, this file contains instructions on
how to install Crafty as a command-line application on your machine.</p>

<p>There is a Crafty mailing list.
To subscribe, send email to 
majordomo<a name="nospam05">&#x40;</a>cis.uab.edu, with 
"subscribe crafty-list" in the body.</p>

<hr />
<h3><a name="tag-D.4">[D.4] How do I use Crafty with XBoard?</a></h3>

<p>First, you need to get Crafty and install it as a command-line
application on your machine.  See topic <a href="#tag-D.3">[D.3]</a>.</p>

<p>To use Crafty with XBoard, give the -fcp
parameter like this:</p>

<pre>
    xboard -fcp "./crafty" -fd <I>crafty_directory</I>
</pre>

<p>Here <I>crafty_directory</I> is the directory where you installed Crafty.
You can add more xboard options at the end of the command line.</p>

<p>Crafty 15.14 or later is required to work properly with XBoard
4.0.0 or later.  We generally recommend using the latest versions of
both XBoard and Crafty.</p>

<hr />
<h3><a name="tag-D.5">[D.5] How do I use Crafty with WinBoard?</a></h3>

<p>First, you need to get Crafty and install it as a command-line
application on your machine.  See topic <a href="#tag-D.3">[D.3]</a>.
It is best to use the latest version of Crafty with the latest version
of WinBoard to make sure all features are compatible and function
correctly.  You can install Crafty in any directory you like.</p>

<p>You also need to get WinBoard and install it in the normal way
using its built-in installer.  You can do that either before or after
you install Crafty.</p>

<p>After both Crafty and WinBoard are installed separately, follow the
directions in the WinBoard Help file (included with WinBoard) for
connecting new chess engines to WinBoard.</p>

<p>If you want to have Crafty act as an automated computer player on a
chess server, see topic <a href="#tag-B.16">[B.16]</a>.  Before you try
to get that working, be sure you can play against Crafty locally,
first without WinBoard, then with it.  Also be sure you can use
WinBoard to play on the chess server yourself, without having Crafty
connected to it.  You have to crawl before you can walk!</p>

<hr />
<h3><a name="tag-D.6">[D.6] How do I use GNU Chess with XBoard?</a></h3>

<p>By default, XBoard tries to use Fairy-Max by running the
command "fairymax".  That's why if you don't have Fairy-Max, you
get the error message "Failed to start first chess program fairymax
on localhost: fairymax: No such file or directory."</p>

<p>If you have GNU Chess 5, the command should be "gnuchess xboard"
instead.  To make XBoard use this command, give the -fcp parameter
like this:</p>

<pre>
    xboard -fcp "gnuchess xboard" 
</pre>

If you instaled GNU Chess as a package, the operating system usually 
knows where to find it, and GNU Chess knwos where to find its data
files, such as the opening book.
If GNU Chess is installed in a non-compliant way, e.g. together
with its book file in a user directory, you must use:

<pre>
    xboard -fd <I>gnuchess_directory</I> -fcp "./gnuchess xboard" 
</pre>

<p>Here <I>gnuchess_directory</I> is the directory where you installed
GNU Chess 5 and its book. 
In all cases you can add more xboard options at the end of the command 
line.</p>

<p>If you want to use GNU Chess 4, the command should be "gnuchessx"
instead.  To make XBoard use this command, give the -fcp parameter
like this:</p>

<pre>
    xboard -fcp "gnuchessx" 
</pre>

<p>The same applies for non-compliant installs as for GNU Chess 5:
the install directory has to be given with the -fd argument. </p>

<hr />
<h3><a name="tag-D.7">[D.7] How do I use GNU Chess with WinBoard?</a></h3>

<p>Well, why would you want to? If you want a strong free engine,
use Crafty, Glaurung, Fruit or Toga.
If you wnt an engine that plays many variants, use Fairy-Max,
Pulsar or Sjeng.
But the procedure to install and run those is not any different than
for GNU Chess.
</p>
<p>If you want to use a WinBoard-compatible chess engine that is not
automatically installed with the download,
you will have to download it yourself.
Most chess engines are downloaded as a compressed archive (e.g. a .zip file),
and on downloadig it, the decompression software on your Windows system
is automatically invoked when you seected "Open" in the download dialog.
You can then click "extract all files", and you are prompted for a place
to put the unpacked stuff.
The place it proposes is usually no good, so browse to the folder
in which you installed the winBoard download
(where you see the Fairy-Max and WinBoard folders).
</p><p>
When the archiv contained a single folder, (with files in it), 
unpack it there.
If the archive contained a lot of small files, first create a folder,
and browse there, before you unpack.
(To get all the files in a single place, not mixed with others,
so you can easily delete it again.)
Say you unpacked in a folder named "NewEngine", which now sits
next to your "WinBoard" folder amongst the chess files on your system.
Say there is a file "Engine.exe" in this "NewEngine" folder.
</p><p>
Then to run the engine with WinBoard,
you have to enter the command:
</p>
<pre>
        winboard /fcp="Engine.exe" /fd="..\NewEngine"
</pre>
<p>
Sometimes engines need parameters on their command line,
e.g. to set the hash-table size, or tell them they have to
deal with WinBoard.
These should then go within the quotes around the Engine.exe file name, 
directly behind it, and separated from it (and each other) by spaces.
See any README files that come with the engine to learn how
exactly the engine has to be invoked.
</p>
<hr />
<h3><a name="tag-D.8">[D.8] What is Fairy-Max?</a></h3>

<p>Fairy-Max is a chess engine that plays chess at a level where
you don't need to be a super GM to still have a chance to beat it.
Apart from normal chess it plays many variants as well,
such as Capablanca or Gothic Chess, Knightmate, etc.
Dedicated versions of it are available to play Shatranj and Xiangqi
(Chinese Chess).
</p>

<hr />
<h3><a name="tag-D.9">[D.9] What is UCI? What is Polyglot?</a></h3>

<p>UCI, or Universal Chess Interface, is a standard for communication
between chess engines and its Graphical User Interface, that was
created as an alternative to the way XBoard / WinBoard does it.
(The latter way having become known as 
"<a href="#tag-B.17">WinBoard protocol</a>").
XBoard / WinBoard do not understand a word of UCI,
so UCI engines cannnot be run directly as engine under them.
</p><p>
Polyglot is an adapter that translates WB protocol to UCI.
It bhaves like it is a WB engine, but, without XBoard / WinBoard
knowing about this, it consults an UCI engine for getting the moves.
With the aid of Polyglot, any UCI engine can be run under WinBoard.
Polyglot is available as a Debian package for Linux, and is included
in the WinBoard installation.
Polyglot is open source software released under the GPL.
</p>

<hr />
<h3><a name="tag-D.10">[D.10] How can I run a UCI engine under XBoard / WinBoard?</a></h3>

<p>First you have to download and install the UCI engine.
This is similar to installing WinBoard engines, 
see <a href="#tag-D.7">D.7</a>.
Furthermore, you have to make sure that 
<a href="#tag-D.9">Polyglot</a> is nstalled on
your system, in a place where XBoard / WinBoard can find it.
There are then two ways to run the UCI engine:
</p><p>
In the first method, the only thing you have to do is add an extra
option to the command that invokes XBoard / WinBoard,
to tell it that the engine is UCI:
</p>
<pre>
        xboard -fcp "fruit" -fUCI

        winboard /fcp="Fruit_21.exe" /fd="..\Fruit" /fUCI
</pre>
<p>
The second method is more complicated, but also more versatile.
UCI engines accept many settings from their GUI than XBoard / WinBoard
usually send to a WB engine.
Polyglot can provide such settings from a file dedicated to that engine,
usully referred to as a "polyglot.ini" file (although the actual name
can be different.)
If the engine you downloaded comes with a polyglot.ini file for it,
you can force Polyglot to use this file with engine settings
by invoking it explicitly from XBoard / WinBoard:
</p>
<pre>
        xboard -fcp "polyglot INIFILE"

        winboard /fcp="polyglot INIFILE" /fd="POLYGLOTDIR"
</pre>
<p>
INIFILE is the name of the polyglot.ini file (possibly a path name,
such as "PG\fruit.ini", while POLYGLOTDIR should be the directory
(path) name were the Polyglot executable is located.
The directory and name of the actual engine are described in the
polygot.ini file, and XBoard / WinBoard need not be aware of them.
</p><p>
If you don't have a polyglot.ini file for the engine, you would
have to make one.
How to do that is beyond the scope of this FAQ.
Refer to the Polyglot documentation for this,
or use method 1.
</p>
<hr />
** End of XBoard/WinBoard FAQ **
</body></html>