Bash-4.2 distribution sources and documentation
[platform/upstream/bash.git] / CHANGES
1 This document details the changes between this version, bash-4.2-release,
2 and the previous version, bash-4.2-rc2.
3
4 1.  Changes to Bash
5
6 a.  Fixed a bug that caused some variables to be clobbered by a longjmp,
7     resulting in stack corruption.
8
9 ------------------------------------------------------------------------------
10 This document details the changes between this version, bash-4.2-rc2,
11 and the previous version, bash-4.2-rc1.
12
13 1.  Changes to Bash
14
15 a.  Changes to bash_directory_completion_hook so that it's assigned to the
16     readline rl_directory_rewrite_hook variable, which modifies the directory
17     name passed to opendir without modifying the directory name the user
18     typed.
19
20 b.  Fixed bug in select builtin that caused it to not terminate correctly if
21     the read timed out due to $TMOUT.
22
23 c.  Fixed a problem that resulted in non-repeatable sequences of random
24     numbers when RANDOM=0.
25
26 ------------------------------------------------------------------------------
27 This document details the changes between this version, bash-4.2-rc1,
28 and the previous version, bash-4.2-beta.
29
30 1.  Changes to Bash
31
32 a.  Fixed a bug that caused some redirection errors to leak file descriptors.
33
34 b.  Fixed a bug that caused unary `+' and `-' arithmetic operators to have a
35     higher precedence than unary `!' and `~'.
36
37 c.  Fixed a bug that caused simple commands in a pipeline to affect the exit
38     status ($?) seen by subsequent pipeline commands.
39
40 d.  A number of cygwin-specific changes to avoid the use of text-mode files
41     and file access, and to make sure that \r is handled correctly.
42
43 e.  Fixed a bug that caused the read builtin to not return failure if an
44     attempt is made to assign to a readonly variable.
45
46 f.  Fixed a bug that caused some builtin usage messages to not be translated.
47
48 g.  Fixed a bug that caused the getopts builtin to not return failure if an
49     attempt is made to assign to a readonly variable.  Now it returns 2.
50
51 h.  Fixed the cd and pwd builtins to return failure if PWD is readonly and
52     cannot be assigned to.
53
54 i.  Added code to check the return value of access(2) on Solaris systems,
55     since it returns success for executable tests (e.g., `test -x') when
56     run by root, even if the file permissions don't allow execution.
57
58 2.  Changes to Readline
59
60 a.  Fixed a bug that caused directory names in words to be completed to not
61     be dequoted correctly.
62
63 3.  New Features in Bash
64
65 4.  New Features in Readline
66
67 ------------------------------------------------------------------------------
68 This document details the changes between this version, bash-4.2-beta,
69 and the previous version, bash-4.2-alpha.
70
71 1.  Changes to Bash
72
73 a.  Fixed a bug that caused the \W prompt string escape to not add a closing
74     NULL.
75
76 b.  Fixed a bug that caused partially-quoted words that were not subject to
77     word splitting to retained quoted NULLs.
78
79 c.  Added considerable efficiency speedups when pattern matching in multibyte
80     locales by skipping multibyte character functions where possible.
81
82 d.  Added considerable speedups to variable expansion when in multibyte locales.
83
84 e.  Fixed a bug that caused the expansion of $* when there are no positional
85     parameters to cause the shell to dump core when used in a pattern
86     matching context.
87
88 f.  Fixed a bug that caused variable expansions preceding regular builtins to
89     not change the shell environment during their execution.
90
91 2.  Changes to Readline
92
93 a.  Fixed a bug that made an explicit argument of 0 to yank-last-arg behave
94     as if it were a negative argument.
95
96 ------------------------------------------------------------------------------
97 This document details the changes between this version, bash-4.2-alpha,
98 and the previous version, bash-4.1-release.
99
100 1.  Changes to Bash
101
102 a.  Fixed a bug in the parser when processing alias expansions containing
103     quoted newlines.
104
105 b.  Fixed a memory leak in associative array expansion.
106
107 c.  Fixed a bug that caused quoted here-strings to be requoted when printed.
108
109 d.  Fixed a bug in arithmetic expansion that caused the index in an array
110     expansion to be evaluated twice under certain circumstances.
111
112 e.  Fixed several bugs with the expansion and display of variables that have
113     been given attributes but not values and are technically unset.
114
115 f.  Fixed a bug that caused core dumps when using filename completion that
116     expands to a filename containing a globbing character.
117
118 g.  Fixed a bug that caused assignment statements preceding a special builtin
119     when running in Posix mode to not persist after the builtin completed
120     when the special builtin was executed in a shell function without any
121     local variables.
122
123 h.  Fixed a bug that caused a command to remain in the hash table even after
124     `hash command' did not find anything if there was already an existing
125     hashed pathname.
126
127 i.  Fixed several bugs caused by executing unsafe functions from a signal
128     handler in the cases where a signal handler is executed immediately
129     rather than setting a flag for later execution.
130
131 j.  Fixed a bug that caused some internal flag variables to be set
132     incorrectly if `read -t' timed out.
133
134 k.  Fixed a Posix compatibility issue by making sure that a backslash escaping
135     a `}' within a double-quoted ${...} parameter expansion is removed as part
136     of the parameter expansion.
137
138 l.  Fixed a bug that caused execution of a trap to overwrite PIPESTATUS.
139
140 m.  Fixed a bug that caused here documents to not be displayed correctly
141     when attached to commands inside compound commands.
142
143 n.  Fixed a bug that caused the printf builtin to use the wrong precision
144     when using the `*' modifier.
145
146 o.  Fixed a bug that caused an arriving SIGCHLD to interrupt output functions
147     like those invoked by echo or printf.
148
149 p.  Changed to use a more robust mechanism than eaccess(2) when test is
150     checking filenames for execution permission.
151
152 q.  Fixed a bug that caused spurious semicolons to be added into the command
153     history in certain cases.
154
155 r.  Fixed a bug that caused the shell to free non-allocated memory when
156     unsetting element 0 of an associative array after it was assigned
157     implicitly.
158
159 s.  Fixed a bug that could cause the shell to dump core if using the `v'
160     vi editing command on a multi-line command.
161
162 t.  Fixed a bug that left FIFOs opened by process substitutions open long
163     enough to potentially cause file descriptor exhaustion when running a
164     shell function or shell builtin.
165
166 u.  Fixed a bug that caused the history expansion functions to not recognize
167     process substitution or extended glob patterns as single words.
168
169 v.  Fixed a bug that caused restricted shells to set a restricted command's
170     exit status incorrectly.
171
172 w.  Fixed a bug that caused bash to ignore the wrong set of filenames when
173     completing a command using the `complete-filename' readline command.
174
175 x.  Fixed a bug that caused a -PID argument following a -s sig or -n sig to
176     not be interpreted as a signal specification.
177
178 y.  Changed posix-mode behavior of a parse error in a `.' script or `eval'
179     command to exit the shell under Posix-specified conditions.  Previous
180     versions printed a warning.
181
182 z.  Fixed a bug in \W prompt expansion that resulted in incorrect expansion
183     in the event of overlapping strings.
184
185 aa. Fixed a bug that caused the := parameter expansion operator to return the
186     wrong value as the result of the expansion.
187
188 bb. When in Posix mode, a single quote is not treated specially in a
189     double-quoted ${...} expansion, unless the expansion operator is
190     # or % or the non-Posix `//', `^', and `,'.  In particular, it does
191     not define a new quoting context.  This is from Posix interpretation 221.
192
193 cc. Fixed a bug that inadvertently allowed program names containing slashes
194     to be entered into the command hash table.
195
196 dd. Fixed a bug that caused the select builtin to incorrectly compute the
197     display width of the arguments in the presence of multibyte characters.
198
199 ee. Fixed a bug that caused bash to not change the xtrace file descriptor if
200     BASH_XTRACEFD was found in the shell environment at startup.
201
202 ff. Fixed a memory leak in the pattern removal parameter expansion.
203
204 gg. Fixed a bug that caused SIGINT to fail to interrupt a nested loop if the
205     loop was in a pipeline.
206
207 hh. Fixed a problem in $(...) parsing that caused the parser to add an extra
208     space to a here-document delimiter if the first word contained a `/'.
209
210 ii. Fixed a bug that caused functions defined with the `function' reserved
211     word to require braces around the function body.
212
213 jj. Fixed a bug that caused bash to dump core when a variable expansion being
214     used as an array subscript failed.
215
216 kk. Fixed a bug that caused bash to dump core if the case-modification
217     expansions were used on a variable with a null value.
218
219 ll. Fixed a bug that caused partially-quoted strings to be split incorrectly
220     if a variable with a null value was expanded within double quotes.
221
222 mm. The pattern substitution word expansion has been sped up dramatically
223     when running in a locale with multibyte characters.
224
225 nn. Fixed a bug that caused history -a to not write the correct lines to
226     the history file if all the new lines in the history list were added
227     since the last time the history file was read or written.
228
229 oo. Fixed a bug that caused completion of a word with an unclosed `` command
230     substitution to set the prompt incorrectly.
231
232 pp. Fixed a bug that caused extended globbing patterns in $HISTIGNORE or
233     $GLOBIGNORE to be incorrectly scanned.
234
235 qq. Fixed a bug caused by closing file descriptors 3-20 on shell startup.  The
236     shell now sets them to close-on-exec.
237
238 rr. Fixed a bug that caused the exit status of `exec file' to be set incorrectly
239     if `file' was a directory.
240
241 ss. Fixed a bug in the `.' builtin to make a non-interactive posix-mode shell
242     exit if the file argument to `.' is not found.  Prefixing exec with 
243     `command' makes the shell not exit. Posix requires this behavior.
244
245 tt. Fixed a bug that caused `sh -c 'command exec; exit 1' to hang.
246
247 uu. Fixed a bug in $(...) command substitution parsing that caused the shell
248     to treat backslash-newline incorrectly when parsing a comment.
249
250 vv. Fixed bug that caused brace expansion sequence generation to misbehave
251     when supplied integers greater than 2**31 - 1.
252
253 ww. Fixed a bug that caused failure to save file descriptors for redirections
254     to corrupt shell file descriptors.
255
256 xx. Fixed a bug that caused bash-forward-shellword to not correctly handle
257     quoted strings.
258
259 2.  Changes to Readline
260
261 a.  Fixed a bug that caused the unconverted filename to be added to the list of
262     completions when the application specified filename conversion functions.
263
264 b.  Fixed a bug that caused the wrong filename to be passed to opendir when the
265     application has specified a filename dequoting function.
266
267 c.  Fixed a bug when repeating a character search in vi mode in the case where
268     there was no search to repeat.
269
270 d.  When show-all-if-ambiguous is set, the completion routines no longer insert
271     a common match prefix that is shorter than the text being completed.
272
273 e.  The full set of vi editing commands may now be used in callback mode.
274
275 f.  Fixed a bug that caused readline to not update its idea of the terminal
276     dimensions while running in `no-echo' mode.
277
278 h.  Fixed a bug that caused readline to dump core if an application called
279     rl_prep_terminal without setting rl_instream.
280
281 i.  Fixed a bug that caused meta-prefixed characters bound to incremental
282     search forward or backward to not be recognized if they were typed
283     subsequently.
284
285 j.  The incremental search code treats key sequences that map to the same
286     functions as (default) ^G, ^W, and ^Y as equivalent to those characters.
287
288 k.  Fixed a bug in menu-complete that caused it to misbehave with large
289     negative argument.
290
291 l.  Fixed a bug that caused vi-mode yank-last-arg to ring the bell when invoked
292     at the end of the line.
293
294 3.  New Features in Bash
295
296 a.  `exec -a foo' now sets $0 to `foo' in an executable shell script without a
297     leading #!.
298
299 b.  Subshells begun to execute command substitutions or run shell functions or
300     builtins in subshells do not reset trap strings until a new trap is
301     specified.  This allows $(trap) to display the caller's traps and the
302     trap strings to persist until a new trap is set.
303
304 c.  `trap -p' will now show signals ignored at shell startup, though their
305     disposition still cannot be modified.
306
307 d.  $'...', echo, and printf understand \uXXXX and \UXXXXXXXX escape sequences.
308
309 e.  declare/typeset has a new `-g' option, which creates variables in the
310     global scope even when run in a shell function.
311
312 f.  test/[/[[ have a new -v variable unary operator, which returns success if
313     `variable' has been set.
314
315 g.  Posix parsing changes to allow `! time command' and multiple consecutive
316     instances of `!' (which toggle) and `time' (which have no cumulative
317     effect).
318
319 h.  Posix change to allow `time' as a command by itself to print the elapsed
320     user, system, and real times for the shell and its children.
321
322 j.  $((...)) is always parsed as an arithmetic expansion first, instead of as
323     a potential nested command substitution, as Posix requires.
324
325 k.  A new FUNCNEST variable to allow the user to control the maximum shell
326     function nesting (recursive execution) level.
327
328 l.  The mapfile builtin now supplies a third argument to the callback command:
329     the line about to be assigned to the supplied array index.
330
331 m.  The printf builtin has a new %(fmt)T specifier, which allows time values
332     to use strftime-like formatting.
333
334 n.  There is a new `compat41' shell option.
335
336 o.  The cd builtin has a new Posix-mandated `-e' option.
337
338 p.  Negative subscripts to indexed arrays, previously errors, now are treated
339     as offsets from the maximum assigned index + 1.
340
341 q.  Negative length specifications in the ${var:offset:length} expansion,
342     previously errors, are now treated as offsets from the end of the variable.
343
344 r.  Parsing change to allow `time -p --'.
345
346 s.  Posix-mode parsing change to not recognize `time' as a keyword if the
347     following token begins with a `-'.  This means no more Posix-mode
348     `time -p'.  Posix interpretation 267.
349
350 t.  There is a new `lastpipe' shell option that runs the last command of a
351     pipeline in the current shell context.  The lastpipe option has no
352     effect if job control is enabled.
353
354 u.  History expansion no longer expands the `$!' variable expansion.
355
356 v.  Posix mode shells no longer exit if a variable assignment error occurs
357     with an assignment preceding a command that is not a special builtin.
358
359 w.  Non-interactive mode shells exit if -u is enabled and an attempt is made
360     to use an unset variable with the % or # expansions, the `//', `^', or
361     `,' expansions, or the parameter length expansion.
362
363 x.  Posix-mode shells use the argument passed to `.' as-is if a $PATH search
364     fails, effectively searching the current directory.  Posix-2008 change.
365
366 4.  New Features in Readline
367
368 a.  The history library does not try to write the history filename in the
369     current directory if $HOME is unset.  This closes a potential security
370     problem if the application does not specify a history filename.
371
372 b.  New bindable variable `completion-display-width' to set the number of
373     columns used when displaying completions.
374
375 c.  New bindable variable `completion-case-map' to cause case-insensitive
376     completion to treat `-' and `_' as identical.
377
378 d.  There are new bindable vi-mode command names to avoid readline's case-
379     insensitive matching not allowing them to be bound separately.
380
381 e.  New bindable variable `menu-complete-display-prefix' causes the menu
382     completion code to display the common prefix of the possible completions
383     before cycling through the list, instead of after.
384
385 ------------------------------------------------------------------------------
386 This document details the changes between this version, bash-4.1-rc,
387 and the previous version, bash-4.1-beta.
388
389 1.  Changes to Bash
390
391 a.  Fixed a bug that caused printf to not return a partial value when it
392     encountered an error while converting an integer argument.
393
394 b.  Fixed a bug that caused setting one of the compatNN options to not
395     turn off the others.
396
397 c.  The (undocumented) --wordexp option is no longer included by default.
398
399 d.  Fixed a bug in conditional command execution that caused it to not
400     correctly ignore the exit status under certain circumstances.
401
402 e.  Added a configure-time check for correctly-working asprintf/snprintf.
403
404 f.  Fixed some problems with line number calculation and display when sourcing
405     a file in an interactive shell.
406
407 g.  Fixed a bug that caused the shell to crash when using `declare -A foo=bar'.
408
409 h.  Fixed a bug that caused an off-by-one error when calculating the directories
410     to display with the PROMPT_DIRTRIM option.
411
412 2.  Changes to Readline
413
414 a.  Fixed a bug that caused applications using the callback interface to not
415     react to SIGINT (or other signals) until another character arrived.
416
417 ------------------------------------------------------------------------------
418 This document details the changes between this version, bash-4.1-beta,
419 and the previous version, bash-4.1-alpha.
420
421 1.  Changes to Bash
422
423 a.  Fixed a bug in mapfile that caused the shell to crash if it was passed the
424     name of an associative array.
425
426 b.  Fixed a bug that caused the shell to incorrectly split case patterns if
427     they contained characters in $IFS.
428
429 c.  Fixed a bug that caused the shell to set $? to the wrong value when using
430     a construct ending with a variable assignment with set -x enabled and PS4
431     containing a command substitution.
432
433 d.  Fixed a bug that caused the shell to read commands incorrectly if an
434     expansion error occurred under certain conditions in a user-specified
435     subshell.
436
437 e.  Fixed a bug that caused the shell to set $? incorrectly if a parse error
438     occurred in an evaluation context ("eval", trap command, dot script, etc.)
439
440 f.  Fixed a bug that caused the shell to attempt command substitution
441     completion within a single-quoted string.
442
443 g.  Fixed a bug that caused the shell to insert an extra single quote during
444     word completion.
445
446 h.  Fixed a bug that caused the shell to crash if invoked with the environment
447     variable EMACS having a null value.
448
449 i.  Fixed a bug that caused bash to incorrectly report the presence of new
450     mail in a `maildir' environment.
451
452 j.  Fixed a bug that caused the shell to not recognize a here-document ending
453     delimiter inside a command substitution.
454
455 k.  Fixed a bug that caused the shell to crash when a a dynamic array variable
456     was assigned a scalar value.
457
458 2.  Changes to Readline
459
460 3.  New Features in Bash
461
462 a.  The mapfile/readarray builtin no longer stores the commands it invokes via
463     callbacks in the history list.
464
465 b.  There is a new `compat40' shopt option.
466
467 c.  The < and > operators to [[ do string comparisons using the current locale
468     only if the compatibility level is greater than 40 (set to 41 by default).
469
470 4.  New Features in Readline
471
472 ------------------------------------------------------------------------------
473 This document details the changes between this version, bash-4.1-alpha,
474 and the previous version, bash-4.0-release.
475
476 1.  Changes to Bash
477
478 a.  Fixed bugs in the parser involving new parsing of the commands contained
479     in command substitution when the substitution is read.
480
481 b.  Fixed a bug that caused the shell to dump core when performing programmable
482     completion using a shell function.
483
484 c.  Fixed a bug in `mapfile' that caused it to invoke callbacks at the wrong
485     time.
486
487 d.  Fixed a bug that caused the shell to dump core when listing jobs in the
488     `exit' builtin.
489
490 e.  Fixed several bugs encountered when reading subscripts in associative
491     array assignments and expansions.
492
493 f.  Fixed a bug that under some circumstances caused an associative array to
494     be converted to an indexed array.
495
496 g.  Fixed a bug that caused syntax errors and SIGINT interrupts to not set
497     $? to a value > 128.
498
499 h.  Fixed a bug that caused the shell to remove FIFOs associated with process
500     substitution inside shell functions.
501
502 i.  Fixed a bug that caused terminal attributes to not be reset when the
503     `read' builtin timed out.
504
505 j.  Fixed a bug in brace expansion that caused unwanted zero padding of the
506     expanded terms.
507
508 k.  Fixed a bug that prevented the |& construct from working as intended when
509     used with a simple command with additional redirections.
510
511 l.  Fixed a bug with the case statment ;& terminator that caused the shell to
512     dereference a NULL pointer.
513
514 m.  Fixed a bug that caused assignment statements or redirections preceding
515     a simple command name to inhibit alias expansion.
516
517 n.  Fixed the behavior of `set -u' to conform to the latest Posix interpretation:
518     every expansion of an unset variable except $@ and $* will cause the
519     shell to exit.
520
521 o.  Fixed a bug that caused double-quoted expansions of $* inside word
522     expansions like ${x#$*} to not expand properly when $IFS is empty.
523
524 p.  Fixed a bug that caused traps to set $LINENO to the wrong value when they
525     execute.
526
527 q.  Fixed a bug that caused off-by-one errors when computing history lines in
528     the `fc' builtin.
529
530 r.  Fixed a bug that caused some terminating signals to not exit the shell
531     quickly enough, forcing the kernel to send the signal (e.g., SIGSEGV)
532     multiple times.
533
534 s.  Fixed a bug that caused the shell to attempt to add empty lines to the
535     history list when reading here documents.
536
537 t.  Made some internal changes that dramatically speeds up sequential indexed
538     array access.
539
540 u.  Fixed a bug that caused the shell to write past the end of a string when
541     completing a double-quoted string ending in a backslash.
542
543 v.  Fixed a bug that caused the shell to replace too many characters when a
544     pattern match was null in a ${foo//bar} expansion.
545
546 w.  Fixed bugs in the expansion of ** that caused duplicate directory names
547     and the contents of the current directory to be omitted.
548
549 x.  Fixed a bug that caused $? to not be set correctly when referencing an
550     unset variable with set -u and set -e enabled.
551
552 y.  Fixed a bug caused by executing an external program from the DEBUG trap
553     while a pipeline was running.  The effect was to disturb the pipeline
554     state, occasionally causing it to hang.
555
556 z.  Fixed a bug that caused the ** glob expansion to dump core if it
557     encountered an unsearchable directory.
558
559 aa. Fixed a bug that caused `command -v' and `command -V' to not honor the
560     path set by the -p option.
561
562 bb. Fixed a bug that caused brace expansion to take place too soon in some
563     compound array assignments.
564
565 cc. Fixed a bug that caused programmable completion functions' changes to
566     READLINE_POINT to not be reflected back to readline.
567
568 dd. Fixed a bug that caused the shell to dump core if a trap was executed
569     during a shell assignment statement.
570
571 ee. Fixed an off-by-one error when computing the number of positional
572     parameters for the ${@:0:n} expansion.
573
574 ff. Fixed a problem with setting COMP_CWORD for programmable completion
575     functions that could leave it set to -1.
576
577 gg. Fixed a bug that caused the ERR trap to be triggered in some cases where
578     `set -e' would not have caused the shell to exit.
579
580 hh. Fixed a bug that caused changes made by `compopt' to not persist past the
581     completion function in which compopt was executed.
582
583 ii. Fixed a bug that caused the list of hostname completions to not be cleared
584     when HOSTNAME was unset.
585
586 jj. Fixed a bug that caused variable expansion in here documents to look in
587     any temporary environment.
588
589 kk. Bash and readline can now convert file names between precomposed and
590     decomposed Unicode on Mac OS X ("keyboard" and file system forms,
591     respectively).  This affects filename completion (using new
592     rl_filename_rewrite_hook), globbing, and readline redisplay.
593
594 ll. The ERR and EXIT traps now see a non-zero value for $? when a parser
595     error after set -e has been enabled causes the shell to exit.
596
597 mm. Fixed a bug that in brace expansion that caused zero-prefixed terms to
598     not contain the correct number of digits.
599
600 nn. Fixed a bug that caused the shell to free non-allocated memory when
601     unsetting an associative array which had had a value implicitly assigned
602     to index "0".
603
604 oo. Fixed a memory leak in the ${!prefix@} expansion.
605
606 pp. Fixed a bug that caused printf to not correctly report all write errors.
607
608 qq. Fixed a bug that caused single and double quotes to act as delimiters
609     when splitting a command line into words for programmable completion.
610
611 rr. Fixed a bug that caused ** globbing that caused **/path/* to match every
612     directory, not just those matching `path'.
613
614 ss. Fixed a bug that caused the shell to dump core when running `help' without
615     arguments if the terminal width was fewer than 7 characters.
616
617 2.  Changes to Readline
618
619 a.  The SIGWINCH signal handler now avoids calling the redisplay code if
620     one arrives while in the middle of redisplay.
621
622 b.  Changes to the timeout code to make sure that timeout values greater
623     than one second are handled better.
624
625 c.  Fixed a bug in the redisplay code that was triggered by a prompt
626     containing invisible characters exactly the width of the screen.
627
628 d.  Fixed a bug in the redisplay code encountered when running in horizontal
629     scroll mode.
630
631 e.  Fixed a bug that prevented menu completion from properly completing
632     filenames.
633
634 f.  Fixed a redisplay bug caused by a multibyte character causing a line to
635     wrap.
636
637 g.  Fixed a bug that caused key sequences of two characters to not be
638     recognized when a longer sequence identical in the first two characters
639     was bound.
640
641 h.  Fixed a bug that caused history expansion to be attempted on $'...'
642     single-quoted strings.
643
644 i.  Fixed a bug that caused incorrect redisplay when the prompt contained
645     multibyte characters in an `invisible' sequence bracketed by \[ and
646     \].
647
648 j.  Fixed a bug that caused history expansion to short-circuit after
649     encountering a multibyte character.
650
651 3.  New Features in Bash
652
653 a.  Here-documents within $(...) command substitutions may once more be
654     delimited by the closing right paren, instead of requiring a newline.
655
656 b.  Bash's file status checks (executable, readable, etc.) now take file
657     system ACLs into account on file systems that support them.
658
659 c.  Bash now passes environment variables with names that are not valid
660     shell variable names through into the environment passed to child
661     processes.
662
663 d.  The `execute-unix-command' readline function now attempts to clear and
664     reuse the current line rather than move to a new one after the command
665     executes.
666
667 e.  `printf -v' can now assign values to array indices.
668
669 f.  New `complete -E' and `compopt -E' options that work on the "empty"
670     completion: completion attempted on an empty command line.
671
672 g.  New complete/compgen/compopt -D option to define a `default' completion:
673     a completion to be invoked on command for which no completion has been
674     defined.  If this function returns 124, programmable completion is
675     attempted again, allowing a user to dynamically build a set of completions
676     as completion is attempted by having the default completion function
677     install individual completion functions each time it is invoked.
678
679 h.  When displaying associative arrays, subscripts are now quoted.
680
681 i.  Changes to dabbrev-expand to make it more `emacs-like': no space appended
682     after matches, completions are not sorted, and most recent history entries
683     are presented first.
684
685 j.  The [[ and (( commands are now subject to the setting of `set -e' and the
686     ERR trap.
687
688 k.  The source/. builtin now removes NUL bytes from the file before attempting
689     to parse commands.
690
691 l.  There is a new configuration option (in config-top.h) that forces bash to
692     forward all history entries to syslog.
693
694 m.  A new variable $BASHOPTS to export shell options settable using `shopt' to
695     child processes.
696
697 n.  There is a new confgure option that forces the extglob option to be
698     enabled by default.
699
700 o.  New variable $BASH_XTRACEFD; when set to an integer bash will write xtrace
701     output to that file descriptor.
702
703 p.  If the optional left-hand-side of a redirection is of the form {var}, the
704     shell assigns the file descriptor used to $var or uses $var as the file
705     descriptor to move or close, depending on the redirection operator.
706
707 q.  The < and > operators to the [[ conditional command now do string
708     comparison according to the current locale.
709
710 r.  Programmable completion now uses the completion for `b' instead of `a'
711     when completion is attempted on a line like: a $(b c.
712
713 s.  Force extglob on temporarily when parsing the pattern argument to
714     the == and != operators to the [[ command, for compatibility.
715
716 t.  Changed the behavior of interrupting the wait builtin when a SIGCHLD is
717     received and a trap on SIGCHLD is set to be Posix-mode only.
718
719 u.  The read builtin has a new `-N nchars' option, which reads exactly NCHARS
720     characters, ignoring delimiters like newline.
721
722 4.  New Features in Readline
723
724 a.  New bindable function: menu-complete-backward.
725
726 b.  In the vi insertion keymap, C-n is now bound to menu-complete by default,
727     and C-p to menu-complete-backward.
728
729 c.  When in vi command mode, repeatedly hitting ESC now does nothing, even
730     when ESC introduces a bound key sequence.  This is closer to how
731     historical vi behaves.
732
733 d.  New bindable function: skip-csi-sequence.  Can be used as a default to
734     consume key sequences generated by keys like Home and End without having
735     to bind all keys.
736
737 e.  New application-settable function: rl_filename_rewrite_hook.  Can be used
738     to rewite or modify filenames read from the file system before they are
739     compared to the word to be completed.
740
741 f.  New bindable variable: skip-completed-text, active when completing in the
742     middle of a word.  If enabled, it means that characters in the completion
743     that match characters in the remainder of the word are "skipped" rather
744     than inserted into the line.
745
746 g.  The pre-readline-6.0 version of menu completion is available as
747     "old-menu-complete" for users who do not like the readline-6.0 version.
748
749 h.  New bindable variable: echo-control-characters.  If enabled, and the
750     tty ECHOCTL bit is set, controls the echoing of characters corresponding
751     to keyboard-generated signals.
752
753 i.  New bindable variable: enable-meta-key.  Controls whether or not readline
754     sends the smm/rmm sequences if the terminal indicates it has a meta key
755     that enables eight-bit characters.
756
757 ------------------------------------------------------------------------------
758 This document details the changes between this version, bash-4.0-release,
759 and the previous version, bash-4.0-rc1.
760
761 1.  Changes to Bash
762
763 a.  Changed the message printed when setlocale(3) fails to only include the
764     strerror error text if the call changes errno.
765
766 b.  Changed trap command execution to reset the line number before running a
767     trap (except DEBUG and RETURN traps).
768
769 c.  Fixed behavior of case-modifiying word expansions to not work on
770     individual words within a variable's value.
771
772 d.  Fixed a bug that caused mapfile to not be interruptible when run in an
773     interactive shell.
774
775 e.  Fixed a bug that caused mapfile to not run callbacks for the first line
776     read.
777
778 f.  Fixed a bug that caused mapfile to not honor EOF typed in an interactive
779     shell.
780
781 g.  Fixed the coprocess reaping code to not run straight from a signal handler.
782
783 h.  Fixed a bug that caused printf -b to ignore the first % conversion specifier
784     in the format string on 64-bit systems.
785
786 i.  Fixed a bug that caused incorrect word splitting when `:', `=', or `~'
787     appeared in $IFS.
788
789 j.  Fixed a bug that caused data corruption in the programmable completion code
790     when a shell function called from a completion aborted execution.
791
792 k.  Fixed a bug that caused the CPU usage reported by the `time' builtin to be
793     capped at 100%.
794
795 l.  Changed behavior of shell when -e option is in effect to reflect consensus
796     of Posix shell standardization working group.
797
798 m.  Fixed a bug introduced in bash-4.0-alpha that caused redirections to not
799     be displayed by `type' or `declare' when appearing in functions under
800     certain circumstances.
801
802 2.  Changes to Readline
803
804 a.  Fixed a bug that caused !(...) extended glob patterns to inhibit later
805     history expansion.
806
807 b.  Reworked the signal handling to avoid calling disallowed functions from a
808     signal handler.
809
810 3.  New Features in Bash
811
812 a.  `readarray' is now a synonym for `mapfile'.
813 ------------------------------------------------------------------------------
814 This document details the changes between this version, bash-4.0-rc1,
815 and the previous version, bash-4.0-beta2.
816
817 1.  Changes to Bash
818
819 a.  Fixed a bug that caused parsing errors when a $()-style command
820     substitution was follwed immediately by a quoted newline.
821
822 b.  Fixed a bug that caused extended shell globbing patterns beginning with
823     `*(' to not work when used with pattern substitution word expansions.
824  
825 ------------------------------------------------------------------------------
826 This document details the changes between this version, bash-4.0-beta2,
827 and the previous version, bash-4.0-beta.
828
829 1.  Changes to Bash
830
831 a.  Fixed a bug that caused failed word expansions to set $? but not
832     PIPESTATUS.
833
834 b.  Changed filename completion to quote the tilde in a filename with a
835     leading tilde that exists in the current directory.
836
837 c.  Fixed a bug that caused a file descriptor leak when performing
838     redirections attached to a compound command.
839
840 d.  Fixed a bug that caused expansions of $@ and $* to not exit the shell if
841     the -u option was enabled and there were no posititional parameters.
842
843 e.  Fixed a bug that resulted in bash not terminating immediately if a
844     terminating signal was received while performing output.
845
846 f.  Fixed a bug that caused the shell to crash after creating 256 process
847     substitutions during word completion.
848
849 2.  Changes to Readline
850
851 a.  Fixed a bug that caused redisplay errors when using prompts with invisible
852     characters and numeric arguments to a command in a multibyte locale.
853
854 b.  Fixed a bug that caused redisplay errors when using prompts with invisible
855     characters spanning more than two physical screen lines.
856
857 ------------------------------------------------------------------------------
858 This document details the changes between this version, bash-4.0-beta,
859 and the previous version, bash-4.0-alpha.
860
861 1.  Changes to Bash
862
863 a.  Fixed a typo that caused a variable to be used before initialization
864     while parsing Posix-style command substitutions.
865
866 b.  Fixed a bug that caused stray ^? when the expansion of a parameter used
867     as part of a pattern removal expansion is empty, but part of a non-
868     empty string.
869
870 c.  Fixed a bug that could cause strings not converted to numbers by strtol
871     to be treated as if the conversion had been successful.
872
873 d.  The `return' builtin now accepts no options and requires a `--' before
874     a negative return value, as Posix requires.
875
876 e.  Fixed a bug that caused local variables to be created with the empty
877     string for a value rather than no value.
878
879 f.  Changed behavior so the shell now acts as if it received an interrupt
880     when a pipeline is killed by SIGINT while executing a list.
881
882 g.  Fixed a bug that caused `declare var' and `typeset var' to initialize
883     `var' to the empty string.
884
885 h.  Changed `bind' builtin to print a warning but proceed if invoked when
886     line editing is not active.
887
888 i.  Fixed a bug that caused the shell to exit when the `errexit' option is
889     set and a command in a pipeline returns a non-zero exit status.
890
891 j.  Fixed a bug that caused the shell to not run the exit trap in a command
892     run with `bash -c' under some circumstances.
893
894 k.  Fixed a bug that caused parser errors to occasionally not set $? when
895     running commands with `eval'.
896
897 l.  Fixed a bug that caused stray control characters when evaluating compound
898     array assignments containing $'\x7f' escapes.
899
900 m.  Fixed a bug that caused redirections involving file descriptor 10 as the
901     target to behave incorrectly.
902
903 n.  Fixed a bug that could cause memory to be freed multiple times when
904     assigning to COMP_WORDBREAKS.
905
906 o.  Fixed a bug that could cause NULL pointer dereferences when COMP_WORDBREAKS
907     was unset.
908
909 2.  Changes to Readline
910
911 3.  New Features in Bash
912
913 a.  A value of 0 for the -t option to `read' now returns success if there is
914     input available to be read from the specified file descriptor.
915
916 b.  CDPATH and GLOBIGNORE are ignored when the shell is running in privileged
917     mode.
918
919 c.  New bindable readline functions shell-forward-word and shell-backward-word,
920     which move forward and backward words delimited by shell metacharacters
921     and honor shell quoting.
922
923 d.  New bindable readline functions shell-backward-kill-word and shell-kill-word
924     which kill words backward and forward, but use the same word boundaries
925     as shell-forward-word and shell-backward-word.
926
927 4.  New Features in Readline
928
929 a.  If the kernel supports it, readline displays special characters
930     corresponding to a keyboard-generated signal when the signal is received.
931
932 ------------------------------------------------------------------------------
933 This document details the changes between this version, bash-4.0-alpha,
934 and the previous version, bash-3.2-release.
935
936 1.  Changes to Bash
937
938 a.  Fixed several bugs in old-style `` command substitution parsing, including
939     comment parsing and quoted string handling.
940
941 b.  Fixed problems parsing arguments to the [[ command's =~ regular expression
942     matching operator:  metacharacter and whitespace parsing.
943
944 c.  Fixed a bug that caused the shell to inappropriately reuse high-numbered
945     file descriptors it used internally.
946
947 d.  Fixed a bug in pattern replacement word expansions that caused a `/' as
948     the first character of an expanded pattern to be mistaken for a global
949     replacement specifier.
950
951 e.  Fixed several problems with the asprintf and snprintf replacement functions
952     that caused hangs and crashes.
953
954 f.  Fixed a bug in the calculation of the current and previous job that caused
955     it to refer to incorrect jobs.
956
957 g.  Fixed a bug in the check for the validity of a hashed command pathname that
958     caused unnecessary hash table deletions and additions.
959
960 h.  Fixed a bug that caused child processes to inherit the wrong value for $!.
961
962 i.  Fixed a bug that caused `.' to fail to read and execute commands from non-
963     regular files such as devices or named pipes.
964
965 j.  Fixed a bug in printf formatting for the %x and %X expansions that occurred
966     on some systems.
967
968 k.  Fixed a bug that caused the shell to crash when creating temporary files if
969     $TMPDIR named a non-writable directory.
970
971 l.  Fixed a bug that caused the shell to ignore $TMPDIR when creating temporary
972     files under some circumstances.
973
974 m.  Fixed a bug that caused named pipes created by process substitution to not
975     be cleaned up.
976
977 n.  Fixed a bug that caused HISTTIMEFORMAT to not be honored when it appeared
978     in the initial shell environment.
979
980 o.  Fixed several bugs in the expansion of $* and $@ (quoted and unquoted)
981     when IFS is null or contains non-whitespace characters; the same changes
982     apply to arrays subscripted with * or @.
983
984 p.  Fixed several problems with pattern substitution expansions on the
985     positional parameters and arrays subscripted with * or @ that occurred
986     when $IFS was set to the empty string.
987
988 q.  Made a change to the default locale initialization code that should
989     result in better behavior from the locale-aware library functions.
990
991 r.  Fixed a bug that caused compacting the jobs list to drop jobs.
992
993 s.  Fixed a bug that caused jumps back to the top-level processing loop from
994     a builtin command to leave the shell in an inconsistent state.
995
996 t.  Fixed a bug that caused characters that would be escaped internally to be
997     doubled when escaped with a backslash.
998
999 u.  Fixed the initialization of mailboxes to not cause maildirs to be read
1000     (and stat(2) called for every message file) at shell startup.
1001
1002 v.  Fixed a bug that caused the shell to not display $PS2 when the read builtin
1003     reads a line continued with a backslash.
1004
1005 w.  Fixed a bug that caused errors in word splitting when $IFS contained
1006     characters used for internal quoting.
1007
1008 x.  Fixed bugs that caused problems with output from shell builtins not being
1009     completely displayed on some systems.
1010
1011 y.  Fixed a bug that caused output to be lost when a redirection is acting on
1012     the shell's output file descriptor.
1013
1014 z.  Fixed bugs caused by shell builtins not checking for all write errors.
1015
1016 aa. Fixed a problem that caused the shell to dump core if expansions on the
1017     pattern passed to the pattern removal word expansions resulted in expansion
1018     errors.
1019
1020 bb. Fixed a bug that caused bash to loop infinitely after creating and
1021     waiting for 4096 jobs.
1022
1023 cc. Fixed a bug that caused bash to lose the status of a background job under
1024     certain circumstances.
1025
1026 dd. Fixed a bug that caused bash to not look in the temporary environment
1027     when performing variable lookup under certain circumstances.
1028
1029 ee. Fixed a bug that caused bash to close file descriptors greater than 10
1030     when they were used in redirections.
1031
1032 ff. Fixed a problem that caused the shell to attempt to read from the standard
1033     input when called as `bash -i script'.
1034
1035 gg. Fixed a memory leak and variable initialization problems when the -v option
1036     was supplied to `printf' that could cause incorrect results.
1037
1038 hh. Fixed a bug that caused the `read' builtin to count bytes when the -n option
1039     was supplied, rather than (possibly multibyte) characters.
1040
1041 ii. Fixed a bug when displaying a function due to not converting the function
1042     to an external form.
1043
1044 jj. Changed job control initialization to ensure that the shell has a tty
1045     as its controlling terminal before enabling job control.
1046
1047 kk. Fixed a bug with the `test' builtin that caused it to misinterpret
1048     arguments beginning with `-' but containing more than one character.
1049
1050 ll. Fixed bug that could cause the shell to dump core in certain cases where
1051     a command sets the SIGINT disposition to the default.
1052
1053 mm. Fixed a bug in the pattern replacement (affecting both word expansion
1054     and the `fc' builtin) that occurred when the pattern and replacement
1055     strings were empty.
1056
1057 nn. Fixed a bug that caused an arithmetic evaluation error to disable all
1058     further evaluation.
1059
1060 oo. Fixed a bug in pathname expansion that caused it to interpret backslashes
1061     in the pathname as quoting characters.
1062
1063 pp. Fixed a bug in the replacement getcwd() implementation that could cause
1064     memory to be overwritten.
1065
1066 qq. When in Posix mode, the `ulimit' builtin now uses a block size of 512 for
1067     the `-c' and `-f' options.
1068
1069 rr. Brace expansion now allows process substitutions to pass through unchanged.
1070
1071 ss. Fixed a problem in the command name completion code to avoid quoting
1072     escaped special characters twice when the command name begins with a tilde.
1073
1074 tt. Fixed a problem in the printf builtin that resulted in single-byte
1075     output for the "'" escape, even when using multibyte characters.
1076
1077 uu. Fixed a bug that caused the failure exit status to be lost when redirections
1078     attached to a compound command failed.
1079
1080 vv. Fixed a bug that caused the internal random number generator to not be
1081     re-seeded correctly when creating a subshell.
1082
1083 ww. Fixed a bug that could cause the bash replacement getcwd to overwrite
1084     memory.
1085
1086 xx. Fixed a bug that caused the shell to not receive SIGINT if it was sent
1087     while the shell was waiting for a command substitution to terminate, and
1088     make sure the exit status is correct when it does.
1089
1090 yy. Fixed a bug that resulted in the second and subsequent children spawned
1091     by a shell begun to run a command substitution being placed into the
1092     wrong process group.
1093
1094 zz. Fixed a bug that caused the results of successful tilde expansion to be
1095     subject to pathname expansion and word splitting.
1096
1097 aaa. Fixed a bug that could cause the shell to hang if it encountered an
1098      error that caused it to jump back to the top processing loop during a
1099      command substitution or `eval' command.
1100
1101 bbb. Fixed a bug that caused the `read' builtin to use the tty's attributes
1102      instead of those of the file descriptor passed with the -u option when
1103      processing the -n and -d options.
1104
1105 ccc. Fixed a bug that caused incorrect expansion of ${array[@]:foo} if the
1106      first character of $IFS was not whitespace.
1107
1108 ddd. Fixed a bug that occurred when scanning for the ending delimiter of a
1109      ${parameter/pat/sub} expansion.
1110
1111 eee. Fixed a bug that caused the shell to inappropriately expand command
1112      substitutions in words when expanding directory names for completion.
1113
1114 fff. Fixed a bug that caused the `fc' builtin to look too far back in the
1115      history list under certain circumstances.
1116
1117 ggg. Fixed a bug that caused a shell running in Posix mode to search $PWD for
1118      a file specified as an argument to source/. when the file was not found
1119      in $PATH.
1120
1121 hhh. Fixed a bug that caused the shell to modify the case of a command word
1122      found via command completion when the shell was performing case-
1123      insensitive completion.
1124
1125 iii. Fixed a bug that caused the shell to search $PATH for an argument to
1126      source/. even when it contained a `/'.
1127
1128 jjj. Fixed a bug that caused brace expansion to misorder expansions when the
1129      locale did not have a collating order like aAbBcC...zZ.
1130
1131 kkk. Fixed a bug that did not allow `set +o history' to have any effect when
1132      run in a startup file or from a sourced file.
1133
1134 lll. Fixed a bug with the precedence of the ?: conditional arithmetic operator.
1135
1136 mmm. Fixed a bug that caused side effects of temporary variable assignments
1137      to persist in the shell environment.
1138
1139 nnn. Fixed a bug that caused the terminal to be left in non-canonical mode
1140      when using editing commands that invoke the an editor on the current
1141      command line.
1142
1143 ooo. Fixed a bug that caused globbing characters and characters in $IFS to not
1144      be quoted appropriately when displaying assignment statements.
1145
1146 ppp. Fixed a bug that caused the `-e' option to be inherited when sourcing a
1147      file or evaluating a command with `eval' even if the return value of the
1148      command was supposed to be ignored.
1149
1150 qqq. Fixed a bug that caused the shell to attempt to created variables with
1151      invalid names if such names appeared in the initial environment.
1152
1153 rrr. Fixed a bug with quote removal in strings where the final character is a
1154      backslash.
1155
1156 sss. Fixed a bug that caused the effects of special variables to persist even
1157      when the variables were unset as part of the shell reinitializing itself
1158      to execute a shell script.
1159
1160 ttt. Fixed a bug that caused the history to not be saved after `history -c' or
1161      `history -d' was executed until a sufficient number of commands had been
1162      saved to the history.
1163
1164 uuu. Bash now parses command substitutions according to Posix rules: parsing
1165      the command contained in $() to find the closing delimiter.
1166
1167 vvv. Fixed a bug that caused traps on SIGCHLD set in a SIGCHLD handler to
1168      not persist.
1169
1170 www. Fixed a bug that didn't allow SIGCHLD to interrupt the `wait' builtin
1171      as Posix specifies.
1172
1173 xxx. Invalid numeric arguments to shell builtins no longer cause the shell to
1174      short-circuit any executing compound command.
1175
1176 yyy. Fixed a bug that caused the exit status to be lost when `break' was
1177      used to short-circuit a loop's execution.
1178
1179 zzz. Fixed a bug that caused stray ^? characters to be left in expansions of
1180      "${array[*]}".
1181
1182 aaaa. Bash now prints better error messages for here documents terminated by
1183       EOF and for identifying the incorrect token in an invalid arithmetic
1184       expression.
1185
1186 bbbb. Fixed a bug in the variable length word expansion that caused it to
1187       incorrectly calculate the number of multibyte characters.
1188
1189 cccc. Fixed a race condition that could result in the top-level shell setting
1190       the terminal's process group to an incorrect value if the process
1191       group was changed by a child of a child of the shell.
1192
1193 dddd. Fixed a bug that caused here documents belonging to commands within a
1194       compound command to be displayed in a syntactially-incorrect form, which
1195       prevented them from being re-read as input.
1196
1197 eeee. The shell displays more warnings about failures to set the locale.
1198
1199 ffff. Fixed a bug that caused the body of a here-document to not be saved to
1200       the history list.
1201
1202 gggg. Fixed a bug that caused configure to incorrectly conclude that FreeBSD
1203       had /dev/fd available, resulting in problems with process substitution.
1204
1205 2.  Changes to Readline
1206
1207 a.  Fixed a number of redisplay errors in environments supporting multibyte 
1208     characters.
1209
1210 b.  Fixed bugs in vi command mode that caused motion commands to inappropriately
1211     set the mark.
1212
1213 c.  When using the arrow keys in vi insertion mode, readline allows movement
1214     beyond the current end of the line (unlike command mode).
1215
1216 d.  Fixed bugs that caused readline to loop when the terminal has been taken
1217     away and reads return -1/EIO.
1218
1219 e.  Fixed bugs in redisplay occurring when displaying prompts containing
1220     invisible characters.
1221
1222 f.  Fixed a bug that caused the completion append character to not be reset to
1223     the default after an application-specified completion function changed it.
1224
1225 g.  Fixed a problem that caused incorrect positioning of the cursor while in
1226     emacs editing mode when moving forward at the end of a line while using
1227     a locale supporting multibyte characters.
1228
1229 h.  Fixed an off-by-one error that caused readline to drop every 511th
1230     character of buffered input.
1231
1232 i.  Fixed a bug that resulted in SIGTERM not being caught or cleaned up.
1233
1234 j.  Fixed redisplay bugs caused by multiline prompts with invisible characters
1235     or no characters following the final newline.
1236
1237 k.  Fixed redisplay bug caused by prompts consisting solely of invisible
1238     characters.
1239
1240 l.  Fixed a bug in the code that buffers characters received very quickly in
1241     succession which caused characters to be dropped.
1242
1243 m.  Fixed a bug that caused readline to reference uninitialized data structures
1244     if it received a SIGWINCH before completing initialzation.
1245
1246 n.  Fixed a bug that caused the vi-mode `last command' to be set incorrectly
1247     and therefore unrepeatable.
1248
1249 o.  Fixed a bug that caused readline to disable echoing when it was being used
1250     with an output file descriptor that was not a terminal.
1251
1252 p.  Readline now blocks SIGINT while manipulating internal data structures
1253     during redisplay.
1254
1255 q.  Fixed a bug in redisplay that caused readline to segfault when pasting a
1256     very long line (over 130,000 characters).
1257
1258 r.  Fixed bugs in redisplay when using prompts with no visible printing
1259     characters.
1260
1261 3.  New Features in Bash
1262
1263 a.  When using substring expansion on the positional parameters, a starting
1264     index of 0 now causes $0 to be prefixed to the list.
1265
1266 b.  The `help' builtin now prints its columns with entries sorted vertically
1267     rather than horizontally.
1268
1269 c.  There is a new variable, $BASHPID, which always returns the process id of
1270     the current shell.
1271
1272 d.  There is a new `autocd' option that, when enabled, causes bash to attempt
1273     to `cd' to a directory name that is supplied as the first word of a
1274     simple command.
1275
1276 e.  There is a new `checkjobs' option that causes the shell to check for and
1277     report any running or stopped jobs at exit.
1278
1279 f.  The programmable completion code exports a new COMP_TYPE variable, set to
1280     a character describing the type of completion being attempted.
1281
1282 g.  The programmable completion code exports a new COMP_KEY variable, set to
1283     the character that caused the completion to be invoked (e.g., TAB).
1284
1285 h.  If creation of a child process fails due to insufficient resources, bash
1286     will try again several times before reporting failure.
1287
1288 i.  The programmable completion code now uses the same set of characters as
1289     readline when breaking the command line into a list of words.
1290
1291 j.  The block multiplier for the ulimit -c and -f options is now 512 when in
1292     Posix mode, as Posix specifies.
1293
1294 k.  Changed the behavior of the read builtin to save any partial input received
1295     in the specified variable when the read builtin times out.  This also
1296     results in variables specified as arguments to read to be set to the empty
1297     string when there is no input available.  When the read builtin times out,
1298     it returns an exit status greater than 128.
1299
1300 l.  The shell now has the notion of a `compatibility level', controlled by
1301     new variables settable by `shopt'.  Setting this variable currently
1302     restores the bash-3.1 behavior when processing quoted strings on the rhs
1303     of the `=~' operator to the `[[' command.
1304
1305 m.  The `ulimit' builtin now has new -b (socket buffer size) and -T (number
1306     of threads) options.
1307
1308 n.  The -p option to `declare' now displays all variable values and attributes
1309     (or function values and attributes if used with -f).
1310
1311 o.  There is a new `compopt' builtin that allows completion functions to modify
1312     completion options for existing completions or the completion currently
1313     being executed.
1314
1315 p.  The `read' builtin has a new -i option which inserts text into the reply
1316     buffer when using readline.
1317
1318 q.  A new `-E' option to the complete builtin allows control of the default
1319     behavior for completion on an empty line.
1320
1321 r.  There is now limited support for completing command name words containing
1322     globbing characters.
1323
1324 s.  Changed format of internal help documentation for all builtins to roughly
1325     follow man page format.
1326
1327 t.  The `help' builtin now has a new -d option, to display a short description,
1328     and a -m option, to print help information in a man page-like format.
1329
1330 u.  There is a new `mapfile' builtin to populate an array with lines from a
1331     given file.
1332
1333 v.  If a command is not found, the shell attempts to execute a shell function
1334     named `command_not_found_handle', supplying the command words as the
1335     function arguments.
1336
1337 w.  There is a new shell option: `globstar'.  When enabled, the globbing code
1338     treats `**' specially -- it matches all directories (and files within
1339     them, when appropriate) recursively.
1340
1341 x.  There is a new shell option: `dirspell'.  When enabled, the filename
1342     completion code performs spelling correction on directory names during
1343     completion.
1344
1345 y.  The `-t' option to the `read' builtin now supports fractional timeout
1346     values.
1347
1348 z.  Brace expansion now allows zero-padding of expanded numeric values and
1349     will add the proper number of zeroes to make sure all values contain the
1350     same number of digits.
1351
1352 aa. There is a new bash-specific bindable readline function: `dabbrev-expand'.
1353     It uses menu completion on a set of words taken from the history list.
1354
1355 bb. The command assigned to a key sequence with `bind -x' now sets two new
1356     variables in the environment of the executed command:  READLINE_LINE_BUFFER
1357     and READLINE_POINT.  The command can change the current readline line
1358     and cursor position by modifying READLINE_LINE_BUFFER and READLINE_POINT,
1359     respectively.
1360
1361 cc. There is a new &>> redirection operator, which appends the standard output
1362     and standard error to the named file.
1363
1364 dd. The parser now understands `|&' as a synonym for `2>&1 |', which redirects
1365     the standard error for a command through a pipe.
1366
1367 ee. The new `;&' case statement action list terminator causes execution to
1368     continue with the action associated with the next pattern in the
1369     statement rather than terminating the command.
1370
1371 ff. The new `;;&' case statement action list terminator causes the shell to
1372     test the next set of patterns after completing execution of the current
1373     action, rather than terminating the command.
1374
1375 gg. The shell understands a new variable: PROMPT_DIRTRIM.  When set to an
1376     integer value greater than zero, prompt expansion of \w and \W  will
1377     retain only that number of trailing pathname components and replace
1378     the intervening characters with `...'.
1379
1380 hh. There are new case-modifying word expansions: uppercase (^[^]) and
1381     lowercase (,[,]).  They can work on either the first character or
1382     array element, or globally.  They accept an optional shell pattern
1383     that determines which characters to modify.  There is an optionally-
1384     configured feature to include capitalization operators.
1385
1386 ii. The shell provides associative array variables, with the appropriate
1387     support to create, delete, assign values to, and expand them.
1388
1389 jj. The `declare' builtin now has new -l (convert value to lowercase upon
1390     assignment) and -u (convert value to uppercase upon assignment) options.
1391     There is an optionally-configurable -c option to capitalize a value at
1392     assignment.
1393
1394 kk. There is a new `coproc' reserved word that specifies a coprocess: an
1395     asynchronous command run with two pipes connected to the creating shell.
1396     Coprocs can be named.  The input and output file descriptors and the
1397     PID of the coprocess are available to the calling shell in variables
1398     with coproc-specific names.
1399
1400 4.  New Features in Readline
1401
1402 a.  A new variable, rl_sort_completion_matches; allows applications to inhibit
1403     match list sorting (but beware: some things don't work right if
1404     applications do this).
1405
1406 b.  A new variable, rl_completion_invoking_key; allows applications to discover
1407     the key that invoked rl_complete or rl_menu_complete.
1408
1409 c.  The functions rl_block_sigint and rl_release_sigint are now public and
1410     available to calling applications who want to protect critical sections
1411     (like redisplay).
1412
1413 d.  The functions rl_save_state and rl_restore_state are now public and
1414     available to calling applications; documented rest of readline's state
1415     flag values.
1416
1417 e.  A new user-settable variable, `history-size', allows setting the maximum
1418     number of entries in the history list.
1419
1420 f.  There is a new implementation of menu completion, with several improvements
1421     over the old; the most notable improvement is a better `completions
1422     browsing' mode.
1423
1424 g.  The menu completion code now uses the rl_menu_completion_entry_function
1425     variable, allowing applications to provide their own menu completion
1426     generators.
1427
1428 h.  There is support for replacing a prefix  of a pathname with a `...' when
1429     displaying possible completions.  This is controllable by setting the
1430     `completion-prefix-display-length' variable.  Matches with a common prefix
1431     longer than this value have the common prefix replaced with `...'.
1432
1433 i.  There is a new `revert-all-at-newline' variable.  If enabled, readline will
1434     undo all outstanding changes to all history lines when `accept-line' is
1435     executed.
1436
1437 ------------------------------------------------------------------------------
1438 This document details the changes between this version, bash-3.2-release,
1439 and the previous version, bash-3.2-beta.
1440
1441 1.  Changes to Bash
1442
1443 a.  Fixed a bug that caused the temporary environment passed to a command to
1444     affect the shell's environment under certain circumstances.
1445
1446 b.  Fixed a bug in the printf builtin that caused the %q format specifier to
1447     ignore empty string arguments.
1448
1449 c.  Improved multibyte character environment detection at configuration time.
1450
1451 d.  Fixed a bug in the read builtin that left spurious escape characters in the
1452     input after processing backslashes when assigning to an array variable.
1453
1454 2.  Changes to Readline
1455
1456 a.  Fixed a redisplay bug that occurred in multibyte-capable locales when the
1457     prompt was one character longer than the screen width.
1458 ------------------------------------------------------------------------------
1459 This document details the changes between this version, bash-3.2-beta,
1460 and the previous version, bash-3.2-alpha.
1461
1462 1.  Changes to Bash
1463
1464 a.  Changed the lexical analyzer to treat locale-specific blank characters as
1465     white space.
1466
1467 b.  Fixed a bug in command printing to avoid confusion between redirections and
1468     process substitution.
1469
1470 c.  Fixed problems with cross-compiling originating from inherited environment
1471     variables.
1472
1473 d.  Added write error reporting to printf builtin.
1474
1475 e.  Fixed a bug in the variable expansion code that could cause a core dump in
1476     a multi-byte locale.
1477
1478 f.  Fixed a bug that caused substring expansion of a null string to return
1479     incorrect results.
1480
1481 g.  BASH_COMMAND now retains its previous value while executing commands as the
1482     result of a trap, as the documentation states.
1483
1484 2.  Changes to Readline
1485
1486 a.  Fixed a bug with prompt redisplay in a multi-byte locale to avoid redrawing
1487     the prompt and input line multiple times.
1488
1489 b.  Fixed history expansion to not be confused by here-string redirection.
1490
1491 c.  Readline no longer treats read errors by converting them to newlines, as
1492     it does with EOF.  This caused partial lines to be returned from readline().
1493
1494 ------------------------------------------------------------------------------
1495 This document details the changes between this version, bash-3.2-alpha,
1496 and the previous version, bash-3.1-release.
1497
1498 1.  Changes to Bash
1499
1500 a.  Fixed a source bug that caused the minimal configuration to not compile.
1501
1502 b.  Fixed memory leaks in error handling for the `read' builtin.
1503
1504 c.  Changed the [[ and (( compound commands to set PIPESTATUS with their exit
1505     status.
1506
1507 d.  Fixed some parsing problems with compound array assignments.
1508
1509 e.  Added additional configuration changes for: NetBSD (incomplete multibyte
1510     character support)
1511
1512 f.  Fixed two bugs with local array variable creation when shadowing a variable
1513     of the same name from a previous context.
1514
1515 g.  Fixed the `read' builtin to restore the correct set of completion functions
1516     if a timeout occurs.
1517
1518 h.  Added code to defer the initialization of HISTSIZE (and its stifling of the
1519     history list) until the history file is loaded, allowing a startup file to
1520     override the default value.
1521
1522 i.  Tightened up the arithmetic expression parsing to produce better error
1523     messages when presented with invalid operators.
1524
1525 j.  Fixed the cross-compilation support to build the signal list at shell
1526     invocation rather than compile time if cross-compiling.
1527
1528 k.  Fixed multibyte support for non-gcc compilers (or compilers that do not
1529     allow automatic array variable sizing based on a non-constant value).
1530
1531 l.  Several fixes to the code that manages the list of terminated jobs and
1532     their exit statuses, and the list of active and recently-terminated jobs
1533     to avoid pid aliasing/wraparound and allocation errors.
1534
1535 m.  Fixed a problem that allowed scripts to die due to SIGINT while waiting
1536     for children, even when started in the background or otherwise ignoring
1537     SIGINT.
1538
1539 n.  Fixed a bug that caused shells invoked as -/bin/bash from not being
1540     recognized as login shells.
1541
1542 o.  Fixed a problem that caused shells in the background to give the terminal
1543     to a process group other than the foreground shell process group.
1544
1545 p.  Fixed a problem with extracting the `varname' in ${#varname}.
1546
1547 q.  Fixed the code that handles SIGQUIT to not exit immediately -- thereby
1548     calling functions that may not be called in a signal handler context --
1549     but set a flag and exit afterward (like SIGINT).
1550
1551 r.  Changed the brace expansion code to skip over braces that don't begin a
1552     valid matched brace expansion construct.
1553
1554 s.  Fixed `typeset' and `declare' to not require that their shell function
1555     operands to be valid shell identifiers.
1556
1557 t.  Changed `test' to use access(2) with a temporary uid/euid swap when testing
1558     file attributes and running setuid, and access(2) in most other cases.
1559
1560 u.  Changed completion code to not attempt command name completion on a line
1561     consisting solely of whitespace when no_empty_command_completion is set.
1562
1563 v.  The `hash' builtin now prints nothing in posix mode when the hash table is
1564     empty, and prints a message to that effect to stdout instead of stderr
1565     when not in posix mode.
1566
1567 w.  Fixed a bug in the extended pattern matching code that caused it to fail to
1568     match periods with certain patterns.
1569
1570 x.  Fixed a bug that caused the shell to dump core when performing filename
1571     generation in directories with thousands of files.
1572
1573 y.  Returned to the original Bourne shell rules for parsing ``:  no recursive
1574     parsing of embedded quoted strings or ${...} constructs.
1575
1576 z.  The inheritence of the DEBUG, RETURN, and ERR traps is now dependent only
1577     on the settings of the `functrace' and `errtrace' shell options, rather
1578     than whether or not the shell is in debugging mode.
1579
1580 aa. Fixed a problem with $HOME being converted to ~ in the expansion of
1581     members of the DIRSTACK array.
1582
1583 bb. Fixed a problem with quoted arguments to arithmetic expansions in certain
1584     constructs.
1585
1586 cc. The command word completion code now no longer returns matching directories
1587     while searching $PATH.
1588
1589 dd. Fixed a bug with zero-padding and precision handling in snprintf()
1590     replacement.
1591
1592 ee. Fixed a bug that caused the command substitution code not to take embedded
1593     shell comments into account.
1594
1595 ff. Fixed a bug that caused $((...);(...)) to be misinterpreted as an
1596     arithmetic substitution.
1597
1598 gg. Fixed a bug in the prompt expansion code that inappropriately added a
1599     \001 before a \002 under certain circumstances.
1600
1601 hh. Fixed a bug that caused `unset LANG' to not properly reset the locale
1602     (previous versions would set the locale back to what it was when bash
1603     was started rather than the system's "native" locale).
1604
1605 ii. Fixed a bug that could cause file descriptors > 10 to not be closed even
1606     when closed explicitly by a script.
1607
1608 jj. Fixed a bug that caused single quotes to be stripped from ANSI-C quoting
1609     inside double-quoted command substitutions.
1610
1611 kk. Fixed a bug that could cause core dumps when `return' was executed as the
1612     last element of a pipeline inside a shell function.
1613
1614 ll. Fixed a bug that caused DEBUG trap strings to overwrite commands stored in
1615     the jobs list.
1616
1617 2.  Changes to Readline
1618
1619 a.  Fixed a problem that caused segmentation faults when using readline in
1620     callback mode and typing consecutive DEL characters on an empty line.
1621
1622 b.  Fixed several redisplay problems with multibyte characters, all having to
1623     do with the different code paths and variable meanings between single-byte
1624     and multibyte character redisplay.
1625
1626 c.  Fixed a problem with key sequence translation when presented with the
1627     sequence \M-\C-x.
1628
1629 d.  Fixed a problem that prevented the `a' command in vi mode from being
1630     undone and redone properly.
1631
1632 e.  Fixed a problem that prevented empty inserts in vi mode from being undone
1633     properly.
1634
1635 f.  Fixed a problem that caused readline to initialize with an incorrect idea
1636     of whether or not the terminal can autowrap.
1637
1638 g.  Fixed output of key bindings (like bash `bind -p') to honor the setting of
1639     convert-meta and use \e where appropriate.
1640
1641 h.  Changed the default filename completion function to call the filename
1642     dequoting function if the directory completion hook isn't set.  This means
1643     that any directory completion hooks need to dequote the directory name,
1644     since application-specific hooks need to know how the word was quoted,
1645     even if no other changes are made.
1646
1647 i.  Fixed a bug with creating the prompt for a non-interactive search string
1648     when there are non-printing characters in the primary prompt.
1649
1650 j.  Fixed a bug that caused prompts with invisible characters to be redrawn
1651     multiple times in a multibyte locale.
1652
1653 k.  Fixed a bug that could cause the key sequence scanning code to return the
1654     wrong function.
1655
1656 l.  Fixed a problem with the callback interface that caused it to fail when
1657     using multi-character keyboard macros.
1658
1659 m.  Fixed a bug that could cause a core dump when an edited history entry was
1660     re-executed under certain conditions.
1661
1662 n.  Fixed a bug that caused readline to reference freed memory when attmpting
1663     to display a portion of the prompt.
1664
1665 3.  New Features in Bash
1666
1667 a.  Changed the parameter pattern replacement functions to not anchor the
1668     pattern at the beginning of the string if doing global replacement - that
1669     combination doesn't make any sense.
1670
1671 b.  When running in `word expansion only' mode (--wordexp option), inhibit
1672     process substitution.
1673
1674 c.  Loadable builtins now work on MacOS X 10.[34].
1675
1676 d.  Shells running in posix mode no longer set $HOME, as POSIX requires.
1677
1678 e.  The code that checks for binary files being executed as shell scripts now
1679     checks only for NUL rather than any non-printing character.
1680
1681 f.  Quoting the string argument to the [[ command's  =~ operator now forces
1682     string matching, as with the other pattern-matching operators.
1683
1684 4.  New Features in Readline
1685
1686 a.  Calling applications can now set the keyboard timeout to 0, allowing
1687     poll-like behavior.
1688
1689 b.  The value of SYS_INPUTRC (configurable at compilation time) is now used as
1690     the default last-ditch startup file.
1691
1692 c.  The history file reading functions now allow windows-like \r\n line
1693     terminators.
1694
1695 ------------------------------------------------------------------------------
1696 This document details the changes between this version, bash-3.1-release,
1697 and the previous version, bash-3.1-rc2.
1698
1699 1.  Changes to Readline
1700
1701 a.  Several changes to the multibyte redisplay code to fix problems with
1702     prompts containing invisible characters.
1703
1704 ------------------------------------------------------------------------------
1705 This document details the changes between this version, bash-3.1-rc2,
1706 and the previous version, bash-3.1-rc1.
1707
1708 1.  Changes to Bash
1709
1710 a.  Fixed a bug that caused a DEBUG trap to overwrite a command string that's
1711     eventually attached to a background job.
1712
1713 b.  Changed some code so that filenames with leading tildes with spaces in the
1714     name aren't tilde-expanded by the bash completion code.
1715
1716 c.  Fixed a bug that caused the pushd builtin to fail to change to
1717     directories with leading `-'.
1718
1719 d.  Fixed a small memory leak in the programmable completion code.
1720
1721 2.  Changes to Readline
1722
1723 a.  Fixed a redisplay bug caused by moving the cursor vertically to a line
1724     with invisible characters in the prompt in a multibyte locale.
1725
1726 b.  Fixed a bug that could cause the terminal special chars to be bound in the
1727     wrong keymap in vi mode.
1728
1729 3.  New Features in Bash
1730
1731 a.  If compiled for strict POSIX conformance, LINES and COLUMNS may now
1732     override the true terminal size.
1733
1734 4.  New Features in Readline
1735
1736 a.  A new external application-controllable variable that allows the LINES
1737     and COLUMNS environment variables to set the window size regardless of
1738     what the kernel returns.
1739
1740 ------------------------------------------------------------------------------
1741 This document details the changes between this version, bash-3.1-rc1,
1742 and the previous version, bash-3.1-beta1.
1743
1744 1.  Changes to Bash
1745
1746 a.  Fixed a bug that could cause core dumps due to accessing the current
1747     pipeline while in the middle of modifying it.
1748
1749 b.  Fixed a bug that caused pathnames with backslashes still quoting characters
1750     to be passed to opendir().
1751
1752 c.  Command word completion now obeys the setting of completion-ignore-case.
1753
1754 d.  Fixed a problem with redirection that caused file descriptors greater than
1755     2 to be inappropriately marked as close-on-exec.
1756
1757 e.  In Posix mode, after `wait' is called to wait for a particular process
1758     explicitly, that process is removed from the list of processes known to
1759     the shell, and subsequent attempts to wait for it return errors.
1760
1761 f.  Fixed a bug that caused extended pattern matching to incorrectly scan
1762     backslash-escaped pattern characters.
1763
1764 g.  Fixed a synchronization problem that could cause core dumps when handling
1765     a SIGWINCH.
1766
1767 h.  Fixed a bug that caused an unmatched backquote to be accepted without an
1768     error when processing here documents.
1769
1770 i.  Fixed a small memory leak in the `cd' builtin.
1771
1772 j.  Fix for MacOS X so it gets the values for the HOSTTYPE, MACHTYPE, and
1773     OSTYPE variables at build time, to support universal binaries.
1774
1775 k.  Fixed a bug that could cause an exit trap to return the exit status of
1776     the trap command rather than the status as it was before the trap was
1777     run as the shell's exit status.
1778
1779 2.  New Features in Bash
1780
1781 3.  Changes to Readline
1782
1783 a.  Fixed a bug that caused reversing the incremental search direction to
1784     not work correctly.
1785
1786 b.  Fixed the vi-mode `U' command to only undo up to the first time insert mode
1787     was entered, as Posix specifies.
1788
1789 c.  Fixed a bug in the vi-mode `r' command that left the cursor in the wrong
1790     place.
1791
1792 4.  New Features in Readline
1793
1794 a.  New application-callable auxiliary function, rl_variable_value, returns
1795     a string corresponding to a readline variable's value.
1796
1797 b.  When parsing inputrc files and variable binding commands, the parser
1798     strips trailing whitespace from values assigned to boolean variables
1799     before checking them.
1800
1801
1802 ------------------------------------------------------------------------------
1803 This document details the changes between this version, bash-3.1-beta1,
1804 and the previous version, bash-3.1-alpha1.
1805
1806 1.  Changes to Bash
1807
1808 a.  Added some system-specific signal names.
1809
1810 b.  Fixed a typo in the ulimit builtin to make `x' the right option to
1811     maniuplate the limit on file locks.
1812
1813 c.  Fixed a problem with using += to append to index 0 of an array variable
1814     when not using subscript syntax.
1815
1816 d.  A few changes to configure.in to remove calls to obsolete or outdated
1817     macros.
1818
1819 e.  Make sure changes to variables bash handles specially (e.g., LC_ALL) are
1820     made when the variable is set in the temporary environment to a command.
1821
1822 f.  Make sure changes to variables bash handles specially (e.g., LC_ALL) are
1823     made when the variable is modified using `printf -v'.
1824
1825 g.  The export environment is now remade on cygwin when HOME is changed, so
1826     DLLs bash is linked against pick up the new value.  This fixes problems
1827     with tilde expansion when linking against and already-installed readline.
1828
1829 h.  Small fix to the logic for performing tilde expansion in posix mode, so
1830     expansion on the right-hand side of an assignment statement takes place.
1831
1832 i.  Fixed a bug that prevented redirections associated with a shell function
1833     from being executed when in a subshell.
1834
1835 j.  Fixed `source' and `.' builtins to not require an executable file when
1836     searching $PATH for a file to source.
1837
1838 k.  Fixed a bug that caused incorrect word splitting in a function when IFS
1839     was declared local, then unset.
1840
1841 l.  Fixed a problem with the `kill' builtin that prevented sending signals
1842     to a process group under certain circumstances when providing a pid < 0.
1843
1844 m.  When in POSIX mode, `pwd' now checks that the value it prints is the same
1845     directory as `.', even when displaying $PWD.
1846
1847 n.  Fixed a problem with the `read' builtin when reading a script from standard
1848     input and reading data from the same file.
1849
1850 o.  Fixed a problem with the `type' and `command' builtins that caused absolute
1851     pathnames to be displayed incorrectly.
1852
1853 p.  Some changes to the `bg' builtin for POSIX conformance.
1854
1855 q.  The `fc' builtin now removes the `fc' command that caused it to invoke an
1856     editor on specified history entries from the history entirely, rather than
1857     simply ignoring it.
1858
1859 r.  When in POSIX mode, the `v' command in vi editing mode simply invokes vi
1860     on the current command, rather than checking $FCEDIT and $EDITOR.
1861
1862 s.  Fixed a small memory leak in the pathname canonicalization code.
1863
1864 t.  Fixed a bug that caused the expanded value of a $'...' string to be
1865     incorrectly re-quoted if it occurred within a double-quoted ${...}
1866     parameter expansion.
1867
1868 u.  Restored default emacs-mode key binding of M-TAB to dynamic-complete-history.
1869
1870 v.  Fixed a bug that caused core dumps when interrupting loops running builtins
1871     on some systems.
1872
1873 w.  Make sure that some of the functions bash provides replacements for are
1874     not cpp defines.
1875
1876 x.  The code that scans embedded commands for the parser (`...` and $(...)) is
1877     now more aware of embedded comments and their effect on quoted strings.
1878
1879 y.  Changed the `-n' option to the `history' builtin to not reset the number of
1880     history lines read in the current session after reading the new lines from
1881     the history file if the history is being appended when it is written to
1882     the file, since the appending takes care of the problem that the adjustment
1883     was intended to solve.
1884
1885 z.  Improved the error message displayed when a shell script fails to execute
1886     because the environment and size of command line arguments are too large.
1887
1888 aa. A small fix to make sure that $HISTCMD is evaluated whenever the shell is
1889     saving commands to the history list, not just when HISTSIZE is defined.
1890
1891 2.  Changes to Readline
1892
1893 a.  The `change-case' command now correctly changes the case of multibyte
1894     characters.
1895
1896 b.  Changes to the shared library construction scripts to deal with Windows
1897     DLL naming conventions for Cygwin.
1898
1899 c.  Fixed the redisplay code to avoid core dumps resulting from a poorly-timed
1900     SIGWINCH.
1901
1902 d.  Fixed the non-incremental search code in vi mode to dispose of any current
1903     undo list when copying a line from the history into the current editing
1904     buffer.
1905
1906 e.  The variable assignment code now ignores whitespace at the end of lines
1907     when assigning to boolean variables.
1908
1909 f.  The `C-w' binding in incremental search now understands multibyte
1910     characters.
1911
1912 3.  New Features in Bash
1913
1914 a.  A new configuration option, `--enable-strict-posix-default', which will
1915     build bash to be POSIX conforming by default.
1916
1917 4.  New Features in Readline
1918
1919 a.  If the rl_completion_query_items is set to a value < 0, readline never
1920     asks the user whether or not to view the possible completions.
1921
1922 ------------------------------------------------------------------------------
1923 This document details the changes between this version, bash-3.1-alpha1,
1924 and the previous version, bash-3.0-release.
1925
1926 1.  Changes to Bash
1927
1928 a.  Fixed a bug that caused bash to crash if referencing an unset local array.
1929
1930 b.  Fixed a problem that caused tilde expansion to not be performed before
1931     attempting globbing word completion.
1932
1933 c.  Fixed an incompatibility so that a first argument to trap that's a valid
1934     signal number will be trated as a signal rather than a command to execute.
1935
1936 d.  Fixed ${#word} expansion to correctly compute the length of a string
1937     containing multibyte characters.
1938
1939 e.  Fixed a bug that caused bash to not pass the correct flags for signal
1940     disposition to child processes.
1941
1942 f.  Fixed a bug that caused `fc -l' to list one too many history entries.
1943
1944 g.  Some fixes to `fc' for POSIX conformance.
1945
1946 h.  Some fixes to job status display for POSIX conformance.
1947
1948 i.  Fixed a bug that caused `command -v' to display output if a command was not
1949     found -- it should be silent.
1950
1951 j.  In POSIX mode, `type' and `command -[vV]' do not report non-executable
1952     files, even if the shell will attempt to execute them.
1953
1954 k.  Fixed a bug that caused the `==' operator to the [[ command to not attempt
1955     extended pattern matching.
1956
1957 l.  Fixed the brace expansion code to handle characters whose value exceeds 128.
1958
1959 m.  Fixed `printf' to handle strings with a leading `\0' whose length is
1960     non-zero.
1961
1962 n.  Fixed a couple of problems with brace expansion where `${' was handled
1963     incorrectly.
1964
1965 o.  Fixed off-by-one error when calculating the upper bound of `offset' when
1966     processing the ${array[@]:offset:length} expansion.
1967
1968 p.  System-specific configuration changes for: FreeBSD 5.x, Interix, MacOS X
1969     10.4, Linux 2.4+ kernels, Linux 3.x kernels, Dragonfly BSD, QNX 6.x,
1970     Cygwin
1971
1972 q.  Fixed a bug that caused the shell to ignore the status of the rightmost
1973     command in a pipeline when the `pipefail' option was enabled.
1974
1975 r.  Fixed a completion bug that caused core dumps when expanding a directory
1976     name.
1977
1978 s.  Fixed a bug that prevented `hash -d' from removing commands from the hash
1979     table.
1980
1981 t.  Fixed word splitting to avoid really bad quadratic performance when
1982     expanding long lists.
1983
1984 u.  Fixed a bug that caused negative offsets in substring expansion to use the
1985     wrong values.
1986
1987 v.  Fixed a bug in printf that caused it to not return failure on write errors.
1988
1989 w.  Fixed a bug that caused commands in subshells to not be properly timed.
1990
1991 x.  The shell parser no longer attempts to parse a compound assignment specially
1992     unless in a position where an assignment statement is acceptable or parsing
1993     arguments to a builtin that accepts assignment statements.
1994
1995 y.  Fixed a problem that caused a `case' statement to be added to the history
1996     incorrectly as a single command if the `case word' was on one line and the
1997     `in' on another.
1998
1999 z.  Fixed a problem that caused internal shell quoting characters to be
2000     incorrectly quoted with backslashes under some circumstances.
2001
2002 aa. The shell now performs correct word splitting when IFS contains multibyte
2003     characters.
2004
2005 bb. The mail checking code now resets the cached file information if the size
2006     drops to 0, even if the times don't change.
2007
2008 cc. A completed command name that is found in $PATH as well as the name of a
2009     directory in the current directory no longer has a slash appended in certain
2010     circumstances:  a single instance found in $PATH when `.' is not in $PATH,
2011     and multiple instances found in $PATH, even when `.' is in $PATH.
2012
2013 dd. Incorporated tilde expansion into the word expansion code rather than as a
2014     separately-called function, fixing some cases where it was performed
2015     inappropriately (e.g., after the second `=' in an assignment statement or
2016     in a double-quoted parameter expansion).
2017
2018 ee. Fixed several bugs encountered when parsing compound assignment statements,
2019     so that compound assignments appearing as arguments to builtins are no
2020     longer double-expanded.
2021
2022 ff. Fixed a bug in the command execution code that caused asynchronous commands
2023     containing command substitutions to not put the terminal in the wrong
2024     process group.
2025
2026 gg. Bash now handles the case where the WCONTINUED flag causes waitpid() to
2027     return -1/EINVAL at runtime as well as configuration time.
2028
2029 hh. Fixed parser to generate an error when the pipeline `argument' to `!' or
2030     `time' is NULL.
2031
2032 ii. The shell now takes a little more care when manipulating file descriptors
2033     greater than 9 with the `exec' builtin.
2034
2035 jj. Fixed a bug that caused variable assignments preceding the `command' builtin
2036     preceding a special builtin to be preserved after the command completed in
2037     POSIX mode.
2038
2039 kk. Fixed a bug that allowed variables beginning with a digit to be created.
2040
2041 ll. Fixed a bug that caused a \<newline> to be removed when parsing a $'...'
2042     construct.
2043
2044 mm. A shell whose name begins with `-' will now be a restricted shell if the
2045     remainder of the name indicates it should be restricted.
2046
2047 nn. Fixed a bug that could cause a core dump if FUNCNAME were changed or unset
2048     during a function's execution.
2049
2050 oo. Fixed a bug that caused executing a `return' in a function to not execute
2051     a RETURN trap.  The RETURN trap is inherited by shell functions only if
2052     function tracing is globally enabled or has been enabled for that function.
2053
2054 pp. Fixed cases where var[@] was not handled exactly like var, when var is a
2055     scalar variable.
2056
2057 qq. Fixed a bug that caused the first character after a SIGINT to be discarded
2058     under certain circumstances.
2059
2060 rr. Fixed exit status code so that a suspended job returns 128+signal as its
2061     exit status (preventing commands after it in `&&' lists from being
2062     executed).
2063
2064 ss. Fixed a bug that caused the shell parser state to be changed by executing
2065     a shell function as a result of word completion.
2066
2067 tt. Fixed a long-standing bug that caused '\177' characters in variable
2068     values to be discarded when expanded in double-quoted strings.
2069
2070 uu. Fixed a bug that caused $RANDOM to be re-seeded multiple times in a
2071     subshell environment.
2072
2073 vv. Extensive changes to the job management code to avoid the pid-reuse and
2074     pid-aliasing problems caused by retaining the exit status of too many jobs,
2075     but still retain as many background job statuses as POSIX requires.
2076
2077 ww. Fixed a parser bug in processing \<newline> that caused things like
2078
2079                 ((echo 5) \
2080                  (echo 6))
2081
2082     to not work correctly.
2083
2084 xx. `pwd -P' now sets $PWD to a directory name containing no symbolic links
2085     when in posix mode, as POSIX requires.
2086
2087 yy. In posix mode, bash no longer sets $PWD to a name containing no symbolic
2088     links if a directory is chosen from $CDPATH.
2089
2090 zz. The word splitting code now treats an IFS character that is not space,
2091     tab, or newline and any adjacent IFS white space as a single delimiter, as
2092     SUSv3/XPG6 require.
2093
2094 aaa. The `read' builtin now checks whether or not the number of fields read is
2095      exactly the same as the number of variables instead of just assigning the
2096      rest of the line (minus any trailing IFS white space) to the last
2097      variable.  This is what POSIX/SUS/XPG all require.
2098
2099 bbb. Fixed a bug that caused `read' to always check whether or not fd 0 was a
2100      pipe, even when reading from another file descriptor.
2101
2102 ccc. Fixed a bug that caused short-circuiting of execution even if the return
2103      value was being inverted.
2104
2105 ddd. Fixed a bug that caused a core dump while decoding \W escapes in PS1 if
2106      PWD was unset.
2107
2108 eee. Fixed a bug in `read' that counted internal quoting characters for the
2109      purposes of `read -n'.
2110
2111 fff. Fixed a bug so that a function definition in a pipeline causes a child
2112      process to be forked at the right time.
2113
2114 ggg. Bash will not attempt to link against a readline library that doesn't
2115      have rl_gnu_readline_p == 1.
2116
2117 hhh. Fixed a bug that caused `read' to consume one too many characters when
2118      reading a fixed number of characters and the Nth character is a backslash.
2119
2120 iii. Fixed a bug that caused `unset' on variables in the temporary environment
2121      to leave them set when `unset' completed.
2122
2123 jjj. Fixed a bug that caused bash to close fd 2 if an `exec' failed and the
2124      shell didn't exit.
2125
2126 kkk. The completion code is more careful to not turn `/' or `///' into `//',
2127      for those systems on which `//' has special meaning.
2128
2129 lll. Fixed a bug that caused command substitution in asynchronous commands to
2130      close the wrong file descriptors.
2131
2132 mmm. The shell no longer prints status messages about terminated background
2133      processes unless job control is active.
2134
2135 nnn. Fixed a bug that prevented multiple consecutive invocations of `history -s'
2136      from adding all the commands to the history list.
2137
2138 ooo. Added a couple of changes to make arithmetic expansion more consistent in
2139      all its contexts (still not perfect).
2140
2141 ppp. Fixed a bug that caused the parser to occasionally not find the right
2142      terminating "`" in an old-style command substitution.
2143
2144 qqq. Fixed a bug that caused core dumps when the shell was reading its non-
2145      interactive input from fd 0 and fd 0 was duplicated and restored using a
2146      combination of `exec' (to save) and redirection (to restore).
2147
2148 rrr. Fixed a problem that caused loops in sourced scripts to not be cleaned
2149      up properly when a `return' is executed.
2150
2151 sss. Change internal command substitution completion function to append a slash
2152      to directory names in the command.
2153
2154 2.  Changes to Readline
2155
2156 a.  Fixed a bug that caused multiliine prompts to be wrapped and displayed
2157     incorrectly.
2158
2159 b.  Fixed a bug that caused ^P/^N in emacs mode to fail to display the current
2160     line correctly.
2161
2162 c.  Fixed a problem in computing the number of invisible characters on the first
2163     line of a prompt whose length exceeds the screen width.
2164
2165 d.  Fixed vi-mode searching so that failure preserves the current line rather
2166     than the last line in the history list.
2167
2168 e.  Fixed the vi-mode `~' command (change-case) to have the correct behavior at
2169     end-of-line when manipulating multibyte characters.
2170
2171 f.  Fixed the vi-mode `r' command (change-char) to have the correct behavior at
2172     end-of-line when manipulating multibyte characters.
2173
2174 g.  Fixed multiple bugs in the redisplay of multibyte characters:  displaying
2175     prompts longer than the screen width containing multibyte characters, 
2176
2177 h.  Fix the calculation of the number of physical characters in the prompt
2178     string when it contains multibyte characters.
2179
2180 i.  A non-zero value for the `rl_complete_suppress_append' variable now causes
2181     no `/' to be appended to a directory name.
2182
2183 j.  Fixed forward-word and backward-word to work when words contained
2184     multibyte characters.
2185
2186 k.  Fixed a bug in finding the delimiter of a `?' substring when performing
2187     history expansion in a locale that supports multibyte characters.
2188
2189 l.  Fixed a memory leak caused by not freeing the timestamp in a history entry.
2190
2191 m.  Fixed a bug that caused "\M-x" style key bindings to not obey the setting
2192     of the `convert-meta' variable.
2193
2194 n.  Fixed saving and restoring primary prompt when prompting for incremental
2195     and non-incremental searches; search prompts now display multibyte
2196     characters correctly.
2197
2198 o.  Fixed a bug that caused keys originally bound to self-insert but shadowed
2199     by a multi-character key sequence to not be inserted.
2200
2201 p.  Fixed code so rl_prep_term_function and rl_deprep_term_function aren't
2202     dereferenced if NULL (matching the documentation).
2203
2204 q.  Extensive changes to readline to add enough state so that commands
2205     requiring additional characters (searches, multi-key sequences, numeric
2206     arguments, commands requiring an additional specifier character like
2207     vi-mode change-char, etc.) work without synchronously waiting for
2208     additional input.
2209
2210 r.  Lots of changes so readline builds and runs on MinGW.
2211
2212 s.  Readline no longer tries to modify the terminal settings when running in
2213     callback mode.
2214
2215 t.  The Readline display code no longer sets the location of the last invisible
2216     character in the prompt if the \[\] sequence is empty.
2217
2218 3.  New Features in Bash
2219
2220 a.  Bash now understands LC_TIME as a special variable so that time display
2221     tracks the current locale.
2222
2223 b.  BASH_ARGC, BASH_ARGV, BASH_SOURCE, and BASH_LINENO are no longer created
2224     as `invisible' variables and may not be unset.
2225
2226 c.  In POSIX mode, if `xpg_echo' option is enabled, the `echo' builtin doesn't
2227     try to interpret any options at all, as POSIX requires.
2228
2229 d.  The `bg' builtin now accepts multiple arguments, as POSIX seems to specify.
2230
2231 e.  Fixed vi-mode word completion and glob expansion to perform tilde
2232     expansion.
2233
2234 f.  The `**' mathematic exponentiation operator is now right-associative.
2235
2236 g.  The `ulimit' builtin has new options: -i (max number of pending signals),
2237     -q (max size of POSIX message queues), and -x (max number of file locks).
2238
2239 h.  A bare `%' once again expands to the current job when used as a job
2240     specifier.
2241
2242 i.  The `+=' assignment operator (append to the value of a string or array) is
2243     now supported for assignment statements and arguments to builtin commands
2244     that accept assignment statements.
2245
2246 j.  BASH_COMMAND now preserves its value when a DEBUG trap is executed.
2247
2248 k.  The `gnu_errfmt' option is enabled automatically if the shell is running
2249     in an emacs terminal window.
2250
2251 l.  New configuration option:  --single-help-strings.  Causes long help text
2252     to be written as a single string; intended to ease translation.
2253
2254 m.  The COMP_WORDBREAKS variable now causes the list of word break characters
2255     to be emptied when the variable is unset.
2256
2257 n.  An unquoted expansion of $* when $IFS is empty now causes the positional
2258     parameters to be concatenated if the expansion doesn't undergo word
2259     splitting.
2260
2261 o.  Bash now inherits $_ from the environment if it appears there at startup.
2262
2263 p.  New shell option: nocasematch.  If non-zero, shell pattern matching ignores
2264     case when used by `case' and `[[' commands.
2265
2266 q.  The `printf' builtin takes a new option: -v var.  That causes the output
2267     to be placed into var instead of on stdout.
2268
2269 r.  By default, the shell no longer reports processes dying from SIGPIPE.
2270
2271 s.  Bash now sets the extern variable `environ' to the export environment it
2272     creates, so C library functions that call getenv() (and can't use the
2273     shell-provided replacement) get current values of environment variables.
2274
2275 4.  New Features in Readline
2276
2277 a.  The key sequence sent by the keypad `delete' key is now automatically
2278     bound to delete-char.
2279
2280 b.  A negative argument to menu-complete now cycles backward through the
2281     completion list.
2282
2283 c.  A new bindable readline variable:  bind-tty-special-chars.  If non-zero,
2284     readline will bind the terminal special characters to their readline
2285     equivalents when it's called (on by default).
2286
2287 d.  New bindable command: vi-rubout.  Saves deleted text for possible
2288     reinsertion, as with any vi-mode `text modification' command; `X' is bound
2289     to this in vi command mode.
2290
2291 ------------------------------------------------------------------------------
2292 This document details the changes between this version, bash-3.0-release,
2293 and the previous version, bash-3.0-rc1.
2294
2295 1.  Changes to Bash
2296
2297 a.  Fixed a boundary overrun that could cause segmentation faults when the
2298     completion code hands an incomplete construct to the word expansion
2299     functions.
2300
2301 b.  Changed posix mode behavior so that an error in a variable assignment
2302     preceding a special builtin causes a non-interactive shell to exit.
2303
2304 c.  Change the directory expansion portion of the completion code to not
2305     expand embedded command substitutions if the directory name appears in
2306     the file system.
2307
2308 d.  Fixed a problem that caused `bash -r' to turn on restrictions before
2309     reading the startup files.
2310
2311 e.  Fixed a problem with the default operation of the `umask' builtin.
2312
2313 2.  Changes to Readline
2314
2315 a.  Fixed a problem with readline saving the contents of the current line
2316     before beginning a non-interactive search.
2317
2318 b.  Fixed a problem with EOF detection when using rl_event_hook.
2319
2320 c.  Fixed a problem with the vi mode `p' and `P' commands ignoring numeric
2321     arguments.
2322
2323 ------------------------------------------------------------------------------
2324 This document details the changes between this version, bash-3.0-rc1,
2325 and the previous version, bash-3.0-beta1.
2326
2327 1.  Changes to Bash
2328
2329 a.  Fixed a bug that caused incorrect behavior when referecing element 0 of
2330     an array using $array, element 0 was unset, and `set -u' was enabled.
2331
2332 b.  System-specific changes for: SCO Unix 3.2, Tandem.
2333
2334 c.  Fixed a bug that caused inappropriate word splitting when a variable was
2335     expanded within a double-quoted string that also included $@.
2336
2337 d.  Fixed a bug that caused `pwd' to not display anything in physical mode
2338     when the file system had changed underneath the shell.
2339
2340 e.  Fixed a bug in the pre- and post- increment and decrement parsing in the
2341     expression evaluator that caused errors when the operands and corresponding
2342     operators were separated by whitespace.
2343
2344 f.  Fixed a bug that caused `history -p' to add an entry to the history list,
2345     counter to the documentation.  (Keeps the history expansions invoked by
2346     emacs-mode command line editing from doing that as well.)
2347
2348 g.  Fixed a bug that could cause a core dump if `cd' is asked to print out a
2349     pathname longer than PATH_MAX characters.
2350
2351 h.  Fixed a bug that caused jobs to be put into the wrong process group under
2352     some circumstances after enabling job control with `set -m'.
2353
2354 i.  `unalias' now  returns failure if no alias name arguments are supplied.
2355
2356 j.  Documented the characters not allowed to appear in an alias name.
2357
2358 k.  $* is no longer expanded as if in double quotes when it appears in the
2359     body of a here document, as the SUS seems to require.
2360
2361 l.  The `bashbug' script now uses a directory in $TMPDIR for exclusive
2362     access rather than trying to guess how the underlying OS provides for
2363     secure temporary file creation.
2364
2365 m.  Fixed a few problems with `cd' and `pwd' when asked to operate on pathnames
2366     longer than PATH_MAX characters.
2367
2368 n.  Fixed a memory leak caused when creating multiple local array variables
2369     with identical names.
2370
2371 o.  Fixed a problem with calls to getcwd() so that bash now operates better
2372     when the full pathname to the current directory is longer than PATH_MAX
2373     bytes.
2374
2375 p.  The `trap' builtin now reports an error if a single non-signal argument
2376     is specified.
2377
2378 q.  Fixed a bug that caused `umask' to not work correctly when presented
2379     with a mask of all 0s.
2380
2381 r.  When `getopts' reaches the end of options, OPTARG is unset, as POSIX
2382     appears to specify.
2383
2384 s.  Interactive mode now depends on whether or not stdin and stderr are
2385     connected to a tty; formerly it  was stdin and stdout.  POSIX requires
2386     this.
2387
2388 t.  Fixed vi-mode completion to work more as POSIX specifies (e.g., doing the
2389     right kind of filename generation).
2390
2391 2.  Changes to Readline
2392
2393 a.  Fixed a problem that could cause readline to refer to freed memory when
2394     moving between history lines while doing searches.
2395
2396 b.  Improvements to the code that expands and displays prompt strings
2397     containing multibyte characters.
2398
2399 c.  Fixed a problem with vi-mode not correctly remembering the numeric argument
2400     to the last `c'hange command for later use with `.'.
2401
2402 d.  Fixed a bug in vi-mode that caused multi-digit count arguments to work
2403     incorrectly.
2404
2405 e.  Fixed a problem in vi-mode that caused the last text modification command
2406     to not be remembered across different command lines.
2407
2408 f.  Fixed problems with changing characters and changing case at the end of
2409     the line.
2410
2411 3.  New Features in Bash
2412
2413 a.  The `jobs', `kill', and `wait' builtins now accept job control notation
2414     even if job control is not enabled.
2415
2416 b.  The historical behavior of `trap' that allows a missing `action' argument
2417     to cause each specified signal's handling to be reset to its default is
2418     now only supported when `trap' is given a single non-option argument.
2419
2420 4.  New Features in Readline
2421
2422 a.  When listing completions, directories have a `/' appended if the
2423     `mark-directories' option has been enabled.
2424
2425 ------------------------------------------------------------------------------
2426 This document details the changes between this version, bash-3.0-beta1,
2427 and the previous version, bash-3.0-alpha.
2428
2429 1.  Changes to Bash
2430
2431 a.  Fixes to build correctly when arrays are not compiled into the shell.
2432
2433 b.  Fixed command substitution to run any exit trap defined in the command
2434     substitution before returning; the exit trap is not inherited from the
2435     calling shell.
2436
2437 c.  Fixes to process group synchronization code so that every child process
2438     attempts to set the terminal's process group; fixes some synchronization
2439     problems on Linux kernels that schedule the child to always run before
2440     the parent.
2441
2442 d.  Fixed processing of octal and hex constants in printf builtin for POSIX.2
2443     compliance.
2444
2445 e.  Fixed a couple of core dumps in the pattern removal code.
2446
2447 f.  Fixes to the array subrange extraction code to deal better with sparse
2448     arrays.
2449
2450 g.  Parser errors and other errors that result in the shell exiting now cause
2451     the exit trap to be run.
2452
2453 h.  Change the command substitution completion functions to not append any
2454     closing quote, because it would be inserted a closing "`" or ")".
2455
2456 i.  Fix history initialization so assignments to $histchars made in startup
2457     files are honored.
2458
2459 j.  If an exit trap does not contain a call to `exit', the shell now uses
2460     the exit status of the last command executed before the trap as the exit
2461     status of the shell.
2462
2463 k.  The parser now prompts with $PS2 if it reads a newline while parsing a
2464     compound array assignment statement.
2465
2466 l.  When performing a compound array assignment, the parser doesn't treat
2467     words of the form [index]=value as assignments if they're the result of
2468     expansions.
2469
2470 m.  Fixed a bug that caused `return' executed in a trap command to make the
2471     shell think it was still running the trap.
2472
2473 n.  Fixed the value of errno set by the pathname canonicalization functions.
2474
2475 o.  Changed the grammar so that `time' alone on a line times a null command
2476     rather than being a syntax error.
2477
2478 p.  The pattern substitution code no longer performs quote removal on the
2479     pattern before trying to match it, as the pattern removal functions do.
2480
2481 q.  Fixed a bug that could cause core dumps when checking whether a quoted
2482     command name was being completed.
2483
2484 r.  Fixes to the pattern removal and pattern replacement expansions to deal
2485     with multibyte characters better (and faster).
2486
2487 s.  Fix to the substring expansion (${param:off[:len]}) to deal with (possibly
2488     multibyte) characters instead of raw bytes.
2489
2490 t.  Fixed a bug that caused some key bindings set in an inputrc to be ignored
2491     at shell startup.
2492
2493 u.  Fixed a bug that caused unsetting a local variable within a function to
2494     not work correctly.
2495
2496 v.  Fixed a bug that caused invalid variables to be created when using
2497     `read -a'.
2498
2499 w.  Fixed a bug that caused "$@" to expand incorrectly when used as the right
2500     hand side of a parameter expansion such as ${word:="$@"} if the first
2501     character of $IFS was not a space.
2502
2503 x.  Fixed a slight cosmetic problem when printing commands containing a
2504     `>&word' redirection.
2505
2506 y.  Fixed a problem that could cause here documents to not be created correctly
2507     if the system temporary directory did not allow writing.
2508
2509 2.  Changes to Readline
2510
2511 a.  Change to history expansion functions to treat `^' as equivalent to word
2512     one, as the documention states.
2513
2514 b.  Some changes to the display code to improve display and redisplay of
2515     multibyte characters.
2516
2517 c.  Changes to speed up the multibyte character redisplay code.
2518
2519 d.  Fixed a bug in the vi-mode `E' command that caused it to skip over the
2520     last character of a word if invoked while point was on the word's
2521     next-to-last character.
2522
2523 e.  Fixed a bug that could cause incorrect filename quoting when
2524     case-insensitive completion was enabled and the word being completed
2525     contained backslashes quoting word break characters.
2526
2527 f.  Fixed a bug in redisplay triggered when the prompt string contains
2528     invisible characters.
2529
2530 g.  Fixed some display (and other) bugs encountered in multibyte locales
2531     when a non-ascii character was the last character on a line.
2532
2533 h.  Fixed some display bugs caused by multibyte characters in prompt strings.
2534
2535 i.  Fixed a problem with history expansion caused by non-whitespace characters
2536     used as history word delimiters.
2537
2538 3.  New Features in Bash
2539
2540 a.  printf builtin understands two new escape sequences:  \" and \?.
2541
2542 b.  `echo -e' understands two new escape sequences:  \" and \?.
2543
2544 c.  The GNU `gettext' package and libintl have been integrated; the shell's
2545     messages can be translated into different languages.
2546
2547 d.  The `\W' prompt expansion now abbreviates $HOME as `~', like `\w'.
2548
2549 e.  The error message printed when bash cannot open a shell script supplied
2550     as argument 1 now includes the name of the shell, to better identify
2551     the error as coming from bash.
2552
2553 4.  New Features in Readline
2554
2555 a.  New application variable, rl_completion_quote_character, set to any
2556     quote character readline finds before it calls the application completion
2557     function.
2558
2559 b.  New application variable, rl_completion_suppress_quote, settable by an
2560     application completion function.  If set to non-zero, readline does not
2561     attempt to append a closing quote to a completed word.
2562
2563 c.  New application variable, rl_completion_found_quote, set to a non-zero
2564     value if readline determines that the word to be completed is quoted.
2565     Set before readline calls any application completion function.
2566
2567 d.  New function hook, rl_completion_word_break_hook, called when readline
2568     needs to break a line into words when completion is attempted.  Allows
2569     the word break characters to vary based on position in the line.
2570
2571 e.  New bindable command: unix-filename-rubout.  Does the same thing as
2572     unix-word-rubout, but adds `/' to the set of word delimiters.
2573
2574 ------------------------------------------------------------------------------
2575 This document details the changes between this version, bash-3.0-alpha,
2576 and the previous version, bash-2.05b-release.
2577
2578 1.  Changes to Bash
2579
2580 a.  Fixes so that the shell will compile without some of the default options
2581     defined.
2582
2583 b.  Fixed an error message that did not pass enough arguments to printf.
2584
2585 c.  Fixed a bug that caused input redirection to a builtin inside a script
2586     being read from standard input to result in the rest of the already-
2587     read and buffered script to be discarded.
2588
2589 d.  Fixed a bug that caused subshell initialization to close the file
2590     descriptor from which the shell was reading a script under certain
2591     circumstances.
2592
2593 e.  Fixed a bug that caused the shell to not advance a string pointer over
2594     a null wide character when doing string operations.
2595
2596 f.  Fixed the internal logout code so that shells that time out waiting for
2597     input (using $TMOUT) run ~/.bash_logout.
2598
2599 g.  Portability and configuration changes for: cygwin, HP/UX, GNU/FreeBSD.
2600
2601 h.  The parser no longer adds implicit double quotes to ((...)) arithmetic
2602     commands.
2603
2604 i.  The ((...)) arithmetic command evaluation code was fixed to not dump core
2605     when the expanded string is null.
2606
2607 j.  The ((...)) arithmetic command evaluation code was fixed to not perform
2608     variable assignments while expanding the expression.
2609
2610 k.  Fixed a bug that caused word splitting to be performed incorrectly when
2611     IFS is set, but null.
2612
2613 l.  Fixed a bug in brace expansion that caused a quoted `$' preceding an
2614     open brace to inhibit brace expansion.
2615
2616 m.  Fixed a bug that caused a leading `-' in the shell's name to cause it to
2617     not be recognized as a restricted shell.
2618
2619 n.  Fixed a bug in the arithmetic evaluation code that could cause longjmps
2620     to an invalid location and result in a core dump.
2621
2622 o.  Fixed a bug in the calculation of how many history lines are new in a
2623     single shell session when reading new history lines from a file with
2624     `history -n'.
2625
2626 p.  Fixed a bug in pathname canonicalization that caused the shell to dump
2627     core when presented with a pathname longer than PATH_MAX.
2628
2629 q.  Fixed the parser so that it doesn't try to compare a char variable to
2630     EOF, which fails when chars are unsigned.
2631
2632 r.  Fixed a bug in the simple command execution code that caused occasional
2633     core dumps.
2634
2635 s.  The shell does a better job of saving any partial parsing state during
2636     operations which cause a command to be executed while a line is being
2637     entered and parsed.
2638
2639 t.  The completion code now splits words more like the expansion code when
2640     $IFS is used to split.
2641
2642 u.  The locale code does a better job of recomputing the various locale
2643     variable values when LC_ALL is unset.
2644
2645 v.  The programmable completion code does a better job of dequoting expanded
2646     word lists before comparing them against the word to be matched.
2647
2648 w.  The shell no longer seg faults if the expanded value of $PS4 is null
2649     and `set -x' is enabled.
2650
2651 x.  Fixed a bug that caused core dumps when a here string expanded to NULL.
2652
2653 y.  The mail checking code now makes sure the mailbox is bigger before
2654     reporting the existence of new mail.
2655
2656 z.  The parser does not try to expand $'...' and $"..." when the appear
2657     within double quotes unless the `extquote' option has been enabled with
2658     `shopt'.  For backwards compatibility, it is enabled by default.
2659
2660 aa. Fixed a bug that caused `for x; do ...' and `select x; do ... to use
2661     $@ instead of "$@" for the implicit list of arguments.
2662
2663 bb. Fixed a bug that caused a subshell of a restricted shell (e.g., one
2664     spawned to execute a pipeline) to not exit immediately if attempting
2665     to use a command containing a slash.
2666
2667 cc. Fixed a problem with empty replacements for a pattern that doesn't match
2668     when performing ${param/word/} expansion.
2669
2670 dd. Word expansions performed while expanding redirections no longer search
2671     a command's temporary environment to expand variable values.
2672
2673 ee. Improvements to the alias expansion code when expanding subsequent words
2674     because an aliase's value ends with a space.
2675
2676 ff. `cd -' now prints the current working directory after a successful chdir
2677     even when the shell is not interactive, as the standard requires.
2678
2679 gg. The shell does a better job of ensuring a child process dies of SIGINT
2680     before resending SIGINT to itself.
2681
2682 hh. The arithmetic expansion variable assignment code now does the right
2683     thing when assigning to `special' variables like OPTIND.
2684
2685 ii. When history expansion verification is enabled, the bash readline helper
2686     functions that do history expansion on the current line don't print
2687     the results.
2688
2689 jj. Fixed bugs with multiple consecutive alias expansion when one of the
2690     expansions ends with a space.
2691
2692 kk. Fixed a problem in the programmable completion code that could cause core
2693     dumps when trying to initialize a set of possible completions from a
2694     list of variables.
2695
2696 ll. The \[ and \] escape characters are now ignored when decoding the prompt
2697     string if the shell is started with editing disabled.
2698
2699 mm. Fixed a bug that could leave extra characters in a string when doing
2700     quoted null character removal.
2701
2702 nn. Command substitution and other subshell operations no longer reset the
2703     line number (aids the bash debugger).
2704
2705 oo. Better line number management when executing simple commands, conditional
2706     commands, for commands, and select commands.
2707
2708 pp. The globbing code now uses malloc, with its better failure properties,
2709     rather than alloca().
2710
2711 qq. Fixed a bug that caused expansions like #{a[2]:=value} to create the
2712     appropriate array element instead of a variable named `a[2]'.
2713
2714 rr. Fixed a bug in the handling of a `?(...)' pattern immediately following
2715     a `*' when extglob is enabled.
2716
2717 ss. Fixed a bug that caused a `return' invoked in an exit trap when exit is
2718     invoked in a function to misbehave.
2719
2720 tt. Fixed a bug that caused CTLESC and CTLNUL characters to not be escaped
2721     by the internal shell string quoting functions.
2722
2723 uu. Fixed a bug that caused quoted null characters in an expanded word list
2724     to be inappropriately assigned to an array variable when using `read -a'.
2725
2726 vv. Fixed a bug that caused redirections accompanying a null command to persist
2727     in the current shell.
2728
2729 ww. Fixed a bug that caused the prompt to be printed when the shell was
2730     expanding a multiline alias.
2731
2732 xx. Fixed a bug that resulted in core dumps when the completion for a command
2733     changed the compspec.
2734
2735 yy. Fixed a bug that caused evaluation of programmable completions to print
2736     notifications of completed jobs.
2737
2738 zz. Bash now disables line editing when $EMACS == `t' and $TERM == `dumb'
2739     (which is what emacs shell windows do).
2740
2741 aaa. In posix mode, `kill -l' causes signal names to be displayed without
2742      a leading `SIG'.
2743
2744 bbb. Clear error flag on standard output so it doesn't persist across multiple
2745      builtin commands.
2746
2747 ccc. In posix mode, `alias' displays alias values without the leading `alias',
2748      so the output cannot be used as subsequent input.
2749
2750 ddd. In posix mode, the `trap' builtin doesn't check whether or not its
2751      first argument is a signal specification and revert the signal handling
2752      to its original disposition if it is.
2753
2754 eee. Fixed several bugs in the handling of "$*" and "${array[*]}" by the
2755      pattern substitution and removal expansions.
2756
2757 fff. Fixed several problems with the handling of ${array[@]}, ${array[*]},
2758      $@, and $* by the indirect variable expansion code.
2759
2760 ggg. Fixed a bug that did not allow `time' to be aliased.
2761
2762 hhh. Improved the mail checking code so it won't check (and possibly cause an
2763      NFS file system mount) until MAILPATH or MAIL is given a value -- there
2764      is no default if DEFAULT_MAIL_DIRECTORY is not defined at compile time.
2765      (It is computed by configure, but can be #undef'd in config-bot.h.)
2766
2767 iii. If the `chkwinsize' option is enabled, the shell checks for window size
2768      changes if a child process exits due to a signal.
2769
2770 jjj. Removed the attempts to avoid adding a slash at the end of a completed
2771      executable name if there was a directory with the same name in the
2772      current directory.
2773
2774 kkk. Fixed PATH lookup code so it treats the permission bits separately for
2775      owner, group, and other, rather than checking them all.
2776
2777 lll. Fixed the locale code to reset the parser's idea of the character class
2778      <blank>, which controls how it splits tokens, when the locale changes.
2779
2780 mmm. The shell now binds its special readline functions and key bindings only
2781      if the user's inputrc file has not already bound them.
2782
2783 nnn. The shell now reports on processes that dump core due to signals when
2784      invoked as `-c command'.
2785
2786 2.  Changes to Readline
2787
2788 a.  Fixes to avoid core dumps because of null pointer references in the
2789     multibyte character code.
2790
2791 b.  Fix to avoid infinite recursion caused by certain key combinations.
2792
2793 c.  Fixed a bug that caused the vi-mode `last command' to be set incorrectly.
2794
2795 d.  Readline no longer tries to read ahead more than one line of input, even
2796     when more is available.
2797
2798 e.  Fixed the code that adjusts the point to not mishandle null wide
2799     characters.
2800
2801 f.  Fixed a bug in the history expansion `g' modifier that caused it to skip
2802     every other match.
2803
2804 g.  Fixed a bug that caused the prompt to overwrite previous output when the
2805     output doesn't contain a newline and the locale supports multibyte
2806     characters.  This same change fixes the problem of readline redisplay
2807     slowing down dramatically as the line gets longer in multibyte locales.
2808
2809 h.  History traversal with arrow keys in vi insertion mode causes the cursor
2810     to be placed at the end of the new line, like in emacs mode.
2811
2812 i.  The locale initialization code does a better job of using the right
2813     precedence and defaulting when checking the appropriate environment
2814     variables.
2815
2816 j.  Fixed the history word tokenizer to handle <( and >( better when used as
2817     part of bash.
2818
2819 k.  The overwrite mode code received several bug fixes to improve undo.
2820
2821 l.  Many speedups to the multibyte character redisplay code.
2822
2823 m.  The callback character reading interface should not hang waiting to read
2824     keyboard input.
2825
2826 n.  Fixed a bug with redoing vi-mode `s' command.
2827
2828 o.  The code that initializes the terminal tracks changes made to the terminal
2829     special characters with stty(1) (or equivalent), so that these changes
2830     are reflected in the readline bindings.  New application-callable function
2831     to make it work:  rl_tty_unset_default_bindings().
2832
2833 p.  Fixed a bug that could cause garbage to be inserted in the buffer when
2834     changing character case in vi mode when using a multibyte locale.
2835
2836 q.  Fixed a bug in the redisplay code that caused problems on systems
2837     supporting multibyte characters when moving between history lines when the
2838     new line has more glyphs but fewer bytes.
2839
2840 r.  Undo and redo now work better after exiting vi insertion mode.
2841
2842 s.  Make sure system calls are restarted after a SIGWINCH is received using
2843     SA_RESTART.
2844
2845 t.  Improvements to the code that displays possible completions when using
2846     multibyte characters.
2847
2848 u.  Fixed a problem when parsing nested if statements in inputrc files.
2849
2850 v.  The completer now takes multibyte characters into account when looking for
2851     quoted substrings on which to perform completion.
2852
2853 w.  The history search functions now perform better bounds checking on the
2854     history list.
2855
2856 3.  New Features in Bash
2857
2858 a.  ANSI string expansion now implements the \x{hexdigits} escape.
2859
2860 b.  There is a new loadable `strftime' builtin.
2861
2862 c.  New variable, COMP_WORDBREAKS, which controls the readline completer's
2863     idea of word break characters.
2864
2865 d.  The `type' builtin no longer reports on aliases unless alias expansion
2866     will actually be performed.    
2867
2868 e.  HISTCONTROL is now a colon-separated list of values, which permits
2869     more extensibility and backwards compatibility.
2870
2871 f.  HISTCONTROL may now include the `erasedups' option, which causes all lines
2872     matching a line being added to be removed from the history list.
2873
2874 g.  `configure' has a new `--enable-multibyte' argument that permits multibyte
2875     character support to be disabled even on systems that support it.
2876
2877 h.  New variables to support the bash debugger:  BASH_ARGC, BASH_ARGV,
2878     BASH_SOURCE, BASH_LINENO, BASH_SUBSHELL, BASH_EXECUTION_STRING,
2879     BASH_COMMAND
2880
2881 i.  FUNCNAME has been changed to support the debugger: it's now an array
2882     variable.
2883
2884 j.  for, case, select, arithmetic commands now keep line number information
2885     for the debugger.
2886
2887 k.  There is a new `RETURN' trap executed when a function or sourced script
2888     returns (not inherited child processes; inherited by command substitution
2889     if function tracing is enabled and the debugger is active).
2890
2891 l.  New invocation option:  --debugger.  Enables debugging and turns on new
2892     `extdebug' shell option.
2893
2894 m.  New `functrace' and `errtrace' options to `set -o' cause DEBUG and ERR
2895     traps, respectively, to be inherited by shell functions.  Equivalent to
2896     `set -T' and `set -E' respectively.  The `functrace' option also controls
2897     whether or not the DEBUG trap is inherited by sourced scripts.
2898
2899 n.  The DEBUG trap is run before binding the variable and running the action
2900     list in a `for' command, binding the selection variable and running the
2901     query in a `select' command, and before attempting a match in a `case'
2902     command.
2903
2904 o.  New `--enable-debugger' option to `configure' to compile in the debugger
2905     support code.
2906
2907 p.  `declare -F' now prints out extra line number and source file information
2908     if the `extdebug' option is set.
2909
2910 q.  If `extdebug' is enabled, a non-zero return value from a DEBUG trap causes
2911     the next command to be skipped, and a return value of 2 while in a
2912     function or sourced script forces a `return'.
2913
2914 r.  New `caller' builtin to provide a call stack for the bash debugger.
2915
2916 s.  The DEBUG trap is run just before the first command in a function body is
2917     executed, for the debugger.
2918
2919 t.  `for', `select', and `case' command heads are printed when `set -x' is
2920     enabled.
2921
2922 u.  There is a new {x..y} brace expansion, which is shorthand for {x.x+1,
2923     x+2,...,y}.  x and y can be integers or single characters; the sequence
2924     may ascend or descend; the increment is always 1.
2925
2926 v.  New ksh93-like ${!array[@]} expansion, expands to all the keys (indices)
2927     of array.
2928
2929 w.  New `force_fignore' shopt option; if enabled, suffixes specified by
2930     FIGNORE cause words to be ignored when performing word completion even
2931     if they're the only possibilities.
2932
2933 x.  New `gnu_errfmt' shopt option; if enabled, error messages follow the `gnu
2934     style' (filename:lineno:message) format.
2935
2936 y.  New `-o bashdefault' option to complete and compgen; if set, causes the
2937     whole set of bash completions to be performed if the compspec doesn't
2938     result in a match.
2939
2940 z.  New `-o plusdirs' option to complete and compgen; if set, causes directory
2941     name completion to be performed and the results added to the rest of the
2942     possible completions.
2943
2944 aa. `kill' is available as a builtin even when the shell is built without
2945     job control.
2946
2947 bb. New HISTTIMEFORMAT variable; value is a format string to pass to
2948     strftime(3).  If set and not null, the `history' builtin prints out
2949     timestamp information according to the specified format when displaying
2950     history entries.  If set, bash tells the history library to write out
2951     timestamp information when the history file is written.
2952
2953 cc. The [[ ... ]] command has a new binary `=~' operator that performs
2954     extended regular expression (egrep-like) matching.
2955
2956 dd. `configure' has a new `--enable-cond-regexp' option (enabled by default)
2957     to enable the =~ operator and regexp matching in [[ ... ]].
2958
2959 ee. Subexpressions matched by the =~ operator are placed in the new
2960     BASH_REMATCH array variable.
2961
2962 ff. New `failglob' option that causes an expansion error when pathname
2963     expansion fails to produce a match.
2964
2965 gg. New `set -o pipefail' option that causes a pipeline to return a failure
2966     status if any of the processes in the pipeline fail, not just the last
2967     one.
2968
2969 4.  New Features in Readline
2970
2971 a.  History expansion has a new `a' modifier equivalent to the `g' modifier
2972     for compatibility with the BSD csh.
2973
2974 b.  History expansion has a new `G' modifier equivalent to the BSD csh `g'
2975     modifier, which performs a substitution once per word.
2976
2977 c.  All non-incremental search operations may now undo the operation of
2978     replacing the current line with the history line.
2979
2980 d.  The text inserted by an `a' command in vi mode can be reinserted with
2981     `.'.
2982
2983 e.  New bindable variable, `show-all-if-unmodified'.  If set, the readline
2984     completer will list possible completions immediately if there is more
2985     than one completion and partial completion cannot be performed.
2986
2987 f.  There is a new application-callable `free_history_entry()' function.
2988
2989 g.  History list entries now contain timestamp information; the history file
2990     functions know how to read and write timestamp information associated
2991     with each entry.
2992
2993 h.  Four new key binding functions have been added:
2994
2995         rl_bind_key_if_unbound()
2996         rl_bind_key_if_unbound_in_map()
2997         rl_bind_keyseq_if_unbound()
2998         rl_bind_keyseq_if_unbound_in_map()
2999
3000 ------------------------------------------------------------------------------
3001 This document details the changes between this version, bash-2.05b-release,
3002 and the previous version, bash-2.05b-beta2.
3003
3004 1.  Changes to Bash
3005
3006 a.  Fixed an off-by-one error in the function that translates job
3007     specifications.
3008
3009 b.  Note that we're running under Emacs and disable line editing if
3010     $EMACS == `t'.
3011
3012 ------------------------------------------------------------------------------
3013 This document details the changes between this version, bash-2.05b-beta2,
3014 and the previous version, bash-2.05b-beta1.
3015
3016 1.  Changes to Bash
3017
3018 a.  Fixed the /= and %= arithmetic operators to catch division by zero.
3019
3020 b.  Added putenv, setenv, unsetenv to getenv replacement for completeness.
3021
3022 c.  Fixed a bug that could cause the -O expand_aliases invocation option
3023     to not take effect.
3024
3025 d.  Fixed a problem with process substitution that resulted in incorrect
3026     behavior when the number of process substitutions in an individual
3027     command approached 64.
3028
3029 2.  Changes to Readline
3030
3031 a.  Fixed a problem with backward-char-search when on a system with support
3032     for multibyte characters when running in a locale without any multibyte
3033     characters.
3034
3035 ------------------------------------------------------------------------------
3036 This document details the changes between this version, bash-2.05b-beta1,
3037 and the previous version, bash-2.05b-alpha1.
3038
3039 1.  Changes to Bash
3040
3041 a.  Fixed a problem when parsing a POSIX.2 character class name while
3042     evaluating a bracket expression containing multibyte characters.
3043
3044 b.  Changed the help text for `bind' to make it clear that any command
3045     that may be placed in ~/.inputrc is a valid argument to `bind'.
3046
3047 c.  Added `help' builtin entries for `((', `[[', and arithmetic for.
3048
3049 d.  malloc updated again:
3050         o slightly better overflow and underflow detection by putting the
3051           chunk size at the beginning and end of the chunk and making
3052           sure they match in free/realloc
3053         o partial page allocated to make things page-aligned no longer
3054           completely wasted
3055         o block coalescing now enabled by default
3056         o splitting and coalescing enabled for 32-byte chunks, the most
3057           common size requested
3058         o fixed a problem that resulted in spurious underflow messages and
3059           aborts
3060         o bin sizes are precomputed and stored in an array rather than
3061           being computed at run time
3062         o malloc will return memory blocks back to the system if the block
3063           being freed is at the top of the heap and of sufficient size to
3064           make it worthwhile
3065         o malloc/free/realloc now inline memset instead of calling the
3066           libc function; uses Duff's device for good performance
3067
3068 e.  Check for getservent(); make the service name completion code dependent
3069     on its presence.
3070
3071 f.  Changed the readline callback that executes a command bound to a key
3072     sequence to not save the executed command on the history list and to
3073     save and restore the parsing state.
3074
3075 g.  Changes to lib/sh/snprintf.c:  fixed some bugs in the `g' and `G'
3076     floating point format display; implemented the "'" flag character
3077     that turns on thousands' grouping; fixed behavior on systems where
3078     MB_CUR_MAX does not evaluate to a constant.
3079
3080 h.  The `unset' builtin no longer returns a failure status when asked to
3081     unset a previously-unset variable or function.
3082
3083 i.  Changes to the build system to make it easier to cross-compile bash
3084     for different systems.
3085
3086 j.  Added `,' to  the characters that are backslash-escaped during filename
3087     completion, to avoid problems with complete-into-braces and RCS filenames
3088     containing commas.
3089
3090 k.  Some changes to the multibyte character support code to avoid many calls
3091     to strlen().
3092
3093 l.  Bash now correctly honors setting LANG to some value when LC_ALL does not
3094     already have a value.
3095
3096 m.  Fixed a bug that could cause SIGSEGV when processing nested traps with
3097     trap handlers.
3098
3099 n.  The `source/.' builtin now restores the positional parameters when it
3100     returns unless they were changed using the `set' builtin during the file's
3101     execution.
3102
3103 o.  Fixed a bug that caused a syntax error when a command was terminated by
3104     EOF.
3105
3106 2.  New Features in Bash
3107
3108 a.  There is now support for placing the long help text into separate files
3109     installed into ${datadir}/bash.  Not enabled by default; can be turned
3110     on with `--enable-separate-helpfiles' option to configure.
3111
3112 b.  All builtins that take operands accept a `--' pseudo-option, except
3113     `echo'.
3114
3115 c.  The `echo' builtin now accepts \0xxx (zero to three octal digits following
3116     the `0') in addition to \xxx (one to three octal digits) for SUSv3/XPG6/
3117     POSIX.1-2001 compliance.
3118
3119 3.  Changes to Readline
3120
3121 a.  Fixed a small problem in _rl_insert_char with multibyte characters.
3122
3123 b.  Fixes from IBM for line wrapping problems when using multibyte characters.
3124
3125 c.  Fixed a problem which caused the display to be messed up when the last
3126     line of a multi-line prompt (possibly containing invisible characters)
3127     was longer than the screen width.
3128
3129 d.  Fixed a problem with the vi-mode `r' command that ocurred on systems with
3130     support for multibyte characters when running in a locale without any
3131     multibyte characters.
3132
3133 ------------------------------------------------------------------------------
3134 This document details the changes between this version, bash-2.05b-alpha1,
3135 and the previous version, bash-2.05a-release.
3136
3137 1.  Changes to Bash
3138
3139 a.  Some changes to work around inlining differences between compilers.
3140
3141 b.  Added more prototypes for internal shell typedefs, to catch argument
3142     passing errors when using pointers to functions.
3143
3144 c.  The `cd' builtin now fails in posix mode when a valid directory cannot be
3145     constructed from a relative pathname argument and the $PWD using pathname
3146     canonicalization, and the -P option has not been supplied.  Previously,
3147     the shell would attempt to use what the user typed, leading to weird
3148     values for $PWD and discrepancies between the value of $PWD and the
3149     actual working directory.
3150
3151 d.  The `cd' builtin now resets $PWD when canonicalization fails but a chdir
3152     to the pathname passed as an argument succeeds (when not in posix mode).
3153
3154 e.  The `fc' builtin has been fixed, as POSIX requires, to use the closest
3155     history position in range when given an out-of-range argument.
3156
3157 f.  The history file loading code was changed to allow lines to be saved in
3158     the history list from the shell startup files.
3159
3160 g.  `history -s args' now works better in compound commands.
3161
3162 h.  The tilde expansion code was fixed to better recognize when it's being
3163     invoked in an assignment context, which enables expansion after `='
3164     and `:'.
3165
3166 i.  Fixed the command name completion code so a slash is no longer appended
3167     to a single match if there happens to be a directory with that name in
3168     $PWD.
3169
3170 j.  Fixed compound array assignment to no longer perform alias expansion, to
3171     allow reserved words as array members, and to not produce extra output
3172     when the `-v' option had been enabled.
3173
3174 k.  Fixed the programmable completion code to better handle newlines in lists
3175     of possible completions (e.g., `complete -W').
3176
3177 l.  Removed the reserved words from the `bash-builtins' manual page.
3178
3179 m.  Parser error reporting now attempts to do a better job of identifying the
3180     token in error rather than doing straight textual analysis.
3181
3182 n.  Fixes for Inf/NaN, locales, wide/multibyte characters and zero-length
3183     arguments in the library snprintf(3) replacement.
3184
3185 o.  `read -e' no longer does command name completion on the first word on
3186     the line being read.
3187
3188 p.  `select' now returns failure if the read of the user's selection fails.
3189
3190 q.  Fixed a bug that could cause a core dump when setting $PIPESTATUS.
3191
3192 r.  Fixes to not allocate so many job slots when the shell is running a loop
3193     with job control enabled in a subshell of an interactive shell.
3194
3195 s.  Fixed a bug in the trap code that caused traps to be inherited by
3196     command substitutions in some cases.
3197
3198 t.  Fixed a bug that could cause alias expansion to inappropriately expand
3199     the word following the alias.
3200
3201 u.  Fixed a bug in the `kill' builtin that mishandled negative pid arguments.
3202
3203 v.  The parser is less lenient when parsing assignment statements where the
3204     characters before the `=' don't comprise a valid identifier.
3205
3206 w.  The arithmetic expression evaluation code now honors the setting of the
3207     `-u' option when expanding variable names.
3208
3209 x.  Fixed the arithmetic evaluation code to allow array subscripts to be
3210     assigned (`let b[7]=42') and auto-incremented and auto-decremented
3211     (e.g., b[7]++).
3212
3213 y.  Reimplemented the existing prompt string date and time expansions using
3214     strftime(3), which changed the output of \@ in some locales.
3215
3216 z.  Fixed a bug that could cause a core dump when a special shell variable
3217     (like RANDOM) was converted to an array with a variable assignment.
3218
3219 aa. Fixed a bug that would reset the handler for a signal the user had
3220     trapped to a function that would exit the shell when setting the exit
3221     trap in a non-interactive shell.
3222
3223 bb. Changed the execve(2) wrapper code to check whether or not a failing
3224     command is a directory before looking at whether a `#!' interpreter
3225     failed for some reason.
3226
3227 cc. Fixed a bug in the command printing code so it no longer inserts a `;'
3228     after a newline, which produces a syntax error when reused as input.
3229
3230 dd. The code that expands $PS4 no longer inherits the `-x' flag.
3231
3232 ee. The bash-specific completion functions may now take advantage of the
3233     double-TAB and M-?  features of the standard readline completion
3234     functions.
3235
3236 ff. The mail checking code no longer prints a message if the checked file's
3237     size has not increased, even if the access time is less than the modification time.
3238
3239 gg. Rewrote the variable symbol table code: there is now a stack of
3240     contexts, each possibly including a separate symbol table; there can
3241     be more than one temporary environment supplied to nested invocations
3242     of `./source'; the temporary environments no longer require so much
3243     special-case code; shell functions now handle the temporary environment
3244     and local variables more consistently; function scope exit is faster now
3245     that the entire symbol table does not have to be traversed to dispose of
3246     local variables; it is now easier to push vars from the temporary
3247     environment to the shell's variable table in posix mode; some duplicated
3248     code has been removed.
3249
3250 hh. Regularized the error message printing code; builtin_error is now called
3251     more consistently, and common error message strings are handled by small
3252     functions.  This should make eventual message translation easier.
3253
3254 ii. Error messages now include the line number in a script when the shell
3255     is not interactive.
3256
3257 jj. Array subscript expansion now takes place even when the array variable is
3258     unset, so side effects will take place.
3259
3260 kk. Fixed a bug in the SICGHLD child-reaping code so that it won't find
3261     jobs already marked as terminated if the OS reuses pids quickly enough.
3262
3263 ll. Fixed a bug that could cause a signal to not interrupt the `wait'
3264     builtin while it was waiting for a background process to terminate.
3265
3266 mm. A couple of changes to make it easier for multiple shells to share history
3267     files using `history -n', `history -r', and `history -w'.
3268
3269 nn. The `getopts' builtin always increments OPTIND to point to the next
3270     option to be handled when an option is returned, whether it's valid
3271     or not, as POSIX 1003.x-2001 requires.
3272
3273 oo. Changed some parts of the expansion code to avoid allocating and
3274     immediately freeing memory without using the results for anything.
3275
3276 pp. The shell now keeps track of $IFS internally, updating its internal map
3277     each time the variable is assigned a new value (or at local scope exit).
3278     This saves thousands of hash lookups for IFS, which, while individually
3279     cheap, add up.
3280
3281 qq. Rewrote the hash table code:  searching and insertion are much faster now,
3282     and it uses a better string hashing function; augmented the function
3283     interface to simplify other parts of the code and remove duplicated code
3284
3285 rr. The shell now uses a simple, generic `object cache' for allocating and
3286     caching words and word lists, which were the major users of
3287     malloc/free.
3288
3289 ss. Fixed the assignment statement parsing code to allow whitespace and
3290     newlines in subscripts when performing array element assignment.
3291
3292 tt. The shell now issues many fewer calls to sigprocmask and other signal
3293     masking system calls.
3294
3295 uu. Fixed the `test' and conditional command file comparison operators to
3296     work right when one file has a non-positive timestamp and the other
3297     does not exist.
3298
3299 vv. Fixed some cases where the special characters '\001' and '\177' in the
3300     values of variables or positional parameters caused incorrect expansion
3301     results.
3302
3303 2.  Changes to Readline
3304
3305 a.  Fixed output of comment-begin character when listing variable values.
3306
3307 b.  Added some default key bindings for common escape sequences produced by
3308     HOME and END keys.
3309
3310 c.  Fixed the mark handling code to be more emacs-compatible.
3311
3312 d.  A bug was fixed in the code that prints possible completions to keep it
3313     from printing empty strings in certain circumstances.
3314
3315 e.  Change the key sequence printing code to print ESC as M\- if ESC is a
3316     meta-prefix character -- it's easier for users to understand than \e.
3317
3318 f.  Fixed unstifle_history() to return values that match the documentation.
3319
3320 g.  Fixed the event loop (rl_event_hook) to handle the case where the input
3321     file descriptor is invalidated.
3322
3323 h.  Fixed the prompt display code to work better when the application has a
3324     custom redisplay function.
3325
3326 i.  Changes to make reading and writing the history file a little faster, and
3327     to cope with huge history files without calling abort(3) from xmalloc.
3328
3329 j.  The vi-mode `S' and `s' commands are now undone correctly.
3330
3331 3.  New Features in Bash
3332
3333 a.  If set, TMOUT is the default timeout for the `read' builtin.
3334
3335 b.  `type' has two new options:  `-f' suppresses shell function lookup, and
3336     `-P' forces a $PATH search.
3337
3338 c.  New code to handle multibyte characters.
3339
3340 d.  `select' was changed to be more ksh-compatible, in that the menu is
3341     reprinted each time through the loop only if REPLY is set to NULL.
3342     The previous behavior is available as a compile-time option.
3343
3344 e.  `complete -d' and `complete -o dirnames' now force a slash to be
3345     appended to names which are symlinks to directories.
3346
3347 f.  There is now a bindable edit-and-execute-command readline command,
3348     like the vi-mode `v' command, bound to C-xC-e in emacs mode.
3349
3350 g.  Added support for ksh93-like [:word:] character class in pattern matching.
3351
3352 h.  The  $'...' quoting construct now expands \cX to Control-X.
3353
3354 i.  A new \D{...} prompt expansion; passes the `...' to strftime and inserts
3355     the result into the expanded prompt.
3356
3357 j.  The shell now performs arithmetic in the largest integer size the
3358     machine supports (intmax_t), instead of long.
3359
3360 k.  If a numeric argument is supplied to one of the bash globbing completion
3361     functions, a `*' is appended to the word before expansion is attempted.
3362
3363 l.  The bash globbing completion functions now allow completions to be listed
3364     with double tabs or if `show-all-if-ambiguous' is set.
3365
3366 m.  New `-o nospace' option for `complete' and `compgen' builtins; suppresses
3367     readline's appending a space to the completed word.
3368
3369 n.  New `here-string' redirection operator:  <<< word.
3370
3371 o.  When displaying variables, function attributes and definitions are shown
3372     separately, allowing them to be re-used as input (attempting to re-use
3373     the old output would result in syntax errors).
3374
3375 p.  There is a new configuration option `--enable-mem-scramble', controls
3376     bash malloc behavior of writing garbage characters into memory at
3377     allocation and free time.
3378
3379 q.  The `complete' and `compgen' builtins now have a new `-s/-A service'
3380     option to complete on names from /etc/services.
3381
3382 r.  `read' has a new `-u fd' option to read from a specified file descriptor.
3383
3384 s.  Fix the completion code so that expansion errors in a directory name
3385     don't cause a longjmp back to the command loop.
3386
3387 t.  Fixed word completion inside command substitution to work a little more
3388     intuitively.
3389
3390 u.  The `printf' %q format specifier now uses $'...' quoting to print the
3391     argument if it contains non-printing characters.
3392
3393 v.  The `declare' and `typeset' builtins have a new `-t' option.  When applied
3394     to functions, it causes the DEBUG trap to be inherited by the named
3395     function.  Currently has no effect on variables.
3396
3397 w.  The DEBUG trap is now run *before* simple commands, ((...)) commands,
3398     [[...]] conditional commands, and for ((...)) loops.
3399
3400 x.  The expansion of $LINENO inside a shell function is only relative to the
3401     function start if the shell is interactive -- if the shell is running a
3402     script, $LINENO expands to the line number in the script.  This is as
3403     POSIX-2001 requires.
3404
3405 y.  The bash debugger in examples/bashdb has been modified to work with the
3406     new DEBUG trap semantics, the command set has been made more gdb-like,
3407     and the changes to $LINENO make debugging functions work better.  Code
3408     from Gary Vaughan.
3409
3410 z.  New [n]<&word- and [n]>&word- redirections from ksh93 -- move fds (dup
3411     and close).
3412
3413 aa. There is a new `-l' invocation option, equivalent to `--login'.
3414
3415 bb. The `hash' builtin has a new `-l' option to list contents in a reusable
3416     format, and a `-d' option to remove a name from the hash table.
3417
3418 4.  New Features in Readline
3419
3420 a.  Support for key `subsequences':  allows, e.g., ESC and ESC-a to both
3421     be bound to readline functions.  Now the arrow keys may be used in vi
3422     insert mode.
3423
3424 b.  When listing completions, and the number of lines displayed is more than
3425     the screen length, readline uses an internal pager to display the results.
3426     This is controlled by the `page-completions' variable (default on).
3427
3428 c.  New code to handle editing and displaying multibyte characters.
3429
3430 d.  The behavior introduced in bash-2.05a of deciding whether or not to
3431     append a slash to a completed name that is a symlink to a directory has
3432     been made optional, controlled by the `mark-symlinked-directories'
3433     variable (default is the 2.05a behavior).
3434
3435 e.  The `insert-comment' command now acts as a toggle if given a numeric
3436     argument:  if the first characters on the line don't specify a
3437     comment, insert one; if they do, delete the comment text
3438
3439 f.  New application-settable completion variable:
3440     rl_completion_mark_symlink_dirs, allows an application's completion
3441     function to temporarily override the user's preference for appending
3442     slashes to names which are symlinks to directories.
3443
3444 g.  New function available to application completion functions:
3445     rl_completion_mode, to tell how the completion function was invoked
3446     and decide which argument to supply to rl_complete_internal (to list
3447     completions, etc.).
3448
3449 h.  Readline now has an overwrite mode, toggled by the `overwrite-mode'
3450     bindable command, which could be bound to `Insert'.
3451
3452 i.  New application-settable completion variable:
3453     rl_completion_suppress_append, inhibits appending of
3454     rl_completion_append_character to completed words.
3455
3456 j.  New key bindings when reading an incremental search string:  ^W yanks
3457     the currently-matched word out of the current line into the search
3458     string; ^Y yanks the rest of the current line into the search string,
3459     DEL or ^H deletes characters from the search string.
3460
3461 ------------------------------------------------------------------------------
3462 This document details the changes between this version, bash-2.05a-release,
3463 and the previous version, bash-2.05a-rc1.
3464
3465 1.  Changes to Bash
3466
3467 a.  Fixed the `printf' builtin so that the variable name supplied as an
3468     argument to a %n conversion must be a valid shell identifier.
3469
3470 b.  Improved the random number generator slightly.
3471
3472 c.  Changes to configuration to not put -I/usr/include into $CFLAGS, since
3473     it messes up some includes.
3474
3475 d.  Corrected description of POSIXLY_CORRECT in man page and info manual.
3476
3477 e.  Fixed a couple of cases of incorrect function prototypes that sneaked
3478     through and caused compilation problems.
3479
3480 f.  A few changes to avoid potential core dumps in the programmable completion
3481     code.
3482
3483 g.  Fixed a configure problem that could cause a non-existent file to show
3484     up in LIBOBJS.
3485
3486 h.  Fixed a configure problem that could cause siglist.o to not be built when
3487     required.
3488
3489 i.  Changes to the strtoimax and strtoumax replacement functions to work
3490     around buggy compilers.
3491
3492 j.  Fixed a problem with the snprintf replacement function that could
3493     potentially cause a core dump.
3494
3495 2.  Changes to Readline
3496
3497 a.  Fixed a locale-specific problem in the vi-mode `goto mark' command.
3498
3499 b.  Fixed Makefile to not put -I/usr/include into CFLAGS, since it can cause
3500     include file problems.
3501
3502 ------------------------------------------------------------------------------
3503 This document details the changes between this version, bash-2.05a-rc1,
3504 and the previous version, bash-2.05a-beta1.
3505
3506 1.  Changes to Bash
3507
3508 a.  Fixed the snprintf replacement to correctly implement the `alternate form'
3509     of the %g and %G conversions.
3510
3511 b.  Fixed snprintf to correctly handle the optional precision with the %g and
3512     %G conversions.
3513
3514 c.  Fixed the arithmetic evaluation code to correct the values of `@' and `_'
3515     when translating base-64 constants (they were backwards).
3516
3517 d.  New library functions for formatting long and long long ints.
3518
3519 e.  Fixed a few places where negative array subscripts could have occurred,
3520     mostly as the result of systems using signed characters.
3521
3522 f.  Fixed a few places that assumed a pid_t was no wider than an int.
3523
3524 g.  Fixed the `maildir' mail checking code to work on systems where a
3525     `struct stat' doesn't include an `st_blocks' member.
3526
3527 h.  Fixed snprintf to make `unsigned long long' conversion formats (%llu)
3528     work better.
3529
3530 i.  Fixed snprintf to not print a sign when asked to do an unsigned conversion.
3531
3532 j.  Made configure changes to avoid compiling empty source files in lib/sh.
3533
3534 k.  New replacement functions (if necessary) for strtoull, strtoll, strtoimax,
3535     strtoumax.
3536
3537 l.  The `printf' builtin now handles the `ll' and `j' length modifiers
3538     directly, since they can affect the type and width of the argument
3539     passed to printf(3).
3540
3541 m.  Renamed a number of the bash-specific autoconf macros in aclocal.m4 to
3542     have more sytematic naming, with accompanying changes to configure.in.
3543
3544 n.  Fixed snprintf to handle long doubles and the %a/%A conversions by
3545     falling back to sprintf, as long as sprintf supports them.
3546
3547 o.  Fixed return value from vsnprintf/snprintf to be the number of characters
3548     that would have been printed, even if that number exceeds the buffer
3549     size passed as an argument.
3550
3551 p.  Bash no longer attempts to define its own versions of some ctype macros
3552     if they are implemented as functions in libc but not as macros in
3553     <ctype.h>.
3554
3555 q.  Changed the variable printing code (used by `set', `export', etc.) to
3556     not use the $'...' syntax when in posix mode, since that caused
3557     interoperability problems with other shells (most notably with autoconf).
3558     When not in posix mode, it uses $'...' if the string to be printed
3559     contains non-printing characters and regular single quotes otherwise.
3560
3561 r.  snprintf now recognizes the %F conversion.
3562
3563 s.  Fixed a bug that could cause the wrong status to be returned by a shell
3564     function when the shell is compiled without job control and a null
3565     command containing a command substutition was executed in the function.
3566
3567 t.  When in posix mode, the default value for MAILCHECK is 600.
3568
3569 u.  Bash only initializes FUNCNAME, GROUPS, and DIRSTACK as special variables
3570     if they're not in the initial environment.
3571
3572 v.  If SECONDS appears in the initial environment with a valid integer value,
3573     bash uses that as the starting value, as if an assignment had been
3574     performed.
3575
3576 w.  Bash no longer auto-exports HOME, PATH, SHELL, or TERM, even though it
3577     gives them default values if they don't appear in the initial environment.
3578
3579 x.  Bash no longer auto-exports HOSTNAME, HOSTTYPE, MACHTYPE, or OSTYPE,
3580     even if it assigns them default values.
3581
3582 y.  Bash no longer removes the export attribute from SSH_CLIENT or SSH2_CLIENT
3583     if they appear in the initial environment.
3584
3585 z.  Bash no longer attempts to discover if it's being run by sshd in order to
3586     run the startup files.  If the SSH_SOURCE_BASHRC is uncommented in
3587     config-top.h it will attempt to do so as previously, but that's commented
3588     out in the distributed version.
3589
3590 aa. Fixed a typo in the code that tests for LC_NUMERIC.
3591
3592 bb. The POSIXLY_CORRECT shell variable and its effects are now documented.
3593
3594 cc. Some changes to several of the support shell scripts included in the
3595     definitions to try to avoid race conditions and attacks.
3596
3597 dd. Several changes to avoid warnings from `gcc -Wall'.
3598
3599 ee. Fixed a problem with the `unset' builtin that could cause incorrect
3600     results if asked to unset a variable and an array subscript in the
3601     same command.
3602
3603 ff. A few changes to the shell's temporary file creation code to avoid
3604     potential file descriptor leaks and to prefer the system's idea of
3605     the temporary directory to use.
3606
3607 gg. Fixes to build with the C alloca in lib/malloc/alloca.c if the system
3608     requires it but the shell has been configured --without-bash-malloc.
3609
3610 hh. Updated the documentation to note that only interactive shells resend
3611     SIGHUP to all jobs before exiting.
3612
3613 ii. Fixes to only pass unquoted tilde words to tilde_expand, rather than
3614     rely on tilde_expand or getpwnam(3) to handle the quotes (MacOS 10.x
3615     will remove backslashes in any login name passed to getpwnam(3)).
3616
3617 jj. Small change from Paul Eggert to make LINENO right in commands run with
3618     `bash -c'.
3619
3620 2.  New Features in Bash
3621
3622 a.  The `printf' builtin now handles the %a and %A conversions if they're
3623     implemented by printf(3).
3624
3625 b.  The `printf' builtin now handles the %F conversion (just about like %f).
3626
3627 c.  The `printf' builtin now handles the %n conversion like printf(3).  The
3628     corresponding argument is the name of a shell variable to which the
3629     value is assigned.
3630
3631 3.  Changes to Readline
3632
3633 a.  Fixed a few places where negative array subscripts could have occurred.
3634
3635 b.  Fixed the vi-mode code to use a better method to determine the bounds of
3636     the array used to hold the marks.
3637
3638 c.  Fixed the defines in chardefs.h to work better when chars are signed.
3639
3640 d.  Fixed configure.in to use the new names for bash autoconf macros.
3641
3642 e.  Readline no longer attempts to define its own versions of some ctype
3643     macros if they are implemented as functions in libc but not as macros in
3644     <ctype.h>.
3645
3646 f.  Fixed a problem where rl_backward could possibly set point to before
3647     the beginning of the line.
3648
3649 ------------------------------------------------------------------------------
3650 This document details the changes between this version, bash-2.05a-beta1,
3651 and the previous version, bash-2.05a-alpha1.
3652
3653 1.  Changes to Bash
3654
3655 a.  Fixed a bug in the evalution of arithmetic `for' statements when the
3656     expanded expression is NULL.
3657
3658 b.  Fixed an unassigned variable problem in the redirection printing code.
3659
3660 c.  Added more prototypes to extern function declarations in the header
3661     files and to static function declarations in C source files.
3662
3663 d.  Make sure called functions have a prototype in scope, to get the arguments
3664     and return values right instead of casting.  Removed extern function
3665     declarations from C source files that were already included in header
3666     files.
3667
3668 e.  Changed some function arguments to use function typedefs in general.h so
3669     the prototypes can be checked.  The only use of Function and VFunction
3670     now is for unwind-protects.
3671
3672 f.  More const changes to function arguments and appropriate variables.
3673
3674 g.  Changed the mail checking support to handle `maildir'-style mail
3675     directories.
3676
3677 h.  Augmented the bash malloc to pass in the file and line number information
3678     for each malloc, realloc, and free.  This should result in better error
3679     messages.
3680
3681 i.  The `old' gnu malloc is no longer a configuration option.
3682
3683 j.  Augmented the bash malloc with optional tracing and registering allocated
3684     and freed memory.
3685
3686 k.  Prompt string decoding now saves and restores the value of $? when it
3687     expands the prompt string, so command substitutions don't change $?.
3688
3689 i.  Array indices are now `long', since shell arithmetic is performed as long,
3690     and the internal arrayind_t type is used consistently.
3691
3692 j.  Some more `unsigned char *' fixes from Paul Eggert.
3693
3694 k.  Fixed a bad call to builtin_error that could cause core dumps when making
3695     local variables.
3696
3697 l.  `return' may no longer be used to terminate a `select' command, for
3698     compatibility with ksh.
3699
3700 m.  Changed code that reads octal numbers to do a better job of detecting
3701     overflows.
3702
3703 n.  The time formatting code no longer uses absolute indices into a buffer,
3704     because the buffer size changes depending on the size of a `time_t'.
3705
3706 o.  `umask' now prints four digits when printing in octal mode, for
3707     compatibility with other shells.
3708
3709 p.  Lots of changes to the `printf' builtin from Paul Eggert:  it handles `L'
3710     formats and long doubles better, and internal functions have been
3711     simpified where appropriate.
3712
3713 q.  Some `time_t' fixes for machines were a time_t is bigger than a long.
3714
3715 r.  Replaced some bash-specific autoconf macros with standard equivalents.
3716
3717 s.  Improvmed the code that constructs temporary filenames to make the
3718     generated names a bit more random.
3719
3720 t.  Added code that checks for ascii before calling any of the is* ctype
3721     functions.
3722
3723 u.  Changed some places where a `char' was used as an array subscript to use
3724     `unsigned char', since a `char' can be negative if it's signed by default.
3725
3726 v.  Lots of changes to the `ulimit' builtin from Paul Eggert to add support
3727     for the new POSIX-200x RLIM_SAVED_CUR and RLIM_SAVED_MAX values and
3728     simplify the code.
3729
3730 w.  `ulimit' now prints the description of a resource in any error message
3731     relating to fetching or setting that resource's limits.
3732
3733 x.  The `snprintf' replacement now computes maximum values at compile
3734     time rather than using huge constants for things like long long.
3735
3736 y.  Interactive shells now ignore `set -n'.
3737
3738 z.  Changed the malloc bookkeeping information so that it's now 8 bytes
3739     instead of 12 on most 32-bit machines (saving 4 bytes per allocation),
3740     restoring 8-byte alignment.
3741
3742 aa. The malloc error reporting code now attempts to print the file and line
3743     number of the call that caused the error.
3744
3745 bb. Changed the redirection error reporting code to catch EBADF errors and
3746     report the file descriptor number rather than the file being redirected
3747     to or from (e.g., things like `exec 4242<x' where 4242 is an out-of-range
3748     file descriptor).
3749
3750 cc. `printf', `echo -e', and the $'...' code now process only two hex digits
3751     after a `\x' escape sequence for compatibility with other shells, and
3752     the documentation was changed to note that the octal and hex escape
3753     sequences result in an eight-bit value rather than strict ASCII.
3754
3755 2.  Changes to Readline
3756
3757 a.  The completion code now attempts to do a better job of preserving the
3758     case of the word the user typed if ignoring case in completions.
3759
3760 b.  Readline defaults to not echoing the input and lets the terminal
3761     initialization code enable echoing if there is a controlling terminal.
3762
3763 c.  The key binding code now processes only two hex digits after a `\x'
3764     escape sequence, and the documentation was changed to note that the
3765     octal and hex escape sequences result in an eight-bit value rather
3766     than strict ASCII.
3767
3768 3.  New Features in Bash
3769
3770 a.  The builtin `ulimit' now takes two new non-numeric arguments:  `hard',
3771     meaning the current hard limit, and `soft', meaning the current soft
3772     limit, in addition to `unlimited'
3773
3774 b.  `ulimit' now prints the option letter associated with a particular
3775     resource when printing more than one limit.
3776
3777 c.  `ulimit' prints `hard' or `soft' when a value is not `unlimited' but is
3778     one of RLIM_SAVED_MAX or RLIM_SAVED_CUR, respectively.
3779
3780 4.  New Features in Readline
3781
3782 a.  New bindable variable `history-preserve-point'.  If set, the history
3783     code attempts to place the user at the same location on each history
3784     line retrived with previous-history or next-history.
3785
3786 ------------------------------------------------------------------------------
3787 This document details the changes between this version, bash-2.05a-alpha1,
3788 and the previous version, bash-2.05-release.
3789
3790 1.  Changes to Bash
3791
3792 a.  Better checks in the redirection code for write errors.
3793
3794 b.  bashbug now uses $TMPDIR, defaulting to /tmp, and uses mktemp(1) more
3795     portably.
3796
3797 c.  System-specific configuration changes for:  Interix, OpenBSD, FreeBSD,
3798     MacOS X.
3799
3800 d.  Some more `const' cleanups through the code.
3801
3802 e.  Fixed a typo in the /dev/fd redirection code, better checks for valid
3803     numeric fds in /dev/fd.
3804
3805 f.  Fixed many parts of the shell to handle integer overflow more gracefully
3806     and to do more stringent checks for valid numbers.
3807
3808 g.  Fixed mksignames to include config.h.
3809
3810 h.  Fixed an uninitialized variable problem that could cause the shell to core
3811     dump when replacing characters in a string.
3812
3813 i.  New mechanism for updating the patch level when official patches are
3814     released (patchlevel.h).
3815
3816 j.  configure.in changed to no longer require external files _distribution and
3817     _patchlevel.
3818
3819 k.  Fixed non-interactive shell initialization problem when bash started as
3820     `bash -i filename'.
3821
3822 l.  Fixed printf builtin conversion error handling to be POSIX.2-conformant.
3823
3824 m.  autoconf-2.52 is now used to build configure; autoconf-2.50 or newer is
3825     required.  Some of the bash-specific macros were removed, since they are
3826     now standard.
3827
3828 n.  Startup files and files read with source or `.' are no longer required to
3829     be regular files.
3830
3831 o.  Fixed core dump in builtin printf when user-supplied precision or field
3832     width is 0.
3833
3834 p.  Fixed builtin printf to treat a negative field width as a positive field
3835     width with left-justification.
3836
3837 r.  New unwind-protect implementation from Paul Eggert.
3838
3839 s.  Fixed an inadvertently-unclosed comment in the bash completion code that
3840     caused programmable completions to not add trailing slashes or spaces to
3841     completions.
3842
3843 t.  Fixed the process substitution code to cope better when stdin is closed.
3844
3845 v.  Fixes, mostly from Paul Eggert, for a few possible buffer overflows in
3846     the shell.
3847
3848 w.  Fixes from Paul Eggert to avoid most of the type casts in the shell code,
3849     and use more appropriate types for a number of variables.
3850
3851 x.  Command substition no longer inherits the DEBUG trap.
3852
3853 y.  Some fixes to the process substition code on machines without /dev/fd so
3854     that named pipes are not removed inappropriately.
3855
3856 z.  The loadable `getconf' builtin is now much more complete, and will become
3857     part of the shell in the future.
3858
3859 aa. The select command no longer terminates on a `return', so it can be used
3860     to return from an enclosing function (as ksh does it).
3861
3862 bb. Fixed the extended pattern matching code to behave better when presented
3863     with incorrectly-formed patterns.
3864
3865 cc. Some changes were made with the intent of making cross-compilation easier.
3866
3867 dd. The network code (/dev/tcp and /dev/udp redirections) uses getaddrinfo(3)
3868     if it's available, which adds support for IPv6.
3869
3870 ee. Subshells of login shells no longer source ~/.bash_logout when they exit.
3871
3872 ff. Fixes so that subshells don't exit inappropriately if the -e option has
3873     been set.
3874
3875 gg. Restricted shells no longer allow functions to be exported.
3876
3877 hh. Changes to the pattern matching code so extended pattern matching works
3878     on systems with deficient shared library implementations, like MacOS X.
3879
3880 ii. Better error messages when a script with a leading `#!interp' fails
3881     to execute because of problems with `interp'.
3882
3883 jj. Fixed `compgen' to handle the `-o default' option better.
3884
3885 kk. Fixed the job control code to force an asynchronous process's standard
3886     input to /dev/null only if job control is not active.
3887
3888 ll. Fixed a possible infinite recursion problem when `fc ""=abc' (a null
3889     pattern) is used to re-execute a previous command.
3890
3891 mm. Fixed `declare [-a] var=value' to assign VALUE to element 0 if VAR is an
3892     array variable.  Similarly for `declare [-a] var[N]=value'.  This is like
3893     ksh93.
3894
3895 nn. Fixed a bug that caused `read -a aname' to work even if ANAME had been
3896     declared readonly.
3897
3898 oo. Fixed a possible integer overflow problem when constructing names for
3899     temporary files.
3900
3901 2.  New Features in Bash
3902
3903 a.  Added support for DESTDIR installation root prefix, so you can do a
3904     `make install DESTDIR=bash-root' and do easier binary packaging.
3905
3906 b.  Added support for builtin printf "'" flag character as per latest POSIX
3907     drafts.
3908
3909 c.  Support for POSIX.2 printf(1) length specifiers `j', `t', and `z' (from
3910     ISO C99).
3911
3912 d.  New autoconf macro, RL_LIB_READLINE_VERSION, for use by other applications
3913     (bash doesn't use very much of what it returns).
3914
3915 e.  `set [-+]o nolog' is recognized as required by the latest POSIX drafts,
3916     but ignored.
3917
3918 f.  New read-only `shopt' option:  login_shell.  Set to non-zero value if the
3919     shell is a login shell.
3920
3921 g.  New `\A' prompt string escape sequence; expands to time in 24 HH:MM format.
3922
3923 h.  New `-A group/-g' option to complete and compgen; does group name
3924     completion.
3925
3926 i.  New `-t' option to `hash' to list hash values for each filename argument.
3927
3928 j.  New [-+]O invocation option to set and unset `shopt' options at startup.
3929
3930 k.  configure's `--with-installed-readline' option now takes an optional
3931     `=PATH' suffix to set the root of the tree where readline is installed
3932     to PATH.
3933
3934 l.  The ksh-like `ERR' trap has been added.  The `ERR' trap will be run
3935     whenever the shell would have exited if the -e option were enabled.
3936     It is not inherited by shell functions.
3937
3938 m.  `readonly', `export', and `declare' now print variables which have been
3939     given attributes but not set by assigning a value as just a command and
3940     a variable name (like `export foo') when listing, as the latest POSIX
3941     drafts require.
3942
3943 n.  `bashbug' now requires that the subject be changed from the default.
3944
3945 o.  configure has a new `--enable-largefile' option, like other GNU utilities.
3946
3947 p.  `for' loops now allow empty word lists after `in', like the latest POSIX
3948     drafts require.
3949
3950 3.  Changes to Readline
3951
3952 a.  More `const' and type casting fixes.
3953
3954 b.  Changed rl_message() to use vsnprintf(3) (if available) to fix buffer
3955     overflow problems.
3956
3957 c.  The completion code no longer appends a `/' or ` ' to a match when
3958     completing a symbolic link that resolves to a directory name, unless
3959     the match does not add anything to the word being completed.  This
3960     means that a tab will complete the word up to the full name, but not
3961     add anything, and a subsequent tab will add a slash.
3962
3963 d.  Fixed a trivial typo that made the vi-mode `dT' command not work.
3964
3965 e.  Fixed the tty code so that ^S and ^Q can be inserted with rl_quoted_insert.
3966
3967 f.  Fixed the tty code so that ^V works more than once.
3968
3969 g.  Changed the use of __P((...)) for function prototypes to PARAMS((...))
3970     because the use of __P in typedefs conflicted g++ and glibc.
3971
3972 4.  New Features in Readline
3973
3974 a.  Added extern declaration for rl_get_termcap to readline.h, making it a
3975     public function (it was always there, just not in readline.h).
3976
3977 b.  New #defines in readline.h:  RL_READLINE_VERSION, currently 0x0402,
3978     RL_VERSION_MAJOR, currently 4, and RL_VERSION_MINOR, currently 2.
3979
3980 c.  New readline variable:  rl_readline_version, mirrors RL_READLINE_VERSION.
3981
3982 d.  New bindable boolean readline variable:  match-hidden-files.  Controls
3983     completion of files beginning with a `.' (on Unix).  Enabled by default.
3984
3985 e.  The history expansion code now allows any character to terminate a
3986     `:first-' modifier, like csh.
3987
3988 f.  The incremental search code remembers the last search string and uses
3989     it if ^R^R is typed without a search string.
3990
3991 ------------------------------------------------------------------------------
3992 This document details the changes between this version, bash-2.05-release,
3993 and the previous version, bash-2.05-beta2.
3994
3995 1.  Changes to Bash
3996
3997 a.  Make sure we note that the first line of a multi-line command was not
3998     saved in the history if the tests for HISTCONTROL succeed, but the
3999     HISTIGNORE check fails.
4000
4001 b.  Fixed a bug in the pattern matching code that caused `[' to be treated
4002     as a special character inside a `[...]' bracket expression.
4003
4004 c.  Fixed a bug in the pattern matching code that caused `]' to terminate
4005     a bracket expression even if it was the first character after the `['
4006     (or a leading `!' or `^').
4007
4008 d.  Made a small change to report a more user-friendly error message if
4009     execve(2) fails because of an error with the interpreter in a script
4010     with a leading `#! interpreter'.
4011
4012 e.  If the OS does not support an exec(2) magic number of `#!', make sure we
4013     have a non-null interpreter name before attempting to execute it.
4014
4015 f.  Fixed a bug that caused the shell process to end up in a different
4016     process group than the controlling terminal if a job-control shell was
4017     run with `exec' in the startup files.
4018
4019 g.  When started in POSIX mode, either by `bash --posix', `bash -o posix', or
4020     `sh', $SHELLOPTS includes `posix' and POSIXLY_CORRECT is set.
4021
4022 h.  Fixed a problem that caused the `\W' prompt string escape sequence to
4023     expand to nothing when $PWD was `//'.
4024
4025 i.  The `bashbug' shell script no longer uses $(...) command substitution.
4026
4027 j.  When `set' is invoked without options in POSIX mode, it no longer prints
4028     the names and definitions of shell functions.
4029
4030 2.  Changes to Readline
4031
4032 a.  rl_set_paren_blink_timeout() is now documented.
4033
4034 b.  Corrected history.3 man page: `$' is not in the default value of
4035     history_word_delimiters.
4036
4037 c.  If a hook function assigned to rl_event_hook sets rl_done to a non-zero
4038     value, rl_read_key() now immediately returns '\n' (which is assumed to
4039     be bound to accept-line).
4040
4041 3.  New Features in Bash
4042
4043 a.  The `>&word' redirection now works in POSIX mode as it does by default,
4044     since POSIX.2 leaves it unspecified.
4045
4046 ------------------------------------------------------------------------------
4047 This document details the changes between this version, bash-2.05-beta2,
4048 and the previous version, bash-2.05-beta1.
4049
4050 1.  Changes to Bash
4051
4052 a.  Fixed a bug in the arithmetic evaluation code so that a^=b is supported.
4053
4054 b.  Fixed startup so posixly_correct is retained across subshells begun to
4055     execute scripts without a leading `#!'.
4056
4057 c.  Fixed a bug that caused $(< file) to not work in a (...) subshell.
4058
4059 d.  Added config support for Linux running on the IBM S390.
4060
4061 e.  Fixed a bug that caused bash to get its input pointer out of sync when
4062     reading commands through a pipe and running a command with standard
4063     input redirected from a file.
4064
4065 f.  Made a change so that command completion now makes about half as many
4066     stat(2) calls when searching the $PATH.
4067
4068 g.  Fixed a bug that caused variable assignments preceding `return' to not
4069     be propagated to the shell environment in POSIX mode.
4070
4071 h.  Fixed a bug with ${parameter[:]?word} -- tilde expansion was not performed
4072     on `word'.
4073
4074 i.  In POSIX mode, `break' and `continue' do not complain and return success
4075     if called when the shell is not executing a loop.
4076
4077 j.  Fixed `bash -o posix' to work the same as `bash --posix'.
4078
4079 k.  Fixed a bug where variable assignments preceding `eval' or `source/.'
4080     would not show up in the environment exported to subshells run by the
4081     commands.
4082
4083 l.  In POSIX mode, shells started to execute command substitutions inherit
4084     the value of the `-e' option from their parent shell.
4085
4086 m.  In POSIX mode, aliases are expanded even in non-interactive shells.
4087
4088 n.  Changed some of the job control messages to display the text required by
4089     POSIX.2 when the shell is in POSIX mode.
4090
4091 o.  Fixed a bug in `test' that caused it to occasionally return incorrect
4092     results when non-numeric arguments were supplied to `-t'.
4093
4094 2.  Changes to Readline
4095
4096 a.  Some changes were made to avoid gcc warnings with -Wall.
4097
4098 b.  rl_get_keymap_by_name now finds keymaps case-insensitively, so
4099     `set keymap EMACS' works.
4100
4101 c.  The history file writing and truncation functions now return a useful
4102     status on error.
4103
4104 d.  Fixed a bug that could cause applications to dereference a NULL pointer
4105     if a NULL second argument was passed to history_expand().
4106
4107 3.  New Features in Bash
4108
4109 a.  doc/readline.3 has been moved to the readline distribution.
4110
4111 4.  New Features in Readline
4112
4113 a.  New function, rl_get_screen_size (int *rows, int *columns), returns
4114     readline's idea of the screen dimensions.
4115
4116 b.  The timeout in rl_gather_tyi (readline keyboard input polling function)
4117     is now settable via a function (rl_set_keyboard_input_timeout()).
4118
4119 c.  Renamed the max_input_history variable to history_max_entries; the old
4120     variable is maintained for backwards compatibility.
4121
4122 d.  The list of characters that separate words for the history tokenizer is
4123     now settable with a variable:  history_word_delimiters.  The default
4124     value is as before.
4125
4126 ------------------------------------------------------------------------------
4127 This document details the changes between this version, bash-2.05-beta1,
4128 and the previous version, bash-2.05-alpha1.
4129
4130 1.  Changes to Bash
4131
4132 a.  Changes to allow shared library and object building on the GNU Hurd.
4133
4134 b.  Fixes to the way exported functions are placed into the environment and
4135     cached.
4136
4137 c.  The globbing library once again respects locales when processing ranges
4138     in bracket expressions while doing pattern matching.
4139
4140 d.  System-specific configuration changes for:  Tru 64, Interix
4141
4142 e.  Bashbug now uses /usr/bin/editor as one of the editing alternatives, and
4143     will use mktemp(1) or tempfile(1), if present, for temporary file creation.
4144
4145 f.  Bash no longer performs a binary file check on a script argument that's
4146     really a tty (like /dev/fd/0 or /dev/stdin).
4147
4148 g.  Fixed a bug in the execution of shell scripts that caused the effects of
4149     $BASH_ENV to be undone in some cases.
4150
4151 h.  Fixed several bugs that made `bash [-i] /dev/stdin' not work correctly.
4152
4153 i.  Several changes to the job control code to avoid some signal state
4154     manipulation.
4155
4156 j.  The Bash malloc no longer blocks signals as often, which should make it
4157     faster.
4158
4159 k.  Fixed a parsing bug that did not allow backslash to escape a single quote
4160     inside a $'...' construct.
4161
4162 l.  Fixed a bug that caused things like ${var:=$'value'} to be parsed
4163     incorrectly.  This showed up in newer versions of autoconf.
4164
4165 m.  Fixed a bug in the bash-specific readline initialization that caused
4166     key bindings to bash-specific function names appearing in .inputrc to
4167     not be honored.
4168
4169 n.  Bash now sets the file descriptor it uses to save the file descriptor
4170     opened on a shell script to close on exec.
4171
4172 o.  Fixed a bug in the prompt string decoding that caused it to misbehave
4173     when presented an octal sequence of fewer than three characters.
4174
4175 p.  Fixed the `test' builtin to return an error if `[' is supplied a single
4176     argument that is not `]'.
4177
4178 q.  Fixed a bug that caused subshells started to run executable shell scripts
4179     without a leading `#!' to incorrectly inherit an argument list preceding
4180     a shell builtin (like such a script called from a script sourced with `.',
4181     where there were variable assignments preceding the `.' command)
4182
4183 r.  Fixed a bug that caused changes to variables supplied in an assignment
4184     statement preceding a shell builtin to not be honored (like a script
4185     run with `.').
4186
4187 s.  HOSTTYPE, OSTYPE, and MACHTYPE are set only if they do not have values
4188     when the shell is started.
4189
4190 t.  Fixed a bug that caused SIGINT to kill shell scripts after the script
4191     called `wait'.
4192
4193 u.  The `fc' builtin now tries to create its temporary files in the directory
4194     named by $TMPDIR.
4195
4196 v.  Bash no longer calls any Readline functions or uses any Readline variables
4197     not declared in readline.h.
4198
4199 w.  Fixed a bug that caused some substitutions involving $@ to not be split
4200     correctly, especially expansions of the form ${paramterOPword}.
4201
4202 x.  SSH2_CLIENT is now treated like SSH_CLIENT and not auto-exported if it
4203     appears in the initial environment.
4204
4205 y.  Fixed a couple of problems with shell scripts without a leading `#!'
4206     being executed out of shell functions that could cause core dumps if
4207     such a script attempted to execute `return'.
4208
4209 z.  Fixed a problem with the `-nt' and `-ot' binary operators for the
4210     `test/[' builtin and the `[[' conditional command that caused wrong
4211     return values if one of the file arguments did not exist.
4212
4213 aa. Fixed a bug that caused non-interactive shells which had previously
4214     executed `shopt -s expand_aliases' to fail to expand aliases in a
4215     command like `(command) &'.
4216  
4217 2.  Changes to Readline
4218
4219 a.  Changes to make most (but not yet all -- there is still crlf()) of the
4220     exported readline functions declared in readline.h have an rl_ prefix.
4221
4222 b.  More `const' changes in function arguments, mostly for completion
4223     functions.
4224
4225 c.  Fixed a bug in rl_forward that could cause the point to be set to before
4226     the beginning of the line in vi mode.
4227
4228 d.  Fixed a bug in the callback read-char interface to make it work when a
4229     readline function pushes some input onto the input stream with
4230     rl_execute_next (like the incremental search functions).
4231
4232 e.  Fixed a file descriptor leak in the history file manipulation code that
4233     was tripped when attempting to truncate a non-regular file (like
4234     /dev/null).
4235
4236 f.  Some existing variables are now documented and part of the public
4237     interface (declared in readline.h):  rl_explict_arg, rl_numeric_arg,
4238     rl_editing_mode, rl_last_func.
4239
4240 g.  Renamed rltty_set_default_bindings to rl_tty_set_default_bindings and
4241     crlf to rl_crlf, so there are no public functions declared in readline.h
4242     without an `rl_' prefix.  The old functions still exist for backwards
4243     compatibility.
4244
4245 3.  New Features in Bash
4246
4247 a.  A new loadable builtin, realpath, which canonicalizes and expands symlinks
4248     in pathname arguments.
4249
4250 b.  When `set' is called without options, it prints function defintions in a
4251     way that allows them to be reused as input.  This affects `declare' and
4252     `declare -p' as well.
4253
4254 4.  New Features in Readline
4255
4256 a.  New application-callable function rl_set_prompt(const char *prompt):
4257     expands its prompt string argument and sets rl_prompt to the result.
4258
4259 b.  New application-callable function rl_set_screen_size(int rows, int cols):
4260     public method for applications to set readline's idea of the screen
4261     dimensions.
4262
4263 c.  The history example program (examples/histexamp.c) is now built as one
4264     of the examples.
4265
4266 ------------------------------------------------------------------------------
4267 This document details the changes between this version, bash-2.05-alpha1,
4268 and the previous version, bash-2.04-release.
4269
4270 1.  Changes to Bash
4271
4272 a.  A fix was made to allow newlines in compond array assignments.
4273
4274 b.  configure now checks for real-time signals with unusable values.
4275
4276 c.  Interactive shells no longer exit if a substitution fails because of an
4277     unset variable within a sourced file.
4278
4279 d.  Fixed a problem with incorrect matching of extended glob patterns when
4280     doing pattern substitution.
4281
4282 e.  `{' is now quoted by the completion code when it appears in a filename.
4283
4284 f.  Fixed an error in pattern matching that caused the matcher to not
4285     correctly skip the rest of a bracket expression after a character
4286     matched.
4287
4288 g.  Fixed a bug in the IFS word splitting code to make a non-whitespace IFS
4289     character preceded by IFS whitespace part of the current delimiter rather
4290     than generating a separate field.
4291
4292 h.  The {!prefix@} expansion now generates separate words, analogous to $@,
4293     when double-quoted.
4294
4295 i.  Command substitution now ignores NUL bytes in the command output, and the
4296     parser ignores them on input.
4297
4298 j.  A fix was made to the job control code to prevent hanging processes when
4299     the shell thinks background processes are running but the kernel returns
4300     -1/ECHILD from waitpid().
4301
4302 k.  `pwd' now prints an error message if the write fails when displaying the
4303     current directory.
4304
4305 l.  When in POSIX mode, the shell prints trap dispostions without a leading
4306     `SIG' in the signal specification.
4307
4308 m.  Fixed a parser bug that caused the current command's line count to be
4309     messed up by a compound array assignment.
4310
4311 n.  Fixed a bug in the unwind-protect code that caused bad behavior on machines
4312     where ints and pointers are not the same size.
4313
4314 o.  System-specific configure changes for:  MacOS X.
4315
4316 p.  Changes for Cygwin to translate \r\n and \r to \n and to set file
4317     descriptors used for reading input to text mode in various places.
4318
4319 q.  Fixed a bug that caused `!' to occasionally not be honored when in
4320     a (...) subshell.
4321
4322 r.  Bash no longer assumes that getcwd() will return any useful error message
4323     in the buffer passed as an argument if the call fails.
4324
4325 s.  The `source', `.', and `fc' builtins no longer check whether a file is
4326     binary before reading commands from it.
4327
4328 t.  Subshells no longer turn off job control when they exit, since that
4329     sometimes resulted in the terminal being reset to the wrong process
4330     group.
4331
4332 u.  The history code no longer tries to save the second and subsequent lines
4333     of a multi-line command if the first line was not saved.
4334
4335 v.  The history saving code now does a better job of saving blank lines in a
4336     multi-line command.
4337
4338 w.  Removed a `feature' that made `ulimit' silently translate `unlimited' to
4339     the current hard limit, which obscured some kernel error returns.
4340
4341 x.  Fixed the grammar so that `}' is recognized as a reserved word after
4342     another reserved word, rather than requiring a `;' or newline.  This
4343     means that constructs like
4344
4345         { { echo a b c ; } }
4346
4347     work as expected.
4348
4349 y.  Conditional commands ([[...]]) now perform tilde expansion on their
4350     arguments.
4351
4352 z.  Noted in the documentation that `set -a' will cause functions to be
4353     exported if they are defined after `set -a' is executed.
4354
4355 aa. When an interactive login shell starts, if $PWD and $HOME refer to the
4356     same directory but are not the same string, $PWD is set to $HOME.
4357
4358 bb. Fixed `printf' to handle invalid floating point numbers better.
4359
4360 cc. Temporary files are now created with random filenames, to improve security.
4361
4362 dd. The readline initialization code now binds the custom bash functions and
4363     key bindings after the readline defaults are set up.
4364
4365 ee. Fixed the `source' builtin to no longer overwrite a shell function's
4366     argument list, even if the sourced file changes the positional parameters.
4367
4368 ff. A bug fix was made in the expansion of `$*' in contexts where it should
4369     not be split, like assignment statements.
4370
4371 gg. Fixed a bug in the parameter substring expansion to handle conditional
4372     arithmetic expressions ( exp ? val1 : val2 ) without cutting the expression
4373     off at the wrong `:'.
4374
4375 hh. The `<>' redirection is no longer subject to the current setting of
4376     `noclobber', as POSIX.2 specifies.
4377
4378 ii. Fixed a bug in the conditional command parsing code that caused expressions
4379     in parentheses to occasionally be parsed incorrectly.
4380
4381 jj. Fixed a bug in the ((...)) arithmetic command to allow do...done or
4382     {...} to follow the )) without an intervening list terminator.
4383
4384 kk. `printf' now treats `\E' the same as `\e' when performing backslash escape
4385     expansion for the `%b' format specifier.
4386
4387 ll. When in POSIX mode, the shell no longer searches the current directory for
4388     a file to be sourced with `.' or `source' if `.' is not in $PATH.
4389
4390 mm. Interactive comments are no longer turned off when POSIX mode is disabled.
4391
4392 nn. The UID, EUID, HOSTNAME variables are not set if they are in the shell's
4393     environment when it starts up.
4394
4395 oo. Fixed a bug in the `command' builtin so the effect of a command like
4396     `command exec 4<file' is as if the `command' had been omitted.
4397
4398 pp. ${foo[@]} and ${foo[*]} now work as in ksh93 if `foo' is not an array
4399     variable.
4400
4401 qq. ${#foo[X]}, where X is 0, @, or *, now work as in ksh93 if `foo' is not
4402     an array variable.
4403
4404 rr. The shell's idea of an absolute pathname now takes into account a
4405     possible drive specification on Cygwin and other Windows systems.
4406
4407 ss. Fixed a bug which caused incorrect parsing of some multi-character
4408     constructs if they were split across input lines with backslash-newline
4409     line continuation.
4410
4411 tt. Fixed a bug that caused restricted shell mode to be set inappropriately
4412     when trying to execute a shell script without a leading `#!'.
4413
4414 uu. Shell function definitions no longer require that the body be a group
4415     command ( {...} ), as POSIX.2 requires.
4416
4417 vv. The `cd' and `pwd' builtins now process symlinks in pathnames internally
4418     and should require many fewer calls to getcwd().
4419
4420 ww. Fixed a bug that caused a pipeline's process group to be set incorrectly
4421     if one of the pipeline elements contained a command substitution.
4422
4423 xx. Fixed a bug that caused core dumps when expanding the value of HISTIGNORE.
4424
4425 yy. The output of `set' is now quoted using $'...' so invisible characters are
4426     displayed as escape sequences.
4427
4428 zz. Fixed the help text for `unset', since PATH and IFS may both be unset.
4429
4430 aaa. The shell no longer puts directory names into the command hash table.
4431
4432 bbb. Fixed a bug in `read' that caused it to occasionally free memory twice if
4433      it was interrupted after reading a large amount of data.
4434
4435 ccc. Assignment statements that attempt to assign values to readonly variables
4436      now cause the command to return an error status.
4437
4438 ddd. Fixed a bug that could cause incorrect output if a $(<file) construct was
4439      interrupted.
4440
4441 eee. GROUPS and FUNCNAME now return an error status when assignment is
4442      attempted, but may be unset (in which case they lose their special
4443      properties).  In all respects except unsetting, they are readonly.
4444
4445 fff. The string-to-integer conversion code now ignores trailing whitespace in
4446      the string, even if strtol(3) does not.
4447
4448 ggg. The tcsh magic-space function now does a better job of inserting the
4449      space close to where the point was before the history expansion, rather
4450      than just appending it.
4451
4452 hhh. Fixed a bug which caused a file sourced from an interactive shell to
4453      fill up the jobs table if it ran lots of jobs.
4454
4455 iii. Fixed a bug in the parameter pattern substitution code to avoid infinite
4456      recursion on zero-length matches.
4457
4458 2.  Changes to Readline
4459
4460 a.  When setting the terminal attributes on systems using `struct termio',
4461     readline waits for output to drain before changing the attributes.
4462
4463 b.  A fix was made to the history word tokenization code to avoid attempts to
4464     dereference a null pointer.
4465
4466 c.  Readline now defaults rl_terminal_name to $TERM if the calling application
4467     has left it unset, and tries to initialize with the resultant value.
4468
4469 d.  Instead of calling (*rl_getc_function)() directly to get input in certain
4470     places, readline now calls rl_read_key() consistently.
4471
4472 e.  Fixed a bug in the completion code that allowed a backslash to quote a
4473     single quote inside a single-quoted string.
4474
4475 f.  rl_prompt is no longer assigned directly from the argument to readline(),
4476     but uses memory allocated by readline.  This allows constant strings to
4477     be passed to readline without problems arising when the prompt processing
4478     code wants to modify the string.
4479
4480 g.  Fixed a bug that caused non-interactive history searches to return the
4481     wrong line when performing multiple searches backward for the same string.
4482
4483 h.  Many variables, function arguments, and function return values are now
4484     declared `const' where appropriate, to improve behavior when linking with
4485     C++ code.
4486
4487 i.  The control character detection code now works better on systems where
4488     `char' is unsigned by default.
4489
4490 j.  The vi-mode numeric argument is now capped at 999999, just like emacs mode.
4491
4492 k.  The Function, CPFunction, CPPFunction, and VFunction typedefs have been
4493     replaced with a set of specific prototyped typedefs, though they are
4494     still in the readline header files for backwards compatibility.
4495
4496 m.  Nearly all of the (undocumented) internal global variables in the library
4497     now have an _rl_ prefix -- there were a number that did not, like
4498     screenheight, screenwidth, alphabetic, etc.
4499
4500 n.  The ding() convenience function has been renamed to rl_ding(), though the
4501     old function is still defined for backwards compatibility.
4502
4503 o.  The completion convenience functions filename_completion_function,
4504     username_completion_function, and completion_matches now have an rl_
4505     prefix, though the old names are still defined for backwards compatibility.
4506
4507 p.  The functions shared by readline and bash (linkage is satisfied from bash
4508     when compiling with bash, and internally otherwise) now have an sh_ prefix.
4509
4510 q.  Changed the shared library creation procedure on Linux and BSD/OS 4.x so
4511     that the `soname' contains only the major version number rather than the
4512     major and minor numbers.
4513
4514 r.  Fixed a redisplay bug that occurred when the prompt spanned more than one
4515     physical line and contained invisible characters.
4516
4517 3.  New Features in Bash
4518
4519 a.  Added a new `--init-file' invocation argument as a synonym for `--rcfile',
4520     per the new GNU coding standards.
4521
4522 b.  The /dev/tcp and /dev/udp redirections now accept service names as well as
4523     port numbers.
4524
4525 c.  `complete' and `compgen' now take a `-o value' option, which controls some
4526     of the aspects of that compspec.  Valid values are:
4527
4528         default - perform bash default completion if programmable
4529                   completion produces no matches
4530         dirnames - perform directory name completion if programmable
4531                    completion produces no matches
4532         filenames - tell readline that the compspec produces filenames,
4533                     so it can do things like append slashes to
4534                     directory names and suppress trailing spaces
4535
4536 4.  New Features in Readline
4537
4538 a.  The blink timeout for paren matching is now settable by applications.
4539
4540 b.  _rl_executing_macro has been renamed to rl_executing_macro, which means
4541     it's now part of the public interface.
4542
4543 c.  Readline has a new variable, rl_readline_state, which is a bitmap that
4544     encapsulates the current state of the library; intended for use by
4545     callbacks and hook functions.
4546
4547 ------------------------------------------------------------------------------
4548 This document details the changes between this version, bash-2.04-release,
4549 and the previous version, bash-2.04-beta5.
4550
4551 1.  Changes to Bash
4552
4553 a.  Better compile-time and configure-time checks for the necessity of
4554     inet_aton().
4555
4556 b.  A bug was fixed in the expansion of "${@:-}" when there are positional
4557     parameters.
4558
4559 c.  A typo was fixed in the output of `complete'.
4560
4561 d.  The matches generated for a word by the `-W' argument to complete and
4562     compgen are now matched against the word being completed, and only
4563     matches are returned as the result.
4564
4565 e.  Some fixes were made for systems which do not restart read(2) when a
4566     signal caught by bash is received.
4567
4568 f.  A bug was fixed which caused the umask to be set to 0 when an invalid
4569     symbolic mode mask was parsed.
4570
4571 g.  Fixed a bug that could cause a core dump if a SIGCHLD was received while
4572     performing an assignment statement using command substitution.
4573
4574 h.  Changed the word splitting function for programmable completion so cases
4575     in which the cursor is between words are handled a bit better.
4576
4577 2.  Changes to Readline
4578
4579 a.  rl_funmap_names() is now documented.
4580
4581 3.  New Features in Bash
4582
4583 a.  The LC_NUMERIC variable is now treated specially, and used to set the
4584     LC_NUMERIC locale category for number formatting, e.g., when `printf'
4585     displays floating-point numbers.
4586
4587 ------------------------------------------------------------------------------
4588 This document details the changes between this version, bash-2.04-beta5,
4589 and the previous version, bash-2.04-beta4.
4590
4591 1.  Changes to Bash
4592
4593 a.  A couple of changes were made to the Makefiles for easier building on
4594     non-Unix systems.
4595
4596 b.  Fixed a bug where the current prompt would be set to $PS2 at startup.
4597
4598 c.  The shell script that tests an already-installed version was changed to
4599     remove the directory it created its test programs in at exit.
4600
4601 d.  Several changes were made to the code that tokenizes an input line for
4602     the programmable completion code.  Shell metacharacters will now appear
4603     as individual words in the word list passed to the completion functions.
4604     Some of the example completion shell functions were changed to understand
4605     redirection operators.
4606
4607 e.  A bug was fixed that, under obscure circumstances, could confuse the
4608     parser when a shell function was run by the programmable completion code.
4609
4610 f.  A bug was fixed in the ulimit builtin for systems not using getrlimit().
4611
4612 g.  The execution code now propagates the correct exit status back to the rest
4613     of the code if the return value of a subshell command was being inverted.
4614     Some new test cases for inverting return values with the `!' reserved
4615     word have been added.
4616
4617 h.  Negative exponents in the arithmetic evaluation of v**e now return an
4618     evaluation error.
4619
4620 i.  A bug that caused bash to check the wrong process in a pipeline for
4621     abnormal termination (and consequently resetting the terminal attributes)
4622     was fixed.
4623
4624 j.  Fixed a bug that caused $PS2 to be displayed after PROMPT_COMMAND was
4625     executed.
4626
4627 2.  Changes to Readline
4628
4629 1.  Fixed a bug in a C preprocessor define that caused the keypad control
4630     functions to be compiled out for all platforms except DJGPP.
4631
4632 ------------------------------------------------------------------------------
4633 This document details the changes between this version, bash-2.04-beta4,
4634 and the previous version, bash-2.04-beta3.
4635
4636 1.  Changes to Bash
4637
4638 a.  A couple of changes were made to the redirection to attempt to avoid
4639     race conditions and malicious file replacement.
4640
4641 2.  A change was made to the string evaluation code (used for command 
4642     substitution, `eval', and the `.' builtin) to fix an obscure core
4643     dump on alpha machines.
4644
4645 3.  A bug that caused $LINENO to be wrong when executing arithmetic for
4646     commands was fixed.
4647
4648 4.  A couple of memory leaks in the programmable completion code were fixed.
4649
4650 5.  A bug that could cause a core dump by freeing memory twice during a call
4651     to `eval' if `set -u' had been enabled and an undefined variable was
4652     referenced was fixed.
4653
4654 ------------------------------------------------------------------------------
4655 This document details the changes between this version, bash-2.04-beta3,
4656 and the previous version, bash-2.04-beta2.
4657
4658 1.  Changes to Bash
4659
4660 a.  Bash should run the appropriate startup files when invoked by ssh2.
4661
4662 b.  Fixed a bug in the parsing of conditional commands that could cause a
4663     core dump.
4664
4665 c.  Fixed a bug in parsing job specifications that occasionally caused
4666     core dumps when an out-of-range job was referenced.
4667
4668 d.  Fixed the `type' and `command' builtins to do better reporting of
4669     commands that are not found in $PATH or the hash table.
4670
4671 e.  Fixed a POSIX.2 compliance problem in the command builtin -- commands
4672     are supposed to be reported as full pathnames.
4673
4674 f.  The `echo' builtin now returns failure if a write error occurs.
4675
4676 g.  Fixed a bug which caused the locale to not be reset correctly when
4677     LC_ALL was unset.
4678
4679 h.  Changed description of `getopts' in man page and reference manual to make
4680     it clear that option characters may be characters other than letters.
4681
4682 i.  If the shell exits while in a function, make sure that any trap on EXIT
4683     doesn't think the function is still executing.
4684
4685 j.  Bashbug now tries harder to find a usable editor if $EDITOR is not set,
4686     rather than simply defaulting to `emacs'.
4687
4688 k.  Changes to the scripts that guess and canonicalize the system type, from
4689     the latest `automake' distribution via Debian.
4690
4691 l.  When using named pipes for process substitution, make sure the file
4692     descriptors opened for reading are set to non-blocking mode.
4693
4694 m.  Fixed a bug that caused termination of pipelines that are killed by a
4695     signal to not be reported in some cases.
4696
4697 n.  When not in literal-history mode, shell comment lines are not added to
4698     the history list.
4699
4700 o.  When running in POSIX.2 mode, bash no longer performs word splitting on
4701     the expanded value of the word supplied as the filename argument to
4702     redirection operators.
4703
4704 p.  The prompt string decoding code now backslash-quotes only characters that
4705     are special within double quotes when expanding the \w and \W escape
4706     sequences.
4707
4708 q.  Fixed a bug in the prompt decoding code that could cause a non-interactive
4709     shell to seg fault if `\u' was used in PS4 and the shell was in xtrace
4710     mode.
4711
4712 r.  Fixed a bug that caused function definitions to be printed with any
4713     redirections that should be attached to the entire function before the
4714     closing brace.
4715
4716 s.  Changed the tilde expansion code for Cygwin systems to avoid creating
4717     pathnames beginning with `//' if $HOME == `/'.
4718
4719 t.  Fixed a couple of autoconf tests to avoid creating files with fixed names
4720     in /tmp.
4721
4722 u.  The `trap' and `kill' builtins now know the names of the POSIX.1b real-
4723     time signals on systems which support them.
4724
4725 2.  Changes to Readline
4726
4727 a.  Fixed a problem with the single-quote quoting function that could cause
4728     buffer overflows.
4729
4730 b.  Fixed a bug that caused incorrect `stat characters' to be printed if
4731     the files being completed were in the root directory and visible-stats
4732     was enabled.
4733
4734 3.  New Features in Bash
4735
4736 a.  There is a new `rbash.1' manual page, from the Debian release.
4737
4738 b.  The `--enable-usg-echo-default' option to `configure' has been renamed to
4739     `--enable-xpg-echo-default'.  The old option is still there for backwards
4740     compatibility.
4741
4742 ------------------------------------------------------------------------------
4743 This document details the changes between this version, bash-2.04-beta2,
4744 and the previous version, bash-2.04-beta1.
4745
4746 1.  Changes to Bash
4747
4748 a.  Fixed a bug that could cause pipes to be closed inappropriately in
4749     some obscure cases.
4750
4751 b.  Fixed a bug that caused creation of the exported environment to clobber
4752     the current command string if there were any exported shell functions.
4753
4754 c.  Some changes were made to reduce bash's memory usage.
4755
4756 d.  Fixed a problem with programmable completion and filenames to be
4757     completed containing quote characters.
4758
4759 e.  Changed the code the removes named pipes created for the <(...) and >(...)
4760     expansions to defer removal until after any current shell function has
4761     finished executing.
4762
4763 f.  Fixed a bug in `select' which caused it to not handle the `continue'
4764     builtin correctly.
4765
4766 g.  Autoconf tests added for cygwin32 and mingw32.
4767
4768 2.  New Features in Bash
4769
4770 a.  The `--with-bash-malloc' configure option replaces `--with-gnu-malloc'
4771     (which is still there for backwards compatibility).
4772
4773 ------------------------------------------------------------------------------
4774 This document details the changes between this version, bash-2.04-beta1,
4775 and the previous version, bash-2.04-alpha1.
4776
4777 1.  Changes to Bash
4778
4779 a.  Fixed a bug in the programmable completion code that occurred when
4780     trying to complete command lines containing a `;' or `@'.
4781
4782 b.  The file descriptor from which the shell is reading a script is now
4783     moved to a file descriptor above the user-addressible range.
4784
4785 c.  Changes to `printf' so that it can handle integers beginning with 0
4786     or 0x as octal and hex, respectively.
4787
4788 d.  Fixes to the programmable completion code so it handles nonsense like
4789     `compgen -C xyz' gracefully.
4790
4791 e.  The shell no longer modifies the signal handler for SIGPROF, allowing
4792     profiling again on certain systems.
4793
4794 f.  The shell checks for a new window size, if the user has requested it,
4795     after a process exits due to a signal.
4796
4797 g.  Fixed a bug with variables with null values in a program's temporary
4798     environment and the bash getenv() replacement.
4799
4800 h.  `declare' and the other builtins that take variable assignments as
4801     arguments now honor `set -a' and mark modified variables for export.
4802
4803 i.  Some changes were made for --dump-po-strings mode when writing strings
4804     with embedded newlines.
4805
4806 j.  The code that caches export strings from the initial environment now
4807     duplicates the string rather than just pointing into the environment.
4808
4809 k.  The filename completion quoting code now uses single quotes by default
4810     if the filename being completed contains newlines, since \<newline>
4811     has a special meaning to the parser.
4812
4813 l.  Bash now uses typedefs bits32_t and u_bits32_t instead of int32_t and
4814     u_int32_t, respectively to avoid conflicts on certain Unix versions.
4815
4816 m.  Configuration changes were made for: Rhapsody, Mac OS, FreeBSD-3.x.
4817
4818 n.  Fixed a problem with hostname-to-ip-address translation in the
4819     /dev/(tcp|udp)/hostname/port redirection code.
4820
4821 o.  The texinfo manual has been reorganized slightly.
4822
4823 p.  Filename generation (globbing) range comparisons in bracket expressions
4824     no longer use strcoll(3) even if it is available, since it has unwanted
4825     effects in certain locales.
4826
4827 q.  Fixed a cosmetic problem in the source that caused the shell to not
4828     compile if DPAREN_ARITHMETIC was not defined but ARITH_FOR_COMMAND was.
4829
4830 r.  Fixed a bug in the here-document code tripped when the file descriptor
4831     opened to the file containing the text of the here document was the
4832     same as a redirector specified by the user.
4833
4834 s.  Fixed a bug where the INVERT_RETURN flag was not being set for `pipeline'
4835     in `time ! pipeline'.
4836
4837 t.  Fixed a bug with the `wait' builtin which manifested itself when an
4838     interrupt was received while the shell was waiting for asynchronous
4839     processes in a shell script.
4840
4841 u.  Fixed the DEBUG trap code so that it has the correct value of $?.
4842
4843 v.  Fixed a bug in the parameter pattern substitution code that could cause
4844     the shell to attempt to free unallocated memory if the pattern started
4845     with `/' and an expansion error occurs.
4846
4847 w.  Fixed a bug in the positional parameter substring code that could
4848     cause the shell to loop freeing freed memory.
4849
4850 x.  Fixed a bug in the positional parameter pattern substitution code so
4851     that it correctly handles null replacement strings with a pattern
4852     string prefixed with `%' or `#'.
4853
4854 y.  The shell no longer attempts to import functions from the environment if
4855     started with `-n'.
4856
4857 z.  Fixed a bug that caused `return' in a command substitution executed in
4858     a shell function to return from the function in a subshell and continue
4859     execution.
4860
4861 aa. `hash -p /pathname/with/slashes name' is no longer allowed when the shell
4862     is restricted.
4863
4864 bb. The wait* job control functions now behave better if called when there
4865     are no unwaited-for children.
4866
4867 cc. Command substitution no longer unconditionally disables job control in
4868     the subshell started to run the command.
4869
4870 dd. A bug was fixed that occasionally caused traps to mess up the parser
4871     state.
4872
4873 ee. `bashbug' now honors user headers in the mail message it sends.
4874
4875 ff. A bug was fixed that caused the `:p' history modifier to not print the
4876     history expansion if the `histverify' option was set.
4877
4878 2.  Changes to Readline
4879
4880 a.  Fixed a bug in the redisplay code for lines with more than 256 line
4881     breaks.
4882
4883 b.  A bug was fixed which caused invisible character markers to not be
4884     stripped from the prompt string if the terminal was in no-echo mode.
4885
4886 c.  Readline no longer tries to get the variables it needs for redisplay
4887     from the termcap entry if the calling application has specified its
4888     own redisplay function.  Readline treats the terminal as `dumb' in
4889     this case.
4890
4891 d.  Fixes to the SIGWINCH code so that a multiple-line prompt with escape
4892     sequences is redrawn correctly.
4893
4894 3.  New Features in Bash
4895
4896 a.  `bashbug' now accepts `--help' and `--version' options.
4897
4898 b.  There is a new `xpg_echo' option to `shopt' that controls the behavior
4899     of echo with respect to backslash-escaped characters at runtime.
4900
4901 ------------------------------------------------------------------------------
4902 This document details the changes between this version, bash-2.04-alpha1,
4903 and the previous version, bash-2.04-devel.
4904
4905 1.  Changes to Bash
4906
4907 a.  Fixed a bug that could cause core dumps when performing substring
4908     expansion.
4909
4910 b.  Shared object configuration changes for:  Solaris, OSF/1
4911
4912 c.  The POSIX_GLOB_LIBRARY code that uses the POSIX.2 globbing facilities
4913     for pathname expansion now understands GLOBIGNORE.
4914
4915 d.  The code that implements `eval' was changed to save the value of the
4916     current prompt, so an eval in a shell function called by the programmable
4917     completion code will not change the prompt to $PS2.
4918
4919 e.  Restored the undocumented NON_INTERACTIVE_LOGIN_SHELLS #define to
4920     config-top.h.  If this is defined, all login shells will read the
4921     startup files, not just interactive and non-interactive started with
4922     the `--login' option.
4923
4924 f.  Fixed a bug that caused the expansion code to occasionally dump core if
4925     IFS contained characters > 128.
4926
4927 g.  Fixed a problem with the grammar so that a newline is not required
4928     after the `))' in the new-style arithmetic for statement; a semicolon
4929     may be used as expected.
4930
4931 h.  Variable indirection may now reference the shell's special variables.
4932
4933 i.  The $'...' and $"..." constructs are now added to the history correctly
4934     if they contain newlines and command-oriented history is enabled.
4935
4936 j.  It is now an error to try to assign a value to a function-local copy
4937     of a readonly shell variable (declared with the `local' builtin).
4938
4939 2.  Changes to Readline
4940
4941 a.  The history file code now uses O_BINARY mode when reading and writing
4942     the history file on cygwin32.
4943
4944 3.  New Features in Bash
4945
4946 a.  A new programmable completion facility, with two new builtin commands:
4947     complete and compgen.
4948
4949 b.  configure has a new option, `--enable-progcomp', to compile in the
4950     programmable completion features (enabled by default).
4951
4952 c.  `shopt' has a new option, `progcomp', to enable and disable programmable
4953     completion at runtime.
4954
4955 d.  Unsetting HOSTFILE now clears the list of hostnames used for completion.
4956
4957 4.  New Features in Readline
4958
4959 a.  A new variable, rl_gnu_readline_p, always 1.  The intent is that an
4960     application can verify whether or not it is linked with the `real'
4961     readline library or some substitute.
4962
4963 ------------------------------------------------------------------------------
4964 This document details the changes between this version, bash-2.04-devel,
4965 and the previous version, bash-2.03-release.
4966
4967 1.  Changes to Bash
4968
4969 a.  System-specific configuration and source changes for:  Interix, Rhapsody
4970
4971 b.  Fixed a bug in execute_cmd.c that resulted in a compile-time error if
4972     JOB_CONTROL was not defined.
4973
4974 c.  An obscure race condition in the trap code was fixed.
4975
4976 d.  The string resulting from $'...' is now requoted to avoid any further
4977     expansion.
4978
4979 e.  The $'...' quoting syntax now allows backslash to escape a single quote,
4980     for ksh-93 compatibility.
4981
4982 f.  The $"..." quoting syntax now escapes backslashes and double quotes in
4983     the translated string when displaying them with the --dump-po-strings
4984     option.
4985
4986 g.  `echo -e' no longer converts \' to '.
4987
4988 h.  Fixes were made to the extended globbing code to handle embedded (...)
4989     patterns better.
4990
4991 i.  Some improvements were made to the code that unsets `nodelay' mode on
4992     the file descriptor from which bash is reading input.
4993
4994 j.  Some changes were made to the replacement termcap library for better
4995     operation on MS-DOS.
4996
4997 k.  Some changes were made to the tilde expansion code to handle backslash
4998     as a pathname separator on MS-DOS.
4999
5000 l.  The source has been reorganized a little bit -- there is now an `include'
5001     subdirectory, and lib/posixheaders has been removed.
5002
5003 m.  Improvements were made to the `read' builtin so that it makes many
5004     fewer read(2) system calls.
5005
5006 n.  The expansion of $- will include `c' and `s' when those options are
5007     supplied at shell invocation.
5008
5009 o.  Several improvments were made to the completion code:  variable completion
5010     now works better when there are unterminated expansions, command
5011     completion understands quotes better, and completion now works in certain
5012     unclosed $(... constructs.
5013
5014 p.  The arithmetic expansion code was fixed to not need the value of a
5015     variable being assigned a value (fixes the "ss=09; let ss=10" bug).
5016
5017 q.  Some changes were made to make exported environment creation faster.
5018
5019 r.  The html documentation will be installed into $(htmldir) if that variable
5020     has a value when `make install' is run.
5021
5022 s.  Fixed a bug that would cause the bashrc file to be sourced inappropriately
5023     when bash is started by sshd.
5024
5025 t.  The SSH_CLIENT environment variable is no longer auto-exported.
5026
5027 u.  A bug that caused redirections with (...) subshells to be performed in
5028     the wrong order was fixed.
5029
5030 v.  A bug that occasionally caused inappropriate expansion of assignment
5031     statements in compound array assignments was fixed.
5032
5033 w.  The code that parses the words in a compound array assignment was
5034     simplified considerably and should work better now.
5035
5036 x.  Fixes to the non-job-control code in nojobs.c to make it POSIX.2-compliant
5037     when a user attempts to retrieve the status of a terminated background
5038     process.
5039
5040 y.  Fixes to the `printf' builtin so that it doesn't try to expand all
5041     backslash escape sequences in the format string before parsing it for
5042     % format specifiers.
5043
5044 2.  Changes to Readline
5045
5046 a.  The history library tries to truncate the history file only if it is a
5047     regular file.
5048
5049 b.  A bug that caused _rl_dispatch to address negative array indices on
5050     systems with signed chars was fixed.
5051
5052 c.  rl-yank-nth-arg now leaves the history position the same as when it was
5053     called.
5054
5055 d.  Changes to the completion code to handle MS-DOS drive-letter:pathname
5056     filenames.
5057
5058 e.  Completion is now case-insensitive by default on MS-DOS.
5059
5060 f.  Fixes to the history file manipulation code for MS-DOS.
5061
5062 g.  Readline attempts to bind the arrow keys to appropriate defaults on MS-DOS.
5063
5064 h.  Some fixes were made to the redisplay code for better operation on MS-DOS.
5065
5066 i.  The quoted-insert code will now insert tty special chars like ^C.
5067
5068 j.  A bug was fixed that caused the display code to reference memory before
5069     the start of the prompt string.
5070
5071 k.  More support for __EMX__ (OS/2).
5072
5073 l.  A bug was fixed in readline's signal handling that could cause infinite
5074     recursion in signal handlers.
5075
5076 m.  A bug was fixed that caused the point to be less than zero when rl_forward
5077     was given a very large numeric argument.
5078
5079 n.  The vi-mode code now gets characters via the application-settable value
5080     of rl_getc_function rather than calling rl_getc directly.
5081
5082 3.  New Features in Bash
5083
5084 a.  The history builtin has a `-d offset' option to delete the history entry
5085     at position `offset'.
5086
5087 b.  The prompt expansion code has two new escape sequences: \j, the number of
5088     active jobs; and \l, the basename of the shell's tty device name.
5089
5090 c.  The `bind' builtin has a new `-x' option to bind key sequences to shell
5091     commands.
5092
5093 d.  There is a new shell option, no_empty_command_completion, which, when
5094     enabled, disables command completion when TAB is typed on an empty line.
5095
5096 e.  The `help' builtin has a `-s' option to just print a builtin's usage
5097     synopsys.
5098
5099 f.  There are several new arithmetic operators:  id++, id-- (variable
5100     post-increment/decrement), ++id, --id (variabl pre-increment/decrement),
5101     expr1 , expr2 (comma operator).
5102
5103 g.  There is a new ksh-93 style arithmetic for command:
5104         for ((expr1 ; expr2; expr3 )); do list; done
5105
5106 h.  The `read' builtin has a number of new options:
5107         -t timeout      only wait timeout seconds for input
5108         -n nchars       only read nchars from input instead of a full line
5109         -d delim        read until delim rather than newline
5110         -s              don't echo input chars as they are read
5111
5112 i.  The redirection code now handles several filenames specially:
5113     /dev/fd/N, /dev/stdin, /dev/stdout, and /dev/stderr, whether or
5114     not they are present in the file system.
5115
5116 j.  The redirection code now recognizes pathnames of the form
5117     /dev/tcp/host/port and /dev/udp/host/port, and tries to open a socket
5118     of the appropriate type to the specified port on the specified host.
5119
5120 k.  The ksh-93 ${!prefix*} expansion, which expands to the names of all
5121     shell variables whose names start with prefix, has been implemented.
5122
5123 l.  There is a new dynamic variable, FUNCNAME, which expands to the name of
5124     a currently-executing function.  Assignments to FUNCNAME have no effect.
5125
5126 m.  The GROUPS variable is no longer readonly; assignments to it are silently
5127     discarded.  This means it can be unset.
5128
5129 4.  New Features in Readline
5130
5131 a.  Parentheses matching is now always compiled into readline, and enabled
5132     or disabled when the value of the `blink-matching-paren' variable is
5133     changed.
5134
5135 b.  MS-DOS systems now use ~/_inputrc as the last-ditch inputrc filename.
5136
5137 c.  MS-DOS systems now use ~/_history as the default history file.
5138
5139 d.  history-search-{forward,backward} now leave the point at the end of the
5140     line when the string to search for is empty, like
5141     {reverse,forward}-search-history.
5142
5143 e.  history-search-{forward,backward} now leave the last history line found
5144     in the readline buffer if the second or subsequent search fails.
5145
5146 f.  New function for use by applications:  rl_on_new_line_with_prompt, used
5147     when an application displays the prompt itself before calling readline().
5148
5149 g.  New variable for use by applications:  rl_already_prompted.  An application
5150     that displays the prompt itself before calling readline() must set this to
5151     a non-zero value.
5152
5153 ------------------------------------------------------------------------------
5154 This document details the changes between this version, bash-2.03-release,
5155 and the previous version, bash-2.03-beta2.
5156
5157 1.  Changes to Bash
5158
5159 a.  A file descriptor leak in the `fc' builtin was fixed.
5160
5161 b.  A bug was fixed in the `read' builtin that caused occasional spurious
5162     failures when using `read -e'.
5163
5164 c.  The version code needed to use the value of the cpp variable
5165     CONF_MACHTYPE rather than MACHTYPE.
5166
5167 d.  A new test was added to exercise the command printing and copying code.
5168
5169 e.  A bug was fixed that caused `time' to be recognized as a reserved word
5170     if it was the first pattern in a `case' statement pattern list.
5171
5172 ------------------------------------------------------------------------------
5173 This document details the changes between this version, bash-2.03-beta2,
5174 and the previous version, bash-2.03-beta1.
5175
5176 1.  Changes to Bash
5177
5178 a.  Slight additions to support/shobj-conf, mostly for the benefit of AIX 4.2.
5179
5180 b.  config.{guess,sub} support added for the NEC SX4.
5181
5182 c.  Changed some of the cross-compiling sections of the configure macros in
5183     aclocal.m4 so that configure won't abort.
5184
5185 d.  Slight changes to how the HTML versions of the bash and readline manuals
5186     are generated.
5187
5188 e.  Fixed conditional command printing to avoid interpreting printf `%'-escapes
5189     in arguments to [[.
5190
5191 f.  Don't include the bash malloc on all variants of the alpha processor.
5192
5193 g.  Changes to configure to make --enable-profiling work on Solaris 2.x.
5194
5195 h.  Fixed a bug that manifested itself when shell functions were called
5196     between calls to `getopts'.
5197
5198 i.  Fixed pattern substitution so that a bare `#'as a pattern causes the
5199     replacement string to be prefixed to the search string, and a bare
5200     `%' causes the replacement string to be appended to the search string.
5201
5202 j.  Fixed a bug in the command execution code that caused child processes
5203     to occasionally have the wrong value for $!.
5204
5205 2.  Changes to Readline
5206
5207 a.  Added code to the history library to catch history substitutions using
5208     `&' without a previous history substitution or search having been
5209     performed.
5210
5211 3.  New Features in Bash
5212
5213 4.  New Features in Readline
5214
5215 a.  New bindable variable: `isearch-terminators'.
5216
5217 b.  New bindable function: `forward-backward-delete-char' (unbound by default).
5218
5219 ------------------------------------------------------------------------------
5220 This document details the changes between this version, bash-2.03-beta1,
5221 and the previous version, bash-2.03-alpha.
5222     
5223 1.  Changes to Bash
5224
5225 a.  A change was made to the help text for `{...}' to make it clear that a
5226     semicolon is required before the closing brace.
5227
5228 b.  A fix was made to the `test' builtin so that syntax errors cause test
5229     to return an exit status > 1.
5230
5231 c.  Globbing is no longer performed on assignment statements that appear as
5232     arguments to `assignment builtins' such as `export'.
5233
5234 d.  System-specific configuration changes were made for:  Rhapsody,
5235     AIX 4.2/gcc, BSD/OS 4.0.
5236
5237 e.  New loadable builtins: ln, unlink.
5238
5239 f.  Some fixes were made to the globbing code to handle extended glob patterns
5240     which immediately follow a `*'.
5241
5242 g.  A fix was made to the command printing code to ensure that redirections
5243     following compound commands have a space separating them from the rest
5244     of the command.
5245
5246 h.  The pathname canonicalization code was changed to produce fewer leading
5247     `//' sequences, since those are interpreted as network file system
5248     pathnames on some systems.
5249
5250 i.  A fix was made so that loops containing `eval' commands in commands passed
5251     to `bash -c' would not exit prematurely.
5252
5253 j.  Some changes were made to the job reaping code when the shell is not
5254     interactive, so the shell will retain exit statuses longer for examination
5255     by `wait'.
5256
5257 k.  A fix was made so that `jobs | command' works again.
5258
5259 l.  The erroneous compound array assignment var=((...)) is now a syntax error.
5260
5261 m.  A change was made to the dynamic loading code in `enable' to support
5262     Tenon's MachTen.
5263
5264 n.  A fix was made to the globbing code so that extended globbing patterns
5265     will correctly match `.' in a bracket expression.
5266
5267 2.  Changes to Readline
5268
5269 a.  A fix was made to the completion code in which a typo caused the wrong
5270     value to be passed to the function that computed the longest common
5271     prefix of the list of matches.
5272
5273 b.  The completion code now checks the value of rl_filename_completion_desired,
5274     which is set by application-supplied completion functions to indicate
5275     that filename completion is being performed, to decide whether or not to
5276     call an application-supplied `ignore completions' function.
5277
5278 3.  New Features in Bash
5279
5280 a.  A change was made to the startup file code so that any shell begun with
5281     the `--login' option, even non-interactive shells, will source the login
5282     shell startup files.
5283
5284 4.  New Features in Readline
5285
5286 a.  A new variable, rl_erase_empty_line, which, if set by an application using
5287     readline, will cause readline to erase, prompt and all, lines on which the
5288     only thing typed was a newline.
5289
5290 ------------------------------------------------------------------------------
5291 This document details the changes between this version, bash-2.03-alpha,
5292 and the previous version, bash-2.02.1-release.
5293
5294 1.  Changes to Bash
5295
5296 a.  System-specific configuration changes were made for: Irix 6.x, Unixware 7.
5297
5298 b.  The texi2dvi and texi2html scripts were updated to the latest versions
5299     from the net.
5300
5301 c.  The configure tests that determine which native type is 32 bits were
5302     changed to not require a compiled program.
5303
5304 d.  Fixed a bug in shell_execve that could cause memory to be freed twice
5305     after a failed exec.
5306
5307 e.  The `printf' test uses `diff -a' if it's available to prevent confusion
5308     due to the non-ascii output.
5309
5310 f.  Shared object configuration is now performed by a shell script,
5311     support/shobj-conf, which generates values to be substituted into
5312     makefiles by configure.
5313
5314 g.  Some changes were made to `ulimit' to avoid the use of RLIM_INVALID as a
5315     return value.
5316
5317 h.  Changes were made to `ulimit' to work around HPUX 9.x's peculiar
5318     handling of RLIMIT_FILESIZE.
5319
5320 i.  Some new loadable builtins were added: id, printenv, sync, whoami, push,
5321     mkdir.  `pushd', `popd', and `dirs' can now be built as regular or
5322     loadable builtins from the same source file.
5323
5324 j.  Changes were made to `printf' to handle NUL bytes in the expanded format
5325     string.
5326
5327 k.  The various `make clean' Makefile targets now descend into lib/sh.
5328
5329 l.  The `type' builtin was changed to use the internal `getopt' so that things
5330     like `type -ap' work as expected.
5331
5332 m.  There is a new configuration option, --with-installed-readline, to link
5333     bash with a locally-installed version of readline.  Only readline version
5334     4.0 and later releases can support this.  Shared and static libraries
5335     are supported.  The installed include files are used.
5336
5337 n.  There is a new autoconf macro used to find which basic type is 64 bits.
5338
5339 o.  Dynamic linking and loadable builtins should now work on SCO 3.2v5*,
5340     AIX 4.2 with gcc, Unixware 7, and many other systems using gcc, where
5341     the `-shared' options works correctly.
5342
5343 p.  A bug was fixed in the bash filename completion code that caused memory to
5344     be freed twice if a directory name containing an unset variable was
5345     completed and the -u option was set.
5346
5347 q.  The prompt expansion code now quotes the `$' in the `\$' expansion so it
5348     is not processed by subsequent parameter expansion.
5349
5350 r.  Fixed a parsing bug that caused a single or double quote after a `$$' to
5351     trigger ANSI C expansion or locale translation.
5352
5353 s.  Fixed a bug in the globbing code that caused quoted filenames containing
5354     no globbing characters to sometimes be incorrectly expanded.
5355
5356 t.  Changes to the default prompt strings if prompt string decoding is not
5357     compiled into the shell.
5358
5359 u.  Added `do', `then', `else', `{', and `(' to the list of keywords that may
5360     precede the `time' reserved word.
5361
5362 v.  The shell may now be cross-built for BeOS as well as cygwin32.
5363
5364 w.  The conditional command execution code now treats `=' the same as `=='
5365     for deciding when to perform pattern matching.
5366
5367 x.  The `-e' option no longer causes the shell to exit if a command exits
5368     with a non-zero status while running the startup files.
5369
5370 y.  The `printf' builtin no longer dumps core if a modifier is supplied in
5371     the format string without a conversion character (e.g. `%h').
5372
5373 z.  Array assignments of the form a=(...) no longer show up in the history
5374     list.
5375
5376 aa. The parser was fixed to obey the POSIX.2 rules for finding the closing
5377     `}' in a ${...} expression.
5378
5379 bb. The history file is now opened with mode 0600 rather than 0666, so bash
5380     no longer relies on the user's umask being set appropriately.
5381
5382 cc. Setting LANG no longer causes LC_ALL to be assigned a value; bash now
5383     relies on proper behavior from the C library.
5384
5385 dd. Minor changes were made to allow quoted variable expansions using
5386     ${...} to be completed correctly if there is no closing `"'.
5387
5388 ee. Changes were made to builtins/Makefile.in so that configuring the shell
5389     with `--enable-profiling' works right and builtins/mkbuiltins is
5390     generated.
5391
5392 2.  Changes to Readline
5393
5394 a.  The version number is now 4.0.
5395
5396 b.  There is no longer any #ifdef SHELL code in the source files.
5397
5398 c.  Some changes were made to the key binding code to fix memory leaks and
5399     better support Win32 systems.
5400
5401 d.  Fixed a silly typo in the paren matching code -- it's microseconds, not
5402     milliseconds.
5403
5404 e.  The readline library should be compilable by C++ compilers.
5405
5406 f.  The readline.h public header file now includes function prototypes for
5407     all readline functions, and some changes were made to fix errors in the
5408     source files uncovered by the use of prototypes.
5409
5410 g.  The maximum numeric argument is now clamped at 1000000.
5411
5412 h.  Fixes to rl_yank_last_arg to make it behave better.
5413
5414 i.  Fixed a bug in the display code that caused core dumps if the prompt
5415     string length exceeded 1024 characters.
5416
5417 j.  The menu completion code was fixed to properly insert a single completion
5418     if there is only one match.
5419
5420 k.  A bug was fixed that caused the display code to improperly display tabs
5421     after newlines.
5422
5423 3.  New Features in Bash
5424
5425 a.  New `shopt' option, `restricted_shell', indicating whether or not the
5426     shell was started in restricted mode, for use in startup files.
5427
5428 b.  Filename generation is now performed on the words between ( and ) in
5429     array assignments (which it probably should have done all along).
5430
5431 c.  OLDPWD is now auto-exported, as POSIX.2 seems to require.
5432
5433 d.  ENV and BASH_ENV are read-only variables in a restricted shell.
5434
5435 4.  New Features in Readline
5436
5437 a.  Many changes to the signal handling:
5438         o Readline now catches SIGQUIT and cleans up the tty before returning;
5439         o A new variable, rl_catch_signals, is available to application writers 
5440           to indicate to readline whether or not it should install its own
5441           signal handlers for SIGINT, SIGTERM, SIGQUIT, SIGALRM, SIGTSTP,
5442           SIGTTIN, and SIGTTOU;
5443         o A new variable, rl_catch_sigwinch, is available to application
5444           writers to indicate to readline whether or not it should install its
5445           own signal handler for SIGWINCH, which will chain to the calling
5446           applications's SIGWINCH handler, if one is installed;
5447         o There is a new function, rl_free_line_state, for application signal
5448           handlers to call to free up the state associated with the current
5449           line after receiving a signal;
5450         o There is a new function, rl_cleanup_after_signal, to clean up the
5451           display and terminal state after receiving a signal;
5452         o There is a new function, rl_reset_after_signal, to reinitialize the
5453           terminal and display state after an application signal handler
5454           returns and readline continues
5455
5456 b.  There is a new function, rl_resize_terminal, to reset readline's idea of
5457     the screen size after a SIGWINCH.
5458
5459 c.  New public functions: rl_save_prompt and rl_restore_prompt.  These were
5460     previously private functions with a `_' prefix.
5461
5462 d.  New function hook: rl_pre_input_hook, called just before readline starts
5463     reading input, after initialization.
5464
5465 e.  New function hook: rl_display_matches_hook, called when readline would
5466     display the list of completion matches.  The new function
5467     rl_display_match_list is what readline uses internally, and is available
5468     for use by application functions called via this hook.
5469
5470 f.  New bindable function, delete-char-or-list, like tcsh.
5471
5472 ------------------------------------------------------------------------------
5473 This document details the changes between this version, bash-2.02.1-release,
5474 and the previous version, bash-2.02-release.
5475
5476 1.  Changes to Bash
5477
5478 a.  A bug that caused the bash readline support to not compile unless aliases
5479     and csh-style history were configured into the shell was fixed.
5480
5481 b.  Fixed a bug that could cause a core dump when here documents contained
5482     more than 1000 characters.
5483
5484 c.  Fixed a bug that caused a CDPATH entry of "" to not be treated the same
5485     as the current directory when in POSIX mode.
5486
5487 d.  Fixed an alignment problem with the memory returned by the bash malloc,
5488     so returned memory is now 64-bit aligned.
5489
5490 e.  Fixed a bug that caused command substitutions executed within pipelines
5491     to put the terminal in the wrong process group.
5492
5493 f.  Fixes to support/config.sub for: alphas, SCO Open Server and Open Desktop,
5494     Unixware 2, and Unixware 7.
5495
5496 g.  Fixes to the pattern matching code to make it work correctly for eight-bit
5497     characters.
5498
5499 h.  Fixed a problem that occasionally caused the shell to display the wrong
5500     value for the new working directory when changing to a directory found
5501     in $CDPATH when in physical mode.
5502
5503 i.  Fixed a bug that caused core dumps when using conditional commands in
5504     shell functions.
5505
5506 j.  Fixed a bug that caused the printf builtin to loop forever if the format
5507     string did not consume any of the arguments.
5508
5509 k.  Fixed a bug in the parameter expansion code that caused "$@" to be
5510     incorrectly split if $IFS did not contain a space character.
5511
5512 l.  Fixed a bug that could cause a core dump when completing hostnames if
5513     the number of matching hostnames was an exact multiple of 16.
5514
5515 m.  Fixed a bug that caused the shell to fork too early when a command
5516     such as `%2 &' was given.
5517
5518 2.  Changes to Readline
5519
5520 a.  Fixed a problem with redisplay that showed up when the prompt string was
5521     longer than the screen width and the prompt contained invisible characters.
5522
5523 ------------------------------------------------------------------------------
5524 This document details the changes between this version, bash-2.02-release,
5525 and the previous version, bash-2.02-beta2.
5526
5527 1.  Changes to Bash
5528
5529 a.  A bug was fixed that caused the terminal process group to be set
5530     incorrectly when performing command substitution of builtins in a
5531     pipeline.
5532
5533 ------------------------------------------------------------------------------
5534 This document details the changes between this version, bash-2.02-beta2,
5535 and the previous version, bash-2.02-beta1.
5536
5537 1.  Changes to Bash
5538
5539 a.  Attempting to `wait' for stopped jobs now generates a warning message.
5540
5541 b.  Pipelines which exit due to SIGPIPE in non-interactive shells are now
5542     not reported if the shell is compiled -DDONT_REPORT_SIGPIPE.
5543
5544 c.  Some changes were made to builtins/psize.sh and support/bashbug.sh to
5545     attempt to avoid some /tmp file races and surreptitious file
5546     substitutions.
5547
5548 d.  Fixed a bug that caused the shell not to compile if configured with
5549     dparen arithmetic but without aliases.
5550
5551 e.  Fixed a bug that caused the input stream to be switched when assigning
5552     empty arrays with `bash -c'.
5553
5554 f.  A bug was fixed in the readline expansion glue code that caused bash to
5555     dump core when expanding lines with an unclosed single quote.
5556
5557 g.  A fix was made to the `cd' builtin so that using a non-empty directory
5558     from $CDPATH results in an absolute pathname of the new current working
5559     directory to be displayed after the current directory is changed.
5560
5561 h.  Fixed a bug in the variable assignment code that caused the shell to
5562     dump core when referencing an unset variable with `set -u' enabled in
5563     an assignment statement preceding a command.
5564
5565 i.  Fixed a bug in the exit trap code that caused reserved words to not be
5566     recognized under certain circumstances.
5567
5568 j.  Fixed a bug in the parameter pattern substitution code so that quote
5569     removal is performed.
5570
5571 k.  The shell should now configure correctly on Apple Rhapsody systems.
5572
5573 l.  The `kill' builtin now prints a usage message if it is not passed any
5574     arguments.
5575
5576 ------------------------------------------------------------------------------
5577 This document details the changes between this version, bash-2.02-beta1,
5578 and the previous version, bash-2.02-alpha1.
5579
5580 1.  Changes to Bash
5581
5582 a.  A few compilation bugs were fixed in the new extended globbing code.
5583
5584 b.  Executing arithmetic commands now sets the command name to `((' so
5585     error messages look right.
5586
5587 c.  Fixed some build problems with various configuration options.
5588
5589 d.  The `printf' builtin now aborts immediately if an illegal format
5590     character is encountered.
5591
5592 e.  The code that creates here-documents now behaves better if the file it's
5593     trying to create already exists for some reason.
5594
5595 f.  Fixed a problem with the extended globbing code that made patterns like
5596     `x+*' expand incorrectly.
5597
5598 g.  The prompt string expansion code no longer quotes tildes with backslashes.
5599
5600 h.  The bash getcwd() implementation in lib/sh/getcwd.c now behaves better in
5601     the presence of lstat(2) failures.
5602
5603 i.  Fixed a bug with strsub() that caused core dumps when executing `fc -s'.
5604
5605 j.  The mail checking code now ensures that it has a valid default mailpath.
5606
5607 k.  A bug was fixed that caused local variables to be unset inappropriately
5608     when sourcing a script from within another sourced script.
5609
5610 l.  A bug was fixed in the history saving code so that functions are saved
5611     in the history list correctly if `cmdhist' is enabled, but `lithist'
5612     is not.
5613
5614 m.  A bug was fixed that caused printf overflows when displaying error
5615     messages.
5616
5617 n.  It should be easier to build the loadble builtins in examples/loadables,
5618     though some manual editing of the generated Makefile is still required.
5619
5620 o.  The user's primary group is now always ${GROUPS[0]}.
5621
5622 p.  Some updates were made to support/config.guess from the GNU master copy.
5623
5624 q.  Some changes were made to the autoconf support for Solaris 2.6 large
5625     files.
5626
5627 r.  The `command' builtins now does the right thing when confstr(3) cannot
5628     find a value for _CS_PATH.
5629
5630 s.  Extended globbing expressions like `*.!(c)' are not history expanded if
5631     `extglob' is enabled.
5632
5633 t.  Using the `-P' option to `cd' will force the value that is assigned to
5634     PWD to not contain any symbolic links.
5635
5636 2.  Changes to Readline
5637
5638 a.  The code that prints completion listings now behaves better if one or
5639     more of the filenames contains non-printable characters.
5640
5641 b.  The time delay when showing matching parentheses is now 0.5 seconds.
5642
5643 ------------------------------------------------------------------------------
5644 This document details the changes between this version, bash-2.02-alpha1,
5645 and the previous version, bash-2.01.1-release.
5646
5647 1.  Changes to Bash
5648
5649 a.  OS-specific configuration changes for:  BSD/OS 3.x, Minix 2.x,
5650     Solaris 2.6, SINIX SVR4.
5651
5652 b.  Changes were made to the generated `info' files so that `install-info'
5653     works correctly.
5654
5655 c.  PWD is now auto-exported.
5656
5657 d.  A fix was made to the pipeline code to make sure that the shell forks
5658     to execute simple commands consisting solely of assignment statements.
5659
5660 e.  Changes to the test suite for systems with 14-character filenames.
5661
5662 f.  The default sizes of some internal hash tables have been made smaller
5663     to reduce the shell's memory footprint.
5664
5665 g.  The `((...))' arithmetic command is now executed directly instead of
5666     being translated into `let "..."'.
5667
5668 h.  Fixes were made to the expansion code so that "$*", "$@", "${array[@]}",
5669     and "${array[@]}" expand correctly when IFS does not contain a space
5670     character, is unset, or is set to NULL.
5671
5672 i.  The indirect expansion code (${!var}) was changed so that the only
5673     valid values of `var' are variable names, positional parameters, `#',
5674     `@', and `*'.
5675
5676 j.  An arithmetic expression error in a $((...)) expansion now causes a
5677     non-interactive shell running in posix mode to exit.
5678
5679 k.  Compound array assignment now splits the words within the parentheses
5680     on shell metacharacters like the parser would before expansing them
5681     and performing the assignment.  This is for compatibility with ksh-93.
5682
5683 l.  The internal shell backslash-quoting code (used in the output of `set'
5684     and completion) now quotes tildes if they appear at the start of the
5685     string or after a `=' or `:'.
5686
5687 m.  A couple of bugs with `shopt -o' were fixed.
5688
5689 n.  `bash +o' now displays the same output as `set +o' before starting an
5690     interactive shell.
5691
5692 o.  A bug that caused command substitution and the `eval' builtin to
5693     occasionally free memory twice when an error was encountered was fixed.
5694
5695 p.  The filename globbing code no longer requires read permission for a
5696     directory when the filename to be matched does not contain any globbing
5697     characters, as POSIX.2 specifies.
5698
5699 q.  A bug was fixed so that the job containing the last asynchronous
5700     process is not removed from the job table until a `wait' is executed
5701     for that process or another asynchronous process is started.  This
5702     satisfies a POSIX.2 requirement.
5703
5704 r.  A `select' bug was fixed so that a non-numeric user response is treated
5705     the same as a numeric response that is out of range.
5706
5707 s.  The shell no longer parses the value of SHELLOPTS from the environment
5708     if it is restricted, running setuid, or running in `privileged mode'.
5709
5710 t.  Fixes were made to enable large file support on systems such as
5711     Solaris 2.6, where the size of a file may be larger than can be held
5712     in an `int'.
5713
5714 u.  The filename hashing code was fixed to not add `./' to the beginning of
5715     filenames which already begin with `./'.
5716
5717 v.  The configure script was changed so that the GNU termcap library is not
5718     compiled in if `prefer-curses' has been specified.
5719
5720 w.  HISTCONTROL and HISTIGNORE are no longer applied to the second and
5721     subsequent lines of a multi-line command.
5722
5723 x.  A fix was made to `disown' so that it does a better job of catching
5724     out-of-range jobs.
5725
5726 y.  Non-interactive shells no longer report the status of processes terminated
5727     due to SIGINT, even if the standard output is a terminal.
5728
5729 z.  A bug that caused the output of `jobs' to have extra carriage returns
5730     was fixed.
5731
5732 aa. A bug that caused PIPESTATUS to not be set when builtins or shell
5733     functions were executed in the foreground was fixed.
5734
5735 bb. Bash now attempts to detect when it is being run by sshd, and treats
5736     that case identically to being run by rshd.
5737
5738 cc. A bug that caused `set -a' to export SHELLOPTS when one of the shell
5739     options was changed was fixed.
5740
5741 dd. The `kill' builtin now disallows empty or missing process id arguments
5742     instead of treating them as identical to `0', which means the current
5743     process.
5744
5745 ee. `var=value declare -x var' now behaves identically to
5746     `var=value export var'.  Similarly for `var=value declare -r var' and
5747     `var=value readonly var'.
5748
5749 ff. A few memory leaks were fixed.
5750
5751 gg. `alias' and `unalias' now print error messages when passed an argument
5752     that is not an alias for printing or deletion, even when the shell is
5753     not interactive, as POSIX.2 specifies.
5754
5755 hh. `alias' and `alias -p' now return a status of 0 when no aliases are
5756     defined, as POSIX.2 specifes.
5757
5758 ii. `cd -' now prints the pathname of the new working directory if the shell
5759     is interactive.
5760
5761 jj. A fix was made so that the code that binds $PWD now copes with getcwd()
5762     returning NULL.
5763
5764 kk. `unset' now checks whether or not a function name it's trying to unset
5765     is a valid shell identifier only when the shell is running in posix mode.
5766
5767 ll. A change was made to the code that generates filenames for here documents
5768     to make them less prone to name collisions.
5769
5770 mm. The parser was changed so that `time' is recognized as a reserved word
5771     only at the beginning of a pipeline.
5772
5773 nn. The pathname canonicalization code was changed so that `//' is converted
5774     into `/', but all other pathnames beginning with `//' are left alone, as
5775     POSIX.2 specifies.
5776
5777 oo. The `logout' builtin will no longer exit a non-interactive non-login
5778     shell.
5779
5780 2.  Changes to Readline
5781
5782 a.  Fixed a problem in the readline test program rltest.c that caused a core
5783     dump.
5784
5785 b.  The code that handles parser directives in inputrc files now displays
5786     more error messages.
5787
5788 c.  The history expansion code was fixed so that the appearance of the
5789     history comment character at the beginning of a word inhibits history
5790     expansion for that word and the rest of the input line.
5791
5792 3.  New Features in Bash
5793
5794 a.  A new version of malloc, based on the older GNU malloc, that has many
5795     changes, is more page-based, is more conservative with memory usage,
5796     and does not `orphan' large blocks when they are freed.
5797
5798 b.  A new version of gmalloc, based on the old GLIBC malloc, with many
5799     changes and range checking included by default.
5800
5801 c.  A new implementation of fnmatch(3) that includes full POSIX.2 Basic
5802     Regular Expression matching, including character classes, collating
5803     symbols, equivalence classes, and support for case-insensitive pattern
5804     matching.
5805
5806 d.  ksh-88 egrep-style extended pattern matching ([@+*?!](patlist)) has been
5807     implemented, controlled by a new `shopt' option, `extglob'.
5808
5809 e.  There is a new ksh-like `[[' compound command, which implements
5810     extended `test' functionality.
5811
5812 f.  There is a new `printf' builtin, implemented according to the POSIX.2
5813     specification.
5814
5815 g.  There is a new feature for command substitution: $(< filename) now expands
5816     to the contents of `filename', with any trailing newlines removed
5817     (equivalent to $(cat filename)).
5818
5819 h.  There are new tilde prefixes which expand to directories from the
5820     directory stack.
5821
5822 i.  There is a new `**' arithmetic operator to do exponentiation.
5823
5824 j.  There are new configuration options to control how bash is linked:
5825     `--enable-profiling', to allow bash to be profiled with gprof, and
5826     `--enable-static-link', to allow bash to be linked statically.
5827
5828 k.  There is a new configuration option, `--enable-cond-command', which
5829     controls whether or not the `[[' command is included.  It is on by
5830     default.
5831
5832 l.  There is a new configuration option, `--enable-extended-glob', which
5833     controls whether or not the ksh extended globbing feature is included.
5834     It is enabled by default.
5835
5836 m.  There is a new configuration #define in config.h.top that, when enabled,
5837     will cause all login shells to source /etc/profile and one of the user-
5838     specific login shell startup files, whether or not the shell is
5839     interactive.
5840
5841 n.  There is a new invocation option, `--dump-po-strings', to dump
5842     a shell script's translatable strings ($"...") in GNU `po' format.
5843
5844 o.  There is a new `shopt' option, `nocaseglob', to enable case-insensitive
5845     pattern matching when globbing filenames and using the `case' construct.
5846
5847 p.  There is a new `shopt' option, `huponexit', which, when enabled, causes
5848     the shell to send SIGHUP to all jobs when an interactive login shell
5849     exits.
5850
5851 q.  `bind' has a new `-u' option, which takes a readline function name as an
5852     argument and unbinds all key sequences bound to that function in a
5853     specified keymap.
5854
5855 r.  `disown' now has `-a' and `-r' options, to limit operation to all jobs
5856     and running jobs, respectively.
5857
5858 s.  The `shopt' `-p' option now causes output to be displayed in a reusable
5859     format.
5860
5861 t.  `test' has a new `-N' option, which returns true if the filename argument
5862     has been modified since it was last accessed.
5863
5864 u.  `umask' now has a `-p' option to print output in a reusable format.
5865
5866 v.  A new escape sequence, `\xNNN', has been added to the `echo -e' and $'...'
5867     translation code.  It expands to the character whose ascii code is NNN
5868     in hexadecimal.
5869
5870 w.  The prompt string expansion code has a new `\r' escape sequence.
5871
5872 x.  The shell may now be cross-compiled for the CYGWIN32 environment on
5873     a Unix machine.
5874
5875 4.  New Features in Readline
5876
5877 a.  There is now an option for `iterative' yank-last-arg handline, so a user
5878     can keep entering `M-.', yanking the last argument of successive history
5879     lines.
5880
5881 b.  New variable, `print-completions-horizontally', which causes completion
5882     matches to be displayed across the screen (like `ls -x') rather than up
5883     and down the screen (like `ls').
5884
5885 c.  New variable, `completion-ignore-case', which causes filename completion
5886     and matching to be performed case-insensitively.
5887
5888 d.  There is a new bindable command, `magic-space', which causes history
5889     expansion to be performed on the current readline buffer and a space to
5890     be inserted into the result.
5891
5892 e.  There is a new bindable command, `menu-complete', which enables tcsh-like
5893     menu completion (successive executions of menu-complete insert a single
5894     completion match, cycling through the list of possible completions).
5895
5896 f.  There is a new bindable command, `paste-from-clipboard', for use on Win32
5897     systems, to insert the text from the Win32 clipboard into the editing
5898     buffer.
5899
5900 g.  The key sequence translation code now understands printf-style backslash
5901     escape sequences, including \NNN octal escapes.  These escape sequences
5902     may be used in key sequence definitions or macro values.
5903
5904 h.  An `$include' inputrc file parser directive has been added.
5905
5906 ------------------------------------------------------------------------------
5907 This document details the changes between this version, bash-2.01.1-release,
5908 and the previous version, bash-2.01-release.
5909
5910 1.  Changes to Bash
5911
5912 a.  The select command was fixed to check the validity of the user's
5913     input more strenuously.
5914
5915 b.  A bug was fixed that prevented `time' from timing commands correctly
5916     when supplied as an argument to `bash -c'.
5917
5918 c.  A fix was made to the mail checking code to keep from adding the same
5919     mail file to the list of files to check multiple times when parsing
5920     $MAILPATH.
5921
5922 d.  Fixed an off-by-one error in the tilde expansion library.
5923
5924 e.  When using the compound array assignment syntax, the old value of
5925     the array is cleared before assigning the new value.
5926
5927 f.  Fixed a bug that could cause a core dump when a trap handler was reset
5928     to the default in the trap command associated with that signal.
5929
5930 g.  Fixed a bug in the locale code that occurred when assigning a value
5931     to LC_ALL.
5932
5933 h.  A change was made to the parser so that words of the form xxx=(...)
5934     are not considered compound assignment statements unless there are
5935     characters before the `='.
5936
5937 i.  A fix was made to the command tracing code to correctly quote each
5938     word of output.
5939
5940 j.  Some changes were made to the bash-specific autoconf tests to make them
5941     more portable.
5942
5943 k.  Completion of words with globbing characters now correctly quotes the
5944     result.
5945
5946 l.  The directory /var/spool/mail is now preferred to /usr/spool/mail when
5947     configure is deciding on the default mail directory.
5948
5949 m.  The brace completion code was fixed to not quote the `{' and `}'.
5950
5951 n.  Some fixes were made to make $RANDOM more random in subshells.
5952
5953 o.  System-specific changes were made to configure for: SVR4.2
5954
5955 p.  Changes were made so that completion of words containing globbing chars
5956     substitutes the result only if a single filename was matched.
5957
5958 q.  The window size is now recomputed after a job is stopped with SIGTSTP if
5959     the user has set `checkwinsize' with `shopt'.
5960
5961 r.  When doing substring expansion, out-of-range substring specifiers now
5962     cause nothing to be substituted rather than an expansion error.
5963
5964 s.  A fix was made so that you can no longer trap `SIGEXIT' or `SIGDEBUG' --
5965     only `EXIT' and `DEBUG' are accepted.
5966
5967 t.  The display of trapped signals now uses the signal number if signals
5968     for which bash does not know the name are trapped.
5969
5970 u.  A fix was made so that `bash -r' does not turn on restricted mode until
5971     after the startup files are executed.
5972
5973 v.  A bug was fixed that occasionally caused a core dump when a variable
5974     found in the temporary environment of export/declare/readonly had a
5975     null value.
5976
5977 w.  A bug that occasionally caused unallocated memory to be passed to free()
5978     when doing arithmetic substitution was fixed.
5979
5980 x.  A bug that caused a buffer overrun when expanding a prompt string
5981     containing `\w' and ${#PWD} exceeded PATH_MAX was fixed.
5982
5983 y.  A problem with the completion code that occasionally caused it to
5984     refer to a character before the beginning of the readline line buffer
5985     was fixed.
5986
5987 z.  A bug was fixed so that the `read' builtin restarts reads when
5988     interrupted by signals other than SIGINT.
5989
5990 aa. Fixed a bug that caused a command to be freed twice when there was
5991     an evaluation error in the `eval' command.
5992
5993 2.  Changes to Readline
5994
5995 a.  Added a missing `extern' to a declaration in readline.h that kept
5996     readline from compiling cleanly on some systems.
5997
5998 b.  The history file is now opened with mode 0600 when it is written for
5999     better security.
6000
6001 c.  Changes were made to the SIGWINCH handling code so that prompt redisplay
6002     is done better.
6003
6004 d.  ^G now interrupts incremental searches correctly.
6005
6006 e.  A bug that caused a core dump when the set of characters to be quoted
6007     when completing words was empty was fixed.
6008
6009 ------------------------------------------------------------------------------
6010 This document details the changes between this version, bash-2.01-release,
6011 and the previous version, bash-2.01-beta2.
6012
6013 1.  Changes to Bash
6014
6015 a.  The `distclean' target should remove the `printenv' executable if it
6016     has been created.
6017
6018 b.  The test suite was changed slightly to ensure that the error messages
6019     are printed in English.
6020
6021 c.  A bug that caused the shell to dump core when a filename containing a
6022     `/' was passed to `hash' was fixed.
6023
6024 d.  Pathname canonicalization now leaves a leading `//' intact, as POSIX.1
6025     requires.
6026
6027 e.  A memory leak when completing commands was fixed.
6028
6029 f.  A memory leak that occurred when checking the hash table for commands
6030     with relative paths was fixed.
6031
6032 ------------------------------------------------------------------------------
6033 This document details the changes between this version, bash-2.01-beta2,
6034 and the previous version, bash-2.01-beta1.
6035
6036 1.  Changes to Bash
6037
6038 a.  The `ulimit' builtin translates RLIM_INFINITY to the hard limit only if
6039     the current (soft) limit is less than or equal to the hard limit.
6040
6041 b.  Fixed a bug that caused the bash emulation of strcasecmp to produce
6042     incorrect results.
6043
6044 c.  A bug that caused memory to be freed twice when a trap handler resets
6045     the trap more than once was fixed.
6046
6047 d.  A bug that caused machines where sizeof (pointer) > sizeof (int) to
6048     fail (and possibly dump core) when trying to unwind-protect a null
6049     pointer was fixed.
6050
6051 e.  The startup files should not be run with job control enabled.  This fix
6052     allows SIGINT to once again interrupt startup file execution.
6053
6054 f.  Bash should not change the SIGPROF handler if it is set to something
6055     other than SIG_DFL.
6056
6057 g.  The completion code that provides bash-specific completions for readline
6058     now quotes characters that the readline code would treat as word break
6059     characters if they appear in a file name.
6060
6061 h.  The completion code now correctly quotes filenames containing a `!',
6062     even if the user attempted to use double quotes when attempting
6063     completion.
6064
6065 i.  A bug that caused the shell to dump core when `disown' was called without
6066     arguments and there was no current job was fixed.
6067
6068 j.  A construct like $((foo);bar) is now processed as a command substitution
6069     rather than as a bad arithmetic substitution.
6070
6071 k.  A couple of bugs that caused `fc' to not obey the `cmdhist' and `lithist'
6072     shell options when editing and re-executing a series of commands were
6073     fixed.
6074
6075 l.  A fix was made to the grammar -- the list of commands between `do' and
6076     `done' in the body of a `for' command should be treated the same as a
6077     while loop.
6078
6079 2.  Changes to Readline
6080
6081 a.  A couple of bugs that caused the history search functions to attempt to
6082     free a NULL pointer were fixed.
6083
6084 b.  If the C library provides setlocale(3), readline does not need to look
6085     at various environment variables to decide whether or not to go into
6086     eight-bit mode automatically -- just check whether the current locale
6087     is not `C' or `POSIX'.
6088
6089 c.  If the filename completion function finds that a directory was not closed
6090     by a previous (interrupted) completion, it closes the directory with
6091     closedir().
6092
6093 3.  New Features in Bash
6094
6095 a.  New bindable readline commands:  history-and-alias-expand-line and
6096     alias-expand-line.  The code was always in there, there was just no
6097     way to execute it.
6098
6099 ------------------------------------------------------------------------------
6100 This document details the changes between this version, bash-2.01-beta1,
6101 and the previous version, bash-2.01-alpha1.
6102
6103 1.  Changes to Bash
6104
6105 a.  Fixed a problem that could cause file descriptors used for process
6106     substitution to conflict with those used explicitly in redirections.
6107
6108 b.  Made it easier to regenerate configure if the user changes configure.in.
6109
6110 c.  ${GROUPS[0]} should always be the primary group, even on systems without
6111     multiple groups.
6112
6113 d.  Spelling correction is no longer enabled by default.
6114
6115 e.  Fixes to quoting problems in `bashbug'.
6116
6117 f.  OS-specific configuration changes were made for: Irix 6.
6118
6119 g.  OS-specific code changes were made for: QNX.
6120
6121 h.  A more meaningful message is now printed when the file in /tmp for a
6122     here document cannot be created.
6123
6124 i.  Many changes to the shell's variable initialization code to speed
6125     non-interactive startup.
6126
6127 j.  Changes to the non-job-control code so that it does not try to open
6128     /dev/tty.
6129
6130 k.  The output of `set' and `export' is once again sorted, as POSIX wants.
6131
6132 l.  Fixed a problem caused by a recursive call reparsing the value of
6133     $SHELLOPTS.
6134
6135 m.  The tilde code no longer calls getenv() when it's compiled as part of
6136     the shell, which should eliminate problems on systems that cannot
6137     redefine getenv(), like the NeXT OS.
6138
6139 n.  Fixed a problem that caused `bash -o' or `bash +o' to not list all
6140     the shell options.
6141
6142 o.  Fixed `ulimit' to convert RLIM_INFINITY to the appropriate hard limit
6143     only if the hard limit is greater than the current (soft) limit.
6144
6145 p.  Fixed a problem that arose when building bash in a different directory
6146     than the source and y.tab.[ch] were remade with something other than
6147     bison.  This came up most often on NetBSD.
6148
6149 q.  Fixed a problem with completion -- it thought that `pwd`/[TAB] indicated
6150     an unfinished command completion (`/), which generated errors.
6151
6152 r.  The bash special tilde expansions (~-, ~+) are now attempted before
6153     calling the standard tilde expansion code, which should eliminate the
6154     problems people have been seeing with this on Solaris 2.5.1.
6155
6156 s.  Added support for <stdarg.h> to places where it was missing.
6157
6158 t.  Changed the code that reads the output of a command substitution to not
6159     go through stdio.  This reduces the memory requirements and is faster.
6160
6161 u.  A number of changes to speed up export environment creation were made.
6162
6163 v.  A number of memory leaks were fixed as the result of running the test
6164     scripts through Purify.
6165
6166 w.  Fixed a bug that caused subshells forked to interpret executable
6167     scripts without a leading `#!' to not reinitialize the values of
6168     the shell options.
6169
6170 2.  Changes to Readline
6171
6172 a.  History library has less `#ifdef SHELL' code -- abstracted stuff out
6173     into application-specific function hooks.
6174
6175 b.  Readline no longer calls getenv() if it's compiled as part of the shell,
6176     which should eliminate problems on systems that cannot redefine getenv(),
6177     like the NeXT OS.
6178
6179 c.  Fixed translation of ESC when `untranslating' macro values.
6180
6181 d.  The region kill operation now fixes the mark if it ends up beyond the
6182     boundaries of the line after the region is deleted.
6183
6184 3.  New Features in Bash
6185
6186 a.  New argument for `configure':  `--with-curses'.  This can be used to
6187     override the selection of the termcap library on systems where it is
6188     deficient.
6189
6190 ------------------------------------------------------------------------------
6191 This document details the changes between this version, bash-2.01-alpha1,
6192 and the previous version, bash-2.0-release.
6193
6194 1.  Changes to Bash
6195
6196 a.  System-specific configuration changes for: FreeBSD, SunOS4, Irix,
6197     MachTen, QNX 4.2, Harris Night Hawk, SunOS5.
6198
6199 b.  System-specific code changes were made for: Linux, 4.4 BSD, QNX 4.2,
6200     HP-UX, AIX 4.2.
6201
6202 c.  A bug that caused the exec builtin to fail because the full pathname of
6203     the command could not be found was fixed.
6204
6205 d.  The code that performs output redirections is now more resistant to
6206     race conditions and possible security exploits.
6207
6208 e.  A bug that caused the shell to dump core when performing pattern
6209     substitutions on variable values was fixed.
6210
6211 f.  More hosts are now recognized by the auto-configuration mechanism
6212     (OpenBSD, QNX, others).
6213
6214 g.  Assignments to read-only variables that attempt to convert them to
6215     arrays are now errors.
6216
6217 h.  A bug that caused shell scripts using array assignments in POSIX mode
6218     to exit after the assignment was performed was fixed.
6219
6220 i.  The substring expansion code is now more careful about running off the
6221     ends of the expanded variable value.
6222
6223 j.  A bug that caused completion to fail if a backquoted command substitution
6224     appeared anywhere on the line was fixed.
6225
6226 k.  The `source' builtin no longer turns off history if it has been enabled
6227     in a non-interactive shell.
6228
6229 l.  A bug that caused the shell to crash when `disown' was given a pid
6230     instead of a job number was fixed.
6231
6232 m.  The `cd' spelling correction code will not try to change to `.' if no
6233     directory entries match a single-character argument.
6234
6235 n.  A bad variable name supplied to `declare', `export', or `readonly' no
6236     longer causes a non-interactive shell in POSIX mode to exit.
6237
6238 o.  Some fixes were made to the test suite to handle peculiarities of
6239     various Unix versions.
6240
6241 p.  The bash completion code now quotes characters that readline would
6242     treat as word breaks for completion but are not shell metacharacters.
6243
6244 q.  Bad options supplied at invocation now cause a usage message to be
6245     displayed.
6246
6247 r.  Fixes were made to the code that handles DEBUG traps so that the trap
6248     string is not freed inappropriately.
6249
6250 s.  Some changes were made to the bash debugger in examples/bashdb -- it
6251     should be closer to working now.
6252
6253 t.  A problem that caused the default filename used for mail checking to be
6254     wrong was fixed.
6255
6256 u.  A fix was made to the `echo' builtin so that NUL characters printed with
6257     `echo -e' do not cause the output to be truncated.
6258
6259 v.  A fix was made to the job control code so that the shell behaves better
6260     when monitor mode is enabled in a non-interactive shell.
6261
6262 w.  Bash no longer catches all of the terminating signals in a non-
6263     interactive shell until a trap is set on EXIT, which should result in
6264     quicker startup.
6265
6266 x.  A fix was made to the command timing code so that `time' can be used in
6267     a loop.
6268
6269 y.  A fix was made to the parser so that `((cmd); cmd2)' is now parsed as
6270     a nested subshell rather than strictly as an (erroneous) arithmetic
6271     command.
6272
6273 z.  A fix was made to the globbing code so that it correctly matches quoted
6274     filenames beginning with a `.'.
6275
6276 aa. A bug in `fc' that caused some multi-line commands to not be stored as
6277     one command in the history when they were re-executed after editing
6278     (with `fc -e') was fixed.
6279
6280 bb. The `ulimit' builtin now attempts to catch some classes of integer
6281     overflows.
6282
6283 cc. The command-oriented-history code no longer attempts to add `;'
6284     inappropriately when a newline appears while reading a $(...) command
6285     substitution.
6286
6287 dd. A bug that caused the shell to dump core when `help --' was executed
6288     was fixed.
6289
6290 ee. A bug that caused the shell to crash when an unset variable appeared
6291     in the body of a here document after `set -u' had been executed was
6292     fixed.
6293
6294 ff. Implicit input redirections from /dev/null for asynchronous commands
6295     are now handled better.
6296
6297 gg. A bug that caused the shell to fail to compile when configured with
6298     `--disable-readline' was fixed.
6299
6300 hh. The globbing code should now be interruptible.
6301
6302 ii. Bash now notices when the `kill' builtin is used to send SIGCONT to a
6303     stopped job and adjusts the data structures accordingly, as if `bg' had
6304     been executed instead.
6305
6306 jj. A bug that caused the shell to crash when mixing calls to `getopts'
6307     and `shift' on the same set of positional parameters was fixed.
6308
6309 kk. The command printing code now preserves the `-p' flag to `time'.
6310
6311 ll. The command printing code now handles here documents better when there
6312     are other redirections associated with the command.
6313
6314 mm. The special glibc environment variable (NNN_GNU_nonoption_argv_flags_)
6315     is no longer placed into the environment of executed commands -- users
6316     of glibc had too many problems with it.
6317
6318 nn. Reorganized the code that generates signames.h.  The signal_names list
6319     is now more complete but may be slightly different (SIGABRT is favored
6320     over SIGIOT, for example).  The preferred signal names are those
6321     listed in the POSIX.2 standard.
6322
6323 oo. `bashbug' now uses a filename shorter than 14 characters for its
6324     temporary file, and asks for confirmation before sending the bug
6325     report.
6326
6327 pp. A bug that caused TAB completion in vi editing mode to not be turned
6328     off when `set -o posix' was executed or back on when `set +o posix'
6329     was executed was fixed.
6330
6331 qq. A bug in the brace expansion code that caused brace expansions appearing
6332     in new-style $(...) command substitutions to be inappropriately expanded
6333     was fixed.
6334
6335 rr. A bug in the readline hook shell-expand-line that could cause memory to
6336     be inappropriately freed was fixed.
6337
6338 ss. A bug that caused some arithmetic expressions containing `&&' and `||'
6339     to be parsed with the wrong precedence has been fixed.
6340
6341 tt. References to unbound variables after `set -u' has been executed now
6342     cause the shell to exit immediately, as they should.
6343
6344 uu. A bug that caused the shell to exit inappropriately when `set -e' had
6345     been executed and a command's return status was being inverted with the
6346     `!' reserved word was fixed.
6347
6348 vv. A bug that could occasionally cause the shell to crash with a
6349     divide-by-zero error when timing a command was fixed.
6350
6351 ww. A bug that caused parameter pattern substitution to leave stray
6352     backslashes in the replacement string when the expression is in
6353     double quotes was fixed.
6354
6355 xx. The `break' and `continue' builtins now break out of all loops when an
6356     invalid count argument is supplied.
6357
6358 yy. Fixed a bug that caused PATH to be set to the empty string if
6359     `command -p' is executed with PATH unset.
6360
6361 zz. Fixed `kill -l signum' to print the signal name without the `SIG' prefix,
6362     as POSIX specifies.
6363
6364 aaa. Fixed a bug that caused the shell to crash while setting $SHELLOPTS
6365      if there were no shell options set.
6366
6367 bbb. Fixed `export -p' and `readonly -p' so that when the shell is in POSIX
6368      mode, their output is as POSIX.2 specifies.
6369
6370 ccc. Fixed a bug in `readonly' so that `readonly -a avar=(...)' actually
6371      creates an array variable.
6372
6373 ddd. Fixed a bug that prevented `time' from correctly timing background
6374      pipelines.
6375
6376 2.  Changes to Readline
6377
6378 a.  A bug that caused an extra newline to be printed when the cursor was on
6379     an otherwise empty line was fixed.
6380
6381 b.  An instance of memory being used after it was freed was corrected.
6382
6383 c.  The redisplay code now works when the prompt is longer than the screen
6384     width.
6385
6386 d.  `dump-macros' is now a bindable name, as it should have been all along.
6387
6388 e.  Non-printable characters are now expanded when displaying macros and
6389     their values.
6390
6391 f.  The `dump-variables' and `dump-macros' commands now output a leading
6392     newline if they're called as the result of a key sequence, rather
6393     than directly by an application.
6394
6395 3.  New Features in Bash
6396
6397 a.  There is a new builtin array variable: GROUPS, the set of groups to which
6398     the user belongs.  This is used by the test suite.
6399
6400 4.  New Features in Readline
6401
6402 a.  If a key sequence bound to `universal-argument' is read while reading a
6403     numeric argument started with `universal-argument', it terminates the
6404     argument but is otherwise ignored.  This provides a way to insert multiple
6405     instances of a digit string, and is how GNU emacs does it.
6406
6407 ------------------------------------------------------------------------------
6408 This document details the changes between this version, bash-2.0-release,
6409 and the previous version, bash-2.0-beta3.
6410
6411 1.  Changes to Bash
6412
6413 a.  Fix to the `getopts' builtin so that it does the right thing when a
6414     required option argument is not present.
6415
6416 b.  The completion code now updates the common prefix of matched names
6417     after FIGNORE processing is done, since any names that were removed
6418     may have changed the common prefix.
6419
6420 c.  Fixed a bug that made messages in MAILPATH entries not work correctly.
6421
6422 d.  Fixed a serious documentation error in the description of the new
6423     ${parameter:offset[:length]} expansion.
6424
6425 e.  Fixes to make parameter substring expansion ({$param:offset[:length]})
6426     work when within double quotes.
6427
6428 f.  Fixes to make ^A (CTLESC) survive an unquoted expansion of positional
6429     parameters.
6430
6431 g.  Corrected a misspelling of `unlimited' in the output of `ulimit'.
6432
6433 h.  Fixed a bug that caused executable scripts without a leading `#!' to
6434     occasionally pick up the wrong set of positional parameters.
6435
6436 i.  Linux systems now have a working `ulimit -v', using RLIMIT_AS.
6437
6438 j.  Updated config.guess so that many more machine types are recognized.
6439
6440 k.  Fixed a bug with backslash-quoted slashes in the ${param/pat[/sub]}
6441     expansion.
6442
6443 l.  If the shell is named `-su', and `-c command' is supplied, read and
6444     execute the login shell startup files even though the shell is not
6445     interactive.  This is to support the `-' option to `su'.
6446
6447 m.  Fixed a bug that caused core dumps when the DEBUG trap was ignored
6448     with `trap "" DEBUG' and a shell function was subsequently executed.
6449
6450 n.  Fixed a bug that caused core dumps in the read builtin when IFS was
6451     set to the null string and the input had leading whitespace.
6452
6453 2.  Changes to Readline
6454
6455 a.  Fixed a bug that caused a numeric argument of 1024 to be ignored when
6456     inserting text.
6457
6458 b.  Fixed the display code so that the numeric argument is displayed as it's
6459     being entered.
6460
6461 c.  Fixed the numeric argument reading code so that `M-- command' is
6462     equivalent to `M--1 command', as the prompt implies.
6463
6464 3.  New Features in Bash
6465
6466 a.  `ulimit' now sets both hard and soft limits and reports the soft limit
6467     by default (when neither -H nor -S is specified).  This is compatible
6468     with versions of sh and ksh that implement `ulimit'.
6469
6470 b.  Integer constants have been extended to base 64.
6471
6472 4.  New Features in Readline
6473
6474 a.  The `home' and `end' keys are now bound to beginning-of-line and
6475     end-of-line, respectively, if the corresponding termcap capabilities
6476     are present.
6477
6478 ------------------------------------------------------------------------------
6479 This document details the changes between this version, bash-2.0-beta3,
6480 and the previous version, bash-2.0-beta2.
6481
6482 1.  Changes to Bash
6483
6484 a.  System-specific changes for: AIX 4.2, SCO 3.2v[45], HP-UX.
6485
6486 b.  When in POSIX mode, variable assignments preceding a special builtin
6487     persist in the shell environment after the builtin completes.
6488
6489 c.  Changed all calls to getwd() to getcwd().  Improved check for systems
6490     where the libc getcwd() calls popen(), since that breaks on some
6491     systems when job control is being used.
6492
6493 d.  Fixed a bug that caused seg faults when executing scripts with the
6494     execute bit set but without a leading `#!'.
6495
6496 e.  The environment passed to executed commands is never sorted.
6497
6498 f.  A bug was fixed in the code that expands ${name[@]} to the number of
6499     elements in an array variable.
6500
6501 g.  A bug was fixed in the array compound assignment code ( A=( ... ) ).
6502
6503 h.  Window size changes now correctly propagate down to readline if
6504     the shopt `checkwinsize' option is enabled.
6505
6506 i.  A fix was made in the code that expands to the length of a variable
6507     value (${#var}).
6508
6509 j.  A fix was made to the command builtin so that it did not turn on the
6510     `no fork' flag inappropriately.
6511
6512 k.  A fix was made to make `set -n' work more reliably.
6513
6514 l.  A fix was made to the job control initialization code so that the
6515     terminal process group is set to the shell's process group if the
6516     shell changes its own process group.
6517
6518 2.  Changes to Readline
6519
6520 a.  System-specific changes for: SCO 3.2v[45].
6521
6522 b.  The behavior of the vi-mode `.' when redoing an `i' command was changed
6523     to insert the text previously inserted by the `i' command rather than
6524     simply entering insert mode.
6525
6526 3.  New features in Bash
6527
6528 a.  There is a new version of the autoload function package, in
6529     examples/functions/autoload.v2, that uses arrays and provides more
6530     functionality.
6531
6532 b.  Support for LC_COLLATE and locale-specific sorting of the results of
6533     pathname expansion if strcoll() is available.
6534
6535 4.  New Features in Readline
6536
6537 a.  Support for locale-specific sorting of completion possibilities if
6538     strcoll() is available.
6539
6540 ------------------------------------------------------------------------------
6541 This document details the changes between this version, bash-2.0-beta2,
6542 and the previous version, bash-2.0-beta1.
6543
6544 1.  Changes to Bash
6545
6546 a.  `pushd -' is once again equivalent to `pushd $OLDPWD'.
6547
6548 b.  OS-specific changes for: SCO 3.2v[45].
6549
6550 c.  A change was made to the fix for the recently-reported security hole
6551     when reading characters with octal value 255 to make it work better on
6552     systems with restartable system calls when not using readline.
6553
6554 d.  Some changes were made to the test suite so that it works if you
6555     configure bash with --enable-usg-echo-default.
6556
6557 e.  A fix was made to the parsing of conditional arithmetic expressions.
6558
6559 f.  Illegal arithmetic bases now cause an arithmetic evaluation error rather
6560     than being silently reset.
6561
6562 g.  Multiple arithmetic bases now cause an arithmetic evaluation error
6563     instead of being ignored.
6564
6565 h.  A fix was made to the evaluation of ${param?word} to conform to POSIX.2.
6566
6567 i.  A bug that sometimes caused array indices to be evaluated twice (which
6568     would cause errors when they contained assignment statements) was fixed.
6569
6570 j.  `ulimit' was rewritten to avoid problems with getrlimit(2) returning
6571     unsigned values and to simplify the code.
6572
6573 k.  A bug in the command-oriented-history code that caused it to sometimes
6574     put semicolons after right parens inappropriately was fixed.
6575
6576 l.  The values inserted into the prompt by the \w and \W escape sequences
6577     are now quoted to prevent further expansion.
6578
6579 m.  An interactive shell invoked as `sh' now reads and executes commands
6580     from the file named by $ENV when it starts up.  If it's a login shell,
6581     it does this after reading /etc/profile and ~/.profile.
6582
6583 n.  The file named by $ENV is never read by non-interactive shells.
6584
6585 2.  Changes to Readline
6586
6587 a.  A few changes were made to hide some macros and functions that should not
6588     be public.
6589
6590 b.  An off-by-one error that caused seg faults in the history expansion code
6591     was fixed.
6592
6593 3.  New Features in Bash
6594
6595 a.  The ksh-style ((...)) arithmetic command was implemented.  It is exactly
6596     identical to let "...".  This is controlled by a new option to configure,
6597     `--enable-dparen-arithmetic', which is on by default.
6598
6599 b.  There is a new #define available in config.h.top: SYS_BASH_LOGOUT.  If
6600     defined to a filename, bash reads and executes commands from that file
6601     when a login shell exits.  It's commented out by default.
6602
6603 c.  `ulimit' has a `-l' option that reports the maximum amount of data that
6604     may be locked into memory on 4.4BSD-based systems.
6605
6606 ------------------------------------------------------------------------------
6607 This document details the changes between this version, bash-2.0-beta1,
6608 and the previous version, bash-2.0-alpha4.
6609
6610 1.  Changes to Bash
6611
6612 a.  A bug that sometimes caused traps to be ignored on signals the
6613     shell treats specially was fixed.
6614
6615 b.  The internationalization code was changed to track the values of
6616     LC_* variables and call setlocale() as appropriate.  The TEXTDOMAIN
6617     and TEXTDOMAINDIR variables are also tracked; changes cause calls
6618     to textdomain() and bindtextdomain(), if available.
6619
6620 c.  A bug was fixed that sometimes caused double-quoted strings to be
6621     parsed incorrectly.
6622
6623 d.  Changes were made so that the siglist code compiles correctly on
6624     Solaris 2.5.
6625
6626 e.  Added `:' to the set of characters that cause word breaks for the
6627     completion code so that pathnames in assignments to $PATH can be
6628     completed.
6629
6630 f.  The `select' command was fixed to print $PS3 to stderr.
6631
6632 g.  Fixed an error in the manual page section describing the effect that
6633     setting and unsetting GLOBIGNORE has on the setting of the `dotglob'
6634     option.
6635
6636 h.  The time conversion code now uses CLK_TCK rather than CLOCKS_PER_SEC
6637     on systems without gettimeofday() and resources.
6638
6639 i.  The getopt static variables are now initialized each time a subshell
6640     is started, so subshells using `getopts' work right.
6641
6642 j.  A sign-extension bug that caused a possible security hole was fixed.
6643
6644 k.  The parser now reads characters between backquotes within a double-
6645     quoted string as a single word, so double quotes in the backquoted
6646     string don't terminate the enclosing double-quoted string.
6647
6648 l.  A bug that caused `^O' to work incorrectly when typed as the first
6649     thing to an interactive shell was fixed.
6650
6651 m.  A rarely-exercised off-by-one error in the code that quotes variable
6652     values was fixed.
6653
6654 n.  Some memory and file descriptor leaks encountered when running a
6655     shell script that is executable but does not have a leading `#!'
6656     were plugged.
6657
6658 2.  Changes to Readline
6659
6660 a.  A bug that sometimes caused incorrect results when trying to read
6661     typeahead on systems without FIONREAD was fixed.
6662
6663 3.  New Features in Bash
6664
6665 a.  The command timing code now uses the value of the TIMEFORMAT variable
6666     to format and display timing statistics.
6667
6668 b.  The `time' reserved word now accepts a `-p' option to force the
6669     POSIX.2 output format.
6670
6671 c.  There are a couple of new and updated scripts to convert csh startup
6672     files to bash format.
6673
6674 d.  There is a new builtin array variable: BASH_VERSINFO.  The various
6675     members hold the parts of the version information in BASH_VERSION,
6676     plus the value of MACHTYPE.
6677
6678 4.  New Features in Readline
6679
6680 a.  Setting LANG to `en_US.ISO8859-1' now causes readline to enter
6681     eight-bit mode.
6682
6683 ------------------------------------------------------------------------------
6684 This document details the changes between this version, bash-2.0-alpha4,
6685 and the previous version, bash-2.0-alpha3.
6686
6687 1.  Changes to Bash
6688
6689 a.  There is better detection of rsh connections on Solaris 2.
6690
6691 b.  Assignments to read-only variables preceding a command name are now
6692     variable assignment errors.  Variable assignment errors cause
6693     non-interactive shells running in posix mode to exit.
6694
6695 c.  The word tokenizer was rewritten to handle nested quotes and pairs
6696     ('', "", ``, ${...}, $(...), $[...], $'...', $"...", <(...), >(...))
6697     correctly.  Some of the parameter expansion code was updated as a
6698     consequence.
6699
6700 d.  A fix was made to `test' when given three arguments so that a binary
6701     operator is checked for first, before checking that the first argument
6702     is `!'.
6703
6704 e.  2''>/dev/null is no longer equivalent to 2>/dev/null.
6705
6706 f.  Parser error messages were regularized, and in most cases the name of
6707     the shell script being read by a non-interactive shell is not printed
6708     twice.
6709
6710 g.  A fix was made to the completion code so that it no longer removes the
6711     text the user typed in some cases.
6712
6713 h.  The special glibc `getopt' environment variable is no longer put into
6714     the environment on machines with small values of ARG_MAX.
6715
6716 i.  The expansion of ${...} now follows the POSIX.2 rules for finding the
6717     closing `}'.
6718
6719 j.  The shell no longer displays spurious status messages for background
6720     jobs in shell scripts that complete successfully when the script is
6721     run from a terminal.
6722
6723 k.  `shopt -o' now correctly updates $SHELLOPTS.
6724
6725 l.  A bug that caused the $PATH searching code to return a non-executable
6726     file even when an executable file with the same name appeared later in
6727     $PATH was fixed.
6728
6729 m.  The shell now does tilde expansions on unquoted `:~' in assignment
6730     statements when not in posix mode.
6731
6732 n.  Variable assignment errors when a command consists only of assignments
6733     now cause non-interactive shells to exit when in posix mode.
6734
6735 o.  If the variable in a `for' or `select' command is read-only, or not a
6736     legal shell identifier, a variable assignment error occurs.
6737
6738 p.  `test' now handles `-a' and `-o' as binary operators when three arguments
6739     are supplied, and correctly parses `( word )' as equivalent to `word'.
6740
6741 q.  `test' was fixed so that file names of the form /dev/fd/NN mean the same
6742     thing on all systems, even Linux.
6743
6744 r.  Fixed a bug in the globbing code that caused patterns with multiple
6745     consecutive `*'s to not be matched correctly.
6746
6747 s.  Fixed a bug that caused $PS2 to not be printed when an interactive shell
6748     not using readline is reading a here document.
6749
6750 t.  Fixed a bug that caused history expansion to be performed inappropriately
6751     when a single-quoted string spanned more than one line.
6752
6753 u.  `getopts' now checks that the variable name passed by the user as the
6754     second argument is a legal shell identifier and that the variable is
6755     not read-only.
6756
6757 v.  Fixed `getopts' to obey POSIX.2 rules for setting $OPTIND when it
6758     encounters an error.
6759
6760 w.  Fixed `set' to display variable values in a form that can be re-read.
6761
6762 x.  Fixed a bug in the code that keeps track of whether or not local variables
6763     have been declared at the current level of function nesting.
6764
6765 y.  Non-interactive shells in posix mode now exit if the name in a function
6766     declaration is not a legal identifier.
6767
6768 z.  The job control code now ignores stopped children when the shell is not
6769     interactive.
6770
6771 aa. The `cd' builtin no longer attempts spelling correction on the directory
6772     name if the shell is not interactive, regardless of the setting of the
6773     `cdspell' option.
6774
6775 bb. Some OS-specific changes were made for SCO 3.2v[45] and AIX 4.2.
6776
6777 cc. `time' now prints its output to stderr, as POSIX.2 specifies.
6778
6779 2.  Fixes to Readline
6780
6781 a.  After printing possible completions, all lines of a multi-line prompt
6782     are redisplayed.
6783
6784 b.  Some changes were made to the terminal handling code in rltty.c to
6785     work around AIX 4.2 bugs.
6786
6787 3.  New Features in Bash
6788
6789 a.  There is a new loadable builtin: sprintf, with calling syntax
6790                 sprintf var format [args]
6791     This provides an easy way to simulate ksh left- and right-justified
6792     variable values.
6793
6794 b.  The expansions of \h and \H in prompt strings were swapped.  \h now
6795     expands to the hostname up to the first `.', as in bash-1.14.
6796
6797 4.  New Features in Readline
6798
6799 a.  The bash-1.14 behavior when ^M is typed while doing an incremental
6800     search was restored.  ^J may now be used to terminate the search without
6801     accepting the line.
6802
6803 b.  There is a new bindable variable: disable-completion.  This inhibits
6804     word completion and causes the completion character to be inserted as
6805     if it had been bound to self-insert.
6806
6807 ------------------------------------------------------------------------------
6808 This document details the changes between this version, bash-2.0-alpha3,
6809 and the previous version, bash-2.0-alpha2.
6810
6811 There is now a file `COMPAT' included in the distribution that lists the
6812 user-visible incompatibilities between 1.14 and 2.0.
6813
6814 1. Changes to Bash
6815
6816 a. Some work was done so that word splitting of the rhs of assignment
6817    statements conforms more closely to historical practice.
6818
6819 b. A couple of errant memory frees were fixed.
6820
6821 c. A fix was made to the test builtin so it recognizes `<' and `>' as
6822    binary operators.
6823
6824 d. The GNU malloc in lib/malloc/malloc.c now scrambles memory as it's
6825    allocated and freed.  This is to catch callers that refer to freed
6826    memory or assume something about newly-allocated memory.
6827
6828 e. Fixed a problem with conversion to 12-hour time in the prompt
6829    expansion code.
6830
6831 f. Fixed a problem with configure's argument parsing order.  Now you can
6832    correctly turn on specific options after using --enable-minimal-config.
6833
6834 g. The configure script now automatically disables the use of GNU malloc
6835    on systems where it's appropriate (better than having people read the
6836    NOTES file and do it manually).
6837
6838 h. There are new prompt expansions (\v and \V) to insert version information
6839    into the prompt strings.
6840
6841 i. The default prompt string now includes the version number.
6842
6843 j. Most of the builtins that take no options were changed to use the
6844    internal getopt so they can produce proper error messages for -?
6845    and incorrect options.
6846
6847 k. Some system-specific changes were made for SVR4.2 and Solaris 2.5.
6848
6849 l. Bash now uses PATH_MAX instead of MAXPATHLEN and NAME_MAX instead of
6850    MAXNAMLEN.
6851
6852 m. A couple of problems caused by uninitialized variables were fixed.
6853
6854 n. There are a number of new loadable builtin examples: logname, basename,
6855    dirname, tty, pathchk, tee, head, and rmdir.  All of these conform to
6856    POSIX.2.
6857
6858 o. Bash now notices changes in TZ and calls tzset() if present, so
6859    changing TZ will alter the time printed by prompt expansions.
6860
6861 p. The source was reorganized a bit so I don't have to wait so long for
6862    some files to compile, and to facilitate the creation of a `shell
6863    library' at some future point.
6864
6865 q. Bash no longer turns off job control if called as `sh', since the
6866    POSIX.2 spec includes job control as a standard feature.
6867
6868 r. `bash -o posix' now works as intended.
6869
6870 s. Fixed a problem with the completion code: when completing a filename
6871    that contained globbing characters, if show-all-if-ambiguous was set,
6872    the completion code would remove the user's text.
6873
6874 t. Fixed ulimit so that (hopefully) the full range of limits is available
6875    on HPUX systems.
6876
6877 u. A new `shopt' option (`hostcomplete') enables and disables hostname
6878    completion.
6879
6880 v. The shell no longer attempts to save the history on an abort(),
6881    which is usually called by programming_error().
6882
6883 w. The `-s' option to `fc' was changed to echo the command to be executed
6884    to stderr instead of stdout.
6885
6886 x. If the editor invoked by `fc -e' exits with a non-zero status, no
6887    commands are executed.
6888
6889 y. Fixed a bug that made the shopt `histverify' option work incorrectly.
6890
6891 z. There is a new variable `MACHTYPE' whose value is the GNU-style
6892    `cpu-company-system' system description as set by configure.  (The
6893    values of MACHTYPE and HOSTTYPE should really be swapped.)
6894
6895 aa. The `ulimit' builtin now allows the maximum virtual memory size to be
6896     set via setrlimit(2) if RLIMIT_VMEM is defined.
6897
6898 bb. `bash -nc 'command'' no longer runs `command'.
6899
6900 2. Changes to Readline
6901
6902 a. Fixed a typo in the code that checked for FIONREAD in input.c.
6903
6904 b. Fixed a bug in the code that outputs keybindings, so things like C-\
6905    are quoted properly.
6906
6907 c. Fixed a bug in the inputrc file parsing code to handle the problems
6908    caused by inputrc files created from the output of `bind -p' in
6909    previous versions of bash.  The problem was due to the bug fixed
6910    in item b above.
6911
6912 d. Readline no longer turns off the terminal's meta key, and turns it on
6913    once the first time it's called.
6914
6915 ------------------------------------------------------------------------------
6916 This file documents the changes between this version, bash-2.0-alpha2,
6917 and the previous version, bash-2.0-alpha.
6918
6919 1. Changes to Bash
6920
6921 a. The shell no longer thinks directories are executable.
6922
6923 b. `disown' has a new option, `h', which inhibits the resending of SIGHUP
6924    but does not remove the job from the jobs table.
6925
6926 c. The varargs functions in error.c now use ANSI-C `stdarg' if available.
6927
6928 d. The build process now treats the `build version' in .build as local to
6929    the build directory, so different versions built from the same source
6930    tree have different `build versions'.
6931
6932 e. Some problems with the grammar have been fixed. (It used `list' in a few
6933    productions where `compound_list' was needed.  A `list' must be terminated
6934    with a newline or semicolon; a `compound_list' need not be.)
6935
6936 f. A fix was made to keep `wait' from hanging when waiting for all background
6937    jobs.
6938
6939 g. `bash --help' now writes its output to stdout, like the GNU Coding Standards
6940    specify, and includes the machine type (the value of MACHTYPE).
6941
6942 h. `bash --version' now prints more information and exits successfully, like
6943    the GNU Coding Standards specify.
6944
6945 i. The output of `time' and `times' now prints fractional seconds with three
6946    places after the decimal point.
6947
6948 j. A bug that caused process substitutions to screw up the pipeline printed
6949    by `jobs' was fixed.
6950
6951 k. Fixes were made to the code that implements $'...' and $"..." so they
6952    work as documented.
6953
6954 l. The process substitution code now opens named pipes for reading with
6955    O_NONBLOCK to avoid hanging.
6956
6957 m. Fixes were made to the trap code so the shell cleans up correctly if the
6958    trap command contains a `return' and we're executing a function or
6959    sourcing a script with `.'.
6960
6961 n. Fixes to doc/Makefile.in so that it doesn't try to remake all of the
6962    documentation (ps, dvi, etc.) on a `make install'.
6963
6964 o. Fixed an auto-increment error that caused bash -c args to sometimes dump
6965    core.
6966
6967 p. Fixed a bug that caused $HISTIGNORE to fail when the history line
6968    contained globbing characters.
6969
6970 2. Changes to Readline
6971
6972 a. There is a new string variable, rl_library_version, available for use by
6973    applications.  The current value is "2.1".
6974
6975 b. A bug encountered when expand-tilde was enabled and file completion was
6976    attempted on a word beginning with `~/' was fixed.
6977
6978 c. A slight change was made to the incremental search termination behavior.
6979    ESC still terminates the search, but if input is pending or arrives
6980    within 0.1 seconds (on systems with select(2)), it is used as a prefix
6981    character.  This is intented to allow users to terminate searches with
6982    the arrow keys and get the behavior they expect.