Add color_board_prev_move to the manual page.
[cboard.git] / NEWS
blob35585fb7b81d89e36f78fa0a9b0431b6ad6b214f
1 CBoard version 0.7.0
2 --------------------
3 Many thanks to Noel Tlatempa G <ntlatempa@gmail.com> most all feature
4 patches in this release.
6 UTF-8 support and gettext support.
8 Unicode chess pieces when -u or 'utf8_pieces' is enabled.
10 Es translation.
12 Ability to rotate the board at the beginning of a round and in history mode.
14 Added option 'coords_y_left' to change sides of the board characters.
16 Added option 'fm_polyglot' to fix quirks with some chess engine interfaces.
17 Sends the 'go' command after beginning a round.
19 Added the 'board_left' config option to put the chess board to the right or
20 left of other windows.
22 Added confirmation before quitting.
24 Added option 'engine_cmd_blacktag' to set the oppenent tag to the engine
25 command line.
27 Added option 'show_attacks' to hilight opponent pieces that can attack the
28 square under the cursor using the 'color_board_attack' color.
30 Fixed castling bug.
32 Fixed game copying.
34 Added big and mega board sizes. These can be viewed when resizing the
35 terminal to 112x40 and 144x50.
37 Minimal terminal size is now 74x23.
40 CBoard version 0.6.1
41 --------------------
42 This version fixes a bug when copying a game the FEN tag wasn't getting parsed
43 correctly.
45 Also fixes a threading issue in pgn_parse_move() if you'd like to use libchess
46 in your own multi-threaded chess game.
49 CBoard version 0.6
50 --------------------
51 No longer send SIGINT to the chess engine before each command. I'm not sure
52 how or when this broke things but no longer doing it fixes engine IO.
54 A macro value can now reference other macros and may also contain spaces.
56 Faster history parsing.
58 Fixed multiple game crashes. libchess no longer uses global variables.
60 Preliminary perl support. See README for details.
62 New signing key 0xB140DCE2.
64 New homepage. Please use http://c-board.sourceforge.net/.
66 Other minor fixes and changes. See ChangeLog for details.
69 CBoard version 0.5
70 --------------------
71 Board details are now enabled by default.
73 Added configuration parameter color_board_castling to change the castling
74 availability colors when board details is enabled.
76 Added configuration parameter color_board_enpassant. Visible when board
77 details is enabled.
79 The default color for a color definition can be used be specifying '-' as the
80 color.
82 A more complete clock. Time controls and move increments are now supported.
83 This only works for human/human play at the moment.
85 CBoard now uses nearly zero CPU time.
87 When sent SIGTERM, save all games to save_directory if specified and ~/.cboard
88 if not before quitting.
90 Fixed opening and saving to compressed files. Appending to compressed files is
91 now supported.
93 Added form input history for single line input dialogs.
95 A few bugfixes. See ChangeLog for details.
98 CBoard version 0.4
99 --------------------
100 The status window is now on top of the roster tag window.
102 Added command line option -C to enable strict castling.
104 A better clock. Each player has its own clock. The input format is the same as
105 before and also supports 'G/5' format. I'll add more features later.
107 A few (some important) bugfixes. See ChangeLog for details.
110 CBoard version 0.3
111 --------------------
112 New versioning scheme. It's less confusing and easier for me to use X.X
113 format. I really only work and release on one branch anyway.
115 Added global CTRL-i which copies the current game to a new one.
117 Added -D command line option to enable debugging if debugging was enabled at
118 compile time.
120 Added configuration parameter "engine_protocol" which specifies the XBoard
121 protocol that the engine uses. Right now this only means whether to send SAN
122 formatted moves (version 2) or FRFR formatted moves (version 1, the default).
124 Added file browser binding CTRL-e to change the filename expression.
126 Added configuration parameter 'strict_castling'. When enabled a castling move
127 will be invalid if the opponent can attack a castling square, beit the King,
128 Rook or the squares between the two. The default is off. This also adds a
129 keyboard binding CTRL-p to toggle strict castling.
131 New status window line 'Flags' which shows game flags for the current game.
133 Bugfixes and invisible changes. See ChangeLog for details.
136 CBoard version 0.2.4
137 --------------------
138 libchess: Castling bugfix.
140 You can now customize the key bindings for each game mode. The old "bind"
141 configuration parameter has been renamed to "cbind". The new "bind" works like
142 this: 
144     bind  <game_mode>  <key>  <command>  [alternate_description]
146 where game_mode is one of play, history or edit. The command is the command
147 associated with the game_mode. See doc/config.example for the default
148 bindings.
150 Added macros. When pressing a single key multiple keys can be "pressed"
151 without interaction. This adds a configuration parameter "macro" which looks
152 like this:
154     macro  <game_mode>  <key>  <key_sequence>
156 It's kinda like "bind" but with a key_sequence instead of a command so make
157 sure you specify all the "bind" stuff before "macro" stuff. It's also
158 different in that you can specify "any" as a game_mode so you can access the
159 global keys.
162 CBoard version 0.2.3
163 --------------------
164 Added non-blocking message windows, input dialogs and menus. This means that
165 other games can be running while editing tags etc.
167 Added a move history tree menu. From this you can view and edit a moves
168 annotation. RAV will be supported problably in the next release.
170 The board details key 'd' has changed to CTRL-d and annotating a move in
171 history mode now uses the key CTRL-a.
173 A couple bug fixes. See ChangeLog for details.
176 CBoard version 0.2.2
177 --------------------
178 Black opening and history mode fix.
180 Tag window and long value fix.
182 Added frfr2san.pgn to test/.
184 Increased MAX_PGN_NAG from 5 to 8.
186 The "Result" tag is determined by the move validator. Don't trust the result
187 tag from PGN import format unless it's a draw and the result couldn't be
188 determined.
190 -E command line switch fix.
192 When there is no promotion piece in the move text, promote to queen.
194 A few PGN parsing and writing fixes. RAV, NAG, comments and EOG.
196 Fix for copying the cc.data file.
198 Fix installing config.example to PREFIX/share/man/man6.
200 Added Debianization stuff.
203 Cboard version 0.2.1
204 --------------------
205 The move validator is a little more than 5 times faster. The major problem was
206 initializing each games g->b board when a file was parsed. Now g->b has
207 disappeared and a single board is used (caching). I discovered this on
208 accident, learn something new every day. Still not as fast as 0.1.6 though.
210 Switching between games will remember the cursor position and selected piece.
212 Switching playing sides will update the White and Black roster tags.
214 Castling and en passant validation fixes.
216 Resuming a game with a Black opening fixed.
218 FEN tag fix when loading a file.
220 Fixed the 'u'ndo command.
222 Cosmetic menu fix.
224 Added configuration parameter 'board_details' to enable/disable it by default.
226 Added board details indicator at the lower-right of the board window.
228 Added a move clock for both Black and White. Also added a countdown clock that
229 can be set by pressing 'C' in play mode.
231 When an ambiguous piece was pinned both the pinned piece and the other piece
232 failed validation. This has been fixed.
234 Fixed another SAN bug. If an ambiguous piece was pinned and the other was on
235 the same file the libchess would put the rank next to the piece in the move
236 text rather than the file.
238 Fixed resuming a game from a previous move in the history.
240 SIGTERM and SIGINT are caught and both will have cboard exit cleanly.
242 Black opening fix. Also when saving.
245 Cboard version 0.2.0
246 --------------------
247 Quite a while since the last release, I've lost interest in the project off
248 and on but still keep at it enough to fix and add things. The most important
249 change in this version is better SAN handling. Ambiguities are fixed along
250 with frfr to SAN conversion. There are quite a few internal changes too but
251 unfortunately this version is quite a bit slower than the last do to more
252 functionality. I'm trying to find ways to speed it up though. The PGN portion
253 of the code has been split up into a library "libchess". This allows for easy
254 inclusion into other projects. In-game keys have changed quite a bit. Press F1
255 to see them. Also read the manual page as configuration parameters have been
256 changed/added/removed. Here's the rest of the changes:
258 Switch from CVS to GIT.
260 Lots of FEN tag fixes when parsing, saving and editing the board.
262 When in history mode, the cursor is updated to the last position on the board.
264 Support for Unix 98 ptys.
266 Show the repeat count in the status window.
268 Added command line options -V to only validate a .pgn file, -S to save a PGN
269 formatted game and -R to save a reduced PGN formatted game. The return value
270 of cboard will be 1 if there was a parse error or 0 on success.
272 Added option -t to save custom tags from the configuration file when -S is
273 specified.
275 Added option -E to stop processing the file when a game contains a parse
276 error. Also see configuration parameter stop_on_error in the manual page.
278 A few key bindings have been removed. Press 'F1' in game for help.
280 Added human/human play. Toggle it with the 'H' key.
282 Added engine/engine play. Toggle it with the 'E' key then hit 'g'o!.
284 I've got a new email address. Send any bugs reports patches etc to me at
285 bjk@luxsci.net.
287 When a piece is selected cboard will only highlight legal squares the piece
288 can move to.
290 Updated manual page. Read this because a few configuration parameters have
291 changed.
293 Added game key 'd' to show board details. Details are the enpassant square and
294 castling availability.
296 The parser now supports RAV. Moves are read into the history but the interface
297 is minimal at the moment. Saving also works but is buggy.
299 Support window resizing when in an xterm. Need at least an 80x24 terminal.
301 Support for all engines that utilize the XBoard protocol. Not very well
302 tested. GNUChess and Crafty seem to work fine though.
304 Added configuration parameter 'engine_init' which sends a command to the
305 engine when initialized.
307 The file browser (save/load prompt) supports filters.
309 A "Loading..." window/line when a file is being loaded.
311 Added configuration parameter 'bind' which binds a key to a command to send to
312 the engine when in play mode. Read the manual page.
314 Added key 'W' to show an engine io window.
316 New menu code. Looks better with custom colors. Type ahead searching is buggy
317 though.
319 Lots of internal, parser, validation and bug fixes.
322 CBoard version 0.1.6
323 --------------------
324 A few important save game, validation and file parser fixes.
326 Added command 't' to edit tags. You won't be prompted to edit tags anymore
327 when saving.
329 Renamed game deletion commands 'd' and 'D' to 'x' and 'X'. The delete commands
330 also accept a "range" to delete by specifying a count the one of the delete
331 commands then a direction ('<' or '>').
333 Tildes in the load/save dialog are expanded.
335 Added commands '!'-'*' and 'A'-'H' to move the cursor to the specified
336 rank/file.
338 Move numbers and tags are no longer needed in a PGN file.
340 The ncurses interface is initialized before trying to parse a file specified
341 on the command line.
343 The annotation viewing commands '[' and ']' have changed to 'V' and 'v'.
345 The next/prev move text expression keys '}' and '{' have changed to ']' and
346 '['.
348 Added game searching commands '?', '}' and '{'. These work like to move text
349 searching commands, but for roster tags instead.
351 Now parses the FEN tag. When editing tags, you can press CTRL-f to insert or
352 update the FEN tag with the current move in the move history.
354 Added command 'e' to toggle edit mode. This will allow positioning, deleting
355 ('x' command) and inserting ('I' command) of pieces. No move validation is
356 done in edit mode and may only be enabled with a fresh board ('N' or 'n'
357 commands). After leaving edit mode, a FEN tag is created. It's somewhat
358 useless right now though.
360 Redone main command keys help.
362 Added commands '_' and '+' to decrease and increase the engine depth. These
363 can take a count.
366 CBoard version 0.1.5
367 --------------------
368 The repeat count commands are now 0-9. The first non-integer is the command to
369 repeat. So now you can have more than ten as a count. Pressing ESCAPE in the
370 middle of the count will reset it (similar to VIM's repeat).
372 The 'u'ndo command can take a repeat count.
374 Replaced the black and white status windows with a Seven Tag Roster window
375 (like before). The black and white info will be in the game status window.
377 Check and checkmate recognition are working (not draw though).
379 Added history move text searching commands. '/' will prompt for a new regular
380 expression and jump to the next match, '{' and '}' will jump to the previous
381 or next match prompting for an expression if one doesn't already exist. All of
382 these commands can take a repeat count.
384 Move numbers in the history window are full move numbers now. So by default,
385 the cursor keys in history mode will jump 2 moves. Pressing SPACE in history
386 mode will toggle half-move stepping.
388 The "board_moves" color parameter has been replaced by "board_white_moves" and
389 "board_black_moves" to specify the valid move color for those squares.
392 CBoard version 0.1.4
393 --------------------
394 This release fixes a few bugs and plugs a couple memory leaks in the menu code.
395 The SAN move parser still needs quite a bit of work though when interfaced
396 with the engine, so check and end-of-game determination are on hold until that
397 gets stable. But viewing games seems alright. Beginnings of ICS support
398 (ignore the manual references as its useless right now). Hopefully the code is
399 little more readable and easier to follow now. Heres the rest of the news:
401 "make install" will install the data files and example configuration file to
402 DATADIR/cboard (/usr/local/share/cboard by default). They will be copied to
403 ~/.cboard if they cannot be found.
405 Linux runtime fixes.
407 Can load and save .Z, .gz, .zip, .bz and .bz2 compressed files. Can't append
408 to a compressed file though (for now).
410 If theres a parse error when loading a file with multiple games, CBoard will
411 keep reading the file rather than aborting.
413 When editing the "Site" tag, you can lookup country codes which are stored in
414 ~/.cboard/cc.data.
416 If a filename doesn't contain a ".", then ".pgn" is appended to it when
417 saving.
419 A few but important PGN parser fixes.
421 Tags are sorted when loading and saving.
423 Added command "d" to toggle the delete flag of the current game. Pressing "D"
424 will delete all flagged games or the current one if none are flagged. This
425 adds the configuration parameter "delete_prompt". The default is on.
427 Added configuration parameter "valid_moves" to show valid moves when a piece
428 is selected. The color can be adjusted with the "board_moves" color parameter.
429 The cursor keys will move to the associated valid move. This is still buggy
430 though.
432 Added cursor repeat commands 0..9 (zero being ten). These will work with the
433 board navigation, history browsing and game browsing keys.
435 Removed cursor movement command 'j', 'k', 'l', and ';'.
437 Added commands 'j' and 'J' to jump to a history move number or game number.
439 Added "board_window" color configuration parameter.
441 Added "engine_cmd" to specify the chess engine path, command and any
442 arguments. The default is "gnuchess xboard". Note that other commands/engines
443 haven't been tested.
446 CBoard version 0.1.3
447 --------------------
448 Can now load and save SAN move format! Still not perfect I'm sure.
450 A file browser has been added to the load/save game prompt. Pressing TAB will
451 enable it.
453 Added configuration parameter "save_directory". If set, saved games will be
454 stored here and will also be the default open location of the file browser.
456 The annotation viewing keys have changed from 'V' and 'v' to '[' and ']'.
458 Configuration parameters whose values were either "0" or "1" are now "off" or
459 "on" respectively.
461 New configuration parameter "line_graphics". If "off", then the board line
462 graphics will not be drawn.
464 The data window has been replaced by two separate white and black player
465 information windows. This adds color configuration parameters white_... and
466 black_...
468 The PGN file parser now supports "!?"/"!!"/etc. NAG format and end-of-game
469 markers.
471 When multiple games are loaded, you can choose to save all games or just the
472 current one.
474 When saving from history mode, you can save up to the current move or all
475 moves.
477 Added configuration parameter "save_prompt" and ingame command "S". When set
478 to "off", don't prompt to edit roster tags and for history save commands when
479 in history mode.
481 The ingame "N" command has changed to start a new game from scratch. The "n"
482 command starts a new game or round.
484 Added command "D" to delete game.
487 CBoard version 0.1.2
488 --------------------
489 Loading a saved game and resuming a game from previous history works now. This
490 is done by having the chess engine read a FIFO and have CBoard write to it.
491 This allows for easy game switching when more than one game has been loaded.
493 Promotions, En Passant and castling moves are recognized now.
495 Agony strings are stored in ~/.cboard/agony.data and can be disabled with a
496 configuration file option (see below).
498 Rewritten move text section in the PGN parser. Now move annotations are read
499 and written and can be viewed with the 'v' and 'V' commands in history mode.
500 This supports both move comments and NAG data (see below).
502 There is no longer a -f command line option to specify a configuration file.
503 The new configuration file is stored in the ~/.cboard directory along with a
504 few data files. The files that need to be found in this directory are:
506     config     - This is optional, CBoard will use defaults if not found.
507     nag.data   - For viewing and editing move annotations.
508     agony.data - Agony strings displayed in the status window when a capture
509                  has been made.
510     fifo       - Used for resuming games.
512 You can find the data files along with an example configuration file in the
513 'etc/' directory of the archive. You'll have to copy them over to ~/.cboard
514 yourself until I figure out a way to do it with 'make install'.
516 You can define custom colors and attributes in the configuration file. See the
517 manual page for more infomation on the syntax.
519 Added configuration parameters:
520           pgntag - Define custom tags for new games or override defaults.
521            agony - Show a random agony string on a capture.
522     historyagony - Enable or disable agony strings in history mode.
524 SAN move format is the next major thing that needs to be done. It seems like
525 I'm going in reverse order of how things should be developed, but oh well.