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.12">
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="Mode-Menu.html#Mode-Menu" title="Mode 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; }
27 <a name="File-Menu"></a>
28 Next: <a rel="next" accesskey="n" href="Mode-Menu.html#Mode-Menu">Mode Menu</a>,
29 Up: <a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
33 <h3 class="section">2.1 File Menu</h3>
35 <p><a name="index-File-Menu-4"></a><a name="index-Menu_002c-File-5"></a>
37 <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
38 game. The <kbd>r</kbd> key is a keyboard equivalent. In Internet Chess
\r
39 Server mode, clears the current state of XBoard, then
\r
40 resynchronizes with the ICS by sending a refresh command. If you want to
\r
41 stop playing, observing, or examining an ICS game, use an
\r
42 appropriate command from the Action menu, not ‘<samp><span class="samp">New Game</span></samp>’.
\r
43 See <a href="Action-Menu.html#Action-Menu">Action Menu</a>.
\r
44 <br><dt>New Shuffle Game<dd><a name="index-New-Shuffle-Game_002c-Menu-Item-7"></a>Similar to ‘<samp><span class="samp">New Game</span></samp>’, but allows you to specify a particular initial position
\r
45 (according to a standardized numbering system)
\r
46 in chess variants which use randomized opening positions (e.g. Chess960).
\r
47 The selected opening position will persistently be chosen on any following
\r
48 New Game command until you use this menu to select another. Selecting
\r
49 position number -1 will produce a newly randomized position on any new game.
\r
50 Using this menu item in variants that normally do not shuffle their opening position
\r
51 does cause these variants to become shuffle variants until you use the
\r
52 ‘<samp><span class="samp">New Shuffle Game</span></samp>’ menu to explicitly switch the randomization off,
\r
53 or select a new variant.
\r
54 <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
55 (In ICS play, the ICS is responsible for deciding which variant will be played,
\r
56 and XBoard adapts autmatically.) If you play with an engine, the engine must
\r
57 be able to play the selected variant, or the command will be ignored.
\r
58 XBoard supports all major variants, such as xiangqi, shogi, chess, chess960,
\r
59 Capablanca Chess, shatranj, crazyhous, bughouse.
\r
60 <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
61 A popup dialog prompts you for the file name. If the file contains more
\r
62 than one game, a second popup dialog
\r
63 displays a list of games (with information drawn from their PGN tags, if
\r
64 any), and you can select the one you want. Alternatively, you can load the
\r
65 Nth game in the file directly, by typing the number <kbd>N</kbd> after the
\r
66 file name, separated by a space.
\r
68 The game file parser will accept PGN (portable game notation),
\r
69 or in fact almost any file that contains moves in algebraic
\r
71 Notation of the form ‘<samp><span class="samp">P@f7</span></samp>’
\r
72 is accepted for piece-drops in bughouse games;
\r
73 this is a nonstandard extension to PGN.
\r
74 If the file includes a PGN position (FEN tag), or an old-style
\r
75 XBoard position diagram bracketed by ‘<samp><span class="samp">[--</span></samp>’ and ‘<samp><span class="samp">--]</span></samp>’
\r
76 before the first move, the game starts from that position. Text
\r
77 enclosed in parentheses, square brackets, or curly braces is assumed to
\r
78 be commentary and is displayed in a pop-up window. Any other
\r
79 text in the file is ignored. PGN variations (enclosed in
\r
80 parentheses) are treated as comments; XBoard is not able to walk
\r
82 The nonstandard PGN tag [Variant "varname"] functions similarly to
\r
83 the -variant command-line option (see below), allowing games in certain chess
\r
84 variants to be loaded. There is also a heuristic to
\r
85 recognize chess variants from the Event tag, by looking for the strings
\r
86 that the Internet Chess Servers put there when saving variant ("wild") games.
\r
87 <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
88 The shifted <kbd>N</kbd> key is a keyboard equivalent.
\r
89 <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
90 loaded. The shifted <kbd>P</kbd> key is a keyboard equivalent.
\r
91 Not available if the last game was loaded from a pipe.
\r
92 <br><dt>Reload Same Game<dd><a name="index-Reload-Same-Game_002c-Menu-Item-12"></a>Reloads the last game you loaded.
\r
93 Not available if the last game was loaded from a pipe.
\r
94 <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
96 prompts you for the file name. If the game did not begin with
\r
97 the standard starting position, the game file includes the
\r
98 starting position used. Games are saved in the PGN (portable
\r
99 game notation) format, unless the oldSaveStyle option is true,
\r
100 in which case they are saved in an older format that is specific
\r
101 to XBoard. Both formats are human-readable, and both can be
\r
102 read back by the ‘<samp><span class="samp">Load Game</span></samp>’ command.
\r
103 Notation of the form ‘<samp><span class="samp">P@f7</span></samp>’
\r
104 is accepted for piece-drops in bughouse games;
\r
105 this is a nonstandard extension to PGN.
\r
106 <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
107 format and sets the X selection to the game text. The game can be
\r
108 pasted to another application (such as a text editor or another copy
\r
109 of XBoard) using that application's paste command. In many X
\r
110 applications, such as xterm and emacs, the middle mouse button can be
\r
111 used for pasting; in XBoard, you must use the Paste Game command.
\r
112 <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
114 <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
115 you for the file name. If the file contains more than one saved
\r
116 position, and you want to load the Nth one, type the number N
\r
117 after the file name, separated by a space. Position files must
\r
118 be in FEN (Forsythe-Edwards notation), or in the format that the
\r
119 Save Position command writes when oldSaveStyle is turned on.
\r
120 <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
121 <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
122 loaded. Not available if the last position was loaded from a pipe.
\r
123 <br><dt>Reload Same Position<dd><a name="index-Reload-Same-Position_002c-Menu-Item-19"></a>Reloads the last position you loaded.
\r
124 Not available if the last position was loaded from a pipe.
\r
125 <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
127 prompts you for the file name. Positions are saved in
\r
128 FEN (Forsythe-Edwards notation) format unless the <code>oldSaveStyle</code>
\r
129 option is true, in which case they are saved in an older,
\r
130 human-readable format that is specific to XBoard. Both formats
\r
131 can be read back by the ‘<samp><span class="samp">Load Position</span></samp>’ command.
\r
132 <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
133 sets the X selection to the position text. The position can be pasted
\r
134 to another application (such as a text editor or another copy of
\r
135 XBoard) using that application's paste command. In many X
\r
136 applications, such as xterm and emacs, the middle mouse button can be
\r
137 used for pasting; in XBoard, you must use the Paste Position command.
\r
138 <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
139 with Load Position.
\r
140 <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
141 <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
projects / xboard.git / blob