From dd48ea29d4fe7ebdb8ac3c019429291e6887854f Mon Sep 17 00:00:00 2001 From: H.G. Muller Date: Thu, 16 Feb 2012 10:19:58 +0100 Subject: [PATCH] Expand User Guide --- whats_new/LoadOpt.png | Bin 0 -> 12248 bytes whats_new/PromoPopup.png | Bin 0 -> 3509 bytes whats_new/UserGuide.html | 491 ++++++++++++++++++++++++++++++++++++++++++++-- 3 files changed, 474 insertions(+), 17 deletions(-) create mode 100644 whats_new/LoadOpt.png create mode 100644 whats_new/PromoPopup.png diff --git a/whats_new/LoadOpt.png b/whats_new/LoadOpt.png new file mode 100644 index 0000000000000000000000000000000000000000..01d43131aa19f32128e7be35ac2ad4a81f3a6be4 GIT binary patch literal 12248 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 ADF6Tf literal 0 HcmV?d00001 diff --git a/whats_new/UserGuide.html b/whats_new/UserGuide.html index a678542..2efdfa4 100644 --- a/whats_new/UserGuide.html +++ b/whats_new/UserGuide.html @@ -102,6 +102,16 @@ so you see them played out on the chess board. You can continue to step forward and backward through the engine line as long as you keep the button down.

+The variation board is only useful when playing with engines. +When logged on to an Internet Chess server, +there is an option to push observation of other games while you are playing 'to the background'. +That is, boards from those other games are not immediately displayed, overwriting your own position, +but XBoard will silently remember the most-recent such board. +You can then have a peek at it by right-clicking the board, for as long as you keep the mouse button down. +On release the board switches back to displaying your own game. +This can be useful in bughouse to see how your partner is doing. +

+

When setting up a position ('Edit Position mode'), things work a bit differently, because you are not bound by any chess rules in that case. In a click-click move any second click would be a to-square, @@ -148,16 +158,16 @@ and an exclamation point there will warn you there were dots hiding behind it.

    -
  • Detour Under-promotion (General Options) determines if a promotion menu will pop up on promotion moves
  • +
  • Detour Under-promotion (General Options) determines if a promotion menu will pop up on promotion moves
  • -pieceMenu (command-line option) determines if a right-click invokes a menu in Edit Position mode
  • -
  • Drop Menu (General Options) determines if a right-click in bughouse invokes a drop menu
  • -
  • Animate Dragging (General Options) determines if you will see the piece being dragged
  • -
  • Seek Graph (ICS Options) determines if left-clicks can call up the seek graph
  • -
  • Highlight Last Move (General Options) controls if clicking squares highlights them
  • -
  • Highlight with Arrow (General Options) controls if an arrow is drawn between from- and to-square
  • -
  • One-click moving (General Options) can make a piece move by clicking only from- or to-square
  • -
  • Show Target Squares (General Options) marks square where the selected / dragged piece can move to
  • -
  • Hide Thinking from Human (General Options) determines if engine thinking is displayed in the message field
  • +
  • Drop Menu (General Options) determines if a right-click in bughouse invokes a drop menu
  • +
  • Animate Dragging (General Options) determines if you will see the piece being dragged
  • +
  • Seek Graph (ICS Options) determines if left-clicks can call up the seek graph
  • +
  • Highlight Last Move (General Options) controls if clicking squares highlights them
  • +
  • Highlight with Arrow (General Options) controls if an arrow is drawn between from- and to-square
  • +
  • One-click moving (General Options) can make a piece move by clicking only from- or to-square
  • +
  • Show Target Squares (General Options) marks square where the selected / dragged piece can move to
  • +
  • Hide Thinking from Human (General Options) determines if engine thinking is displayed in the message field
  • -variations (command-line option) determines whether you can enter variations
  • -showButtonBar (command-line option) determines whether the navigation buttons are present
@@ -175,7 +185,7 @@ In this case XBoard will 'upgrade' this variation to become the main line of the You can then step through the variation to make it visible on the board.

    -
  • Auto-dispay comment (Load Options) causes automatic pop up whenever you encounter a commented move.
  • +
  • Auto-dispay comment (Load Options) causes automatic pop up whenever you encounter a commented move.
