X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=manual%2Fxboard.html;h=5a8eb5105b76d06da1538f061bc4bd6807270f9e;hb=10173187bb807a7194df200fef7a0e5efe47688f;hp=f6ced810bef4847f5dccbf9e9fa16b98a4a317b2;hpb=0f848da7556dd6eadf0a33029d2aade7676caa37;p=xboard.git diff --git a/manual/xboard.html b/manual/xboard.html index f6ced81..5a8eb51 100644 --- a/manual/xboard.html +++ b/manual/xboard.html @@ -3,7 +3,7 @@
This manual documents version 4.4.0j of XBoard. +
This manual documents version 4.4.3 of XBoard.
loadGameFile
or loadPositionFile
option is set,
@@ -1072,11 +1073,11 @@ that in favor of white, even when the engine plays black.
Important when XBoard uses the score for adjudications, or in PGN reporting.
usePolyglotBook
option is set to true,
and the option firstHasOwnBookUCI
or secondHasOwnBookUCI
applying to the engine
is set to false.
@@ -1124,11 +1125,11 @@ and XBoard will select the book moves for it. Default "".
-firstScoreAbs
and -secondScoreAbs
if needed.
Default: 0 (no adjudication)
-NOT ALL BOARDSIZES PROVIDE A COMPLETE SET OF BUILT-IN BITMAPS FOR ALL
+UN-ORTHODOX PIECES, though. Only in boardSize
middling and bulky
+all 22 piece types are provided, while -boardSize petite has most
+of them. Archbishop, Chancellor and Amazon are supported in every
+size from petite to bulky. Kings or Amazons are substituted for
+missing bitmaps. You can still play variants needing un-orthodox
+pieces in other board sizes providing your own bitmaps through the
+bitmapDirectory
or pixmapDirectory
options.
+
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 (off-board
-interposition on mate), losers, suicide, giveaway, atomic, and 3check
-are not fully understood.
+interposition on mate) are not fully understood, but losers, suicide,
+giveaway, atomic, and 3check should be OK.
Berolina and cylinder chess can only be played with legality testing off.
In crazyhouse, XBoard now does keep
track of off-board pieces. In shatranj it does implement the baring
rule when mate detection is switched on.
-
remoteShell
. The default is your local user name.
-An Internet Chess Server, or ICS, is a place on the +
An Internet Chess Server, or ICS, is a place on the
Internet where people can get together to play chess, watch other
people's games, or just chat. You can use either telnet
or a
client program like XBoard to connect to the server. There are
@@ -1827,25 +1845,25 @@ unique guest name for you.
Some useful ICS commands include
For example help register tells you how to become a registered
ICS player.
-
Some special XBoard features are activated when you are @@ -1875,8 +1893,8 @@ and ‘Stop Examining’ on the < Options Menu.
Game and position files are found in a directory named by the +
Game and position files are found in a directory named by the
CHESSDIR
environment variable. If this variable is not set, the
current working directory is used. If CHESSDIR
is set,
XBoard actually changes its working directory to
@@ -2023,8 +2041,8 @@ XBoard actually changes its working directory to
will be placed there too.
There is no way for two people running copies of XBoard to play +
There is no way for two people running copies of XBoard to play each other without going through an Internet Chess Server.
Under some circumstances, your ICS password may be echoed when you log on. @@ -2059,7 +2077,7 @@ The piece-drop menu does not check piece drops in bughouse to see if you actuall the piece you are trying to drop. But this way of dropping pieces should be considered an obsolete feature, now that pieces can be dropped by dragging them from the holdings to the board. Anyway, if you would attempt an illegal move when using a chess engine or the ICS, -WinBoard will accept the error message that comes back, undo the move, and let you try another. +XBoard will accept the error message that comes back, undo the move, and let you try another. FEN positions saved by XBoard do include correct information about whether castling or en passant are legal, and also handle the 50-move counter. The mate detector does not understand that non-contact mate is not really mate in bughouse. @@ -2088,8 +2106,8 @@ not an XBoard bug. possible bugs, limitations, and ideas for improvement that have been suggested.
-Report bugs and problems with XBoard to <bug-xboard@gnu.org>
.
+
+You can report bugs and problems with XBoard using
+the bug tracker at https://savannah.gnu.org/projects/xboard/
+or by sending mail to <bug-xboard@gnu.org>
. It can also
+be useful to report or discuss bugs in the WinBoard Forum at
+http://www.open-aurec.com/wbforum/
,
+WinBoard development section.
Please use the script program to start a typescript, run XBoard with the ‘-debug’ option, and include the typescript output in your message. Also tell us what kind of machine and what operating system version -you are using. The command ‘uname -a’ will often tell you this. -Here is a sample of approximately what you should type: - -
script - uname -a - ./configure - make - ./xboard -debug - exit - mail bug-xboard@gnu.org - Subject: Your short description of the problem - Your detailed description of the problem - ~r typescript - . --
The WinBoard / XBoard 4.3 line is being developed by H.G. Muller -independently of the GNU Savannah xboard project. -Bug reports on this version, and suggestions for improvements and additions, -are best posted in the WinBoard forum, -WinBoard-development section (http://www.open-aurec.com/wbforum). +you are using. The command ‘uname -a’ will often tell you this.
If you improve XBoard, please send a message about your changes, and we will get in touch with you about merging them in -to the main line of development. -Also see our Web site at http://savannah.gnu.org/projects/xboard/. +to the main line of development.
-Tim Mann has been responsible for XBoard versions 1.3 and beyond, and -for WinBoard, a port of XBoard to Microsoft Win32 (Windows NT and -Windows 95). H.G.Muller is responsible for version 4.3. - -
Mark Williams contributed the initial (WinBoard-only) implementation -of many new features added to both XBoard and WinBoard in version -4.1.0, including copy/paste, premove, icsAlarm, autoFlipView, training -mode, auto raise, and blindfold. Ben Nye contributed X copy/paste -code for XBoard. - -
Hugh Fisher added animated piece movement to XBoard, and Henrik Gram -(henrikg@funcom.com) added it to WinBoard. Frank McIngvale added -click/click moving, the Analysis modes, piece flashing, ZIICS import, -and ICS text colorization to XBoard. Jochen Wiedmann ported XBoard to -the Amiga, creating AmyBoard, and converted the documentation to -texinfo. Elmar Bartel contributed the new piece bitmaps introduced in -version 3.2. John Chanak contributed the initial implementation of -ICS mode. The color scheme and the old 80x80 piece bitmaps were taken +
+Chris Sears and Dan Sears wrote the original XBoard. They were
+responsible for versions 1.0 through 1.2. The color scheme was taken
from Wayne Christopher's XChess
program.
-
Chris Sears and Dan Sears wrote the original XBoard. They were -responsible for versions 1.0 through 1.2. +
Tim Mann was primarily responsible for XBoard versions 1.3 through +4.2.7, and for WinBoard (a port of XBoard to Microsoft Win32) from its +inception through version 4.2.7. + +
John Chanak contributed the initial implementation of ICS mode. Evan
+Welsh wrote CMail
, and Patrick Surry helped in designing,
+testing, and documenting it. Elmar Bartel contributed the new piece
+bitmaps introduced in version 3.2. Jochen Wiedmann converted the
+documentation to texinfo. Frank McIngvale added click/click moving,
+the Analysis modes, piece flashing, ZIICS import, and ICS text
+colorization to XBoard. Hugh Fisher added animated piece movement to
+XBoard, and Henrik Gram added it to WinBoard. Mark Williams
+contributed the initial (WinBoard-only) implementation of many new
+features added to both XBoard and WinBoard in version 4.1.0, including
+copy/paste, premove, icsAlarm, autoFlipView, training mode, auto
+raise, and blindfold. Ben Nye contributed X copy/paste code for
+XBoard.
-
Evan Welsh wrote CMail
. Patrick Surry helped in designing,
-testing, and documenting CMail.
+
In a fork from version 4.2.7, 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. + +
H. G. Muller continued this fork of the project, producing version +4.3. He made WinBoard castling- and e.p.-aware, added variant support +with adjustable board sizes, 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 were WinBoard only have now been +back-ported to XBoard. -
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. +
Michel van den Bergh provided the code for reading Polyglot opening books. -
H.G. Muller made WinBoard castling- and e.p.-aware, -added variant support with adjustable board sizes, -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 were WinBoard only have now been back-ported to XBoard. +
Meanwhile, some work continued on the GNU XBoard project maintained at +savannah.gnu.org, but version 4.2.8 was never released. Daniel +Mehrmann was responsible for much of this work. -
Michel van den Bergh provided the code for reading Polyglot opening books. +
Most recently, Arun Persaud worked with H. G. Muller to merge all +the features of the never-released XBoard/WinBoard 4.2.8 of the GNU +XBoard project and the never-released 4.3.16 from H. G.'s fork into a +unified XBoard/WinBoard 4.4, which is now available both from the +savannah.gnu.org web site and the WinBoard forum. -
Arun Persaud worked with H.G. Muller to combine all the features of the never-released WinBoard 4.2.8 -of the Savannah project (mainly by Daniel Mehrmann), -and the never-released 4.3.16 into a unified WinBoard 4.4, -which is now available both from the Savannah web site and the WinBoard forum.
The cmail program can help you play chess by email with opponents of +
The cmail program can help you play chess by email with opponents of your choice using XBoard as an interface.
You will usually run cmail without giving any options. @@ -2214,8 +2221,8 @@ your choice using XBoard as an interface.
$CMAIL_MAILPROG
or failing that
/usr/ucb/Mail, /usr/ucb/mail or Mail. You will need
to set this variable if none of the above paths fit your system.
-$CMAIL_GAMES
or failing that
-.cmailgames.
-$CMAIL_ALIASES
or failing
-that .cmailaliases.
Here are some other programs you can use with XBoard
http://home.hccnet.nl/h.g.muller/dwnldpage.html
sudo apt-get install hoichess
Enhancements copyright © -1992-2003,2004,2005,2006,2007,2008,2009 Free Software Foundation, Inc. +
Enhancements copyright © 1992-2003, 2004, 2005, 2006, 2007, +2008, 2009, 2010 Free Software Foundation, Inc.
Published by the Free Software Foundation 59 Temple Place - Suite 330 @@ -2612,8 +2613,8 @@ and this permission notice, may be included in translations approved by the Free Software Foundation instead of in the original English.-
+
Next: Index, Previous: Copyright, Up: Top @@ -3320,8 +3321,8 @@ first, please read htt-
+
Previous: Copying, Up: Top @@ -3331,26 +3332,27 @@ Up: Top
- -animateSpeed, option: User interface options
-- .cmailaliases: CMail options
-- .cmailgames: CMail options
+- -autoDisplayComment, option: User interface options
+- -autoDisplayTags, option: User interface options
+- -pasteSelection, option: User interface options
- .icsrc: ICS options
- <, Button: Step Menu
- <<, Button: Step Menu
- >, Button: Step Menu
- >>, Button: Step Menu
-- abort, ICS command: Chess Servers
+- abort, ICS command: Chess Servers
- Abort, Menu Item: Action Menu
- About XBoard, Menu Item: Help Menu
-- accept, ICS command: Chess Servers
+- accept, ICS command: Chess Servers
- Accept, Menu Item: Action Menu
- Action, Menu: Action Menu
-- adjourn, ICS command: Chess Servers
+- adjourn, ICS command: Chess Servers
- Adjourn, Menu Item: Action 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
+- adjudicateDrawMoves, option: Adjudication Options
+- adjudicateLossThreshold, option: Adjudication Options
- Adjudications, Menu Item: Options Menu
- alarm, option: ICS options
- Always Queen, Menu Item: Options Menu
@@ -3362,7 +3364,7 @@ Up: Top- animate, option: User interface options
- animateDragging, option: User interface options
- animateMoving, option: User interface options
-- Authors: Contributors
+- Authors: Contributors
- Auto Comment, Menu Item: Options Menu
- Auto Flag, Menu Item: Options Menu
- Auto Flip View, Menu Item: Options Menu
@@ -3392,22 +3394,22 @@ Up: Top- blindfold, option: User interface options
- bm, option: User interface options
- board size: User interface options
-- boardHeight, option: Other options
+- boardHeight, option: Other options
- boardSize, option: User interface options
-- boardWidth, option: Other options
+- boardWidth, option: Other options
- Book, Menu Item: Help Menu
-- Bug reports: Problems
-- Bugs: Problems
-- Bugs: Limitations
+- Bug reports: Problems
+- Bugs: Problems
+- Bugs: Limitations
- buttons, option: User interface options
- Call Flag, Menu Item: Action Menu
-- checkMates, option: Adjudication Options
+- checkMates, option: Adjudication Options
- Chess engine options: Chess engine options
-- CHESSDIR: Environment
+- CHESSDIR: Environment
- clock, option: Chess engine options
- clockFont, option: User interface options
- clockMode, option: Chess engine options
-- cmail: CMail
+- cmail: CMail
- colorChallenge, option: ICS options
- colorChannel, option: ICS options
- colorChannel1, option: ICS options
@@ -3421,26 +3423,26 @@ Up: Top- colorShout, option: ICS options
- colorSShout, option: ICS options
- colorTell, option: ICS options
-- Contributors: Contributors
+- Contributors: Contributors
- coordFont, option: User interface options
- coords, option: User interface options
- Copy Game, Menu Item: File Menu
- Copy Position, Menu Item: File Menu
- darkSquareColor, option: User interface options
-- debug, option: Other options
-- debugFile, option: Other options
-- debugMode, option: Other options
-- decline, ICS command: Chess Servers
+- debug, option: Other options
+- debugFile, option: Other options
+- debugMode, option: Other options
+- decline, ICS command: Chess Servers
- Decline, Menu Item: Action Menu
- defaultCacheSizeEGTB, option: UCI + WB Engine Settings
-- defaultFrcPosition, option: Other options
+- defaultFrcPosition, option: Other options
- defaultHashSize, option: UCI + WB Engine Settings
- defaultPathEGTB, option: UCI + WB Engine Settings
-- delayAfterQuit, option: Other options
-- delayBeforeQuit, option: Other options
+- delayAfterQuit, option: Other options
+- delayBeforeQuit, option: Other options
- display, option: User interface options
- drag, option: User interface options
-- draw, ICS command: Chess Servers
+- draw, ICS command: Chess Servers
- Draw, Menu Item: Action Menu
- Edit Comment, Menu Item: Mode Menu
- Edit Game, Menu Item: Mode Menu
@@ -3448,9 +3450,9 @@ Up: Top- Edit Tags, Menu Item: Mode Menu
- egtFormats, option: UCI + WB Engine Settings
- Engine Settings: UCI + WB Engine Settings
-- engineDebugOutput, option: Other options
-- Environment variables: Environment
-- examine, ICS command: Chess Servers
+- engineDebugOutput, option: Other options
+- Environment variables: Environment
+- examine, ICS command: Chess Servers
- Exit, Menu Item: File Menu
- exit, option: User interface options
- fb, option: Chess engine options
@@ -3458,7 +3460,7 @@ Up: Top- fd, option: Chess engine options
- fh, option: Chess engine options
- File Menu: File Menu
-- finger, ICS command: Chess Servers
+- finger, ICS command: Chess Servers
- firstChessProgram, option: Chess engine options
- firstComputerString, option: Chess engine options
- firstDirectory, option: Chess engine options
@@ -3490,27 +3492,27 @@ Up: Top- Forward, Menu Item: Step Menu
- fUCI, option: UCI + WB Engine Settings
- gameListTags, option: Load and Save options
-- games, ICS command: Chess Servers
+- games, ICS command: Chess Servers
- gateway, option: ICS options
- geometry, option: User interface options
- Get Move List, Menu Item: Options Menu
- getMoveList, option: ICS options
- Help Menu: Help Menu
-- help, ICS command: Chess Servers
+- help, ICS command: Chess Servers
- Hide Thinking, Menu Item: Options Menu
- Highlight Last Move, Menu Item: Options Menu
- highlight, option: User interface options
- highlightLastMove, option: User interface options
- highlightSquareColor, option: User interface options
- Hint, Menu Item: Help Menu
-- holdingsSize, option: Other options
+- holdingsSize, option: Other options
- iconic, option: User interface options
-- ICS: Chess Servers
+- ICS: Chess Servers
- ICS Alarm, Menu Item: Options Menu
- ICS Client, Menu Item: Mode Menu
- ICS Input Box, Menu Item: Mode Menu
- ICS options: ICS options
-- ICS, addresses: Chess Servers
+- ICS, addresses: Chess Servers
- ics, option: ICS options
- icsAlarm, option: ICS options
- icsAlarmTime, option: ICS options
@@ -3522,9 +3524,9 @@ Up: Top- icsport, option: ICS options
- inc, option: Chess engine options
- Info XBoard, Menu Item: Help Menu
-- initalMode, option: Other options
+- initalMode, option: Other options
- initString, option: Chess engine options
-- Internet Chess Server: Chess Servers
+- Internet Chess Server: Chess Servers
- internetChessServerCommPort, option: ICS options
- internetChessServerHelper, option: ICS options
- internetChessServerHost, option: ICS options
@@ -3538,7 +3540,7 @@ Up: Top- lgf, option: Load and Save options
- lgi, option: Load and Save options
- lightSquareColor, option: User interface options
-- Limitations: Limitations
+- Limitations: Limitations
- Load and Save options: Load and Save options
- Load Game, Menu Item: File Menu
- Load Next Game, Menu Item: File Menu
@@ -3561,7 +3563,7 @@ Up: Top- Man XBoard, Menu Item: Help Menu
- matchGames, option: Chess engine options
- matchMode, option: Chess engine options
-- materialDraws, option: Adjudication Options
+- materialDraws, option: Adjudication Options
- Menu, Action: Action Menu
- Menu, File: File Menu
- Menu, Help: Help Menu
@@ -3572,7 +3574,7 @@ Up: Top- mg, option: Chess engine options
- mm, option: Chess engine options
- Mode Menu: Mode Menu
-- mode, option: Other options
+- mode, option: Other options
- mono, option: User interface options
- monoMode, option: User interface options
- Move Now, Menu Item: Step Menu
@@ -3582,35 +3584,35 @@ Up: Top- movesPerSession, option: Chess engine options
- mps, option: Chess engine options
- msLoginDelay, option: ICS options
-- nameOfDebugFile, option: Other options
-- ncp, option: Other options
+- nameOfDebugFile, option: Other options
+- ncp, option: Other options
- New Game, Menu Item: File Menu
- New Shuffle Game, Menu Item: File Menu
- New variant, Menu Item: File Menu
- niceEngines, option: Chess engine options
-- noChessProgram, option: Other options
+- noChessProgram, option: Other options
- noGUI, option: User interface options
-- observe, ICS command: Chess Servers
+- observe, ICS command: Chess Servers
- Old Save Style, Menu Item: Options Menu
-- oldmoves, ICS command: Chess Servers
+- oldmoves, ICS command: Chess Servers
- oldsave, option: Load and Save options
- oldSaveStyle, option: Load and Save options
- Options: Options
- Options Menu: Options Menu
-- Options, adjudication: Adjudication Options
+- Options, adjudication: Adjudication Options
- options, Chess engine: Chess engine options
- Options, ICS: ICS options
- Options, Load and Save: Load and Save options
-- Options, miscellaneous: Other options
+- Options, miscellaneous: Other options
- Options, User interface: User interface options
-- Other programs: Other programs
+- Other programs: Other programs
- Paste Game, Menu Item: File Menu
- Paste Position, Menu Item: File Menu
- Pause, Menu Item: Mode Menu
- Periodic Updates, Menu Item: Options Menu
- pgnEventHeader, option`: Load and Save options
- pgnExtendedInfo, option`: Load and Save options
-- pieceToSquareTable, option: Other options
+- pieceToCharTable, option: Other options
- pixmap, option: User interface options
- pixmapDirectory, option: User interface options
- PolyglotBook, option: UCI + WB Engine Settings
@@ -3626,7 +3628,7 @@ Up: Top- pre, option: ICS options
- Premove, Menu Item: Options Menu
- premove, option: ICS options
-- Problems: Problems
+- Problems: Problems
- queen, option: User interface options
- Quiet Play, Menu Item: Options Menu
- quiet, option: ICS options
@@ -3634,10 +3636,10 @@ Up: Top- Reload CMail Message, Menu Item: File Menu
- Reload Same Game, Menu Item: File Menu
- Reload Same Position, Menu Item: File Menu
-- remoteShell, option: Other options
-- remoteUser, option: Other options
-- Reporting bugs: Problems
-- Reporting problems: Problems
+- remoteShell, option: Other options
+- remoteUser, option: Other options
+- Reporting bugs: Problems
+- Reporting problems: Problems
- Resign, Menu Item: Action Menu
- Retract Move, Menu Item: Step Menu
- reuse, option: Chess engine options
@@ -3646,9 +3648,9 @@ Up: Top- reuseSecond, option: Chess engine options
- Revert, Menu Item: Step Menu
- ringBellAfterMoves, option: User interface options
-- rsh, option: Other options
-- ruleMoves, option: Adjudication Options
-- ruser, option: Other options
+- rsh, option: Other options
+- ruleMoves, option: Adjudication Options
+- ruser, option: Other options
- sameColorGames, option: Chess engine options
- Save Game, Menu Item: File Menu
- saveGameFile, option: Load and Save options
@@ -3672,7 +3674,7 @@ Up: Top- secondScoreAbs, option: Chess engine options
- secondTimeOdds, option: Chess engine options
- secondXBook, option: UCI + WB Engine Settings
-- set, ICS command: Chess Servers
+- set, ICS command: Chess Servers
- Settings, Engine: UCI + WB Engine Settings
- sgf, option: Load and Save options
- sh, option: Chess engine options
@@ -3713,7 +3715,7 @@ Up: Top- telnet, option: ICS options
- telnetProgram, option: ICS options
- Test Legality, Menu Item: Options Menu
-- testClaims, option: Adjudication Options
+- testClaims, option: Adjudication Options
- testLegality, option: User interface options
- thinking, option: Chess engine options
- Time Control, Menu Item: Options Menu
@@ -3724,17 +3726,17 @@ Up: Top- title, option: User interface options
- titleInWindow, option: User interface options
- Training, Menu Item: Mode Menu
-- trivialDraws, option: Adjudication Options
+- trivialDraws, option: Adjudication Options
- Truncate Game, Menu Item: Step Menu
- Two Machines, Menu Item: Mode Menu
- usePolyglotBook, option: UCI + WB Engine Settings
- User interface options: User interface options
-- userName, option: Other options
+- userName, option: Other options
- useTelnet, option: ICS options
-- variant, option: Other options
-- vars, ICS command: Chess Servers
+- variant, option: Other options
+- vars, ICS command: Chess Servers
- whitePieceColor, option: User interface options
-- who, ICS command: Chess Servers
+- who, ICS command: Chess Servers
- xflash, option: User interface options