updated manuals to latest xboard.texi version
[xboard.git] / manual / html_node / Mode-Menu.html
index c33b485..c57450f 100644 (file)
@@ -36,161 +36,160 @@ Up:&nbsp;<a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
 
 <p><a name="index-Menu_002c-Mode-26"></a><a name="index-Mode-Menu-27"></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
-&lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; 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
-&lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">Stop Examining</span></samp>&rsquo;\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 &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; 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 &lsquo;<samp><span class="samp">Machine White</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Machine Black</span></samp>&rsquo;,\r
-or &lsquo;<samp><span class="samp">Two Machines</span></samp>&rsquo;.\r
-\r
-In ICS mode, the moves are not sent to the ICS: &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; 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 &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; causes XBoard to discard\r
-all remembered moves in the current game.\r
-\r
-In ICS mode, changes made to the position by &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; are\r
-not sent to the ICS: &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; takes XBoard out of\r
-&lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; 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 &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; from the File menu).  While XBoard is in \r
-&lsquo;<samp><span class="samp">Training</span></samp>&rsquo; 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 &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo;\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">          &lt;tag-section&gt; ::= &lt;tag-pair&gt; &lt;tag-section&gt;\r
-                                  &lt;empty&gt;\r
-          &lt;tag-pair&gt; ::= [ &lt;tag-name&gt; &lt;tag-value&gt; ]\r
-          &lt;tag-name&gt; ::= &lt;identifier&gt;\r
-          &lt;tag-value&gt; ::= &lt;string&gt;\r
+<dt>Machine White<dd><a name="index-Machine-White_002c-Menu-Item-28"></a>Tells the chess engine to play White. 
+<br><dt>Machine Black<dd><a name="index-Machine-Black_002c-Menu-Item-29"></a>Tells the chess engine to play Black. 
+<br><dt>Two Machines<dd><a name="index-Two-Machines_002c-Menu-Item-30"></a>Plays a game between two chess engines. 
+<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
+and shows you the analysis as you move pieces around. 
+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>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 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.) 
+and analyze it. When you select this menu item, a popup window appears
+and asks for a filename to load. 
+If the file contains multiple games, another popup appears that lets
+you select which game you wish to analyze. 
+After a game is loaded, use the XBoard arrow buttons to step
+forwards/backwards through the game and watch the analysis. 
+Note: Some chess engines do not support Analysis mode. 
+<br><dt>ICS Client<dd><a name="index-ICS-Client_002c-Menu-Item-33"></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
+&lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; 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
+&lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">Stop Examining</span></samp>&rsquo;
+have special functions in this mode; see below. 
+<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
+moves after backing up with the &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; command. The clocks do
+not run.
+
+     <p>In chess engine mode, the chess engine continues to check moves for legality
+but does not participate in the game. You can bring the chess engine
+into the game by selecting &lsquo;<samp><span class="samp">Machine White</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Machine Black</span></samp>&rsquo;,
+or &lsquo;<samp><span class="samp">Two Machines</span></samp>&rsquo;.
+
+     <p>In ICS mode, the moves are not sent to the ICS: &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; takes
+XBoard out of ICS Client mode and lets you edit games locally. 
+If you want to edit games on ICS in a way that other ICS users
+can see, use the ICS <kbd>examine</kbd> command or start an ICS match
+against yourself. 
+<br><dt>Edit Position<dd><a name="index-Edit-Position_002c-Menu-Item-35"></a>Lets you set up an arbitrary board position. 
+Use mouse button 1 to drag pieces to new squares, or to delete a piece
+by dragging it off the board or dragging an empty square on top of it. 
+To drop a new piece on a square, press mouse button 2 or 3 over the
+square. This brings up a menu of white pieces (button 2) or
+black pieces (button 3). Additional menu choices let you empty the
+square or clear the board. You can set the side to play next by
+clicking on the word White or Black at the top of the screen. 
+Selecting &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; causes XBoard to discard
+all remembered moves in the current game.
+
+     <p>In ICS mode, changes made to the position by &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; are
+not sent to the ICS: &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; takes XBoard out of
+&lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; mode and lets you edit positions locally. If you want to
+edit positions on ICS in a way that other ICS users can see, use
+the ICS <kbd>examine</kbd> command, or start an ICS match against yourself. 
+(See also the ICS Client topic above.) 
+<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
+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 autoplayed. 
+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 &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; from the File menu).  While XBoard is in
+&lsquo;<samp><span class="samp">Training</span></samp>&rsquo; mode, the navigation buttons are disabled. 
+<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 &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo;
+command. 
+<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. 
+This list allows you to move the display to any earlier position in the game
+by clicking on the corresponding move. 
+<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
+is displayed. 
+<br><dt>Edit Tags<dd><a name="index-Edit-Tags_002c-Menu-Item-40"></a>Lets you edit the PGN (portable game notation)
+tags for the current game. After editing, the tags must still conform to
+the PGN tag syntax:
+
+     <pre class="example">          &lt;tag-section&gt; ::= &lt;tag-pair&gt; &lt;tag-section&gt;
+                                  &lt;empty&gt;
+          &lt;tag-pair&gt; ::= [ &lt;tag-name&gt; &lt;tag-value&gt; ]
+          &lt;tag-name&gt; ::= &lt;identifier&gt;
+          &lt;tag-value&gt; ::= &lt;string&gt;
 </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
+     <p class="noindent">See the PGN Standard for full details. Here is an example:
+
+     <pre class="example">          [Event "Portoroz Interzonal"]
+          [Site "Portoroz, Yugoslavia"]
+          [Date "1958.08.16"]
+          [Round "8"]
+          [White "Robert J. Fischer"]
+          [Black "Bent Larsen"]
+          [Result "1-0"]
 </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 &lsquo;<samp><span class="samp">?</span></samp>&rsquo; (unknown value), or &lsquo;<samp><span class="samp">-</span></samp>&rsquo; (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 &lsquo;<samp><span class="samp">Save Game</span></samp>&rsquo; and are displayed by &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo;,\r
-&lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;.\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 &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again, and the\r
-display will automatically update to the latest position.\r
-The &lsquo;<samp><span class="samp">P</span></samp>&rsquo; 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 &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; while you are loading a game, the game stops\r
-loading. You can load more moves manually by selecting &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, or\r
-resume automatic loading by selecting &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again.\r
+     <p class="noindent">Any characters that do not match this syntax are silently ignored. Note that
+the PGN standard requires all games to have at least the seven tags shown
+above. Any that you omit will be filled in by XBoard
+with &lsquo;<samp><span class="samp">?</span></samp>&rsquo; (unknown value), or &lsquo;<samp><span class="samp">-</span></samp>&rsquo; (inapplicable value). 
+<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
+saved by &lsquo;<samp><span class="samp">Save Game</span></samp>&rsquo; and are displayed by &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo;,
+&lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;. 
+<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,
+XBoard
+creates an extra window that you can use for typing in ICS commands. 
+The input box is especially useful if you want to type in something long or do
+some editing on your input, because output from ICS doesn't get mixed
+in with your typing as it would in the main terminal window. 
+<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,
+also pauses your clock. To continue, select &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again, and the
+display will automatically update to the latest position. 
+The &lsquo;<samp><span class="samp">P</span></samp>&rsquo; button and keyboard <kbd>p</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 &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; while you are loading a game, the game stops
+loading. You can load more moves manually by selecting &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, or
+resume automatic loading by selecting &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo; again. 
 </dl>
-   \r
 
    </body></html>