Next: , Up: Menus


3.1 File Menu

New Game
Resets XBoard and the chess engine to the beginning of a new chess game. The Ctrl-N 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 ‘New Game’. See Action Menu.
New Shuffle Game
Similar to ‘New Game’, 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). You can also press the ‘Pick Fixed’ button to let XBoard generate a random number for you. The thus selected opening position will then persistently be chosen on any following New Game command until you use this menu to select another. Selecting position number -1 (or pushing the ‘Randomize’ button) 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 ‘New Shuffle Game’ menu to explicitly switch the randomization off, or select a new variant.
New Variant
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 automatically.) The shifted Alt+V key is a keyboard equivalent. 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, crazyhouse, bughouse. But not every board size has built-in bitmaps for un-orthodox pieces! Only sizes bulky (72) and middling (49) have all pieces, while size petite (33) has most. These sizes would have to be set at startup through the size command-line option when you start up XBoard for such variants to be playable.

You can overrule the default board format of the selected variant, (e.g. to play suicide chess on a 6 x 6 board), in this dialog, but normally you would not do that, and leave them at '-1', which means 'default'.

Load Game
Plays a game from a record file. The Ctrl-O key is a keyboard equivalent. A pop-up dialog prompts you for the file name. If the file contains more than one game, a second pop-up 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 N after the file name, separated by a space.

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 ‘P@f7’ 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 ‘[--’ and ‘--]’ 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) also are treated as comments; however, if you rights-click them in the comment window, XBoard will shelve the current line, and load the the selected variation, so you can step through it. You can later revert to the previous line with the ‘Revert’ command. This way you can walk quite complex varation trees with XBoard. 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. Note that it must appear before any FEN tag for XBoard to recognize variant FENs appropriately. 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.

Load Position
Sets up a position from a position file. A pop-up dialog prompts you for the file name. The shifted Ctrl-O key is a keyboard equivalent. 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.
Load Next Position
Loads the next position from the last position file you loaded. The shifted PgDn key is a keyboard equivalent.
Load Previous Position
Loads the previous position from the last position file you loaded. The shifted PgUp key is a keyboard equivalent. Not available if the last position was loaded from a pipe.
Save Game
Appends a record of the current game to a file. The Ctrl-S key is a keyboard equivalent. A pop-up 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 ‘Load Game’ command. Notation of the form ‘P@f7’ is accepted for piece-drops in bughouse games; this is a nonstandard extension to PGN.
Save Position
Appends a diagram of the current position to a file. The shifted Ctrl+S key is a keyboard equivalent. A pop-up dialog prompts you for the file name. Positions are saved in FEN (Forsythe-Edwards notation) format unless the oldSaveStyle 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 ‘Load Position’ command.
Save Selected Games
Will cause all games selected for display in the current Game List to be appended to a file of the user's choice.
Save Games as Book
Creates an opening book from the currently loaded game file, incorporating only the games currently selected in the Game List. The book will be saved on the file specified in the ‘Common Engine’ options dialog. The value of ‘Book Depth’ specified in that same dialog will be used to determine how many moves of each game will be added to the internal book buffer. This command can take a long time to process, and the size of the buffer is currently limited. At the end the buffer will be saved as a Polyglot book, but the buffer will not be cleared, so that you can continue adding games from other game files.
Mail Move
Reload CMail Message
See CMail.
Exit
Exits from XBoard. The Ctrl-Q key is a keyboard equivalent.