Put warning in HTML help
[xboard.git] / winboard / help / html / 03.htm
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\r
2 <HTML>\r
3 <HEAD>\r
4 <META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">\r
5 <TITLE>File Menu</TITLE>\r
6 </HEAD>\r
7 \r
8 <BODY BGCOLOR="#FFFFFF" TEXT="#000000">\r
9 \r
10 \r
11 \r
12 <P><B><A NAME="filemenu"></A>File Menu</B></P>\r
13 \r
14 \r
15 \r
16 <P><B><A NAME="newgame"></A><font color="#ff0000">New Game</font> <font color="#ff0000">(former</font> Reset<font color="#ff0000">)</font></B></P>\r
17 \r
18 <P>Resets WinBoard and the chess engine (if any) to the beginning of a new chess game. In Internet Chess Server mode, clears the current state of WinBoard, then resynchronizes with ICS by sending a <B>refresh </B>command. If you want to stop playing, observing, or examining a game on ICS, use an appropriate command from the <A HREF="05.htm">Action</A> menu, not <font color="#ff0000">New Game</font>.</P>\r
19 \r
20 \r
21 \r
22 <P><B><A NAME="newshufflegame"></A><font color="#008000">New Shuffle Game</font></B></P>\r
23 \r
24 <P><font color="#ff0000">Brings you to a dialog box where you can enter the number of an opening setup for shuffle variants like FRC, or ask for a random number. After pressing OK, a new game is set up, using this position. The chosen position will continue to be used on every subsequent \93New Game\94,</font> <font color="#008000">even if you are playing a variant that normally is not shuffled, until you select a new variant through the \93New Variant\85\94 menu.</font> <font color="#ff0000">If you enter \93-1\94 for the position number,  new random number is drawn before every game.</font></P>\r
25 \r
26 <P><font color="#008000">The type of shuffling that is done in reaction to a given position number obeys restrictions that depend on the selected variant. In variants that allow castling, Kings remain on the central files, Rooks in the corners. In games with FRC-style castlings, the King starts between the Rooks, but apart from that they could be anywhere. In games without castling, there are no restrictions on King and Rook placement. Pairs of color-bound pieces (such as Bishops) will be placed on oppositely colored squares. In ICS mode this feature has no effect, as the ICS determines the starting position.</font></P>\r
27 \r
28 \r
29 \r
30 <P><B><A NAME="newvariant"></A><font color="#008000">New Variant</font></B></P>\r
31 \r
32 <P><font color="#008000">Select a new variant. There are controls to enter a board width, board height and holdings size, but normally you leave them at \91-1\92, which means the default value for the selected variant will be used (e.g. 8x8 for normal Chess, 9x10 for xiangqi, 10x8 for capablanca, holdings for 5 pieces in crazyhouse). You can set a deviating value for each of the three parameters (e.g. to play a crazyhouse version of xiangqi or capablanca you would set the holdings to 6 or 7). If the board width deviates from the default, the game will start with an empty board.</font></P>\r
33 \r
34 <P><font color="#008000">The variant will remain in force until you select a new one; i.e. subsequent \93New Game\94 commands will start a new game of the same variant. In ICS mode this command has no effect, as the ICS determines which variant will be played.</font></P>\r
35 \r
36 \r
37 \r
38 <P><B><A NAME="loadgame"></A>Load Game</B></P>\r
39 \r
40 <P>Plays a game from a record file. A popup dialog prompts you for the filename. 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.</P>\r
41 \r
42 <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 <I>P@f7</I> 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 a WinBoard 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) <font color="#FF00FF">appear in the comment popup amongst genuine comments; to walk the variation tree, you have to right-click them in this window. This will cause WinBoard to load them as the current line. You can revert to the previous line with the Revert command. (Beware! Currently WinBoard\92s PGN parser is limited to 3 levels of nesting in variations.)</font> The nonstandard PGN tag <CODE>[Variant "varname"]</CODE> functions similarly to the <A HREF="18.htm#variant">variant</A> command-line option, allowing games in certain chess variants to be loaded. <font color="#FF00FF">Note that it has to appear before any FEN tag!</font> There is also a heuristic to recognize chess variants from the <CODE>Event</CODE> tag, by looking for the strings that the Internet Chess Servers put there when saving variant ("wild") games.</P>\r
43 \r
44 \r
45 \r
46 <P><B><A NAME="loadnextgame"></A>Load Next Game</B></P>\r
47 \r
48 <P>Loads the next game from the last game record file you loaded.</P>\r
49 \r
50 \r
51 \r
52 <P><B><A NAME="loadpreviousgame"></A>Load Previous Game</B></P>\r
53 \r
54 <P>Loads the previous game from the last game record file you loaded. Not available if the last game was loaded from a pipe.</P>\r
55 \r
56 \r
57 \r
58 <P><B><A NAME="reloadsamegame"></A>Reload Same Game</B></P>\r
59 \r
60 <P>Reloads the last game you loaded. Not available if the last game was loaded from a pipe.</P>\r
61 \r
62 \r
63 \r
64 <P><B><A NAME="savegame"></A>Save Game</B></P>\r
65 \r
66 <P>Appends a record of the current game to a file. A popup dialog prompts you for the filename. If the game did not begin with the standard starting position, the game file includes the starting position used. Game files are saved in the PGN (portable game notation) format, unless the <A HREF="15.htm#oldsavestyle">oldSaveStyle</A> option is True, in which case they are saved in an older format that is specific to WinBoard. Both formats are human-readable, and both can be read back by the Load Game command. Notation of the form <I>P@f7</I> is generated for piece-drops in bughouse games; this is a nonstandard extension to PGN.</P>\r
67 \r
68 \r
69 \r
70 <P><B><A NAME="copygametoclipboard"></A>Copy Game To Clipboard</B></P>\r
71 \r
72 <P>Copies the record of the current game to the Windows clipboard in PGN (portable game notation) format.</P>\r
73 \r
74 \r
75 \r
76 <P><B><A NAME="pastegamefromclipboard"></A>Paste Game From Clipboard</B></P>\r
77 \r
78 <P>Plays a game from the Windows clipboard. See <A HREF="#loadgame">Load Game</A> for a discussion of game file format and parser behavior.</P>\r
79 \r
80 \r
81 \r
82 <P><B><A NAME="loadposition"></A>Load Position</B></P>\r
83 \r
84 <P>Sets up a position from a position file. A popup dialog prompts you for the filename. Position files must be in FEN (Forsythe-Edwards notation), or in the format that the <U>Save Position</U> command writes when <A HREF="15.htm#oldsavestyle">oldSaveStyle</A> is turned on. <font color="#008000">Note that many variants require an extension of the original FEN standard. WinBoard tries to be as universal as possible in understanding FENs when different standards are raound, but has to make a choice when writing them. In FRC is uses Shredder-FEN (Haha castling notation) , but it understands KQkq as the outermost Rook, so it also reads X-FEN. In Crazyhouse / Bughouse it appends the holdings immediately behind the board info between brackets [], but on input it also understands bFEN (which puts it behind a slash / as if it were an extra board rank). It uses a tilde ~ behind a piece to indicate it is really a promoted Pawn (like bFEN). In Shogi the holdings are printed like in Crazyhouse, but promoted pieces are represented by a plus sign + before the letter of the original piece. Letters used for the pieces can be set with the /pieceToCharTable command-line option.</font></P>\r
85 \r
86 \r
87 \r
88 <P><B><A NAME="loadnextposition"></A>Load Next Position</B></P>\r
89 \r
90 <P>Loads the next position from the last position file you loaded.</P>\r
91 \r
92 \r
93 \r
94 <P><B><A NAME="loadpreviousposition"></A>Load Previous Position</B></P>\r
95 \r
96 <P>Loads the previous position from the last position file you loaded. Not available if the last position was loaded from a pipe.</P>\r
97 \r
98 \r
99 \r
100 <P><B><A NAME="reloadsameposition"></A>Reload Same Position</B></P>\r
101 \r
102 <P>Reloads the last position you loaded. Not available if the last position was loaded from a pipe.</P>\r
103 \r
104 \r
105 \r
106 <P><B><A NAME="saveposition"></A>Save Position</B></P>\r
107 \r
108 <P>Appends a diagram of the current position to a file. A popup dialog prompts you for the filename. Positions are saved in FEN (Forsythe-Edwards notation) format, unless the <A HREF="15.htm#oldsavestyle">oldSaveStyle</A> option is True, in which case they are saved in an older, human-readable format that is specific to WinBoard<I>.</I> Both formats can be read back by the Load Position command; however, currently Load Position can load only the first position in a file.</P>\r
109 \r
110 \r
111 \r
112 <P><B><A NAME="save diagram"></A><font color="#008000">Save Diagram</font></B></P>\r
113 \r
114 <P><font color="#008000">Writes the current board display as a bitmap file. With this command you can use WinBoard as a diagram generator.</font></P>\r
115 \r
116 \r
117 \r
118 <P><B><A NAME="copypositiontoclipboard"></A>Copy Position To Clipboard</B></P>\r
119 \r
120 <P>Places a diagram of the current position (in Forsythe-Edwards notation) into the Windows clipboard.</P>\r
121 \r
122 \r
123 \r
124 <P><B><A NAME="pastepositionfromclipboard"></A>Paste Position From Clipboard</B></P>\r
125 \r
126 <P>Sets up a position from the Windows clipboard. Position must be in FEN (Forsythe-Edwards notation). Puts WinBoard into <A HREF="04.htm#editgame">Edit Game</A> mode if it was not there already.</P>\r
127 \r
128 \r
129 \r
130 <P><B><A NAME="exit"></A>Exit</B></P>\r
131 \r
132 <P>Exits from WinBoard.</P>\r
133 \r
134 </BODY>\r
135 </HTML>\r