manual/html_node/File-Menu.html

   1 <html lang="en">
   2 <head>
   3 <title>File Menu - XBoard</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="XBoard">
   6 <meta name="generator" content="makeinfo 4.13">
   7 <link title="Top" rel="start" href="index.html#Top">
   8 <link rel="up" href="Menus.html#Menus" title="Menus">
   9 <link rel="next" href="Edit-Menu.html#Edit-Menu" title="Edit Menu">
  10 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
  11 <meta http-equiv="Content-Style-Type" content="text/css">
  12 <style type="text/css"><!--
  13   pre.display { font-family:inherit }
  14   pre.format  { font-family:inherit }
  15   pre.smalldisplay { font-family:inherit; font-size:smaller }
  16   pre.smallformat  { font-family:inherit; font-size:smaller }
  17   pre.smallexample { font-size:smaller }
  18   pre.smalllisp    { font-size:smaller }
  19   span.sc    { font-variant:small-caps }
  20   span.roman { font-family:serif; font-weight:normal; }
  21   span.sansserif { font-family:sans-serif; font-weight:normal; }
  22 --></style>
  23 </head>
  24 <body>
  25 <div class="node">
  26 <a name="File-Menu"></a>
  27 <p>
  28 Next:&nbsp;<a rel="next" accesskey="n" href="Edit-Menu.html#Edit-Menu">Edit Menu</a>,
  29 Up:&nbsp;<a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
  30 <hr>
  31 </div>
  32
  33 <h3 class="section">3.1 File Menu</h3>
  34
  35 <p><a name="index-File-Menu-5"></a><a name="index-Menu_002c-File-6"></a>
  36      <dl>
  37 <dt>New Game<dd><a name="index-New-Game_002c-Menu-Item-7"></a>Resets XBoard and the chess engine to the beginning of a new chess
  38 game. The <kbd>Ctrl-N</kbd> key is a keyboard equivalent. In Internet Chess
  39 Server mode, clears the current state of XBoard, then
  40 resynchronizes with the ICS by sending a refresh command. If you want to
  41 stop playing, observing, or examining an ICS game, use an
  42 appropriate command from the Action menu, not &lsquo;<samp><span class="samp">New Game</span></samp>&rsquo;.
  43 See <a href="Action-Menu.html#Action-Menu">Action Menu</a>.
  44 <br><dt>New Shuffle Game<dd><a name="index-New-Shuffle-Game_002c-Menu-Item-8"></a>Similar to &lsquo;<samp><span class="samp">New Game</span></samp>&rsquo;, but allows you to specify a particular initial position
  45 (according to a standardized numbering system)
  46 in chess variants which use randomized opening positions (e.g. Chess960).
  47 You can also press the &lsquo;<samp><span class="samp">Pick Fixed</span></samp>&rsquo; button to let XBoard generate
  48 a random number for you.
  49 The thus selected opening position will then persistently be chosen on any following
  50 New Game command until you use this menu to select another.
  51 Selecting position number -1 (or pushing the &lsquo;<samp><span class="samp">Randomize</span></samp>&rsquo; button)
  52 will produce a newly randomized position on any new game.
  53 Using this menu item in variants that normally do not shuffle their opening position
  54 does cause these variants to become shuffle variants until you use the
  55 &lsquo;<samp><span class="samp">New Shuffle Game</span></samp>&rsquo; menu to explicitly switch the randomization off,
  56 or select a new variant.
  57 <br><dt>New Variant<dd><a name="index-New-variant_002c-Menu-Item-9"></a>Allows you to select a new chess variant in non-ICS mode.
  58 (In ICS play, the ICS is responsible for deciding which variant will be played,
  59 and XBoard adapts automatically.)  The shifted <kbd>Alt+V</kbd> key is a
  60 keyboard equivalent. If you play with an engine, the engine must
  61 be able to play the selected variant, or the command will be ignored.
  62 XBoard supports all major variants, such as xiangqi, shogi, chess, chess960,
  63 Capablanca Chess, shatranj, crazyhouse, bughouse.
  64 But not every board size has built-in bitmaps for un-orthodox pieces!
  65 Only sizes bulky (72) and middling (49) have all pieces,
  66 while size petite (33) has most.
  67 These sizes would have to be set at startup through the <code>size</code>
  68 command-line option when you start up XBoard for such variants to be playable.
  69
  70      <p>You can overrule the default board format of the selected variant,
  71 (e.g. to play suicide chess on a 6 x 6 board),
  72 in this dialog, but normally you would not do that,
  73 and leave them at '-1', which means 'default'.
  74 <br><dt>Load Game<dd><a name="index-Load-Game_002c-Menu-Item-10"></a>Plays a game from a record file. The <kbd>Ctrl-O</kbd> key is a keyboard equivalent.
  75 A pop-up dialog prompts you for the file name. If the file contains more
  76 than one game, a second pop-up dialog
  77 displays a list of games (with information drawn from their PGN tags, if
  78 any), and you can select the one you want. Alternatively, you can load the
  79 Nth game in the file directly, by typing the number <kbd>N</kbd> after the
  80 file name, separated by a space.
  81
  82      <p>The game file parser will accept PGN (portable game notation),
  83 or in fact almost any file that contains moves in algebraic
  84 notation.
  85 Notation of the form &lsquo;<samp><span class="samp">P@f7</span></samp>&rsquo;
  86 is accepted for piece-drops in bughouse games;
  87 this is a nonstandard extension to PGN.
  88 If the file includes a PGN position (FEN tag), or an old-style
  89 XBoard position diagram bracketed by &lsquo;<samp><span class="samp">[--</span></samp>&rsquo; and &lsquo;<samp><span class="samp">--]</span></samp>&rsquo;
  90 before the first move, the game starts from that position. Text
  91 enclosed in parentheses, square brackets, or curly braces is assumed to
  92 be commentary and is displayed in a pop-up window. Any other
  93 text in the file is ignored. PGN variations (enclosed in
  94 parentheses) also are treated as comments;
  95 however, if you rights-click them in the comment window,
  96 XBoard will shelve the current line, and load the the selected variation,
  97 so you can step through it.
  98 You can later revert to the previous line with the &lsquo;<samp><span class="samp">Revert</span></samp>&rsquo; command.
  99 This way you can walk quite complex varation trees with XBoard.
 100 The nonstandard PGN tag [Variant "varname"] functions similarly to
 101 the -variant command-line option (see below), allowing games in certain chess
 102 variants to be loaded.
 103 Note that it must appear before any FEN tag for XBoard to recognize
 104 variant FENs appropriately.
 105 There is also a heuristic to
 106 recognize chess variants from the Event tag, by looking for the strings
 107 that the Internet Chess Servers put there when saving variant ("wild") games.
 108 <br><dt>Load Position<dd><a name="index-Load-Position_002c-Menu-Item-11"></a>Sets up a position from a position file.  A pop-up dialog prompts
 109 you for the file name.  The shifted <kbd>Ctrl-O</kbd> key is a keyboard
 110 equivalent. If the file contains more than one saved
 111 position, and you want to load the Nth one, type the number N
 112 after the file name, separated by a space. Position files must
 113 be in FEN (Forsythe-Edwards notation), or in the format that the
 114 Save Position command writes when oldSaveStyle is turned on.
 115 <br><dt>Load Next Position<dd><a name="index-Load-Next-Position_002c-Menu-Item-12"></a>Loads the next position from the last position file you loaded.
 116 The shifted <kbd>PgDn</kbd> key is a keyboard equivalent.
 117 <br><dt>Load Previous Position<dd><a name="index-Load-Previous-Position_002c-Menu-Item-13"></a>Loads the previous position from the last position file you
 118 loaded. The shifted <kbd>PgUp</kbd> key is a keyboard equivalent.
 119 Not available if the last position was loaded from a pipe.
 120 <br><dt>Save Game<dd><a name="index-Save-Game_002c-Menu-Item-14"></a>Appends a record of the current game to a file.
 121 The <kbd>Ctrl-S</kbd> key is a keyboard equivalent.
 122 A pop-up dialog
 123 prompts you for the file name. If the game did not begin with
 124 the standard starting position, the game file includes the
 125 starting position used. Games are saved in the PGN (portable
 126 game notation) format, unless the oldSaveStyle option is true,
 127 in which case they are saved in an older format that is specific
 128 to XBoard. Both formats are human-readable, and both can be
 129 read back by the &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo; command.
 130 Notation of the form &lsquo;<samp><span class="samp">P@f7</span></samp>&rsquo;
 131 is accepted for piece-drops in bughouse games;
 132 this is a nonstandard extension to PGN.
 133 <br><dt>Save Position<dd><a name="index-Save-Position_002c-Menu-Item-15"></a>Appends a diagram of the current position to a file.
 134 The shifted <kbd>Ctrl+S</kbd> key is a keyboard equivalent.
 135 A pop-up dialog prompts you for the file name. Positions are saved in
 136 FEN (Forsythe-Edwards notation) format unless the <code>oldSaveStyle</code>
 137 option is true, in which case they are saved in an older,
 138 human-readable format that is specific to XBoard. Both formats
 139 can be read back by the &lsquo;<samp><span class="samp">Load Position</span></samp>&rsquo; command.
 140 <br><dt>Mail Move<dt>Reload CMail Message<dd><a name="index-Mail-Move_002c-Menu-Item-16"></a><a name="index-Reload-CMail-Message_002c-Menu-Item-17"></a>See <a href="CMail.html#CMail">CMail</a>.
 141 <br><dt>Exit<dd><a name="index-Exit_002c-Menu-Item-18"></a>Exits from XBoard. The <kbd>Ctrl-Q</kbd> key is a keyboard equivalent.
 142 </dl>
 143
 144    </body></html>
 145