@@ -227,7 +237,7 @@ Right-clicking on a move (in WinBoard: left-double-clicking) will navigate you t (i.e. display that position on the board, and allow you to step through the game from there).

    -
  • Scores in Move List (General Options) enables inclusion of engine score/depth
  • +
  • Scores in Move List (General Options) enables inclusion of engine score/depth
@@ -245,7 +255,7 @@ distinguishable by their color. Clicking in the graph navigates you to the position corrsponding to the point where you clicked.

    -
  • Zoom factor (General Options) set magnifiation of the {-1, 1} score range
  • +
  • Zoom factor (General Options) set magnifiation of the {-1, 1} score range
  • -evalThreshold (command-line option) minimum score to be considered different from 0
@@ -273,8 +283,8 @@ reachable through the 'Thresholds' button) will remain in the list, in that case.

    -
  • (Game List Options) selects the PGN tags included in the header
  • -
  • (Load Options) can set all kind of filter and position-search criteria
  • +
  • (Game List Options) selects the PGN tags included in the header
  • +
  • (Load Options) can set all kind of filter and position-search criteria
@@ -288,7 +298,7 @@ It can be used to view or edit the PGN tags of the stored game. To save any changes brought about by editing, you have to press a button at the bottom of the window.

    -
  • Auto-display Tags (Load Options) cause automatic popup on loading a game
  • +
  • Auto-display Tags (Load Options) cause automatic popup on loading a game

Edit book

@@ -299,10 +309,457 @@ It displays moves available for the current position (displayed on the board) in To save any changes brought about by editing, you have to press a button at the bottom of the window.

+ +

Menus

+

+Most menus speak for themselves. +Many of them are for bringing up menu dialogs, (discussed below), where the real action will take place. +The Forward, Backward etc. items in the Edit menu do the same as the buttons above the board; +you can step through a game in progress, but only for viewing past positions; +Backward will not retract any moves. +The Retract Move item in the Engine menu is for that. +The Book item in the Engine menu queries the engine for its own book moves, +and has nothing to do with XBoards own opening book. +

+

+Items that deserve explanation are Revert and Annotate in the Edit menu. +These items become enabled as soon as you have shelved the main line of the loaded game, +by 'upgrading' a variation to new main line. +This can be done by right-clicking an already present vaiation in the Comment window, +or by entering a move (not at the end of the game) while keeping the Shift key pressed. +With Revert you would abandon such an upgraded variation, and restore the old main line. +Annotate does the same, but adds the abandoned variation as a (PGN variation) comment to the preceding move. +So you typically would use Revert to revert from variations that were already in the game, +and Annotate for a variation that you entered yourself, move by move. +Of course you could use Revert in that case as well, if you don't think the abandoned variation is worth saving +(e.g. after receiving a very poor analysis score). +

Mode menu

+

+The Mode menu might require some more clarification than others. +It is used to determine what XBoard will be doing. +E.g. Machine White and Machine Black will set XBoard to let the user play against the (first) engine, +while Two Machines will make first and second engine play against each other. +In both cases XBoard will revert to idle mode after the game finishes. +Machine Match starts playing the two engines against each other for a number of games (aternating the colors). +This match will stop when you click the menu item again (after the game in progress finishes!), +or when the number of games set in the Match Options dialog is reached. +Edit Game will allow the user to enter moves for both sides; +if a (first) engine is loaded, it will still check the moves for legality, though, +(so you cannot use XBoard to edit the game of a variant the engine does not play!), +but it will not think about them. +Edit Position allows you to set up a position. +

+

+Analysis mode is similar to Edit Game mode in that the user plays both sides, +but now the engine is thinking, and you can follow its thoughts about the current position in the engine-output window. +With Analyze Game, you will make XBoard step through the currently loaded game automatically, +while the engine is analyzing every position in it. +The results of this analysis are then added to the moves as comments +(i.e. score / depth as comments, as well as the PV indicated by the engine in PGN variation format). +

+

