X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=manual%2Fxboard.html;h=9e7c574e0b38298c684ee9f0ab0ded8233530f8f;hb=34f538f46ddad3e88adfbe825ca0aeaa61ce3c5d;hp=970918d822d4d545a24883542669a85ad5689874;hpb=5538e55a9678d04ac6d94baedacd150fa3910a61;p=xboard.git
diff --git a/manual/xboard.html b/manual/xboard.html
index 970918d..9e7c574 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,14 @@ does cause these variants to become shuffle variants until you use the
or select a new variant.
oldSaveStyle
option is true, in which case they are saved in an older,
@@ -298,9 +299,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.
In most modes, Back to Start only lets you look back at old
@@ -530,7 +535,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.
-
If you are examining an ICS game, the behavior of ‘Forward to
@@ -540,21 +545,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.
-
loadGameFile
or loadPositionFile
option is set,
@@ -1072,15 +1073,25 @@ 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.
The engine will be kept in force mode as long as the current position is in book,
and XBoard will select the book moves for it. Default "".
-chessclub.com
.
Another popular chess server to try is freechess.org
.
If your site doesn't have a working Internet name server, try
@@ -1156,15 +1167,15 @@ specifying the host address in numeric form.
You may also need
to specify the numeric address when using the icshelper option
with timestamp or timeseal (see below).
--useTelnet -telnetProgram program
.
-gateway
and useTelnet
options. The default is
telnet. The telnet program is invoked with the value of
internetChessServerHost
as its first argument and the value
of internetChessServerPort
as its second argument.
See Firewalls.
-telnetProgram
on the given host,
instead of using its own internal implementation
of the telnet protocol. You can substitute a different remote shell
program for rsh using the remoteShell
option described below.
See Firewalls.
-The support for this option in XBoard is minimal. You need to
@@ -1229,7 +1240,7 @@ Then telnet to ICS, using a command like
telnet chessclub.com 5000.
Important: See the paragraph below about extra echoes,
in Limitations.
-
-icslogon
option, inserting some delay between characters
of the logon script may help. This option adds delay
milliseconds of delay between characters. Good values to try
are 100 and 250.
-showThinking
must be switched on for
this option to work.
Also diverts similar kibitz information of an opponent engine that is playing you
through the ICS to the engine-output window, as if the engine was playing locally.
--colorize
on without specifying your own colors.
xboard*colorSeek: blue
xboard*colorNormal: default
- loadGameFile
option is set, XBoard loads the specified
+loadGameFile
option is set, XBoard loads the specified
game file at startup. The file name - specifies the standard
input. If there is more than one game in the file, XBoard
pops up a menu of the available games, with entries based on their PGN
@@ -1365,16 +1378,16 @@ first game of the file when it has reached a specified value.
positions or games in auto-increment matchMode
.
See loadPositionIndex
and loadGameIndex
.
default: 0 (no rewind).
-saveGameFile
is set.
-loadPositionFile
option is set, XBoard loads the
+loadPositionFile
option is set, XBoard loads the
specified position file at startup. The file name - specifies the
standard input. If the loadPositionIndex
option is set to N,
the Nth position found in the file is loaded; otherwise the
@@ -1387,15 +1400,21 @@ causes the index to be incremented every two games, so that each position
in the file is used twice (with the engines playing opposite colors).
The rewindIndex
option causes the index to be reset to the
first position of the file when it has reached a specified value.
-titleInWindow
is true,
the window layout is rearranged to make more room for the title.
If tinyLayout is 1, the labels on the menu bar are abbreviated
to one character each and the buttons in the button bar are made narrower.
-coordFont
option specifies what font to use.
-monoMode
; XBoard will determine if it is necessary.
-flashCount
tells XBoard how many times to flash a piece after it
@@ -1493,23 +1512,23 @@ sets flashCount to 3.
xflash
sets flashCount to 0.
Defaults: flashCount=0 (no flashing), flashRate=5.
-showCoords
+showCoords
is true. If the option value is a pattern that does not specify
the font size, XBoard tries to choose an appropriate font for
the board size being used.
Default: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*.
-tol
pixels
or less from the desired size. A value of -1 will force
@@ -1517,7 +1536,7 @@ a scalable font to always be used if available; a value of 0 will
use a nonscalable font only if it is exactly the right size;
a large value (say 1000) will force a nonscalable font to always be
used if available. Default: 4.
-For more information about pixmap pieces and how to get additional
sets, see zic2xpm below.
-
-whitePieceColor #FFFFCC @@ -1569,6 +1588,7 @@ Defaults: -darkSquareColor #77A26D -highlightSquareColor #FFFF00 -premoveHighlightColor #FF0000 + -lowTimeWarningColor #FF0000
On a grayscale monitor you might prefer:
@@ -1578,11 +1598,19 @@ Defaults:
-darkSquareColor gray60
-highlightSquareColor gray100
-premoveHighlightColor gray70
+ -lowTimeWarningColor gray70
-
-firstScoreAbs
and -secondScoreAbs
if needed.
-Default: 0 (no adjudiction)
-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 (offboard
-interposition on mate), losers, suicide, giveaway, atomic, and 3check
-are not fully understood.
+kriegspiel. The winning/drawing conditions in crazyhouse (off-board
+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 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.
-
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
@@ -1807,25 +1844,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 @@ -1995,7 +2032,7 @@ Up: Top
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
@@ -2013,7 +2050,7 @@ Up: Top
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. @@ -2039,7 +2076,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. @@ -2078,38 +2115,23 @@ Up: Top
-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. -
Allessandro 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 wre 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.
@@ -2238,12 +2264,6 @@ directory as cmail keeps its working files (above).
environment variable $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.