updated documentation
[xboard.git] / manual / html_node / File-Menu.html
index f4a3a55..17747b1 100644 (file)
@@ -34,112 +34,113 @@ Up:&nbsp;<a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
 
 <p><a name="index-File-Menu-4"></a><a name="index-Menu_002c-File-5"></a>
      <dl>
-<dt>New Game<dd><a name="index-New-Game_002c-Menu-Item-6"></a>Resets XBoard and the chess engine to the beginning of a new chess
-game. The <kbd>r</kbd> key is a keyboard equivalent. In Internet Chess
-Server mode, clears the current state of XBoard, then
-resynchronizes with the ICS by sending a refresh command. If you want to
-stop playing, observing, or examining an ICS game, use an
-appropriate command from the Action menu, not &lsquo;<samp><span class="samp">New Game</span></samp>&rsquo;. 
-See <a href="Action-Menu.html#Action-Menu">Action Menu</a>. 
-<br><dt>New Shuffle Game<dd><a name="index-New-Shuffle-Game_002c-Menu-Item-7"></a>Similar to &lsquo;<samp><span class="samp">New Game</span></samp>&rsquo;, but allows you to specify a particular initial position
-(according to a standardized numbering system)
-in chess variants which use randomized opening positions (e.g. Chess960). 
-The selected opening position will persistently be chosen on any following
-New Game command until you use this menu to select another. Selecting
-position number -1 will produce a newly randomized position on any new game. 
-Using this menu item in variants that normally do not shuffle their opening position
-does cause these variants to become shuffle variants until you use the
-&lsquo;<samp><span class="samp">New Shuffle Game</span></samp>&rsquo; menu to explicitly switch the randomization off,
-or select a new variant. 
-<br><dt>New Variant<dd><a name="index-New-variant_002c-Menu-Item-8"></a>Allows you to select a new chess variant in non-ICS mode. 
-(In ICS play, the ICS is responsible for deciding which variant will be played,
-and XBoard adapts autmatically.) If you play with an engine, the engine must
-be able to play the selected variant, or the command will be ignored. 
-XBoard supports all major variants, such as xiangqi, shogi, chess, chess960,
-Capablanca Chess, shatranj, crazyhous, bughouse. 
-<br><dt>Load Game<dd><a name="index-Load-Game_002c-Menu-Item-9"></a>Plays a game from a record file. The <kbd>g</kbd> key is a keyboard equivalent. 
-A popup dialog prompts you for the file name. If the file contains more
-than one game, a second popup dialog
-displays a list of games (with information drawn from their PGN tags, if
-any), and you can select the one you want. Alternatively, you can load the
-Nth game in the file directly, by typing the number <kbd>N</kbd> after the
-file name, separated by a space.
-
-     <p>The game file parser will accept PGN (portable game notation),
-or in fact almost any file that contains moves in algebraic
-notation. 
-Notation of the form &lsquo;<samp><span class="samp">P@f7</span></samp>&rsquo;
-is accepted for piece-drops in bughouse games;
-this is a nonstandard extension to PGN. 
-If the file includes a PGN position (FEN tag), or an old-style
-XBoard position diagram bracketed by &lsquo;<samp><span class="samp">[--</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--]</span></samp>&rsquo;
-before the first move, the game starts from that position. Text
-enclosed in parentheses, square brackets, or curly braces is assumed to
-be commentary and is displayed in a pop-up window. Any other
-text in the file is ignored. PGN variations (enclosed in
-parentheses) are treated as comments; XBoard is not able to walk
-variation trees. 
-The nonstandard PGN tag [Variant "varname"] functions similarly to
-the -variant command-line option (see below), allowing games in certain chess
-variants to be loaded.  There is also a heuristic to
-recognize chess variants from the Event tag, by looking for the strings
-that the Internet Chess Servers put there when saving variant ("wild") games. 
-<br><dt>Load Next Game<dd><a name="index-Load-Next-Game_002c-Menu-Item-10"></a>Loads the next game from the last game record file you loaded. 
-The shifted <kbd>N</kbd> key is a keyboard equivalent. 
-<br><dt>Load Previous Game<dd><a name="index-Load-Previous-Game_002c-Menu-Item-11"></a>Loads the previous game from the last game record file you
-loaded.  The shifted <kbd>P</kbd> key is a keyboard equivalent. 
-Not available if the last game was loaded from a pipe. 
-<br><dt>Reload Same Game<dd><a name="index-Reload-Same-Game_002c-Menu-Item-12"></a>Reloads the last game you loaded. 
-Not available if the last game was loaded from a pipe. 
-<br><dt>Save Game<dd><a name="index-Save-Game_002c-Menu-Item-13"></a>Appends a record of the current game to a file. 
-A popup dialog
-prompts you for the file name. If the game did not begin with
-the standard starting position, the game file includes the
-starting position used. Games are saved in the PGN (portable
-game notation) format, unless the oldSaveStyle option is true,
-in which case they are saved in an older format that is specific
-to XBoard. Both formats are human-readable, and both can be
-read back by the &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; command. 
-Notation of the form &lsquo;<samp><span class="samp">P@f7</span></samp>&rsquo;
-is accepted for piece-drops in bughouse games;
-this is a nonstandard extension to PGN. 
-<br><dt>Copy Game<dd><a name="index-Copy-Game_002c-Menu-Item-14"></a>Copies a record of the current game to an internal clipboard in PGN
-format and sets the X selection to the game text.  The game can be
-pasted to another application (such as a text editor or another copy
-of XBoard) using that application's paste command.  In many X
-applications, such as xterm and emacs, the middle mouse button can be
-used for pasting; in XBoard, you must use the Paste Game command. 
-<br><dt>Paste Game<dd><a name="index-Paste-Game_002c-Menu-Item-15"></a>Interprets the current X selection as a game record and loads it, as
-with Load Game. 
-<br><dt>Load Position<dd><a name="index-Load-Position_002c-Menu-Item-16"></a>Sets up a position from a position file.  A popup dialog prompts
-you for the file name. If the file contains more than one saved
-position, and you want to load the Nth one, type the number N
-after the file name, separated by a space. Position files must
-be in FEN (Forsythe-Edwards notation), or in the format that the
-Save Position command writes when oldSaveStyle is turned on. 
-<br><dt>Load Next Position<dd><a name="index-Load-Next-Position_002c-Menu-Item-17"></a>Loads the next position from the last position file you loaded. 
-<br><dt>Load Previous Position<dd><a name="index-Load-Previous-Position_002c-Menu-Item-18"></a>Loads the previous position from the last position file you
-loaded.  Not available if the last position was loaded from a pipe. 
-<br><dt>Reload Same Position<dd><a name="index-Reload-Same-Position_002c-Menu-Item-19"></a>Reloads the last position you loaded. 
-Not available if the last position was loaded from a pipe. 
-<br><dt>Save Position<dd><a name="index-Save-Game_002c-Menu-Item-20"></a>Appends a diagram of the current position to a file. 
-A popup dialog
-prompts you for the file name. Positions are saved in
-FEN (Forsythe-Edwards notation) format unless the <code>oldSaveStyle</code>
-option is true, in which case they are saved in an older,
-human-readable format that is specific to XBoard. Both formats
-can be read back by the &lsquo;<samp><span class="samp">Load Position</span></samp>&rsquo; command. 
-<br><dt>Copy Position<dd><a name="index-Copy-Position_002c-Menu-Item-21"></a>Copies the current position to an internal clipboard in FEN format and
-sets the X selection to the position text.  The position can be pasted
-to another application (such as a text editor or another copy of
-XBoard) using that application's paste command.  In many X
-applications, such as xterm and emacs, the middle mouse button can be
-used for pasting; in XBoard, you must use the Paste Position command. 
-<br><dt>Paste Position<dd><a name="index-Paste-Position_002c-Menu-Item-22"></a>Interprets the current X selection as a FEN position and loads it, as
-with Load Position. 
-<br><dt>Mail Move<dt>Reload CMail Message<dd><a name="index-Mail-Move_002c-Menu-Item-23"></a><a name="index-Reload-CMail-Message_002c-Menu-Item-24"></a>See <a href="CMail.html#CMail">CMail</a>. 
-<br><dt>Exit<dd><a name="index-Exit_002c-Menu-Item-25"></a>Exits from XBoard. The shifted <kbd>Q</kbd> key is a keyboard equivalent. 
+<dt>New Game<dd><a name="index-New-Game_002c-Menu-Item-6"></a>Resets XBoard and the chess engine to the beginning of a new chess\r
+game. The <kbd>r</kbd> key is a keyboard equivalent. In Internet Chess\r
+Server mode, clears the current state of XBoard, then\r
+resynchronizes with the ICS by sending a refresh command. If you want to\r
+stop playing, observing, or examining an ICS game, use an\r
+appropriate command from the Action menu, not &lsquo;<samp><span class="samp">New Game</span></samp>&rsquo;.\r
+See <a href="Action-Menu.html#Action-Menu">Action Menu</a>.\r
+<br><dt>New Shuffle Game<dd><a name="index-New-Shuffle-Game_002c-Menu-Item-7"></a>Similar to &lsquo;<samp><span class="samp">New Game</span></samp>&rsquo;, but allows you to specify a particular initial position \r
+(according to a standardized numbering system)\r
+in chess variants which use randomized opening positions (e.g. Chess960).\r
+The selected opening position will persistently be chosen on any following\r
+New Game command until you use this menu to select another. Selecting\r
+position number -1 will produce a newly randomized position on any new game.\r
+Using this menu item in variants that normally do not shuffle their opening position\r
+does cause these variants to become shuffle variants until you use the\r
+&lsquo;<samp><span class="samp">New Shuffle Game</span></samp>&rsquo; menu to explicitly switch the randomization off,\r
+or select a new variant.\r
+<br><dt>New Variant<dd><a name="index-New-variant_002c-Menu-Item-8"></a>Allows you to select a new chess variant in non-ICS mode. \r
+(In ICS play, the ICS is responsible for deciding which variant will be played,\r
+and XBoard adapts autmatically.) If you play with an engine, the engine must\r
+be able to play the selected variant, or the command will be ignored.\r
+XBoard supports all major variants, such as xiangqi, shogi, chess, chess960,\r
+Capablanca Chess, shatranj, crazyhous, bughouse.\r
+<br><dt>Load Game<dd><a name="index-Load-Game_002c-Menu-Item-9"></a>Plays a game from a record file. The <kbd>g</kbd> key is a keyboard equivalent.\r
+A popup dialog prompts you for the file name. If the file contains more\r
+than one game, a second popup dialog\r
+displays a list of games (with information drawn from their PGN tags, if\r
+any), and you can select the one you want. Alternatively, you can load the\r
+Nth game in the file directly, by typing the number <kbd>N</kbd> after the\r
+file name, separated by a space.\r
+\r
+The game file parser will accept PGN (portable game notation),\r
+or in fact almost any file that contains moves in algebraic\r
+notation. \r
+Notation of the form &lsquo;<samp><span class="samp">P@f7</span></samp>&rsquo;\r
+is accepted for piece-drops in bughouse games;\r
+this is a nonstandard extension to PGN.\r
+If the file includes a PGN position (FEN tag), or an old-style\r
+XBoard position diagram bracketed by &lsquo;<samp><span class="samp">[--</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--]</span></samp>&rsquo;\r
+before the first move, the game starts from that position. Text\r
+enclosed in parentheses, square brackets, or curly braces is assumed to\r
+be commentary and is displayed in a pop-up window. Any other\r
+text in the file is ignored. PGN variations (enclosed in\r
+parentheses) are treated as comments; XBoard is not able to walk\r
+variation trees.\r
+The nonstandard PGN tag [Variant "varname"] functions similarly to\r
+the -variant command-line option (see below), allowing games in certain chess\r
+variants to be loaded.  There is also a heuristic to \r
+recognize chess variants from the Event tag, by looking for the strings\r
+that the Internet Chess Servers put there when saving variant ("wild") games.\r
+<br><dt>Load Next Game<dd><a name="index-Load-Next-Game_002c-Menu-Item-10"></a>Loads the next game from the last game record file you loaded.\r
+The shifted <kbd>N</kbd> key is a keyboard equivalent.\r
+<br><dt>Load Previous Game<dd><a name="index-Load-Previous-Game_002c-Menu-Item-11"></a>Loads the previous game from the last game record file you\r
+loaded.  The shifted <kbd>P</kbd> key is a keyboard equivalent.\r
+Not available if the last game was loaded from a pipe.\r
+<br><dt>Reload Same Game<dd><a name="index-Reload-Same-Game_002c-Menu-Item-12"></a>Reloads the last game you loaded.\r
+Not available if the last game was loaded from a pipe.\r
+<br><dt>Save Game<dd><a name="index-Save-Game_002c-Menu-Item-13"></a>Appends a record of the current game to a file.\r
+A popup dialog\r
+prompts you for the file name. If the game did not begin with\r
+the standard starting position, the game file includes the\r
+starting position used. Games are saved in the PGN (portable\r
+game notation) format, unless the oldSaveStyle option is true,\r
+in which case they are saved in an older format that is specific\r
+to XBoard. Both formats are human-readable, and both can be\r
+read back by the &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; command.\r
+Notation of the form &lsquo;<samp><span class="samp">P@f7</span></samp>&rsquo;\r
+is accepted for piece-drops in bughouse games;\r
+this is a nonstandard extension to PGN.\r
+<br><dt>Copy Game<dd><a name="index-Copy-Game_002c-Menu-Item-14"></a>Copies a record of the current game to an internal clipboard in PGN\r
+format and sets the X selection to the game text.  The game can be\r
+pasted to another application (such as a text editor or another copy\r
+of XBoard) using that application's paste command.  In many X\r
+applications, such as xterm and emacs, the middle mouse button can be\r
+used for pasting; in XBoard, you must use the Paste Game command.\r
+<br><dt>Paste Game<dd><a name="index-Paste-Game_002c-Menu-Item-15"></a>Interprets the current X selection as a game record and loads it, as\r
+with Load Game.\r
+<br><dt>Load Position<dd><a name="index-Load-Position_002c-Menu-Item-16"></a>Sets up a position from a position file.  A popup dialog prompts\r
+you for the file name. If the file contains more than one saved\r
+position, and you want to load the Nth one, type the number N\r
+after the file name, separated by a space. Position files must\r
+be in FEN (Forsythe-Edwards notation), or in the format that the\r
+Save Position command writes when oldSaveStyle is turned on.\r
+<br><dt>Load Next Position<dd><a name="index-Load-Next-Position_002c-Menu-Item-17"></a>Loads the next position from the last position file you loaded.\r
+<br><dt>Load Previous Position<dd><a name="index-Load-Previous-Position_002c-Menu-Item-18"></a>Loads the previous position from the last position file you\r
+loaded.  Not available if the last position was loaded from a pipe.\r
+<br><dt>Reload Same Position<dd><a name="index-Reload-Same-Position_002c-Menu-Item-19"></a>Reloads the last position you loaded.\r
+Not available if the last position was loaded from a pipe.\r
+<br><dt>Save Position<dd><a name="index-Save-Game_002c-Menu-Item-20"></a>Appends a diagram of the current position to a file.\r
+A popup dialog\r
+prompts you for the file name. Positions are saved in\r
+FEN (Forsythe-Edwards notation) format unless the <code>oldSaveStyle</code>\r
+option is true, in which case they are saved in an older,\r
+human-readable format that is specific to XBoard. Both formats\r
+can be read back by the &lsquo;<samp><span class="samp">Load Position</span></samp>&rsquo; command.\r
+<br><dt>Copy Position<dd><a name="index-Copy-Position_002c-Menu-Item-21"></a>Copies the current position to an internal clipboard in FEN format and\r
+sets the X selection to the position text.  The position can be pasted\r
+to another application (such as a text editor or another copy of\r
+XBoard) using that application's paste command.  In many X\r
+applications, such as xterm and emacs, the middle mouse button can be\r
+used for pasting; in XBoard, you must use the Paste Position command.\r
+<br><dt>Paste Position<dd><a name="index-Paste-Position_002c-Menu-Item-22"></a>Interprets the current X selection as a FEN position and loads it, as\r
+with Load Position.\r
+<br><dt>Mail Move<dt>Reload CMail Message<dd><a name="index-Mail-Move_002c-Menu-Item-23"></a><a name="index-Reload-CMail-Message_002c-Menu-Item-24"></a>See <a href="CMail.html#CMail">CMail</a>.\r
+<br><dt>Exit<dd><a name="index-Exit_002c-Menu-Item-25"></a>Exits from XBoard. The shifted <kbd>Q</kbd> key is a keyboard equivalent.\r
 </dl>
+   \r
 
    </body></html>