+ICS client is only available when you are already connected to an Internet Chess Server, +and allows you to continue interacting with it after you have been switching to another mode to do something locally. +(Such as loading a game from a file, in order to upload it to the ICS for examining, +or editing a game with comments in order to save it.) +

+ +
+

+ +

+ +

+
+

General Options

+

+The General Options dialog contains mostly on/off options. +Most options speak for themselves, or have already been discussed in the section on the board window. +Animate dragging / moving control whether the pieces move to their destination +square in a continuous fashion, rather than instantly jumping there. +The latter is for click-click moves or moves from an external source (file, engine, ICS), +the other for drag-drop moving. +Blindfold suppresses display of all pieces, so the board will always look empty. +Auto-flag terminates the game when one of the players flags +(or at least sends a request to that end to the ICS). +Auto Flip View will put the side you are playing at the bottom of the display, +when playing against engine or on ICS. +(By default white is at the bottom, +but the Flip View men item or F2 key can change this manually). +Ponder Next Move will cause an engine to think also when its opponent's clock is running. +Periodic Updates is a feature only relevant for analysis with an engine, +and let the engine send a constant stream of updates on what it is doing, +rather than just new variations. +Absolute analysis score means that in analysis positive scores mean white has the advantage. +(Normally engines report scores from the point of view of the side to move.) +XBoard has the possibility to make pieces that move blink on and off a few times on their to-square (Flash Moves). +You can suppress popup of several popups (e.g. drop menu in favor of PV walking). +

+

+Test Legality will already make XBoard refuse entry of illegal moves; +when you switch it off, you can enter them, but an ICS or engine would still rfuse them, +and XBoard would then take the move back. +Switching it off can be useful, though, when you use XBoard for a chess variant it does not know the rules of. +In that case the engine will be the final authority on what moves the user can enter. +Some other options won't work when legality testing is off: +XBoard won't be able to adjudicate checkmates and stalemates, 'Show Target Squares' where a pickedup piece can move to, +or use 'One-click Moving' (see below). +

+

+Two options affect how you enter moves. +One-Click Moving automatically moves pieces you click to the only square they can move to when this option is on. +As an alternative, it allows you to click empty squares, and if you have only a single piece that can move there, +XBoard will make that move. +Finally, clicking on an already selected piece (in practice usually double-clicking an unselected one) will force it to make the only capture it can do. +

+
+

+Detour Under-Promotion is a novel way to handle pawn promotions: +Moving the pawn forward to its promotion square will automatically give you a queen, +but in the rare case you want something else, you can drag the pawn backwards first, +upon which it will start changing identity. +When it finaly becomes the piece you want, you then move it forward to the promotion square. +If the option is off, you will be prompted for a choice with a popup (shown left). +With One-click moving you will only get a promotion choice when clicking the pawn; +clicking the promotion square will always give you queen. +A command-line options -alwaysPromoteToQueen can force this anyway, in stead of the popup. +

+
+ +
+
+ +
+ + +

Save Options

+

+XBoard allows you to save games or positions manually, +but in the Save Options dialog you can make arrangements for this to happen automatically at the end of any game. +If you specify a file for this, all games will be appended to the file. +(XBoard never over-writes game or position files, but always appends.) +If not, it will prompt you for a file name every time it saves, +proposing a name derived from the players. +It is recommended to alays save as PGN. +Other thing you can set here are the text in the Event tag, +whether score & depth of engine moves will be saved as comment to the moves, +whether the score when the engine came out of book will be saved as a PGN tag, +and whether tourney games will get s Number tag with a sequence number. +

+
+ +
+

Adjudication options

+

+XBoard can recognize checkmates and stalmates, +and end games when they occur without waiting for the engine to claim it. +It can thus also check if engines claim these events unjustly, and forfeit them for that. +Positions without mating potential can be recognized in the more common variants, +and be declared draw instantly. +Some material combinations that would only allow helpmates (such as KBKN) can also be adjudicated draw after a short delay, +under contro of the 'Trivial Draws' option +

+

