manual/html_node/Edit-Menu.html

   1 <html lang="en">
   2 <head>
   3 <title>Edit 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="prev" href="File-Menu.html#File-Menu" title="File Menu">
  10 <link rel="next" href="View-Menu.html#View-Menu" title="View Menu">
  11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
  12 <meta http-equiv="Content-Style-Type" content="text/css">
  13 <style type="text/css"><!--
  14   pre.display { font-family:inherit }
  15   pre.format  { font-family:inherit }
  16   pre.smalldisplay { font-family:inherit; font-size:smaller }
  17   pre.smallformat  { font-family:inherit; font-size:smaller }
  18   pre.smallexample { font-size:smaller }
  19   pre.smalllisp    { font-size:smaller }
  20   span.sc    { font-variant:small-caps }
  21   span.roman { font-family:serif; font-weight:normal; }
  22   span.sansserif { font-family:sans-serif; font-weight:normal; }
  23 --></style>
  24 </head>
  25 <body>
  26 <div class="node">
  27 <a name="Edit-Menu"></a>
  28 <p>
  29 Next:&nbsp;<a rel="next" accesskey="n" href="View-Menu.html#View-Menu">View Menu</a>,
  30 Previous:&nbsp;<a rel="previous" accesskey="p" href="File-Menu.html#File-Menu">File Menu</a>,
  31 Up:&nbsp;<a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
  32 <hr>
  33 </div>
  34
  35 <h3 class="section">2.2 Edit Menu</h3>
  36
  37 <p><a name="index-Menu_002c-Edit-18"></a><a name="index-Edit-Menu-19"></a>
  38      <dl>
  39 <dt>Copy Game<dd><a name="index-Copy-Game_002c-Menu-Item-20"></a>Copies a record of the current game to an internal clipboard in PGN
  40 format and sets the X selection to the game text. The <kbd>Ctrl-C</kbd>
  41 key is a keyboard equivalent. The game can be
  42 pasted to another application (such as a text editor or another copy
  43 of XBoard) using that application's paste command.  In many X
  44 applications, such as xterm and emacs, the middle mouse button can be
  45 used for pasting; in XBoard, you must use the Paste Game command.
  46 <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
  47 sets the X selection to the position text. The shifted <kbd>Ctrl-C</kbd> key
  48 is a keyboard equivalent.  The position can be pasted
  49 to another application (such as a text editor or another copy of
  50 XBoard) using that application's paste command.  In many X
  51 applications, such as xterm and emacs, the middle mouse button can be
  52 used for pasting; in XBoard, you must use the Paste Position command.
  53 <br><dt>Paste Game<dd><a name="index-Paste-Game_002c-Menu-Item-22"></a>Interprets the current X selection as a game record and loads it, as
  54 with Load Game. The <kbd>Ctrl-V</kbd> key is a keyboard equivalent.
  55 <br><dt>Paste Position<dd><a name="index-Paste-Position_002c-Menu-Item-23"></a>Interprets the current X selection as a FEN position and loads it, as
  56 with Load Position. The shifted <kbd>Ctrl-V</kbd> key is a keyboard equivalent.
  57 <br><dt>Edit Game<dd><a name="index-Edit-Game_002c-Menu-Item-24"></a>Allows you to make moves for both Black and White, and to change
  58 moves after backing up with the &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; command. The clocks do
  59 not run. The <kbd>Ctrl-E</kbd> key is a keyboard equivalent.
  60
  61      <p>In chess engine mode, the chess engine continues to check moves for legality
  62 but does not participate in the game. You can bring the chess engine
  63 into the game by selecting &lsquo;<samp><span class="samp">Machine White</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Machine Black</span></samp>&rsquo;,
  64 or &lsquo;<samp><span class="samp">Two Machines</span></samp>&rsquo;.
  65
  66      <p>In ICS mode, the moves are not sent to the ICS: &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; takes
  67 XBoard out of ICS Client mode and lets you edit games locally.
  68 If you want to edit games on ICS in a way that other ICS users
  69 can see, use the ICS <kbd>examine</kbd> command or start an ICS match
  70 against yourself.
  71 <br><dt>Edit Position<dd><a name="index-Edit-Position_002c-Menu-Item-25"></a>Lets you set up an arbitrary board position.
  72 The shifted <kbd>Ctrl-E</kbd> key is a keyboard equivalent.
  73 Use mouse button 1 to drag pieces to new squares, or to delete a piece
  74 by dragging it off the board or dragging an empty square on top of it.
  75 To drop a new piece on a square, press mouse button 2 or 3 over the
  76 square. This brings up a menu of white pieces (button 2) or
  77 black pieces (button 3). Additional menu choices let you empty the
  78 square or clear the board. You can set the side to play next by
  79 clicking on the word White or Black at the top of the screen.
  80 Selecting &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; causes XBoard to discard
  81 all remembered moves in the current game.
  82
  83      <p>In ICS mode, changes made to the position by &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; are
  84 not sent to the ICS: &lsquo;<samp><span class="samp">Edit Position</span></samp>&rsquo; takes XBoard out of
  85 &lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo; mode and lets you edit positions locally. If you want to
  86 edit positions on ICS in a way that other ICS users can see, use
  87 the ICS <kbd>examine</kbd> command, or start an ICS match against yourself.
  88 (See also the ICS Client topic above.)
  89 <br><dt>Edit Tags<dd><a name="index-Edit-Tags_002c-Menu-Item-26"></a>Lets you edit the PGN (portable game notation)
  90 tags for the current game. After editing, the tags must still conform to
  91 the PGN tag syntax:
  92
  93      <pre class="example">          &lt;tag-section&gt; ::= &lt;tag-pair&gt; &lt;tag-section&gt;
  94                                   &lt;empty&gt;
  95           &lt;tag-pair&gt; ::= [ &lt;tag-name&gt; &lt;tag-value&gt; ]
  96           &lt;tag-name&gt; ::= &lt;identifier&gt;
  97           &lt;tag-value&gt; ::= &lt;string&gt;
  98 </pre>
  99      <p class="noindent">See the PGN Standard for full details. Here is an example:
 100
 101      <pre class="example">          [Event "Portoroz Interzonal"]
 102           [Site "Portoroz, Yugoslavia"]
 103           [Date "1958.08.16"]
 104           [Round "8"]
 105           [White "Robert J. Fischer"]
 106           [Black "Bent Larsen"]
 107           [Result "1-0"]
 108 </pre>
 109      <p class="noindent">Any characters that do not match this syntax are silently ignored. Note that
 110 the PGN standard requires all games to have at least the seven tags shown
 111 above. Any that you omit will be filled in by XBoard
 112 with &lsquo;<samp><span class="samp">?</span></samp>&rsquo; (unknown value), or &lsquo;<samp><span class="samp">-</span></samp>&rsquo; (inapplicable value).
 113 <br><dt>Edit Comment<dd><a name="index-Edit-Comment_002c-Menu-Item-27"></a>Adds or modifies a comment on the current position. Comments are
 114 saved by &lsquo;<samp><span class="samp">Save Game</span></samp>&rsquo; and are displayed by &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo;,
 115 &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, and &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;.
 116 <br><dt>Revert<dt>Annotate<dd><a name="index-Revert_002c-Menu-Item-28"></a><a name="index-Annotate_002c-Menu-Item-29"></a>If you are examining an ICS game and Pause mode is off,
 117 Revert issues the ICS command &lsquo;<samp><span class="samp">revert</span></samp>&rsquo;.
 118 In local mode, when you were editing or analyzing a game,
 119 and the <code>-variations</code> command-line option is switched on,
 120 you can start a new variation by holding the Shift key down while
 121 entering a move not at the end of the game.
 122 Variations can also become the currently displayed line by
 123 clicking a PGN variation displayed in the Comment window.
 124 This can be applied recursively,
 125 so that you can analyze variations on variations;
 126 each time you create a new variation by entering an alternative move
 127 with Shift pressed, or select a new one from the Comment window,
 128 the current variation will be shelved.
 129 &lsquo;<samp><span class="samp">Revert</span></samp>&rsquo; allows you to return to the most recently shelved variation.
 130 The difference between &lsquo;<samp><span class="samp">Revert</span></samp>&rsquo; and &lsquo;<samp><span class="samp">Annotate</span></samp>&rsquo;
 131 is that with the latter,
 132 the variation you are now abandoning will be added as a comment
 133 (in PGN variation syntax, i.e. between parentheses)
 134 to the original move where you deviated, for later recalling.
 135 The <kbd>Home</kbd> key is a keyboard equivalent to &lsquo;<samp><span class="samp">Revert</span></samp>&rsquo;.
 136 <br><dt>Truncate Game<dd><a name="index-Truncate-Game_002c-Menu-Item-30"></a>Discards all remembered moves of the game beyond the current
 137 position. Puts XBoard into &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; mode if it was not there
 138 already.
 139 The <kbd>End</kbd> key is a keyboard equivalent.
 140 <br><dt>Backward<dd><a name="index-Backward_002c-Menu-Item-31"></a><a name="index-g_t_003c_002c-Button-32"></a>Steps backward through a series of remembered moves.
 141 The &lsquo;<samp><span class="samp">[&lt;]</span></samp>&rsquo; button and the <kbd>Alt+LeftArrow</kbd> key are equivalents,
 142 as is turning the mouse wheel towards you.
 143 In addition, pressing the Control key steps back one move, and releasing
 144 it steps forward again.
 145
 146      <p>In most modes, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; only lets you look back at old positions;
 147 it does not retract moves. This is the case if you are playing against
 148 a chess engine, playing or observing a game on an ICS, or loading a game.
 149 If you select &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; in any of these situations, you will not
 150 be allowed to make a different move. Use &lsquo;<samp><span class="samp">Retract Move</span></samp>&rsquo; or
 151 &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; if you want to change past moves.
 152
 153      <p>If you are examining an ICS game, the behavior of &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;
 154 depends on whether XBoard is in Pause mode. If Pause mode is
 155 off, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; issues the ICS backward command, which backs up
 156 everyone's view of the game and allows you to make a different
 157 move. If Pause mode is on, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo; only backs up your local
 158 view.
 159 <br><dt>Forward<dd><a name="index-Forward_002c-Menu-Item-33"></a><a name="index-g_t_003e_002c-Button-34"></a>Steps forward through a series of remembered moves (undoing the
 160 effect of &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;) or forward through a game file. The
 161 &lsquo;<samp><span class="samp">[&gt;]</span></samp>&rsquo; button and the <kbd>Alt+RightArrow</kbd> key are equivalents,
 162 as is turning the mouse wheel away from you.
 163
 164      <p>If you are examining an ICS game, the behavior of Forward
 165 depends on whether XBoard is in Pause mode. If Pause mode is
 166 off, &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo; issues the ICS forward command, which moves
 167 everyone's view of the game forward along the current line. If
 168 Pause mode is on, &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo; only moves your local view forward,
 169 and it will not go past the position that the game was in when
 170 you paused.
 171 <br><dt>Back to Start<dd><a name="index-Back-to-Start_002c-Menu-Item-35"></a><a name="index-g_t_003c_003c_002c-Button-36"></a>Jumps backward to the first remembered position in the game.
 172 The &lsquo;<samp><span class="samp">[&lt;&lt;]</span></samp>&rsquo; button and the <kbd>Alt+Home</kbd> key are equivalents.
 173
 174      <p>In most modes, Back to Start only lets you look back at old
 175 positions; it does not retract moves. This is the case if you
 176 are playing against a local chess engine, playing or observing a game on
 177 a chess server, or loading a game. If you select &lsquo;<samp><span class="samp">Back to Start</span></samp>&rsquo; in any
 178 of these situations, you will not be allowed to make different
 179 moves. Use &lsquo;<samp><span class="samp">Retract Move</span></samp>&rsquo; or &lsquo;<samp><span class="samp">Edit Game</span></samp>&rsquo; if you want to change past
 180 moves; or use Reset to start a new game.
 181
 182      <p>If you are examining an ICS game, the behavior of &lsquo;<samp><span class="samp">Back to
 183 Start</span></samp>&rsquo; depends on whether XBoard is in Pause mode. If Pause mode
 184 is off, &lsquo;<samp><span class="samp">Back to Start</span></samp>&rsquo; issues the ICS &lsquo;<samp><span class="samp">backward 999999</span></samp>&rsquo;
 185 command, which backs up everyone's view of the game to the start and
 186 allows you to make different moves. If Pause mode is on, &lsquo;<samp><span class="samp">Back
 187 to Start</span></samp>&rsquo; only backs up your local view.
 188 <br><dt>Forward to End<dd><a name="index-Forward-to-End_002c-Menu-Item-37"></a><a name="index-g_t_003e_003e_002c-Button-38"></a>Jumps forward to the last remembered position in the game. The
 189 &lsquo;<samp><span class="samp">[&gt;&gt;]</span></samp>&rsquo; button and the <kbd>Alt+End</kbd> key are equivalents.
 190
 191      <p>If you are examining an ICS game, the behavior of &lsquo;<samp><span class="samp">Forward to
 192 End</span></samp>&rsquo; depends on whether XBoard is in Pause mode. If Pause mode
 193 is off, &lsquo;<samp><span class="samp">Forward to End</span></samp>&rsquo; issues the ICS &lsquo;<samp><span class="samp">forward 999999</span></samp>&rsquo;
 194 command, which moves everyone's view of the game forward to the end of
 195 the current line. If Pause mode is on, &lsquo;<samp><span class="samp">Forward to End</span></samp>&rsquo; only moves
 196 your local view forward, and it will not go past the position
 197 that the game was in when you paused.
 198 </dl>
 199
 200    </body></html>
 201