You can then edit this list, e.g. for re-ordering the engines,
or adding uncommon options needed by this engine
(e.g. to cure non-compliant behavior).
+
+By editing you can also organize the engines into collapsible groups.
+By sandwiching a number of engine lines between lines "# NAME" and "# end",
+the thus enclosed engines will not initially appear in engine listboxes
+of other dialogs, but only the single line "# NAME"
+(where NAME can be an arbitrary text) will appear in their place.
+Selecting that line will then show the enclosed engines in the listbox,
+which recursively can contain other groups.
+The line with the group name will still present as a header,
+and selecting that line will collapse the group again,
+and makes the listbox go back to displaying the surrounding group.
@item Load New 1st Engine
@itemx Load New 2nd Engine
@cindex Load Engine, Menu Item
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.
+you can tick ‘WB protocol v1’ to speed up the loading process.
+
+New engines are always added at the end of the existing list,
+but can be re-ordered with the aid of the @samp{Edit Engine List} menu item.
+They can even be organized in groups that can be opened or collapsed at will,
+which can be very useful if the list is very long.
+
@item Engine #N Settings
@cindex Engine #N Settings, Menu Item
Pop up a menu dialog to alter the settings specific to the applicable engine.
@section Options Menu
@cindex Menu, Options
@cindex Options Menu
-@subsection General Options
+@heading General Options
+@section General Options
@cindex General Options, Menu Item
The following items to set option values appear in the dialog
summoned by the general Options menu item.
indicating the factor by which the score interval (-1,1) should be
blown up on the vertical axis of the Evaluation Graph.
@end table
-@subsection Time Control
+@section Time Control
@cindex Time Control, Menu Item
Pops up a sub-menu where you can set the time-control parameters interactively.
The shifted @kbd{Alt+T} key is a keyboard equivalent.
be it at the beginning of a session or through the time increment or
fixed time per move, will be divided by N.
-@subsection Adjudications
+@section Adjudications
@cindex Adjudications, Menu Item
Pops up a sub-menu where you can enable or disable various adjudications
that XBoard can perform in engine-engine games.
the engine's scores. To facilitate the latter, you can inform xboard here if
the engines report scores from the viewpoint of white, or from that of their own color.
-@subsection ICS Options
+@section ICS Options
@cindex ICS Options, Menu Item
The following options occur in a dialog summoned by the
ICS Options menu item.
through the accompanying text edits.
@end table
-@subsection Tournament Options
+@section Tournament Options
@cindex Tournament Options, Menu Item
Summons a dialog where you can set options important for playing automatic
matches between two or more chess programs
through the respective buttons at the bottom of the latter.)
@end table
-@subsection Load Game Options
+@section Load Game Options
@cindex Load Game Options, Menu Item
Summons a dialog where you can set the @code{autoDisplayComment} and
@code{autoDisplayTags} options, (which control popups when viewing loaded games),
have expired (or in Xiangqi).
@end table
-@subsection Save Game Options
+@section Save Game Options
@cindex Save Game Options, Menu Item
Summons a dialog where you can specify the files on which XBoard should
automatically save any played or entered games,
should be included.
For Chess, always set the format to PGN, rather than "old save stye"!
-@subsection Game List
+@section Game List
@cindex Game List Tags, Menu Item
Pops up a dialog where you can select the PGN tags that should appear
on the lines in the game list, and their order.
-@subsection Sound Options
+@section Sound Options
@cindex Sound Options, Menu Item
Summons a dialog where you can specify the sounds that should accompany
various events that can occur in XBoard.
The sound is not played after moves you make or moves read from a
saved game file.
-@subsection Save Settings Now
+@section Save Settings Now
@cindex Save Settings Now, Menu Item
Selecting this menu item causes the current XBoard settings to be
written to the settings file, so they will also apply in future sessions.
with the specified value as default, because that value will overrule
the value loaded from the settings file (being read later).
-@subsection Save Settings on Exit
+@section Save Settings on Exit
@cindex Save Settings on Exit, Menu Item
Setting this option has no immediate effect, but causes the settings
to be saved when you quit XBoard. What happens then is otherwise