+You can also set the number of repeats and reversible moves after which a draw should be declared, +or cut short excessively long games by delaring draw. +Setting these values to 0 disables the corresponding adjudication. +You can let XBoard declare a win when both engines agree one is so much behind that further playing is pointless (Win / Loss Threshold). +For this to work, the engines must report the scores in the conventional way +(i.e. positive meaning they think themselves ahead, even when playing black). +Two options allow you to flip the black score of non-compliant engines. +

+
+ +
+ +
+ + +

Common engine options

+

+This dialog allows you to set some parameters valid for all engines, +such as their hash-table size, size of their tablebase buffer, the number of cores they can use, +and where you have installed the tablebases on your system. +Almost all UCI engines (run through the Polyglot adapter) need these parameters. +For native XBoard engines these settings often are ignored, +because they don't support the necessary commands to set them through the protocol. +'Polyglot directory' is where the Polyglot executable is to be found; +on Linux this can usually stay empty, becaue Polyglot is installed in a directory that is searched automatically +when you issue a simple 'polyglot' command. +

+

+Opening book - The remaining options are for controlling the opening book used by XBoard. +This book can be used to play openings for the engines, without the engines being consulted. +(The moves selected by XBoard from the book will be forced to the engine, +and the engine will be started to think for itself only when XBoard gets out of book.) +You can specify any opening book in Polyglot format as book file, +but to make it possible for XBoard to use it, 'Use GUI Book' should also be checked. +This still does not mean XBoard will use the book for all engines; +to use it for a specific engine, the 'Has Own Book' option for that engine should be switched off. +By default it would be switched on after loading an engine, +except when this engine was installed with the explicit request to use the book. +In tournaments you can overrule this default, though, and make all participants start from the GUI book +unless they explicitly request to not use it +(which they almost never do, unless you edited the engine list by hand). +Finally you can set for how many (full) moves the book should at most be used, +and specify the book variation by a number from 0 to 100: +100 would mean totally random selection of all moves the book has for the current position, +while 0 would mean it only plays the best move(s) listed in the books. +The value 50 here would play the moves in proportion to the probabilities the book suggests. +

+
+ +

Load engine

+
+

+To start using a different engine (or start using one when you so far were in game-viewer mode only) +you can select one with the aid of this dialog. +If the engine is already 'installed', i.e. present in the list maintained in XBoard's setting file, +you can simply select it from the drop-down list at the top of the dialog. +You then only have to select if you want to load it as first or second engine, +and can press OK. +The rest of the dialog is then not used. +

+

+Only to load an engine never used before the rest of the dialog becomes relevant. +You can specify the engine command there, which can be done by browsing to the executable for that engine. +Some engines might need other stuff on their start command than just their name, however, +like '-xboard', or a specification of the hash size. +You must tick a box if the engine is UCI. +By default it will be assumed you want to remember this new engine in the engine list, +so that next time you can select it directly from the drop-down list. +If you don't want this, you can untick the 'Add to list' chackbox. +

+

+You can also specify a 'nickname', whih is the name under which it will appear in the drop-down list, +if you are not satisfied with the name of the executable. +(Some engines have horribly cryptic names for their command, +and you might want to install versions of the same engine with different settings, +and use nicknames to keep them apart.) +Other checkboxes allow you to determine if this engine should request using XBoard's opening book, +if it is an obsolete engne using version 1 of the protocol +(whih would otherwise take many seconds to load), +and if the engine should be installed to always play the currently active variant +(this is only usful for engines that do not play normal chess). +

+
+ +
+ +
+ + +

Board options

+

