Version 0.6.
[cboard.git] / NEWS
blobd43e08f87090ce222fa9a363eb6a3153b11527c0
1 CBoard version 0.6
2 --------------------
3 No longer send SIGINT to the chess engine before each command. I'm not sure
4 how or when this broke things but no longer doing it fixes engine IO.
6 A macro value can now reference other macros and may also contain spaces.
8 Faster history parsing.
10 Fixed multiple game crashes. libchess no longer uses global variables.
12 Preliminary perl support. See README for details.
14 New signing key 0xB140DCE2.
16 New homepage. Please use http://c-board.sourceforge.net/.
18 Other minor fixes and changes. See ChangeLog for details.
21 CBoard version 0.5
22 --------------------
23 Board details are now enabled by default.
25 Added configuration parameter color_board_castling to change the castling
26 availability colors when board details is enabled.
28 Added configuration parameter color_board_enpassant. Visible when board
29 details is enabled.
31 The default color for a color definition can be used be specifying '-' as the
32 color.
34 A more complete clock. Time controls and move increments are now supported.
35 This only works for human/human play at the moment.
37 CBoard now uses nearly zero CPU time.
39 When sent SIGTERM, save all games to save_directory if specified and ~/.cboard
40 if not before quitting.
42 Fixed opening and saving to compressed files. Appending to compressed files is
43 now supported.
45 Added form input history for single line input dialogs.
47 A few bugfixes. See ChangeLog for details.
50 CBoard version 0.4
51 --------------------
52 The status window is now on top of the roster tag window.
54 Added command line option -C to enable strict castling.
56 A better clock. Each player has its own clock. The input format is the same as
57 before and also supports 'G/5' format. I'll add more features later.
59 A few (some important) bugfixes. See ChangeLog for details.
62 CBoard version 0.3
63 --------------------
64 New versioning scheme. It's less confusing and easier for me to use X.X
65 format. I really only work and release on one branch anyway.
67 Added global CTRL-i which copies the current game to a new one.
69 Added -D command line option to enable debugging if debugging was enabled at
70 compile time.
72 Added configuration parameter "engine_protocol" which specifies the XBoard
73 protocol that the engine uses. Right now this only means whether to send SAN
74 formatted moves (version 2) or FRFR formatted moves (version 1, the default).
76 Added file browser binding CTRL-e to change the filename expression.
78 Added configuration parameter 'strict_castling'. When enabled a castling move
79 will be invalid if the opponent can attack a castling square, beit the King,
80 Rook or the squares between the two. The default is off. This also adds a
81 keyboard binding CTRL-p to toggle strict castling.
83 New status window line 'Flags' which shows game flags for the current game.
85 Bugfixes and invisible changes. See ChangeLog for details.
88 CBoard version 0.2.4
89 --------------------
90 libchess: Castling bugfix.
92 You can now customize the key bindings for each game mode. The old "bind"
93 configuration parameter has been renamed to "cbind". The new "bind" works like
94 this: 
96     bind  <game_mode>  <key>  <command>  [alternate_description]
98 where game_mode is one of play, history or edit. The command is the command
99 associated with the game_mode. See doc/config.example for the default
100 bindings.
102 Added macros. When pressing a single key multiple keys can be "pressed"
103 without interaction. This adds a configuration parameter "macro" which looks
104 like this:
106     macro  <game_mode>  <key>  <key_sequence>
108 It's kinda like "bind" but with a key_sequence instead of a command so make
109 sure you specify all the "bind" stuff before "macro" stuff. It's also
110 different in that you can specify "any" as a game_mode so you can access the
111 global keys.
114 CBoard version 0.2.3
115 --------------------
116 Added non-blocking message windows, input dialogs and menus. This means that
117 other games can be running while editing tags etc.
119 Added a move history tree menu. From this you can view and edit a moves
120 annotation. RAV will be supported problably in the next release.
122 The board details key 'd' has changed to CTRL-d and annotating a move in
123 history mode now uses the key CTRL-a.
125 A couple bug fixes. See ChangeLog for details.
128 CBoard version 0.2.2
129 --------------------
130 Black opening and history mode fix.
132 Tag window and long value fix.
134 Added frfr2san.pgn to test/.
136 Increased MAX_PGN_NAG from 5 to 8.
138 The "Result" tag is determined by the move validator. Don't trust the result
139 tag from PGN import format unless it's a draw and the result couldn't be
140 determined.
142 -E command line switch fix.
144 When there is no promotion piece in the move text, promote to queen.
146 A few PGN parsing and writing fixes. RAV, NAG, comments and EOG.
148 Fix for copying the cc.data file.
150 Fix installing config.example to PREFIX/share/man/man6.
152 Added Debianization stuff.
155 Cboard version 0.2.1
156 --------------------
157 The move validator is a little more than 5 times faster. The major problem was
158 initializing each games g->b board when a file was parsed. Now g->b has
159 disappeared and a single board is used (caching). I discovered this on
160 accident, learn something new every day. Still not as fast as 0.1.6 though.
162 Switching between games will remember the cursor position and selected piece.
164 Switching playing sides will update the White and Black roster tags.
166 Castling and en passant validation fixes.
168 Resuming a game with a Black opening fixed.
170 FEN tag fix when loading a file.
172 Fixed the 'u'ndo command.
174 Cosmetic menu fix.
176 Added configuration parameter 'board_details' to enable/disable it by default.
178 Added board details indicator at the lower-right of the board window.
180 Added a move clock for both Black and White. Also added a countdown clock that
181 can be set by pressing 'C' in play mode.
183 When an ambiguous piece was pinned both the pinned piece and the other piece
184 failed validation. This has been fixed.
186 Fixed another SAN bug. If an ambiguous piece was pinned and the other was on
187 the same file the libchess would put the rank next to the piece in the move
188 text rather than the file.
190 Fixed resuming a game from a previous move in the history.
192 SIGTERM and SIGINT are caught and both will have cboard exit cleanly.
194 Black opening fix. Also when saving.
197 Cboard version 0.2.0
198 --------------------
199 Quite a while since the last release, I've lost interest in the project off
200 and on but still keep at it enough to fix and add things. The most important
201 change in this version is better SAN handling. Ambiguities are fixed along
202 with frfr to SAN conversion. There are quite a few internal changes too but
203 unfortunately this version is quite a bit slower than the last do to more
204 functionality. I'm trying to find ways to speed it up though. The PGN portion
205 of the code has been split up into a library "libchess". This allows for easy
206 inclusion into other projects. In-game keys have changed quite a bit. Press F1
207 to see them. Also read the manual page as configuration parameters have been
208 changed/added/removed. Here's the rest of the changes:
210 Switch from CVS to GIT.
212 Lots of FEN tag fixes when parsing, saving and editing the board.
214 When in history mode, the cursor is updated to the last position on the board.
216 Support for Unix 98 ptys.
218 Show the repeat count in the status window.
220 Added command line options -V to only validate a .pgn file, -S to save a PGN
221 formatted game and -R to save a reduced PGN formatted game. The return value
222 of cboard will be 1 if there was a parse error or 0 on success.
224 Added option -t to save custom tags from the configuration file when -S is
225 specified.
227 Added option -E to stop processing the file when a game contains a parse
228 error. Also see configuration parameter stop_on_error in the manual page.
230 A few key bindings have been removed. Press 'F1' in game for help.
232 Added human/human play. Toggle it with the 'H' key.
234 Added engine/engine play. Toggle it with the 'E' key then hit 'g'o!.
236 I've got a new email address. Send any bugs reports patches etc to me at
237 bjk@luxsci.net.
239 When a piece is selected cboard will only highlight legal squares the piece
240 can move to.
242 Updated manual page. Read this because a few configuration parameters have
243 changed.
245 Added game key 'd' to show board details. Details are the enpassant square and
246 castling availability.
248 The parser now supports RAV. Moves are read into the history but the interface
249 is minimal at the moment. Saving also works but is buggy.
251 Support window resizing when in an xterm. Need at least an 80x24 terminal.
253 Support for all engines that utilize the XBoard protocol. Not very well
254 tested. GNUChess and Crafty seem to work fine though.
256 Added configuration parameter 'engine_init' which sends a command to the
257 engine when initialized.
259 The file browser (save/load prompt) supports filters.
261 A "Loading..." window/line when a file is being loaded.
263 Added configuration parameter 'bind' which binds a key to a command to send to
264 the engine when in play mode. Read the manual page.
266 Added key 'W' to show an engine io window.
268 New menu code. Looks better with custom colors. Type ahead searching is buggy
269 though.
271 Lots of internal, parser, validation and bug fixes.
274 CBoard version 0.1.6
275 --------------------
276 A few important save game, validation and file parser fixes.
278 Added command 't' to edit tags. You won't be prompted to edit tags anymore
279 when saving.
281 Renamed game deletion commands 'd' and 'D' to 'x' and 'X'. The delete commands
282 also accept a "range" to delete by specifying a count the one of the delete
283 commands then a direction ('<' or '>').
285 Tildes in the load/save dialog are expanded.
287 Added commands '!'-'*' and 'A'-'H' to move the cursor to the specified
288 rank/file.
290 Move numbers and tags are no longer needed in a PGN file.
292 The ncurses interface is initialized before trying to parse a file specified
293 on the command line.
295 The annotation viewing commands '[' and ']' have changed to 'V' and 'v'.
297 The next/prev move text expression keys '}' and '{' have changed to ']' and
298 '['.
300 Added game searching commands '?', '}' and '{'. These work like to move text
301 searching commands, but for roster tags instead.
303 Now parses the FEN tag. When editing tags, you can press CTRL-f to insert or
304 update the FEN tag with the current move in the move history.
306 Added command 'e' to toggle edit mode. This will allow positioning, deleting
307 ('x' command) and inserting ('I' command) of pieces. No move validation is
308 done in edit mode and may only be enabled with a fresh board ('N' or 'n'
309 commands). After leaving edit mode, a FEN tag is created. It's somewhat
310 useless right now though.
312 Redone main command keys help.
314 Added commands '_' and '+' to decrease and increase the engine depth. These
315 can take a count.
318 CBoard version 0.1.5
319 --------------------
320 The repeat count commands are now 0-9. The first non-integer is the command to
321 repeat. So now you can have more than ten as a count. Pressing ESCAPE in the
322 middle of the count will reset it (similar to VIM's repeat).
324 The 'u'ndo command can take a repeat count.
326 Replaced the black and white status windows with a Seven Tag Roster window
327 (like before). The black and white info will be in the game status window.
329 Check and checkmate recognition are working (not draw though).
331 Added history move text searching commands. '/' will prompt for a new regular
332 expression and jump to the next match, '{' and '}' will jump to the previous
333 or next match prompting for an expression if one doesn't already exist. All of
334 these commands can take a repeat count.
336 Move numbers in the history window are full move numbers now. So by default,
337 the cursor keys in history mode will jump 2 moves. Pressing SPACE in history
338 mode will toggle half-move stepping.
340 The "board_moves" color parameter has been replaced by "board_white_moves" and
341 "board_black_moves" to specify the valid move color for those squares.
344 CBoard version 0.1.4
345 --------------------
346 This release fixes a few bugs and plugs a couple memory leaks in the menu code.
347 The SAN move parser still needs quite a bit of work though when interfaced
348 with the engine, so check and end-of-game determination are on hold until that
349 gets stable. But viewing games seems alright. Beginnings of ICS support
350 (ignore the manual references as its useless right now). Hopefully the code is
351 little more readable and easier to follow now. Heres the rest of the news:
353 "make install" will install the data files and example configuration file to
354 DATADIR/cboard (/usr/local/share/cboard by default). They will be copied to
355 ~/.cboard if they cannot be found.
357 Linux runtime fixes.
359 Can load and save .Z, .gz, .zip, .bz and .bz2 compressed files. Can't append
360 to a compressed file though (for now).
362 If theres a parse error when loading a file with multiple games, CBoard will
363 keep reading the file rather than aborting.
365 When editing the "Site" tag, you can lookup country codes which are stored in
366 ~/.cboard/cc.data.
368 If a filename doesn't contain a ".", then ".pgn" is appended to it when
369 saving.
371 A few but important PGN parser fixes.
373 Tags are sorted when loading and saving.
375 Added command "d" to toggle the delete flag of the current game. Pressing "D"
376 will delete all flagged games or the current one if none are flagged. This
377 adds the configuration parameter "delete_prompt". The default is on.
379 Added configuration parameter "valid_moves" to show valid moves when a piece
380 is selected. The color can be adjusted with the "board_moves" color parameter.
381 The cursor keys will move to the associated valid move. This is still buggy
382 though.
384 Added cursor repeat commands 0..9 (zero being ten). These will work with the
385 board navigation, history browsing and game browsing keys.
387 Removed cursor movement command 'j', 'k', 'l', and ';'.
389 Added commands 'j' and 'J' to jump to a history move number or game number.
391 Added "board_window" color configuration parameter.
393 Added "engine_cmd" to specify the chess engine path, command and any
394 arguments. The default is "gnuchess xboard". Note that other commands/engines
395 haven't been tested.
398 CBoard version 0.1.3
399 --------------------
400 Can now load and save SAN move format! Still not perfect I'm sure.
402 A file browser has been added to the load/save game prompt. Pressing TAB will
403 enable it.
405 Added configuration parameter "save_directory". If set, saved games will be
406 stored here and will also be the default open location of the file browser.
408 The annotation viewing keys have changed from 'V' and 'v' to '[' and ']'.
410 Configuration parameters whose values were either "0" or "1" are now "off" or
411 "on" respectively.
413 New configuration parameter "line_graphics". If "off", then the board line
414 graphics will not be drawn.
416 The data window has been replaced by two separate white and black player
417 information windows. This adds color configuration parameters white_... and
418 black_...
420 The PGN file parser now supports "!?"/"!!"/etc. NAG format and end-of-game
421 markers.
423 When multiple games are loaded, you can choose to save all games or just the
424 current one.
426 When saving from history mode, you can save up to the current move or all
427 moves.
429 Added configuration parameter "save_prompt" and ingame command "S". When set
430 to "off", don't prompt to edit roster tags and for history save commands when
431 in history mode.
433 The ingame "N" command has changed to start a new game from scratch. The "n"
434 command starts a new game or round.
436 Added command "D" to delete game.
439 CBoard version 0.1.2
440 --------------------
441 Loading a saved game and resuming a game from previous history works now. This
442 is done by having the chess engine read a FIFO and have CBoard write to it.
443 This allows for easy game switching when more than one game has been loaded.
445 Promotions, En Passant and castling moves are recognized now.
447 Agony strings are stored in ~/.cboard/agony.data and can be disabled with a
448 configuration file option (see below).
450 Rewritten move text section in the PGN parser. Now move annotations are read
451 and written and can be viewed with the 'v' and 'V' commands in history mode.
452 This supports both move comments and NAG data (see below).
454 There is no longer a -f command line option to specify a configuration file.
455 The new configuration file is stored in the ~/.cboard directory along with a
456 few data files. The files that need to be found in this directory are:
458     config     - This is optional, CBoard will use defaults if not found.
459     nag.data   - For viewing and editing move annotations.
460     agony.data - Agony strings displayed in the status window when a capture
461                  has been made.
462     fifo       - Used for resuming games.
464 You can find the data files along with an example configuration file in the
465 'etc/' directory of the archive. You'll have to copy them over to ~/.cboard
466 yourself until I figure out a way to do it with 'make install'.
468 You can define custom colors and attributes in the configuration file. See the
469 manual page for more infomation on the syntax.
471 Added configuration parameters:
472           pgntag - Define custom tags for new games or override defaults.
473            agony - Show a random agony string on a capture.
474     historyagony - Enable or disable agony strings in history mode.
476 SAN move format is the next major thing that needs to be done. It seems like
477 I'm going in reverse order of how things should be developed, but oh well.