G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
N N N NA A A AM M M ME E E E
xboard - X user interface for GNU Chess, the Internet Chess
Server (ICS), and electronic mail correspondence chess.
x x
[ [
x x
[ [
- [ [
S S S SY Y Y YN N N NO O O OP P P PS S S SI I I IS S S S
To run with GNU Chess:
x xb b b bo o o oa a a ar r r rd d d d
[ [o o o op p p pt t t ti i i io o o on n n ns s s s] ] ] ]
To run with the ICS:
x xb b b bo o o oa a a ar r r rd d d d - - - -i i i ic c c cs s s s
[ [o o o op p p pt t t ti i i io o o on n n ns s s s] ] ] ]
To play email chess: See _ c_ m_ a_ i_ l(6).
To run standalone: x x x xb b b bo o o oa a a ar r r rd d d d
- -n n n nc c c cp p p p
[ [o o o op p p pt t t ti i i io o o on n n ns s s s] ] ] ]
D D D DE E E ES S S SC C C CR R R RI I I IP P P PT T T TI I I IO O O ON N
N N
_ x_ b_ o_ a_ r_ d is a graphical chessboard that can serve as
a user
interface for GNU Chess, for the Internet Chess Server, or
for electronic mail correspondence chess. _ x_ b_ o_ a_ r_ d
can also
be used by itself.
As an interface to GNU Chess, _ x_ b_ o_ a_ r_ d lets you play
a game
against the machine, set up arbitrary positions, force
variations, or watch a game between two machines.
As an interface to the Internet Chess Server (ICS),
_ x_ b_ o_ a_ r_ d
-_ i_ c_ s lets you play against other ICS users, observe games
they are playing, or review games that have recently
finished.
As an interface to electronic mail correspondence chess,
_ x_ b_ o_ a_ r_ d works with the _ c_ m_ a_ i_ l(6) program.
See its manual page
for instructions.
You can also use _ x_ b_ o_ a_ r_ d as a chessboard to play
through
games. It will read and write game files and allow you to
play through variations manually. You can use it to browse
games off the net or review GNU Chess, ICS, and
correspondence games you have saved. These features are
available at all times; even if you do not have access to
GNU Chess or the ICS, you can use them by giving the command
_ x_ b_ o_ a_ r_ d -_ n_ c_ p.
After starting _ x_ b_ o_ a_ r_ d, you make moves by dragging
pieces
with the mouse. Press mouse button 1 while the cursor is on
one of your pieces, then move the cursor to another square
and release the button.
O O O OP P P PT T T TI I I IO O O ON N N NS S S S
Most of the _ x_ b_ o_ a_ r_ d options have both a long name
and a short
name. To turn a boolean option on or off from the command
line, either give its long name followed by the value True
or False (-_ l_ o_ n_ g_ O_ p_ t_ i_ o_ n_ N_ a_ m_ e True), or
give just the short name
to turn the option on (-_ o_ p_ t), or the short name preceded
by
"x" to turn the option off (-x_ o_ p_ t). For options that
take
strings or numbers as values, you can use the long or short
option names interchangeably.
Page 1
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
Each option corresponds to an X resource with the same name,
so you can set options in your ._ X_ d_ e_ f_ a_ u_ l_ t_ s
file if you like.
For options that have two names, the longer one is the name
of the corresponding X resource; the short name is not
recognized in .Xdefaults. To turn a boolean option on or
off in your .Xdefaults file, give its long name followed by
the value True or False
(XBoard*_ l_ o_ n_ g_ O_ p_ t_ i_ o_ n_ N_ a_ m_ e:
True).
G G G GN N N NU U U U C C C Ch h h he e e es s s ss s s s
O O O Op p p pt t t ti i i io o o on n n ns s s s
- - - -t t t tc c c c o o o or r r r - - - t t t ti i i im m m me e e eC C C Co o o on n n nt t t tr r r ro o o ol l
l l
m m m mi i i in n n nu u u ut t t te e e es s s s[ [ [ [: : : :s s s se e
e ec c c co o o on n n nd d d ds s s s] ] ] ]
- - - -m m m mp p p ps s s s o o o or r r r - - - m m m mo o o ov v v ve e e es s s sP P P Pe e e er r r rS S S Se e e es s
s ss s s si i i io o o on n n n m m m mo o o ov v v ve e e es s s s
Each player begins with the specified amount of time
on his clock. If a player makes the specified
number of moves before his clock runs out,
_ x_ b_ o_ a_ r_ d
adds the specified amount of time to his clock.
Default: 40 moves in 5 minutes.
- - - -c c c cl l l lo o o oc c c ck k k k o o o or r r r - - -c c c cl l l lo o o oc c c ck k k kM M M Mo o o od d d de e e e
Determines whether or not to display the chess
clocks. If clockMode is False, the clocks are not
shown, but the side that is to play next is still
highlighted. Also, unless searchTime or searchDepth
is set, GNU Chess still keeps track of the clock
time and uses it to determine how fast to make its
moves.
- - - -s s s st t t t o o o or r r r - - - s s s se e e ea a a ar r r rc c c ch h h hT T T Ti i i im m m me e e e
m m m mi i i in n n nu u u ut t t te e e es s s s[ [ [ [: : : :s s s se e
e ec c c co o o on n n nd d d ds s s s] ] ] ]
Tells GNU Chess to spend at most the given amount of
time searching for each of its moves. Without this
option, GNU Chess chooses its search time based on
the number of moves and amount of time remaining
until the next time control. Setting this option
also sets clockMode to False.
- - - -s s s sd d d d o o o or r r r - - - s s s se e e ea a a ar r r rc c c ch h h hD D D De e e ep p p pt t t th h
h h n n n nu u u um m m mb b b be e e er r r r
Tells GNU Chess to look ahead at most the given
number of moves when searching for a move to make.
Without this option, GNU Chess chooses its search
depth based on the number of moves and amount of
time remaining until the next time control. Setting
this option also sets clockMode to False.
- - - -m m m mm m m m o o o or r r r - - - m m m ma a a at t t tc c c ch h h hM M M Mo o o od d d de e e e
Automatically runs a game between two chess
programs. If the loadGameFile or loadPositionFile
option is set, _ x_ b_ o_ a_ r_ d starts the game with
the given
opening moves or the given position; otherwise, the
game starts with the standard initial chess
position. If the saveGameFile option is set, a move
record for the match is appended to the specified
file. If the savePositionFile option is set, the
Page 2
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
final position reached in the match is appended to
the specified file. When the match is over,
_ x_ b_ o_ a_ r_ d
exits.
Default: False.
- - - -f f f fc c c cp p p p o o o or r r r - - - f f f fi i i ir r r rs s s st t t tC C C Ch h h he e e es s s ss s s sP P
P Pr r r ro o o og g g gr r r ra a a am m m m
p p p pr r r ro o o og g g gr r r ra a a am m m m
Name of first chess program. In matches between two
machines, this program plays black. Default:
"gnuchessx".
- - - -s s s sc c c cp p p p o o o or r r r - - - s s s se e e ec c c co o o on n n nd d d dC C C Ch h h he e e es s s ss s
s sP P P Pr r r ro o o og g g gr r r ra a a am m m m
p p p pr r r ro o o og g g gr r r ra a a am m m m
Name of second chess program, if needed. In matches
between two machines, this program plays white;
otherwise it is not started. Default: "gnuchessx".
- - - -f f f fh h h h o o o or r r r - - - f f f fi i i ir r r rs s s st t t tH H H Ho o o os s s st t t t
h h h ho o o os s s st t t t
Name of host the first chess program plays on.
Default: "localhost".
- - - -s s s sh h h h o o o or r r r - - - s s s se e e ec c c co o o on n n nd d d dH H H Ho o o os s s st t t t
h h h ho o o os s s st t t t
Name of host the second chess program plays on.
Default: "localhost".
- - r r r re e e em
l l s s s sh h
n n n na a a am
-r r r rs s s sh h h h o o o or r r r - - - m m mo o o ot t t te e e eS S S Sh h h he e e el l l ll l
h he e e el l l ll l l l- - - m m me e e e
Some systems do not use rsh as the remote shell.
This option allows a user to name the remote shell
command.
- - - i i i in n n ni i i it t t tS S S St
s s s st t t tr r r ri i i in n n ng
The string that is
program. Default:
t t tr r r ri i i in n n ng g g g
g g g
sent to initialize the chess
"new\nbeep\nrandom\neasy\n".
If you change this option, don't remove the "new"
and "beep" commands. You can remove the "random"
command if you like; including it causes GNU Chess
to randomize its move selection slightly so that it
doesn't play the same moves in every game. (Even
without "random", GNU Chess randomizes its choice of
moves from its opening book.) You can also remove
"easy" if you like; including it toggles easy mode
off, causing GNU Chess to think on your time. That
is, if "easy" is _ i_ n_ c_ l_ u_ d_ e_ d in the
initString, GNU
Chess thinks on your time; if not, it does not.
(Yes, this does seem backwards, doesn't it!) To see
what GNU Chess is thinking about, you can add the
"post" command and run _ x_ b_ o_ a_ r_ d with
debugMode turned
on. You can also try adding other commands to the
initString; see the GNU Chess documentation for
details.
- - w w w wh h h hi
g g s s s st t
- - b b b bl l l la
g g s s s st t
Page 3
i
t
a
t
i it t t te e e eS S S St t t tr r r ri i i in n n ng g
tr r r ri i i in n n ng g g g
a ac c c ck k k kS S S St t t tr r r ri i i in n n ng g
tr r r ri i i in n n ng g g g
These options control what is sent when the Machine
(printed 1/12/99)
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
White and Machine Black buttons are selected. This
is mostly for compatibility with obsolete versions
of GNU Chess.
I I
C C C Ch
S S S Se
O O O Op
I
h
e
p
In n n nt t t te e e er r r rn n n ne e e et t t t
h he e e es s s ss s s s
e er r r rv v v ve e e er r r r
p pt t t ti i i io o o on n n ns s s s
- - - -i i i ic c c cs s s s o o o or r r r - - - i i i in n n nt t t te e e er r r rn n n ne e e et t t tC C C Ch h h he e
e es s s ss s s sS S S Se e e er r r rv v v ve e e er r r rM M M Mo o o
od d d de e e e
Connect with an Internet Chess Server to play chess
against its other users, observe games they are
playing, or review games that have recently
finished. Default: False.
To use xboard in ICS mode, run it in the foreground,
and use the terminal you started it from to type
commands and receive text responses from the chess
server. Useful ICS commands include _ w_ h_ o to see
who
is logged on, _ g_ a_ m_ e_ s to see what games are
being
played, _ m_ a_ t_ c_ h to challenge another player to
a game,
_ o_ b_ s_ e_ r_ v_ e to observe an ongoing game,
_ e_ x_ a_ m_ i_ n_ e or
_ o_ l_ d_ m_ o_ v_ e_ s to review a recently completed
game, and of
course _ h_ e_ l_ p. Whenever you ask to observe an
ongoing
game, review a completed game, or resume an
adjourned game, _ x_ b_ o_ a_ r_ d retrieves and parses
the list
of past moves from the ICS, so you can review them
with the Forward and Backward commands or save them
with Save Game.
You can create a script file containing ICS commands
that _ x_ b_ o_ a_ r_ d will type in for you whenever
you
connect to the ICS.
See FILES below.
- - - -a a a au u u ut t t to o o of f f fl l l la a a ag g g g
o o o or r r r - - - a a a au u u ut t t to o o oC C C Ca a a al l l ll l l lF F F Fl l l la a
a ag g g g
If autoCallFlag is True and your opponent runs out
of time before you do, _ x_ b_ o_ a_ r_ d will
automatically
call his flag, claiming a win on time (or a draw if
you do not have mating material). Default: False.
- - - -q q q qu u u ui i i ie e e et t t t o o o or r r r - - -q q q qu u u ui i i ie e e et t t tP P P Pl l l la a a ay y y y
If this option is True, _ x_ b_ o_ a_ r_ d will
automatically
issue a "set shout 0" command whenever you start an
ICS game and a "set shout 1" command whenever you
finish one. Default: False.
- - - -i i i ic c c cs s s sh h h ho o o os s s st t t t
o o o or r r r - - - i i i in n n nt t t te e e er r r rn n n ne e e et t t tC C C Ch h h he e
e es s s ss s s sS S S Se e e er r r rv v v ve e e er r r rH H H Ho o o
os s s st t t t h h h ho o o os s s st t t t
The Internet host name or address of the chess
server to connect to when in ICS mode. Default:
ics.uoknor.edu. Other values to try:
anemone.daimi.aau.dk, coot.lcs.mit.edu,
chess.pitt.edu.
If your site doesn't have a working Internet name
server, try specifying the host address in numeric
form. The addresses for the hosts given above are
Page 4
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
respectively 129.15.10.21, 130.225.18.58,
18.52.0.70, and 136.142.81.40.
- - - -i i i ic c c cs s s sp p p po o o or r r rt t t t
o o o or r r r - - - i i i in n n nt t t te e e er r r rn n n ne e e et t t tC C C Ch h h he e
e es s s ss s s sS S S Se e e er r r rv v v ve e e er r r rP P P Po o o
or r r rt t t t p p p po o o or r r rt t t t- - - n n n nu u u um m m mb b b be e e er r r r
The port number to use when connecting to a chess
server in ICS mode. Default: 5000.
- - - -g g g ga a a at t t te e e ew w w wa a a ay y y y
If this option is set to a host name,
_ x_ b_ o_ a_ r_ d uses
_ r_ s_ h to run telnet on the given host to
communicate
with the Internet Chess Server instead of opening a
direct TCP connection.
This option is useful if your machine is unable to
connect directly to the ICS but is able to rsh to a
gateway host that can connect to the ICS. As an
example, suppose the gateway host is called
gate.wassamatta-u.edu, and you set options as
follows: -gateway gate.wassamatta-u.edu
-internetChessServer ics.uoknor.edu
-internetChessServerPort 5000 Then when you run
_ x_ b_ o_ a_ r_ d in ICS mode, it will connect to the
ICS by
using rsh to run the command "telnet ics.uoknor.edu
5000" on host gate.wassamatta-u.edu.
- - - -t t t te e e el l l ln n n ne e e et t t t
o o o or r r r - - - u u u us s s se e e eT T T Te e e el l l ln n n ne e e et t t t
If this option set to True, _ x_ b_ o_ a_ r_ d runs the
_ t_ e_ l_ n_ e_ t(1) program to communicate with the
Internet
Chess Server instead of opening a direct TCP
connection. The default is False.
One case where this option is useful is if your
machine is unable to connect directly to the ICS but
is able to telnet to a gateway host that can connect
to the ICS. It is more general than the gateway
option, because you may be able to telnet to a host
that you cannot rsh to, but it's not as convenient
to use. As an example, suppose the gateway host is
called gate.wassamatta-u.edu, and you set options as
follows: -useTelnet true -internetChessServer
gate.wassamatta-u.edu -internetChessServerPort 23
Then when you run _ x_ b_ o_ a_ r_ d in ICS mode, you
will get a
login prompt from the gateway host. Log in there
and run the telnet program (giving a command like
"telnet ics.uoknor.edu 5000") to connect to the ICS.
This works because giving the option "internetChessServerPort 23" causes _ x_ b_ o_ a_ r_ d
to connect
to the gateway host's standard incoming telnet
service instead of trying to connect to a chess
server running on the gateway host.
- - - t t t te e e el l l ln n n ne e e et t t tP P P Pr r r ro o o og g g gr r
r ra a a am m m m
Page 5
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
This option gives the name of the telnet program to
be used with the gateway and useTelnet options. The
default is "telnet". The telnet program is invoked
with the value of internetChessServer as its first
argument and the value of internetChessServerPort as
its second argument.
L L L Lo o o oa a a ad d d d a a a an n n nd d d d
S S S Sa a a av v v ve e e e
O O O Op p p pt t t ti i i io o o on n n ns s s s
- - - -l l l lg g g gf f f f o o o or r r r - - - l l l lo o o oa a a ad d d dG G G Ga a a am m m me e e eF F F Fi i i il l
l le e e e f f f fi i i il l l le e e e
- - - -l l l lg g g gi i i i o o o or r r r - - - l l l lo o o oa a a ad d d dG G G Ga a a am m m me e e eI I I In n n nd d
d de e e ex x x x i i i in n n nd d d de e e ex x x x
If the loadGameFile option is set, _ x_ b_ o_ a_ r_ d
loads the
specified position file at startup. If the
loadGameIndex option is set to N, the _ Nth game found
in the file is loaded; otherwise the first game is
loaded.
- - - -t t t td d d d o o o or r r r - - - t t t ti i i im m m me e e eD D D De e e el l l la a a ay y y y
s s s se e e ec c c co o o on n n nd d d ds s s s
Time delay between moves during "Load Game".
Fractional seconds are allowed; try -td 0.4. A time
delay value of -1 tells _ x_ b_ o_ a_ r_ d not to step
through
game files automatically.
Default: 1 second.
- - - -s s s sg g g gf f f f o o o or r r r - - - s s s sa a a av v v ve e e eG G G Ga a a am m m me e e eF F F Fi i i il l
l le e e e f f f fi i i il l l le e e e
If this option is set, _ x_ b_ o_ a_ r_ d appends a
record of
every game played to the specified file.
- - - -a a a au u u ut t t to o o os s s sa a a av v v ve e e e
o o o or r r r - - - a a a au u u ut t t to o o oS S S Sa a a av v v ve e e eG G G Ga a a am m
m me e e es s s s
If this option is True, at the end of every game
_ x_ b_ o_ a_ r_ d prompts you for a file name and
appends a
record of the game to the file you specify. Ignored
if autoSaveGames is set.
- - - -l l l lp p p pf f f f o o o or r r r - - - l l l lo o o oa a a ad d d dP P P Po o o os s s si i i it t t ti i i io o
o on n n nF F F Fi i i il l l le e e e f f f fi i i il l l le e e e
- - - -l l l lp p p pi i i i o o o or r r r - - - l l l lo o o oa a a ad d d dP P P Po o o os s s si i i it t t ti i i io o
o on n n nI I I In n n nd d d de e e ex x x x
i i i in n n nd d d de e e ex x x x
If the loadPositionFile option is set,
_ x_ b_ o_ a_ r_ d loads
the specified position file at startup. If the
loadPositionIndex option is set to N, the _ Nth
position found in the file is loaded; otherwise the
first position is loaded.
- - - -s s s sp p p pf f f f o o o or r r r - - - s s s sa a a av v v ve e e eP P P Po o o os s s si i i it t t ti i i io o
o on n n nF F F Fi i i il l l le e e e f f f fi i i il l l le e e e
If this option is set, _ x_ b_ o_ a_ r_ d appends the
final
position reached in every game played to the
specified file.
- - - -o o o ol l l ld d d ds s s sa a a av v v ve e e e
o o o or r r r - - - o o o ol l l ld d d dS S S Sa a a av v v ve e e eS S S St t t ty y y yl l
l le e e e
If this option is False (the default),
_ x_ b_ o_ a_ r_ d saves
games in PGN (portable game notation) and positions
in FEN (Forsythe-Edwards notation). If the option
is True, a save style that is compatible with older
versions of _ x_ b_ o_ a_ r_ d is used instead.
Page 6
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U U Us s s se e e er r r r
I I I In n n nt t t te e e er r r rf f f fa a a ac c c ce e e e
O O O Op p p pt t t ti i i io o o on n n ns s s s
s s s st t t ta a a an n n nd d d da a a ar r r rd d d d
X X X Xt t t t o o o op p p pt t t ti i i io o o on n n ns s s s
_ x_ b_ o_ a_ r_ d accepts standard Xt options like display,
-geometry, and -iconic.
- - - -b b b be e e el l l ll l l l o o o or r r r - - - r r r ri i i in n n ng g g gB B B Be e e el l l ll l l lA A A Af f f ft t
t te e e er r r rM M M Mo o o ov v v ve e e es s s s
If this option is True, _ x_ b_ o_ a_ r_ d alerts you
by ringing
the terminal bell after each of your opponent's
moves (or after every move if you are observing a
game on the Internet Chess Server). The bell is not
rung after moves you make or moves read from a saved
game file. Default: False.
If you turn on this option when using
_ x_ b_ o_ a_ r_ d with
the Internet Chess Server, you will probably want to
give the "set bell 0" command to the ICS, since
otherwise the ICS will ring the bell itself after
every move (not just yours).
- - - -q q q qu u u ue e e ee e e en n n n o o o or r r r - - a a a al l l lw w w wa a a ay y y ys s s sP P P Pr r r ro o o om m m mo o
o ot t t te e e eT T T To o o oQ Q Q Qu u u ue e e ee e e en n n n
If this option is False (the default),
_ x_ b_ o_ a_ r_ d brings
up a dialog box whenever you move a pawn to the last
rank, asking what piece you want to promote it to.
If the option is True, your pawns are always
promoted to queens. (Your opponent can still
underpromote, however.)
b
(
M
S
b
(
M
S
b
(
M
S
bo
(L
Me
Sm
o
L
e
m
- - o oa
L La
e ed
m ma
-s s s si i i iz z z ze e e e o o o or r r r - - - a a ar r r rd d d dS S S Si i i iz z z ze e e e
a a ar r r rg g g ge e e e | | | |
d d di i i iu u u um m m m | | | |
a a al l l ll l l l) ) ) )
Determines how large the board will be and what
built-in piece bitmaps will be used. On a large
board (the default), pieces are 80x80 pixels, on a
medium board 64x64 pixels, and on a small board
40x40 pixels.
- - - -c c c co o o oo o o or r r rd d d ds s s s
o o o or r r r - - - s s s sh h h ho o o ow w w wC C C Co o o oo o o or r r rd d d ds s s s
If this option is True, _ x_ b_ o_ a_ r_ d displays
algebraic
coordinates along the board's left and bottom edges.
The default is False. The _ c_ o_ o_ r_ d_ F_ o_ n_ t
option
specifies what font to use.
- - - -f f f fl l l li i i ip p p p o o o or r r r - - - f f f fl l l li i i ip p p pV V V Vi i i ie e e ew w w w
If you are playing a game on the ICS, the board is
always oriented at the start of the game so that
your pawns move from the bottom of the window
towards the top. Otherwise, the starting is
determined by the flipView option; if it is False
(the default), White's pawns move from bottom to top
at the start of each game; if it is True, Black's
pawns move from bottom to top.
- - - -t t t ti i i it t t tl l l le e e e o o o or r r r - - t t t ti i i it t t tl l l le e e eI I I In n n nW W W Wi i i in n n nd d
d do o o ow w w w
If this option is True, _ x_ b_ o_ a_ r_ d displays
player names
Page 7
(printed 1/12/99)
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
(for ICS games) and game file names (for Load Game)
inside its main window. If the option is False (the
default), this information is displayed only in the
window banner. You probably won't want to set this
option unless the information is not showing up in
the banner, as happens with a few X window managers.
- - - -m m m mo o o on n n no o o o o o o or r r r - - - m m m mo o o on n n no o o oM M M Mo o o od d d de e e e
Determines whether _ x_ b_ o_ a_ r_ d displays its
pieces and
squares with two colors (True) or four (False). You
shouldn't have to specify monoMode; _ x_ b_ o_ a_ r_ d
will
determine if it is necessary.
- - - b b b bo o o or r r rd d d de e e er r r rX X X Xo o o of f f ff f f fs s
s se e e et t t t
- - - b b b bo o o or r r rd d d de e e er r r rY Y Y Yo o o of f f ff f f fs s
s se e e et t t t
These options are part of a kludge that helps
position the Comment and Edit Comment windows in the
same place on the screen when they are closed and
reopened. They should be set equal to the width and
height of the borders that your X window manager
adds to windows when it displays them. The defaults
are correct for _ t_ v_ t_ w_ m(1).
- - - c c c cl l l lo o o oc c c ck k k kF F F Fo o o on n n nt t t t
The font used for the clocks. If the option value
is a pattern that does not specify the font size,
_ x_ b_ o_ a_ r_ d tries to choose an appropriate font
for the
board size being used. Default: -*-helvetica-boldr-normal--*-*-*-*-*-*-*-*.
- - - c c c co o o oo o o or r r rd d d dF F F Fo o o on n n nt t t t
The font used for rank and file coordinate labels if
_ s_ h_ o_ w_ C_ o_ o_ r_ d_ s is True. If the option
value is a
pattern that does not specify the font size,
_ x_ b_ o_ a_ r_ d
tries to choose an appropriate font for the board
size being used. Default: -*-helvetica-bold-rnormal--*-*-*-*-*-*-*-*.
- - - -f f f fo o o on n n nt t t t
The font used for popup
dialogs, menus, comments,
etc. Default: -*-helvetica-medium-r-normal--*-100*-*-*-*-*-*.
Alternate bitmaps for piece icons can be specified either by
choosing one of the built-in sets or with the file name
options described below. There are three built-in sets of
piece bitmaps available, large (the default), medium, or
small.
- - - s s s so o o ol l l
i it t t tm m m ma
- - - s s s so o o ol l l
t tB B B Bi i i it
- - - s s s so o o ol l l
p pB B B Bi i i it
- - - s s s so o o ol l l
i it t t tm m m ma
li i i id d d dP P P Pa a a aw w w wn n n nB B B Bi i
a a ap p p p
li i i id d d dK K K Kn n n ni i i ig g g gh h h ht t
t t tm m m ma a a ap p p p
li i i id d d dB B B Bi i i is s s sh h h ho o o op p
t t tm m m ma a a ap p p p
li i i id d d dR R R Ro o o oo o o ok k k kB B B Bi i
a a ap p p p
Page 8
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
- - - s s s so o o ol l l li i i
B Bi i i it t t tm m m ma
- - - s s s so o o ol l l li i i
i it t t tm m m ma a a ap
Names of
id d d dQ Q Q Qu u u ue e e ee e e en n n nB B
a a ap p p p
id d d dK K K Ki i i in n n ng g g gB B B Bi i
p p p
the bitmap files for the solid piece icons.
- - - o o o ou u u ut t t tl l l li i i in n n ne e e eP P P Pa a a aw w
n nB B B Bi i i it t t tm m m ma a a ap p p p
- - - o o o ou u u ut t t tl l l li i i in n n ne e e eK K K Kn n n ni i
g gh h h ht t t tB B B Bi i i it t t tm m m ma a a ap p p p
- - - o o o ou u u ut t t tl l l li i i in n n ne e e eB B B Bi i i is s
h ho o o op p p pB B B Bi i i it t t tm m m ma a a ap p p p
- - - o o o ou u u ut t t tl l l li i i in n n ne e e eR R R Ro o o oo o
k kB B B Bi i i it t t tm m m ma a a ap p p p
- - - o o o ou u u ut t t tl l l li i i in n n ne e e eQ Q Q Qu u u ue e
e en n n nB B B Bi i i it t t tm m m ma a a ap p p p
- - - o o o ou u u ut t t tl l l li i i in n n ne e e eK K K Ki i i in n
g gB B B Bi i i it t t tm m m ma a a ap p p p
Names of the bitmap files for the outline piece
icons. These are used only in monochrome mode.
w wn n
i ig g
s sh h
o ok k
e ee e
n ng g
- - - w w w wh h h hi i i it t t te e e eP P P Pi i i ie e e ec c c ce e e eC C
C Co o o ol l l lo o o or r r r
Color specification for white pieces, suitable for
_ X_ P_ a_ r_ s_ e_ C_ o_ l_ o_ r(3X11). Default:
#FFFFCC. These colors
look good on a DEC workstation. If you need
different colors, try using the _ x_ c_ o_ l_ o_ r_ s
application.
Source for _ x_ c_ o_ l_ o_ r_ s can be found in the
X11 contrib
directory.
- - - b b b bl l l la a a ac c c ck k k kP P P Pi i i ie e e ec c c ce e e eC C
C Co o o ol l l lo o o or r r r
Same for black pieces. Default: #202020.
- - - l l l li i i ig g g gh h h ht t t tS S S Sq q q qu u u ua a a ar r r re e
e eC C C Co o o ol l l lo o o or r r r
Same for light squares. Default: #C8C365.
- - - d d d da a a ar r r rk k k kS S S Sq q q qu u u ua a a ar r r re e e eC C
C Co o o ol l l lo o o or r r r
Same for dark squares. Default: #77A26D.
If you are using a grayscale monitor, try setting the colors
to: -whitePieceColor
gray100 -blackPieceColor
gray0
-lightSquareColor
gray80 -darkSquareColor
gray60
O O O Ot t t th h h he e e er r r r
O O O Op p p pt t t ti i i io o o on n n ns s s s
- - - -n n n nc c c cp p p p o o o or r r r - - - n n n no o o oC C C Ch h h he e e es s s ss s s sP P P Pr r r ro o o og g
g gr r r ra a a am m m m
If this option is True, _ x_ b_ o_ a_ r_ d acts as a
passive
chessboard; it does not start a chess program at
all. Turning on this option also turns off
clockMode. Default: False.
- - - -d d d de e e eb b b bu u u ug g g g o o o or r r r - - -d d d de e e eb b b bu u u ug g g gM M M Mo o o od d d de e e e
Turns on debugging printout.
M M
C C C CO
B B B BU
A A A AN
M
O
U
N
ME E
O OM
U UT
N ND
All _
E EN N N NU U U U
M M MM M M MA A A AN N N ND D D DS S S S, , , ,
T T TT T T TO O O ON N N NS S S S, , , ,
D D D K K K KE E E EY Y Y YS S S S
x_ b_ o_ a_ r_ d commands are available on menus.
The
most
frequently used commands also have shortcut keys or onscreen buttons.
F F F Fi i i il l l le e e e M M M Me e e en n n nu u u u
R R R Re e e es s s se e e et t t t
Resets _ x_ b_ o_ a_ r_ d
and GNU Chess to the beginning of a
new chess game. The "r" key is a keyboard
Page 9
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
equivalent. In Internet Chess Server mode, clears
the current state of _ x_ b_ o_ a_ r_ d, then
resynchronizes
with ICS by sending a _ r_ e_ f_ r_ e_ s_ h command.
If you want
to stop playing, observing, or examining a game on
ICS, use an appropriate command from the Action
menu, not Reset.
L L L Lo o o oa a a ad d d d G G G Ga a a am m m me e e e
Plays a game from a record file. A popup dialog
prompts you for the file name. If the file contains
more than one game, and you want to load the _ Nth
one, type the number _ N after the file name,
separated by a space. The "g" key is a keyboard
equivalent.
The game file parser will accept PGN (portable game
notation), or in fact almost any file that contains
moves in algebraic notation. If the file includes a
PGN position (FEN tag), or an _ x_ b_ o_ a_ r_ d
position
diagram bracketed by "[--" and "--]" before the
first move, the game starts from that position.
Text enclosed in parentheses, square brackets, or
curly braces is assumed to be commentary and is
displayed in a pop-up window. Any other text in the
file is ignored. PGN variations (enclosed in
parentheses) are treated as comments;
_ x_ b_ o_ a_ r_ d is not
able to walk variation trees.
L L L Lo o o oa a a ad d d d N N N Ne e e ex x x xt t t t
G G G Ga a a am m m me e e e
Loads the next game from the last game record file
you loaded.
L L L Lo o o oa a a ad d d d
P P P Pr r r re e e ev v v vi i i io o o ou u u us s s s
G G G Ga a a am m m me e e e
Loads the previous game from the last game record
file you loaded.
R R R Re e e el l l lo o o oa a a ad d d d
S S S Sa a a am m m me e e e G G G Ga a a am m m me e e e
Reloads the last game you loaded.
L L L Lo o o oa a a ad d d d
P P P Po o o os s s si i i it t t ti i i io o o on n n n
Sets up a position from a position file. A popup
dialog prompts you for the file name. If the file
contains more than one saved position, and you want
to load the _ Nth one, type the number _ N after the
file name, separated by a space. Position files
must be in the format that the Save Position command
writes.
S S S Sa a a av v v ve e e e G G G Ga a a am m m me e e e
Appends a record of the current game to a file. A
popup dialog prompts you for the file name. If the
game did not begin with the standard starting
Page 10
G
1
0
x
x x
G GN
1 19
0 02
x xb
G
1
0
x
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
position, the game file includes the starting
position used. Games are saved in the PGN (portable
game notation) format, unless the oldSaveStyle
option is True, in which case they are saved in an
older format that is specific to _ x_ b_ o_ a_ r_ d.
Both
formats are human-readable, and both can be read
back by the Load Game command.
S S S Sa a a av v v ve e e e
P P P Po o o os s s si i i it t t ti i i io o o on n n n
Appends a diagram of the current position to a file.
A popup dialog prompts you for the file name.
Positions are saved in FEN (Forsythe-Edwards
notation) format unless the oldSaveStyle option is
True, in which case they are saved in an older,
human-readable format that is specific to
_ x_ b_ o_ a_ r_ d.
Both formats can be read back by the Load Position
command.
M M M Ma a a ai i i il l l l M M M Mo o o ov v v ve e e e
R R R Re e e el l l lo o o oa a a ad d d d
C C C CM M M Ma a a ai i i il l l l G G G Ga a a am m m me e e e
See the manual page for _ c_ m_ a_ i_ l(6).
E E E Ex x x xi i i it t t t
The "q" key is a keyboard
equivalent.
Exits from _ x_ b_ o_ a_ r_ d.
M M M Mo o o od d d de e e e M M M Me e e en n n nu u u u
P P P Pa a a au u u us s s se e e e
Pauses updates to the
board, and if you are playing
against GNU Chess, also pauses your clock. To
continue, select Pause again, and the display will
automatically update to the latest position. The
[P] button and keyboard "p" key are equivalents.
If you select Pause when you are playing against GNU
Chess and it is not your move, GNU Chess's clock
will continue to run and it will eventually make a
move, at which point both clocks will stop. Since
board updates are paused, however, you will not see
the move until you exit from Pause mode (or select
Forward). This behavior is meant to simulate
adjournment with a sealed move.
If you select Pause while you are in
_ e_ x_ a_ m_ i_ n_ e mode on
ICS, you can step backward and forward in the
current history of the examined game without
affecting the other observers and examiners. Select
Pause again to reconnect yourself to the current
state of the game on ICS.
If you select Pause while you are loading a game,
the game stops loading. You can load more moves
manually by selecting Forward, or resume automatic
loading by selecting Pause again.
Page 11
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
E E E Ed d d di i i it t t t
C C C Co o o om m m mm m m me e e en n n nt t t t
Adds or modifies a comment on the current position.
Comments are saved by Save Game and are displayed by
Load Game, Forward, and Backward.
M M M Ma a a ac c c ch h h hi i i in n n ne e e e
W W W Wh h h hi i i it t t te e e e
Forces GNU Chess to play white. GNU Chess mode
only.
M M M Ma a a ac c c ch h h hi i i in n n ne e e e
B B B Bl l l la a a ac c c ck k k k
Forces GNU Chess to play black. GNU Chess mode
only.
T T T Tw w w wo o o o
M M M Ma a a ac c c ch h h hi i i in n n ne e e es s s s
Plays a game between two computer programs.
Chess mode only.
GNU
I I I IC C C CS S S S
C C C Cl l l li i i ie e e en n n nt t t t
ICS mode only. Takes _ x_ b_ o_ a_ r_ d out of the
Edit Game or
Edit Position state.
E E E Ed d d di i i it t t t G G G Ga a a am m m me e e e
Allows you to make moves for both black and white,
and to change moves after backing up with the
Backward command. In GNU Chess mode, GNU chess
continues to check moves for legality but does not
participate in the game. You can bring GNU Chess
back into the game by selecting Machine White,
Machine Black, or Two Machines. In ICS mode, the
moves are not sent to the ICS. The clocks do not
run.
E E E Ed d d di i i it t t t
P P P Po o o os s s si i i it t t ti i i io o o on n n n
Lets you set up an arbitrary board position. Use
mouse button 1 to drag pieces to new squares, or to
delete a piece by dragging it off the board or
dragging an empty square on top of it. To drop a
new piece on a square, press mouse button 2 or 3
over the square. This brings up a menu of white
pieces (button 2) or black pieces (button 3).
Additional menu choices let you empty the square or
clear the board. You can set the side to play next
by clicking on the White or Black indicator at the
top of the screen.
A A A Ac c c ct t t ti i i io o o on n n n
M M M Me e e en n n nu u u u
A A A Ac c c cc c c ce e e ep p p pt t t t Accepts a pending
match offer from your opponent.
If there is more than one offer pending, you will
have to type in a more specific command instead of
using this menu choice. (ICS mode only)
D D D De e e ec c c cl l l li i i in n n ne e e e Declines a
pending offer (match, draw, adjourn,
Page 12
(printed 1/12/99)
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
etc.) from your opponent. If there is more than one
offer pending, you will have to type in a more
specific command instead of using this menu choice.
(ICS mode only)
C C C Ca a a al l l ll l l l F F F Fl l l la a a ag g g g
Calls your opponent's flag, claiming a win on time,
or claiming a draw if you are both out of time. You
can also call your opponent's flag by clicking on
his clock or by pressing the keyboard "t" key.
D D D Dr r r ra a a aw w w w
Offers a draw to your opponent,
accepts a pending
draw offer from your opponent, or claims a draw by
repetition or the 50-move rule, as appropriate. The
"d" key is a keyboard equivalent. (ICS mode only)
A A A Ad d d dj j j jo o o ou u u ur r r rn n n n Asks your
opponent to agree to adjourning the
current game, or agrees to a pending adjournment
offer from your opponent. (ICS mode only)
A A A Ab b b bo o o or r r rt t t t
Asks your opponent to
agree to aborting the current
game, or agrees to a pending abort offer from your
opponent. An aborted game ends immediately without
affecting either player's rating.
R R R Re e e es s s si i i ig g g gn n n n
your opponent. The shifted "R"
key is a keyboard equivalent.
Resigns the game to
S S S St t t to o o op p p p
O O O Ob b b bs s s se e e er r r rv v v vi i i in n n ng g g g
Ends your participation in observing a game, by
issuing the ICS _ o_ b_ s_ e_ r_ v_ e command with no
arguments.
(ICS mode only)
S S S St t t to o o op p p p
E E E Ex x x xa a a am m m mi i i in n n ni i i in n n ng g g g
Ends your participation in examining a game, by
issuing the ICS _ u_ n_ e_ x_ a_ m_ i_ n_ e command.
(ICS mode only)
S S S St t t te e e ep p p p M M M Me e e en n n nu u u u
B B B Ba a a ac c c ck k k kw w w wa a a ar r r rd d d d
Steps backward through a series of remembered moves.
The [<] button and the "b" key are equivalents.
In most modes, Backward only lets you look back at
old positions; it does not retract moves. This is
the case if you are playing against GNU Chess,
playing or observing a game on the ICS, or loading a
game. If you select Backward in any of these
situations, you will not be allowed to make a
different move. Use Retract Move or Edit Game if
you want to change past moves.
If you are examining a game on ICS, the behavior of
Page 13
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
Backward depends on whether _ x_ b_ o_ a_ r_ d is in
Pause mode.
If Pause mode is off, Backward issues the ICS
_ b_ a_ c_ k_ w_ a_ r_ d command, which backs up
everyone's view of
the game and allows you to make a different move.
If Pause mode is on, Backward only backs up your
local view.
F F F Fo o o or r r rw w w wa a a ar r r rd d d d Steps forward
through a series of remembered moves
(undoing the effect of Backward) or forward through
a game file. The [>] button and the f key are
equivalents.
If you are examining a game on ICS, the behavior of
Forward depends on whether _ x_ b_ o_ a_ r_ d is in
Pause mode.
If Pause mode is off, Forward issues the ICS
_ f_ o_ r_ w_ a_ r_ d
command, which moves everyone's view of the game
forward along the current line. If Pause mode is
on, Forward only moves your local view forward, and
it will not go past the position that the game was
in when you paused.
B B B Ba a a ac c c ck k k k t t t to o o o
S S S St t t ta a a ar r r rt t t t
Jumps backward to the first remembered position in
the game. The [<<] button and the shifted "B" key
are equivalents.
In most modes, Back to Start only lets you look back
at old positions; it does not retract moves. This
is the case if you are playing against GNU chess,
playing or observing a game on the ICS, or loading a
game. If you select Back to Start in any of these
situations, you will not be allowed to make
different moves. Use Retract Move or Edit Game if
you want to change past moves; or start a new game.
If you are examining a game on ICS, the behavior of
Back to Start depends on whether _ x_ b_ o_ a_ r_ d is
in Pause
mode. If Pause mode is off, Back to Start issues
the ICS _ b_ a_ c_ k_ w_ a_ r_ d _ 9_ 9_ 9_ 9_ 9_ 9
command, which backs up
everyone's view of the game to the start and allows
you to make different moves. If Pause mode is on,
Back to Start only backs up your local view.
F F F Fo o o or r r rw w w wa a a ar r r rd d d d
t t t to o o o E E E En n n nd d d d
Jumps forward to the last remembered position in the
game. The [>>] button and the shifted "F" key are
equivalents.
If you are examining a game on ICS, the behavior of
Forward to End depends on whether _ x_ b_ o_ a_ r_ d is
in Pause
mode. If Pause mode is off, Forward to End issues
the ICS _ f_ o_ r_ w_ a_ r_ d _ 9_ 9_ 9_ 9_ 9_ 9
command, which moves
Page 14
(printed 1/12/99)
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
everyone's view of the game forward to the end of
the current line. If Pause mode is on, Forward to
End only moves your local view forward, and it will
not go past the position that the game was in when
you paused.
R R R Re e e ev v v ve e e er r r rt t t t If you are
examining a game on ICS and Pause mode is
off, issues the ICS command _ r_ e_ v_ e_ r_ t.
T T T Tr r r ru u u un n n nc c c ca a a at t t te e e e
G G G Ga a a am m m me e e e
Discards all remembered moves of the game beyond the
current position. Puts _ x_ b_ o_ a_ r_ d into Edit
Game mode
if it was not there already.
M M M Mo o o ov v v ve e e e N N N No o o ow w w w
Forces GNU Chess to move immediately. (GNU Chess
mode only)
R R R Re e e et t t tr r r ra a a ac c c ct t t t
M M M Mo o o ov v v ve e e e
Retracts your last move. In GNU Chess mode, you can
do this only after GNU Chess has replied to your
move; if GNU Chess is still thinking, use Move Now
first. In ICS mode, Retract Move issues the command
_ t_ a_ k_ e_ b_ a_ c_ k _ 1 or
_ t_ a_ k_ e_ b_ a_ c_ k _ 2 depending on whether it is
your opponent's move or yours; however, this command
currently works only on FICS.
O O O Op p
M M M Me e e en
A A A
Q Q Q Qu u u ue
p pt t t ti i
n n nu u u u
Al l l lw w w
e e ee e e en
Toggles the
i io o o on n n ns s s s
wa a a ay y y ys s s s
n n n
alwaysPromoteToQueen option.
A A A Au u u ut t t to o o of f f fl l l la a a ag g g g
Toggles the autoCallFlag option.
A A A Au u u ut t t to o o os s s sa a a av v v ve e e e
Toggles the autoSaveGames option. Disabled if the
saveGameFile option is set, as in that case all
games are saved to the specified file.
B B B Be e e el l l ll l l l
Toggles the ringBellAfterMoves
option.
F F F Fl l l li i i ip p p p V V V Vi i i ie e e ew w w w
Inverts your view of the chess board for the
duration of the current game. Starting a new game
returns the board to normal.
If you are playing a game on the ICS, the board is
always oriented at the start of the game so that
your pawns move from the bottom of the window
towards the top. Otherwise, the starting
orientation is determined by the flipView command
line option; if it is False (the default), White's
Page 15
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
pawns move from bottom to top at the start of each
game; if it is True, Black's pawns move from bottom
to top.
O O O Ol l l ld d d d S S S Sa a a av v v ve e e e
S S S St t t ty y y yl l l le e e e
Toggles the oldSaveStyle option.
Q Q Q Qu u u ui i i ie e e et t t t
P P P Pl l l la a a ay y y y
Toggles the quietPlay option.
S S S Sh h h ho o o ow w w w
C C C Co o o oo o o or r r rd d d ds s s s
Toggles the showCoords option.
H H H He e e el l l lp p p p M M M Me e e en n n nu u u u
H H H Hi i i in n n nt t t t
Displays a move hint from GNU
Chess. GNU Chess mode
only.
A A A Ab b b bo o o ou u u ut t t t
G G G Ga a a am m m me e e e
Displays information about the current game, in the
form of PGN (portable game notation) tags.
A A A Ab b b bo o o ou u u ut t t t
X X X XB B B Bo o o oa a a ar r r rd d d d
Shows the current _ x_ b_ o_ a_ r_ d version number.
O O O Ot t t th h
s s s sh h h ho o o or
k k k ke e e ey y y ys
I I I Ic c c
i or c key iconifies _
h he e e er r r r
r r rt t t tc c c cu u u ut t t t
s s s
co o o on n n ni i i if f f fy y y y Pressing the
x_ b_ o_ a_ r_ d.
You can add more shortcut keys to _ x_ b_ o_ a_ r_ d using the
X
resource _ f_ o_ r_ m._ t_ r_ a_ n_ s_ l_ a_ t_ i_ o_ n_ s.
Here is an example of what
would go in your .Xdefaults file: XBoard*form.translations:
Shift<Key>?: AboutGameProc() \n \
<Key>y: AcceptProc() \n \
<Key>n: DeclineProc() The _ x_ b_ o_ a_ r_ d functions that
can be
bound to keys in this way are: AbortProc, AboutGameProc,
AboutProc, AcceptProc, AdjournProc, AlwaysQueenProc,
AutoflagProc, AutosaveProc, BackwardProc, BellProc,
CallFlagProc, DeclineProc, DrawProc, EditGameProc,
EditPositionProc, FlipViewProc, ForwardProc, HintProc,
IcsClientProc, LoadGameProc, LoadNextGameProc,
LoadPositionProc, LoadPrevGameProc, MachineBlackProc,
MachineWhiteProc, MailMoveProc, MoveNowProc,
OldSaveStyleProc, PauseProc, QuietPlayProc, QuitProc,
ReloadGameProc, ResetProc, ResignProc, RetractMoveProc,
RevertProc, SaveGameProc, SavePositionProc, ShowCoordsProc,
StopExaminingProc, StopObservingProc, ToEndProc,
ToStartProc, TruncateGameProc, and TwoMachinesProc.
E E E EN N N NV V V VI I I IR R R RO O O ON N N NM M M ME E E EN N N NT T
T T
Game and position files are found in the directory named by
the CHESSDIR environment variable. If this variable is not
set, the current working directory is used. If CHESSDIR is
set, _ x_ b_ o_ a_ r_ d actually changes its working directory
to
Page 16
(printed 1/12/99)
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
$CHESSDIR, so GNU Chess listing files will be stored there
as well.
F F F FI I I IL L L LE E E ES S S S
Whenever _ x_ b_ o_ a_ r_ d connects to the Internet Chess
Server, if it
finds a file called ".icsrc", it feeds the file's contents
to the ICS as commands. Usually the first two lines of the
file should be your ICS user name and password. The .icsrc
file can be either in $CHESSDIR, in _ x_ b_ o_ a_ r_ d's
working
directory if CHESSDIR is not set, or in your home directory.
S S S SE E E EE E E E A A A AL L L LS S S SO O O O
_ g_ n_ u_ c_ h_ e_ s_ s(6)
L L L LI I I IM M M MI I I IT T T TA A A AT T T TI I I IO O O ON N N NS S
S S
There is no way for two people running copies of
_ x_ b_ o_ a_ r_ d to
play each other without going through the Internet Chess
Server.
The game parser recognizes only algebraic notation.
The internal move legality tester does not look at the game
history, so in some cases it misses illegal castling or en
passant captures. However, if you attempt such a move when
using GNU Chess (or the ICS), it will reject the move, and
_ x_ b_ o_ a_ r_ d will undo it and let you try another. Also,
FEN
positions saved by _ x_ b_ o_ a_ r_ d do not include correct
information
about whether castling or en passant are legal.
In ICS mode, _ x_ b_ o_ a_ r_ d cannot handle observing (and/or
playing)
more than one game at a time. It may get confused if you
try to do this, though it tries to recover gracefully.
Select Reset from the File menu if you have problems.
Your password gets echoed when you log on to the ICS.
This
happens because _ x_ b_ o_ a_ r_ d does not implement the
telnet
protocol. Also, if useTelnet mode is set, every line you
type to the ICS gets echoed an extra time. This happens
because _ x_ b_ o_ a_ r_ d does not put the keyboard into raw
mode and
let the telnet program do all the echoing. (The details of
how to do so vary on different versions of Unix.)
The .icsrc file does not work properly when you connect to
ICS through a Unix gateway host with useTelnet mode. The
Unix login process apparently discards type-ahead.
Some _ x_ b_ o_ a_ r_ d functions may not work with versions of
GNU
Chess earlier than 4.0, patchlevel 52. In particular, with
GNU Chess 3.1 the timeControl option can be given only to
the nearest minute, restoring a saved position with black to
play may not work, and if you use the Backward button after
a mate or draw, the clocks are reset (because GNU Chess has
Page 17
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
exited and must be restarted).
A A A AU U U UT T T TH H H HO O O OR R R RS S S S
Original authors: Chris Sears and Dan Sears. Enhancements,
current maintainer: Tim Mann. Thanks to John Chanak for
the initial implementation of ICS mode. Thanks to Evan
Welsh for implementing _ c_ m_ a_ i_ l(6).
Send bug reports to <bug-gnu-chess@prep.ai.mit.edu>.
C C C CO O O OP P P PY Y Y YR R R RI I I IG G G GH H H HT T T T
Copyright 1991 by Digital Equipment Corporation, Maynard,
Massachusetts. Enhancements Copyright 1992-94 Free Software
Foundation, Inc.
XBoard borrows its colors, icon and piece bitmaps from
XChess, which was written and is copyrighted by Wayne
Christopher.
The following terms apply to Digital Equipment Corporation's
copyright interest in XBoard:
All Rights Reserved
Permission to use, copy, modify, and distribute this
software and its documentation for any purpose and
without fee is hereby granted, provided that the above
copyright notice appear in all copies and that both
that copyright notice and this permission notice appear
in supporting documentation, and that the name of
Digital not be used in advertising or publicity
pertaining to distribution of the software without
specific, written prior permission.
DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL DIGITAL
BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
THIS SOFTWARE.
The following terms apply to the enhanced version of XBoard
distributed by the Free Software Foundation:
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General
Public License as published by the Free Software
Foundation; either version 2 of the License, or (at
your option) any later version.
Page 18
G
1
0
x
G
1
0
x
x x
G GN
1 19
0 02
x xb
x
N
9
2
b
xb b
N NU
9 99
2 2:
b bo
(printed 1/12/99)
b
U
9
:
o
bo o o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
U U ( ( ( ($ $ $ $D D D Da a a at t t te e e e: : : :
9 94 4 4 4/ / / /0 0 0 05 5 5 5/ / / /2 2 2 22 2 2 2
: :2 2 2 23 3 3 3: : : :0 0 0 03 3 3 3 $ $ $ $) ) ) )
o oa a a ar r r rd d d d( ( ( (6 6 6 6) ) ) )
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General
Public License along with this program; if not, write
to the Free Software Foundation, Inc., 675 Mass Ave,
Cambridge, MA 02139, USA.
Page 19
(printed 1/12/99)