+In the View menu there is the Board Options dialog to make you configure the look of the board. +There ae two modes for rendering board squares: through an externally given (pixmap) image file, or evenly colored. +In the latter case you can select the colors with the 'color pickers' at the top of the dialog. +In XBoard colors are indicated by hexadedecimal numbers for their Red, Green and Blue value. +This cryptic notation is displayed in a text-edit, and if you understand the coding system, +you could alter it to the color you want by typing a new code. +(Hint: the first two letters behind # are for red, the next two for green, and the last two for blue.) +Otherwise you can set the color experimentally, using the buttons behind the text edit +to make it a bit redder, greener, bluer or darker. +To see what you are doing the color is displayed behind the text edit. +This is also a button, though, and if you press it, it restores the color to the default. +You can set square color, piece color and highlight colors through this method. +

+

+To use image files for board squares, you must specify the pixmap files from which the light and dark squares are cut. +These files must contain an image at least as big as the square size, +The cutting algorithm is such that it tries to minimize the overlap between cut squares, +and that when you specify an image exactly the size of the entire board, +the squares tile to recover the complete image undamaged. +The width of the highlight lines can be hand-tuned with the 'Line Gap' option. +

+

+You can also specify external pieces, as bitmaps or pixmaps. +A complete set of pieces of the current board size would have to be contained in the specified diretories. +The other options speak for themselves. +

+
+ +

Sound options

+
+

+XBoard cannot generate sounds by itself, but can invoke an external sound player to play a number of predefined sounds. +These sounds can be coupled to certain events, like your opponent making a move, +the game ending in a win, loss or draw, etc. +Many of the events can only ocur when you aue XBoard to connect to an Internet Chess Server, +such as someone challeging you for a game, others sending you a 'tell' message, a 'shout' being broadasted on the server. +For each of the events there is a drop-down list from which you can selet the sound you want to hear when it occurs. +Apart from the predefined sounds that come with XBoard, +you can supply your own sound files: +yust select one in the text edit at the top, +and choose 'Above WAV File' from the drop-down list. +You can also select your preferred sound-player command, and the directory where the predefined sounds are stored. +

+

ICS Text Menu

+
+ + +

+There is one dialog that is special, because the user can decide what is in it! +It displays a number of buttons, which represent a command text to be sent to the Internet Chess Server you are connected to. +Each button could thus represent a command you frequently use, +and now can send with a single click of the mouse! +

+

+The button texts, and commands to send are all specified through the multi-line option -icsMenu, +which is stored in the settings file (~/xboardrc). +The easiest way to change it is probably editing this file (sorry about that...). +Buttons are described by "buttonText;command;" pairs, where the command can contain linefeeds +(i.e. be multiple ICS commands). +"$name" in the command will be replaced by currently selected text in the ICS console. +Commands ending with "$input" are placed in the ICS Input Box, rather than directly sent to the ICS. +If they start with "$add", they will be appended to text already in the ICS Input Box, rather than replacing it. +

+
+
+ +
+ + +
+

ICS options

+

+This dialog can alter settings relevant for playing on an Internet Chess Server. +On the right you can specify colors to be given to various type of messages coming from the ICS. +They consist of a comma-separated triple for font color, background color and ???. +To activate this, the Colorize option has to be ticked. +

+

+You can also switch premoving (i.e. entering your move in advance, whil the opponent is still thinking) on or off, +and specify premoves for the first move of the game. +An Alarm can be set to sound when the time left on your clock drops below a certain value. +(Use the Sound Options dialog to pick the sound!) +Auto-raise board pulls the board window to the foreground whenever there is activity, +while Quiet Play suppresses all messages coming from the ICS while you are involved in a game. +Get Move List is important for not missing the initial part of games you start observing when they are in progress, +but can be very disruptive if you observe more games at the same time. +

+
+ +
+

+The option Auto-Comment causes all text messages you receive from your opponent during game play +to be added as comments to the stored game, so they can be saved with the PGN. +Auto-Kibitz will cause the thinking output of an engine playing through XBoard on the ICS ('zippy mode') +to be sent through kibitz commands to opponent and observers. +At the same time it will cause such incoming kibitzed thinking output to be diverted to the engine-output window. +

+

+Seek graph controls if a left-click on the board while idle will bring up a graph of players seeking a game. +When this option is on, Auto-Refresh Seek Graph controls if it is automatically updated, +(works only on FIC and ICS, and consumes a lot of bandwidth), +or whether you have to right-click the graph (in an empty part) for that. +The color of the dots in the seek graph codes for rated / unrated / wild, +while the shape (circle / square) encodes for human / computer. +

+

+The option Background Observe suppresses display of any boards of observed games while you are playing. +The latest such received board can then be peeked at by right-clicking on the board, however. +In combination with this, you can use the experimental option Dual Board to see such background-observed games +on a separate board all the time. +Such observed games arenot recorded by XBoard though. +(I.e. you cannot save them on file afterwards, but you can of course always fetch them again from the ICS later, +and save them then.) +

+ +

Load options

+

+The Load Options dialog controls loading and slection of games from the game list. +After loading a game XBoard will normally auto-play it, by stepping through all positions from the beginning. +The stepping rate can be set here in seconds. +(This is one of the few numeric options where fractions can be specified.) +Specifying a negative number will suppress the auto-play, and leave the opening position in the display after game load. +Specifying 0 will instantly move to the final position, and leave that in the display. +You can select if the Tags window will automaticall pop up to show you the PGN tags of the game, +or whether the Comment window will pop up on display of any move that had a comment to it. +

+
+ + +

+A text edit allows you to speify options XBoard that should take effect when XBoard is used as a game viewer +(i.e. with the -viewer option, as it is when invoked through clicking a PGN file). +By default this will be -ncp mode ('no chess program', i.e. without engine), +but you might prefer to start it with your favorite engine for analyzing games. +

+

+The other options are all for 'filtering' the game list, i.e. only display games that fit certain criteria. +You can specify Elo thresholds for only showing the games from a PGN file of players that are strong enough, +or restict the display to games played after a certain year. +This all works in combination with the 'Filter' field in the Game List itself, +where you can select based on a text occurring in the header lines. +You can also select games based on occurrence of certain positions in them. +The position you search should in that case be set up on the board. +To decide when a position is considered a 'match', six different, and progressively more liberal criteria can be used: +

+
    +
  • The position must be exactly the same as the one on the board
  • +
  • Pieces on the board must occur in the position exactly as given, but there could be extra material
  • +
  • Only the Pawns must be exactly as on the board, but non-Pawn material could be anywhere
  • +
  • The position must have the same material as is on the board, but it doesn't matter where
  • +
  • The position must contain at least the material on the lower half of the board, + but can optionally have any subset of the material on the upper half in addition
  • +
  • As above, but the optional material must be the same for black and white
+

+In addition you can tick whether the first three comparison methods should also accept mirror images +(where vertical flipping will be accompanied by color flipping). +For the last three methods you can require that the imposed conditions are satisfied not for a single position, +but for a given number of consecutive positions. +Pressing the 'Find Position' button at the bottom of the Game List will apply the specified criteria. +Games loaded from a Game List filtered position will not auto-play, +but always load with the position search for as the currently displayed one. +

+
-

+

Match options

+

+Here you can set the parameters for matches and tournaments. +For (old-style) two-player matches only the options in the bottom half of the dialog are relevant: +you can select the default number of match games +(i.e. that used when you click the Machine Match item in the Mode menu), +the game or position file from which the games in the match will be started +(i.e. the games, presumably short opening lines, or position will be loaded first, +and the engines will then start to play from there), +and which game or position from the file should be used. +By specifying -1 or -2 for the latter you can make XBoard automatically step through all positions in the file, +taking the next one every game (-1) or every two games (-2, so they are played with both colors). +You can specify that after a number of games / positions have been used, +XBoard 'should rewind' to the first in the file.

+

+The pause between matches is important for engines that do not support 'ping', +which have the nasty habit of sometimes producing a move for the previous game when the next game has already started, +(because the opponent unexpectedly resigned), +without XBoard being able to detect that. +Th only remedy is to wait long enough for such engines to finish their search and produce the move before the next game starts. +The file for saving the games can be set here, as well as from the Save Options dialog. +The other parameters, in the upper half of the dialog are only important for tourneys with more than two engines +(or at least, other than the two currently loaded engines), +see the page on XBoards built-in tournament manager. +

+ +
+ + +

Game-list options

+

+With this dialog you can customize the lines in the game list. +The various PGN tags that are eligible for appearing there are displayed in a listbox. +You can select one of those by clicking it, and then move it up or down in the ranking with the buttons at the bottom. +Only tags above the 'hidden tags' item will be printed in the game list, +in the order they appear in the list box. +

+
+ +
+ +
-- 1.7.0.4