release of 4.5.0
[xboard.git] / manual / html_node / Menus.html
1 <html lang="en">
2 <head>
3 <title>Menus - 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="prev" href="Major-modes.html#Major-modes" title="Major modes">
9 <link rel="next" href="Options.html#Options" title="Options">
10 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11 <meta http-equiv="Content-Style-Type" content="text/css">
12 <style type="text/css"><!--
13   pre.display { font-family:inherit }
14   pre.format  { font-family:inherit }
15   pre.smalldisplay { font-family:inherit; font-size:smaller }
16   pre.smallformat  { font-family:inherit; font-size:smaller }
17   pre.smallexample { font-size:smaller }
18   pre.smalllisp    { font-size:smaller }
19   span.sc    { font-variant:small-caps }
20   span.roman { font-family:serif; font-weight:normal; } 
21   span.sansserif { font-family:sans-serif; font-weight:normal; } 
22 --></style>
23 </head>
24 <body>
25 <div class="node">
26 <a name="Menus"></a>
27 <p>
28 Next:&nbsp;<a rel="next" accesskey="n" href="Options.html#Options">Options</a>,
29 Previous:&nbsp;<a rel="previous" accesskey="p" href="Major-modes.html#Major-modes">Major modes</a>,
30 Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
31 <hr>
32 </div>
33
34 <h2 class="chapter">2 Menus, buttons, and keys</h2>
35
36 <p><a name="index-Menus-3"></a>
37 To move a piece, you can drag it with the left mouse button, or you
38 can click the left mouse button once on the piece, then once more on
39 the destination square.  To drop a new piece on a square (when
40 applicable), press the middle or the right mouse button over the
41 square and select from the pop-up menu.  In cases where you can drop
42 either a white or black piece, use the middle button (or shift+right)
43 for white and the right button (or shift+middle) for black.  When you
44 are playing a bughouse game on an Internet Chess Server, a list of the
45 off-board pieces that each player has available is shown in the window
46 title after the player's name; in addition, the piece menus show the
47 number of pieces available of each type. From version 4.3.14 on, it is
48 also possible in crazyhouse, bughouse or shogi to drag and drop pieces
49 to the board from the holdings squares displayed next to the board. 
50 This latter method for dropping pieces during a game is preferred,
51 and the piece-drop menu is now deprecated (except for editing a position). 
52 Although the old behavior can still be selected through a command-line
53 option, the default function of the right mouse button is to display
54 the position the chess program thinks it will end up in,
55 while moving the mouse vertically with this button pressed will step
56 through the principal variation to show how this position will be
57 reached. 
58 Lines of play displayed in the engine-output window an similarly
59 be played out on the board, by right-clicking on them.
60
61    <p>When connected to an ICS, it is possible to call up a graphical
62 representation of players seeking a game in stead of the chess board,
63 when the latter is not in use
64 (i.e. when you are not playing or observing). 
65 Left-clicking the display area will switch between this 'seek graph'
66 and the chess board. 
67 Hovering the mouse pointer over a dot will show the details of the
68 seek ad in the message field above the board. 
69 Left-clicking the dot will challenge that player. 
70 Right-clicking a dot will 'push it to the back',
71 to reveal any dots that were hidden behind it. 
72 Right-clicking off dots will refresh the graph.
73
74    <p>Most other XBoard commands are available from the menu bar. The most
75 frequently used commands also have shortcut keys or on-screen buttons. 
76 Some rarely used parameters can only be set through options on the
77 command line used to invoke XBoard.
78
79    <p>XBoard uses a settings file, in which it can remember any changes to
80 the settings that are made through menus or command-line options,
81 so they will still apply when you restart XBoard for another session. 
82 The settings can be saved into this file automatically when XBoard exits,
83 or on explicit request of the user. 
84 The default name for the settings file is /etc/xboard/xboard.conf,
85 but in a standard install this file is only used as a master settings
86 file that determines the system-wide default settings,
87 and defers reading and writing of user settings to a user-specific
88 file like ~/.xboardrc in the user's home directory.
89
90    <p>When XBoard is iconized, its graphical icon is a white knight if
91 it is White's turn to move, a black knight if it is Black's turn.  See
92 Iconize in <a href="Keys.html#Keys">Keys</a> below if you have problems getting this
93 feature to work.
94
95 <ul class="menu">
96 <li><a accesskey="1" href="File-Menu.html#File-Menu">File Menu</a>:        Accessing external games and positions. 
97 <li><a accesskey="2" href="Edit-Menu.html#Edit-Menu">Edit Menu</a>:        Altering games, positions, PGN tags or comments. 
98 <li><a accesskey="3" href="View-Menu.html#View-Menu">View Menu</a>:        Controlling XBoard's shape and looks. 
99 <li><a accesskey="4" href="Mode-Menu.html#Mode-Menu">Mode Menu</a>:        Selecting XBoard's mode. 
100 <li><a accesskey="5" href="Action-Menu.html#Action-Menu">Action Menu</a>:      Talking to the chess engine or ICS opponents. 
101 <li><a accesskey="6" href="Engine-Menu.html#Engine-Menu">Engine Menu</a>:      Controlling settings and actions of the engine(s). 
102 <li><a accesskey="7" href="Options-Menu.html#Options-Menu">Options Menu</a>:     User preferences. 
103 <li><a accesskey="8" href="Help-Menu.html#Help-Menu">Help Menu</a>:        Getting help. 
104 <li><a accesskey="9" href="Keys.html#Keys">Keys</a>:             Other shortcut keys. 
105 </ul>
106
107    </body></html>
108