<title>Mode Menu - XBoard</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="XBoard">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Menus.html#Menus" title="Menus">
-<link rel="prev" href="File-Menu.html#File-Menu" title="File Menu">
+<link rel="prev" href="View-Menu.html#View-Menu" title="View Menu">
<link rel="next" href="Action-Menu.html#Action-Menu" title="Action Menu">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
</head>
<body>
<div class="node">
-<p>
<a name="Mode-Menu"></a>
+<p>
Next: <a rel="next" accesskey="n" href="Action-Menu.html#Action-Menu">Action Menu</a>,
-Previous: <a rel="previous" accesskey="p" href="File-Menu.html#File-Menu">File Menu</a>,
+Previous: <a rel="previous" accesskey="p" href="View-Menu.html#View-Menu">View Menu</a>,
Up: <a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
<hr>
</div>
-<h3 class="section">2.2 Mode Menu</h3>
+<h3 class="section">3.4 Mode Menu</h3>
-<p><a name="index-Menu_002c-Mode-26"></a><a name="index-Mode-Menu-27"></a>
+<p><a name="index-Menu_002c-Mode-57"></a><a name="index-Mode-Menu-58"></a>
<dl>
-<dt>Machine White<dd><a name="index-Machine-White_002c-Menu-Item-28"></a>Tells the chess engine to play White.\r
-<br><dt>Machine Black<dd><a name="index-Machine-Black_002c-Menu-Item-29"></a>Tells the chess engine to play Black.\r
-<br><dt>Two Machines<dd><a name="index-Two-Machines_002c-Menu-Item-30"></a>Plays a game between two chess engines.\r
-<br><dt>Analysis Mode<dd><a name="index-Analysis-Mode_002c-Menu-Item-31"></a>XBoard tells the chess engine to start analyzing the current game/position\r
-and shows you the analysis as you move pieces around.\r
-Note: Some chess engines do not support Analysis mode.\r
-\r
-To set up a position to analyze, you do the following:\r
-\r
-1. Select Edit Position from the Mode Menu\r
-\r
-2. Set up the position. Use the middle and right buttons to\r
-bring up the white and black piece menus.\r
-\r
-3. When you are finished, click on either the Black or White\r
-clock to tell XBoard which side moves first.\r
-\r
-4. Select Analysis Mode from the Mode Menu to start the analysis.\r
-\r
-The analysis function can also be used when observing games on an ICS\r
-with an engine loaded (zippy mode); the engine then will analyse\r
-the positions as they occur in the observed game.\r
-<br><dt>Analyze File<dd><a name="index-Analyze-File_002c-Menu-Item-32"></a>This option lets you load a game from a file (PGN, XBoard format, etc.)\r
-and analyze it. When you select this menu item, a popup window appears\r
-and asks for a filename to load.\r
-If the file contains multiple games, another popup appears that lets\r
-you select which game you wish to analyze.\r
-After a game is loaded, use the XBoard arrow buttons to step\r
-forwards/backwards through the game and watch the analysis.\r
-Note: Some chess engines do not support Analysis mode.\r
-<br><dt>ICS Client<dd><a name="index-ICS-Client_002c-Menu-Item-33"></a>This is the normal mode when XBoard\r
-is connected to a chess server. If you have moved into\r
-Edit Game or Edit Position mode, you can select this option to get out.\r
-\r
-To use xboard in ICS mode, run it in the foreground with the -ics\r
-option, and use the terminal you started it from to type commands and\r
-receive text responses from the chess server. See\r
-<a href="Chess-Servers.html#Chess-Servers">Chess Servers</a> below for more information.\r
-\r
-XBoard activates some special position/game editing features when you\r
-use the <kbd>examine</kbd> or <kbd>bsetup</kbd> commands on ICS and you have\r
-‘<samp><span class="samp">ICS Client</span></samp>’ selected on the Mode menu. First, you can issue the\r
-ICS position-editing commands with the mouse. Move pieces by dragging\r
-with mouse button 1. To drop a new piece on a square, press mouse\r
-button 2 or 3 over the square. This brings up a menu of white pieces\r
-(button 2) or black pieces (button 3). Additional menu choices let\r
-you empty the square or clear the board. Click on the White or Black\r
-clock to set the side to play. You cannot set the side to play or\r
-drag pieces to arbitrary squares while examining on ICC, but you can\r
-do so in <kbd>bsetup</kbd> mode on FICS. In addition, the menu commands\r
-‘<samp><span class="samp">Forward</span></samp>’, ‘<samp><span class="samp">Backward</span></samp>’, ‘<samp><span class="samp">Pause</span></samp>’, and ‘<samp><span class="samp">Stop Examining</span></samp>’\r
-have special functions in this mode; see below.\r
-<br><dt>Edit Game<dd><a name="index-Edit-Game_002c-Menu-Item-34"></a>Allows you to make moves for both Black and White, and to change\r
-moves after backing up with the ‘<samp><span class="samp">Backward</span></samp>’ command. The clocks do\r
-not run.\r
-\r
-In chess engine mode, the chess engine continues to check moves for legality\r
-but does not participate in the game. You can bring the chess engine\r
-into the game by selecting ‘<samp><span class="samp">Machine White</span></samp>’, ‘<samp><span class="samp">Machine Black</span></samp>’,\r
-or ‘<samp><span class="samp">Two Machines</span></samp>’.\r
-\r
-In ICS mode, the moves are not sent to the ICS: ‘<samp><span class="samp">Edit Game</span></samp>’ takes\r
-XBoard out of ICS Client mode and lets you edit games locally.\r
-If you want to edit games on ICS in a way that other ICS users\r
-can see, use the ICS <kbd>examine</kbd> command or start an ICS match\r
-against yourself.\r
-<br><dt>Edit Position<dd><a name="index-Edit-Position_002c-Menu-Item-35"></a>Lets you set up an arbitrary board position.\r
-Use mouse button 1 to drag pieces to new squares, or to delete a piece\r
-by dragging it off the board or dragging an empty square on top of it.\r
-To drop a new piece on a square, press mouse button 2 or 3 over the\r
-square. This brings up a menu of white pieces (button 2) or\r
-black pieces (button 3). Additional menu choices let you empty the\r
-square or clear the board. You can set the side to play next by\r
-clicking on the word White or Black at the top of the screen.\r
-Selecting ‘<samp><span class="samp">Edit Position</span></samp>’ causes XBoard to discard\r
-all remembered moves in the current game.\r
-\r
-In ICS mode, changes made to the position by ‘<samp><span class="samp">Edit Position</span></samp>’ are\r
-not sent to the ICS: ‘<samp><span class="samp">Edit Position</span></samp>’ takes XBoard out of\r
-‘<samp><span class="samp">ICS Client</span></samp>’ mode and lets you edit positions locally. If you want to\r
-edit positions on ICS in a way that other ICS users can see, use\r
-the ICS <kbd>examine</kbd> command, or start an ICS match against yourself.\r
-(See also the ICS Client topic above.)\r
-<br><dt>Training<dd><a name="index-Training_002c-Menu-Item-36"></a>Training mode lets you interactively guess the moves of a game for one\r
-of the players. You guess the next move of the game by playing the\r
-move on the board. If the move played matches the next move of the\r
-game, the move is accepted and the opponent's response is autoplayed.\r
-If the move played is incorrect, an error message is displayed. You\r
-can select this mode only while loading a game (that is, after\r
-selecting ‘<samp><span class="samp">Load Game</span></samp>’ from the File menu). While XBoard is in \r
-‘<samp><span class="samp">Training</span></samp>’ mode, the navigation buttons are disabled.\r
-<br><dt>Show Game List<dd><a name="index-Show-Game-List_002c-Menu-Item-37"></a>Shows or hides the list of games generated by the last ‘<samp><span class="samp">Load Game</span></samp>’\r
-command.\r
-<br><dt>Show Move History<dd><a name="index-Show-Move-History_002c-Menu-Item-38"></a>Shows or hides a list of moves of the current game.\r
-This list allows you to move the display to any earlier position in the game\r
-by clicking on the corresponding move.\r
-<br><dt>Show Engine Output<dd><a name="index-Show-Engine-Output_002c-Menu-Item-39"></a>Shows or hides a window in which the thinking output of any loaded engines\r
-is displayed.\r
-<br><dt>Edit Tags<dd><a name="index-Edit-Tags_002c-Menu-Item-40"></a>Lets you edit the PGN (portable game notation)\r
-tags for the current game. After editing, the tags must still conform to\r
-the PGN tag syntax:\r
-\r
- <pre class="example"> <tag-section> ::= <tag-pair> <tag-section>\r
- <empty>\r
- <tag-pair> ::= [ <tag-name> <tag-value> ]\r
- <tag-name> ::= <identifier>\r
- <tag-value> ::= <string>\r
-</pre>
- <p class="noindent">See the PGN Standard for full details. Here is an example:\r
-\r
- <pre class="example"> [Event "Portoroz Interzonal"]\r
- [Site "Portoroz, Yugoslavia"]\r
- [Date "1958.08.16"]\r
- [Round "8"]\r
- [White "Robert J. Fischer"]\r
- [Black "Bent Larsen"]\r
- [Result "1-0"]\r
-</pre>
- <p class="noindent">Any characters that do not match this syntax are silently ignored. Note that\r
-the PGN standard requires all games to have at least the seven tags shown\r
-above. Any that you omit will be filled in by XBoard\r
-with ‘<samp><span class="samp">?</span></samp>’ (unknown value), or ‘<samp><span class="samp">-</span></samp>’ (inapplicable value).\r
-<br><dt>Edit Comment<dd><a name="index-Edit-Comment_002c-Menu-Item-41"></a>Adds or modifies a comment on the current position. Comments are\r
-saved by ‘<samp><span class="samp">Save Game</span></samp>’ and are displayed by ‘<samp><span class="samp">Load Game</span></samp>’,\r
-‘<samp><span class="samp">Forward</span></samp>’, and ‘<samp><span class="samp">Backward</span></samp>’.\r
-<br><dt>ICS Input Box<dd><a name="index-ICS-Input-Box_002c-Menu-Item-42"></a>If this option is set in ICS mode,\r
-XBoard\r
-creates an extra window that you can use for typing in ICS commands.\r
-The input box is especially useful if you want to type in something long or do\r
-some editing on your input, because output from ICS doesn't get mixed\r
-in with your typing as it would in the main terminal window.\r
-<br><dt>Pause<dd><a name="index-Pause_002c-Menu-Item-43"></a>Pauses updates to the board, and if you are playing against a chess engine,\r
-also pauses your clock. To continue, select ‘<samp><span class="samp">Pause</span></samp>’ again, and the\r
-display will automatically update to the latest position.\r
-The ‘<samp><span class="samp">P</span></samp>’ button and keyboard <kbd>p</kbd> key are equivalents.\r
-\r
-If you select Pause when you are playing against a chess engine and\r
-it is not your move, the chess engine's clock\r
-will continue to run and it will eventually make a move, at which point\r
-both clocks will stop. Since board updates are paused, however,\r
-you will not see the move until you exit from Pause mode (or select Forward).\r
-This behavior is meant to simulate adjournment with a sealed move.\r
-\r
-If you select Pause while you are observing or examining a game on a\r
-chess server, you can step backward and forward in the current history\r
-of the examined game without affecting the other observers and\r
-examiners, and without having your display jump forward to the latest\r
-position each time a move is made. Select Pause again to reconnect\r
-yourself to the current state of the game on ICS.\r
-\r
-If you select ‘<samp><span class="samp">Pause</span></samp>’ while you are loading a game, the game stops\r
-loading. You can load more moves manually by selecting ‘<samp><span class="samp">Forward</span></samp>’, or\r
-resume automatic loading by selecting ‘<samp><span class="samp">Pause</span></samp>’ again.\r
+<dt>Machine White<dd><a name="index-Machine-White_002c-Menu-Item-59"></a>Tells the chess engine to play White.
+The <kbd>Ctrl-W</kbd> key is a keyboard equivalent.
+<br><dt>Machine Black<dd><a name="index-Machine-Black_002c-Menu-Item-60"></a>Tells the chess engine to play Black.
+The <kbd>Ctrl-B</kbd> key is a keyboard equivalent.
+<br><dt>Two Machines<dd><a name="index-Two-Machines_002c-Menu-Item-61"></a>Plays a game between two chess engines.
+The <kbd>Ctrl-T</kbd> key is a keyboard equivalent.
+<br><dt>Analysis Mode<dd><a name="index-Analysis-Mode_002c-Menu-Item-62"></a><a name="index-null-move-63"></a>XBoard tells the chess engine to start analyzing the current game/position
+and shows you the analysis as you move pieces around.
+The <kbd>Ctrl-A</kbd> key is a keyboard equivalent.
+Note: Some chess engines do not support Analysis mode.
+
+ <p>To set up a position to analyze, you do the following:
+
+ <p>1. Select Edit Position from the Mode Menu
+
+ <p>2. Set up the position. Use the middle and right buttons to
+bring up the white and black piece menus.
+
+ <p>3. When you are finished, click on either the Black or White
+clock to tell XBoard which side moves first.
+
+ <p>4. Select Analysis Mode from the Mode Menu to start the analysis.
+
+ <p>You can now play legal moves to create follow-up positions for the
+engine to analyze, while the moves will be remembered as a stored game,
+and then step backward through this game to take the moves back.
+Note that you can also click on the clocks to set the opposite
+side to move (adding a so-called ‘<samp><span class="samp">null move</span></samp>’ to the game).
+
+ <p>You can also tell the engine to exclude some moves from analysis.
+(Engines that do not support the exclude-moves feature will
+ignore this, however.)
+The general way to do this is to play the move you want to exclude
+starting with a double click on the piece.
+When you use drag-drop moving, the piece you grab with a double click
+will also remain on its square, to show you that you are not really
+making the move, but just forbid it from the current position.
+Playing a thus excluded move a second time will include it again.
+Excluded moves will be listed as text in a header line in the
+Engine Output window, and you can also re-include them by
+right-clicking them there.
+This header line will also contain the words 'best' and 'tail';
+right-clicking those will exclude the currently best move,
+or all moves not explicitly listed in the header line.
+Once you leave the current position all memory of excluded
+moves will be lost when you return there.
+
+ <p>Selecting this menu item while already in ‘<samp><span class="samp">Analysis Mode</span></samp>’ will
+toggle the participation of the second engine in the analysis.
+The output of this engine will then be shown in the lower pane
+of the Engine Output window.
+The analysis function can also be used when observing games on an ICS
+with an engine loaded (zippy mode); the engine then will analyse
+the positions as they occur in the observed game.
+
+ <br><dt>Analyze Game<dd><a name="index-Analyze-Game_002c-Menu-Item-64"></a>This option subjects the currently loaded game to automatic
+analysis by the loaded engine.
+The <kbd>Ctrl-G</kbd> key is a keyboard equivalent.
+XBoard will start auto-playing the game from the currently displayed position,
+while the engine is analyzing the current position.
+The game will be annotated with the results of these analyses.
+In particlar, the score and depth will be added as a comment,
+and the PV will be added as a variation.
+
+ <p>Normally the analysis would stop after reaching the end of the game.
+But when a game is loaded from a multi-game file
+while ‘<samp><span class="samp">Analyze Game</span></samp>’ was already switched on,
+the analysis will continue with the next game in the file
+until the end of the file is reached (or you switch to another mode).
+
+ <p>The time the engine spends on analyzing each move can be controlled
+through the command-line option ‘<samp><span class="samp">-timeDelay</span></samp>’,
+which can also be set from the ‘<samp><span class="samp">Load Game Options</span></samp>’ menu dialog.
+Note: Some chess engines do not support Analysis mode.
+<br><dt>Edit Game<dd>Duplicate of the item in the Edit menu.
+Note that ‘<samp><span class="samp">Edit Game</span></samp>’ is the idle mode of XBoard, and can be used
+to get you out of other modes. E.g. to stop analyzing, stop a game
+between two engines or stop editing a position.
+<br><dt>Edit Position<dd>Duplicate of the item in the Edit menu.
+<br><dt>Training<dd><a name="index-Training_002c-Menu-Item-65"></a>Training mode lets you interactively guess the moves of a game for one
+of the players. You guess the next move of the game by playing the
+move on the board. If the move played matches the next move of the
+game, the move is accepted and the opponent's response is auto-played.
+If the move played is incorrect, an error message is displayed. You
+can select this mode only while loading a game (that is, after
+selecting ‘<samp><span class="samp">Load Game</span></samp>’ from the File menu). While XBoard is in
+‘<samp><span class="samp">Training</span></samp>’ mode, the navigation buttons are disabled.
+<br><dt>ICS Client<dd><a name="index-ICS-Client_002c-Menu-Item-66"></a>This is the normal mode when XBoard
+is connected to a chess server. If you have moved into
+Edit Game or Edit Position mode, you can select this option to get out.
+
+ <p>To use xboard in ICS mode, run it in the foreground with the -ics
+option, and use the terminal you started it from to type commands and
+receive text responses from the chess server. See
+<a href="Chess-Servers.html#Chess-Servers">Chess Servers</a> below for more information.
+
+ <p>XBoard activates some special position/game editing features when you
+use the <kbd>examine</kbd> or <kbd>bsetup</kbd> commands on ICS and you have
+‘<samp><span class="samp">ICS Client</span></samp>’ selected on the Mode menu. First, you can issue the
+ICS position-editing commands with the mouse. Move pieces by dragging
+with mouse button 1. To drop a new piece on a square, press mouse
+button 2 or 3 over the square. This brings up a menu of white pieces
+(button 2) or black pieces (button 3). Additional menu choices let
+you empty the square or clear the board. Click on the White or Black
+clock to set the side to play. You cannot set the side to play or
+drag pieces to arbitrary squares while examining on ICC, but you can
+do so in <kbd>bsetup</kbd> mode on FICS. In addition, the menu commands
+‘<samp><span class="samp">Forward</span></samp>’, ‘<samp><span class="samp">Backward</span></samp>’, ‘<samp><span class="samp">Pause</span></samp>’, and ‘<samp><span class="samp">Stop Examining</span></samp>’
+have special functions in this mode; see below.
+<br><dt>Machine Match<dd><a name="index-Machine-match_002c-Menu-Item-67"></a>Starts a match between two chess programs,
+with a number of games and other parameters set through
+the ‘<samp><span class="samp">Match Options</span></samp>’ menu dialog.
+When a match is already running, selecting this item will make
+XBoard drop out of match mode after the current game finishes.
+<br><dt>Pause<dd><a name="index-Pause_002c-Menu-Item-68"></a>Pauses updates to the board, and if you are playing against a chess engine,
+also pauses your clock. To continue, select ‘<samp><span class="samp">Pause</span></samp>’ again, and the
+display will automatically update to the latest position.
+The ‘<samp><span class="samp">P</span></samp>’ button and keyboard <kbd>Pause</kbd> key are equivalents.
+
+ <p>If you select Pause when you are playing against a chess engine and
+it is not your move, the chess engine's clock
+will continue to run and it will eventually make a move, at which point
+both clocks will stop. Since board updates are paused, however,
+you will not see the move until you exit from Pause mode (or select Forward).
+This behavior is meant to simulate adjournment with a sealed move.
+
+ <p>If you select Pause while you are observing or examining a game on a
+chess server, you can step backward and forward in the current history
+of the examined game without affecting the other observers and
+examiners, and without having your display jump forward to the latest
+position each time a move is made. Select Pause again to reconnect
+yourself to the current state of the game on ICS.
+
+ <p>If you select ‘<samp><span class="samp">Pause</span></samp>’ while you are loading a game, the game stops
+loading. You can load more moves manually by selecting ‘<samp><span class="samp">Forward</span></samp>’, or
+resume automatic loading by selecting ‘<samp><span class="samp">Pause</span></samp>’ again.
</dl>
- \r
</body></html>
projects / xboard.git / blobdiff