updated Changelog, NEWS, etc.
[xboard.git] / NEWS
1 ** Version 4.6.2 **
2    (for a more detailed list with screenshots see http://www.gnu.org/software/xboard/whats_new/4.6.2/ )
3    bugfix relase for 4.6.1
4    * Suppress clear-board message after pasting FEN
5    * Fix faking of castling rights after editing position with holdings
6    * Fix second-engine variant test
7
8 ** Version 4.6.1 **
9    (for a more detailed list with screenshots see http://www.gnu.org/software/xboard/whats_new/4.6.1/ )
10
11    bugfix release for 4.6.0
12
13    * Fix memory corruption bug on second-engine loading (through menu or in tournament),
14      which could destroy -firstInitString
15    * Fix bug loading a new engine through the menu (not loading it with the full game,
16      but just upto the current move)
17    * Prefix engine command with "./" when a pathname is split up during install, so the engine actually runs (XB)
18    * Fix fall-back to -ncp mode when engine does not start (cutting short the feature timeout)
19    * Fix bug in position search for FRC castlings (where a King could 'fall off' the board)
20    * Add a message to inform the user how to clear the board, in sweep-select edit-position mode
21    * Fix a bug that could stop the clock when the board window was dragged (XB)
22    * Fix switching off highlighting during game (so last highlights do not remain for the rest of the game)
23    * Allow user to enter the name of a non-existing file when browsing for a save file (WB)
24    * Make sure rarely used engine-related options (such as -firstNPS) are also correctly loaded during session
25    * Correctly handle parsing of Crazyhouse promotions with legality-testing off
26    * Fix click-click detour under-promotions, which were not working for non-captures
27    * Don't strip path from engine command if directory is explicitly given in Load Engine dialog
28    * Consistently make auxiliary windows top level-shells or not, with new -topLevel option (XB)
29    * No longer fatal if second engine does not support current variant (just refuse Two Machines mode)
30    * Scroll XBoard game list to keep selected item in view (XB)
31    * Suppress spurious error popup when starting observing of bughouse games
32    * Fix vertical axis ticks in eval graph with drop games
33    * Put title on same line as menu bar only for -size 72 and larger (with -titleInWindow, XB)
34    * Properly open and close debug file when switching debug mode through key binding Ctrl-D (XB)
35
36 ** Version 4.6.0 **
37
38    (see http://www.gnu.org/software/xboard/whats_new/4.6.0/ )
39
40    * Engine vs. Engine
41     * Loading and installing engines through the menu
42     * Running tournaments with more than two partipants
43     * Stopping a match between two engines
44     * Replacing a tourney participant
45     * Playing openings in color-reversed pairs
46     * Perpetual chasing in Xiangqi
47
48    * Interface Improvements
49     * Auto-Queen, and still under-promote?
50     * Piece fonts and figurine fonts
51     * Displaying PVs as SAN
52     * Small scores in the Eval Graph
53     * How close is the 50-move draw?
54     * Sign of the engine scores
55
56    * Interactive Analysis
57     * Playing moves from the PV
58     * Rapidly changing the number of PVs
59     * Setting the other side to move in analysis
60     * Annotating a game with an engine
61
62    * Other New Functionality
63     * Searching a position in a PGN file
64     * Editing the opening book
65
66    * XBoard -> WinBoard Convergence
67     * Exporting the game list (XB)
68     * A move type-in box (XB)
69     * New-style Move History window (XB)
70
71 ** Version 4.5.3a **
72
73    (see http://www.gnu.org/software/xboard/whats_new/4.5.3a/ )
74
75   * only changes to Winboard : build non JAW by default, fix compile errors
76
77 ** Version 4.5.3 **
78
79    (see http://www.gnu.org/software/xboard/whats_new/4.5.3/ )
80
81   * fixes of major bugs:
82    * In the file-browse dialog . and .. no longer mask other files if they are non-first in the directory
83    * Fix XBoard crash on showing an empty Engine Settings dialog, printing a message in stead
84    * The XBoard Game List can now handle files with more than 1900 games, by paging through them
85    * The state of the Move-History window is now remembered by XBoard even when the Engine-Output window is up
86    * Fix crash on switching sounds in WinBoard under Windows Vista
87    * Fix empty-string option values on XBoard command line (which were ignored)
88    * Fix spurious vertical scrolling in XBoard Engine-Output window on clicking in it
89    * Obey an engine's san feature when sending book moves to it
90    * Fix XBoard crash when 'filtering' made Game List empty
91    * Suppress clearing of Engine-Output window on automatic updates in analyze mode
92    * Force Move-History refresh after loading/reverting variation
93    * Fix closing brace, when joining two comments to same move
94
95   * fixes of minor bugs:
96    * Suppress playing sounds when no -soundProgram is set
97    * Fix display of last move of last match game
98    * Update window title after last game of match
99    * Never one-click move when legality testing is off
100    * Suppress playing book move when total weigth of all moves is zero
101    * Restore echo after ^C killed XBoard during ICS password
102    * Fix default of -remoteUser, which could cause crash when playing remote engines
103    * Fix recognition of separators between options in -adapterCommand command line
104    * Fix button sizing in generic popup
105    * Fix translatability of 'Spartan Chess' menu item WB
106    * Remove some duplicats from WB language template file
107    * Fix spurious 'Unfinished' sounds during ICS examining
108    * Fix bug in handling of partner command in zippy-mode bughouse games
109    * Create more space in some WB dialogs to accomodate translations
110
111   * Improvements benefitting the speaking version for the visually impaired (WB):
112    * Implement NVDA support in JAWS version
113    * Fix translation of spoken composite messages
114    * Fix JAWS reading of Engine-Settings dialog by removing group-boxes
115    * Add tab stops in WB generic popup
116    * Reorder controls in Engine-Setings dialog WB, so they are tabbed through in logical order
117
118   * fixed compiler warnings/errors and portability:
119    * Fix use of random function in XBoard shuffle dialog callback
120    * Fix inconsistent type of the variable 'shuffleOpenings'
121    * Silence warnings during rpm build
122    * Fix warnings XBoard file browser
123    * Fix some warnings and header-file improvement
124
125   * misc:
126    * Add -at and -opt options as alternative for @, as work-around for Windows shortcut bug
127    * Make occurrence of unknown option in settings file non-fatal
128    * Stale output no longer lingers in the engine-output window when a new game starts
129    * Popdown (stale) Comment window on new game
130
131 ** Version 4.5.2a (Winboard only)**
132
133    (see http://www.gnu.org/software/xboard/whats_new/4.5.2/ )
134
135   * Fix Engine Settings button options in WinBoard
136
137 ** Version 4.5.2  **
138
139    (see http://www.gnu.org/software/xboard/whats_new/4.5.2/ )
140
141   * Main new feature:
142    * Added many option dialogs and reworked some of the old ones
143
144   * bugfixes, packaging and install:
145    * Fix nps bug
146    * Fix flipBlack option XBoard with board texture
147    * Fix two bugs in reading position diagram
148    * Fix parsing bug of FRC castling
149    * Fix bugs in FRC castling rights
150    * Fix display of promotion piece in ICS superchess
151    * Fix path browsing in WinBoard
152    * Fix use of game/position file in first match game
153    * Fix build on Mac OS X
154    * install bitmaps and sounds during "make install"
155    * some minor bug fixes
156    * code cleanup (e.g. 64 bit warnings, removed malloc.h)
157
158 ** Version 4.5.1 **
159
160    (see http://www.gnu.org/software/xboard/whats_new/4.5.1/ )
161
162  * bugfixes:
163    * Revert "Implement -reset option feature in WinBoard"
164    * Fix deselection of greyed-out variant button (WB)
165    * Put warning in HTML help
166    * Fix unmarked translation
167    * Fix Alfil bug
168    * Fix variant janus size prefix
169    * Fix Xiangqi King facing
170    * Fix showing of user move after adjudication
171    * Make language choice from menu persistent
172    * Fix ICS channel 0
173    * Fix some resource leaks
174
175  * fixed packaging issues:
176    * add DIFFSTAT and SHORTLOG to tar-ball
177    * added history.c to the tar-ball. Needed for Winboard
178
179  * fixed compiler warnings/errors:
180    * added missing header file for sprintf
181    * added missing #includes and missing prototypes to filebrowser
182    * Fix MSVC compilability
183    * Fix 64-bit Windows compilability
184    * Fix MSVC snprintf problem
185
186  * fixed configure problems:
187    * fixed configure script to correctly detect Xaw3d library
188    * updated configure.ac to check for Xaw header files
189
190  * misc:
191    * Fix two typos in option names in texi file
192
193
194 ** Version 4.5.0 **
195
196    (see http://www.gnu.org/software/xboard/whats_new/4.5.0/ for more details)
197
198     General
199     -------
200     * User specific settings files
201     * More logical (and standard) menu structure
202     * Translation into other languages (WB)
203     * Walking the PV of an engine
204     * Exploring variations
205     * Playing through PGN variations
206     * Annotating a game with analysis results
207     * Editing Comments
208     * Controlling move choice of the GUI book
209     * Keeping the clock in sync in tournaments
210     * Starting an engine match from the menu
211     * Fixed thinking time per move
212     * Improved multi-PV support
213     * Where your pieces can move to
214     * Editing crazyhouse holdings
215     * Thai Chess (Makruk) and Seirawan Chess
216     * Non-compliant FEN and SAN input
217     * Improved Xiangqi adjudications
218     * Allowing engines to setup a position
219
220     Merging XBoard & WinBoard
221     ------------------------------
222     * Evaluation graph (XB)
223     * Settings file (XB)
224     * Filtering the game list (XB)
225     * Game-List options dialog (XB)
226     * Recalling the ICS input history (XB)
227     * Aribtrary board textures (XB)
228     * Highlight arrow (XB)
229
230     ICS-client Enhancements
231     -----------------------
232     * Maintaining a healty ICS connection
233     * Claiming a draw after your move
234     * ICS seek graph
235     * One-click moving
236     * Observing your bughouse partner
237     * Improved Chat-Box interface (WB)
238     * Uploading games to an ICS
239     * Side-by-side boards
240
241
242 ** Version 4.4.4 **
243
244  * Repair exit-popup deadlock patch
245  * Fix bug in sending "usermove" when forcing book moves
246  * Let move parser return ImpossibleMove for off-board moves
247  * Prevent engine stall on perpetual-chase evasion
248  * Pop down old tags on loadng new game in WinBoard
249  * Fix game end during dragging
250  * Repair animate dragging
251  * Fix bug in sending cores command to engine
252  * Fix parsing of SAN shogi promotions
253  * Fix variant switch on PGN loading
254  * Allow -flipBlack to work with font-based piece rendering
255  * Allow font-based piece rendering in board sizes below petite
256  * Fix WinBoard game-list title
257  * Fix deadlock in match-result display
258  * Fix regression in colorization of zippy-matched commands
259  * Fix zippy handling of draw offers from ICS
260  * Make some more zippy code obey the --disable-zippy flag
261  * Remove unnecessary double equals from configure.ac.
262  * Cut board squares out of texture bitmap more cleverly
263
264 ** Version 4.4.3 **
265
266  * Add variant Makruk
267  * Implement castling for variant CRC
268  * Extensive bugfix of -autoKibitz
269  * Accept <Enter> for changing chat partner
270  * Change opening array -variant fairy
271  * Send continuation lines to chat box they belong to
272  * Use -keepAlive option to determine connection health
273  * Fix of ancient WinBoard bug: check value of int options
274  * Fix bug for incommensurate time odds
275  * Fix piece-to-char table -variant fairy
276  * Fix TwoKings ICS castling-rights bug
277  * Fix reading castling rights FEN in knightmate and twokings
278  * Fix OO-castling in FRC after pasting FEN
279  * Fix bug in display of logos
280  * Fix highlighting bug in XBoard
281  * Match handles with multiple titles for channel Chat Boxes
282  * Make WinBoard makefiles use parser.c in XBoard directory
283  * Added missing sounds files to be able to compile on windows
284  * Added logo files for xboard
285  * Bugfix stale first-click
286  * Fix copying of WB Chat Window contents
287  * Fix XB crash on giving keyboard focus to non-text widget
288  * Bugfix copying from Chat Box, own lines
289  * Fix 'mamer bug' in Chat Boxes
290  * Fix copying of kibitzed lines from WB Engine-Output window
291  * Do not recognize non-ICS variants from PGN event tag
292  * Remake programVersion string after receiving engine features
293  * Set keyboard focus at startup to board window
294  * Fix window-position upset on failing engine start in WinBoard
295  * Allow lower-case promochar in moves of type h8=Q
296  * Small bugfixed for JAWS version
297  * Small bugfixes
298
299 ** Version 4.4.2 **
300
301  * add Winboard source files into tar-ball
302  * remove trailing \r in xboard output
303  * double buffer size to prevent overflow
304  * fix problem with empty string in -firstNeedsNoncompliantFEN
305  * updates makefiles to include dependency on config.h
306  * correctly apply some check boxes from the option menu
307  * score sign in analysis mode
308  * fix for bug #28077: xboard needs to link against x11
309  * fix castling rights when copying FEN to clipboard (again)
310  * fixed some outstanding pixmaps
311  * fix the irritating wandering off of the MoveHistory window in XBoard on opening/closing.
312  * use xtell for talking to handles, but tell for talking into a channel.
313  * fix bug in bughouse drop menu
314  * removing some rather verbose debug messages that seem no longer needed.
315  * fix engine-sync on move-number type-in bug
316  * fix declaration of engineOutputDialogUp
317  * fix double start of zippy engine after switch to gothic
318  * the last move before the time control now gets its time listed in the PGN
319  * fix casting rights after FEN pasting
320  * fix crash on engine crash
321  * fixed build on openbsd
322  * cleaned up some debug messages and typos
323  * removed files that should only be in the windboard directory
324  * added missing library for build on OS X
325
326 ** Version 4.4.1 **
327
328  * added chat windows to keep track of multiple conversations (WinBoard only)
329  * allow the result comment as a display item in the game list
330  * added a "Mute All Sounds" item in the WinBoard Options menu
331  * new -forceIllegalMoves option
332  * new -keepAlive option (for ICS play)
333  * ported -autoDisplayComment and -autoDisplayTags to xboard, controling popups
334  * replaces analysispopup with engineoutputpopup in xboard
335  * allow copy/paste position and game to use clipboard (xboard)
336  * updated several bitmaps (xboard)
337  * Made the beep sounds for JAWS board navigation configurable
338    through command-line options
339  * added the result comment to the game-list tags when the game
340    list is exported to the clipboard
341  * updated RTF docs
342  * fixed premove problem
343  * fixed engine did not start playing when out of GUI book on second
344    move with white
345  * fix bug using opening books (file were not closed)
346  * fixed crash when opening Engine #1 Settings when there were no
347    text-edit options in the dialog
348  * fixed loading of games from command lines, fixes cmail bug
349  * fix joining lines split by ICS and resizing terminal window when using ICS
350    (new option -keepLineBreaksICS, -wrapContinuationSequence, -useInternalWrap)
351  * fixed -autoDisplayComment
352  * fixed wrong default value for engineDebugOutput in xboard
353  * swapped 'tell' and 'message' parsing order for correct colorization.
354  * fixed parse bug for pgn files
355  * fix for edit-position "moves" being sent by XBoard to the engine
356  * bugfix for protocol extensions: egtbpath -> egtpath
357  * fix bug in parser
358  * further bugfixes:  #8847, #10990, #27427, #27642,
359    #27666, #27667, #27668, #27715, #27751, #27760,
360    #27772, #27799, #27826 and several small ones
361  * use "make distcheck" to generate tar-balls
362  * prepared a system to internationalize winboard menus
363  * improved mouse handler
364  * rewrote wevalgraph for better frontend/backend separation
365  * code cleanup
366
367 ** Version 4.4.0 **
368
369 A new release of both XBoard and WinBoard is now available.  Version
370 4.4.0 includes many changes. It is the first major release of
371 xboard/winboard after a fork of the project after version 4.2.7. It
372 includes small changes made in the main line and changes made by a
373 fork of Alessandro Scotti and lots of changes made afterwards by
374 H.G. Muller (released as versions 4.3.x). This release represents a
375 unified version of all changes made after the fork. It includes many
376 new features and bugfixes.
377
378 You can get both XBoard and WinBoard from the Savannah
379 project pages:
380
381 https://savannah.gnu.org/projects/xboard/
382
383 If you find a bug, please report it in the bug tracker at
384 https://savannah.gnu.org/projects/xboard/ or by email to bug-xboard
385 (AT) gnu.org.
386
387
388 ** Version 4.3.16 **
389
390 New command-line options
391 /niceEngines=N       for adjusting the priority of engine processes so they don't soak up all your system resources
392 /firstOptions="..."   Allows the setting of options that engines define through the feature option="..." commands
393 /secondOptions="..."
394 /firstLogo=filename.bmp  Displays the mentioned bitmap next to the clock (with H:W =1:2 aspect ratio) (WB only)
395 /secondLogo=filename.bmp
396 /autoLogo=false          get logo files automatically from engineDirectory\logo.bmp
397
398 General enhancements:
399 * New WB-protocol command: 'feature option="NAME -TYPE VALUE OTHER"', which engines can use to define options
400 * New WB-protocol command: 'option NAME VALUE' used to set value of engine-defned options.
401 * implements /delayAfterQuit and /delayBeforeQuit in XBoard, and uses SIGKILL to terminate rogue engine processes
402
403
404 ** Version 4.3.15 **
405
406 New command-line options
407 /rewindIndex=N (for the new auto-increment mode of the loadGameIndex or loadPositionIndex in match mode)
408 /sameColorGames=N (for playing a match where the same player has white all the time)
409 /egtFormats="..." (for specifying where various end-game tables are installed on the computer)
410
411 New menu items
412 + Time-odds factors can be set in the time-control dialog
413 + Nr of CPUs for SMP engines can be set in the Options -> UCI dialog
414 + Own-Book options can be switched from the Options -> UCI dialog
415 + The ScoreIsAbs options can be set from the Options -> Engine dialog
416 + New-Variant menu adds Superchess
417
418 General Enhancements:
419 * WinBoard engines can now also use the Polyglot opening book (implemented as general GUI book)
420 * New WB-protocol commands memory, cores and egtpath make interactive setting of these parameters
421   possible on WB engines
422 * New Polyglot is available that relays the interactive setting of these parameters to UCI engines
423 * Match mode suports an auto-increment mode, so that all games or positions from a file can be played
424 * Draw claims with Kings and an arbitrary number of like Bishops (e.g. KBBKB) are accepted
425
426 The source tree in original xboard 4.2.7 format can now be compiled under Cygwin with the aid
427 of the cygwin.mak file in the ~/winboard/ subdirectory of the source releasy, after you put
428 the hep-file from an executabl distribution there. Maefiles for other compilers are not updated
429 since 4.2.7, as I do not have those compilers.
430
431
432 ** Version 4.3.14 **
433
434 This relaese was not made by the GNU xboard team, but by H.G.Muller.
435 It mainly contains developments on WinBoard. Nevertheless, an attempt
436 has been started to back-port the enormous number of improvements that
437 have been made to WinBoard since the Linux and Windows developments branched
438 to xboard. This is reflected by the source tree now having the same format
439 as that of xboard 4.2.7, including all the xboard sources.
440
441 An enormous amount of work still has to be done to make the xboard version
442 fully equivalent to WinBoard, especially on user-interface side. As a modest
443 beginning, the xboard source files have been patched to allow their compilation
444 with the newer back-end files from WinBoard. To this end, the number of piece
445 types in xboard has been increased from 6 to 22, and the WinBoard bitmaps
446 have been converted to xboard source format (.bm) and are included in the
447 xboard bitmaps directory. Other quick patches include the coloring of the
448 board squares (for xiangqi and holdings), and some code in the user-move
449 handling to suppress all moves into or out of the area between board and
450 holdings in crazyhouse, and the treatment of king-captures-own-piece
451 as a possibly valid move (for FRC castling). This should make it possible
452 to run xboard with the new back-end files without too much inconvenience.
453
454 New xboard command-line options have been added to make the added back-end
455 features available. The include the new variants (as argument of the old
456 -variant option), -boardWidth, -boardHeight and -holdingsSize. Be sure
457 to call xboard with "-boardSize middling" or "-boardSize bulky" if you
458 want to play with fairy pieces, or xboard might crash due to unavailability
459 of bitmaps. Other added xboard options are:
460
461 ADJUDICATION OPTIONS:
462 -checkMates
463 -testClaims
464 -materialDraws
465 -trivialDraws
466 -ruleMoves
467 -repeatsToDraw
468 -adjudicateLossThreshold
469 -firstScoreAbsolute
470 -secondScoreAbsolute
471
472 TIME-CONTROL OPTIONS
473 -firstTimeOdds
474 -secondTimeOdds
475 -timeOddsMode
476 -firstNPS
477 -secondNPS
478
479 GENERAL OPTIONS
480 -matchPause
481 -engineDebugOutput
482 -userName
483 -pgnExtendedInfo
484 -pgnEventHeader
485 -hideThinkingFromHuman
486
487 This is all completely untested, but as the options merely switch on well-tested
488 code in the back-end, there should not be too many problems with them.
489 Bugs can be reported in the WinBoard forum.
490
491
492 ** Version 4.3.14k **
493
494 Compared to version 4.3.13 described below, this version features
495
496 New command-line options:
497 /autoKibitz (for relaying the PV info of the engine to the ICS)
498 /userName="..." (for setting the name of the Human player, also as menu)
499 /engineDebugOutput=N (controlling the writing of engine output to debug file)
500 /firstNPS=N (for time management by node count or CPU time)
501 /secondNPS=N (likewise for the other engine)
502
503 New Menu items
504 + Enter Username (same as /userName command-line option)
505 + Save Diagram (for saving the Chessboard display as bitmap file)
506 + Machine Both (not implemented yet, but menu item already provided)
507 + New-Variant menu adds CRC, Janus and Berolina (the latter only with legality testing off!)
508 + Any variant can be played from a shuffled opening setup
509
510 Bugfixes:
511 * Problems with switching the variant in ICS zippy mode solved
512 * In ICS observing mode game history is now fully accessible
513 * Moves are not fed to engine in zippy mode, when observing a game from a variant unknown to the engine
514 * a problem with loading PGN of FRC games with move disambiguation and initial castling rights was fixed.
515 * A bug in the clock display that made previous versions of WinBoard crash for tiny displays is fixed
516
517 General enhancements:
518 * variant name displayed in title bar in ICS mode, when not 'normal'
519 * when receiving a challenge in ICS zippy mode, it is checked if the engine supports the variant (/zippyVariants="..." can still be used to limit the allowed variants, and for protocol-1 engines is still the only thing to go on)
520 * when loading a game from a PGN file, WB automatically switches to the variant specified in the PGN tags
521 * when starting from a loaded position (using /loadPositionFile), this position will be used on subsequent 'New Game' commands as well (until we switch variant)
522
523 New is also that the source tree is now brought back in the original WinBoard 4.2.7 format, including
524 xboard source files. Note, however, that the xboard sources are from an older date, and I did not test
525 if they still compile together with the much newer backend sources. I did add code in xboard.c to recognize
526 the new command-line options I added since then, and in so far they are back-end options that should be enough
527 to make them work. This is completely untested, though; I did not even try to compile it. Last time anyone
528 built a working xboard.exe from this was at a stage where WinBoard did have adjustable board size, allowing
529 it to play Xiangqi. But no crazyhouse holdings yet.
530
531
532 ** Version 4.3.13a **
533
534 This version of WinBoard_F fixes several bugs in 4.3.12, and also addse a few new features.
535 The new features include:
536 - some more fairy pieces, so that each side now has 22 piece types in stead of 17,
537 making most fairy pieces available in board size "petite" (next to "bulky" and "middling"),
538 making the ArchBishop and Chancellor, as well as one wildcard piece (the Lance) available in all
539 sizes from "petite" to "bulky".
540 - The FRC support is fully fixed, both in local and ICS mode.
541 - A mechanism is provided for safe draw claiming in cases where a 3-fold repetition woud occur only
542   after your own move. In this case a draw will be awarded by WinBoard if the engine sends "offer draw"
543   before making its move.
544 - Genuine draw offers are not passed on immediately to the opponent but held up to when the offerer announces
545   its move.
546 - Variants FRC, Cylinder and Falcon are added to the "New Variant..." menu.
547 - Support for playing time-odds games is added. (Options /firstTimeOdds, /secondTimeOdds, /timeOddsMode)
548 - A mechanism is provided for attaching WinBoard options to the engine command, to create options that
549 follow the engine (e.g. time odds) in a tournament run under a tournament manager.
550 Bugfixes include:
551 - Shatranj in ICS mode (did not work at all before)
552 - Some draw adjudications (QRKR was mistaken for KRKR, and KBKB with like Bishops is now recognized)
553 - time info in the PGN is now correct
554
555 ** Winboard_F.4.3.12 release notes
556
557 This WinBoard (beta-)version is derived from Allessandro Scotti's
558 Winboard_x, and supports the following new options, mainly in the area
559 of adjudication of engine-engine games, improved Crazyhouse support,
560 and allowing variants with non-conventional pieces and or board
561 sizes. (All option are shown here with their default values):
562
563 /variant=normal
564 This (already existing) option has been expanded with
565 several new variants, involving non-conventional pieces and deviating
566 board sizes. The board size is automatically adapted to the selected
567 variant, unless explicitly overruled (see below). The new variants are
568 (with default board size, files x ranks, in parentheses):
569
570 variant name    Game           board     description
571 knightmate    Knightmate        (8x8)  Variant where the King moves as a Knight, and vice versa
572 capablanca    Capablanca Chess (10x8)  Variant featuring Archbishop and Chancellor as new pieces
573 gothic        Gothic Chess     (10x8)  Same as Capablanca, with a more interesting opening position
574 courier       Courier Chess    (12x8)  a Medieval form that combines elements of Shatranj and modern Chess
575 shogi         Shogi             (9x9)  Japanese Chess
576 xiangqi       Xiangqi          (9x10)  Chinese Chess
577 fairy         Fairy Chess       (8x8)  Variant were you can use all pieces of other variants together
578
579 The variant can be set from the newly added "File -> New Variant..."
580 sub-menu.  Extra board files are indicated by the letters i, j, k, l,
581 ... For boards with more than 9 ranks, the counting starts at zero!
582 More than 10 ranks is not tested and unlikely to work in the area of
583 PGN saving / reading. Non-FIDE pieces will be referred to in FENs and
584 PGN by letters that depend on the variant, and might collide with
585 piece designators in other variants. E.g. in Xiangqi 'C' is a Cannon,
586 in Capablanca Chess it is a Chancellor. Pieces that do not belong in a
587 variant cannot be addressed in FEN and PGN either, for as long as that
588 variant is selected, unless the letter assignment is overruled with
589 the aid of the /pieceToCharTable option. The variant is not saved in
590 the winboard.ini file; on start-up we always get variant "normal"
591 unless we use the command-line option, or have added the option to the
592 winboard.ini file manually (in which case it will disappear when this
593 file is overwritten by WinBoard saving its options).  WinBoard_F knows
594 the movement of all pieces occurring in Capablanca Chess (of which
595 FIDE Chess is a subset), Shatranj, Courier, Xiangqi and 9x9 Shogi, so
596 that these games can be played with legality testing enabled.
597
598 /pieceToCharTable="PNBRQFWEMOUHACGSKpnbrqfwemouhacgsk"
599 Each piece that WinBoard knows (in its legality test) has a letter
600 associated with it, by which it will be referred to in FEN or PGN. The
601 default assignment can be overruled with this option. The value has to
602 be a string of even length, with at least 12 characters. The first
603 half of the string designates the white pieces, the second half the
604 black.  The last letter for each color will be assigned to the
605 King. (This is the piece that moves as an orthodox King; note that
606 Nightmate and Xiangqi have a different royal piece.) All letters
607 before it will be assigned to the other pieces in the order:
608
609 P Pawn                 (move often depends on variant)
610 N Knight               (move subtly different in Xiangqi (where it is written as H) or Shogi)
611 B Bishop
612 R Rook
613 Q Queen                (Lance L in Shogi)
614 F Ferz/General         (The Shatranj 'Queen' and Xiangqi 'Adviser', used for Silver General S in Shogi.)
615 W Wazir/GrandVizer     (Gold General G in Shogi, in Xiangqi it is royal and denoted by K)
616 E Alfil/Elephant       (Moves subtly different in Xiangqi vs Shatranj/Courier)
617 M Commoner/Man
618 O Cannon/Pao
619 U Unicorn              (representation of Royal Knight in Knightmate, used as promoted Pawn in Shogi)
620 H Nightrider           (Promoted Knight in Shogi and CrazyHouse)
621 A Archbishop/Cardinal  (Promoted Bishop in Shogi and CrazyHouse)
622 C Chancellor/Marshall  (Promoted Rook   in Shogi and CrazyHouse)
623 G Grasshopper          (Promoted Queen in Crazyhouse, promoted Lance in Shogi)
624 S                      (Promoted Silver in Shogi)
625 K King
626
627 Pieces that are not mentioned (because the argument has less than 34
628 characters) will remain disabled. Mentioned pieces can be disabled by
629 assigning them a '.' (period). They are then not recognized in FEN or
630 PGN input. Non-FIDE pieces that are not assigned a letter will also
631 not appear on the promotion menu. It is not advisable to disable a
632 piece that is present in the opening position of the selected variant,
633 though.
634 Promoted pieces that need to be distinguished from original pieces of
635 the same type (because of demotion on capture and transfer to the
636 holdings) will be indicated by the letter for the unpromoted piece
637 with a '+' in front of it (Shogi), or by the letter of the promoted
638 piece with a '~' after it (Crazyhouse, Bughouse, in general everything
639 with holdings that is not Shogi). To achieve this, they should be
640 assigned the characters '+' or '~', respectively.
641 All the new pieces have a native bitmap representation in the board
642 sizes 'bulky' and 'middling'. For all window sizes that do not support
643 such fairy bitmaps, promoted NBRQ are represented as a 2-sizes-smaller
644 normal piece symbol, so that Crazyhouse can be played at any
645 size. People disliking the fairy representations might even prefer
646 this.
647 There is an enhanced 'Edit Position' menu popup (right-clicking on the
648 squares after selecting this mode in the main menu), featuring some
649 common non-FIDE pieces, and 'promote' and 'demote' options to make
650 those not directly in the menu. The promotion popup shows ArchBishop
651 and Chancellor in Capablanca and Gothic, (or in fact in any game where
652 this piece is not disabled or a promoted version of a normal piece),
653 and leaves only the options YES / NO in Shogi. In Xiangqi there are no
654 promotions.
655
656 /fontPieceToCharTable="PNBRQFWEMOUHACGSKpnbrqfwemouhacgsk"
657 This option is similar to /pieceToCharTable, but sets the font
658 character that is used to display the piece on the screen (when
659 font-based rendering is in use), rather than in the FEN or PGN. The
660 default setting should work with George Tsavdaris' WinboardF font,
661 which uses the 'intuitive' mapping of font characters to symbols. With
662 font-based rendering the fairy pieces can be used at any board size.
663 Note that UHACGS are also used to represent the promoted versions of
664 PNBRQF, in games like Crazyhouse and Shogi, where the promotion has to
665 be undone on capture. In such games you are likely to prefer a
666 different representation of those pieces then when they represent true
667 fairy pieces.
668
669 /flipBlack=FALSE
670 Traditional Shogi bitmaps are only included for size "moderate". For
671 other sizes you must depend on font-based rendering.
672
673 /detectMate=TRUE
674 /testClaim=TRUE
675 /materialDraws=TRUE
676 /trivialDraws=FALSE
677 /ruleMoves=51
678 /repeatsToDraw=6
679 The option /materialDraws=TRUE causes games with insufficient mating
680 material to be adjudicated immediately as draws, in case the engines
681 would not claim these draws. This applies to KK, KNK and KBK.  The
682 option /trivialDraws adjudicates KNNK, KBKB, KNKN, KBKN, KRKR and KQKQ
683 to draws after 3 moves (to allow for a quick tactical win). Note that
684 in KQKQ this might not be sound, but that problem would disappear once
685 bitbase probing is implemented.
686
687 Clocks
688 The flag-fell condition is now indicated as '(!)' behind the displayed
689 time, to eliminate the necessity for overwriting the message in the
690 title bar (which might contain indispensible information in match
691 mode).
692
693 Other improvements / changes
694 Castling rights and e.p. rights are now fully maintained, and
695 considered in legality testing. They are imported from and written to
696 FEN, as is the 50-move counter. (When reading an incomplete FEN they
697 are still guessed, though.)  The time (in sec, or min:sec) is now
698 always stored together with the PV information to the PGN, if storing
699 the latter was requested (through ticking "extended PGN info" in
700 "Options -> General..."). The saved time is the WinBoard clock time
701 (as opposed to the time reported by the engine).
702
703 ** Winboard_F.4.3.8 release notes
704
705 This Winboard supports the following new options (shown here with their default values):
706
707 /variant=normal
708 This (already existing) option has been expanded with several new
709 variants, involving non-conventional pieces and deviating board
710 sizes. The board size is automatically adapted to the selected
711 variant, unless explicitly overruled (see below). The new variants are
712 (with default board size, files x ranks, in parentheses):
713
714 variant name    Game           board     description
715 knightmate    Knightmate        (8x8)  Variant where the King moves as a Knight, and vice versa
716 capablanca    Capablanca Chess (10x8)  Variant featuring Archbishop and Chancellor as new pieces
717 gothic        Gothic Chess     (10x8)  Same as Capablanca, with a more interesting opening position
718 courier       Courier Chess    (12x8)  a Medieval form that combines elements of Shatranj and modern Chess
719 shogi         Shogi             (9x9)  Japanese Chess
720 xiangqi       Xiangqi          (9x10)  Chinese Chess
721 fairy         Fairy Chess       (8x8)  Variant were you can use all pieces of other variants together
722
723 The variant can be set from the newly added "File -> New Variant..." sub-menu.
724 Extra board files are indicated by the letters i, j, k, l, ... For
725 boards with more than 9 ranks, the counting starts at zero! Non-FIDE
726 pieces will be referred to in FENs and PGN by letters that depend on
727 the variant, and might collide with piece designators in other
728 variants. E.g. in Xiangqi 'C' is a Cannon, in Capablanca Chess it is a
729 Chancellor. Pieces that do not belong in a variant cannot be addressed
730 in FEN and PGN either as long as that variant is selected, unless the
731 letter assignment is overruled by the /pieceToCharTable option. The
732 variant is not saved in the winboard.ini file; on start-up we always
733 get variant "normal" unless we use the command-line opton, or have
734 added the option to the winboard.ini file manually (in which case it
735 will disappear when this file is overwritten).  WinBoard_F knows the
736 movement of all pieces occurring in Capablanca Chess (of which FIDE
737 Chess is a subset), Shatranj, Courier, Xiangqi and 9x9 Shogi, so that
738 these games can be played with legality testing enabled.
739
740 /pieceToCharTable="PNBRQFWEMOUHACGSKpnbrqfwemouhacgsk"
741 Each piece that WinBoard knows (in its legality test) has a letter
742 associated with it, by which it will be referred to in FEN or PGN. The
743 default assignment can be overruled with this option. The value has to
744 be a string of even length, with at least 12 characters. The first
745 half of the string designates the white pieces, the second half the
746 black.  The last letter for each color will be assigned to the
747 King. (This is the piece that moves as an orthodox King; note that
748 Nightmate and Xiangqi have a different royal piece.) All letters
749 before it will be assigned to the other pieces in the order:
750
751 P Pawn                 (move often depends on variant)
752 N Knight               (move subtly different in Xiangqi (where it is written as H) or Shogi)
753 B Bishop
754 R Rook
755 Q Queen                (Lance L in Shogi)
756 F Ferz/General         (Silver General S in Shogi)
757 W Wazir/GrandVizer     (Gold General G in Shogi, in Xiangqi it is royal and denoted by K)
758 E Alfil/Elephant       (Moves subtly different in Xiangqi vs Shatranj/Courier)
759 M Commoner/Man
760 O Cannon/Pao
761 U Unicorn              (representation of Royal Knight in Knightmate, used as promoted Pawn in Shogi)
762 H Nightrider           (Promoted Knight in Shogi and CrazyHouse)
763 A Archbishop/Cardinal  (Promoted Bishop in Shogi and CrazyHouse)
764 C Chancellor/Marshall  (Promoted Rook   in Shogi and CrazyHouse)
765 G Grasshopper          (Promoted Queen in Crazyhouse, promoted Lance in Shogi)
766 S                      (Promoted Silver in Shogi)
767 K King
768
769 Pieces that are not mentioned (because the argument has less than 34
770 characters) will remain disabled. Mentioned pieces can be disabled by
771 assigning them a '.' (period). They are then not recognized in FEN or
772 PGN input. It is not advisable to disable a piece that is present in
773 the opening position of the selected variant, though.
774 Promoted pieces that need to be distinguished from original pieces of
775 the same type (because of demotion on capture and transfer to the
776 holdings) will be indicated by the letter for the unpromoted piece
777 with a '+' in front of it (Shogi), or by the letter of the promoted
778 piece with a '~' after it (Crazyhouse, Bughouse, in general everything
779 with holdings that is not Shogi).
780 All the new pieces have a native biytmap representation in the board
781 sizes 'bulky' and 'middling'. For all window sizes that do not support
782 such fairy bitmaps, promoted NBRQ are represented as a 2-sizes-smaller
783 normal piece symbol, so that Crazyhouse can be played at any
784 size. People disliking the fairy representations might even prefer
785 that.
786 There is an enhanced 'Edit Position' menu popup (right-clicking on the
787 squares after selecting this mode in the main menu), featuring some
788 common non-FIDE pieces, and 'promote' and 'demote' options to make
789 those not directly in the menu. The promotion popup shows ArchBishop
790 and Chancellor in Capablanca and Gothic, (or in fact in any game where
791 this piece is not disabled), and leaves only the options YES / NO in
792 Shogi. In Xiangqi there are no promotions.
793
794 /alphaRank=FALSE
795 This option does not seem to work for reading PGN files. Saving works
796 fine. For now, using it is not recommended. In the future it might be
797 redefined as only affecting engine-engine communication, .
798
799 /flipBlack=FALSE
800 Setting this option will cause upside-down display of the native piece
801 bitmaps used to represent the pieces of the side that plays black, as
802 would be needed for a traditional representation of Shogi pieces. It
803 can be set from the "Options -> Board..." sub-menu, and it is saved in
804 the winboard.ini file. For now, traditional Shogi bitmaps are not
805 included, though.
806
807 Other improvements / changes
808 Castling rights and e.p. rights are now fully maintained, and
809 considered in legality testing. They are imported from and written to
810 FEN, as is the 50-move counter. The time (in sec, or min:sec) is now
811 always stored together with the PV information to the PGN, if storing
812 the latter was requested (through ticking 'extended PGN info' in
813 "Options -> General..."). The saved time is the Winboard clock time
814 (as opposed to the time reported by the engine).
815
816 ** Winboard_F.4.3.7 release notes
817
818 This Winboard supports the following new options (shown here with
819 their default values):
820
821 /variant=normal
822 This (already existing) option has been expanded with several new
823 variants, involving non-conventional pieces and deviating board
824 sizes. The board size is automatically adapted to the selected
825 variant, unless explicitly overruled (see below). The new variants are
826 (with default board size, files x ranks, in parentheses):
827
828 variant name    Game           board     description
829 knightmate    Knightmate        (8x8)  Variant where the King moves as a Knight, and vice versa
830 capablanca    Capablanca Chess (10x8)  Variant featuring Archbishop and Chancellor as new pieces
831 gothic        Gothic Chess     (10x8)  Same as Capablanca, with a more interesting opening position
832 courier       Courier Chess    (12x8)  a Medieval form that combines elements of Shatranj and modern Chess
833 shogi         Shogi             (9x9)  Japanese Chess
834 xiangqi       Xiangqi          (9x10)  Chinese Chess
835 fairy         Fairy Chess       (8x8)  Variant were you can use all pieces of other variants together
836
837 The variant can be set from the newly added "File -> New Variant..." sub-menu.
838 Extra board files are indicated by the letters i, j, k, l, ... For
839 boards with more than 9 ranks, the counting starts at zero! Non-FIDE
840 pieces will be referred to in FENs and PGN by letters that depend on
841 the variant, and might collide with piece designators in other
842 variants. E.g. in Xiangqi 'C' is a Cannon, in Capablanca Chess it is a
843 Chancellor. Pieces that do not belong in a variant cannot be addressed
844 in FEN and PGN either as long as that variant is selected, unless the
845 letter assignment is overruled by the /pieceToCharTable option. The
846 variant is not saved in the winboard.ini file; on start-up we always
847 get variant "normal" unless we use the command-line opton, or have
848 added the option to the winboard.ini file manually (in which case it
849 will disappear when this file is overwritten).  WinBoard_F knows the
850 movement of all pieces occurring in Capablanca Chess (of which FIDE
851 Chess is a subset), Shatranj, Courier, Xiangqi and 9x9 Shogi, so that
852 these games can be played with legality testing enabled.
853
854 /pieceToCharTable="PNBRQFWEMOUHACGSKpnbrqfwemouhacgsk"
855 Each piece that WinBoard knows (in its legality test) has a letter
856 associated with it, by which it will be referred to in FEN or PGN. The
857 default assignment can be overruled with this option. The value has to
858 be a string of even length, with at least 12 characters. The first
859 half of the string designates the white pieces, the second half the
860 black.  The last letter for each color will be assigned to the
861 King. (This is the piece that moves as an orthodox King; note that
862 Nightmate and Xiangqi have a different royal piece.) All letters
863 before it will be assigned to the other pieces in the order:
864
865 P Pawn                 (move often depends on variant)
866 N Knight               (move subtly different in Xiangqi (where it is written as H) or Shogi)
867 B Bishop
868 R Rook
869 Q Queen                (Lance L in Shogi)
870 F Ferz/General         (Silver General S in Shogi)
871 W Wazir/GrandVizer     (Gold General G in Shogi, in Xiangqi it is royal and denoted by K)
872 E Alfil/Elephant       (Moves subtly different in Xiangqi vs Shatranj/Courier)
873 M Commoner/Man
874 O Cannon/Pao
875 U Unicorn              (representation of Royal Knight in Knightmate, used as promoted Pawn in Shogi)
876 H Nightrider           (Promoted Knight in Shogi and CrazyHouse)
877 A Archbishop/Cardinal  (Promoted Bishop in Shogi and CrazyHouse)
878 C Chancellor/Marshall  (Promoted Rook   in Shogi and CrazyHouse)
879 G Grasshopper          (Promoted Queen in Crazyhouse, promoted Lance in Shogi)
880 S                      (Promoted Silver in Shogi)
881 K King
882
883 Pieces that are not mentioned (because the argument has less than 34
884 characters) will remain disabled. Mentioned pieces can be disabled by
885 assigning them a '.' (period). They are then not recognized in FEN or
886 PGN input. It is not advisable to disable a piece that is present in
887 the opening position of the selected variant, though.
888 Promoted pieces that need to be distinguished from original pieces of
889 the same type (because of demotion on capture and transfer to the
890 holdings) will be indicated by the letter for the unpromoted piece
891 with a '+' in front of it (Shogi), or by the letter of the promoted
892 piece with a '~' after it (Crazyhouse, Bughouse, in general everything
893 with holdings that is not Shogi).
894 All the new pieces have a native biytmap representation in the board
895 sizes 'bulky' and 'middling'. For all window sizes that do not support
896 such fairy bitmaps, promoted NBRQ are represented as a 2-sizes-smaller
897 normal piece symbol, so that Crazyhouse can be played at any
898 size. People disliking the fairy representations might even prefer
899 that.
900 There is an enhanced 'Edit Position' menu popup (right-clicking on the
901 squares after selecting this mode in the main menu), featuring some
902 common non-FIDE pieces, and 'promote' and 'demote' options to make
903 those not directly in the menu. The promotion popup shows ArchBishop
904 and Chancellor in Capablanca and Gothic, (or in fact in any game where
905 this piece is not disabled), and leaves only the options YES / NO in
906 Shogi. In Xiangqi there are no promotions.
907
908 /fontPieceToCharTable="PNBRQFWEMOUHACGSKpnbrqfwemouhacgsk"
909 This option is similar to /pieceToCharTable, but sets the font
910 character that is used to display the piece on the screen (when
911 font-based rendering is in use), rather than in the FEN or PGN. The
912 default setting should work with the WinboardF font, which uses the
913 'intuitive' mapping of font characters to symbols.  Note that UHACGS
914 are also used to represent the promoted versions of PNBRQF, in games
915 like Crazyhouse and Shogi, where the promotion has to be undone on
916 capture.
917
918 /boardWidth=-1 /boardHeight=-1
919 Set a number of files and ranks of the playing board to a value that
920 will override the defaults for the variant that is selected. A value
921 of -1 means the variant default board size will be used for the
922 corresponding parameter (and is itself the default value of these
923 options). These parameters can be set in the "Files -> New Variant..."
924 sub-menu, where they are reset to the default -1 is you OK the chosen
925 variant without typing something to overrule it. These parameters are
926 saved in the winboard.ini file. (But unless you saved while a variant
927 with board-size override was selected, they will always be saved as
928 -1.)
929 A variant with a non-standard board size will be communicated to the
930 engine(s) with the board size prefixed to the variant name,
931 e.g. "variant 12x8_capablanca". In protocol 2 the engine must first
932 enable this feature by sending "boardsizeFxR" amongst the accepted
933 variants, where F is the maximum number of files, and R the maximum
934 number of ranks, as decimal numbers.
935
936 /holdingsSize=-1
937 Set the size of the holdings for dropable pieces to a value that will
938 override the default for the variant that is selected. A value of -1
939 means the variant default holdings size will be used for that
940 parameter (and is itself the default value of this options). This
941 parameter can be set in the Files -> New Variant... sub-menu, where it
942 is reset to the default -1 is you OK the chosen variant without typing
943 something to overrule it. This parameters is saved in the winboard.ini
944 file.  To disable holdings, set their size to 0. They will then not be
945 displayed. For non-zero holding size N, the holdings are displayed
946 left and right of the board, and piece drops can be effected by
947 dragging pieces from the holdings to the drop square. In bughouse, the
948 holdings will be filled by the ICS. In all other variants, captured
949 pieces will go into the holdings (after reversing their color). Only
950 the first N pieces of the /pieceToCharTable argument will go into the
951 holdings. All other pieces will be converted to Pawns. (In Shogi,
952 however they will be demoted in the regular way before determining if
953 they fit.) Pieces that are disabled (per default and per
954 /pieceToCharTable option) might not be counted when determining what
955 are the first N pieces.  Non-standard holdingsize will be communicated
956 to the engine by prefixing it (together with the board size, even if
957 this is standard) to the variant name, e.g. "variant 7x7+5_shogi". In
958 protocol 2 the engine should enable this feature by sending
959 "holdingsH" amongst the variant names, where H is the maximum
960 acceptable holdings size as a decimal number.
961
962 /alphaRank=FALSE
963 When this parameter is true, a-h are converted to 1-9, and vice versa,
964 in all move output and input (to PGN files or SAN move display as well
965 as in communication with the engine). This might be useful for Shogi,
966 where conventionally one uses letters to designate ranks, and digits
967 to designate files. Engines that want to use this option must make
968 sure pieces are never represented by lower case! This option can be
969 set from the Files -> New Variant... menu, where it defaults to FALSE
970 unless you explicitly set it. It is not saved in the winboard.ini
971 file.  Note that the PGN format in Shogi also leaves out the trailing
972 '+' as check indicator: In Shogi such a trailing '+' means promotion,
973 while a trailing '=' means defer promotion. Prefix '+' signs are used
974 on moves with promoted pieces, disambiguation is done western SAN
975 style.
976
977 /allWhite=FALSE
978 Causes the outline of the 'white' pieces to be superimposed onto the
979 'black' piece symbols as well (as a black outline) when native bitmaps
980 are used (as opposed to font-based rendering). This is useful if we
981 choose a very light color to represent the 'black' pieces. It might be
982 particularly useful in Shogi, where the conventional representation of
983 the 'black' pieces is as upside-down white pieces, so that both colors
984 would be white. This option is saved in the winboard.ini file, and can
985 be set in the "Options -> Board..." sub-menu.
986
987 /flipBlack=FALSE
988 This option is reserved for future use. It will cause upside-down
989 display of the 'black' native piece bitmaps, as would be needed for
990 Shogi. For now it can be set from the "Options -> Board..." sub-menu,
991 and it is saved in the winboard.ini file, but it is ignored.
992
993 /detectMate=TRUE
994 /testClaim=TRUE
995 /materialDraws=TRUE
996 /trivialDraws=FALSE
997 /ruleMoves=51
998 /repeatsToDraw=6
999 These are all options that only affect engine-engine play, and can be
1000 set from the "Options -> Engine..." sub-menu. They are all related to
1001 adjudication of games by the GUI. Legality checking must be switched
1002 on for them to work.  If /detectMate is TRUE, the GUI recognizes
1003 checkmate and stalemate (but not in games with holdings!), and ends
1004 the game accordingly before the engines can claim. This is convenient
1005 for play with engines that fail to claim, and just exit.  With
1006 /testClaim set, all result and illegal-move claims by engines that
1007 claim more than their own loss are scrutinized for validity, and false
1008 claims result in forfeit of the game. Useful with buggy engines.  The
1009 option /materialDraws=TRUE causes games with insufficient mating
1010 material to be adjudicated immediately as draws, in case the engines
1011 would not claim them.  The option /trivialDraws adjudicates KNNK,
1012 KBKB, KNKN, KBKN, KRKR and KQKQ to draws after 3 moves (to allow for a
1013 quick tactical win. Note that in KQKQ this might not be sound, but
1014 that problem would disappear once bitbase probing is added).  The
1015 /ruleMoves determine after how many reversible moves the game is
1016 adjudicated as a draw. Setting this to 0 turns this option off. Draw
1017 claims by the engine are still accepted (by /testClaim) after 50
1018 reversible moves, even if /ruleMoves species a larger number. Note
1019 that it is perfectly legal according to FIDE rules to play on after 50
1020 reversible moves, but in tournaments having two engines that want to
1021 play on forever is a nuisance in endings like KBNKR, where one of the
1022 engines thinks it is ahead and can avoids repeats virtually forever.
1023 The option /repeatsToDraw makes the GUI adjudicate a game as draw
1024 after the same position has occurred the specified number of times. If
1025 it is set to a value > 3, engines can still claim the draw after
1026 3-fold repeat.  All these options are saved in the winboard.ini file.
1027
1028 Clocks
1029 There is an "Options -> flip Clocks" command, that swaps the position
1030 of white and black clocks (convenient in over-the-board matches, where
1031 the screen is next to the board, and you want your own time to be
1032 displayed on your side of the screen). The clocks can be adjusted in
1033 "edit game" mode: right-clicking them adds one minute, left-clicking
1034 subtracts one minute. (Also for OTB matches, to keep them synchronized
1035 with the official match clock.) The flag-fell condition is now
1036 indicated as (!) behind the time.
1037
1038 Other improvements
1039 Castling rights and e.p. rights are now fully maintained, and
1040 considered in legality testing. They are imported from and written to
1041 FEN, as is the 50-move counter.
1042
1043 ** Winboard_F 4.3.2
1044
1045 These are the release notes of Winboard_F 4.3.2, which is released
1046 under the GPL.  This version was derived from Allessandro Scotti's
1047 Winboard_x 4.2.7 source files.  It only includes the files that were
1048 changed:
1049
1050 config.h
1051 common.h
1052 parser.h
1053 moves.h
1054 resource.h
1055
1056 winboard.c
1057 backend.c
1058 moves.c
1059
1060 parser.l
1061 winboard.rc
1062
1063 and some bitmaps for piece symbols
1064
1065 I made modifications in the following areas:
1066
1067 1) Adjudication and claim verification
1068 2) Fairy pieces and board sizes other than 8x8
1069 3) Miscellaneous
1070
1071 Miscellaneous
1072
1073 /matchPause=10000
1074 is an option to set the length of the pause between two games of a
1075 match. The value is in msec, default value is 10000 (I will present
1076 all newly implemented options with their default value as example). Be
1077 aware that some engines might not be stopped yet if you make the pause
1078 too small, but might still be puking output, which then will interfere
1079 with the next game. But the fixed value of 10 sec of the old Winboard
1080 seemed like overdoing it.
1081
1082 Time info in PGN
1083 When you ask for the PV-info to be stored in the PGN (a Winboard_x
1084 option), it now also stores the time spent on the move with it.
1085
1086 Flag fell
1087 In engine-engine games the messge "white/black/both" flag(s) fell" no
1088 longer appears in the window caption, but as an exclamation point
1089 behind the clock time. (To prevent the annoying overwriting of the
1090 normal header line).
1091
1092 Adjudications and Claim verification.
1093
1094 These functions are only present in engine-engine games, and only if
1095 legality-testing is switched on. (The latter will be typically
1096 switched off in games with bizarre rules, which the GUI doesn't know,
1097 and in that case the GUI can never have an opinion on the outcome of a
1098 game.)
1099
1100 Illegal-move forfeit
1101 As soon as one of the engines plays an illegal move, it forfeits the
1102 game. This feature was already present, but it should be 100% reliable
1103 now, as it also takes e.p. and castling rights into account, rather
1104 than erring on the safe side.
1105
1106 Illegal-move claim
1107 From the above, it follows that any illegal-move claims by an engine
1108 must be false, and will result in forfeiting the game. (In Winboard_x
1109 this message is ignored, causing the game or match to hang.)
1110
1111 Checkmate adjudication
1112 As soon as one of the engines does a move that results in checkmate,
1113 the GUI declares the game won, without waiting for the engine to claim
1114 it.
1115
1116 Insufficient mating material
1117 As soon as the material on the board has shrunk to KK, KNK or KBK, the
1118 game is declared draw.
1119
1120 /adjudicateLossThreshold=0
1121 This option was already present in Winboard_x, (to declare a game lost
1122 for which both engines agree for 3 moves that the score is below the
1123 given threshold), but a non-zero value is now also used to enable the
1124 following adjudications. If you only want the latter, just make the
1125 threshold impossibly low (-40000 will usually do the trick).
1126
1127 Trivial draws
1128 If we are 3 moves into a KQKQ, KRKR, KBKB KBKN or KNKN end-game, the
1129 game is adjudicated as draw.
1130
1131 /repeatsToDraw=6
1132 When the specified number of repeats occurs, the game is adjudicated
1133 draw. Should keep track of e.p. and castling rights. This does not
1134 require legality-testing to be switched on. The engines retain the
1135 legal right to claim after a 3-fold repetition, though. If you set
1136 this parameter to 3 or less, they will never get the chance. Better
1137 not set it to 1 or less.
1138
1139 /ruleMoves=51
1140 After the given number of full moves without capture or Pawn move, the
1141 game is adjudicated draw. Even without legality testing. The engines
1142 retain the legal right to claim after 50 moves.
1143
1144 /testClaims=FALSE
1145 When enabled, this option verifies all result claims made by the
1146 engines, and overrules the claim if it is false (forfeiting the game
1147 for the claimer). An engine can still safely claim a win for its
1148 opponent on a nonsense reason, though; this is taken to be the
1149 equivalent of 'resign'. Draw claims (made before a draw adjudication)
1150 are checked against the 50-move, 3-fold-repetition or
1151 insufficient-material rules. Win claims are always considered false,
1152 as the GUI adjudicates checkmates (and stalemates) before any engine
1153 can claim them.
1154
1155 Fairy-Chess support
1156
1157 /boardWidth=8
1158 Sets the number of files on the board. The additional files are named
1159 i, j, k, l... in PGN, and should be indicated this way in
1160 communicating moves to and from the engine. Currently works upto
1161 12. No guarantees on how the rest of the display (clocks, etc.) looks
1162 if you make this number < 8.
1163
1164 /boardHeight=8
1165 Sets the number of ranks. Extra ranks are numbered 9, 10, 11... in
1166 PGN. This is so far largely untested, and unlikely to work for
1167 double-digit ranks. Displaying boards with upto 12 ranks seems to
1168 work, though, but double-digit ranks might cause all kind of unforseen
1169 problems in PGN file and move parser, or in communication with the
1170 engine. To avoid such problems as much as possible, in boards with
1171 more than 9 ranks the counting of ranks will start at zero rather than
1172 one!
1173
1174 /fontPieceToCharTable="......."
1175 This paramater, controlling the mapping of font symbols to piece
1176 types, was already present in Winboard_x. The default is dependent on
1177 the font selected with the /renderPiecesWithFont option. It can now
1178 accept upto 32 pieces, but the length should always be even. The first
1179 half designates the white pieces, the second half the black, both in
1180 the order PNBRACHFEWDOGMQK. (The letters mentioned here are the
1181 letters by which the pieces will be indicated in PGN and FEN notation,
1182 what you have to give as argument depends on the font you use. A black
1183 king might be 'l', for instance).  If you give fewer then 32 pieces,
1184 this will go at the expense of what is just before Queen. So the last
1185 two symbols you give for each color are always Queen and King, the
1186 others are assigned in the order Pawn, Knight, ... Pieces that do not
1187 get a symbol assigned will remain invisible.
1188
1189 fairy-FEN support
1190 The letters ACDEFGHMOW are accepted in FENs in addition to the regular
1191 PNBRQK,(and of course the lower case versions for black), and are
1192 passed to the engine in a setboard or edit menu.  Double-digit skips
1193 are acceptable in FENs. 'x' is interpreted as a skip of 10.  Castling
1194 rights should no longer be ignored. (Doesn't work for FRC yet,
1195 though.)  The 50-move-plies field should also be meaningful now.
1196
1197 Legality testing for Fairy pieces
1198 There is a build in notion of what some of the new pieces can do, according to
1199 A = Archbishop (aka Cardinal) = N+B
1200 C = Chancellor (aka Marshall) = N+R
1201 F = Ferz (aka General), moves 1 step diagonal
1202 W = Wazir (aka Grand Vizer), moves 1 step orthogonal
1203 E = Elephant (aka Alfil), jumps 2 steps diagonal
1204 D = Dabbabah (aka War Machine), jumps 2 steps orthogonal
1205 M = Man (aka Commoner), moves as King, but is not a royal piece
1206 O = Cannon, moves along Rook lines, but cannot capture unless it jumps over
1207             exactly one piece (friend or foe), and captures the first piece
1208             it encounters thereafter. It can only jump if it captures something.
1209             The piece jumped over (the 'platform') is not affected.
1210 The other pieces have not yet any moves implemented:
1211 H = Nightrider
1212 G = Grasshopper
1213 In games that use the mentioned pieces as described (Shatranj,
1214 Courier, Capablanca Chess) you can leave legality testing on. If you
1215 use them to represent pieces that move differently, you should switch
1216 legality testing off.
1217
1218 Pawn moves
1219 Pawn motion is made dependent on the variant played: in Shatranj and
1220 Courier the double move is forbidden. In those games promotions are
1221 always to Ferz. In Capablanca Chess the ArchBishop and Chancellor also
1222 appear as choices in the promotion popup box.
1223
1224
1225 /variant="normal"
1226 Several new variants names are added (replacing "variant31" upto
1227 "variant36"). They affect the initial position. (Board size has to be
1228 set separately.) They are: courier (a Medieval predecessor of modern
1229 Chess, played on a 12x8 board) capablanca (on a 10x8 board, featuring
1230 Archbishop and Chancellor) gothic (as Capablanca, but with a more
1231 exciting initial setup) xiangqi (Chinese Chess) shogi (Japanese Chess,
1232 no support yet) fairy (This variant plays on 8x8 with HEW in stead of
1233 NBR on the Queen side, so that all back-rank pieces are (potentially)
1234 different) Make sure the selected board size matches the variant; this
1235 is not automatic
1236
1237 Xiangqi and Shogi support (or lack thereof)
1238 Xiangqi is only partially supported. The board display is
1239 western-style (the pieces play on squares, rather than grid
1240 intersections). The legality testing uses the Shatranj Knight and
1241 Elephant, that cannot be blocked, and thus allows some moves that
1242 should be illegal in Xiangqi. The Palace region is indicated on the
1243 board, but there is no testing if the King or Mandarins (implemented
1244 as ordinary Ferzes) leave the Palace. SAN might be non-standard, as it
1245 uses O to indicate Cannon. Most of this will be fixed in a future
1246 version.  Shogi is not yet supported at all, first the shaky
1247 implementation of Crazyhouse will have to be beefed up.