X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=manual%2Fxboard.html;h=f6ced810bef4847f5dccbf9e9fa16b98a4a317b2;hb=0f848da7556dd6eadf0a33029d2aade7676caa37;hp=c293d2f7102459882eb8739577b247d10fef57f6;hpb=5acdc0c401a6b8d61ff3926783ae252b0d318a35;p=xboard.git diff --git a/manual/xboard.html b/manual/xboard.html index c293d2f..f6ced81 100644 --- a/manual/xboard.html +++ b/manual/xboard.html @@ -115,11 +115,11 @@ To move a piece, you can drag it with the left mouse button, or you can click the left mouse button once on the piece, then once more on the destination square. To drop a new piece on a square (when applicable), press the middle or the right mouse button over the -square and select from the popup menu. In cases where you can drop +square and select from the pop-up menu. In cases where you can drop either a white or black piece, use the middle button (or shift+right) for white and the right button (or shift+middle) for black. When you are playing a bughouse game on an Internet Chess Server, a list of the -offboard pieces that each player has available is shown in the window +off-board pieces that each player has available is shown in the window title after the player's name; in addition, the piece menus show the number of pieces available of each type. From version 4.3.14 on, it is also possible in crazyhouse, bughouse or shogi to dag and drop pieces @@ -174,13 +174,13 @@ does cause these variants to become shuffle variants until you use the or select a new variant.
New Variant
Allows you to select a new chess variant in non-ICS mode. (In ICS play, the ICS is responsible for deciding which variant will be played, -and XBoard adapts autmatically.) If you play with an engine, the engine must +and XBoard adapts automatically.) If you play with an engine, the engine must be able to play the selected variant, or the command will be ignored. XBoard supports all major variants, such as xiangqi, shogi, chess, chess960, -Capablanca Chess, shatranj, crazyhous, bughouse. +Capablanca Chess, shatranj, crazyhouse, bughouse.
Load Game
Plays a game from a record file. The g key is a keyboard equivalent. -A popup dialog prompts you for the file name. If the file contains more -than one game, a second popup dialog +A pop-up dialog prompts you for the file name. If the file contains more +than one game, a second pop-up dialog displays a list of games (with information drawn from their PGN tags, if any), and you can select the one you want. Alternatively, you can load the Nth game in the file directly, by typing the number N after the @@ -213,7 +213,7 @@ Not available if the last game was loaded from a pipe.
Reload Same Game
Reloads the last game you loaded. Not available if the last game was loaded from a pipe.
Save Game
Appends a record of the current game to a file. -A popup dialog +A pop-up dialog prompts you for the file name. If the game did not begin with the standard starting position, the game file includes the starting position used. Games are saved in the PGN (portable @@ -232,7 +232,7 @@ applications, such as xterm and emacs, the middle mouse button can be used for pasting; in XBoard, you must use the Paste Game command.
Paste Game
Interprets the current X selection as a game record and loads it, as with Load Game. -
Load Position
Sets up a position from a position file. A popup dialog prompts +
Load Position
Sets up a position from a position file. A pop-up dialog prompts you for the file name. If the file contains more than one saved position, and you want to load the Nth one, type the number N after the file name, separated by a space. Position files must @@ -244,7 +244,7 @@ loaded. Not available if the last position was loaded from a pipe.
Reload Same Position
Reloads the last position you loaded. Not available if the last position was loaded from a pipe.
Save Position
Appends a diagram of the current position to a file. -A popup dialog +A pop-up dialog prompts you for the file name. Positions are saved in FEN (Forsythe-Edwards notation) format unless the oldSaveStyle option is true, in which case they are saved in an older, @@ -298,9 +298,9 @@ clock to tell XBoard which side moves first. with an engine loaded (zippy mode); the engine then will analyse the positions as they occur in the observed game.
Analyze File
This option lets you load a game from a file (PGN, XBoard format, etc.) -and analyze it. When you select this menu item, a popup window appears -and asks for a filename to load. -If the file contains multiple games, another popup appears that lets +and analyze it. When you select this menu item, a pop-up window appears +and asks for a file name to load. +If the file contains multiple games, another pop up appears that lets you select which game you wish to analyze. After a game is loaded, use the XBoard arrow buttons to step forwards/backwards through the game and watch the analysis. @@ -361,7 +361,7 @@ the ICS examine command, or start an ICS match against yourself.
Training
Training mode lets you interactively guess the moves of a game for one of the players. You guess the next move of the game by playing the move on the board. If the move played matches the next move of the -game, the move is accepted and the opponent's response is autoplayed. +game, the move is accepted and the opponent's response is auto-played. If the move played is incorrect, an error message is displayed. You can select this mode only while loading a game (that is, after selecting ‘Load Game’ from the File menu). While XBoard is in @@ -467,6 +467,10 @@ keyboard equivalent. observe command with no arguments. ICS mode only.
Stop Examining
Ends your participation in examining a game, by issuing the ICS unexamine command. ICS mode only. +
Adjudicate to White
Adjudicate to Black
Adjudicate Draw
Terminate an ongoing game in Two-Machines mode (including match mode), +with as result a win for white, for black, or a draw, respectively. +The PGN file of the game will accompany the result string +by the comment "user adjudication".
@@ -480,9 +484,9 @@ Up: Menus

2.4 Step Menu

-

+

-
Backward
Steps backward through a series of remembered moves. +
Backward
Steps backward through a series of remembered moves. The ‘[<]’ button and the b key are equivalents, as is turning the mouse wheel towards you. In addition, pressing the Control key steps back one move, and releasing @@ -501,7 +505,7 @@ off, ‘Backward’ issues the IC everyone's view of the game and allows you to make a different move. If Pause mode is on, ‘Backward’ only backs up your local view. -
Forward
Steps forward through a series of remembered moves (undoing the +
Forward
Steps forward through a series of remembered moves (undoing the effect of ‘Backward’) or forward through a game file. The ‘[>]’ button and the f key are equivalents, as is turning the mouse wheel away from you. @@ -513,7 +517,7 @@ everyone's view of the game forward along the current line. If Pause mode is on, ‘Forward’ only moves your local view forward, and it will not go past the position that the game was in when you paused. -
Back to Start
Jumps backward to the first remembered position in the game. +
Back to Start
Jumps backward to the first remembered position in the game. The ‘[<<]’ button and the shifted B key are equivalents.

In most modes, Back to Start only lets you look back at old @@ -530,7 +534,7 @@ is off, ‘Back to Start’ issue command, which backs up everyone's view of the game to the start and allows you to make different moves. If Pause mode is on, ‘Back to Start’ only backs up your local view. -

Forward to End
Jumps forward to the last remembered position in the game. The +
Forward to End
Jumps forward to the last remembered position in the game. The ‘[>>]’ button and the shifted F key are equivalents.

If you are examining an ICS game, the behavior of ‘Forward to @@ -540,21 +544,17 @@ command, which moves everyone's view of the game forward to the end of the current line. If Pause mode is on, ‘Forward to End’ only moves your local view forward, and it will not go past the position that the game was in when you paused. -

Revert
If you are examining an ICS game and Pause mode is off, issues +
Revert
If you are examining an ICS game and Pause mode is off, issues the ICS command ‘revert’. -
Truncate Game
Discards all remembered moves of the game beyond the current +
Truncate Game
Discards all remembered moves of the game beyond the current position. Puts XBoard into ‘Edit Game’ mode if it was not there already. -
Move Now
Forces the chess engine to move immediately. Chess engine mode only. -
Retract Move
Retracts your last move. In chess engine mode, you can do this only +
Move Now
Forces the chess engine to move immediately. Chess engine mode only. +
Retract Move
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 ‘Move Now’ first. In ICS mode, ‘Retract Move’ issues the command ‘takeback 1’ or ‘takeback 2’ depending on whether it is your opponent's move or yours. -
Adjudicate to White
Adjudicate to Black
Adjudicate Draw
Terminate an ongoing game in Two-Machines mode (including match mode), -with as result a win for white, for black, or a draw, repsectively. -The PGN file of the game will accompany the result string -by the comment "user adjudication".
@@ -578,24 +578,24 @@ that XBoard can perform in engine-engine games. You can instruct XBoard to detect and terminate the game on checkmate or stalemate, even if the engines would not do so, to verify engine result claims (forfeiting engines that make false claims), rather than -naively following the engine, to declare draw on posititions +naively following the engine, to declare draw on positions which can never be won for lack of mating material, (e.g. KBK), -or which are impossble to win unless the opponent seeks its own demise +or which are impossible to win unless the opponent seeks its own demise (e.g. KBKN). For these adjudications to work, ‘Test Legality’ should be switched on. -It is also possible to insruct XBoard to enforce a 50-move or 3-fold-repeat -rule and automtically declare draw (after a user-adjustable number of moves +It is also possible to instruct XBoard to enforce a 50-move or 3-fold-repeat +rule and automatically declare draw (after a user-adjustable number of moves or repeats) even if the engines are prepared to go on. It is also possible to have XBoard declare draw on games that seem to drag on -forever, or adjudicate a loss if both engines agree (for 3 cosecutive moves) that one +forever, or adjudicate a loss if both engines agree (for 3 consecutive moves) that one of them is behind more than a user-adjustable score threshold. For the latter adjudication to work, XBoard should be able to properly understand -the engine's scores. To faclitate the latter, you can inform xboard here if +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.
Engine Settings
Pops up a sub-menu where you can set some engine parameters common to most engines, such as hash-table size, tablebase cache size, maximum number of processors that SMP engines can use, and where to find the Polyglot adapter needed -to run UCI engines under XBoard. The feature tht allows setting of these parameters on +to run UCI engines under XBoard. The feature that allows setting of these parameters on engines is new since XBoard 4.3.15, so not many WinBoard engines respond to it yet, but UCI engines should. It is also possible to specify a GUI opening book here, i.e. an opening @@ -613,7 +613,7 @@ fixed time per move, will be divided by N.
Always Queen
If this option is off, XBoard brings up a dialog box whenever you move a pawn to the last rank, asking what piece you want to promote it to. If the option is true, your pawns are -always promoted to queens. Your opponent can still underpromote. +always promoted to queens. Your opponent can still under-promote.
Animate Dragging
If Animate Dragging is on, while you are dragging a piece with the mouse, an image of the piece follows the mouse cursor. If Animate Dragging is off, there is no visual feedback while you are @@ -736,9 +736,9 @@ message to standard error (the terminal) and exits immediately.
Popup Move Errors
If this option is off, when you make an error in moving (such as attempting an illegal move or moving the wrong color piece), the error message is displayed in the message area. If the option is -on, move errors are displayed in small popup windows like other errors. -You can dismiss an error popup either by clicking its OK button or by -clicking anywhere on the board, including downclicking to start a move. +on, move errors are displayed in small pop-up windows like other errors. +You can dismiss an error pop-up either by clicking its OK button or by +clicking anywhere on the board, including down-clicking to start a move.
Premove
If this option is on while playing a game on an ICS, you can register your next planned move before it is your turn. Move the piece with the mouse in the ordinary way, and the starting and ending squares @@ -908,7 +908,7 @@ true or false (‘XBoard*longOptionName: trueICS options: Connecting to and using ICS.
  • Load and Save options: Input/output options.
  • User interface options: Look and feel options. -
  • Adjudication Options: Control adjudcation of engine-engine games. +
  • Adjudication Options: Control adjudication of engine-engine games.
  • Other options: Miscellaneous. @@ -972,7 +972,7 @@ If mode=1, the engine that gets the most time will always get the nominal time, as specified by the time-control options, and its opponent's time is renormalized accordingly. If mode=0, both play with reduced time. Default: 0.
    -hideThinkingFromHuman true/false
    Controls the Hide Thinking option. See Options Menu. Default: true. -(Relaces the Show-Thinking option of older xboard versions.) +(Replaces the Show-Thinking option of older xboard versions.)
    -thinking/-xthinking or -showThinking true/false
    Forces the engine to send thinking output to xboard. Used to be the only way to control if thinking output was displayed in older xboard versions, @@ -982,7 +982,7 @@ by the new option Hide Thinking. See Options Menu. D (But if xboard needs the thinking output for some purpose, it makes the engine send it despite the setting of this option.)
    -ponder/-xponder or -ponderNextMove true/false
    Sets the Ponder Next Move menu option. See Options Menu. Default: true. -
    -smpCores number
    Specifies the maxmum nmber of CPUs an SMP engine is allowed to use. +
    -smpCores number
    Specifies the maximum number of CPUs an SMP engine is allowed to use. Only works for engines that support the WinBoard-protocol cores feature.
    -mg or -matchGames n
    Automatically runs an n-game match between two chess engines, with alternating colors. @@ -1110,10 +1110,10 @@ Up: Options
    -fUCI or -firstIsUCI true/false
    -sUCI or -secondIsUCI true/false
    Indicates if the mentioned engine executable file is an UCI engine, and should be run with the aid of the Polyglot adapter rather than directly. Xboard will then pass the other UCI options and engine name to Polyglot -through a .ini temporary file ceated for the purpose. +through a .ini temporary file created for the purpose.
    -PolyglotDir filename
    Gives the name of the directory in which the Polyglot adapter for UCI engines expects its files. Default: "/usr/local/share/polyglot". -
    -usePolyglotBook true/false
    Specifies if the Polygot book should be used. +
    -usePolyglotBook true/false
    Specifies if the Polyglot book should be used.
    -PolyglotBook filename
    Gives the filename of the opening book that Polyglot should use. From XBoard 4.3.15 on, native WinBoard engines will also use the opening book specified here, provided the usePolyglotBook option is set to true, @@ -1200,7 +1200,7 @@ See Firewalls. the given character I/O device instead of opening a TCP connection. Use this option if your system does not have any kind of Internet connection itself (not even a SLIP or PPP connection), -but you do have dialup access (or a hardwired terminal line) to +but you do have dial-up access (or a hardwired terminal line) to an Internet service provider from which you can telnet to the ICS.

    The support for this option in XBoard is minimal. You need to @@ -1623,9 +1623,9 @@ if both engines agree for a duration of 6 consecutive ply that the score is below the given score threshold for that engine. Make sure the score is interpreted properly by XBoard, using -firstScoreAbs and -secondScoreAbs if needed. -Default: 0 (no adjudiction) +Default: 0 (no adjudication)

    -adjudicateDrawMoves n
    If the given value is non-zero, XBoard adjudicates the game as a draw -if after the given number of moves it was not yet decided. Defaut: 0 (no adjudication) +if after the given number of moves it was not yet decided. Default: 0 (no adjudication)
    -checkMates true/false
    If this option is set, XBoard detects all checkmates and stalemates, and ends the game as soon as they occur. Legality-testing must be switched on for this option to work. @@ -1700,7 +1700,7 @@ needed in ICS mode. Recognized variant names are: gothic similar, with a better initial position caparandom An FRC-like version of Capablanca Chess (10x8) janus A game with two Archbishops (10x8 board) - courier Medieval intermedite between shatranj and + courier Medieval intermediate between shatranj and modern Chess (on 12x8 board) falcon Patented 10x8 variant with two Falcon pieces berolina Pawns capture straight ahead, and move diagonal @@ -1714,12 +1714,12 @@ needed in ICS mode. Recognized variant names are:

    In the shuffle variants, XBoard now does shuffle the pieces, although you can still do it by hand using Edit Position. Some variants are supported only in ICS mode, including bughouse, and -kriegspiel. The winning/drawing conditions in crazyhouse (offboard +kriegspiel. The winning/drawing conditions in crazyhouse (off-board interposition on mate), losers, suicide, giveaway, atomic, and 3check are not fully understood. Berolina and cylinder chess can only be played with legality testing off. In crazyhouse, XBoard now does keep -track of offboard pieces. In shatranj it does implement the baring +track of off-board pieces. In shatranj it does implement the baring rule when mate detection is switched on.

    -boardHeight N
    Allows you to set a non-standard number of board ranks in any variant. If the height is given as -1, the default height for the variant is used. @@ -1767,7 +1767,7 @@ with respect to saving it in the debug file. The output is further (hopefully) ignored. If number=0, WinBoard refrains from writing such spurious output to the debug file. If number=1, all engine output is written faithfully to the debug file. -If number=2, any protocol-violating line is prefixed with a ‘#’ character, +If number=2, any protocol-violating line is prefixed with a '#' character, as the engine itself should have done if it wanted to submit info for inclusion in the debug file. This option is provided for the benefit of applications that use the debug file as a source of information, such as the broadcaster of live games TLCV / TLCS. @@ -1779,7 +1779,7 @@ configured and compiled. remoteShell. The default is your local user name.
    -userName username
    Name under which the Human player will be listed in the PGN file. Default is the login name on your local computer. -
    -delayBeforeQuit number
    -delayAfterQuit number
    These options specify how long WinBoard has to wait before sending a termination signal to rogue engine processes, that do not want to react to the ‘quit’ command. The second one determines the pause after killing the engine, to make sure it dies. +
    -delayBeforeQuit number
    -delayAfterQuit number
    These options specify how long WinBoard has to wait before sending a termination signal to rogue engine processes, that do not want to react to the 'quit' command. The second one determines the pause after killing the engine, to make sure it dies. @@ -2169,7 +2169,7 @@ responsible for versions 1.0 through 1.2.

    Evan Welsh wrote CMail. Patrick Surry helped in designing, testing, and documenting CMail. -

    Allessandro Scotti added many elements to the user interface of WinBoard, +

    Alessandro Scotti added many elements to the user interface of WinBoard, including the board textures and font-based rendering, the evaluation-graph, move-history and engine-output window. He was also responsible for adding the UCI support. @@ -2180,7 +2180,7 @@ the crazyhouse holdings, and the fairy pieces. In addition he added most of the adjudication options, made WinBoard more robust in dealing with buggy and crashing engines, and extended time control with a time-odds and node-count-based modes. -Most of the options that initially wre WinBoard only have now been back-ported to XBoard. +Most of the options that initially were WinBoard only have now been back-ported to XBoard.

    Michel van den Bergh provided the code for reading Polyglot opening books. @@ -2455,13 +2455,13 @@ Up: Other programs

    11.2 Fairy-Max

    -

    Fairy-Max is a derivative from the World's smallest Chess program micro-Max, +

    Fairy-Max is a derivative from the once World's smallest Chess program micro-Max, which measures only about 100 lines of source code. The main difference with micro-Max is that Fairy-Max loads its move-generator tables from a file, so that the rules for piece movement can be easily configured to implement unorthodox pieces. -Fairy-Max can therefore play a lage number of variants, normal Chess being one of those. -In addition it plas Knightmate, Capablanca and Gothic Chess, Shatranj, Courier Chess, +Fairy-Max can therefore play a large number of variants, normal Chess being one of those. +In addition it plays Knightmate, Capablanca and Gothic Chess, Shatranj, Courier Chess, Cylinder chess, Berolina Chess, while the user can easily define new variants. It can be obtained from: @@ -3334,10 +3334,10 @@ Up: Top

  • .cmailaliases: CMail options
  • .cmailgames: CMail options
  • .icsrc: ICS options
    • -
  • <, Button: Step Menu
    • -
  • <<, Button: Step Menu
    • -
  • >, Button: Step Menu
    • -
  • >>, Button: Step Menu
    • +
  • <, Button: Step Menu
    • +
  • <<, Button: Step Menu
    • +
  • >, Button: Step Menu
    • +
  • >>, Button: Step Menu
  • abort, ICS command: Chess Servers
  • Abort, Menu Item: Action Menu
  • About XBoard, Menu Item: Help Menu
    • @@ -3346,9 +3346,9 @@ Up: Top
  • Action, Menu: Action Menu
  • adjourn, ICS command: Chess Servers
  • Adjourn, Menu Item: Action Menu
    • -
  • Adjudicate Draw, Menu Item: Step Menu
    • -
  • Adjudicate to Black, Menu Item: Step Menu
    • -
  • Adjudicate to White, Menu Item: Step Menu
    • +
  • Adjudicate Draw, Menu Item: Action Menu
    • +
  • Adjudicate to Black, Menu Item: Action Menu
    • +
  • Adjudicate to White, Menu Item: Action Menu
  • adjudicateDrawMoves, option: Adjudication Options
  • adjudicateLossThreshold, option: Adjudication Options
  • Adjudications, Menu Item: Options Menu
    • @@ -3382,8 +3382,8 @@ Up: Top
  • autoRaiseBoard, option: User interface options
  • autosave, option: Load and Save options
  • autoSaveGames, option: Load and Save options
    • -
  • Back to Start, Menu Item: Step Menu
    • -
  • Backward, Menu Item: Step Menu
    • +
  • Back to Start, Menu Item: Step Menu
    • +
  • Backward, Menu Item: Step Menu
  • bell, option: User interface options
  • bitmapDirectory, option: User interface options
  • blackPieceColor, option: User interface options
    • @@ -3486,8 +3486,8 @@ Up: Top
  • Font, coordinates: User interface options
  • font, option: User interface options
  • fontSizeTolerance, option: User interface options
    • -
  • Forward to End, Menu Item: Step Menu
    • -
  • Forward, Menu Item: Step Menu
    • +
  • Forward to End, Menu Item: Step Menu
    • +
  • Forward, Menu Item: Step Menu
  • fUCI, option: UCI + WB Engine Settings
  • gameListTags, option: Load and Save options
  • games, ICS command: Chess Servers
    • @@ -3567,7 +3567,7 @@ Up: Top
  • Menu, Help: Help Menu
  • Menu, Mode: Mode Menu
  • Menu, Options: Options Menu
    • -
  • Menu, Step: Step Menu
    • +
  • Menu, Step: Step Menu
  • Menus: Menus
  • mg, option: Chess engine options
  • mm, option: Chess engine options
    • @@ -3575,7 +3575,7 @@ Up: Top
  • mode, option: Other options
  • mono, option: User interface options
  • monoMode, option: User interface options
    • -
  • Move Now, Menu Item: Step Menu
    • +
  • Move Now, Menu Item: Step Menu
  • Move Sound, Menu Item: Options Menu
  • moves, option: ICS options
  • movesound, option: User interface options
    • @@ -3639,12 +3639,12 @@ Up: Top
  • Reporting bugs: Problems
  • Reporting problems: Problems
  • Resign, Menu Item: Action Menu
    • -
  • Retract Move, Menu Item: Step Menu
    • +
  • Retract Move, Menu Item: Step Menu
  • reuse, option: Chess engine options
  • reuse2, option: Chess engine options
  • reuseFirst, option: Chess engine options
  • reuseSecond, option: Chess engine options
    • -
  • Revert, Menu Item: Step Menu
    • +
  • Revert, Menu Item: Step Menu
  • ringBellAfterMoves, option: User interface options
  • rsh, option: Other options
  • ruleMoves, option: Adjudication Options
    • @@ -3704,7 +3704,7 @@ Up: Top
  • soundTell, option: ICS options
  • spf, option: Load and Save options
  • st, option: Chess engine options
    • -
  • Step Menu: Step Menu
    • +
  • Step Menu: Step Menu
  • Stop Examining, Menu Item: Action Menu
  • Stop Observing, Menu Item: Action Menu
  • sUCI, option: UCI + WB Engine Settings
    • @@ -3725,7 +3725,7 @@ Up: Top
  • titleInWindow, option: User interface options
  • Training, Menu Item: Mode Menu
  • trivialDraws, option: Adjudication Options
    • -
  • Truncate Game, Menu Item: Step Menu
    • +
  • Truncate Game, Menu Item: Step Menu
  • Two Machines, Menu Item: Mode Menu
  • usePolyglotBook, option: UCI + WB Engine Settings
  • User interface options: User interface options