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