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