3 * xboard: (xboard). An X Window System graphical chessboard.
9 XBoard is a graphical chessboard that can serve as a user interface to
10 chess engines (such as GNU Chess), the Internet Chess Servers,
11 electronic mail correspondence chess, or your own collection of saved
14 This manual documents version 4.4.3 of XBoard.
19 XBoard always runs in one of four major modes. You select the major
20 mode from the command line when you start up XBoard.
23 As an interface to GNU Chess or another chess engine running on
24 your machine, XBoard lets you play a game against the machine, set
25 up arbitrary positions, force variations, watch a game between two
26 chess engines, interactively analyze your stored games or set up
27 and analyze arbitrary positions. (Note: Not all chess engines
30 xboard -ics -icshost hostname [options]
31 As Internet Chess Server (ICS) interface, XBoard lets you play
32 against other ICS users, observe games they are playing, or review
33 games that have recently finished. Most of the ICS "wild" chess
34 variants are supported, including bughouse.
37 XBoard can also be used simply as an electronic chessboard to play
38 through games. It will read and write game files and allow you to
39 play through variations manually. You can use it to browse games
40 off the net or review games you have saved. These features are
41 also available in the other modes.
44 If you want to pipe games into XBoard, use the supplied shell
45 script `pxboard'. For example, from the news reader `xrn', find a
46 message with one or more games in it, click the Save button, and
47 type `|pxboard' as the file name.
50 As an interface to electronic mail correspondence chess, XBoard
51 works with the cmail program. See *note CMail:: below for
54 2 Menus, buttons, and keys
55 **************************
57 To move a piece, you can drag it with the left mouse button, or you can
58 click the left mouse button once on the piece, then once more on the
59 destination square. To drop a new piece on a square (when applicable),
60 press the middle or the right mouse button over the square and select
61 from the pop-up menu. In cases where you can drop either a white or
62 black piece, use the middle button (or shift+right) for white and the
63 right button (or shift+middle) for black. When you are playing a
64 bughouse game on an Internet Chess Server, a list of the off-board
65 pieces that each player has available is shown in the window title
66 after the player's name; in addition, the piece menus show the number
67 of pieces available of each type. From version 4.3.14 on, it is also
68 possible in crazyhouse, bughouse or shogi to dag and drop pieces to the
69 board from the holdings squares displayed next to the board.
71 All other XBoard commands are available from the menu bar. The most
72 frequently used commands also have shortcut keys or on-screen buttons.
74 When XBoard is iconized, its graphical icon is a white knight if it
75 is White's turn to move, a black knight if it is Black's turn. See
76 Iconize in *note Keys:: below if you have problems getting this feature
83 Resets XBoard and the chess engine to the beginning of a new chess
84 game. The `r' key is a keyboard equivalent. In Internet Chess
85 Server mode, clears the current state of XBoard, then
86 resynchronizes with the ICS by sending a refresh command. If you
87 want to stop playing, observing, or examining an ICS game, use an
88 appropriate command from the Action menu, not `New Game'. *Note
92 Similar to `New Game', but allows you to specify a particular
93 initial position (according to a standardized numbering system) in
94 chess variants which use randomized opening positions (e.g.
95 Chess960). The selected opening position will persistently be
96 chosen on any following New Game command until you use this menu
97 to select another. Selecting position number -1 will produce a
98 newly randomized position on any new game. Using this menu item
99 in variants that normally do not shuffle their opening position
100 does cause these variants to become shuffle variants until you use
101 the `New Shuffle Game' menu to explicitly switch the randomization
102 off, or select a new variant.
105 Allows you to select a new chess variant in non-ICS mode. (In ICS
106 play, the ICS is responsible for deciding which variant will be
107 played, and XBoard adapts automatically.) If you play with an
108 engine, the engine must be able to play the selected variant, or
109 the command will be ignored. XBoard supports all major variants,
110 such as xiangqi, shogi, chess, chess960, Capablanca Chess,
111 shatranj, crazyhouse, bughouse. (But not every board size has
112 built-in bitmaps for un-orthodox pieces!)
115 Plays a game from a record file. The `g' key is a keyboard
116 equivalent. A pop-up dialog prompts you for the file name. If the
117 file contains more than one game, a second pop-up dialog displays
118 a list of games (with information drawn from their PGN tags, if
119 any), and you can select the one you want. Alternatively, you can
120 load the Nth game in the file directly, by typing the number `N'
121 after the file name, separated by a space.
123 The game file parser will accept PGN (portable game notation), or
124 in fact almost any file that contains moves in algebraic notation.
125 Notation of the form `P@f7' is accepted for piece-drops in
126 bughouse games; this is a nonstandard extension to PGN. If the
127 file includes a PGN position (FEN tag), or an old-style XBoard
128 position diagram bracketed by `[--' and `--]' before the first
129 move, the game starts from that position. Text enclosed in
130 parentheses, square brackets, or curly braces is assumed to be
131 commentary and is displayed in a pop-up window. Any other text in
132 the file is ignored. PGN variations (enclosed in parentheses) are
133 treated as comments; XBoard is not able to walk variation trees.
134 The nonstandard PGN tag [Variant "varname"] functions similarly to
135 the -variant command-line option (see below), allowing games in
136 certain chess variants to be loaded. There is also a heuristic to
137 recognize chess variants from the Event tag, by looking for the
138 strings that the Internet Chess Servers put there when saving
139 variant ("wild") games.
142 Loads the next game from the last game record file you loaded.
143 The shifted `N' key is a keyboard equivalent.
146 Loads the previous game from the last game record file you loaded.
147 The shifted `P' key is a keyboard equivalent. Not available if
148 the last game was loaded from a pipe.
151 Reloads the last game you loaded. Not available if the last game
152 was loaded from a pipe.
155 Appends a record of the current game to a file. A pop-up dialog
156 prompts you for the file name. If the game did not begin with the
157 standard starting position, the game file includes the starting
158 position used. Games are saved in the PGN (portable game notation)
159 format, unless the oldSaveStyle option is true, in which case they
160 are saved in an older format that is specific to XBoard. Both
161 formats are human-readable, and both can be read back by the `Load
162 Game' command. Notation of the form `P@f7' is accepted for
163 piece-drops in bughouse games; this is a nonstandard extension to
167 Copies a record of the current game to an internal clipboard in PGN
168 format and sets the X selection to the game text. The game can be
169 pasted to another application (such as a text editor or another
170 copy of XBoard) using that application's paste command. In many X
171 applications, such as xterm and emacs, the middle mouse button can
172 be used for pasting; in XBoard, you must use the Paste Game
176 Interprets the current X selection as a game record and loads it,
180 Sets up a position from a position file. A pop-up dialog prompts
181 you for the file name. If the file contains more than one saved
182 position, and you want to load the Nth one, type the number N
183 after the file name, separated by a space. Position files must be
184 in FEN (Forsythe-Edwards notation), or in the format that the Save
185 Position command writes when oldSaveStyle is turned on.
188 Loads the next position from the last position file you loaded.
190 Load Previous Position
191 Loads the previous position from the last position file you
192 loaded. Not available if the last position was loaded from a pipe.
195 Reloads the last position you loaded. Not available if the last
196 position was loaded from a pipe.
199 Appends a diagram of the current position to a file. A pop-up
200 dialog prompts you for the file name. Positions are saved in FEN
201 (Forsythe-Edwards notation) format unless the `oldSaveStyle'
202 option is true, in which case they are saved in an older,
203 human-readable format that is specific to XBoard. Both formats can
204 be read back by the `Load Position' command.
207 Copies the current position to an internal clipboard in FEN format
208 and sets the X selection to the position text. The position can
209 be pasted to another application (such as a text editor or another
210 copy of XBoard) using that application's paste command. In many X
211 applications, such as xterm and emacs, the middle mouse button can
212 be used for pasting; in XBoard, you must use the Paste Position
216 Interprets the current X selection as a FEN position and loads it,
217 as with Load Position.
224 Exits from XBoard. The shifted `Q' key is a keyboard equivalent.
230 Tells the chess engine to play White.
233 Tells the chess engine to play Black.
236 Plays a game between two chess engines.
239 XBoard tells the chess engine to start analyzing the current
240 game/position and shows you the analysis as you move pieces around.
241 Note: Some chess engines do not support Analysis mode.
243 To set up a position to analyze, you do the following:
245 1. Select Edit Position from the Mode Menu
247 2. Set up the position. Use the middle and right buttons to bring
248 up the white and black piece menus.
250 3. When you are finished, click on either the Black or White clock
251 to tell XBoard which side moves first.
253 4. Select Analysis Mode from the Mode Menu to start the analysis.
255 The analysis function can also be used when observing games on an
256 ICS with an engine loaded (zippy mode); the engine then will
257 analyse the positions as they occur in the observed game.
260 This option lets you load a game from a file (PGN, XBoard format,
261 etc.) and analyze it. When you select this menu item, a pop-up
262 window appears and asks for a file name to load. If the file
263 contains multiple games, another pop up appears that lets you
264 select which game you wish to analyze. After a game is loaded,
265 use the XBoard arrow buttons to step forwards/backwards through
266 the game and watch the analysis. Note: Some chess engines do not
267 support Analysis mode.
270 This is the normal mode when XBoard is connected to a chess
271 server. If you have moved into Edit Game or Edit Position mode,
272 you can select this option to get out.
274 To use xboard in ICS mode, run it in the foreground with the -ics
275 option, and use the terminal you started it from to type commands
276 and receive text responses from the chess server. See *note Chess
277 Servers:: below for more information.
279 XBoard activates some special position/game editing features when
280 you use the `examine' or `bsetup' commands on ICS and you have
281 `ICS Client' selected on the Mode menu. First, you can issue the
282 ICS position-editing commands with the mouse. Move pieces by
283 dragging with mouse button 1. To drop a new piece on a square,
284 press mouse button 2 or 3 over the square. This brings up a menu
285 of white pieces (button 2) or black pieces (button 3). Additional
286 menu choices let you empty the square or clear the board. Click
287 on the White or Black clock to set the side to play. You cannot
288 set the side to play or drag pieces to arbitrary squares while
289 examining on ICC, but you can do so in `bsetup' mode on FICS. In
290 addition, the menu commands `Forward', `Backward', `Pause', and
291 `Stop Examining' have special functions in this mode; see below.
294 Allows you to make moves for both Black and White, and to change
295 moves after backing up with the `Backward' command. The clocks do
298 In chess engine mode, the chess engine continues to check moves
299 for legality but does not participate in the game. You can bring
300 the chess engine into the game by selecting `Machine White',
301 `Machine Black', or `Two Machines'.
303 In ICS mode, the moves are not sent to the ICS: `Edit Game' takes
304 XBoard out of ICS Client mode and lets you edit games locally. If
305 you want to edit games on ICS in a way that other ICS users can
306 see, use the ICS `examine' command or start an ICS match against
310 Lets you set up an arbitrary board position. Use mouse button 1
311 to drag pieces to new squares, or to delete a piece by dragging it
312 off the board or dragging an empty square on top of it. To drop a
313 new piece on a square, press mouse button 2 or 3 over the square.
314 This brings up a menu of white pieces (button 2) or black pieces
315 (button 3). Additional menu choices let you empty the square or
316 clear the board. You can set the side to play next by clicking on
317 the word White or Black at the top of the screen. Selecting `Edit
318 Position' causes XBoard to discard all remembered moves in the
321 In ICS mode, changes made to the position by `Edit Position' are
322 not sent to the ICS: `Edit Position' takes XBoard out of `ICS
323 Client' mode and lets you edit positions locally. If you want to
324 edit positions on ICS in a way that other ICS users can see, use
325 the ICS `examine' command, or start an ICS match against yourself.
326 (See also the ICS Client topic above.)
329 Training mode lets you interactively guess the moves of a game for
330 one of the players. You guess the next move of the game by playing
331 the move on the board. If the move played matches the next move of
332 the game, the move is accepted and the opponent's response is
333 auto-played. If the move played is incorrect, an error message is
334 displayed. You can select this mode only while loading a game
335 (that is, after selecting `Load Game' from the File menu). While
336 XBoard is in `Training' mode, the navigation buttons are disabled.
339 Shows or hides the list of games generated by the last `Load Game'
343 Shows or hides a list of moves of the current game. This list
344 allows you to move the display to any earlier position in the game
345 by clicking on the corresponding move.
348 Shows or hides a window in which the thinking output of any loaded
349 engines is displayed.
352 Lets you edit the PGN (portable game notation) tags for the
353 current game. After editing, the tags must still conform to the
356 <tag-section> ::= <tag-pair> <tag-section>
358 <tag-pair> ::= [ <tag-name> <tag-value> ]
359 <tag-name> ::= <identifier>
360 <tag-value> ::= <string>
361 See the PGN Standard for full details. Here is an example:
363 [Event "Portoroz Interzonal"]
364 [Site "Portoroz, Yugoslavia"]
367 [White "Robert J. Fischer"]
368 [Black "Bent Larsen"]
370 Any characters that do not match this syntax are silently ignored.
371 Note that the PGN standard requires all games to have at least the
372 seven tags shown above. Any that you omit will be filled in by
373 XBoard with `?' (unknown value), or `-' (inapplicable value).
376 Adds or modifies a comment on the current position. Comments are
377 saved by `Save Game' and are displayed by `Load Game', `Forward',
381 If this option is set in ICS mode, XBoard creates an extra window
382 that you can use for typing in ICS commands. The input box is
383 especially useful if you want to type in something long or do some
384 editing on your input, because output from ICS doesn't get mixed
385 in with your typing as it would in the main terminal window.
388 Pauses updates to the board, and if you are playing against a
389 chess engine, also pauses your clock. To continue, select `Pause'
390 again, and the display will automatically update to the latest
391 position. The `P' button and keyboard `p' key are equivalents.
393 If you select Pause when you are playing against a chess engine and
394 it is not your move, the chess engine's clock will continue to run
395 and it will eventually make a move, at which point both clocks
396 will stop. Since board updates are paused, however, you will not
397 see the move until you exit from Pause mode (or select Forward).
398 This behavior is meant to simulate adjournment with a sealed move.
400 If you select Pause while you are observing or examining a game on
401 a chess server, you can step backward and forward in the current
402 history of the examined game without affecting the other observers
403 and examiners, and without having your display jump forward to the
404 latest position each time a move is made. Select Pause again to
405 reconnect yourself to the current state of the game on ICS.
407 If you select `Pause' while you are loading a game, the game stops
408 loading. You can load more moves manually by selecting `Forward',
409 or resume automatic loading by selecting `Pause' again.
415 Accepts a pending match offer. If there is more than one offer
416 pending, you will have to type in a more specific command instead
417 of using this menu choice.
420 Declines a pending offer (match, draw, adjourn, etc.). If there is
421 more than one offer pending, you will have to type in a more
422 specific command instead of using this menu choice.
425 Calls your opponent's flag, claiming a win on time, or claiming a
426 draw if you are both out of time. You can also call your
427 opponent's flag by clicking on his clock or by pressing the
431 Offers a draw to your opponent, accepts a pending draw offer from
432 your opponent, or claims a draw by repetition or the 50-move rule,
433 as appropriate. The `d' key is a keyboard equivalent.
436 Asks your opponent to agree to adjourning the current game, or
437 agrees to a pending adjournment offer from your opponent.
440 Asks your opponent to agree to aborting the current game, or
441 agrees to a pending abort offer from your opponent. An aborted
442 game ends immediately without affecting either player's rating.
445 Resigns the game to your opponent. The shifted `R' key is a
449 Ends your participation in observing a game, by issuing the ICS
450 observe command with no arguments. ICS mode only.
453 Ends your participation in examining a game, by issuing the ICS
454 unexamine command. ICS mode only.
459 Terminate an ongoing game in Two-Machines mode (including match
460 mode), with as result a win for white, for black, or a draw,
461 respectively. The PGN file of the game will accompany the result
462 string by the comment "user adjudication".
468 Steps backward through a series of remembered moves. The `[<]'
469 button and the `b' key are equivalents, as is turning the mouse
470 wheel towards you. In addition, pressing the Control key steps
471 back one move, and releasing it steps forward again.
473 In most modes, `Backward' only lets you look back at old positions;
474 it does not retract moves. This is the case if you are playing
475 against a chess engine, playing or observing a game on an ICS, or
476 loading a game. If you select `Backward' in any of these
477 situations, you will not be allowed to make a different move. Use
478 `Retract Move' or `Edit Game' if you want to change past moves.
480 If you are examining an ICS game, the behavior of `Backward'
481 depends on whether XBoard is in Pause mode. If Pause mode is off,
482 `Backward' issues the ICS backward command, which backs up
483 everyone's view of the game and allows you to make a different
484 move. If Pause mode is on, `Backward' only backs up your local
488 Steps forward through a series of remembered moves (undoing the
489 effect of `Backward') or forward through a game file. The `[>]'
490 button and the `f' key are equivalents, as is turning the mouse
493 If you are examining an ICS game, the behavior of Forward depends
494 on whether XBoard is in Pause mode. If Pause mode is off,
495 `Forward' issues the ICS forward command, which moves everyone's
496 view of the game forward along the current line. If Pause mode is
497 on, `Forward' only moves your local view forward, and it will not
498 go past the position that the game was in when you paused.
501 Jumps backward to the first remembered position in the game. The
502 `[<<]' button and the shifted `B' key are equivalents.
504 In most modes, Back to Start only lets you look back at old
505 positions; it does not retract moves. This is the case if you are
506 playing against a local chess engine, playing or observing a game
507 on a chess server, or loading a game. If you select `Back to
508 Start' in any of these situations, you will not be allowed to make
509 different moves. Use `Retract Move' or `Edit Game' if you want to
510 change past moves; or use Reset to start a new game.
512 If you are examining an ICS game, the behavior of `Back to Start'
513 depends on whether XBoard is in Pause mode. If Pause mode is off,
514 `Back to Start' issues the ICS `backward 999999' command, which
515 backs up everyone's view of the game to the start and allows you
516 to make different moves. If Pause mode is on, `Back to Start' only
517 backs up your local view.
520 Jumps forward to the last remembered position in the game. The
521 `[>>]' button and the shifted `F' key are equivalents.
523 If you are examining an ICS game, the behavior of `Forward to End'
524 depends on whether XBoard is in Pause mode. If Pause mode is off,
525 `Forward to End' issues the ICS `forward 999999' command, which
526 moves everyone's view of the game forward to the end of the
527 current line. If Pause mode is on, `Forward to End' only moves
528 your local view forward, and it will not go past the position that
529 the game was in when you paused.
532 If you are examining an ICS game and Pause mode is off, issues the
533 ICS command `revert'.
536 Discards all remembered moves of the game beyond the current
537 position. Puts XBoard into `Edit Game' mode if it was not there
541 Forces the chess engine to move immediately. Chess engine mode
545 Retracts your last move. In chess engine mode, you can do this only
546 after the chess engine has replied to your move; if the chess
547 engine is still thinking, use `Move Now' first. In ICS mode,
548 `Retract Move' issues the command `takeback 1' or `takeback 2'
549 depending on whether it is your opponent's move or yours.
555 Inverts your view of the chess board for the duration of the
556 current game. Starting a new game returns the board to normal.
557 The `v' key is a keyboard equivalent.
560 Pops up a sub-menu where you can enable or disable various
561 adjudications that XBoard can perform in engine-engine games. You
562 can instruct XBoard to detect and terminate the game on checkmate
563 or stalemate, even if the engines would not do so, to verify engine
564 result claims (forfeiting engines that make false claims), rather
565 than naively following the engine, to declare draw on positions
566 which can never be won for lack of mating material, (e.g. KBK), or
567 which are impossible to win unless the opponent seeks its own
568 demise (e.g. KBKN). For these adjudications to work, `Test
569 Legality' should be switched on. It is also possible to instruct
570 XBoard to enforce a 50-move or 3-fold-repeat rule and
571 automatically declare draw (after a user-adjustable number of moves
572 or repeats) even if the engines are prepared to go on. It is also
573 possible to have XBoard declare draw on games that seem to drag on
574 forever, or adjudicate a loss if both engines agree (for 3
575 consecutive moves) that one of them is behind more than a
576 user-adjustable score threshold. For the latter adjudication to
577 work, XBoard should be able to properly understand the engine's
578 scores. To facilitate the latter, you can inform xboard here if
579 the engines report scores from the viewpoint of white, or from
580 that of their own color.
583 Pops up a sub-menu where you can set some engine parameters common
584 to most engines, such as hash-table size, tablebase cache size,
585 maximum number of processors that SMP engines can use, and where
586 to find the Polyglot adapter needed to run UCI engines under
587 XBoard. The feature that allows setting of these parameters on
588 engines is new since XBoard 4.3.15, so not many XBoard/WinBoard
589 engines respond to it yet, but UCI engines should. It is also
590 possible to specify a GUI opening book here, i.e. an opening book
591 that XBoard consults for any position a playing engine gets in.
592 It then forces the engine to play the book move, rather than to
593 think up its own, if that position is found in the book. The book
594 can switched on and off independently for either engine.
597 Pops up a sub-menu where you can set the time-control parameters
598 interactively. Allows you to select classical or incremental time
599 controls, set the moves per session, session duration, and time
600 increment. Also allows specification of time-odds factors for one
601 or both engines. If an engine is given a time-odds factor N, all
602 time quota it gets, be it at the beginning of a session or through
603 the time increment or fixed time per move, will be divided by N.
606 If this option is off, XBoard brings up a dialog box whenever you
607 move a pawn to the last rank, asking what piece you want to
608 promote it to. If the option is true, your pawns are always
609 promoted to queens. Your opponent can still under-promote.
612 If Animate Dragging is on, while you are dragging a piece with the
613 mouse, an image of the piece follows the mouse cursor. If Animate
614 Dragging is off, there is no visual feedback while you are
615 dragging a piece, but if Animate Moving is on, the move will be
616 animated when it is complete.
619 If Animate Moving is on, all piece moves are animated. An image
620 of the piece is shown moving from the old square to the new square
621 when the move is completed (unless the move was already animated
622 by Animate Dragging). If Animate Moving is off, a moved piece
623 instantly disappears from its old square and reappears on its new
624 square when the move is complete.
627 If this option is on, any remarks made on ICS while you are
628 observing or playing a game are recorded as a comment on the
629 current move. This includes remarks made with the ICS commands
630 `say', `tell', `whisper', and `kibitz'. Limitation: remarks that
631 you type yourself are not recognized; XBoard scans only the output
632 from ICS, not the input you type to it.
635 If this option is on and one player runs out of time before the
636 other, XBoard will automatically call his flag, claiming a win on
637 time. In ICS mode, Auto Flag will only call your opponent's flag,
638 not yours, and the ICS may award you a draw instead of a win if
639 you have insufficient mating material. In local chess engine mode,
640 XBoard may call either player's flag and will not take material
644 If the Auto Flip View option is on when you start a game, the board
645 will be automatically oriented so that your pawns move from the
646 bottom of the window towards the top.
649 If this option is on and you add a player to your `gnotify' list
650 on ICS, XBoard will automatically observe all of that player's
651 games, unless you are doing something else (such as observing or
652 playing a game of your own) when one starts. The games are
653 displayed from the point of view of the player on your gnotify
654 list; that is, his pawns move from the bottom of the window
655 towards the top. Exceptions: If both players in a game are on
656 your gnotify list, if your ICS `highlight' variable is set to 0,
657 or if the ICS you are using does not properly support observing
658 from Black's point of view, you will see the game from White's
662 If this option is on, whenever a new game begins, the chessboard
663 window is deiconized (if necessary) and raised to the top of the
667 If this option is true, at the end of every game XBoard prompts
668 you for a file name and appends a record of the game to the file
669 you specify. Disabled if the `saveGameFile' command-line option
670 is set, as in that case all games are saved to the specified file.
671 *Note Load and Save options::.
674 If this option is on, XBoard displays the board as usual but does
675 not display pieces or move highlights. You can still move in the
676 usual way (with the mouse or by typing moves in ICS mode), even
677 though the pieces are invisible.
680 If this option is on, whenever a move is completed, the moved
681 piece flashes. The number of times to flash is set by the
682 flashCount command-line option; it defaults to 3 if Flash Moves is
683 first turned on from the menu.
685 If you are playing a game on an ICS, the board is always oriented
686 at the start of the game so that your pawns move from the bottom
687 of the window towards the top. Otherwise, the starting orientation
688 is determined by the `flipView' command line option; if it is
689 false (the default), White's pawns move from bottom to top at the
690 start of each game; if it is true, Black's pawns move from bottom
691 to top. *Note User interface options::.
694 If this option is on, whenever XBoard receives the first board of
695 a new ICS game (or a different game from the one it is currently
696 displaying), it retrieves the list of past moves from the ICS.
697 You can then review the moves with the `Forward' and `Backward'
698 commands or save them with `Save Game'. You might want to turn
699 off this option if you are observing several blitz games at once,
700 to keep from wasting time and network bandwidth fetching the move
701 lists over and over. When you turn this option on from the menu,
702 XBoard immediately fetches the move list of the current game (if
706 If Highlight Last Move is on, after a move is made, the starting
707 and ending squares remain highlighted. In addition, after you use
708 Backward or Back to Start, the starting and ending squares of the
709 last move to be unmade are highlighted.
712 If this option is on, XBoard alerts you by playing a sound after
713 each of your opponent's moves (or after every move if you are
714 observing a game on the Internet Chess Server). The sound is not
715 played after moves you make or moves read from a saved game file.
716 By default, the sound is the terminal bell, but on some systems
717 you can change it to a sound file using the soundMove option; see
720 If you turn on this option when using XBoard with the Internet
721 Chess Server, you will probably want to give the `set bell 0'
722 command to the ICS, since otherwise the ICS will ring the terminal
723 bell after every move (not just yours). (The `.icsrc' file is a
724 good place for this; see *note ICS options::.)
727 When this option is on, an alarm sound is played when your clock
728 counts down to the icsAlarmTime (by default, 5 seconds) in an ICS
729 game. For games with time controls that include an increment, the
730 alarm will sound each time the clock counts down to the
731 icsAlarmTime. By default, the alarm sound is the terminal bell,
732 but on some systems you can change it to a sound file using the
733 soundIcsAlarm option; see below.
736 If this option is off, XBoard saves games in PGN (portable game
737 notation) and positions in FEN (Forsythe-Edwards notation). If
738 the option is on, a save style that is compatible with older
739 versions of XBoard is used instead. The old position style is
740 more human-readable than FEN; the old game style has no particular
744 If this option is off (or if you are using a chess engine that
745 does not support periodic updates), the analysis window will only
746 be updated when the analysis changes. If this option is on, the
747 Analysis Window will be updated every two seconds.
750 If this option is off, the chess engine will think only when it is
751 on move. If the option is on, the engine will also think while
752 waiting for you to make your move.
755 If this option is on, when XBoard wants to display a message just
756 before exiting, it brings up a modal dialog box and waits for you
757 to click OK before exiting. If the option is off, XBoard prints
758 the message to standard error (the terminal) and exits immediately.
761 If this option is off, when you make an error in moving (such as
762 attempting an illegal move or moving the wrong color piece), the
763 error message is displayed in the message area. If the option is
764 on, move errors are displayed in small pop-up windows like other
765 errors. You can dismiss an error pop-up either by clicking its OK
766 button or by clicking anywhere on the board, including
767 down-clicking to start a move.
770 If this option is on while playing a game on an ICS, you can
771 register your next planned move before it is your turn. Move the
772 piece with the mouse in the ordinary way, and the starting and
773 ending squares will be highlighted with a special color (red by
774 default). When it is your turn, if your registered move is legal,
775 XBoard will send it to ICS immediately; if not, it will be ignored
776 and you can make a different move. If you change your mind about
777 your premove, either make a different move, or double-click on any
778 piece to cancel the move entirely.
781 If this option is on, XBoard will automatically issue an ICS `set
782 shout 0' command whenever you start a game and a `set shout 1'
783 command whenever you finish one. Thus, you will not be distracted
784 by shouts from other ICS users while playing.
787 If this option is on, XBoard displays algebraic coordinates along
788 the board's left and bottom edges.
791 If this option is off, the chess engine's notion of the score and
792 best line of play from the current position is displayed as it is
793 thinking. The score indicates how many pawns ahead (or if negative,
794 behind) the chess engine thinks it is. In matches between two
795 machines, the score is prefixed by `W' or `B' to indicate whether
796 it is showing White's thinking or Black's, and only the thinking
797 of the engine that is on move is shown.
800 If this option is on, XBoard tests whether the moves you try to
801 make with the mouse are legal and refuses to let you make an
802 illegal move. Moves loaded from a file with `Load Game' are also
803 checked. If the option is off, all moves are accepted, but if a
804 local chess engine or the ICS is active, they will still reject
805 illegal moves. Turning off this option is useful if you are
806 playing a chess variant with rules that XBoard does not
807 understand. (Bughouse, suicide, and wild variants where the king
808 may castle after starting on the d file are generally supported
809 with Test Legality on.)
815 Displays the XBoard documentation in info format. For this
816 feature to work, you must have the GNU info program installed on
817 your system, and the file `xboard.info' must either be present in
818 the current working directory, or have been installed by the `make
819 install' command when you built XBoard.
822 Displays the XBoard documentation in man page format. For this
823 feature to work, the file `xboard.6' must have been installed by
824 the `make install' command when you built XBoard, and the
825 directory it was placed in must be on the search path for your
826 system's `man' command.
829 Displays a move hint from the chess engine.
832 Displays a list of possible moves from the chess engine's opening
833 book. The exact format depends on what chess engine you are using.
834 With GNU Chess 4, the first column gives moves, the second column
835 gives one possible response for each move, and the third column
836 shows the number of lines in the book that include the move from
837 the first column. If you select this option and nothing happens,
838 the chess engine is out of its book or does not support this
842 Shows the current XBoard version number.
844 2.7 Other Shortcut Keys
845 =======================
848 Pressing the `i' or `c' key iconizes XBoard. The graphical icon
849 displays a white knight if it is White's move, or a black knight
850 if it is Black's move. If your X window manager displays only text
851 icons, not graphical ones, check its documentation; there is
852 probably a way to enable graphical icons. If you get black and
853 white reversed, we would like to hear about it; see *note
854 Problems:: below for instructions on how to report this problem.
856 You can add or remove shortcut keys using the X resources
857 `form.translations'. Here is an example of what would go in your
860 XBoard*form.translations: \
861 Shift<Key>?: AboutGameProc() \n\
862 <Key>y: AcceptProc() \n\
863 <Key>n: DeclineProc() \n\
864 <Key>i: NothingProc()
865 Binding a key to `NothingProc' makes it do nothing, thus removing it
866 as a shortcut key. The XBoard commands that can be bound to keys are:
868 AbortProc, AboutGameProc, AboutProc, AcceptProc, AdjournProc,
869 AlwaysQueenProc, AnalysisModeProc, AnalyzeFileProc,
870 AnimateDraggingProc, AnimateMovingProc, AutobsProc, AutoflagProc,
871 AutoflipProc, AutoraiseProc, AutosaveProc, BackwardProc,
872 BlindfoldProc, BookProc, CallFlagProc, CopyGameProc, CopyPositionProc,
873 DebugProc, DeclineProc, DrawProc, EditCommentProc, EditGameProc,
874 EditPositionProc, EditTagsProc, EnterKeyProc, FlashMovesProc,
875 FlipViewProc, ForwardProc, GetMoveListProc, HighlightLastMoveProc,
876 HintProc, Iconify, IcsAlarmProc, IcsClientProc, IcsInputBoxProc,
877 InfoProc, LoadGameProc, LoadNextGameProc, LoadNextPositionProc,
878 LoadPositionProc, LoadPrevGameProc, LoadPrevPositionProc,
879 LoadSelectedProc, MachineBlackProc, MachineWhiteProc, MailMoveProc,
880 ManProc, MoveNowProc, MoveSoundProc, NothingProc, OldSaveStyleProc,
881 PasteGameProc, PastePositionProc, PauseProc, PeriodicUpdatesProc,
882 PonderNextMoveProc, PopupExitMessageProc, PopupMoveErrorsProc,
883 PremoveProc, QuietPlayProc, QuitProc, ReloadCmailMsgProc,
884 ReloadGameProc, ReloadPositionProc, RematchProc, ResetProc,
885 ResignProc, RetractMoveProc, RevertProc, SaveGameProc,
886 SavePositionProc, ShowCoordsProc, ShowGameListProc, ShowThinkingProc,
887 StopExaminingProc, StopObservingProc, TestLegalityProc, ToEndProc,
888 ToStartProc, TrainingProc, TruncateGameProc, and TwoMachinesProc.
893 This section documents the command-line options to XBoard. You can set
894 these options in two ways: by typing them on the shell command line you
895 use to start XBoard, or by setting them as X resources (typically in
896 your `.Xresources' file). Many of the options cannot be changed while
897 XBoard is running; others set the initial state of items that can be
898 changed with the *note Options:: menu.
900 Most of the options have both a long name and a short name. To turn a
901 boolean option on or off from the command line, either give its long
902 name followed by the value true or false (`-longOptionName true'), or
903 give just the short name to turn the option on (`-opt'), or the short
904 name preceded by `x' to turn the option off (`-xopt'). For options that
905 take strings or numbers as values, you can use the long or short option
906 names interchangeably.
908 Each option corresponds to an X resource with the same name, so if
909 you like, you can set options in your `.Xresources' file or in a file
910 named `XBoard' in your home directory. For options that have two
911 names, the longer one is the name of the corresponding X resource; the
912 short name is not recognized. To turn a boolean option on or off as an
913 X resource, give its long name followed by the value true or false
914 (`XBoard*longOptionName: true').
916 3.1 Chess Engine Options
917 ========================
919 -tc or -timeControl minutes[:seconds]
920 Each player begins with his clock set to the `timeControl' period.
921 Default: 5 minutes. The additional options `movesPerSession' and
922 `timeIncrement' are mutually exclusive.
924 -mps or -movesPerSession moves
925 When both players have made `movesPerSession' moves, a new
926 `timeControl' period is added to both clocks. Default: 40 moves.
928 -inc or -timeIncrement seconds
929 If this option is specified, `movesPerSession' is ignored.
930 Instead, after each player's move, `timeIncrement' seconds are
931 added to his clock. Use `-inc 0' if you want to require the entire
932 game to be played in one `timeControl' period, with no increment.
933 Default: -1, which specifies `movesPerSession' mode.
935 -clock/-xclock or -clockMode true/false
936 Determines whether or not to display the chess clocks. If
937 clockMode is false, the clocks are not shown, but the side that is
938 to play next is still highlighted. Also, unless `searchTime' is
939 set, the chess engine still keeps track of the clock time and uses
940 it to determine how fast to make its moves.
942 -st or -searchTime minutes[:seconds]
943 Tells the chess engine to spend at most the given amount of time
944 searching for each of its moves. Without this option, the chess
945 engine chooses its search time based on the number of moves and
946 amount of time remaining until the next time control. Setting
947 this option also sets clockMode to false.
949 -depth or -searchDepth number
950 Tells the chess engine to look ahead at most the given number of
951 moves when searching for a move to make. Without this option, the
952 chess engine chooses its search depth based on the number of moves
953 and amount of time remaining until the next time control. With
954 the option, the engine will cut off its search early if it reaches
959 Tells the chess engine to use an internal time standard based on
960 its node count, rather then wall-clock time, to make its timing
961 decisions. The time in virtual seconds should be obtained by
962 dividing the node count through the given number, like the number
963 was a rate in nodes per second. Xboard will manage the clocks in
964 accordance with this, relying on the number of nodes reported by
965 the engine in its thinking output. If the given number equals zero,
966 it can obviously not be used to convert nodes to seconds, and the
967 time reported by the engine is used to decrement the XBoard clock
968 in stead. The engine is supposed to report in CPU time it uses,
969 rather than wall-clock time, in this mode. This option can provide
970 fairer conditions for engine-engine matches on heavily loaded
971 machines, or with very fast games (where the wall clock is too
972 inaccurate). `showThinking' must be on for this option to work.
973 Default: -1 (off). Not many engines might support this yet!
975 -firstTimeOdds factor
976 -secondTimeOdds factor
977 Reduces the time given to the mentioned engine by the given factor.
978 If pondering is off, the effect is indistinguishable from what
979 would happen if the engine was running on an n-times slower
983 This option determines how the case is handled where both engines
984 have a time-odds handicap. If mode=1, the engine that gets the
985 most time will always get the nominal time, as specified by the
986 time-control options, and its opponent's time is renormalized
987 accordingly. If mode=0, both play with reduced time. Default: 0.
989 -hideThinkingFromHuman true/false
990 Controls the Hide Thinking option. *Note Options Menu::. Default:
991 true. (Replaces the Show-Thinking option of older xboard
994 -thinking/-xthinking or -showThinking true/false
995 Forces the engine to send thinking output to xboard. Used to be
996 the only way to control if thinking output was displayed in older
997 xboard versions, but as the thinking output in xboard 4.3 is also
998 used for several other purposes (adjudication, storing in PGN
999 file) the display of it is now controlled by the new option Hide
1000 Thinking. *Note Options Menu::. Default: false. (But if xboard
1001 needs the thinking output for some purpose, it makes the engine
1002 send it despite the setting of this option.)
1004 -ponder/-xponder or -ponderNextMove true/false
1005 Sets the Ponder Next Move menu option. *Note Options Menu::.
1009 Specifies the maximum number of CPUs an SMP engine is allowed to
1010 use. Only works for engines that support the
1011 XBoard/WinBoard-protocol cores feature.
1013 -mg or -matchGames n
1014 Automatically runs an n-game match between two chess engines, with
1015 alternating colors. If the `loadGameFile' or `loadPositionFile'
1016 option is set, XBoard starts each game with the given opening
1017 moves or the given position; otherwise, the games start with the
1018 standard initial chess position. If the `saveGameFile' option is
1019 set, a move record for the match is appended to the specified
1020 file. If the `savePositionFile' option is set, the final position
1021 reached in each game of the match is appended to the specified
1022 file. When the match is over, XBoard displays the match score and
1023 exits. Default: 0 (do not run a match).
1025 -mm/-xmm or -matchMode true/false
1026 Setting `matchMode' to true is equivalent to setting `matchGames'
1030 Automatically runs an n-game match between two chess engines,
1031 without alternating colors. Otherwise the same applies as for the
1032 `-matchGames' option, over which it takes precedence if both are
1033 specified. (See there.) Default: 0 (do not run a match).
1035 -fcp or -firstChessProgram program
1036 Name of first chess engine. Default: `Fairy-Max'.
1038 -scp or -secondChessProgram program
1039 Name of second chess engine, if needed. A second chess engine is
1040 started only in Two Machines (match) mode. Default: `Fairy-Max'.
1042 -fb/-xfb or -firstPlaysBlack true/false
1043 In games between two chess engines, firstChessProgram normally
1044 plays white. If this option is true, firstChessProgram plays
1045 black. In a multi-game match, this option affects the colors only
1046 for the first game; they still alternate in subsequent games.
1048 -fh or -firstHost host
1049 -sh or -secondHost host
1050 Hosts on which the chess engines are to run. The default for each
1051 is `localhost'. If you specify another host, XBoard uses `rsh' to
1052 run the chess engine there. (You can substitute a different remote
1053 shell program for rsh using the `remoteShell' option described
1056 -fd or -firstDirectory dir
1057 -sd or -secondDirectory dir
1058 Working directories in which the chess engines are to be run. The
1059 default is "", which means to run the chess engine in the same
1060 working directory as XBoard itself. (See the CHESSDIR environment
1061 variable.) This option is effective only when the chess engine is
1062 being run on the local host; it does not work if the engine is run
1063 remotely using the -fh or -sh option.
1066 -secondInitString string
1067 The string that is sent to initialize each chess engine for a new
1072 Setting this option from the command line is tricky, because you
1073 must type in real newline characters, including one at the very
1074 end. In most shells you can do this by entering a `\' character
1075 followed by a newline. It is easier to set the option from your
1076 `.Xresources' file; in that case you can include the character
1077 sequence `\n' in the string, and it will be converted to a newline.
1079 If you change this option, don't remove the `new' command; it is
1080 required by all chess engines to start a new game.
1082 You can remove the `random' command if you like; including it
1083 causes GNU Chess 4 to randomize its move selection slightly so
1084 that it doesn't play the same moves in every game. Even without
1085 `random', GNU Chess 4 randomizes its choice of moves from its
1086 opening book. Many other chess engines ignore this command
1087 entirely and always (or never) randomize.
1089 You can also try adding other commands to the initString; see the
1090 documentation of the chess engine you are using for details.
1092 -firstComputerString string
1093 -secondComputerString string
1094 The string that is sent to the chess engine if its opponent is
1095 another computer chess engine. The default is `computer\n'.
1096 Probably the only useful alternative is the empty string (`'),
1097 which keeps the engine from knowing that it is playing another
1100 -reuse/-xreuse or -reuseFirst true/false
1101 -reuse2/-xreuse2 or -reuseSecond true/false
1102 If the option is false, XBoard kills off the chess engine after
1103 every game and starts it again for the next game. If the option
1104 is true (the default), XBoard starts the chess engine only once
1105 and uses it repeatedly to play multiple games. Some old chess
1106 engines may not work properly when reuse is turned on, but
1107 otherwise games will start faster if it is left on.
1109 -firstProtocolVersion version-number
1110 -secondProtocolVersion version-number
1111 This option specifies which version of the chess engine
1112 communication protocol to use. By default, version-number is 2.
1113 In version 1, the "protover" command is not sent to the engine;
1114 since version 1 is a subset of version 2, nothing else changes.
1115 Other values for version-number are not supported.
1117 -firstScoreAbs true/false
1118 -secondScoreAbs true/false
1119 If this option is set, the score reported by the engine is taken
1120 to be that in favor of white, even when the engine plays black.
1121 Important when XBoard uses the score for adjudications, or in PGN
1124 -niceEngines priority
1125 This option allows you to lower the priority of the engine
1126 processes, so that the generally insatiable hunger for CPU time of
1127 chess engines does not interfere so much with smooth operation of
1128 XBoard (or the rest of your system). Negative values could
1129 increase the engine priority, which is not recommended.
1131 -firstOptions string
1132 -secondOptions string
1133 The given string is a comma-separated list of (option name=option
1134 value) pairs, like the following example: "style=Karpov,blunder
1135 rate=0". If an option announced by the engine at startup through
1136 the feature commands of the XBoard/WinBoard protocol matches one
1137 of the option names (i.e. "style" or "blunder rate"), it would be
1138 set to the given value (i.e. "Karpov" or 0) through a
1139 corresponding option command to the engine. This provided that
1140 the type of the value (text or numeric) matches as well.
1142 -firstNeedsNoncompliantFEN string
1143 -secondNeedsNoncompliantFEN string
1144 The castling rights and e.p. fields of the FEN sent to the
1145 mentioned engine with the setboard command will be replaced by the
1146 given string. This can for instance be used to run engines that do
1147 not understand Chess960 FENs in variant fischerandom, to make them
1148 at least understand the opening position, through setting the
1149 string to "KQkq -". (Note you also have to give the e.p. field!)
1150 Other possible applications are to provide work-arounds for
1151 engines that want to see castling and e.p. fields in variants that
1152 do not have castling or e.p. (shatranj, courier, xiangqi, shogi)
1153 so that XBoard would normally omit them (string = "- -"), or to
1154 add variant-specific fields that are not yet supported by XBoard
1155 (e.g. to indicate the number of checks in 3check).
1157 3.2 UCI + WB Engine Settings
1158 ============================
1160 -fUCI or -firstIsUCI true/false
1161 -sUCI or -secondIsUCI true/false
1162 Indicates if the mentioned engine executable file is an UCI engine,
1163 and should be run with the aid of the Polyglot adapter rather than
1164 directly. Xboard will then pass the other UCI options and engine
1165 name to Polyglot through a .ini temporary file created for the
1168 -PolyglotDir filename
1169 Gives the name of the directory in which the Polyglot adapter for
1170 UCI engines expects its files. Default:
1171 "/usr/local/share/polyglot".
1173 -usePolyglotBook true/false
1174 Specifies if the Polyglot book should be used.
1176 -PolyglotBook filename
1177 Gives the filename of the opening book that Polyglot should use.
1178 From XBoard 4.3.15 on, native XBoard/WinBoard engines will also
1179 use the opening book specified here, provided the
1180 `usePolyglotBook' option is set to true, and the option
1181 `firstHasOwnBookUCI' or `secondHasOwnBookUCI' applying to the
1182 engine is set to false. The engine will be kept in force mode as
1183 long as the current position is in book, and XBoard will select
1184 the book moves for it. Default "".
1186 -fNoOwnBookUCI or -firstXBook or -firstHasOwnBookUCI true/false
1187 -sNoOwnBookUCI or -secondXBook or -secondHasOwnBookUCI true/false
1188 Indicates if the mentioned engine has its own opening book it
1189 should play from, rather than using the external book through
1190 XBoard. Default: false.
1193 Sets the size of the hash table to n MegaBytes. Together with the
1194 EGTB cache size this number is also used to calculate the memory
1195 setting of XBoard/WinBoard engines, for those that support the
1196 memory feature of the XBoard/WinBoard protocol. Default: 64.
1198 -defaultCacheSizeEGTB n
1199 Sets the size of the EGTB cache to n MegaBytes. Together with the
1200 hash-table size this number is also used to calculate the memory
1201 setting of XBoard/WinBoard engines, for those that support the
1202 memory feature of the XBoard/WinBoard protocol. Default: 4.
1204 -defaultPathEGTB filename
1205 Gives the name of the directory where the end-game tablebases are
1206 installed, for UCI engines. Default: "/usr/local/share/egtb".
1209 Specifies which end-game tables are installed on the computer, and
1210 where. The argument is a comma-separated list of format
1211 specifications, each specification consisting of a format name, a
1212 colon, and a directory path name, e.g.
1213 "nalimov:/usr/local/share/egtb". If the name part matches that of
1214 a format that the engine requests through a feature command,
1215 xboard will relay the path name for this format to the engine
1216 through an egtpath command. One egtpath command for each matching
1217 format will be sent. Popular formats are "nalimov" DTM tablebases
1218 and "scorpio" bitbases. Default: "".
1223 -ics/-xics or -internetChessServerMode true/false
1224 Connect with an Internet Chess Server to play chess against its
1225 other users, observe games they are playing, or review games that
1226 have recently finished. Default: false.
1228 -icshost or -internetChessServerHost host
1229 The Internet host name or address of the chess server to connect
1230 to when in ICS mode. Default: `chessclub.com'. Another popular
1231 chess server to try is `freechess.org'. If your site doesn't have
1232 a working Internet name server, try specifying the host address in
1233 numeric form. You may also need to specify the numeric address
1234 when using the icshelper option with timestamp or timeseal (see
1237 -icsport or -internetChessServerPort port-number
1238 The port number to use when connecting to a chess server in ICS
1239 mode. Default: 5000.
1241 -icshelper or -internetChessServerHelper prog-name
1242 An external helper program used to communicate with the chess
1243 server. You would set it to "timestamp" for ICC (chessclub.com) or
1244 "timeseal" for FICS (freechess.org), after obtaining the correct
1245 version of timestamp or timeseal for your computer. See "help
1246 timestamp" on ICC and "help timeseal" on FICS. This option is
1247 shorthand for `-useTelnet -telnetProgram program'.
1249 -telnet/-xtelnet or -useTelnet true/false
1250 This option is poorly named; it should be called useHelper. If
1251 set to true, it instructs XBoard to run an external program to
1252 communicate with the Internet Chess Server. The program to use is
1253 given by the telnetProgram option. If the option is false (the
1254 default), XBoard opens a TCP socket and uses its own internal
1255 implementation of the telnet protocol to communicate with the ICS.
1258 -telnetProgram prog-name
1259 This option is poorly named; it should be called helperProgram.
1260 It gives the name of the telnet program to be used with the
1261 `gateway' and `useTelnet' options. The default is `telnet'. The
1262 telnet program is invoked with the value of
1263 `internetChessServerHost' as its first argument and the value of
1264 `internetChessServerPort' as its second argument. *Note
1268 If this option is set to a host name, XBoard communicates with the
1269 Internet Chess Server by using `rsh' to run the `telnetProgram' on
1270 the given host, instead of using its own internal implementation
1271 of the telnet protocol. You can substitute a different remote shell
1272 program for `rsh' using the `remoteShell' option described below.
1275 -internetChessServerCommPort or -icscomm dev-name
1276 If this option is set, XBoard communicates with the ICS through
1277 the given character I/O device instead of opening a TCP connection.
1278 Use this option if your system does not have any kind of Internet
1279 connection itself (not even a SLIP or PPP connection), but you do
1280 have dial-up access (or a hardwired terminal line) to an Internet
1281 service provider from which you can telnet to the ICS.
1283 The support for this option in XBoard is minimal. You need to set
1284 all communication parameters and tty modes before you enter XBoard.
1286 Use a script something like this:
1288 stty raw -echo 9600 > /dev/tty00
1289 xboard -ics -icscomm /dev/tty00
1291 Here replace `/dev/tty00' with the name of the device that your
1292 modem is connected to. You might have to add several more options
1293 to these stty commands. See the man pages for `stty' and `tty' if
1294 you run into problems. Also, on many systems stty works on its
1295 standard input instead of standard output, so you have to use `<'
1298 If you are using linux, try starting with the script below.
1299 Change it as necessary for your installation.
1302 # configure modem and fire up XBoard
1306 stty 2400 ; stty raw ; stty hupcl ; stty -clocal
1307 stty ignbrk ; stty ignpar ; stty ixon ; stty ixoff
1308 stty -iexten ; stty -echo
1310 xboard -ics -icscomm /dev/modem
1311 After you start XBoard in this way, type whatever commands are
1312 necessary to dial out to your Internet provider and log in. Then
1313 telnet to ICS, using a command like `telnet chessclub.com 5000'.
1314 Important: See the paragraph below about extra echoes, in *note
1317 -icslogon or -internetChessServerLogonScript file-name
1318 Whenever XBoard connects to the Internet Chess Server, if it finds
1319 a file with the name given in this option, it feeds the file's
1320 contents to the ICS as commands. The default file name is `.icsrc'.
1321 Usually the first two lines of the file should be your ICS user
1322 name and password. The file can be either in $CHESSDIR, in
1323 XBoard's working directory if CHESSDIR is not set, or in your home
1327 If you experience trouble logging on to an ICS when using the
1328 `-icslogon' option, inserting some delay between characters of the
1329 logon script may help. This option adds `delay' milliseconds of
1330 delay between characters. Good values to try are 100 and 250.
1332 -icsinput/-xicsinput or -internetChessServerInputBox true/false
1333 Sets the ICS Input Box menu option. *Note Mode Menu::. Default:
1336 -autocomm/-xautocomm or -autoComment true/false
1337 Sets the Auto Comment menu option. *Note Options Menu::. Default:
1340 -autoflag/-xautoflag or -autoCallFlag true/false
1341 Sets the Auto Flag menu option. *Note Options Menu::. Default:
1344 -autobs/-xautobs or -autoObserve true/false
1345 Sets the Auto Observe menu option. *Note Options Menu::. Default:
1349 Enables kibitzing of the engines last thinking output (depth,
1350 score, time, speed, PV) before it moved to the ICS, in zippy mode.
1351 The option `showThinking' must be switched on for this option to
1352 work. Also diverts similar kibitz information of an opponent
1353 engine that is playing you through the ICS to the engine-output
1354 window, as if the engine was playing locally.
1356 -moves/-xmoves or -getMoveList true/false
1357 Sets the Get Move List menu option. *Note Options Menu::.
1360 -alarm/-xalarm or -icsAlarm true/false
1361 Sets the ICS Alarm menu option. *Note Options Menu::. Default:
1365 Sets the time in milliseconds for the ICS Alarm menu option.
1366 *Note Options Menu::. Default: 5000.
1368 lowTimeWarning true/false
1369 Controls a color change of the board as a warning your time is
1370 running out. *Note Options Menu::. Default: false.
1372 -pre/-xpre \fRor\fB -premove true/false
1373 Sets the Premove menu option. *Note Options Menu::. Default: true.
1375 -quiet/-xquiet or -quietPlay true/false
1376 Sets the Quiet Play menu option. *Note Options Menu::. Default:
1379 -colorizeMessages or -colorize
1380 Setting colorizeMessages to true tells XBoard to colorize the
1381 messages received from the ICS. Colorization works only if your
1382 xterm supports ISO 6429 escape sequences for changing text colors.
1384 -colorShout foreground,background,bold
1385 -colorSShout foreground,background,bold
1386 -colorChannel1 foreground,background,bold
1387 -colorChannel foreground,background,bold
1388 -colorKibitz foreground,background,bold
1389 -colorTell foreground,background,bold
1390 -colorChallege foreground,background,bold
1391 -colorRequest foreground,background,bold
1392 -colorSeek foreground,background,bold
1393 -colorNormal foreground,background,bold
1394 These options set the colors used when colorizing ICS messages.
1395 All ICS messages are grouped into one of these categories: shout,
1396 sshout, channel 1, other channel, kibitz, tell, challenge, request
1397 (including abort, adjourn, draw, pause, and takeback), or normal
1398 (all other messages).
1400 Each foreground or background argument can be one of the following:
1401 black, red, green, yellow, blue, magenta, cyan, white, or default.
1402 Here "default" means the default foreground or background color of
1403 your xterm. Bold can be 1 or 0. If background is omitted,
1404 "default" is assumed; if bold is omitted, 0 is assumed.
1406 Here is an example of how to set the colors in your `.Xresources'
1407 file. The colors shown here are the default values; you will get
1408 them if you turn `-colorize' on without specifying your own colors.
1410 xboard*colorizeMessages: true
1411 xboard*colorShout: green
1412 xboard*colorSShout: green, black, 1
1413 xboard*colorChannel1: cyan
1414 xboard*colorChannel: cyan, black, 1
1415 xboard*colorKibitz: magenta, black, 1
1416 xboard*colorTell: yellow, black, 1
1417 xboard*colorChallenge: red, black, 1
1418 xboard*colorRequest: red
1419 xboard*colorSeek: blue
1420 xboard*colorNormal: default
1422 -soundProgram progname
1423 If this option is set to a sound-playing program that is installed
1424 and working on your system, XBoard can play sound files when
1425 certain events occur, listed below. The default program name is
1426 "play". If any of the sound options is set to "$", the event
1427 rings the terminal bell by sending a ^G character to standard
1428 output, instead of playing a sound file. If an option is set to
1429 the empty string "", no sound is played for that event.
1431 -soundShout filename
1432 -soundSShout filename
1433 -soundChannel filename
1434 -soundKibitz filename
1436 -soundChallenge filename
1437 -soundRequest filename
1439 These sounds are triggered in the same way as the colorization
1440 events described above. They all default to "", no sound. They
1441 are played only if the colorizeMessages is on.
1444 This sound is used by the Move Sound menu option. Default: "$".
1446 -soundIcsAlarm filename
1447 This sound is used by the ICS Alarm menu option. Default: "$".
1449 -soundIcsWin filename
1450 This sound is played when you win an ICS game. Default: "" (no
1453 -soundIcsLoss filename
1454 This sound is played when you lose an ICS game. Default: "" (no
1457 -soundIcsDraw filename
1458 This sound is played when you draw an ICS game. Default: "" (no
1461 -soundIcsUnfinished filename
1462 This sound is played when an ICS game that you are participating
1463 in is aborted, adjourned, or otherwise ends inconclusively.
1464 Default: "" (no sound).
1466 Here is an example of how to set the sounds in your `.Xresources'
1469 xboard*soundShout: shout.wav
1470 xboard*soundSShout: sshout.wav
1471 xboard*soundChannel1: channel1.wav
1472 xboard*soundChannel: channel.wav
1473 xboard*soundKibitz: kibitz.wav
1474 xboard*soundTell: tell.wav
1475 xboard*soundChallenge: challenge.wav
1476 xboard*soundRequest: request.wav
1477 xboard*soundSeek: seek.wav
1478 xboard*soundMove: move.wav
1479 xboard*soundIcsWin: win.wav
1480 xboard*soundIcsLoss: lose.wav
1481 xboard*soundIcsDraw: draw.wav
1482 xboard*soundIcsUnfinished: unfinished.wav
1483 xboard*soundIcsAlarm: alarm.wav
1485 3.4 Load and Save options
1486 =========================
1488 -lgf or -loadGameFile file
1489 -lgi or -loadGameIndex index
1490 If the `loadGameFile' option is set, XBoard loads the specified
1491 game file at startup. The file name `-' specifies the standard
1492 input. If there is more than one game in the file, XBoard pops up
1493 a menu of the available games, with entries based on their PGN
1494 (Portable Game Notation) tags. If the `loadGameIndex' option is
1495 set to `N', the menu is suppressed and the N th game found in the
1496 file is loaded immediately. The menu is also suppressed if
1497 `matchMode' is enabled or if the game file is a pipe; in these
1498 cases the first game in the file is loaded immediately. Use the
1499 `pxboard' shell script provided with XBoard if you want to pipe in
1500 files containing multiple games and still see the menu. If the
1501 loadGameIndex specifies an index -1, this triggers auto-increment
1502 of the index in `matchMode', which means that after every game the
1503 index is incremented by one, causing each game of the match to be
1504 played from the next game in the file. Similarly, specifying an
1505 index value of -2 causes the index to be incremented every two
1506 games, so that each game in the file is used twice (with reversed
1507 colors). The `rewindIndex' option causes the index to be reset to
1508 the first game of the file when it has reached a specified value.
1511 Causes a position file or game file to be rewound to its beginning
1512 after n positions or games in auto-increment `matchMode'. See
1513 `loadPositionIndex' and `loadGameIndex'. default: 0 (no rewind).
1515 -td or -timeDelay seconds
1516 Time delay between moves during `Load Game'. Fractional seconds
1517 are allowed; try `-td 0.4'. A time delay value of -1 tells XBoard
1518 not to step through game files automatically. Default: 1 second.
1520 -sgf or -saveGameFile file
1521 If this option is set, XBoard appends a record of every game
1522 played to the specified file. The file name `-' specifies the
1525 -autosave/-xautosave or -autoSaveGames true/false
1526 Sets the Auto Save menu option. *Note Options Menu::. Default:
1527 false. Ignored if `saveGameFile' is set.
1529 -lpf or -loadPositionFile file
1530 -lpi or -loadPositionIndex index
1531 If the `loadPositionFile' option is set, XBoard loads the
1532 specified position file at startup. The file name `-' specifies the
1533 standard input. If the `loadPositionIndex' option is set to N, the
1534 Nth position found in the file is loaded; otherwise the first
1535 position is loaded. If the loadPositionIndex specifies an index
1536 -1, this triggers auto-increment of the index in `matchMode',
1537 which means that after every game the index is incremented by one,
1538 causing each game of the match to be played from the next position
1539 in the file. Similarly, specifying an index value of -2 causes the
1540 index to be incremented every two games, so that each position in
1541 the file is used twice (with the engines playing opposite colors).
1542 The `rewindIndex' option causes the index to be reset to the first
1543 position of the file when it has reached a specified value.
1545 -spf or -savePositionFile file
1546 If this option is set, XBoard appends the final position reached
1547 in every game played to the specified file. The file name `-'
1548 specifies the standard output.
1550 -pgnExtendedInfo true/false
1551 If this option is set, XBoard saves depth, score and time used for
1552 each move that the engine found as a comment in the PGN file.
1555 -pgnEventHeader string
1556 Sets the name used in the PGN event tag to string. Default:
1557 "Computer Chess Game".
1559 -saveOutOfBookInfo true/false
1560 Include the information on how the engine(s) game out of its
1561 opening book in a special 'annotator' tag with the PGN file.
1563 -oldsave/-xoldsave or -oldSaveStyle true/false
1564 Sets the Old Save Style menu option. *Note Options Menu::.
1567 -gameListTags string
1568 The character string lists the PGN tags that should be printed in
1569 the Game List, and their order. The meaning of the codes is
1570 e=event, s=site, d=date, o=round, p=players, r=result, w=white
1571 Elo, b=black Elo, t=time control, v=variant, a=out-of-book info.
1574 3.5 User interface options
1575 ==========================
1580 These and most other standard Xt options are accepted.
1583 Suppresses all GUI functions of XBoard (to speed up automated
1584 ultra-fast engine-engine games, which you donÂ’t want to watch).
1585 There will be no board or clock updates, no printing of moves, and
1586 no update of the icon on the task bar in this mode.
1588 -movesound/-xmovesound or -ringBellAfterMoves true/false
1589 Sets the Move Sound menu option. *Note Options Menu::. Default:
1590 false. For compatibility with old XBoard versions, -bell/-xbell
1591 are also accepted as abbreviations for this option.
1593 -exit/-xexit or -popupExitMessage true/false
1594 Sets the Popup Exit Message menu option. *Note Options Menu::.
1597 -popup/-xpopup or -popupMoveErrors true/false
1598 Sets the Popup Move Errors menu option. *Note Options Menu::.
1601 -queen/-xqueen or -alwaysPromoteToQueen true/false
1602 Sets the Always Queen menu option. *Note Options Menu::.
1605 -legal/-xlegal or -testLegality true/false
1606 Sets the Test Legality menu option. *Note Options Menu::.
1609 -size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)
1610 Determines how large the board will be, by selecting the pixel size
1611 of the pieces and setting a few related parameters. The sizeName
1612 can be one of: Titanic, giving 129x129 pixel pieces, Colossal
1613 116x116, Giant 108x108, Huge 95x95, Big 87x87, Large 80x80, Bulky
1614 72x72, Medium 64x64, Moderate 58x58, Average 54x54, Middling
1615 49x49, Mediocre 45x45, Small 40x40, Slim 37x37, Petite 33x33,
1616 Dinky 29x29, Teeny 25x25, or Tiny 21x21. Pieces of all these
1617 sizes are built into XBoard. Other sizes can be used if you have
1618 them; see the pixmapDirectory and bitmapDirectory options. The
1619 default depends on the size of your screen; it is approximately the
1620 largest size that will fit without clipping.
1622 You can select other sizes or vary other layout parameters by
1623 providing a list of comma-separated values (with no spaces) as the
1624 argument. You do not need to provide all the values; for any you
1625 omit from the end of the list, defaults are taken from the nearest
1626 built-in size. The value `n1' gives the piece size, `n2' the
1627 width of the black border between squares, `n3' the desired size
1628 for the clockFont, `n4' the desired size for the coordFont, `n5'
1629 the desired size for the default font, `n6' the smallLayout flag
1630 (0 or 1), and `n7' the tinyLayout flag (0 or 1). All dimensions
1631 are in pixels. If the border between squares is eliminated (0
1632 width), the various highlight options will not work, as there is
1633 nowhere to draw the highlight. If smallLayout is 1 and
1634 `titleInWindow' is true, the window layout is rearranged to make
1635 more room for the title. If tinyLayout is 1, the labels on the
1636 menu bar are abbreviated to one character each and the buttons in
1637 the button bar are made narrower.
1639 -coords/-xcoords or -showCoords true/false
1640 Sets the Show Coords menu option. *Note Options Menu::. Default:
1641 false. The `coordFont' option specifies what font to use.
1643 -autoraise/-xautoraise or -autoRaiseBoard true/false
1644 Sets the Auto Raise Board menu option. *Note Options Menu::.
1647 -autoflip/-xautoflip or -autoFlipView true/false
1648 Sets the Auto Flip View menu option. *Note Options Menu::.
1651 -flip/-xflip or -flipView true/false
1652 If Auto Flip View is not set, or if you are observing but not
1653 participating in a game, then the positioning of the board at the
1654 start of each game depends on the flipView option. If flipView is
1655 false (the default), the board is positioned so that the white
1656 pawns move from the bottom to the top; if true, the black pawns
1657 move from the bottom to the top. In any case, the Flip menu
1658 option (see *note Options Menu::) can be used to flip the board
1659 after the game starts.
1661 -title/-xtitle or -titleInWindow true/false
1662 If this option is true, XBoard displays player names (for ICS
1663 games) and game file names (for `Load Game') inside its main
1664 window. If the option is false (the default), this information is
1665 displayed only in the window banner. You probably won't want to
1666 set this option unless the information is not showing up in the
1667 banner, as happens with a few X window managers.
1669 -buttons/-xbuttons or -showButtonBar True/False
1670 If this option is False, xboard omits the [<<] [<] [P] [>] [>>]
1671 button bar from the window, allowing the message line to be wider.
1672 You can still get the functions of these buttons using the menus
1673 or their keyboard shortcuts. Default: true.
1675 -mono/-xmono or -monoMode true/false
1676 Determines whether XBoard displays its pieces and squares with two
1677 colors (true) or four (false). You shouldn't have to specify
1678 `monoMode'; XBoard will determine if it is necessary.
1683 These options enable flashing of pieces when they land on their
1684 destination square. `flashCount' tells XBoard how many times to
1685 flash a piece after it lands on its destination square.
1686 `flashRate' controls the rate of flashing (flashes/sec).
1687 Abbreviations: `flash' sets flashCount to 3. `xflash' sets
1688 flashCount to 0. Defaults: flashCount=0 (no flashing),
1691 -highlight/-xhighlight or -highlightLastMove true/false
1692 Sets the Highlight Last Move menu option. *Note Options Menu::.
1695 -blind/-xblind or -blindfold true/false
1696 Sets the Blindfold menu option. *Note Options Menu::. Default:
1700 The font used for the clocks. If the option value is a pattern
1701 that does not specify the font size, XBoard tries to choose an
1702 appropriate font for the board size being used. Default:
1703 -*-helvetica-bold-r-normal-*-*-*-*-*-*-*-*.
1706 The font used for rank and file coordinate labels if `showCoords'
1707 is true. If the option value is a pattern that does not specify
1708 the font size, XBoard tries to choose an appropriate font for the
1709 board size being used. Default:
1710 -*-helvetica-bold-r-normal-*-*-*-*-*-*-*-*.
1713 The font used for popup dialogs, menus, comments, etc. If the
1714 option value is a pattern that does not specify the font size,
1715 XBoard tries to choose an appropriate font for the board size
1716 being used. Default: -*-helvetica-medium-r-normal-*-*-*-*-*-*-*-*.
1718 -fontSizeTolerance tol
1719 In the font selection algorithm, a nonscalable font will be
1720 preferred over a scalable font if the nonscalable font's size
1721 differs by `tol' pixels or less from the desired size. A value of
1722 -1 will force a scalable font to always be used if available; a
1723 value of 0 will use a nonscalable font only if it is exactly the
1724 right size; a large value (say 1000) will force a nonscalable font
1725 to always be used if available. Default: 4.
1727 -bm or -bitmapDirectory dir
1728 -pixmap or -pixmapDirectory dir
1729 These options control what piece images xboard uses. The XBoard
1730 distribution includes one set of pixmap pieces in xpm format, in
1731 the directory `pixmaps', and one set of bitmap pieces in xbm
1732 format, in the directory `bitmaps'. Pixmap pieces give a better
1733 appearance on the screen: the white pieces have dark borders, and
1734 the black pieces have opaque internal details. With bitmaps,
1735 neither piece color has a border, and the internal details are
1736 transparent; you see the square color or other background color
1739 If XBoard is configured and compiled on a system that includes
1740 libXpm, the X pixmap library, the xpm pixmap pieces are compiled
1741 in as the default. A different xpm piece set can be selected at
1742 runtime with the `pixmapDirectory' option, or a bitmap piece set
1743 can be selected with the `bitmapDirectory' option.
1745 If XBoard is configured and compiled on a system that does not
1746 include libXpm (or the `--disable-xpm' option is given to the
1747 configure program), the bitmap pieces are compiled in as the
1748 default. It is not possible to use xpm pieces in this case, but
1749 pixmap pieces in another format called "xim" can be used by giving
1750 the `pixmapDirectory' option. Or again, a different bitmap piece
1751 set can be selected with the `bitmapDirectory' option.
1753 Files in the `bitmapDirectory' must be named as follows: The first
1754 character of a piece bitmap name gives the piece it represents
1755 (`p', `n', `b', `r', `q', or `k'), the next characters give the
1756 size in pixels, the following character indicates whether the
1757 piece is solid or outline (`s' or `o'), and the extension is `.bm'.
1758 For example, a solid 80x80 knight would be named `n80s.bm'. The
1759 outline bitmaps are used only in monochrome mode. If bitmap
1760 pieces are compiled in and the bitmapDirectory is missing some
1761 files, the compiled in pieces are used instead.
1763 If the bitmapDirectory option is given, it is also possible to
1764 replace xboard's icons and menu checkmark, by supplying files
1765 named `icon_white.bm', `icon_black.bm', and `checkmark.bm'.
1767 For more information about pixmap pieces and how to get additional
1768 sets, see *note zic2xpm:: below.
1770 -whitePieceColor color
1771 -blackPieceColor color
1772 -lightSquareColor color
1773 -darkSquareColor color
1774 -highlightSquareColor color
1775 -lowTimeWarningColor color
1776 Colors to use for the pieces, squares, and square highlights.
1779 -whitePieceColor #FFFFCC
1780 -blackPieceColor #202020
1781 -lightSquareColor #C8C365
1782 -darkSquareColor #77A26D
1783 -highlightSquareColor #FFFF00
1784 -premoveHighlightColor #FF0000
1785 -lowTimeWarningColor #FF0000
1787 On a grayscale monitor you might prefer:
1789 -whitePieceColor gray100
1790 -blackPieceColor gray0
1791 -lightSquareColor gray80
1792 -darkSquareColor gray60
1793 -highlightSquareColor gray100
1794 -premoveHighlightColor gray70
1795 -lowTimeWarningColor gray70
1797 -drag/-xdrag or -animateDragging true/false
1798 Sets the Animate Dragging menu option. *Note Options Menu::.
1801 -animate/-xanimate or -animateMoving true/false
1802 Sets the Animate Moving menu option. *Note Options Menu::.
1806 Number of milliseconds delay between each animation frame when
1807 Animate Moves is on.
1809 -autoDisplayComment true/false
1810 -autoDisplayTags true/false
1811 If set to true, these options cause the window with the move
1812 comments, and the window with PGN tags, respectively, to pop up
1813 automatically when such tags or comments are encountered during
1814 the replaying a stored or loaded game. Default: true.
1816 -pasteSelection true/false
1817 If this option is set to true, the Paste Position and Paste Game
1818 options paste from the currently selected text. If false, they
1819 paste from the clipboard. Default: false.
1821 3.6 Adjudication Options
1822 ========================
1824 -adjudicateLossThreshold n
1825 If the given value is non-zero, XBoard adjudicates the game as a
1826 loss if both engines agree for a duration of 6 consecutive ply
1827 that the score is below the given score threshold for that engine.
1828 Make sure the score is interpreted properly by XBoard, using
1829 `-firstScoreAbs' and `-secondScoreAbs' if needed. Default: 0 (no
1832 -adjudicateDrawMoves n
1833 If the given value is non-zero, XBoard adjudicates the game as a
1834 draw if after the given number of moves it was not yet decided.
1835 Default: 0 (no adjudication)
1837 -checkMates true/false
1838 If this option is set, XBoard detects all checkmates and
1839 stalemates, and ends the game as soon as they occur.
1840 Legality-testing must be switched on for this option to work.
1843 -testClaims true/false
1844 If this option is set, XBoard verifies all result claims made by
1845 engines, and those who send false claims will forfeit the game
1846 because of it. Legality-testing must be switched on for this
1847 option to work. Default: true
1849 -materialDraws true/false
1850 If this option is set, XBoard adjudicates games as draws when
1851 there is no sufficient material left to inflict a checkmate. This
1852 applies to KBKB with like bishops (any number, actually), and to
1853 KBK, KNK and KK. Legality-testing must be switched on for this
1854 option to work. Default: true
1856 -trivialDraws true/false
1857 If this option is set, XBoard adjudicates games as draws that
1858 cannot be usually won without opponent cooperation. This applies
1859 to KBKB with unlike bishops, and to KBKN, KNKN, KNNK, KRKR and
1860 KQKQ. The draw is called after 6 ply into these end-games, to
1861 allow quick mates that can occur in some exceptional positions to
1862 be found by the engines. KQKQ does not really belong in this
1863 category, and might be taken out in the future. (When
1864 bitbase-based adjudications are implemented.) Legality-testing
1865 must be on for this option to work. Default: false
1868 If the given value is non-zero, XBoard adjudicates the game as a
1869 draw after the given number of consecutive reversible moves.
1870 Engine draw claims are always accepted after 50 moves,
1871 irrespective of the given value of n.
1874 If the given value is non-zero, xboard adjudicates the game as a
1875 draw if a position is repeated the given number of times. Engines
1876 draw claims are always accepted after 3 repeats, (on the 3rd
1877 occurrence, actually), irrespective of the value of n. Beware
1878 that positions that have different castling or en-passant rights
1879 do not count as repeats, XBoard is fully e.p. and castling aware!
1884 -ncp/-xncp or -noChessProgram true/false
1885 If this option is true, XBoard acts as a passive chessboard; it
1886 does not start a chess engine at all. Turning on this option also
1887 turns off clockMode. Default: false.
1889 -mode or -initialMode modename
1890 If this option is given, XBoard selects the given modename from
1891 the Mode menu after starting and (if applicable) processing the
1892 loadGameFile or loadPositionFile option. Default: "" (no
1893 selection). Other supported values are MachineWhite,
1894 MachineBlack, TwoMachines, Analysis, AnalyzeFile, EditGame,
1895 EditPosition, and Training.
1898 Activates preliminary, partial support for playing chess variants
1899 against a local engine or editing variant games. This flag is not
1900 needed in ICS mode. Recognized variant names are:
1903 wildcastle Shuffle chess, king can castle from d file
1904 nocastle Shuffle chess, no castling allowed
1905 fischerandom Fischer Random shuffle chess
1906 bughouse Bughouse, ICC/FICS rules
1907 crazyhouse Crazyhouse, ICC/FICS rules
1908 losers Lose all pieces or get mated (ICC wild 17)
1909 suicide Lose all pieces including king (FICS)
1910 giveaway Try to have no legal moves (ICC wild 26)
1911 twokings Weird ICC wild 9
1912 kriegspiel Opponent's pieces are invisible
1913 atomic Capturing piece explodes (ICC wild 27)
1914 3check Win by giving check 3 times (ICC wild 25)
1915 shatranj An ancient precursor of chess (ICC wild 28)
1916 xiangqi Chinese Chess (on a 9x10 board)
1917 shogi Japanese Chess (on a 9x9 board & piece drops)
1918 capablanca Capablanca Chess (10x8 board, with Archbishop
1919 and Chancellor pieces)
1920 gothic similar, with a better initial position
1921 caparandom An FRC-like version of Capablanca Chess (10x8)
1922 janus A game with two Archbishops (10x8 board)
1923 courier Medieval intermediate between shatranj and
1924 modern Chess (on 12x8 board)
1925 falcon Patented 10x8 variant with two Falcon pieces
1926 berolina Pawns capture straight ahead, and move diagonal
1927 cylinder Pieces wrap around the board edge
1928 knightmate King moves as Knight, and vice versa
1929 super Superchess (shuffle variant with 4 exo-pieces)
1930 makruk Thai Chess (shatranj-like, P promotes on 6th rank)
1931 fairy A catchall variant in which all piece types
1932 known to XBoard can participate (8x8)
1933 unknown Catchall for other unknown variants
1935 NOT ALL BOARDSIZES PROVIDE A COMPLETE SET OF BUILT-IN BITMAPS FOR
1936 ALL UN-ORTHODOX PIECES, though. Only in `boardSize' middling and
1937 bulky all 22 piece types are provided, while -boardSize petite has
1938 most of them. Archbishop, Chancellor and Amazon are supported in
1939 every size from petite to bulky. Kings or Amazons are substituted
1940 for missing bitmaps. You can still play variants needing
1941 un-orthodox pieces in other board sizes providing your own bitmaps
1942 through the `bitmapDirectory' or `pixmapDirectory' options.
1944 In the shuffle variants, XBoard now does shuffle the pieces,
1945 although you can still do it by hand using Edit Position. Some
1946 variants are supported only in ICS mode, including bughouse, and
1947 kriegspiel. The winning/drawing conditions in crazyhouse
1948 (off-board interposition on mate) are not fully understood, but
1949 losers, suicide, giveaway, atomic, and 3check should be OK.
1950 Berolina and cylinder chess can only be played with legality
1951 testing off. In crazyhouse, XBoard now does keep track of
1952 off-board pieces. In shatranj it does implement the baring rule
1953 when mate detection is switched on.
1956 Allows you to set a non-standard number of board ranks in any
1957 variant. If the height is given as -1, the default height for the
1958 variant is used. Default: -1
1961 Allows you to set a non-standard number of board files in any
1962 variant. If the width is given as -1, the default width for the
1963 variant is used. With a non-standard width, the initial position
1964 will always be an empty board, as the usual opening array will not
1968 Allows you to set a non-standard size for the holdings in any
1969 variant. If the size is given as -1, the default holdings size
1970 for the variant is used. The first N piece types will go into the
1971 holdings on capture, and you will be able to drop them on the
1972 board in stead of making a normal move. If size equals 0, there
1973 will be no holdings. Default: -1
1975 -defaultFrcPosition N
1976 Specifies the number of the opening position in shuffle games like
1977 Chess960. A value of -1 means the position is randomly generated
1978 by XBoard at the beginning of every game. Default: -1
1980 -pieceToCharTable string
1981 The characters that are used to represent the piece types XBoard
1982 knows in FEN diagrams and SAN moves. The string argument has to
1983 have an even length (or it will be ignored), as white and black
1984 pieces have to be given separately (in that order). The last
1985 letter for each color will be the King. The letters before that
1986 will be PNBRQ and then a whole host of fairy pieces in an order
1987 that has not fully crystallized yet (currently FEACWMOHIJGDVSLU,
1988 F=Ferz, Elephant, A=Archbishop, C=Chancellor, W=Wazir, M=Commoner,
1989 O=Cannon, H=Nightrider). You should list at least all pieces that
1990 occur in the variant you are playing. If you have less than 44
1991 characters in the string, the pieces not mentioned will get
1992 assigned a period, and you will not be able to distinguish them in
1993 FENs. You can also explicitly assign pieces a period, in which
1994 case they will not be counted in deciding which captured pieces
1995 can go into the holdings. A tilde '~' as a piece name does mean
1996 this piece is used to represent a promoted Pawn in crazyhouse-like
1997 games, i.e. on capture it turns back onto a Pawn. A '+' similarly
1998 indicates the piece is a shogi-style promoted piece, that should
1999 revert to its non-promoted version on capture (rather than to a
2000 Pawn). Note that promoted pieces are represented by pieces 11
2001 further in the list. You should not have to use this option
2002 often: each variant has its own default setting for the piece
2003 representation in FEN, which should be sufficient in normal use.
2006 -debug/-xdebug or -debugMode true/false
2007 Turns on debugging printout.
2009 -debugFile filename or -nameOfDebugFile filename
2010 Sets the name of the file to which XBoard saves debug information
2011 (including all communication to and from the engines).
2013 -engineDebugOutput number
2014 Specifies how XBoard should handle unsolicited output from the
2015 engine, with respect to saving it in the debug file. The output
2016 is further (hopefully) ignored. If number=0, XBoard refrains from
2017 writing such spurious output to the debug file. If number=1, all
2018 engine output is written faithfully to the debug file. If
2019 number=2, any protocol-violating line is prefixed with a '#'
2020 character, as the engine itself should have done if it wanted to
2021 submit info for inclusion in the debug file. This option is
2022 provided for the benefit of applications that use the debug file
2023 as a source of information, such as the broadcaster of live games
2024 TLCV / TLCS. Such applications can be protected from spurious
2025 engine output that might otherwise confuse them.
2027 -rsh or -remoteShell shell-name
2028 Name of the command used to run programs remotely. The default is
2029 `rsh' or `remsh', determined when XBoard is configured and
2032 -ruser or -remoteUser user-name
2033 User name on the remote system when running programs with the
2034 `remoteShell'. The default is your local user name.
2037 Name under which the Human player will be listed in the PGN file.
2038 Default is the login name on your local computer.
2040 -delayBeforeQuit number
2041 -delayAfterQuit number
2042 These options specify how long XBoard has to wait before sending a
2043 termination signal to rogue engine processes, that do not want to
2044 react to the 'quit' command. The second one determines the pause
2045 after killing the engine, to make sure it dies.
2051 An "Internet Chess Server", or "ICS", is a place on the Internet where
2052 people can get together to play chess, watch other people's games, or
2053 just chat. You can use either `telnet' or a client program like XBoard
2054 to connect to the server. There are thousands of registered users on
2055 the different ICS hosts, and it is not unusual to meet 200 on both
2056 chessclub.com and freechess.org.
2058 Most people can just type `xboard -ics' to start XBoard as an ICS
2059 client. Invoking XBoard in this way connects you to the Internet Chess
2060 Club (ICC), a commercial ICS. You can log in there as a guest even if
2061 you do not have a paid account. To connect to the largest Free ICS
2062 (FICS), use the command `xboard -ics -icshost freechess.org' instead,
2063 or substitute a different host name to connect to your favorite ICS.
2064 For a full description of command-line options that control the
2065 connection to ICS and change the default values of ICS options, see
2066 *note ICS options::.
2068 While you are running XBoard as an ICS client, you use the terminal
2069 window that you started XBoard from as a place to type in commands and
2070 read information that is not available on the chessboard.
2072 The first time you need to use the terminal is to enter your login
2073 name and password, if you are a registered player. (You don't need to do
2074 this manually; the `icsLogon' option can do it for you. *note ICS
2075 options::.) If you are not registered, enter `g' as your name, and the
2076 server will pick a unique guest name for you.
2078 Some useful ICS commands include
2080 to get help on the given <topic>. To get a list of possible topics
2081 type "help" without topic. Try the help command before you ask
2082 other people on the server for help.
2084 For example `help register' tells you how to become a registered
2088 to see a list of people who are logged on. Administrators (people
2089 you should talk to if you have a problem) are marked with the
2090 character `*', an asterisk. The <flags> allow you to display only
2091 selected players: For example, `who of' shows a list of players
2092 who are interested in playing but do not have an opponent.
2095 to see what games are being played
2097 `match <player> [<mins>] [<inc>]'
2098 to challenge another player to a game. Both opponents get <mins>
2099 minutes for the game, and <inc> seconds will be added after each
2100 move. If another player challenges you, the server asks if you
2101 want to accept the challenge; use the `accept' or `decline'
2106 to accept or decline another player's offer. The offer may be to
2107 start a new game, or to agree to a `draw', `adjourn' or `abort'
2108 the current game. *Note Action Menu::.
2110 If you have more than one pending offer (for example, if more than
2111 one player is challenging you, or if your opponent offers both a
2112 draw and to adjourn the game), you have to supply additional
2113 information, by typing something like `accept <player>', `accept
2119 asks your opponent to terminate a game by mutual agreement.
2120 Adjourned games can be continued later. Your opponent can either
2121 `decline' your offer or accept it (by typing the same command or
2122 typing `accept'). In some cases these commands work immediately,
2123 without asking your opponent to agree. For example, you can abort
2124 the game unilaterally if your opponent is out of time, and you can
2125 claim a draw by repetition or the 50-move rule if available simply
2129 to get information about the given <player>. (Default: yourself.)
2132 to get a list of personal settings
2135 to modify these settings
2138 to observe an ongoing game of the given <player>.
2142 to review a recently completed game
2144 Some special XBoard features are activated when you are in examine
2145 mode on ICS. See the descriptions of the menu commands `Forward',
2146 `Backward', `Pause', `ICS Client', and `Stop Examining' on the *note
2147 Step Menu::, *note Mode Menu::, and *note Options Menu::.
2152 By default, XBoard communicates with an Internet Chess Server by
2153 opening a TCP socket directly from the machine it is running on to the
2154 ICS. If there is a firewall between your machine and the ICS, this
2155 won't work. Here are some recipes for getting around common kinds of
2156 firewalls using special options to XBoard. Important: See the
2157 paragraph in the below about extra echoes, in *note Limitations::.
2159 Suppose that you can't telnet directly to ICS, but you can telnet to
2160 a firewall host, log in, and then telnet from there to ICS. Let's say
2161 the firewall is called `firewall.example.com'. Set command-line options
2164 xboard -ics -icshost firewall.example.com -icsport 23
2165 Or in your `.Xresources' file:
2167 XBoard*internetChessServerHost: firewall.example.com
2168 XBoard*internetChessServerPort: 23
2169 Then when you run XBoard in ICS mode, you will be prompted to log in
2170 to the firewall host. This works because port 23 is the standard telnet
2171 login service. Do so, then telnet to ICS, using a command like `telnet
2172 chessclub.com 5000', or whatever command the firewall provides for
2173 telnetting to port 5000.
2175 If your firewall lets you telnet (or rlogin) to remote hosts but
2176 doesn't let you telnet to port 5000, you may be able to connect to the
2177 chess server on port 23 instead, which is the port the telnet program
2178 uses by default. Some chess servers support this (including
2179 chessclub.com and freechess.org), while some do not.
2181 If your chess server does not allow connections on port 23 and your
2182 firewall does not allow you to connect to other ports, you may be able
2183 to connect by hopping through another host outside the firewall that
2184 you have an account on. For instance, suppose you have a shell account
2185 at `foo.edu'. Follow the recipe above, but instead of typing `telnet
2186 chessclub.com 5000' to the firewall, type `telnet foo.edu' (or `rlogin
2187 foo.edu'), log in there, and then type `telnet chessclub.com 5000'.
2189 Suppose that you can't telnet directly to ICS, but you can use rsh
2190 to run programs on a firewall host, and that host can telnet to ICS.
2191 Let's say the firewall is called `rsh.example.com'. Set command-line
2194 xboard -ics -gateway rsh.example.com -icshost chessclub.com
2196 Or in your `.Xresources' file:
2198 XBoard*gateway: rsh.example.com
2199 XBoard*internetChessServerHost: chessclub.com
2201 Then when you run XBoard in ICS mode, it will connect to the ICS by
2202 using `rsh' to run the command `telnet chessclub.com 5000' on host
2205 Suppose that you can telnet anywhere you want, but you have to run a
2206 special program called `ptelnet' to do so.
2208 First, we'll consider the easy case, in which `ptelnet chessclub.com
2209 5000' gets you to the chess server. In this case set command line
2212 xboard -ics -telnet -telnetProgram ptelnet
2214 Or in your `.Xresources' file:
2216 XBoard*useTelnet: true
2217 XBoard*telnetProgram: ptelnet
2219 Then when you run XBoard in ICS mode, it will issue the command
2220 `ptelnet chessclub.com 5000' to connect to the ICS.
2222 Next, suppose that `ptelnet chessclub.com 5000' doesn't work; that
2223 is, your `ptelnet' program doesn't let you connect to alternative
2224 ports. As noted above, your chess server may allow you to connect on
2225 port 23 instead. In that case, just add the option `-icsport ""' to
2226 the above command, or add `XBoard*internetChessServerPort:' to your
2227 `.Xresources' file. But if your chess server doesn't let you connect
2228 on port 23, you will have to find some other host outside the firewall
2229 and hop through it. For instance, suppose you have a shell account at
2230 `foo.edu'. Set command line options as follows:
2232 xboard -ics -telnet -telnetProgram ptelnet -icshost foo.edu -icsport ""
2234 Or in your `.Xresources' file:
2236 XBoard*useTelnet: true
2237 XBoard*telnetProgram: ptelnet
2238 XBoard*internetChessServerHost: foo.edu
2239 XBoard*internetChessServerPort:
2241 Then when you run XBoard in ICS mode, it will issue the command
2242 `ptelnet foo.edu' to connect to your account at `foo.edu'. Log in
2243 there, then type `telnet chessclub.com 5000'.
2245 ICC timestamp and FICS timeseal do not work through some firewalls.
2246 You can use them only if your firewall gives a clean TCP connection
2247 with a full 8-bit wide path. If your firewall allows you to get out
2248 only by running a special telnet program, you can't use timestamp or
2249 timeseal across it. But if you have access to a computer just outside
2250 your firewall, and you have much lower netlag when talking to that
2251 computer than to the ICS, it might be worthwhile running timestamp
2252 there. Follow the instructions above for hopping through a host
2253 outside the firewall (foo.edu in the example), but run timestamp or
2254 timeseal on that host instead of telnet.
2256 Suppose that you have a SOCKS firewall that will give you a clean
2257 8-bit wide TCP connection to the chess server, but only after you
2258 authenticate yourself via the SOCKS protocol. In that case, you could
2259 make a socksified version of XBoard and run that. If you are using
2260 timestamp or timeseal, you will to socksify it, not XBoard; this may be
2261 difficult seeing that ICC and FICS do not provide source code for these
2262 programs. Socksification is beyond the scope of this document, but see
2263 the SOCKS Web site at http://www.socks.permeo.com/. If you are missing
2264 SOCKS, try http://www.funbureau.com/.
2266 6 Environment variables
2267 ***********************
2269 Game and position files are found in a directory named by the
2270 `CHESSDIR' environment variable. If this variable is not set, the
2271 current working directory is used. If `CHESSDIR' is set, XBoard
2272 actually changes its working directory to `$CHESSDIR', so any files
2273 written by the chess engine will be placed there too.
2275 7 Limitations and known bugs
2276 ****************************
2278 There is no way for two people running copies of XBoard to play each
2279 other without going through an Internet Chess Server.
2281 Under some circumstances, your ICS password may be echoed when you
2284 If you are connecting to the ICS by running telnet on an Internet
2285 provider or firewall host, you may find that each line you type is
2286 echoed back an extra time after you hit <Enter>. If your Internet
2287 provider is a Unix system, you can probably turn its echo off by typing
2288 `stty -echo' after you log in, and/or typing <^E><Enter> (Ctrl+E
2289 followed by the Enter key) to the telnet program after you have logged
2290 into ICS. It is a good idea to do this if you can, because the extra
2291 echo can occasionally confuse XBoard's parsing routines.
2293 The game parser recognizes only algebraic notation.
2295 Many of the following points used to be limitations in XBoard 4.2.7
2296 and earlier, but are now fixed: The internal move legality tester in
2297 XBoard 4.3.xx does look at the game history, and is fully aware of
2298 castling or en-passant-capture rights. It permits castling with the
2299 king on the d file because this is possible in some "wild 1" games on
2300 ICS. The piece-drop menu does not check piece drops in bughouse to see
2301 if you actually hold the piece you are trying to drop. But this way of
2302 dropping pieces should be considered an obsolete feature, now that
2303 pieces can be dropped by dragging them from the holdings to the board.
2304 Anyway, if you would attempt an illegal move when using a chess engine
2305 or the ICS, XBoard will accept the error message that comes back, undo
2306 the move, and let you try another. FEN positions saved by XBoard do
2307 include correct information about whether castling or en passant are
2308 legal, and also handle the 50-move counter. The mate detector does not
2309 understand that non-contact mate is not really mate in bughouse. The
2310 only problem this causes while playing is minor: a "#" (mate indicator)
2311 character will show up after a non-contact mating move in the move
2312 list. XBoard will not assume the game is over at that point, not even
2313 when the option Detect Mates is on. Edit Game mode always uses the
2314 rules of the selected variant, which can be a variant that uses piece
2315 drops. You can load and edit games that contain piece drops. The
2316 (obsolete) piece menus are not active, but you can perform piece drops
2317 by dragging pieces from the holdings. Edit Position mode does not
2318 allow you to edit the crazyhouse holdings properly. You cannot drag
2319 pieces to the holding, and using the popup menu to put pieces there
2320 does not adapt the holding counts and leads to an inconsistent state.
2321 Set up crazyhouse positions by loading / pasting a bFEN, from there you
2322 can set the holdings. Fischer Random castling is fully understood.
2323 You can enter castlings by dragging the King on top of your Rook. You
2324 can probably also play Fischer Random successfully on ICS by typing
2325 castling moves into the ICS Interaction window.
2327 The menus may not work if your keyboard is in Caps Lock or Num Lock
2328 mode. This seems to be a problem with the Athena menu widget, not an
2331 Also see the ToDo file included with the distribution for many other
2332 possible bugs, limitations, and ideas for improvement that have been
2335 8 Reporting problems
2336 ********************
2338 You can report bugs and problems with XBoard using the bug tracker at
2339 `https://savannah.gnu.org/projects/xboard/' or by sending mail to
2340 `<bug-xboard@gnu.org>'. It can also be useful to report or discuss
2341 bugs in the WinBoard Forum at `http://www.open-aurec.com/wbforum/',
2342 WinBoard development section.
2344 Please use the `script' program to start a typescript, run XBoard
2345 with the `-debug' option, and include the typescript output in your
2346 message. Also tell us what kind of machine and what operating system
2347 version you are using. The command `uname -a' will often tell you this.
2349 If you improve XBoard, please send a message about your changes, and
2350 we will get in touch with you about merging them in to the main line of
2353 9 Authors and contributors
2354 **************************
2356 Chris Sears and Dan Sears wrote the original XBoard. They were
2357 responsible for versions 1.0 through 1.2. The color scheme was taken
2358 from Wayne Christopher's `XChess' program.
2360 Tim Mann was primarily responsible for XBoard versions 1.3 through
2361 4.2.7, and for WinBoard (a port of XBoard to Microsoft Win32) from its
2362 inception through version 4.2.7.
2364 John Chanak contributed the initial implementation of ICS mode. Evan
2365 Welsh wrote `CMail', and Patrick Surry helped in designing, testing,
2366 and documenting it. Elmar Bartel contributed the new piece bitmaps
2367 introduced in version 3.2. Jochen Wiedmann converted the documentation
2368 to texinfo. Frank McIngvale added click/click moving, the Analysis
2369 modes, piece flashing, ZIICS import, and ICS text colorization to
2370 XBoard. Hugh Fisher added animated piece movement to XBoard, and
2371 Henrik Gram added it to WinBoard. Mark Williams contributed the
2372 initial (WinBoard-only) implementation of many new features added to
2373 both XBoard and WinBoard in version 4.1.0, including copy/paste,
2374 premove, icsAlarm, autoFlipView, training mode, auto raise, and
2375 blindfold. Ben Nye contributed X copy/paste code for XBoard.
2377 In a fork from version 4.2.7, Alessandro Scotti added many elements
2378 to the user interface of WinBoard, including the board textures and
2379 font-based rendering, the evaluation-graph, move-history and
2380 engine-output window. He was also responsible for adding the UCI
2383 H. G. Muller continued this fork of the project, producing version
2384 4.3. He made WinBoard castling- and e.p.-aware, added variant support
2385 with adjustable board sizes, the crazyhouse holdings, and the fairy
2386 pieces. In addition he added most of the adjudication options, made
2387 WinBoard more robust in dealing with buggy and crashing engines, and
2388 extended time control with a time-odds and node-count-based modes.
2389 Most of the options that initially were WinBoard only have now been
2390 back-ported to XBoard.
2392 Michel van den Bergh provided the code for reading Polyglot opening
2395 Meanwhile, some work continued on the GNU XBoard project maintained
2396 at savannah.gnu.org, but version 4.2.8 was never released. Daniel
2397 Mehrmann was responsible for much of this work.
2399 Most recently, Arun Persaud worked with H. G. Muller to merge all
2400 the features of the never-released XBoard/WinBoard 4.2.8 of the GNU
2401 XBoard project and the never-released 4.3.16 from H. G.'s fork into a
2402 unified XBoard/WinBoard 4.4, which is now available both from the
2403 savannah.gnu.org web site and the WinBoard forum.
2408 The `cmail' program can help you play chess by email with opponents of
2409 your choice using XBoard as an interface.
2411 You will usually run `cmail' without giving any options.
2417 Displays `cmail' usage information.
2420 Shows the conditions of the GNU General Public License. *Note
2424 Shows the warranty notice of the GNU General Public License.
2429 Provides or inhibits verbose output from `cmail' and XBoard,
2430 useful for debugging. The `-xv' form also inhibits the cmail
2431 introduction message.
2435 Invokes or inhibits the sending of a mail message containing the
2440 Invokes or inhibits the running of XBoard on the game file.
2444 Invokes or inhibits the reuse of an existing XBoard to display the
2448 Resends the last mail message for that game. This inhibits running
2452 The name of the game to be processed.
2457 Number of games to start as White, as Black or in total. Default
2458 is 1 as white and none as black. If only one color is specified
2459 then none of the other color is assumed. If no color is specified
2460 then equal numbers of White and Black games are started, with the
2461 extra game being as White if an odd number of total games is
2466 A one-word alias for yourself or your opponent.
2471 -oppname <full name>
2472 The full name of White, Black, yourself or your opponent.
2477 -oppna <net address>
2478 The email address of White, Black, yourself or your opponent.
2481 The directory in which `cmail' keeps its files. This defaults to
2482 the environment variable `$CMAIL_DIR' or failing that, `$CHESSDIR',
2483 `$HOME/Chess' or `~/Chess'. It will be created if it does not
2487 The directory in which `cmail' archives completed games. Defaults
2488 to the environment variable `$CMAIL_ARCDIR' or, in its absence,
2489 the same directory as cmail keeps its working files (above).
2491 -mailprog <mail program>
2492 The program used by cmail to send email messages. This defaults to
2493 the environment variable `$CMAIL_MAILPROG' or failing that
2494 `/usr/ucb/Mail', `/usr/ucb/mail' or `Mail'. You will need to set
2495 this variable if none of the above paths fit your system.
2498 A file in which to dump verbose debugging messages that are
2499 invoked with the `-v' option.
2502 The PGN Event tag (default `Email correspondence game').
2505 The PGN Site tag (default `NET').
2508 The PGN Round tag (default `-', not applicable).
2511 The PGN Mode tag (default `EM', Electronic Mail).
2514 Any option flags not listed above are passed through to XBoard.
2515 Invoking XBoard through CMail changes the default values of two
2516 XBoard options: The default value for `-noChessProgram' is changed
2517 to true; that is, by default no chess engine is started. The
2518 default value for `-timeDelay' is changed to 0; that is, by default
2519 XBoard immediately goes to the end of the game as played so far,
2520 rather than stepping through the moves one by one. You can still
2521 set these options to whatever values you prefer by supplying them
2522 on CMail's command line. *Note Options::.
2524 10.2 Starting a CMail Game
2525 ==========================
2527 Type `cmail' from a shell to start a game as white. After an opening
2528 message, you will be prompted for a game name, which is optional--if you
2529 simply press <Enter>, the game name will take the form
2530 `you-VS-opponent'. You will next be prompted for the short name of your
2531 opponent. If you haven't played this person before, you will also be
2532 prompted for his/her email address. `cmail' will then invoke XBoard in
2533 the background. Make your first move and select `Mail Move' from the
2534 `File' menu. *Note File Menu::. If all is well, `cmail' will mail a
2535 copy of the move to your opponent. If you select `Exit' without having
2536 selected `Mail Move' then no move will be made.
2538 10.3 Answering a Move
2539 =====================
2541 When you receive a message from an opponent containing a move in one of
2542 your games, simply pipe the message through `cmail'. In some mailers
2543 this is as simple as typing `| cmail' when viewing the message, while in
2544 others you may have to save the message to a file and do `cmail < file'
2545 at the command line. In either case `cmail' will display the game using
2546 XBoard. If you didn't exit XBoard when you made your first move then
2547 `cmail' will do its best to use the existing XBoard instead of starting
2548 a new one. As before, simply make a move and select `Mail Move' from
2549 the `File' menu. *Note File Menu::. `cmail' will try to use the XBoard
2550 that was most recently used to display the current game. This means
2551 that many games can be in progress simultaneously, each with its own
2554 If you want to look at the history or explore a variation, go ahead,
2555 but you must return to the current position before XBoard will allow you
2556 to mail a move. If you edit the game's history you must select `Reload
2557 Same Game' from the `File' menu to get back to the original position,
2558 then make the move you want and select `Mail Move'. As before, if you
2559 decide you aren't ready to make a move just yet you can either select
2560 `Exit' without sending a move or just leave XBoard running until you
2563 10.4 Multi-Game Messages
2564 ========================
2566 It is possible to have a `cmail' message carry more than one game.
2567 This feature was implemented to handle IECG (International Email Chess
2568 Group) matches, where a match consists of one game as white and one as
2569 black, with moves transmitted simultaneously. In case there are more
2570 general uses, `cmail' itself places no limit on the number of
2571 black/white games contained in a message; however, XBoard does.
2573 10.5 Completing a Game
2574 ======================
2576 Because XBoard can detect checkmate and stalemate, `cmail' handles game
2577 termination sensibly. As well as resignation, the `Action' menu allows
2578 draws to be offered and accepted for `cmail' games.
2580 For multi-game messages, only unfinished and just-finished games
2581 will be included in email messages. When all the games are finished,
2582 they are archived in the user's archive directory, and similarly in the
2583 opponent's when he or she pipes the final message through `cmail'. The
2584 archive file name includes the date the game was started.
2586 10.6 Known CMail Problems
2587 =========================
2589 It's possible that a strange conjunction of conditions may occasionally
2590 mean that `cmail' has trouble reactivating an existing XBoard. If this
2591 should happen, simply trying it again should work. If not, remove the
2592 file that stores the XBoard's PID (`game.pid') or use the `-xreuse'
2593 option to force `cmail' to start a new XBoard.
2595 Versions of `cmail' after 2.16 no longer understand the old file
2596 format that XBoard used to use and so cannot be used to correspond with
2597 anyone using an older version.
2599 Versions of `cmail' older than 2.11 do not handle multi-game
2600 messages, so multi-game correspondence is not possible with opponents
2601 using an older version.
2603 11 Other programs you can use with XBoard
2604 *****************************************
2606 Here are some other programs you can use with XBoard
2611 The GNU Chess engine is available from:
2613 ftp://ftp.gnu.org/gnu/gnuchess/
2615 You can use XBoard to play a game against GNU Chess, or to interface
2616 GNU Chess to an ICS.
2621 Fairy-Max is a derivative from the once World's smallest Chess program
2622 micro-Max, which measures only about 100 lines of source code. The
2623 main difference with micro-Max is that Fairy-Max loads its
2624 move-generator tables from a file, so that the rules for piece movement
2625 can be easily configured to implement unorthodox pieces. Fairy-Max can
2626 therefore play a large number of variants, normal Chess being one of
2627 those. In addition it plays Knightmate, Capablanca and Gothic Chess,
2628 Shatranj, Courier Chess, Cylinder chess, Berolina Chess, while the user
2629 can easily define new variants. It can be obtained from:
2631 http://home.hccnet.nl/h.g.muller/dwnldpage.html
2636 HoiChess is a not-so-very-strong Chess engine, which comes with a
2637 derivative HoiXiangqi, able to play Chinese Chess. It can be obtained
2638 from the standard Linux repositories through:
2640 sudo apt-get install hoichess
2645 Crafty is a chess engine written by Bob Hyatt. You can use XBoard to
2646 play a game against Crafty, hook Crafty up to an ICS, or use Crafty to
2647 interactively analyze games and positions for you.
2649 Crafty is a strong, rapidly evolving chess program. This rapid pace
2650 of development is good, because it means Crafty is always getting
2651 better. This can sometimes cause problems with backwards
2652 compatibility, but usually the latest version of Crafty will work well
2653 with the latest version of XBoard. Crafty can be obtained from its
2654 author's FTP site: ftp://ftp.cis.uab.edu/hyatt/.
2656 To use Crafty with XBoard, give the -fcp and -fd options as follows,
2657 where <crafty's directory> is the directory in which you installed
2658 Crafty and placed its book and other support files.
2663 The "zic2xpm" program is used to import chess sets from the ZIICS(*)
2664 program into XBoard. "zic2xpm" is part of the XBoard distribution.
2665 ZIICS is available from:
2667 ftp://ftp.freechess.org/pub/chess/DOS/ziics131.exe
2669 To import ZIICS pieces, do this:
2670 1. Unzip ziics131.exe into a directory:
2671 unzip -L ziics131.exe -d ~/ziics
2673 2. Use zic2xpm to convert a set of pieces to XBoard format.
2674 For example, let's say you want to use the FRITZ4 set. These files
2675 are named "fritz4.*" in the ZIICS distribution.
2679 zic2xpm ~/ziics/fritz4.*
2681 3. Give XBoard the "-pixmap" option when starting up, e.g.:
2682 xboard -pixmap ~/fritz4
2684 Alternatively, you can add this line to your `.Xresources' file:
2686 xboard*pixmapDirectory: ~/fritz4
2688 (*) ZIICS is a separate copyrighted work of Andy McFarland. The
2689 "ZIICS pieces" are copyrighted works of their respective creators.
2690 Files produced by "zic2xpm" are for PERSONAL USE ONLY and may NOT be
2691 redistributed without explicit permission from the original creator(s)
2697 Copyright (C) 1991 Digital Equipment Corporation, Maynard,
2700 All Rights Reserved.
2702 Permission to use, copy, modify, and distribute this software and its
2703 documentation for any purpose and without fee is hereby granted,
2704 provided that the above copyright notice appear in all copies and that
2705 both that copyright notice and this permission notice appear in
2706 supporting documentation, and that the name of Digital not be used in
2707 advertising or publicity pertaining to distribution of the software
2708 without specific, written prior permission.
2710 Digital disclaims all warranties with regard to this software,
2711 including all implied warranties of merchantability and fitness. In no
2712 event shall Digital be liable for any special, indirect or
2713 consequential damages or any damages whatsoever resulting from loss of
2714 use, data or profits, whether in an action of contract, negligence or
2715 other tortious action, arising out of or in connection with the use or
2716 performance of this software.
2718 Enhancements copyright (C) 1992-2003, 2004, 2005, 2006, 2007, 2008,
2719 2009, 2010 Free Software Foundation, Inc.
2721 Published by the Free Software Foundation
2722 59 Temple Place - Suite 330
2723 Boston, MA 02111-1307 USA
2725 Permission is granted to make and distribute verbatim copies of this
2726 manual provided the copyright notice and this permission notice are
2727 preserved on all copies.
2729 Permission is granted to copy and distribute modified versions of
2730 this manual under the conditions for verbatim copying, provided also
2731 that the section entitled "GNU General Public License," is included
2732 exactly as in the original, and provided that the entire resulting
2733 derived work is distributed under the terms of a permission notice
2734 identical to this one.
2736 Permission is granted to copy and distribute translations of this
2737 manual into another language, under the above conditions for modified
2738 versions, except that the section entitled "GNU General Public License,"
2739 and this permission notice, may be included in translations approved by
2740 the Free Software Foundation instead of in the original English.
2742 GNU GENERAL PUBLIC LICENSE
2743 **************************
2745 Version 3, 29 June 2007
2747 Copyright (C) 2007 Free Software Foundation, Inc. `http://fsf.org/'
2749 Everyone is permitted to copy and distribute verbatim copies of this
2750 license document, but changing it is not allowed.
2755 The GNU General Public License is a free, copyleft license for software
2756 and other kinds of works.
2758 The licenses for most software and other practical works are designed
2759 to take away your freedom to share and change the works. By contrast,
2760 the GNU General Public License is intended to guarantee your freedom to
2761 share and change all versions of a program--to make sure it remains
2762 free software for all its users. We, the Free Software Foundation, use
2763 the GNU General Public License for most of our software; it applies
2764 also to any other work released this way by its authors. You can apply
2765 it to your programs, too.
2767 When we speak of free software, we are referring to freedom, not
2768 price. Our General Public Licenses are designed to make sure that you
2769 have the freedom to distribute copies of free software (and charge for
2770 them if you wish), that you receive source code or can get it if you
2771 want it, that you can change the software or use pieces of it in new
2772 free programs, and that you know you can do these things.
2774 To protect your rights, we need to prevent others from denying you
2775 these rights or asking you to surrender the rights. Therefore, you
2776 have certain responsibilities if you distribute copies of the software,
2777 or if you modify it: responsibilities to respect the freedom of others.
2779 For example, if you distribute copies of such a program, whether
2780 gratis or for a fee, you must pass on to the recipients the same
2781 freedoms that you received. You must make sure that they, too, receive
2782 or can get the source code. And you must show them these terms so they
2785 Developers that use the GNU GPL protect your rights with two steps:
2786 (1) assert copyright on the software, and (2) offer you this License
2787 giving you legal permission to copy, distribute and/or modify it.
2789 For the developers' and authors' protection, the GPL clearly explains
2790 that there is no warranty for this free software. For both users' and
2791 authors' sake, the GPL requires that modified versions be marked as
2792 changed, so that their problems will not be attributed erroneously to
2793 authors of previous versions.
2795 Some devices are designed to deny users access to install or run
2796 modified versions of the software inside them, although the
2797 manufacturer can do so. This is fundamentally incompatible with the
2798 aim of protecting users' freedom to change the software. The
2799 systematic pattern of such abuse occurs in the area of products for
2800 individuals to use, which is precisely where it is most unacceptable.
2801 Therefore, we have designed this version of the GPL to prohibit the
2802 practice for those products. If such problems arise substantially in
2803 other domains, we stand ready to extend this provision to those domains
2804 in future versions of the GPL, as needed to protect the freedom of
2807 Finally, every program is threatened constantly by software patents.
2808 States should not allow patents to restrict development and use of
2809 software on general-purpose computers, but in those that do, we wish to
2810 avoid the special danger that patents applied to a free program could
2811 make it effectively proprietary. To prevent this, the GPL assures that
2812 patents cannot be used to render the program non-free.
2814 The precise terms and conditions for copying, distribution and
2815 modification follow.
2817 TERMS AND CONDITIONS
2818 ====================
2822 "This License" refers to version 3 of the GNU General Public
2825 "Copyright" also means copyright-like laws that apply to other
2826 kinds of works, such as semiconductor masks.
2828 "The Program" refers to any copyrightable work licensed under this
2829 License. Each licensee is addressed as "you". "Licensees" and
2830 "recipients" may be individuals or organizations.
2832 To "modify" a work means to copy from or adapt all or part of the
2833 work in a fashion requiring copyright permission, other than the
2834 making of an exact copy. The resulting work is called a "modified
2835 version" of the earlier work or a work "based on" the earlier work.
2837 A "covered work" means either the unmodified Program or a work
2838 based on the Program.
2840 To "propagate" a work means to do anything with it that, without
2841 permission, would make you directly or secondarily liable for
2842 infringement under applicable copyright law, except executing it
2843 on a computer or modifying a private copy. Propagation includes
2844 copying, distribution (with or without modification), making
2845 available to the public, and in some countries other activities as
2848 To "convey" a work means any kind of propagation that enables other
2849 parties to make or receive copies. Mere interaction with a user
2850 through a computer network, with no transfer of a copy, is not
2853 An interactive user interface displays "Appropriate Legal Notices"
2854 to the extent that it includes a convenient and prominently visible
2855 feature that (1) displays an appropriate copyright notice, and (2)
2856 tells the user that there is no warranty for the work (except to
2857 the extent that warranties are provided), that licensees may
2858 convey the work under this License, and how to view a copy of this
2859 License. If the interface presents a list of user commands or
2860 options, such as a menu, a prominent item in the list meets this
2865 The "source code" for a work means the preferred form of the work
2866 for making modifications to it. "Object code" means any
2867 non-source form of a work.
2869 A "Standard Interface" means an interface that either is an
2870 official standard defined by a recognized standards body, or, in
2871 the case of interfaces specified for a particular programming
2872 language, one that is widely used among developers working in that
2875 The "System Libraries" of an executable work include anything,
2876 other than the work as a whole, that (a) is included in the normal
2877 form of packaging a Major Component, but which is not part of that
2878 Major Component, and (b) serves only to enable use of the work
2879 with that Major Component, or to implement a Standard Interface
2880 for which an implementation is available to the public in source
2881 code form. A "Major Component", in this context, means a major
2882 essential component (kernel, window system, and so on) of the
2883 specific operating system (if any) on which the executable work
2884 runs, or a compiler used to produce the work, or an object code
2885 interpreter used to run it.
2887 The "Corresponding Source" for a work in object code form means all
2888 the source code needed to generate, install, and (for an executable
2889 work) run the object code and to modify the work, including
2890 scripts to control those activities. However, it does not include
2891 the work's System Libraries, or general-purpose tools or generally
2892 available free programs which are used unmodified in performing
2893 those activities but which are not part of the work. For example,
2894 Corresponding Source includes interface definition files
2895 associated with source files for the work, and the source code for
2896 shared libraries and dynamically linked subprograms that the work
2897 is specifically designed to require, such as by intimate data
2898 communication or control flow between those subprograms and other
2901 The Corresponding Source need not include anything that users can
2902 regenerate automatically from other parts of the Corresponding
2905 The Corresponding Source for a work in source code form is that
2908 2. Basic Permissions.
2910 All rights granted under this License are granted for the term of
2911 copyright on the Program, and are irrevocable provided the stated
2912 conditions are met. This License explicitly affirms your unlimited
2913 permission to run the unmodified Program. The output from running
2914 a covered work is covered by this License only if the output,
2915 given its content, constitutes a covered work. This License
2916 acknowledges your rights of fair use or other equivalent, as
2917 provided by copyright law.
2919 You may make, run and propagate covered works that you do not
2920 convey, without conditions so long as your license otherwise
2921 remains in force. You may convey covered works to others for the
2922 sole purpose of having them make modifications exclusively for
2923 you, or provide you with facilities for running those works,
2924 provided that you comply with the terms of this License in
2925 conveying all material for which you do not control copyright.
2926 Those thus making or running the covered works for you must do so
2927 exclusively on your behalf, under your direction and control, on
2928 terms that prohibit them from making any copies of your
2929 copyrighted material outside their relationship with you.
2931 Conveying under any other circumstances is permitted solely under
2932 the conditions stated below. Sublicensing is not allowed; section
2933 10 makes it unnecessary.
2935 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
2937 No covered work shall be deemed part of an effective technological
2938 measure under any applicable law fulfilling obligations under
2939 article 11 of the WIPO copyright treaty adopted on 20 December
2940 1996, or similar laws prohibiting or restricting circumvention of
2943 When you convey a covered work, you waive any legal power to forbid
2944 circumvention of technological measures to the extent such
2945 circumvention is effected by exercising rights under this License
2946 with respect to the covered work, and you disclaim any intention
2947 to limit operation or modification of the work as a means of
2948 enforcing, against the work's users, your or third parties' legal
2949 rights to forbid circumvention of technological measures.
2951 4. Conveying Verbatim Copies.
2953 You may convey verbatim copies of the Program's source code as you
2954 receive it, in any medium, provided that you conspicuously and
2955 appropriately publish on each copy an appropriate copyright notice;
2956 keep intact all notices stating that this License and any
2957 non-permissive terms added in accord with section 7 apply to the
2958 code; keep intact all notices of the absence of any warranty; and
2959 give all recipients a copy of this License along with the Program.
2961 You may charge any price or no price for each copy that you convey,
2962 and you may offer support or warranty protection for a fee.
2964 5. Conveying Modified Source Versions.
2966 You may convey a work based on the Program, or the modifications to
2967 produce it from the Program, in the form of source code under the
2968 terms of section 4, provided that you also meet all of these
2971 a. The work must carry prominent notices stating that you
2972 modified it, and giving a relevant date.
2974 b. The work must carry prominent notices stating that it is
2975 released under this License and any conditions added under
2976 section 7. This requirement modifies the requirement in
2977 section 4 to "keep intact all notices".
2979 c. You must license the entire work, as a whole, under this
2980 License to anyone who comes into possession of a copy. This
2981 License will therefore apply, along with any applicable
2982 section 7 additional terms, to the whole of the work, and all
2983 its parts, regardless of how they are packaged. This License
2984 gives no permission to license the work in any other way, but
2985 it does not invalidate such permission if you have separately
2988 d. If the work has interactive user interfaces, each must display
2989 Appropriate Legal Notices; however, if the Program has
2990 interactive interfaces that do not display Appropriate Legal
2991 Notices, your work need not make them do so.
2993 A compilation of a covered work with other separate and independent
2994 works, which are not by their nature extensions of the covered
2995 work, and which are not combined with it such as to form a larger
2996 program, in or on a volume of a storage or distribution medium, is
2997 called an "aggregate" if the compilation and its resulting
2998 copyright are not used to limit the access or legal rights of the
2999 compilation's users beyond what the individual works permit.
3000 Inclusion of a covered work in an aggregate does not cause this
3001 License to apply to the other parts of the aggregate.
3003 6. Conveying Non-Source Forms.
3005 You may convey a covered work in object code form under the terms
3006 of sections 4 and 5, provided that you also convey the
3007 machine-readable Corresponding Source under the terms of this
3008 License, in one of these ways:
3010 a. Convey the object code in, or embodied in, a physical product
3011 (including a physical distribution medium), accompanied by the
3012 Corresponding Source fixed on a durable physical medium
3013 customarily used for software interchange.
3015 b. Convey the object code in, or embodied in, a physical product
3016 (including a physical distribution medium), accompanied by a
3017 written offer, valid for at least three years and valid for
3018 as long as you offer spare parts or customer support for that
3019 product model, to give anyone who possesses the object code
3020 either (1) a copy of the Corresponding Source for all the
3021 software in the product that is covered by this License, on a
3022 durable physical medium customarily used for software
3023 interchange, for a price no more than your reasonable cost of
3024 physically performing this conveying of source, or (2) access
3025 to copy the Corresponding Source from a network server at no
3028 c. Convey individual copies of the object code with a copy of
3029 the written offer to provide the Corresponding Source. This
3030 alternative is allowed only occasionally and noncommercially,
3031 and only if you received the object code with such an offer,
3032 in accord with subsection 6b.
3034 d. Convey the object code by offering access from a designated
3035 place (gratis or for a charge), and offer equivalent access
3036 to the Corresponding Source in the same way through the same
3037 place at no further charge. You need not require recipients
3038 to copy the Corresponding Source along with the object code.
3039 If the place to copy the object code is a network server, the
3040 Corresponding Source may be on a different server (operated
3041 by you or a third party) that supports equivalent copying
3042 facilities, provided you maintain clear directions next to
3043 the object code saying where to find the Corresponding Source.
3044 Regardless of what server hosts the Corresponding Source, you
3045 remain obligated to ensure that it is available for as long
3046 as needed to satisfy these requirements.
3048 e. Convey the object code using peer-to-peer transmission,
3049 provided you inform other peers where the object code and
3050 Corresponding Source of the work are being offered to the
3051 general public at no charge under subsection 6d.
3054 A separable portion of the object code, whose source code is
3055 excluded from the Corresponding Source as a System Library, need
3056 not be included in conveying the object code work.
3058 A "User Product" is either (1) a "consumer product", which means
3059 any tangible personal property which is normally used for personal,
3060 family, or household purposes, or (2) anything designed or sold for
3061 incorporation into a dwelling. In determining whether a product
3062 is a consumer product, doubtful cases shall be resolved in favor of
3063 coverage. For a particular product received by a particular user,
3064 "normally used" refers to a typical or common use of that class of
3065 product, regardless of the status of the particular user or of the
3066 way in which the particular user actually uses, or expects or is
3067 expected to use, the product. A product is a consumer product
3068 regardless of whether the product has substantial commercial,
3069 industrial or non-consumer uses, unless such uses represent the
3070 only significant mode of use of the product.
3072 "Installation Information" for a User Product means any methods,
3073 procedures, authorization keys, or other information required to
3074 install and execute modified versions of a covered work in that
3075 User Product from a modified version of its Corresponding Source.
3076 The information must suffice to ensure that the continued
3077 functioning of the modified object code is in no case prevented or
3078 interfered with solely because modification has been made.
3080 If you convey an object code work under this section in, or with,
3081 or specifically for use in, a User Product, and the conveying
3082 occurs as part of a transaction in which the right of possession
3083 and use of the User Product is transferred to the recipient in
3084 perpetuity or for a fixed term (regardless of how the transaction
3085 is characterized), the Corresponding Source conveyed under this
3086 section must be accompanied by the Installation Information. But
3087 this requirement does not apply if neither you nor any third party
3088 retains the ability to install modified object code on the User
3089 Product (for example, the work has been installed in ROM).
3091 The requirement to provide Installation Information does not
3092 include a requirement to continue to provide support service,
3093 warranty, or updates for a work that has been modified or
3094 installed by the recipient, or for the User Product in which it
3095 has been modified or installed. Access to a network may be denied
3096 when the modification itself materially and adversely affects the
3097 operation of the network or violates the rules and protocols for
3098 communication across the network.
3100 Corresponding Source conveyed, and Installation Information
3101 provided, in accord with this section must be in a format that is
3102 publicly documented (and with an implementation available to the
3103 public in source code form), and must require no special password
3104 or key for unpacking, reading or copying.
3106 7. Additional Terms.
3108 "Additional permissions" are terms that supplement the terms of
3109 this License by making exceptions from one or more of its
3110 conditions. Additional permissions that are applicable to the
3111 entire Program shall be treated as though they were included in
3112 this License, to the extent that they are valid under applicable
3113 law. If additional permissions apply only to part of the Program,
3114 that part may be used separately under those permissions, but the
3115 entire Program remains governed by this License without regard to
3116 the additional permissions.
3118 When you convey a copy of a covered work, you may at your option
3119 remove any additional permissions from that copy, or from any part
3120 of it. (Additional permissions may be written to require their own
3121 removal in certain cases when you modify the work.) You may place
3122 additional permissions on material, added by you to a covered work,
3123 for which you have or can give appropriate copyright permission.
3125 Notwithstanding any other provision of this License, for material
3126 you add to a covered work, you may (if authorized by the copyright
3127 holders of that material) supplement the terms of this License
3130 a. Disclaiming warranty or limiting liability differently from
3131 the terms of sections 15 and 16 of this License; or
3133 b. Requiring preservation of specified reasonable legal notices
3134 or author attributions in that material or in the Appropriate
3135 Legal Notices displayed by works containing it; or
3137 c. Prohibiting misrepresentation of the origin of that material,
3138 or requiring that modified versions of such material be
3139 marked in reasonable ways as different from the original
3142 d. Limiting the use for publicity purposes of names of licensors
3143 or authors of the material; or
3145 e. Declining to grant rights under trademark law for use of some
3146 trade names, trademarks, or service marks; or
3148 f. Requiring indemnification of licensors and authors of that
3149 material by anyone who conveys the material (or modified
3150 versions of it) with contractual assumptions of liability to
3151 the recipient, for any liability that these contractual
3152 assumptions directly impose on those licensors and authors.
3154 All other non-permissive additional terms are considered "further
3155 restrictions" within the meaning of section 10. If the Program as
3156 you received it, or any part of it, contains a notice stating that
3157 it is governed by this License along with a term that is a further
3158 restriction, you may remove that term. If a license document
3159 contains a further restriction but permits relicensing or
3160 conveying under this License, you may add to a covered work
3161 material governed by the terms of that license document, provided
3162 that the further restriction does not survive such relicensing or
3165 If you add terms to a covered work in accord with this section, you
3166 must place, in the relevant source files, a statement of the
3167 additional terms that apply to those files, or a notice indicating
3168 where to find the applicable terms.
3170 Additional terms, permissive or non-permissive, may be stated in
3171 the form of a separately written license, or stated as exceptions;
3172 the above requirements apply either way.
3176 You may not propagate or modify a covered work except as expressly
3177 provided under this License. Any attempt otherwise to propagate or
3178 modify it is void, and will automatically terminate your rights
3179 under this License (including any patent licenses granted under
3180 the third paragraph of section 11).
3182 However, if you cease all violation of this License, then your
3183 license from a particular copyright holder is reinstated (a)
3184 provisionally, unless and until the copyright holder explicitly
3185 and finally terminates your license, and (b) permanently, if the
3186 copyright holder fails to notify you of the violation by some
3187 reasonable means prior to 60 days after the cessation.
3189 Moreover, your license from a particular copyright holder is
3190 reinstated permanently if the copyright holder notifies you of the
3191 violation by some reasonable means, this is the first time you have
3192 received notice of violation of this License (for any work) from
3193 that copyright holder, and you cure the violation prior to 30 days
3194 after your receipt of the notice.
3196 Termination of your rights under this section does not terminate
3197 the licenses of parties who have received copies or rights from
3198 you under this License. If your rights have been terminated and
3199 not permanently reinstated, you do not qualify to receive new
3200 licenses for the same material under section 10.
3202 9. Acceptance Not Required for Having Copies.
3204 You are not required to accept this License in order to receive or
3205 run a copy of the Program. Ancillary propagation of a covered work
3206 occurring solely as a consequence of using peer-to-peer
3207 transmission to receive a copy likewise does not require
3208 acceptance. However, nothing other than this License grants you
3209 permission to propagate or modify any covered work. These actions
3210 infringe copyright if you do not accept this License. Therefore,
3211 by modifying or propagating a covered work, you indicate your
3212 acceptance of this License to do so.
3214 10. Automatic Licensing of Downstream Recipients.
3216 Each time you convey a covered work, the recipient automatically
3217 receives a license from the original licensors, to run, modify and
3218 propagate that work, subject to this License. You are not
3219 responsible for enforcing compliance by third parties with this
3222 An "entity transaction" is a transaction transferring control of an
3223 organization, or substantially all assets of one, or subdividing an
3224 organization, or merging organizations. If propagation of a
3225 covered work results from an entity transaction, each party to that
3226 transaction who receives a copy of the work also receives whatever
3227 licenses to the work the party's predecessor in interest had or
3228 could give under the previous paragraph, plus a right to
3229 possession of the Corresponding Source of the work from the
3230 predecessor in interest, if the predecessor has it or can get it
3231 with reasonable efforts.
3233 You may not impose any further restrictions on the exercise of the
3234 rights granted or affirmed under this License. For example, you
3235 may not impose a license fee, royalty, or other charge for
3236 exercise of rights granted under this License, and you may not
3237 initiate litigation (including a cross-claim or counterclaim in a
3238 lawsuit) alleging that any patent claim is infringed by making,
3239 using, selling, offering for sale, or importing the Program or any
3244 A "contributor" is a copyright holder who authorizes use under this
3245 License of the Program or a work on which the Program is based.
3246 The work thus licensed is called the contributor's "contributor
3249 A contributor's "essential patent claims" are all patent claims
3250 owned or controlled by the contributor, whether already acquired or
3251 hereafter acquired, that would be infringed by some manner,
3252 permitted by this License, of making, using, or selling its
3253 contributor version, but do not include claims that would be
3254 infringed only as a consequence of further modification of the
3255 contributor version. For purposes of this definition, "control"
3256 includes the right to grant patent sublicenses in a manner
3257 consistent with the requirements of this License.
3259 Each contributor grants you a non-exclusive, worldwide,
3260 royalty-free patent license under the contributor's essential
3261 patent claims, to make, use, sell, offer for sale, import and
3262 otherwise run, modify and propagate the contents of its
3263 contributor version.
3265 In the following three paragraphs, a "patent license" is any
3266 express agreement or commitment, however denominated, not to
3267 enforce a patent (such as an express permission to practice a
3268 patent or covenant not to sue for patent infringement). To
3269 "grant" such a patent license to a party means to make such an
3270 agreement or commitment not to enforce a patent against the party.
3272 If you convey a covered work, knowingly relying on a patent
3273 license, and the Corresponding Source of the work is not available
3274 for anyone to copy, free of charge and under the terms of this
3275 License, through a publicly available network server or other
3276 readily accessible means, then you must either (1) cause the
3277 Corresponding Source to be so available, or (2) arrange to deprive
3278 yourself of the benefit of the patent license for this particular
3279 work, or (3) arrange, in a manner consistent with the requirements
3280 of this License, to extend the patent license to downstream
3281 recipients. "Knowingly relying" means you have actual knowledge
3282 that, but for the patent license, your conveying the covered work
3283 in a country, or your recipient's use of the covered work in a
3284 country, would infringe one or more identifiable patents in that
3285 country that you have reason to believe are valid.
3287 If, pursuant to or in connection with a single transaction or
3288 arrangement, you convey, or propagate by procuring conveyance of, a
3289 covered work, and grant a patent license to some of the parties
3290 receiving the covered work authorizing them to use, propagate,
3291 modify or convey a specific copy of the covered work, then the
3292 patent license you grant is automatically extended to all
3293 recipients of the covered work and works based on it.
3295 A patent license is "discriminatory" if it does not include within
3296 the scope of its coverage, prohibits the exercise of, or is
3297 conditioned on the non-exercise of one or more of the rights that
3298 are specifically granted under this License. You may not convey a
3299 covered work if you are a party to an arrangement with a third
3300 party that is in the business of distributing software, under
3301 which you make payment to the third party based on the extent of
3302 your activity of conveying the work, and under which the third
3303 party grants, to any of the parties who would receive the covered
3304 work from you, a discriminatory patent license (a) in connection
3305 with copies of the covered work conveyed by you (or copies made
3306 from those copies), or (b) primarily for and in connection with
3307 specific products or compilations that contain the covered work,
3308 unless you entered into that arrangement, or that patent license
3309 was granted, prior to 28 March 2007.
3311 Nothing in this License shall be construed as excluding or limiting
3312 any implied license or other defenses to infringement that may
3313 otherwise be available to you under applicable patent law.
3315 12. No Surrender of Others' Freedom.
3317 If conditions are imposed on you (whether by court order,
3318 agreement or otherwise) that contradict the conditions of this
3319 License, they do not excuse you from the conditions of this
3320 License. If you cannot convey a covered work so as to satisfy
3321 simultaneously your obligations under this License and any other
3322 pertinent obligations, then as a consequence you may not convey it
3323 at all. For example, if you agree to terms that obligate you to
3324 collect a royalty for further conveying from those to whom you
3325 convey the Program, the only way you could satisfy both those
3326 terms and this License would be to refrain entirely from conveying
3329 13. Use with the GNU Affero General Public License.
3331 Notwithstanding any other provision of this License, you have
3332 permission to link or combine any covered work with a work licensed
3333 under version 3 of the GNU Affero General Public License into a
3334 single combined work, and to convey the resulting work. The terms
3335 of this License will continue to apply to the part which is the
3336 covered work, but the special requirements of the GNU Affero
3337 General Public License, section 13, concerning interaction through
3338 a network will apply to the combination as such.
3340 14. Revised Versions of this License.
3342 The Free Software Foundation may publish revised and/or new
3343 versions of the GNU General Public License from time to time.
3344 Such new versions will be similar in spirit to the present
3345 version, but may differ in detail to address new problems or
3348 Each version is given a distinguishing version number. If the
3349 Program specifies that a certain numbered version of the GNU
3350 General Public License "or any later version" applies to it, you
3351 have the option of following the terms and conditions either of
3352 that numbered version or of any later version published by the
3353 Free Software Foundation. If the Program does not specify a
3354 version number of the GNU General Public License, you may choose
3355 any version ever published by the Free Software Foundation.
3357 If the Program specifies that a proxy can decide which future
3358 versions of the GNU General Public License can be used, that
3359 proxy's public statement of acceptance of a version permanently
3360 authorizes you to choose that version for the Program.
3362 Later license versions may give you additional or different
3363 permissions. However, no additional obligations are imposed on any
3364 author or copyright holder as a result of your choosing to follow a
3367 15. Disclaimer of Warranty.
3369 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
3370 APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
3371 COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS"
3372 WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
3373 INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
3374 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
3375 RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
3376 SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
3377 NECESSARY SERVICING, REPAIR OR CORRECTION.
3379 16. Limitation of Liability.
3381 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
3382 WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES
3383 AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
3384 FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
3385 CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
3386 THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
3387 BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
3388 PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
3389 PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
3390 THE POSSIBILITY OF SUCH DAMAGES.
3392 17. Interpretation of Sections 15 and 16.
3394 If the disclaimer of warranty and limitation of liability provided
3395 above cannot be given local legal effect according to their terms,
3396 reviewing courts shall apply local law that most closely
3397 approximates an absolute waiver of all civil liability in
3398 connection with the Program, unless a warranty or assumption of
3399 liability accompanies a copy of the Program in return for a fee.
3402 END OF TERMS AND CONDITIONS
3403 ===========================
3405 How to Apply These Terms to Your New Programs
3406 =============================================
3408 If you develop a new program, and you want it to be of the greatest
3409 possible use to the public, the best way to achieve this is to make it
3410 free software which everyone can redistribute and change under these
3413 To do so, attach the following notices to the program. It is safest
3414 to attach them to the start of each source file to most effectively
3415 state the exclusion of warranty; and each file should have at least the
3416 "copyright" line and a pointer to where the full notice is found.
3418 ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
3419 Copyright (C) YEAR NAME OF AUTHOR
3421 This program is free software: you can redistribute it and/or modify
3422 it under the terms of the GNU General Public License as published by
3423 the Free Software Foundation, either version 3 of the License, or (at
3424 your option) any later version.
3426 This program is distributed in the hope that it will be useful, but
3427 WITHOUT ANY WARRANTY; without even the implied warranty of
3428 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3429 General Public License for more details.
3431 You should have received a copy of the GNU General Public License
3432 along with this program. If not, see `http://www.gnu.org/licenses/'.
3434 Also add information on how to contact you by electronic and paper
3437 If the program does terminal interaction, make it output a short
3438 notice like this when it starts in an interactive mode:
3440 PROGRAM Copyright (C) YEAR NAME OF AUTHOR
3441 This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
3442 This is free software, and you are welcome to redistribute it
3443 under certain conditions; type `show c' for details.
3445 The hypothetical commands `show w' and `show c' should show the
3446 appropriate parts of the General Public License. Of course, your
3447 program's commands might be different; for a GUI interface, you would
3450 You should also get your employer (if you work as a programmer) or
3451 school, if any, to sign a "copyright disclaimer" for the program, if
3452 necessary. For more information on this, and how to apply and follow
3453 the GNU GPL, see `http://www.gnu.org/licenses/'.
3455 The GNU General Public License does not permit incorporating your
3456 program into proprietary programs. If your program is a subroutine
3457 library, you may consider it more useful to permit linking proprietary
3458 applications with the library. If this is what you want to do, use the
3459 GNU Lesser General Public License instead of this License. But first,
3460 please read `http://www.gnu.org/philosophy/why-not-lgpl.html'.
3465 -animateSpeed, option: See 3.5. (line 1806)
3466 -autoDisplayComment, option: See 3.5. (line 1811)
3467 -autoDisplayTags, option: See 3.5. (line 1811)
3468 -pasteSelection, option: See 3.5. (line 1817)
3469 .icsrc: See 3.3. (line 1318)
3470 <, Button: See 2.4. (line 468)
3471 <<, Button: See 2.4. (line 501)
3472 >, Button: See 2.4. (line 488)
3473 >>, Button: See 2.4. (line 520)
3474 abort, ICS command: See 4. (line 2119)
3475 Abort, Menu Item: See 2.3. (line 440)
3476 About XBoard, Menu Item: See 2.6. (line 842)
3477 accept, ICS command: See 4. (line 2106)
3478 Accept, Menu Item: See 2.3. (line 415)
3479 Action, Menu: See 2.3. (line 414)
3480 adjourn, ICS command: See 4. (line 2119)
3481 Adjourn, Menu Item: See 2.3. (line 436)
3482 Adjudicate Draw, Menu Item: See 2.3. (line 459)
3483 Adjudicate to Black, Menu Item: See 2.3. (line 459)
3484 Adjudicate to White, Menu Item: See 2.3. (line 459)
3485 adjudicateDrawMoves, option: See 3.6. (line 1833)
3486 adjudicateLossThreshold, option: See 3.6. (line 1825)
3487 Adjudications, Menu Item: See 2.5. (line 560)
3488 alarm, option: See 3.3. (line 1361)
3489 Always Queen, Menu Item: See 2.5. (line 606)
3490 alwaysPromoteToQueen, option: See 3.5. (line 1602)
3491 Analysis Mode, Menu Item: See 2.2. (line 239)
3492 Analyze File, Menu Item: See 2.2. (line 260)
3493 Animate Dragging, Menu Item: See 2.5. (line 612)
3494 Animate Moving, Menu Item: See 2.5. (line 619)
3495 animate, option: See 3.5. (line 1802)
3496 animateDragging, option: See 3.5. (line 1798)
3497 animateMoving, option: See 3.5. (line 1802)
3498 Authors: See 9. (line 2356)
3499 Auto Comment, Menu Item: See 2.5. (line 627)
3500 Auto Flag, Menu Item: See 2.5. (line 635)
3501 Auto Flip View, Menu Item: See 2.5. (line 644)
3502 Auto Observe, Menu Item: See 2.5. (line 649)
3503 Auto Raise Board, Menu Item: See 2.5. (line 662)
3504 Auto Save, Menu Item: See 2.5. (line 667)
3505 autobs, option: See 3.3. (line 1345)
3506 autoCallFlag, option: See 3.3. (line 1341)
3507 autocomm, option: See 3.3. (line 1337)
3508 autoComment, option: See 3.3. (line 1337)
3509 autoflag, option: See 3.3. (line 1341)
3510 autoflip, option: See 3.5. (line 1648)
3511 autoFlipView, option: See 3.5. (line 1648)
3512 autoKibitz, option: See 3.3. (line 1349)
3513 autoObserve, option: See 3.3. (line 1345)
3514 autoraise, option: See 3.5. (line 1644)
3515 autoRaiseBoard, option: See 3.5. (line 1644)
3516 autosave, option: See 3.4. (line 1526)
3517 autoSaveGames, option: See 3.4. (line 1526)
3518 Back to Start, Menu Item: See 2.4. (line 501)
3519 Backward, Menu Item: See 2.4. (line 468)
3520 bell, option: See 3.5. (line 1589)
3521 bitmapDirectory, option: See 3.5. (line 1729)
3522 blackPieceColor, option: See 3.5. (line 1776)
3523 blind, option: See 3.5. (line 1696)
3524 Blindfold, Menu Item: See 2.5. (line 674)
3525 blindfold, option: See 3.5. (line 1696)
3526 bm, option: See 3.5. (line 1729)
3527 board size: See 3.5. (line 1610)
3528 boardHeight, option: See 3.7. (line 1956)
3529 boardSize, option: See 3.5. (line 1610)
3530 boardWidth, option: See 3.7. (line 1961)
3531 Book, Menu Item: See 2.6. (line 832)
3532 Bug reports: See 8. (line 2338)
3533 Bugs <1>: See 8. (line 2338)
3534 Bugs: See 7. (line 2278)
3535 buttons, option: See 3.5. (line 1670)
3536 Call Flag, Menu Item: See 2.3. (line 425)
3537 checkMates, option: See 3.6. (line 1838)
3538 Chess engine options: See 3.1. (line 919)
3539 CHESSDIR: See 6. (line 2269)
3540 clock, option: See 3.1. (line 936)
3541 clockFont, option: See 3.5. (line 1700)
3542 clockMode, option: See 3.1. (line 936)
3543 cmail: See 10. (line 2408)
3544 colorChallenge, option: See 3.3. (line 1394)
3545 colorChannel, option: See 3.3. (line 1394)
3546 colorChannel1, option: See 3.3. (line 1394)
3547 colorize, option: See 3.3. (line 1380)
3548 colorKibitz, option: See 3.3. (line 1394)
3549 colorNormal, option: See 3.3. (line 1394)
3550 colorRequest, option: See 3.3. (line 1394)
3551 Colors <1>: See 3.5. (line 1776)
3552 Colors: See 3.3. (line 1380)
3553 colorSeek, option: See 3.3. (line 1394)
3554 colorShout, option: See 3.3. (line 1394)
3555 colorSShout, option: See 3.3. (line 1394)
3556 colorTell, option: See 3.3. (line 1394)
3557 Contributors: See 9. (line 2356)
3558 coordFont, option: See 3.5. (line 1706)
3559 coords, option: See 3.5. (line 1640)
3560 Copy Game, Menu Item: See 2.1. (line 167)
3561 Copy Position, Menu Item: See 2.1. (line 207)
3562 darkSquareColor, option: See 3.5. (line 1776)
3563 debug, option: See 3.7. (line 2007)
3564 debugFile, option: See 3.7. (line 2010)
3565 debugMode, option: See 3.7. (line 2007)
3566 decline, ICS command: See 4. (line 2106)
3567 Decline, Menu Item: See 2.3. (line 420)
3568 defaultCacheSizeEGTB, option: See 3.2. (line 1199)
3569 defaultFrcPosition, option: See 3.7. (line 1976)
3570 defaultHashSize, option: See 3.2. (line 1193)
3571 defaultPathEGTB, option: See 3.2. (line 1205)
3572 delayAfterQuit, option: See 3.7. (line 2042)
3573 delayBeforeQuit, option: See 3.7. (line 2042)
3574 display, option: See 3.5. (line 1580)
3575 drag, option: See 3.5. (line 1798)
3576 draw, ICS command: See 4. (line 2119)
3577 Draw, Menu Item: See 2.3. (line 431)
3578 Edit Comment, Menu Item: See 2.2. (line 376)
3579 Edit Game, Menu Item: See 2.2. (line 294)
3580 Edit Position, Menu Item: See 2.2. (line 310)
3581 Edit Tags, Menu Item: See 2.2. (line 352)
3582 egtFormats, option: See 3.2. (line 1209)
3583 Engine Settings: See 3.2. (line 1160)
3584 engineDebugOutput, option: See 3.7. (line 2014)
3585 Environment variables: See 6. (line 2269)
3586 examine, ICS command: See 4. (line 2142)
3587 Exit, Menu Item: See 2.1. (line 224)
3588 exit, option: See 3.5. (line 1594)
3589 fb, option: See 3.1. (line 1043)
3590 fcp, option: See 3.1. (line 1036)
3591 fd, option: See 3.1. (line 1058)
3592 fh, option: See 3.1. (line 1050)
3593 File Menu: See 2.1. (line 82)
3594 finger, ICS command: See 4. (line 2129)
3595 firstChessProgram, option: See 3.1. (line 1036)
3596 firstComputerString, option: See 3.1. (line 1094)
3597 firstDirectory, option: See 3.1. (line 1058)
3598 firstHasOwnBookUCI, option: See 3.2. (line 1188)
3599 firstHost, option: See 3.1. (line 1050)
3600 firstIsUCI, option: See 3.2. (line 1162)
3601 firstNeedsNoncompliantFEN, option: See 3.1. (line 1144)
3602 firstNPS, option: See 3.1. (line 959)
3603 firstOptions, option: See 3.1. (line 1133)
3604 firstPlaysBlack, option: See 3.1. (line 1043)
3605 firstProtocolVersion, option: See 3.1. (line 1111)
3606 firstScoreAbs, option: See 3.1. (line 1119)
3607 firstTimeOdds, option: See 3.1. (line 977)
3608 firstXBook, option: See 3.2. (line 1188)
3609 Flash Moves, Menu Item: See 2.5. (line 680)
3610 flash, option: See 3.5. (line 1683)
3611 flashCount, option: See 3.5. (line 1683)
3612 flashRate, option: See 3.5. (line 1683)
3613 Flip View, Menu Item: See 2.5. (line 555)
3614 flip, option: See 3.5. (line 1652)
3615 flipView, option: See 3.5. (line 1652)
3616 fNoOwnBookUCI, option: See 3.2. (line 1188)
3617 Font: See 3.5. (line 1713)
3618 Font, clock: See 3.5. (line 1700)
3619 Font, coordinates: See 3.5. (line 1706)
3620 font, option: See 3.5. (line 1713)
3621 fontSizeTolerance, option: See 3.5. (line 1719)
3622 Forward to End, Menu Item: See 2.4. (line 520)
3623 Forward, Menu Item: See 2.4. (line 488)
3624 fUCI, option: See 3.2. (line 1162)
3625 gameListTags, option: See 3.4. (line 1568)
3626 games, ICS command: See 4. (line 2095)
3627 gateway, option: See 3.3. (line 1268)
3628 geometry, option: See 3.5. (line 1580)
3629 Get Move List, Menu Item: See 2.5. (line 694)
3630 getMoveList, option: See 3.3. (line 1357)
3631 Help Menu: See 2.6. (line 814)
3632 help, ICS command: See 4. (line 2080)
3633 Hide Thinking, Menu Item: See 2.5. (line 791)
3634 Highlight Last Move, Menu Item: See 2.5. (line 706)
3635 highlight, option: See 3.5. (line 1692)
3636 highlightLastMove, option: See 3.5. (line 1692)
3637 highlightSquareColor, option: See 3.5. (line 1776)
3638 Hint, Menu Item: See 2.6. (line 829)
3639 holdingsSize, option: See 3.7. (line 1968)
3640 iconic, option: See 3.5. (line 1580)
3641 ICS: See 4. (line 2051)
3642 ICS Alarm, Menu Item: See 2.5. (line 727)
3643 ICS Client, Menu Item: See 2.2. (line 270)
3644 ICS Input Box, Menu Item: See 2.2. (line 381)
3645 ICS options: See 3.3. (line 1223)
3646 ICS, addresses: See 4. (line 2051)
3647 ics, option: See 3.3. (line 1224)
3648 icsAlarm, option: See 3.3. (line 1361)
3649 icsAlarmTime, option: See 3.3. (line 1365)
3650 icscomm, option: See 3.3. (line 1276)
3651 icshelper, option: See 3.3. (line 1242)
3652 icshost, option: See 3.3. (line 1229)
3653 icsinput, option: See 3.3. (line 1333)
3654 icslogon, option: See 3.3. (line 1318)
3655 icsport, option: See 3.3. (line 1238)
3656 inc, option: See 3.1. (line 929)
3657 Info XBoard, Menu Item: See 2.6. (line 815)
3658 initalMode, option: See 3.7. (line 1890)
3659 initString, option: See 3.1. (line 1067)
3660 Internet Chess Server: See 4. (line 2051)
3661 internetChessServerCommPort, option: See 3.3. (line 1276)
3662 internetChessServerHelper, option: See 3.3. (line 1242)
3663 internetChessServerHost, option: See 3.3. (line 1229)
3664 internetChessServerInputBox, option: See 3.3. (line 1333)
3665 internetChessServerLogonScript, option: See 3.3. (line 1318)
3666 internetChessServerMode, option: See 3.3. (line 1224)
3667 internetChessServerPort, option: See 3.3. (line 1238)
3669 See ``Introduction''. (line 9)
3670 Keys: See 2.7. (line 847)
3671 legal, option: See 3.5. (line 1606)
3672 lgf, option: See 3.4. (line 1490)
3673 lgi, option: See 3.4. (line 1490)
3674 lightSquareColor, option: See 3.5. (line 1776)
3675 Limitations: See 7. (line 2278)
3676 Load and Save options: See 3.4. (line 1488)
3677 Load Game, Menu Item: See 2.1. (line 115)
3678 Load Next Game, Menu Item: See 2.1. (line 142)
3679 Load Next Position, Menu Item: See 2.1. (line 188)
3680 Load Position, Menu Item: See 2.1. (line 180)
3681 Load Previous Game, Menu Item: See 2.1. (line 146)
3682 Load Previous Position, Menu Item: See 2.1. (line 191)
3683 loadGameFile, option: See 3.4. (line 1490)
3684 loadGameIndex, option: See 3.4. (line 1490)
3685 loadPositionFile, option: See 3.4. (line 1531)
3686 loadPositionIndex, option: See 3.4. (line 1531)
3687 lowTimeWarning, option: See 3.3. (line 1369)
3688 lowTimeWarningColor, option: See 3.5. (line 1776)
3689 lpf, option: See 3.4. (line 1531)
3690 lpi, option: See 3.4. (line 1531)
3691 Machine Black, Menu Item: See 2.2. (line 233)
3692 Machine White, Menu Item: See 2.2. (line 230)
3693 Mail Move, Menu Item: See 2.1. (line 221)
3694 Major modes: See 1. (line 19)
3695 Man XBoard, Menu Item: See 2.6. (line 822)
3696 matchGames, option: See 3.1. (line 1014)
3697 matchMode, option: See 3.1. (line 1026)
3698 materialDraws, option: See 3.6. (line 1850)
3699 Menu, Action: See 2.3. (line 414)
3700 Menu, File: See 2.1. (line 82)
3701 Menu, Help: See 2.6. (line 814)
3702 Menu, Mode: See 2.2. (line 229)
3703 Menu, Options: See 2.5. (line 554)
3704 Menu, Step: See 2.4. (line 467)
3705 Menus: See 2. (line 57)
3706 mg, option: See 3.1. (line 1014)
3707 mm, option: See 3.1. (line 1026)
3708 Mode Menu: See 2.2. (line 229)
3709 mode, option: See 3.7. (line 1890)
3710 mono, option: See 3.5. (line 1676)
3711 monoMode, option: See 3.5. (line 1676)
3712 Move Now, Menu Item: See 2.4. (line 541)
3713 Move Sound, Menu Item: See 2.5. (line 712)
3714 moves, option: See 3.3. (line 1357)
3715 movesound, option: See 3.5. (line 1589)
3716 movesPerSession, option: See 3.1. (line 925)
3717 mps, option: See 3.1. (line 925)
3718 msLoginDelay, option: See 3.3. (line 1327)
3719 nameOfDebugFile, option: See 3.7. (line 2010)
3720 ncp, option: See 3.7. (line 1885)
3721 New Game, Menu Item: See 2.1. (line 83)
3722 New Shuffle Game, Menu Item: See 2.1. (line 92)
3723 New variant, Menu Item: See 2.1. (line 105)
3724 niceEngines, option: See 3.1. (line 1125)
3725 noChessProgram, option: See 3.7. (line 1885)
3726 noGUI, option: See 3.5. (line 1583)
3727 observe, ICS command: See 4. (line 2138)
3728 Old Save Style, Menu Item: See 2.5. (line 736)
3729 oldmoves, ICS command: See 4. (line 2142)
3730 oldsave, option: See 3.4. (line 1564)
3731 oldSaveStyle, option: See 3.4. (line 1564)
3732 Options: See 3. (line 893)
3733 Options Menu: See 2.5. (line 554)
3734 Options, adjudication: See 3.6. (line 1824)
3735 options, Chess engine: See 3.1. (line 919)
3736 Options, ICS: See 3.3. (line 1223)
3737 Options, Load and Save: See 3.4. (line 1488)
3738 Options, miscellaneous: See 3.7. (line 1884)
3739 Options, User interface: See 3.5. (line 1577)
3740 Other programs: See 11. (line 2606)
3741 Paste Game, Menu Item: See 2.1. (line 176)
3742 Paste Position, Menu Item: See 2.1. (line 216)
3743 Pause, Menu Item: See 2.2. (line 388)
3744 Periodic Updates, Menu Item: See 2.5. (line 744)
3745 pgnEventHeader, option`: See 3.4. (line 1556)
3746 pgnExtendedInfo, option`: See 3.4. (line 1551)
3747 pieceToCharTable, option: See 3.7. (line 1981)
3748 pixmap, option: See 3.5. (line 1729)
3749 pixmapDirectory, option: See 3.5. (line 1729)
3750 PolyglotBook, option: See 3.2. (line 1177)
3751 PolyglotDir, option: See 3.2. (line 1169)
3752 Ponder Next Move, Menu Item: See 2.5. (line 750)
3753 ponder, option: See 3.1. (line 1005)
3754 ponderNextMove, option: See 3.1. (line 1005)
3755 Popup Exit Message, Menu Item: See 2.5. (line 755)
3756 Popup Move Errors, Menu Item: See 2.5. (line 761)
3757 popup, option: See 3.5. (line 1598)
3758 popupExitMessage, option: See 3.5. (line 1594)
3759 popupMoveErrors, option: See 3.5. (line 1598)
3760 pre, option: See 3.3. (line 1373)
3761 Premove, Menu Item: See 2.5. (line 770)
3762 premove, option: See 3.3. (line 1373)
3763 Problems: See 8. (line 2338)
3764 queen, option: See 3.5. (line 1602)
3765 Quiet Play, Menu Item: See 2.5. (line 781)
3766 quiet, option: See 3.3. (line 1376)
3767 quietPlay, option: See 3.3. (line 1376)
3768 Reload CMail Message, Menu Item: See 2.1. (line 221)
3769 Reload Same Game, Menu Item: See 2.1. (line 151)
3770 Reload Same Position, Menu Item: See 2.1. (line 195)
3771 remoteShell, option: See 3.7. (line 2028)
3772 remoteUser, option: See 3.7. (line 2033)
3773 Reporting bugs: See 8. (line 2338)
3774 Reporting problems: See 8. (line 2338)
3775 Resign, Menu Item: See 2.3. (line 445)
3776 Retract Move, Menu Item: See 2.4. (line 545)
3777 reuse, option: See 3.1. (line 1102)
3778 reuse2, option: See 3.1. (line 1102)
3779 reuseFirst, option: See 3.1. (line 1102)
3780 reuseSecond, option: See 3.1. (line 1102)
3781 Revert, Menu Item: See 2.4. (line 532)
3782 ringBellAfterMoves, option: See 3.5. (line 1589)
3783 rsh, option: See 3.7. (line 2028)
3784 ruleMoves, option: See 3.6. (line 1868)
3785 ruser, option: See 3.7. (line 2033)
3786 sameColorGames, option: See 3.1. (line 1030)
3787 Save Game, Menu Item: See 2.1. (line 155)
3788 saveGameFile, option: See 3.4. (line 1521)
3789 saveOutOfBookInfo, option`: See 3.4. (line 1560)
3790 savePositionFile, option: See 3.4. (line 1546)
3791 scp, option: See 3.1. (line 1039)
3792 sd, option: See 3.1. (line 950)
3793 searchDepth, option: See 3.1. (line 950)
3794 searchTime, option: See 3.1. (line 943)
3795 secondChessProgram, option: See 3.1. (line 1039)
3796 secondComputerString, option: See 3.1. (line 1094)
3797 secondDirectory, option: See 3.1. (line 1058)
3798 secondHasOwnBookUCI, option: See 3.2. (line 1188)
3799 secondHost, option: See 3.1. (line 1050)
3800 secondInitString, option: See 3.1. (line 1067)
3801 secondIsUCI, option: See 3.2. (line 1162)
3802 secondNeedsNoncompliantFEN, option: See 3.1. (line 1144)
3803 secondNPS, option: See 3.1. (line 959)
3804 secondOptions, option: See 3.1. (line 1133)
3805 secondProtocolVersion, option: See 3.1. (line 1111)
3806 secondScoreAbs, option: See 3.1. (line 1119)
3807 secondTimeOdds, option: See 3.1. (line 977)
3808 secondXBook, option: See 3.2. (line 1188)
3809 set, ICS command: See 4. (line 2135)
3810 Settings, Engine: See 3.2. (line 1160)
3811 sgf, option: See 3.4. (line 1521)
3812 sh, option: See 3.1. (line 1050)
3813 Shortcut keys: See 2.7. (line 847)
3814 Show Coords, Menu Item: See 2.5. (line 787)
3815 Show Engine Output, Menu Item: See 2.2. (line 348)
3816 Show Game List, Menu Item: See 2.2. (line 339)
3817 Show Move History, Menu Item: See 2.2. (line 343)
3818 showButtonBar, option: See 3.5. (line 1670)
3819 showCoords, option: See 3.5. (line 1640)
3820 showThinking, option: See 3.1. (line 995)
3821 size, option: See 3.5. (line 1610)
3822 sNoOwnBookUCI, option: See 3.2. (line 1188)
3823 soundChallenge, option: See 3.3. (line 1439)
3824 soundChannel, option: See 3.3. (line 1439)
3825 soundIcsAlarm, option: See 3.3. (line 1447)
3826 soundIcsDraw, option: See 3.3. (line 1458)
3827 soundIcsLoss, option: See 3.3. (line 1454)
3828 soundIcsUnfinished, option: See 3.3. (line 1462)
3829 soundIcsWin, option: See 3.3. (line 1450)
3830 soundKibitz, option: See 3.3. (line 1439)
3831 soundMove, option: See 3.3. (line 1444)
3832 soundProgram, option: See 3.3. (line 1423)
3833 soundRequest, option: See 3.3. (line 1439)
3834 Sounds: See 3.3. (line 1423)
3835 soundSeek, option: See 3.3. (line 1439)
3836 soundShout, option: See 3.3. (line 1439)
3837 soundSShout, option: See 3.3. (line 1439)
3838 soundTell, option: See 3.3. (line 1439)
3839 spf, option: See 3.4. (line 1546)
3840 st, option: See 3.1. (line 943)
3841 Step Menu: See 2.4. (line 467)
3842 Stop Examining, Menu Item: See 2.3. (line 453)
3843 Stop Observing, Menu Item: See 2.3. (line 449)
3844 sUCI, option: See 3.2. (line 1162)
3845 tc, option: See 3.1. (line 920)
3846 td, option: See 3.4. (line 1516)
3847 telnet, option: See 3.3. (line 1250)
3848 telnetProgram, option: See 3.3. (line 1259)
3849 Test Legality, Menu Item: See 2.5. (line 800)
3850 testClaims, option: See 3.6. (line 1844)
3851 testLegality, option: See 3.5. (line 1606)
3852 thinking, option: See 3.1. (line 995)
3853 Time Control, Menu Item: See 2.5. (line 597)
3854 timeControl, option: See 3.1. (line 920)
3855 timeDelay, option: See 3.4. (line 1516)
3856 timeIncrement, option: See 3.1. (line 929)
3857 timeOddsMode, option: See 3.1. (line 983)
3858 title, option: See 3.5. (line 1662)
3859 titleInWindow, option: See 3.5. (line 1662)
3860 Training, Menu Item: See 2.2. (line 329)
3861 trivialDraws, option: See 3.6. (line 1857)
3862 Truncate Game, Menu Item: See 2.4. (line 536)
3863 Two Machines, Menu Item: See 2.2. (line 236)
3864 usePolyglotBook, option: See 3.2. (line 1174)
3865 User interface options: See 3.5. (line 1577)
3866 userName, option: See 3.7. (line 2037)
3867 useTelnet, option: See 3.3. (line 1250)
3868 variant, option: See 3.7. (line 1898)
3869 vars, ICS command: See 4. (line 2132)
3870 whitePieceColor, option: See 3.5. (line 1776)
3871 who, ICS command: See 4. (line 2088)
3872 xflash, option: See 3.5. (line 1683)
3878 2 Menus, buttons, and keys
3885 2.7 Other Shortcut Keys
3887 3.1 Chess Engine Options
3888 3.2 UCI + WB Engine Settings
3890 3.4 Load and Save options
3891 3.5 User interface options
3892 3.6 Adjudication Options
3896 6 Environment variables
3897 7 Limitations and known bugs
3898 8 Reporting problems
3899 9 Authors and contributors
3902 10.2 Starting a CMail Game
3903 10.3 Answering a Move
3904 10.4 Multi-Game Messages
3905 10.5 Completing a Game
3906 10.6 Known CMail Problems
3907 11 Other programs you can use with XBoard
3914 GNU GENERAL PUBLIC LICENSE