CHANGES revision 136644
1This document details the changes between this version, readline-5.0, 2and the previous version, readline-4.3. 3 41. Changes to Readline 5 6a. Fixes to avoid core dumps because of null pointer references in the 7 multibyte character code. 8 9b. Fix to avoid infinite recursion caused by certain key combinations. 10 11c. Fixed a bug that caused the vi-mode `last command' to be set incorrectly. 12 13d. Readline no longer tries to read ahead more than one line of input, even 14 when more is available. 15 16e. Fixed the code that adjusts the point to not mishandle null wide 17 characters. 18 19f. Fixed a bug in the history expansion `g' modifier that caused it to skip 20 every other match. 21 22g. Fixed a bug that caused the prompt to overwrite previous output when the 23 output doesn't contain a newline and the locale supports multibyte 24 characters. This same change fixes the problem of readline redisplay 25 slowing down dramatically as the line gets longer in multibyte locales. 26 27h. History traversal with arrow keys in vi insertion mode causes the cursor 28 to be placed at the end of the new line, like in emacs mode. 29 30i. The locale initialization code does a better job of using the right 31 precedence and defaulting when checking the appropriate environment 32 variables. 33 34j. Fixed the history word tokenizer to handle <( and >( better when used as 35 part of bash. 36 37k. The overwrite mode code received several bug fixes to improve undo. 38 39l. Many speedups to the multibyte character redisplay code. 40 41m. The callback character reading interface should not hang waiting to read 42 keyboard input. 43 44n. Fixed a bug with redoing vi-mode `s' command. 45 46o. The code that initializes the terminal tracks changes made to the terminal 47 special characters with stty(1) (or equivalent), so that these changes 48 are reflected in the readline bindings. New application-callable function 49 to make it work: rl_tty_unset_default_bindings(). 50 51p. Fixed a bug that could cause garbage to be inserted in the buffer when 52 changing character case in vi mode when using a multibyte locale. 53 54q. Fixed a bug in the redisplay code that caused problems on systems 55 supporting multibyte characters when moving between history lines when the 56 new line has more glyphs but fewer bytes. 57 58r. Undo and redo now work better after exiting vi insertion mode. 59 60s. Make sure system calls are restarted after a SIGWINCH is received using 61 SA_RESTART. 62 63t. Improvements to the code that displays possible completions when using 64 multibyte characters. 65 66u. Fixed a problem when parsing nested if statements in inputrc files. 67 68v. The completer now takes multibyte characters into account when looking for 69 quoted substrings on which to perform completion. 70 71w. The history search functions now perform better bounds checking on the 72 history list. 73 74x. Change to history expansion functions to treat `^' as equivalent to word 75 one, as the documention states. 76 77y. Some changes to the display code to improve display and redisplay of 78 multibyte characters. 79 80z. Changes to speed up the multibyte character redisplay code. 81 82aa. Fixed a bug in the vi-mode `E' command that caused it to skip over the 83 last character of a word if invoked while point was on the word's 84 next-to-last character. 85 86bb. Fixed a bug that could cause incorrect filename quoting when 87 case-insensitive completion was enabled and the word being completed 88 contained backslashes quoting word break characters. 89 90cc. Fixed a bug in redisplay triggered when the prompt string contains 91 invisible characters. 92 93dd. Fixed some display (and other) bugs encountered in multibyte locales 94 when a non-ascii character was the last character on a line. 95 96ee. Fixed some display bugs caused by multibyte characters in prompt strings. 97 98ff. Fixed a problem with history expansion caused by non-whitespace characters 99 used as history word delimiters. 100 101gg. Fixed a problem that could cause readline to refer to freed memory when 102 moving between history lines while doing searches. 103 104hh. Improvements to the code that expands and displays prompt strings 105 containing multibyte characters. 106 107ii. Fixed a problem with vi-mode not correctly remembering the numeric argument 108 to the last `c'hange command for later use with `.'. 109 110jj. Fixed a bug in vi-mode that caused multi-digit count arguments to work 111 incorrectly. 112 113kk. Fixed a problem in vi-mode that caused the last text modification command 114 to not be remembered across different command lines. 115 116ll. Fixed problems with changing characters and changing case at the end of 117 the line. 118 119mm. Fixed a problem with readline saving the contents of the current line 120 before beginning a non-interactive search. 121 122nn. Fixed a problem with EOF detection when using rl_event_hook. 123 124oo. Fixed a problem with the vi mode `p' and `P' commands ignoring numeric 125 arguments. 126 1272. New Features in Readline 128 129a. History expansion has a new `a' modifier equivalent to the `g' modifier 130 for compatibility with the BSD csh. 131 132b. History expansion has a new `G' modifier equivalent to the BSD csh `g' 133 modifier, which performs a substitution once per word. 134 135c. All non-incremental search operations may now undo the operation of 136 replacing the current line with the history line. 137 138d. The text inserted by an `a' command in vi mode can be reinserted with 139 `.'. 140 141e. New bindable variable, `show-all-if-unmodified'. If set, the readline 142 completer will list possible completions immediately if there is more 143 than one completion and partial completion cannot be performed. 144 145f. There is a new application-callable `free_history_entry()' function. 146 147g. History list entries now contain timestamp information; the history file 148 functions know how to read and write timestamp information associated 149 with each entry. 150 151h. Four new key binding functions have been added: 152 153 rl_bind_key_if_unbound() 154 rl_bind_key_if_unbound_in_map() 155 rl_bind_keyseq_if_unbound() 156 rl_bind_keyseq_if_unbound_in_map() 157 158i. New application variable, rl_completion_quote_character, set to any 159 quote character readline finds before it calls the application completion 160 function. 161 162j. New application variable, rl_completion_suppress_quote, settable by an 163 application completion function. If set to non-zero, readline does not 164 attempt to append a closing quote to a completed word. 165 166k. New application variable, rl_completion_found_quote, set to a non-zero 167 value if readline determines that the word to be completed is quoted. 168 Set before readline calls any application completion function. 169 170l. New function hook, rl_completion_word_break_hook, called when readline 171 needs to break a line into words when completion is attempted. Allows 172 the word break characters to vary based on position in the line. 173 174m. New bindable command: unix-filename-rubout. Does the same thing as 175 unix-word-rubout, but adds `/' to the set of word delimiters. 176 177n. When listing completions, directories have a `/' appended if the 178 `mark-directories' option has been enabled. 179 180------------------------------------------------------------------------------- 181This document details the changes between this version, readline-4.3, 182and the previous version, readline-4.2a. 183 1841. Changes to Readline 185 186a. Fixed output of comment-begin character when listing variable values. 187 188b. Added some default key bindings for common escape sequences produced by 189 HOME and END keys. 190 191c. Fixed the mark handling code to be more emacs-compatible. 192 193d. A bug was fixed in the code that prints possible completions to keep it 194 from printing empty strings in certain circumstances. 195 196e. Change the key sequence printing code to print ESC as M\- if ESC is a 197 meta-prefix character -- it's easier for users to understand than \e. 198 199f. Fixed unstifle_history() to return values that match the documentation. 200 201g. Fixed the event loop (rl_event_hook) to handle the case where the input 202 file descriptor is invalidated. 203 204h. Fixed the prompt display code to work better when the application has a 205 custom redisplay function. 206 207i. Changes to make reading and writing the history file a little faster, and 208 to cope with huge history files without calling abort(3) from xmalloc. 209 210j. The vi-mode `S' and `s' commands are now undone correctly. 211 212k. Fixed a problem which caused the display to be messed up when the last 213 line of a multi-line prompt (possibly containing invisible characters) 214 was longer than the screen width. 215 2162. New Features in Readline 217 218a. Support for key `subsequences': allows, e.g., ESC and ESC-a to both 219 be bound to readline functions. Now the arrow keys may be used in vi 220 insert mode. 221 222b. When listing completions, and the number of lines displayed is more than 223 the screen length, readline uses an internal pager to display the results. 224 This is controlled by the `page-completions' variable (default on). 225 226c. New code to handle editing and displaying multibyte characters. 227 228d. The behavior introduced in bash-2.05a of deciding whether or not to 229 append a slash to a completed name that is a symlink to a directory has 230 been made optional, controlled by the `mark-symlinked-directories' 231 variable (default is the 2.05a behavior). 232 233e. The `insert-comment' command now acts as a toggle if given a numeric 234 argument: if the first characters on the line don't specify a 235 comment, insert one; if they do, delete the comment text 236 237f. New application-settable completion variable: 238 rl_completion_mark_symlink_dirs, allows an application's completion 239 function to temporarily override the user's preference for appending 240 slashes to names which are symlinks to directories. 241 242g. New function available to application completion functions: 243 rl_completion_mode, to tell how the completion function was invoked 244 and decide which argument to supply to rl_complete_internal (to list 245 completions, etc.). 246 247h. Readline now has an overwrite mode, toggled by the `overwrite-mode' 248 bindable command, which could be bound to `Insert'. 249 250i. New application-settable completion variable: 251 rl_completion_suppress_append, inhibits appending of 252 rl_completion_append_character to completed words. 253 254j. New key bindings when reading an incremental search string: ^W yanks 255 the currently-matched word out of the current line into the search 256 string; ^Y yanks the rest of the current line into the search string, 257 DEL or ^H deletes characters from the search string. 258 259------------------------------------------------------------------------------- 260This document details the changes between this version, readline-4.2a, 261and the previous version, readline-4.2. 262 2631. Changes to Readline 264 265a. More `const' and type casting fixes. 266 267b. Changed rl_message() to use vsnprintf(3) (if available) to fix buffer 268 overflow problems. 269 270c. The completion code no longer appends a `/' or ` ' to a match when 271 completing a symbolic link that resolves to a directory name, unless 272 the match does not add anything to the word being completed. This 273 means that a tab will complete the word up to the full name, but not 274 add anything, and a subsequent tab will add a slash. 275 276d. Fixed a trivial typo that made the vi-mode `dT' command not work. 277 278e. Fixed the tty code so that ^S and ^Q can be inserted with rl_quoted_insert. 279 280f. Fixed the tty code so that ^V works more than once. 281 282g. Changed the use of __P((...)) for function prototypes to PARAMS((...)) 283 because the use of __P in typedefs conflicted g++ and glibc. 284 285h. The completion code now attempts to do a better job of preserving the 286 case of the word the user typed if ignoring case in completions. 287 288i. Readline defaults to not echoing the input and lets the terminal 289 initialization code enable echoing if there is a controlling terminal. 290 291j. The key binding code now processes only two hex digits after a `\x' 292 escape sequence, and the documentation was changed to note that the 293 octal and hex escape sequences result in an eight-bit value rather 294 than strict ASCII. 295 296k. Fixed a few places where negative array subscripts could have occurred. 297 298l. Fixed the vi-mode code to use a better method to determine the bounds of 299 the array used to hold the marks, and to avoid out-of-bounds references. 300 301m. Fixed the defines in chardefs.h to work better when chars are signed. 302 303n. Fixed configure.in to use the new names for bash autoconf macros. 304 305o. Readline no longer attempts to define its own versions of some ctype 306 macros if they are implemented as functions in libc but not as macros in 307 <ctype.h>. 308 309p. Fixed a problem where rl_backward could possibly set point to before 310 the beginning of the line. 311 312q. Fixed Makefile to not put -I/usr/include into CFLAGS, since it can cause 313 include file problems. 314 3152. New Features in Readline 316 317a. Added extern declaration for rl_get_termcap to readline.h, making it a 318 public function (it was always there, just not in readline.h). 319 320b. New #defines in readline.h: RL_READLINE_VERSION, currently 0x0402, 321 RL_VERSION_MAJOR, currently 4, and RL_VERSION_MINOR, currently 2. 322 323c. New readline variable: rl_readline_version, mirrors RL_READLINE_VERSION. 324 325d. New bindable boolean readline variable: match-hidden-files. Controls 326 completion of files beginning with a `.' (on Unix). Enabled by default. 327 328e. The history expansion code now allows any character to terminate a 329 `:first-' modifier, like csh. 330 331f. The incremental search code remembers the last search string and uses 332 it if ^R^R is typed without a search string. 333 334h. New bindable variable `history-preserve-point'. If set, the history 335 code attempts to place the user at the same location on each history 336 line retrived with previous-history or next-history. 337 338------------------------------------------------------------------------------- 339This document details the changes between this version, readline-4.2, 340and the previous version, readline-4.1. 341 3421. Changes to Readline 343 344a. When setting the terminal attributes on systems using `struct termio', 345 readline waits for output to drain before changing the attributes. 346 347b. A fix was made to the history word tokenization code to avoid attempts to 348 dereference a null pointer. 349 350c. Readline now defaults rl_terminal_name to $TERM if the calling application 351 has left it unset, and tries to initialize with the resultant value. 352 353d. Instead of calling (*rl_getc_function)() directly to get input in certain 354 places, readline now calls rl_read_key() consistently. 355 356e. Fixed a bug in the completion code that allowed a backslash to quote a 357 single quote inside a single-quoted string. 358 359f. rl_prompt is no longer assigned directly from the argument to readline(), 360 but uses memory allocated by readline. This allows constant strings to 361 be passed to readline without problems arising when the prompt processing 362 code wants to modify the string. 363 364g. Fixed a bug that caused non-interactive history searches to return the 365 wrong line when performing multiple searches backward for the same string. 366 367h. Many variables, function arguments, and function return values are now 368 declared `const' where appropriate, to improve behavior when linking with 369 C++ code. 370 371i. The control character detection code now works better on systems where 372 `char' is unsigned by default. 373 374j. The vi-mode numeric argument is now capped at 999999, just like emacs mode. 375 376k. The Function, CPFunction, CPPFunction, and VFunction typedefs have been 377 replaced with a set of specific prototyped typedefs, though they are 378 still in the readline header files for backwards compatibility. 379 380m. Nearly all of the (undocumented) internal global variables in the library 381 now have an _rl_ prefix -- there were a number that did not, like 382 screenheight, screenwidth, alphabetic, etc. 383 384n. The ding() convenience function has been renamed to rl_ding(), though the 385 old function is still defined for backwards compatibility. 386 387o. The completion convenience functions filename_completion_function, 388 username_completion_function, and completion_matches now have an rl_ 389 prefix, though the old names are still defined for backwards compatibility. 390 391p. The functions shared by readline and bash (linkage is satisfied from bash 392 when compiling with bash, and internally otherwise) now have an sh_ prefix. 393 394q. Changed the shared library creation procedure on Linux and BSD/OS 4.x so 395 that the `soname' contains only the major version number rather than the 396 major and minor numbers. 397 398r. Fixed a redisplay bug that occurred when the prompt spanned more than one 399 physical line and contained invisible characters. 400 401s. Added a missing `includedir' variable to the Makefile. 402 403t. When installing the shared libraries, make sure symbolic links are relative. 404 405u. Added configure test so that it can set `${MAKE}' appropriately. 406 407v. Fixed a bug in rl_forward that could cause the point to be set to before 408 the beginning of the line in vi mode. 409 410w. Fixed a bug in the callback read-char interface to make it work when a 411 readline function pushes some input onto the input stream with 412 rl_execute_next (like the incremental search functions). 413 414x. Fixed a file descriptor leak in the history file manipulation code that 415 was tripped when attempting to truncate a non-regular file (like 416 /dev/null). 417 418y. Changes to make all of the exported readline functions declared in 419 readline.h have an rl_ prefix (rltty_set_default_bindings is now 420 rl_tty_set_default_bindings, crlf is now rl_crlf, etc.) 421 422z. The formatted documentation included in the base readline distribution 423 is no longer removed on a `make distclean'. 424 425aa. Some changes were made to avoid gcc warnings with -Wall. 426 427bb. rl_get_keymap_by_name now finds keymaps case-insensitively, so 428 `set keymap EMACS' works. 429 430cc. The history file writing and truncation functions now return a useful 431 status on error. 432 433dd. Fixed a bug that could cause applications to dereference a NULL pointer 434 if a NULL second argument was passed to history_expand(). 435 436ee. If a hook function assigned to rl_event_hook sets rl_done to a non-zero 437 value, rl_read_key() now immediately returns '\n' (which is assumed to 438 be bound to accept-line). 439 4402. New Features in Readline 441 442a. The blink timeout for paren matching is now settable by applications, 443 via the rl_set_paren_blink_timeout() function. 444 445b. _rl_executing_macro has been renamed to rl_executing_macro, which means 446 it's now part of the public interface. 447 448c. Readline has a new variable, rl_readline_state, which is a bitmap that 449 encapsulates the current state of the library; intended for use by 450 callbacks and hook functions. 451 452d. rlfe has a new -l option to log input and output (-a appends to logfile), 453 a new -n option to set the readline application name, and -v and -h 454 options for version and help information. 455 456e. rlfe can now perform filename completion for the inferior process if the 457 OS has a /proc/<PID>/cwd that can be read with readlink(2) to get the 458 inferior's current working directory. 459 460f. A new file, rltypedefs.h, contains the new typedefs for function pointers 461 and is installed by `make install'. 462 463g. New application-callable function rl_set_prompt(const char *prompt): 464 expands its prompt string argument and sets rl_prompt to the result. 465 466h. New application-callable function rl_set_screen_size(int rows, int cols): 467 public method for applications to set readline's idea of the screen 468 dimensions. 469 470i. The history example program (examples/histexamp.c) is now built as one 471 of the examples. 472 473j. The documentation has been updated to cover nearly all of the public 474 functions and variables declared in readline.h. 475 476k. New function, rl_get_screen_size (int *rows, int *columns), returns 477 readline's idea of the screen dimensions. 478 479l. The timeout in rl_gather_tyi (readline keyboard input polling function) 480 is now settable via a function (rl_set_keyboard_input_timeout()). 481 482m. Renamed the max_input_history variable to history_max_entries; the old 483 variable is maintained for backwards compatibility. 484 485n. The list of characters that separate words for the history tokenizer is 486 now settable with a variable: history_word_delimiters. The default 487 value is as before. 488 489o. There is a new history.3 manual page documenting the history library. 490 491------------------------------------------------------------------------------- 492This document details the changes between this version, readline-4.1, 493and the previous version, readline-4.0. 494 4951. Changes to Readline 496 497a. Changed the HTML documents so that the table-of-contents is no longer 498 a separate file. 499 500b. Changes to the shared object configuration for: Irix 5.x, Irix 6.x, 501 OSF/1. 502 503c. The shared library major and minor versions are now constructed 504 automatically by configure and substituted into the makefiles. 505 506d. It's now possible to install the shared libraries separately from the 507 static libraries. 508 509e. The history library tries to truncate the history file only if it is a 510 regular file. 511 512f. A bug that caused _rl_dispatch to address negative array indices on 513 systems with signed chars was fixed. 514 515g. rl-yank-nth-arg now leaves the history position the same as when it was 516 called. 517 518h. Changes to the completion code to handle MS-DOS drive-letter:pathname 519 filenames. 520 521i. Completion is now case-insensitive by default on MS-DOS. 522 523j. Fixes to the history file manipulation code for MS-DOS. 524 525k. Readline attempts to bind the arrow keys to appropriate defaults on MS-DOS. 526 527l. Some fixes were made to the redisplay code for better operation on MS-DOS. 528 529m. The quoted-insert code will now insert tty special chars like ^C. 530 531n. A bug was fixed that caused the display code to reference memory before 532 the start of the prompt string. 533 534o. More support for __EMX__ (OS/2). 535 536p. A bug was fixed in readline's signal handling that could cause infinite 537 recursion in signal handlers. 538 539q. A bug was fixed that caused the point to be less than zero when rl_forward 540 was given a very large numeric argument. 541 542r. The vi-mode code now gets characters via the application-settable value 543 of rl_getc_function rather than calling rl_getc directly. 544 545s. The history file code now uses O_BINARY mode when reading and writing 546 the history file on cygwin32. 547 548t. Fixed a bug in the redisplay code for lines with more than 256 line 549 breaks. 550 551u. A bug was fixed which caused invisible character markers to not be 552 stripped from the prompt string if the terminal was in no-echo mode. 553 554v. Readline no longer tries to get the variables it needs for redisplay 555 from the termcap entry if the calling application has specified its 556 own redisplay function. Readline treats the terminal as `dumb' in 557 this case. 558 559w. Fixes to the SIGWINCH code so that a multiple-line prompt with escape 560 sequences is redrawn correctly. 561 562x. Changes to the install and install-shared targets so that the libraries 563 and header files are installed separately. 564 5652. New Features in Readline 566 567a. A new Readline `user manual' is in doc/rluserman.texinfo. 568 569b. Parentheses matching is now always compiled into readline, and enabled 570 or disabled when the value of the `blink-matching-paren' variable is 571 changed. 572 573c. MS-DOS systems now use ~/_inputrc as the last-ditch inputrc filename. 574 575d. MS-DOS systems now use ~/_history as the default history file. 576 577e. history-search-{forward,backward} now leave the point at the end of the 578 line when the string to search for is empty, like 579 {reverse,forward}-search-history. 580 581f. history-search-{forward,backward} now leave the last history line found 582 in the readline buffer if the second or subsequent search fails. 583 584g. New function for use by applications: rl_on_new_line_with_prompt, used 585 when an application displays the prompt itself before calling readline(). 586 587h. New variable for use by applications: rl_already_prompted. An application 588 that displays the prompt itself before calling readline() must set this to 589 a non-zero value. 590 591i. A new variable, rl_gnu_readline_p, always 1. The intent is that an 592 application can verify whether or not it is linked with the `real' 593 readline library or some substitute. 594 595j. Per Bothner's `rlfe' (pronounced `Ralphie') readline front-end program 596 is included in the examples subdirectory, though it is not built 597 by default. 598 599------------------------------------------------------------------------------- 600This document details the changes between this version, readline-4.0, 601and the previous version, readline-2.2. 602 6031. Changes to Readline 604 605a. The version number is now 4.0, to match the major and minor version 606 numbers on the shared readline and history libraries. Future 607 releases will maintain the identical numbering. 608 609b. Fixed a typo in the `make install' recipe that copied libreadline.a 610 to libhistory.old right after installing it. 611 612c. The readline and history info files are now installed out of the source 613 directory if they are not found in the build directory. 614 615d. The library no longer exports a function named `savestring' -- backwards 616 compatibility be damned. 617 618e. There is no longer any #ifdef SHELL code in the source files. 619 620f. Some changes were made to the key binding code to fix memory leaks and 621 better support Win32 systems. 622 623g. Fixed a silly typo in the paren matching code -- it's microseconds, not 624 milliseconds. 625 626h. The readline library should be compilable by C++ compilers. 627 628i. The readline.h public header file now includes function prototypes for 629 all readline functions, and some changes were made to fix errors in the 630 source files uncovered by the use of prototypes. 631 632j. The maximum numeric argument is now clamped at 1000000. 633 634k. Fixes to rl_yank_last_arg to make it behave better. 635 636l. Fixed a bug in the display code that caused core dumps if the prompt 637 string length exceeded 1024 characters. 638 639m. The menu completion code was fixed to properly insert a single completion 640 if there is only one match. 641 642n. A bug was fixed that caused the display code to improperly display tabs 643 after newlines. 644 645o. A fix was made to the completion code in which a typo caused the wrong 646 value to be passed to the function that computed the longest common 647 prefix of the list of matches. 648 649p. The completion code now checks the value of rl_filename_completion_desired, 650 which is set by application-supplied completion functions to indicate 651 that filename completion is being performed, to decide whether or not to 652 call an application-supplied `ignore completions' function. 653 654q. Code was added to the history library to catch history substitutions 655 using `&' without a previous history substitution or search having been 656 performed. 657 658 6592. New Features in Readline 660 661a. There is a new script, support/shobj-conf, to do system-specific shared 662 object and library configuration. It generates variables for configure 663 to substitute into makefiles. The README file provides a detailed 664 explanation of the shared library creation process. 665 666b. Shared libraries and objects are now built in the `shlib' subdirectory. 667 There is a shlib/Makefile.in to control the build process. `make shared' 668 from the top-level directory is still the right way to build shared 669 versions of the libraries. 670 671c. rlconf.h is now installed, so applications can find out which features 672 have been compiled into the installed readline and history libraries. 673 674d. rlstdc.h is now an installed header file. 675 676e. Many changes to the signal handling: 677 o Readline now catches SIGQUIT and cleans up the tty before returning; 678 o A new variable, rl_catch_signals, is available to application writers 679 to indicate to readline whether or not it should install its own 680 signal handlers for SIGINT, SIGTERM, SIGQUIT, SIGALRM, SIGTSTP, 681 SIGTTIN, and SIGTTOU; 682 o A new variable, rl_catch_sigwinch, is available to application 683 writers to indicate to readline whether or not it should install its 684 own signal handler for SIGWINCH, which will chain to the calling 685 applications's SIGWINCH handler, if one is installed; 686 o There is a new function, rl_free_line_state, for application signal 687 handlers to call to free up the state associated with the current 688 line after receiving a signal; 689 o There is a new function, rl_cleanup_after_signal, to clean up the 690 display and terminal state after receiving a signal; 691 o There is a new function, rl_reset_after_signal, to reinitialize the 692 terminal and display state after an application signal handler 693 returns and readline continues 694 695f. There is a new function, rl_resize_terminal, to reset readline's idea of 696 the screen size after a SIGWINCH. 697 698g. New public functions: rl_save_prompt and rl_restore_prompt. These were 699 previously private functions with a `_' prefix. These functions are 700 used when an application wants to write a message to the `message area' 701 with rl_message and have the prompt restored correctly when the message 702 is erased. 703 704h. New function hook: rl_pre_input_hook, called just before readline starts 705 reading input, after initialization. 706 707i. New function hook: rl_display_matches_hook, called when readline would 708 display the list of completion matches. The new function 709 rl_display_match_list is what readline uses internally, and is available 710 for use by application functions called via this hook. 711 712j. New bindable function, delete-char-or-list, like tcsh. 713 714k. A new variable, rl_erase_empty_line, which, if set by an application using 715 readline, will cause readline to erase, prompt and all, lines on which the 716 only thing typed was a newline. 717 718l. There is a new script, support/shlib-install, to install and uninstall 719 the shared readline and history libraries. 720 721m. A new bindable variable, `isearch-terminators', which is a string 722 containing the set of characters that should terminate an incremental 723 search without being executed as a command. 724 725n. A new bindable function, forward-backward-delete-char. 726 727------------------------------------------------------------------------------- 728This document details the changes between this version, readline-2.2, 729and the previous version, readline-2.1. 730 7311. Changes to Readline 732 733a. Added a missing `extern' to a declaration in readline.h that kept 734 readline from compiling cleanly on some systems. 735 736b. The history file is now opened with mode 0600 when it is written for 737 better security. 738 739c. Changes were made to the SIGWINCH handling code so that prompt redisplay 740 is done better. 741 742d. ^G now interrupts incremental searches correctly. 743 744e. A bug that caused a core dump when the set of characters to be quoted 745 when completing words was empty was fixed. 746 747f. Fixed a problem in the readline test program rltest.c that caused a core 748 dump. 749 750g. The code that handles parser directives in inputrc files now displays 751 more error messages. 752 753h. The history expansion code was fixed so that the appearance of the 754 history comment character at the beginning of a word inhibits history 755 expansion for that word and the rest of the input line. 756 757i. The code that prints completion listings now behaves better if one or 758 more of the filenames contains non-printable characters. 759 760j. The time delay when showing matching parentheses is now 0.5 seconds. 761 762 7632. New Features in Readline 764 765a. There is now an option for `iterative' yank-last-arg handline, so a user 766 can keep entering `M-.', yanking the last argument of successive history 767 lines. 768 769b. New variable, `print-completions-horizontally', which causes completion 770 matches to be displayed across the screen (like `ls -x') rather than up 771 and down the screen (like `ls'). 772 773c. New variable, `completion-ignore-case', which causes filename completion 774 and matching to be performed case-insensitively. 775 776d. There is a new bindable command, `magic-space', which causes history 777 expansion to be performed on the current readline buffer and a space to 778 be inserted into the result. 779 780e. There is a new bindable command, `menu-complete', which enables tcsh-like 781 menu completion (successive executions of menu-complete insert a single 782 completion match, cycling through the list of possible completions). 783 784f. There is a new bindable command, `paste-from-clipboard', for use on Win32 785 systems, to insert the text from the Win32 clipboard into the editing 786 buffer. 787 788g. The key sequence translation code now understands printf-style backslash 789 escape sequences, including \NNN octal escapes. These escape sequences 790 may be used in key sequence definitions or macro values. 791 792h. An `$include' inputrc file parser directive has been added. 793