<h3 class="section">3.6 Engine Menu</h3>
-<p><a name="index-Engine-Menu-78"></a><a name="index-Menu_002c-Engine-79"></a>
+<p><a name="index-Engine-Menu-81"></a><a name="index-Menu_002c-Engine-82"></a>
<dl>
-<dt>Engine #N Settings<dd><a name="index-Engine-Settings_002c-Menu-Item-80"></a><a name="index-Engine-_00231-Settings_002c-Menu-Item-81"></a><a name="index-Engine-_00232-Settings_002c-Menu-Item-82"></a>Pop up a menu dialog to alter the settings specific to the applicable engine.
+<dt>Load Engine<dd><a name="index-Load-Engine_002c-Menu-Item-83"></a>Pops up a dialog where you can select or specify an engine to be loaded.
+You will always have to indicate whether you want to load the engine
+as first or second engine, through the ‘Load menitioned engine as’
+drop-down list at the bottom of the dialog.
+You can even replace engines during a game, without disturbing that game.
+(Beware that after loading an engine, XBoard will always be in Edit Game mode,
+so you will have to tell the new engine what to do before it does anything!)
+When you select an already installed engine from the ‘Select Engine from List’
+drop-down list,
+all other fields of the dialog will be ignored.
+In other cases, you have to specify the engine executable,
+possible arguments on the engine command line
+(if the engine docs say the engine needs any),
+and the directory where the engine should look for its files
+(if this cannot be deduced automatically from the specification of the engine executable).
+You will also have to specify (with the aid of checkboxes) if the engine is UCI.
+If ‘Add this engine to the list’ is ticked (which it is by default),
+the engine will be added to the list of installed engines in your settings file,
+(provided you save the settings!),
+so that next time you can select it from the drop-down list.
+You can also specify a ‘nickname’,
+under which the engine will then appear in that drop-down list,
+and even choose to use that nickname for it in PGN files for engine-engine games.
+The info you supply with the checkboxes whether the engine should use GUI book,
+or (for variant engines) automatically switch to the current variant when loaded,
+will also be included in the list.
+For obsolete XBoard engines, which would normally take a long delay to load
+because XBoard is waiting for a response they will not give,
+you can tick ‘WB protocol v1’ to speed up the loading process.
+<br><dt>Engine #N Settings<dd><a name="index-Engine-Settings_002c-Menu-Item-84"></a><a name="index-Engine-_00231-Settings_002c-Menu-Item-85"></a><a name="index-Engine-_00232-Settings_002c-Menu-Item-86"></a>Pop up a menu dialog to alter the settings specific to the applicable engine.
(The second engine is only accessible once it has been used in Two-Machines mode.)
For each parameter the engine allows to be set,
a control element will appear in this dialog that can be used to alter the value.
UCI engines usually have many parameters. (But these are only visible with
a sufficiently modern version of the Polyglot adapter needed to run UCI engines,
e.g. Polyglot 1.4.55b.) For native XBoard engines this is less common.
-<br><dt>Hint<dd><a name="index-Hint_002c-Menu-Item-83"></a>Displays a move hint from the chess engine.
-<br><dt>Book<dd><a name="index-Book_002c-Menu-Item-84"></a>Displays a list of possible moves from the chess engine's opening
+<br><dt>Hint<dd><a name="index-Hint_002c-Menu-Item-87"></a>Displays a move hint from the chess engine.
+<br><dt>Book<dd><a name="index-Book_002c-Menu-Item-88"></a>Displays a list of possible moves from the chess engine's opening
book. The exact format depends on what chess engine you are using.
With GNU Chess 4, the first column gives moves, the second column
gives one possible response for each move, and the third column shows
the number of lines in the book that include the move from the first
column. If you select this option and nothing happens, the chess
engine is out of its book or does not support this feature.
-<br><dt>Move Now<dd><a name="index-Move-Now_002c-Menu-Item-85"></a>Forces the chess engine to move immediately. Chess engine mode only.
+<br><dt>Move Now<dd><a name="index-Move-Now_002c-Menu-Item-89"></a>Forces the chess engine to move immediately. Chess engine mode only.
The <kbd>Ctrl-M</kbd> key is a keyboard equivalent.
-<br><dt>Retract Move<dd><a name="index-Retract-Move_002c-Menu-Item-86"></a>Retracts your last move. In chess engine mode, you can do this only
+<br><dt>Retract Move<dd><a name="index-Retract-Move_002c-Menu-Item-90"></a>Retracts your last move. In chess engine mode, you can do this only
after the chess engine has replied to your move; if the chess engine is still
thinking, use ‘<samp><span class="samp">Move Now</span></samp>’ first. In ICS mode, ‘<samp><span class="samp">Retract Move</span></samp>’
issues the command ‘<samp><span class="samp">takeback 1</span></samp>’ or ‘<samp><span class="samp">takeback 2</span></samp>’
depending on whether it is your opponent's move or yours.
The <kbd>Ctrl-X</kbd> key is a keyboard equivalent.
+<br><dt>Recently Used Engines<dd><a name="index-Recently-Used-Engines_002c-In-Menu-91"></a>At the bottom of the engine menu there can be a list of names
+of engines that you recently loaded through the Load Engine menu dialog
+in previous sessions.
+Clicking on such a name will load that engine as first engine,
+so you won't have to search for it in your list of installed engines,
+if that is very long.
+The maximum number of displayed engine names is set by the
+<code>recentEngines</code>command-line option.
</dl>
</body></html>
projects / xboard.git / blobdiff