commit bash-20050225 snapshot

CWRU/CWRU.chlog

@@ -11114,3 +11114,44 @@ builtins/shopt.def
 doc/{bashref.texi,bash.1}
 	- updated descriptions of [[ and case to include reference to
 	  nocasematch option
+
+				   2/22
+				   ----
+builtins/mkbuiltins.c
+	- add `times' to the list of posix special builtins
+
+				   2/23
+				   ----
+builtins/cd.def
+	- posix mode no longer turns on effect of -P option on $PWD if a
+	  directory is chosen from CDPATH
+
+doc/bashref.texi
+	- clarified that in posix mode, reserved words are not alias expanded
+	  only in a reserved word context
+	- removed item about cd, $CDPATH, and -P from posix mode section
+
+				   2/24
+				   ----
+builtins/reserved.def
+	- minor cleanups to the description of `if'
+
+				    3/2
+				    ---
+subst.c
+	- change list_string and get_word_from_string to explicitly treat an
+	  IFS character that is not space, tab, or newline *and any adjacent
+	  IFS white space* as a single delimiter, as SUSv3/XPG6 says
+
+builtins/read.def
+	- check whether or not the number of fields is exactly the same as
+	  the number of variables instead of just assigning the rest of the
+	  line (minus any trailing IFS white space) to the last variable.
+	  This parses a field and checks whether or not it consumes all of
+	  the input (including any trailing field delimiters), falling back
+	  to the previous behavior if it does not.  This is what POSIX.2
+	  specifies, I believe (and the consensus of the austin-group list).
+	  This requires a few tests in read.tests to be changed: backslashes
+	  escaping IFS whitespace characters at the end of input cause the
+	  whitespace characters to be preserved in the value assigned to the
+	  variable, and the trailing non-whitespace field delimiter issue

CWRU/CWRU.chlog~

@@ -11110,3 +11110,46 @@ builtins/shopt.def
 	- new settable option, `nocasematch', controls the match_ignore_case
 	  variable.  Currently alters pattern matching for case and [[ ... ]]
 	  commands (==, !=, and =~ operators)
+
+doc/{bashref.texi,bash.1}
+	- updated descriptions of [[ and case to include reference to
+	  nocasematch option
+
+				   2/22
+				   ----
+builtins/mkbuiltins.c
+	- add `times' to the list of posix special builtins
+
+				   2/23
+				   ----
+builtins/cd.def
+	- posix mode no longer turns on effect of -P option on $PWD if a
+	  directory is chosen from CDPATH
+
+doc/bashref.texi
+	- clarified that in posix mode, reserved words are not alias expanded
+	  only in a reserved word context
+	- removed item about cd, $CDPATH, and -P from posix mode section
+
+				   2/24
+				   ----
+builtins/reserved.def
+	- minor cleanups to the description of `if'
+
+				    3/2
+				    ---
+subst.c
+	- change list_string and get_word_from_string to explicitly treat an
+	  IFS character that is not space, tab, or newline *and any adjacent
+	  IFS white space* as a single delimiter, as SUSv3/XPG6 says
+
+builtins/read.def
+	- check whether or not the number of fields is exactly the same as
+	  the number of variables instead of just assigning the rest of the
+	  line (minus any trailing IFS white space) to the last variable.
+	  This parses a field and checks whether or not it consumes all of
+	  the input (including any trailing field delimiters), falling back
+	  to the previous behavior if it does not.  This is what POSIX.2
+	  specifies, I believe (and the consensus of the austin-group list).
+	  This requires a few tests in read.tests to be changed
+

builtins/cd.def

@@ -246,9 +246,13 @@ cd_builtin (list)
 		printf ("%s\n", path);
 
 	      free (temp);
+#if 0
 	      /* Posix.2 says that after using CDPATH, the resultant
 		 value of $PWD will not contain `.' or `..'. */
 	      return (bindpwd (posixly_correct || no_symlinks));
+#else
+	      return (bindpwd (no_symlinks));
+#endif
 	    }
 	  else
 	    free (temp);

builtins/mkbuiltins.c

@@ -134,7 +134,7 @@ ARRAY *saved_builtins = (ARRAY *)NULL;
 char *special_builtins[] =
 {
   ":", ".", "source", "break", "continue", "eval", "exec", "exit",
-  "export", "readonly", "return", "set", "shift", "trap", "unset",
+  "export", "readonly", "return", "set", "shift", "times", "trap", "unset",
   (char *)NULL
 };
 

builtins/read.def

@@ -1,7 +1,7 @@
 This file is read.def, from which is created read.c.
 It implements the builtin "read" in Bash.
 
-Copyright (C) 1987-2004 Free Software Foundation, Inc.
+Copyright (C) 1987-2005 Free Software Foundation, Inc.
 
 This file is part of GNU Bash, the Bourne Again SHell.
 
@@ -627,10 +627,24 @@ read_builtin (list)
       return (EXECUTION_FAILURE);
     }
 
+#if 0
   /* This has to be done this way rather than using string_list
      and list_string because Posix.2 says that the last variable gets the
      remaining words and their intervening separators. */
   input_string = strip_trailing_ifs_whitespace (input_string, ifs_chars, saw_escape);
+#else
+  /* Check whether or not the number of fields is exactly the same as the
+     number of variables. */
+  if (*input_string)
+    {
+      t1 = input_string;
+      t = get_word_from_string (&input_string, ifs_chars, &e);
+      if (*input_string == 0)
+	input_string = t;
+      else
+	input_string = strip_trailing_ifs_whitespace (t1, ifs_chars, saw_escape);
+    }
+#endif
 
   if (saw_escape)
     {

builtins/read.def.save1

@@ -0,0 +1,736 @@
+This file is read.def, from which is created read.c.
+It implements the builtin "read" in Bash.
+
+Copyright (C) 1987-2004 Free Software Foundation, Inc.
+
+This file is part of GNU Bash, the Bourne Again SHell.
+
+Bash is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free
+Software Foundation; either version 2, or (at your option) any later
+version.
+
+Bash is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+for more details.
+
+You should have received a copy of the GNU General Public License along
+with Bash; see the file COPYING.  If not, write to the Free Software
+Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
+
+$PRODUCES read.c
+
+$BUILTIN read
+$FUNCTION read_builtin
+$SHORT_DOC read [-ers] [-u fd] [-t timeout] [-p prompt] [-a array] [-n nchars] [-d delim] [name ...]
+One line is read from the standard input, or from file descriptor FD if the
+-u option is supplied, and the first word is assigned to the first NAME,
+the second word to the second NAME, and so on, with leftover words assigned
+to the last NAME.  Only the characters found in $IFS are recognized as word
+delimiters.  If no NAMEs are supplied, the line read is stored in the REPLY
+variable.  If the -r option is given, this signifies `raw' input, and
+backslash escaping is disabled.  The -d option causes read to continue
+until the first character of DELIM is read, rather than newline.  If the -p
+option is supplied, the string PROMPT is output without a trailing newline
+before attempting to read.  If -a is supplied, the words read are assigned
+to sequential indices of ARRAY, starting at zero.  If -e is supplied and
+the shell is interactive, readline is used to obtain the line.  If -n is
+supplied with a non-zero NCHARS argument, read returns after NCHARS
+characters have been read.  The -s option causes input coming from a
+terminal to not be echoed.
+
+The -t option causes read to time out and return failure if a complete line
+of input is not read within TIMEOUT seconds.  If the TMOUT variable is set,
+its value is the default timeout.  The return code is zero, unless end-of-file
+is encountered, read times out, or an invalid file descriptor is supplied as
+the argument to -u.
+$END
+
+#include <config.h>
+
+#include "bashtypes.h"
+#include "posixstat.h"
+
+#include <stdio.h>
+
+#if defined (HAVE_UNISTD_H)
+#  include <unistd.h>
+#endif
+
+#include <signal.h>
+#include <errno.h>
+
+#ifdef __CYGWIN__
+#  include <fcntl.h>
+#  include <io.h>
+#endif
+
+#include "../bashintl.h"
+
+#include "../shell.h"
+#include "common.h"
+#include "bashgetopt.h"
+
+#include <shtty.h>
+
+#if defined (READLINE)
+#include "../bashline.h"
+#include <readline/readline.h>
+#endif
+
+#if !defined(errno)
+extern int errno;
+#endif
+
+extern int interrupt_immediately;
+
+#if defined (READLINE)
+static char *edit_line __P((char *));
+static void set_eol_delim __P((int));
+static void reset_eol_delim __P((char *));
+#endif
+static SHELL_VAR *bind_read_variable __P((char *, char *));
+
+static sighandler sigalrm __P((int));
+static void reset_alarm __P((void));
+
+static procenv_t alrmbuf;
+static SigHandler *old_alrm;
+static unsigned char delim;
+
+static sighandler
+sigalrm (s)
+     int s;
+{
+  longjmp (alrmbuf, 1);
+}
+
+static void
+reset_alarm ()
+{
+  set_signal_handler (SIGALRM, old_alrm);
+  alarm (0);
+}
+
+/* Read the value of the shell variables whose names follow.
+   The reading is done from the current input stream, whatever
+   that may be.  Successive words of the input line are assigned
+   to the variables mentioned in LIST.  The last variable in LIST
+   gets the remainder of the words on the line.  If no variables
+   are mentioned in LIST, then the default variable is $REPLY. */
+int
+read_builtin (list)
+     WORD_LIST *list;
+{
+  register char *varname;
+  int size, i, pass_next, saw_escape, eof, opt, retval, code;
+  int input_is_tty, input_is_pipe, unbuffered_read;
+  int raw, edit, nchars, silent, have_timeout, fd;
+  unsigned int tmout;
+  intmax_t intval;
+  char c;
+  char *input_string, *orig_input_string, *ifs_chars, *prompt, *arrayname;
+  char *e, *t, *t1;
+  struct stat tsb;
+  SHELL_VAR *var;
+#if defined (ARRAY_VARS)
+  WORD_LIST *alist;
+#endif
+#if defined (READLINE)
+  char *rlbuf;
+  int rlind;
+#endif
+
+  USE_VAR(size);
+  USE_VAR(i);
+  USE_VAR(pass_next);
+  USE_VAR(saw_escape);
+  USE_VAR(input_is_pipe);
+/*  USE_VAR(raw); */
+  USE_VAR(edit);
+  USE_VAR(tmout);
+  USE_VAR(nchars);
+  USE_VAR(silent);
+  USE_VAR(ifs_chars);
+  USE_VAR(prompt);
+  USE_VAR(arrayname);
+#if defined (READLINE)
+  USE_VAR(rlbuf);
+  USE_VAR(rlind);
+#endif
+  USE_VAR(list);
+
+  i = 0;		/* Index into the string that we are reading. */
+  raw = edit = 0;	/* Not reading raw input by default. */
+  silent = 0;
+  arrayname = prompt = (char *)NULL;
+  fd = 0;		/* file descriptor to read from */
+
+#if defined (READLINE)
+  rlbuf = (char *)0;
+  rlind = 0;
+#endif
+
+  tmout = 0;		/* no timeout */
+  nchars = input_is_tty = input_is_pipe = unbuffered_read = have_timeout = 0;
+  delim = '\n';		/* read until newline */
+
+  reset_internal_getopt ();
+  while ((opt = internal_getopt (list, "ersa:d:n:p:t:u:")) != -1)
+    {
+      switch (opt)
+	{
+	case 'r':
+	  raw = 1;
+	  break;
+	case 'p':
+	  prompt = list_optarg;
+	  break;
+	case 's':
+	  silent = 1;
+	  break;
+	case 'e':
+#if defined (READLINE)
+	  edit = 1;
+#endif
+	  break;
+#if defined (ARRAY_VARS)
+	case 'a':
+	  arrayname = list_optarg;
+	  break;
+#endif
+	case 't':
+	  code = legal_number (list_optarg, &intval);
+	  if (code == 0 || intval < 0 || intval != (unsigned int)intval)
+	    {
+	      builtin_error (_("%s: invalid timeout specification"), list_optarg);
+	      return (EXECUTION_FAILURE);
+	    }
+	  else
+	    {
+	      have_timeout = 1;
+	      tmout = intval;
+	    }
+	  break;
+	case 'n':
+	  code = legal_number (list_optarg, &intval);
+	  if (code == 0 || intval < 0 || intval != (int)intval)
+	    {
+	      sh_invalidnum (list_optarg);
+	      return (EXECUTION_FAILURE);
+	    }
+	  else
+	    nchars = intval;
+	  break;
+	case 'u':
+	  code = legal_number (list_optarg, &intval);
+	  if (code == 0 || intval < 0 || intval != (int)intval)
+	    {
+	      builtin_error (_("%s: invalid file descriptor specification"), list_optarg);
+	      return (EXECUTION_FAILURE);
+	    }
+	  else
+	    fd = intval;
+	  if (sh_validfd (fd) == 0)
+	    {
+	      builtin_error (_("%d: invalid file descriptor: %s"), fd, strerror (errno));
+	      return (EXECUTION_FAILURE);
+	    }
+	  break;
+	case 'd':
+	  delim = *list_optarg;
+	  break;
+	default:
+	  builtin_usage ();
+	  return (EX_USAGE);
+	}
+    }
+  list = loptend;
+
+  /* `read -t 0 var' returns failure immediately.  XXX - should it test
+     whether input is available with select/FIONREAD, and fail if those
+     are unavailable? */
+  if (have_timeout && tmout == 0)
+    return (EXECUTION_FAILURE);
+
+  /* IF IFS is unset, we use the default of " \t\n". */
+  ifs_chars = getifs ();
+  if (ifs_chars == 0)		/* XXX - shouldn't happen */
+    ifs_chars = "";
+
+  input_string = (char *)xmalloc (size = 112);	/* XXX was 128 */
+
+  /* $TMOUT, if set, is the default timeout for read. */
+  if (have_timeout == 0 && (e = get_string_value ("TMOUT")))
+    {
+      code = legal_number (e, &intval);
+      if (code == 0 || intval < 0 || intval != (unsigned int)intval)
+	tmout = 0;
+      else
+	tmout = intval;
+    }
+
+  begin_unwind_frame ("read_builtin");
+
+  input_is_tty = isatty (fd);
+  if (input_is_tty == 0)
+#ifndef __CYGWIN__
+    input_is_pipe = (lseek (0, 0L, SEEK_CUR) < 0) && (errno == ESPIPE);
+#else
+    input_is_pipe = 1;
+#endif
+
+  /* If the -p, -e or -s flags were given, but input is not coming from the
+     terminal, turn them off. */
+  if ((prompt || edit || silent) && input_is_tty == 0)
+    {
+      prompt = (char *)NULL;
+      edit = silent = 0;
+    }
+
+#if defined (READLINE)
+  if (edit)
+    add_unwind_protect (xfree, rlbuf);
+#endif
+
+  if (prompt && edit == 0)
+    {
+      fprintf (stderr, "%s", prompt);
+      fflush (stderr);
+    }
+
+  pass_next = 0;	/* Non-zero signifies last char was backslash. */
+  saw_escape = 0;	/* Non-zero signifies that we saw an escape char */
+
+  if (tmout > 0)
+    {
+      /* Turn off the timeout if stdin is a regular file (e.g. from
+	 input redirection). */
+      if ((fstat (fd, &tsb) < 0) || S_ISREG (tsb.st_mode))
+	tmout = 0;
+    }
+
+  if (tmout > 0)
+    {
+      code = setjmp (alrmbuf);
+      if (code)
+	{
+	  run_unwind_frame ("read_builtin");
+	  return (EXECUTION_FAILURE);
+	}
+      old_alrm = set_signal_handler (SIGALRM, sigalrm);
+      add_unwind_protect (reset_alarm, (char *)NULL);
+      alarm (tmout);
+    }
+
+  /* If we've been asked to read only NCHARS chars, or we're using some
+     character other than newline to terminate the line, do the right
+     thing to readline or the tty. */
+  if (nchars > 0 || delim != '\n')
+    {
+#if defined (READLINE)
+      if (edit)
+	{
+	  if (nchars > 0)
+	    {
+	      unwind_protect_int (rl_num_chars_to_read);
+	      rl_num_chars_to_read = nchars;
+	    }
+	  if (delim != '\n')
+	    {
+	      set_eol_delim (delim);
+	      add_unwind_protect (reset_eol_delim, (char *)NULL);
+	    }
+	}
+      else
+#endif
+      if (input_is_tty)
+	{
+	  ttsave ();
+	  if (silent)
+	    ttcbreak ();
+	  else
+	    ttonechar ();
+	  add_unwind_protect ((Function *)ttrestore, (char *)NULL);
+	}
+    }
+  else if (silent)	/* turn off echo but leave term in canonical mode */
+    {
+      ttsave ();
+      ttnoecho ();
+      add_unwind_protect ((Function *)ttrestore, (char *)NULL);
+    }
+
+  /* This *must* be the top unwind-protect on the stack, so the manipulation
+     of the unwind-protect stack after the realloc() works right. */
+  add_unwind_protect (xfree, input_string);
+  interrupt_immediately++;
+
+  unbuffered_read = (nchars > 0) || (delim != '\n') || input_is_pipe;
+
+#if defined (__CYGWIN__) && defined (O_TEXT)
+  setmode (0, O_TEXT);
+#endif
+
+  for (eof = retval = 0;;)
+    {
+#if defined (READLINE)
+      if (edit)
+	{
+	  if (rlbuf && rlbuf[rlind] == '\0')
+	    {
+	      xfree (rlbuf);
+	      rlbuf = (char *)0;
+	    }
+	  if (rlbuf == 0)
+	    {
+	      rlbuf = edit_line (prompt ? prompt : "");
+	      rlind = 0;
+	    }
+	  if (rlbuf == 0)
+	    {
+	      eof = 1;
+	      break;
+	    }
+	  c = rlbuf[rlind++];
+	}
+      else
+	{
+#endif
+
+      if (unbuffered_read)
+	retval = zread (fd, &c, 1);
+      else
+	retval = zreadc (fd, &c);
+
+      if (retval <= 0)
+	{
+	  eof = 1;
+	  break;
+	}
+
+#if defined (READLINE)
+	}
+#endif
+
+      if (i + 2 >= size)
+	{
+	  input_string = (char *)xrealloc (input_string, size += 128);
+	  remove_unwind_protect ();
+	  add_unwind_protect (xfree, input_string);
+	}
+
+      /* If the next character is to be accepted verbatim, a backslash
+	 newline pair still disappears from the input. */
+      if (pass_next)
+	{
+	  if (c == '\n')
+	    i--;		/* back up over the CTLESC */
+	  else
+	    input_string[i++] = c;
+	  pass_next = 0;
+	  continue;
+	}
+
+      if (c == '\\' && raw == 0)
+	{
+	  pass_next++;
+	  saw_escape++;
+	  input_string[i++] = CTLESC;
+	  continue;
+	}
+
+      if ((unsigned char)c == delim)
+	break;
+
+      if (c == CTLESC || c == CTLNUL)
+	{
+	  saw_escape++;
+	  input_string[i++] = CTLESC;
+	}
+
+      input_string[i++] = c;
+
+      if (nchars > 0 && i >= nchars)
+	break;
+    }
+  input_string[i] = '\0';
+
+#if 1
+  if (retval < 0)
+    {
+      builtin_error (_("read error: %d: %s"), fd, strerror (errno));
+      return (EXECUTION_FAILURE);
+    }
+#endif
+
+  if (tmout > 0)
+    reset_alarm ();
+
+  if (nchars > 0 || delim != '\n')
+    {
+#if defined (READLINE)
+      if (edit)
+	{
+	  if (nchars > 0)
+	    rl_num_chars_to_read = 0;
+	  if (delim != '\n')
+	    reset_eol_delim ((char *)NULL);
+	}
+      else
+#endif
+      if (input_is_tty)
+	ttrestore ();
+    }
+  else if (silent)
+    ttrestore ();
+
+  if (unbuffered_read == 0)
+    zsyncfd (fd);
+
+  interrupt_immediately--;
+  discard_unwind_frame ("read_builtin");
+
+  retval = eof ? EXECUTION_FAILURE : EXECUTION_SUCCESS;
+
+#if defined (ARRAY_VARS)
+  /* If -a was given, take the string read, break it into a list of words,
+     an assign them to `arrayname' in turn. */
+  if (arrayname)
+    {
+      if (legal_identifier (arrayname) == 0)
+	{
+	  sh_invalidid (arrayname);
+	  xfree (input_string);
+	  return (EXECUTION_FAILURE);
+	}
+
+      var = find_or_make_array_variable (arrayname, 1);
+      if (var == 0)
+	return EXECUTION_FAILURE;	/* readonly or noassign */
+      array_flush (array_cell (var));
+
+      alist = list_string (input_string, ifs_chars, 0);
+      if (alist)
+	{
+	  word_list_remove_quoted_nulls (alist);
+	  assign_array_var_from_word_list (var, alist, 0);
+	  dispose_words (alist);
+	}
+      xfree (input_string);
+      return (retval);
+    }
+#endif /* ARRAY_VARS */ 
+
+  /* If there are no variables, save the text of the line read to the
+     variable $REPLY.  ksh93 strips leading and trailing IFS whitespace,
+     so that `read x ; echo "$x"' and `read ; echo "$REPLY"' behave the
+     same way, but I believe that the difference in behaviors is useful
+     enough to not do it.  Without the bash behavior, there is no way
+     to read a line completely without interpretation or modification
+     unless you mess with $IFS (e.g., setting it to the empty string).
+     If you disagree, change the occurrences of `#if 0' to `#if 1' below. */
+  if (list == 0)
+    {
+#if 0
+      orig_input_string = input_string;
+      for (t = input_string; ifs_chars && *ifs_chars && spctabnl(*t) && isifs(*t); t++)
+	;
+      input_string = t;
+      input_string = strip_trailing_ifs_whitespace (input_string, ifs_chars, saw_escape);
+#endif
+
+      if (saw_escape)
+	{
+	  t = dequote_string (input_string);
+	  var = bind_variable ("REPLY", t, 0);
+	  free (t);
+	}
+      else
+	var = bind_variable ("REPLY", input_string, 0);
+      VUNSETATTR (var, att_invisible);
+
+      free (input_string);
+      return (retval);
+    }
+
+  /* This code implements the Posix.2 spec for splitting the words
+     read and assigning them to variables. */
+  orig_input_string = input_string;
+
+  /* Remove IFS white space at the beginning of the input string.  If
+     $IFS is null, no field splitting is performed. */
+  for (t = input_string; ifs_chars && *ifs_chars && spctabnl(*t) && isifs(*t); t++)
+    ;
+  input_string = t;
+
+  for (; list->next; list = list->next)
+    {
+      varname = list->word->word;
+#if defined (ARRAY_VARS)
+      if (legal_identifier (varname) == 0 && valid_array_reference (varname) == 0)
+#else
+      if (legal_identifier (varname) == 0)
+#endif
+	{
+	  sh_invalidid (varname);
+	  xfree (orig_input_string);
+	  return (EXECUTION_FAILURE);
+	}
+
+      /* If there are more variables than words read from the input,
+	 the remaining variables are set to the empty string. */
+      if (*input_string)
+	{
+	  /* This call updates INPUT_STRING. */
+	  t = get_word_from_string (&input_string, ifs_chars, &e);
+	  if (t)
+	    *e = '\0';
+	  /* Don't bother to remove the CTLESC unless we added one
+	     somewhere while reading the string. */
+	  if (t && saw_escape)
+	    {
+	      t1 = dequote_string (t);
+	      var = bind_read_variable (varname, t1);
+	      xfree (t1);
+	    }
+	  else
+	    var = bind_read_variable (varname, t);
+	}
+      else
+	{
+	  t = (char *)0;
+	  var = bind_read_variable (varname, "");
+	}
+
+      FREE (t);
+      if (var == 0)
+	{
+	  xfree (orig_input_string);
+	  return (EXECUTION_FAILURE);
+	}
+
+      stupidly_hack_special_variables (varname);
+      VUNSETATTR (var, att_invisible);
+    }
+
+  /* Now assign the rest of the line to the last variable argument. */
+#if defined (ARRAY_VARS)
+  if (legal_identifier (list->word->word) == 0 && valid_array_reference (list->word->word) == 0)
+#else
+  if (legal_identifier (list->word->word) == 0)
+#endif
+    {
+      sh_invalidid (list->word->word);
+      xfree (orig_input_string);
+      return (EXECUTION_FAILURE);
+    }
+
+  /* This has to be done this way rather than using string_list
+     and list_string because Posix.2 says that the last variable gets the
+     remaining words and their intervening separators. */
+  input_string = strip_trailing_ifs_whitespace (input_string, ifs_chars, saw_escape);
+
+  if (saw_escape)
+    {
+      t = dequote_string (input_string);
+      var = bind_read_variable (list->word->word, t);
+      xfree (t);
+    }
+  else
+    var = bind_read_variable (list->word->word, input_string);
+  stupidly_hack_special_variables (list->word->word);
+  if (var)
+    VUNSETATTR (var, att_invisible);
+  xfree (orig_input_string);
+
+  return (retval);
+}
+
+static SHELL_VAR *
+bind_read_variable (name, value)
+     char *name, *value;
+{
+#if defined (ARRAY_VARS)
+  if (valid_array_reference (name) == 0)
+    return (bind_variable (name, value, 0));
+  else
+    return (assign_array_element (name, value, 0));
+#else /* !ARRAY_VARS */
+  return bind_variable (name, value, 0);
+#endif /* !ARRAY_VARS */
+}
+
+#if defined (READLINE)
+static rl_completion_func_t *old_attempted_completion_function;
+
+static char *
+edit_line (p)
+     char *p;
+{
+  char *ret;
+  int len;
+
+  if (!bash_readline_initialized)
+    initialize_readline ();
+  old_attempted_completion_function = rl_attempted_completion_function;
+  rl_attempted_completion_function = (rl_completion_func_t *)NULL;
+  ret = readline (p);
+  rl_attempted_completion_function = old_attempted_completion_function;
+  if (ret == 0)
+    return ret;
+  len = strlen (ret);
+  ret = (char *)xrealloc (ret, len + 2);
+  ret[len++] = delim;
+  ret[len] = '\0';
+  return ret;
+}
+
+static int old_delim_ctype;
+static rl_command_func_t *old_delim_func;
+static int old_newline_ctype;
+static rl_command_func_t *old_newline_func;
+
+static unsigned char delim_char;
+
+static void
+set_eol_delim (c)
+     int c;
+{
+  Keymap cmap;
+
+  if (bash_readline_initialized == 0)
+    initialize_readline ();
+  cmap = rl_get_keymap ();
+
+  /* Change newline to self-insert */
+  old_newline_ctype = cmap[RETURN].type;
+  old_newline_func =  cmap[RETURN].function;
+  cmap[RETURN].type = ISFUNC;
+  cmap[RETURN].function = rl_insert;
+
+  /* Bind the delimiter character to accept-line. */
+  old_delim_ctype = cmap[c].type;
+  old_delim_func = cmap[c].function;
+  cmap[c].type = ISFUNC;
+  cmap[c].function = rl_newline;
+
+  delim_char = c;
+}
+
+static void
+reset_eol_delim (cp)
+     char *cp;
+{
+  Keymap cmap;
+
+  cmap = rl_get_keymap ();
+
+  cmap[RETURN].type = old_newline_ctype;
+  cmap[RETURN].function = old_newline_func;
+
+  cmap[delim_char].type = old_delim_ctype;
+  cmap[delim_char].function = old_delim_func;
+}
+#endif

builtins/read.def~

@@ -1,7 +1,7 @@
 This file is read.def, from which is created read.c.
 It implements the builtin "read" in Bash.
 
-Copyright (C) 1987-2004 Free Software Foundation, Inc.
+Copyright (C) 1987-2005 Free Software Foundation, Inc.
 
 This file is part of GNU Bash, the Bourne Again SHell.
 
@@ -131,7 +131,7 @@ read_builtin (list)
   intmax_t intval;
   char c;
   char *input_string, *orig_input_string, *ifs_chars, *prompt, *arrayname;
-  char *e, *t, *t1;
+  char *e, *t, *t1, *savei;
   struct stat tsb;
   SHELL_VAR *var;
 #if defined (ARRAY_VARS)
@@ -544,11 +544,11 @@ read_builtin (list)
       if (saw_escape)
 	{
 	  t = dequote_string (input_string);
-	  var = bind_variable ("REPLY", t);
+	  var = bind_variable ("REPLY", t, 0);
 	  free (t);
 	}
       else
-	var = bind_variable ("REPLY", input_string);
+	var = bind_variable ("REPLY", input_string, 0);
       VUNSETATTR (var, att_invisible);
 
       free (input_string);
@@ -627,10 +627,24 @@ read_builtin (list)
       return (EXECUTION_FAILURE);
     }
 
+#if 0
   /* This has to be done this way rather than using string_list
      and list_string because Posix.2 says that the last variable gets the
      remaining words and their intervening separators. */
   input_string = strip_trailing_ifs_whitespace (input_string, ifs_chars, saw_escape);
+#else
+  /* Check whether or not the number of fields is exactly the same as the
+     number of variables. */
+  if (*input_string)
+    {
+      savei = input_string;
+      t = get_word_from_string (&input_string, ifs_chars, &e);
+      if (*input_string == 0)
+	input_string = t;
+      else
+	input_string = strip_trailing_ifs_whitespace (savei, ifs_chars, saw_escape);
+    }
+#endif
 
   if (saw_escape)
     {
@@ -654,11 +668,11 @@ bind_read_variable (name, value)
 {
 #if defined (ARRAY_VARS)
   if (valid_array_reference (name) == 0)
-    return (bind_variable (name, value));
+    return (bind_variable (name, value, 0));
   else
     return (assign_array_element (name, value, 0));
 #else /* !ARRAY_VARS */
-  return bind_variable (name, value);
+  return bind_variable (name, value, 0);
 #endif /* !ARRAY_VARS */
 }
 

builtins/readsave

@@ -0,0 +1,17 @@
+#else
+  /* This code implements the `rest of the fields and their intervening
+     separators' portion of the Posix spec.  The latest interpretation says
+     that the last non-IFS white space separator (and any adjacent IFS
+     white space) is removed.  We repeatedly parse fields, stopping when the
+     last results in us hitting the end of INPUT_STRING. */
+  savei = t = input_string;
+  while (*input_string)
+    {
+      /* This call updates INPUT_STRING. */
+      t1 = get_word_from_string (&input_string, ifs_chars, &e);
+      if (*input_string)
+	t = input_string;
+    }
+  *t = '\0';
+  input_string = savei;
+#endif

builtins/reserved.def

@@ -2,7 +2,7 @@ This file is reserved.def, in which the shell reserved words are defined.
 It has no direct C file production, but defines builtins for the Bash
 builtin help command.
 
-Copyright (C) 1987-2002 Free Software Foundation, Inc.
+Copyright (C) 1987-2005 Free Software Foundation, Inc.
 
 This file is part of GNU Bash, the Bourne Again SHell.
 
@@ -73,12 +73,13 @@ $END
 
 $BUILTIN if
 $SHORT_DOC if COMMANDS; then COMMANDS; [ elif COMMANDS; then COMMANDS; ]... [ else COMMANDS; ] fi
-The if COMMANDS are executed.  If the exit status is zero, then the then
-COMMANDS are executed.  Otherwise, each of the elif COMMANDS are executed
-in turn, and if the exit status is zero, the corresponding then COMMANDS
-are executed and the if command completes.  Otherwise, the else COMMANDS
-are executed, if present.  The exit status is the exit status of the last
-command executed, or zero if no condition tested true.
+The `if COMMANDS' list is executed.  If its exit status is zero, then the
+`then COMMANDS' list is executed.  Otherwise, each `elif COMMANDS' list is
+executed in turn, and if its exit status is zero, the corresponding
+`then COMMANDS' list is executed and the if command completes.  Otherwise,
+the `else COMMANDS' list is executed, if present.  The exit status of the
+entire construct is the exit status of the last command executed, or zero
+if no condition tested true.
 $END
 
 $BUILTIN while

doc/bash.html

@@ -2,7 +2,7 @@
 <TITLE>BASH(1) Manual Page</TITLE>
 </HEAD>
 <BODY><TABLE WIDTH=100%>
-<TH ALIGN=LEFT>BASH(1)<TH ALIGN=CENTER>2005 Feb 11<TH ALIGN=RIGHT>BASH(1)
+<TH ALIGN=LEFT>BASH(1)<TH ALIGN=CENTER>2005 Feb 19<TH ALIGN=RIGHT>BASH(1)
 </TABLE>
 <BR><A HREF="#index">Index</A>
 <HR>
@@ -182,13 +182,15 @@ single-character options to be recognized.
 
 <DD>
 Arrange for the debugger profile to be executed before the shell
-starts.  Turns on extended debugging mode (see the description of the
+starts.
+Turns on extended debugging mode (see the description of the
 <B>extdebug</B>
 
 option to the
 <B>shopt</B>
 
-builtin below) and shell function tracing (see the description of the
+builtin below)
+and shell function tracing (see the description of the
 <B>-o functrace</B> option to the
 <B>set</B>
 
@@ -885,6 +887,11 @@ as primaries.
 When the <B>==</B> and <B>!=</B> operators are used, the string to the
 right of the operator is considered a pattern and matched according
 to the rules described below under <B>Pattern Matching</B>.
+If the shell option
+<B>nocasematch</B>
+
+is enabled, the match is performed without regard to the case
+of alphabetic characters.
 The return value is 0 if the string matches or does not match
 the pattern, respectively, and 1 otherwise.
 Any part of the pattern may be quoted to force it to be matched as a
@@ -901,7 +908,7 @@ the pattern, and 1 otherwise.
 If the regular expression is syntactically incorrect, the conditional
 expression's return value is 2.
 If the shell option
-<B>nocaseglob</B>
+<B>nocasematch</B>
 
 is enabled, the match is performed without regard to the case
 of alphabetic characters.
@@ -1036,7 +1043,13 @@ it against each <I>pattern</I> in turn, using the same matching rules
 as for pathname expansion (see
 <B>Pathname Expansion</B>
 
-below).  When a match is found, the
+below).
+If the shell option
+<B>nocasematch</B>
+
+is enabled, the match is performed without regard to the case
+of alphabetic characters.
+When a match is found, the
 corresponding <I>list</I> is executed.  After the first match, no
 subsequent matches are attempted.  The exit status is zero if no
 pattern matches.  Otherwise, it is the exit status of the
@@ -1604,11 +1617,20 @@ Expands to the full file name used to invoke this instance of
 
 <DD>
 An array variable whose values are the number of parameters in each
-frame of the current bash execution call stack.  The number of
+frame of the current bash execution call stack.
+The number of
 parameters to the current subroutine (shell function or script executed
-with <B>.</B> or <B>source</B>) is at the top of the stack.  When a
-subroutine is executed, the number of parameters passed is pushed onto
+with <B>.</B> or <B>source</B>) is at the top of the stack.
+When a subroutine is executed, the number of parameters passed is pushed onto
 <B>BASH_ARGC</B>.
+The shell sets <B>BASH_ARGC</B> only when in extended debugging mode
+(see the description of the
+<B>extdebug</B>
+
+option to the
+<B>shopt</B>
+
+builtin below)
 <DT><B>BASH_ARGV</B>
 
 <DD>
@@ -1617,6 +1639,14 @@ execution call stack.  The final parameter of the last subroutine call
 is at the top of the stack; the first parameter of the initial call is
 at the bottom.  When a subroutine is executed, the parameters supplied
 are pushed onto <B>BASH_ARGV</B>.
+The shell sets <B>BASH_ARGV</B> only when in extended debugging mode
+(see the description of the
+<B>extdebug</B>
+
+option to the
+<B>shopt</B>
+
+builtin below)
 <DT><B>BASH_COMMAND</B>
 
 <DD>
@@ -10261,6 +10291,23 @@ If the command run by the <B>DEBUG</B> trap returns a value of 2, and the
 shell is executing in a subroutine (a shell function or a shell script
 executed by the <B>.</B> or <B>source</B> builtins), a call to
 <B>return</B> is simulated.
+<DT><B>4.</B>
+
+<DD>
+<B>BASH_ARGC</B> and <B>BASH_ARGV</B> are updated as described in their
+descriptions above.
+<DT><B>5.</B>
+
+<DD>
+Function tracing is enabled:  command substitution, shell functions, and
+subshells invoked with <B>(</B> <I>command</I> <B>)</B> inherit the
+<B>DEBUG</B> and <B>RETURN</B> traps.
+<DT><B>6.</B>
+
+<DD>
+Error tracing is enabled:  command substitution, shell functions, and
+subshells invoked with <B>(</B> <I>command</I> <B>)</B> inherit the
+<B>ERROR</B> trap.
 </DL></DL>
 
 <DT><B>extglob</B>
@@ -10400,6 +10447,14 @@ expansion (see
 <B>Pathname Expansion</B>
 
 above).
+<DT><B>nocasematch</B>
+
+<DD>
+If set,
+<B>bash</B>
+
+matches patterns in a case-insensitive fashion when performing matching
+while executing <B>case</B> or <B>[[</B> conditional commands.
 <DT><B>nullglob</B>
 
 <DD>
@@ -11429,6 +11484,6 @@ Array variables may not (yet) be exported.
 </DL>
 <HR>
 This document was created by man2html from bash.1.<BR>
-Time: 14 February 2005 11:56:43 EST
+Time: 22 February 2005 13:44:29 EST
 </BODY>
 </HTML>

doc/bashref.aux

@@ -65,7 +65,7 @@
 @xrdef{Command Grouping-pg}{13}
 @xrdef{Command Grouping-snt}{Section@tie 3.2.4.3}
 @xrdef{Shell Functions-title}{Shell Functions}
-@xrdef{Shell Functions-pg}{13}
+@xrdef{Shell Functions-pg}{14}
 @xrdef{Shell Functions-snt}{Section@tie 3.3}
 @xrdef{Shell Parameters-title}{Shell Parameters}
 @xrdef{Shell Parameters-pg}{15}
@@ -74,10 +74,10 @@
 @xrdef{Positional Parameters-pg}{15}
 @xrdef{Positional Parameters-snt}{Section@tie 3.4.1}
 @xrdef{Special Parameters-title}{Special Parameters}
-@xrdef{Special Parameters-pg}{15}
+@xrdef{Special Parameters-pg}{16}
 @xrdef{Special Parameters-snt}{Section@tie 3.4.2}
 @xrdef{Shell Expansions-title}{Shell Expansions}
-@xrdef{Shell Expansions-pg}{16}
+@xrdef{Shell Expansions-pg}{17}
 @xrdef{Shell Expansions-snt}{Section@tie 3.5}
 @xrdef{Brace Expansion-title}{Brace Expansion}
 @xrdef{Brace Expansion-pg}{17}
@@ -92,7 +92,7 @@
 @xrdef{Command Substitution-pg}{21}
 @xrdef{Command Substitution-snt}{Section@tie 3.5.4}
 @xrdef{Arithmetic Expansion-title}{Arithmetic Expansion}
-@xrdef{Arithmetic Expansion-pg}{21}
+@xrdef{Arithmetic Expansion-pg}{22}
 @xrdef{Arithmetic Expansion-snt}{Section@tie 3.5.5}
 @xrdef{Process Substitution-title}{Process Substitution}
 @xrdef{Process Substitution-pg}{22}
@@ -110,7 +110,7 @@
 @xrdef{Quote Removal-pg}{24}
 @xrdef{Quote Removal-snt}{Section@tie 3.5.9}
 @xrdef{Redirections-title}{Redirections}
-@xrdef{Redirections-pg}{24}
+@xrdef{Redirections-pg}{25}
 @xrdef{Redirections-snt}{Section@tie 3.6}
 @xrdef{Executing Commands-title}{Executing Commands}
 @xrdef{Executing Commands-pg}{28}
@@ -161,209 +161,209 @@
 @xrdef{Bash Variables-pg}{55}
 @xrdef{Bash Variables-snt}{Section@tie 5.2}
 @xrdef{Bash Features-title}{Bash Features}
-@xrdef{Bash Features-pg}{63}
+@xrdef{Bash Features-pg}{65}
 @xrdef{Bash Features-snt}{Chapter@tie 6}
 @xrdef{Invoking Bash-title}{Invoking Bash}
-@xrdef{Invoking Bash-pg}{63}
+@xrdef{Invoking Bash-pg}{65}
 @xrdef{Invoking Bash-snt}{Section@tie 6.1}
 @xrdef{Bash Startup Files-title}{Bash Startup Files}
-@xrdef{Bash Startup Files-pg}{65}
+@xrdef{Bash Startup Files-pg}{67}
 @xrdef{Bash Startup Files-snt}{Section@tie 6.2}
 @xrdef{Interactive Shells-title}{Interactive Shells}
-@xrdef{Interactive Shells-pg}{67}
+@xrdef{Interactive Shells-pg}{69}
 @xrdef{Interactive Shells-snt}{Section@tie 6.3}
 @xrdef{What is an Interactive Shell?-title}{What is an Interactive Shell?}
-@xrdef{What is an Interactive Shell?-pg}{67}
+@xrdef{What is an Interactive Shell?-pg}{69}
 @xrdef{What is an Interactive Shell?-snt}{Section@tie 6.3.1}
 @xrdef{Is this Shell Interactive?-title}{Is this Shell Interactive?}
-@xrdef{Is this Shell Interactive?-pg}{67}
+@xrdef{Is this Shell Interactive?-pg}{69}
 @xrdef{Is this Shell Interactive?-snt}{Section@tie 6.3.2}
 @xrdef{Interactive Shell Behavior-title}{Interactive Shell Behavior}
-@xrdef{Interactive Shell Behavior-pg}{67}
+@xrdef{Interactive Shell Behavior-pg}{69}
 @xrdef{Interactive Shell Behavior-snt}{Section@tie 6.3.3}
 @xrdef{Bash Conditional Expressions-title}{Bash Conditional Expressions}
-@xrdef{Bash Conditional Expressions-pg}{69}
+@xrdef{Bash Conditional Expressions-pg}{71}
 @xrdef{Bash Conditional Expressions-snt}{Section@tie 6.4}
 @xrdef{Shell Arithmetic-title}{Shell Arithmetic}
-@xrdef{Shell Arithmetic-pg}{70}
+@xrdef{Shell Arithmetic-pg}{72}
 @xrdef{Shell Arithmetic-snt}{Section@tie 6.5}
 @xrdef{Aliases-title}{Aliases}
-@xrdef{Aliases-pg}{71}
+@xrdef{Aliases-pg}{73}
 @xrdef{Aliases-snt}{Section@tie 6.6}
 @xrdef{Arrays-title}{Arrays}
-@xrdef{Arrays-pg}{72}
+@xrdef{Arrays-pg}{74}
 @xrdef{Arrays-snt}{Section@tie 6.7}
 @xrdef{The Directory Stack-title}{The Directory Stack}
-@xrdef{The Directory Stack-pg}{73}
+@xrdef{The Directory Stack-pg}{75}
 @xrdef{The Directory Stack-snt}{Section@tie 6.8}
 @xrdef{Directory Stack Builtins-title}{Directory Stack Builtins}
-@xrdef{Directory Stack Builtins-pg}{73}
+@xrdef{Directory Stack Builtins-pg}{75}
 @xrdef{Directory Stack Builtins-snt}{Section@tie 6.8.1}
 @xrdef{Printing a Prompt-title}{Controlling the Prompt}
-@xrdef{Printing a Prompt-pg}{75}
+@xrdef{Printing a Prompt-pg}{77}
 @xrdef{Printing a Prompt-snt}{Section@tie 6.9}
 @xrdef{The Restricted Shell-title}{The Restricted Shell}
-@xrdef{The Restricted Shell-pg}{76}
+@xrdef{The Restricted Shell-pg}{78}
 @xrdef{The Restricted Shell-snt}{Section@tie 6.10}
 @xrdef{Bash POSIX Mode-title}{Bash POSIX Mode}
-@xrdef{Bash POSIX Mode-pg}{76}
+@xrdef{Bash POSIX Mode-pg}{78}
 @xrdef{Bash POSIX Mode-snt}{Section@tie 6.11}
 @xrdef{Job Control-title}{Job Control}
-@xrdef{Job Control-pg}{81}
+@xrdef{Job Control-pg}{83}
 @xrdef{Job Control-snt}{Chapter@tie 7}
 @xrdef{Job Control Basics-title}{Job Control Basics}
-@xrdef{Job Control Basics-pg}{81}
+@xrdef{Job Control Basics-pg}{83}
 @xrdef{Job Control Basics-snt}{Section@tie 7.1}
 @xrdef{Job Control Builtins-title}{Job Control Builtins}
-@xrdef{Job Control Builtins-pg}{82}
+@xrdef{Job Control Builtins-pg}{84}
 @xrdef{Job Control Builtins-snt}{Section@tie 7.2}
 @xrdef{Job Control Variables-title}{Job Control Variables}
-@xrdef{Job Control Variables-pg}{84}
+@xrdef{Job Control Variables-pg}{86}
 @xrdef{Job Control Variables-snt}{Section@tie 7.3}
 @xrdef{Command Line Editing-title}{Command Line Editing}
-@xrdef{Command Line Editing-pg}{85}
+@xrdef{Command Line Editing-pg}{87}
 @xrdef{Command Line Editing-snt}{Chapter@tie 8}
 @xrdef{Introduction and Notation-title}{Introduction to Line Editing}
-@xrdef{Introduction and Notation-pg}{85}
+@xrdef{Introduction and Notation-pg}{87}
 @xrdef{Introduction and Notation-snt}{Section@tie 8.1}
 @xrdef{Readline Interaction-title}{Readline Interaction}
-@xrdef{Readline Interaction-pg}{85}
+@xrdef{Readline Interaction-pg}{87}
 @xrdef{Readline Interaction-snt}{Section@tie 8.2}
 @xrdef{Readline Bare Essentials-title}{Readline Bare Essentials}
-@xrdef{Readline Bare Essentials-pg}{85}
+@xrdef{Readline Bare Essentials-pg}{87}
 @xrdef{Readline Bare Essentials-snt}{Section@tie 8.2.1}
 @xrdef{Readline Movement Commands-title}{Readline Movement Commands}
-@xrdef{Readline Movement Commands-pg}{86}
+@xrdef{Readline Movement Commands-pg}{88}
 @xrdef{Readline Movement Commands-snt}{Section@tie 8.2.2}
 @xrdef{Readline Killing Commands-title}{Readline Killing Commands}
-@xrdef{Readline Killing Commands-pg}{87}
+@xrdef{Readline Killing Commands-pg}{89}
 @xrdef{Readline Killing Commands-snt}{Section@tie 8.2.3}
 @xrdef{Readline Arguments-title}{Readline Arguments}
-@xrdef{Readline Arguments-pg}{87}
+@xrdef{Readline Arguments-pg}{89}
 @xrdef{Readline Arguments-snt}{Section@tie 8.2.4}
 @xrdef{Searching-title}{Searching for Commands in the History}
-@xrdef{Searching-pg}{88}
+@xrdef{Searching-pg}{90}
 @xrdef{Searching-snt}{Section@tie 8.2.5}
 @xrdef{Readline Init File-title}{Readline Init File}
-@xrdef{Readline Init File-pg}{88}
+@xrdef{Readline Init File-pg}{90}
 @xrdef{Readline Init File-snt}{Section@tie 8.3}
 @xrdef{Readline Init File Syntax-title}{Readline Init File Syntax}
-@xrdef{Readline Init File Syntax-pg}{88}
+@xrdef{Readline Init File Syntax-pg}{90}
 @xrdef{Readline Init File Syntax-snt}{Section@tie 8.3.1}
 @xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
-@xrdef{Conditional Init Constructs-pg}{93}
+@xrdef{Conditional Init Constructs-pg}{95}
 @xrdef{Conditional Init Constructs-snt}{Section@tie 8.3.2}
 @xrdef{Sample Init File-title}{Sample Init File}
-@xrdef{Sample Init File-pg}{94}
+@xrdef{Sample Init File-pg}{96}
 @xrdef{Sample Init File-snt}{Section@tie 8.3.3}
 @xrdef{Bindable Readline Commands-title}{Bindable Readline Commands}
-@xrdef{Bindable Readline Commands-pg}{97}
+@xrdef{Bindable Readline Commands-pg}{99}
 @xrdef{Bindable Readline Commands-snt}{Section@tie 8.4}
 @xrdef{Commands For Moving-title}{Commands For Moving}
-@xrdef{Commands For Moving-pg}{97}
+@xrdef{Commands For Moving-pg}{99}
 @xrdef{Commands For Moving-snt}{Section@tie 8.4.1}
 @xrdef{Commands For History-title}{Commands For Manipulating The History}
-@xrdef{Commands For History-pg}{97}
+@xrdef{Commands For History-pg}{99}
 @xrdef{Commands For History-snt}{Section@tie 8.4.2}
 @xrdef{Commands For Text-title}{Commands For Changing Text}
-@xrdef{Commands For Text-pg}{99}
+@xrdef{Commands For Text-pg}{101}
 @xrdef{Commands For Text-snt}{Section@tie 8.4.3}
 @xrdef{Commands For Killing-title}{Killing And Yanking}
-@xrdef{Commands For Killing-pg}{100}
+@xrdef{Commands For Killing-pg}{102}
 @xrdef{Commands For Killing-snt}{Section@tie 8.4.4}
 @xrdef{Numeric Arguments-title}{Specifying Numeric Arguments}
-@xrdef{Numeric Arguments-pg}{101}
+@xrdef{Numeric Arguments-pg}{103}
 @xrdef{Numeric Arguments-snt}{Section@tie 8.4.5}
 @xrdef{Commands For Completion-title}{Letting Readline Type For You}
-@xrdef{Commands For Completion-pg}{101}
+@xrdef{Commands For Completion-pg}{103}
 @xrdef{Commands For Completion-snt}{Section@tie 8.4.6}
 @xrdef{Keyboard Macros-title}{Keyboard Macros}
-@xrdef{Keyboard Macros-pg}{102}
+@xrdef{Keyboard Macros-pg}{104}
 @xrdef{Keyboard Macros-snt}{Section@tie 8.4.7}
 @xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands}
-@xrdef{Miscellaneous Commands-pg}{103}
+@xrdef{Miscellaneous Commands-pg}{105}
 @xrdef{Miscellaneous Commands-snt}{Section@tie 8.4.8}
 @xrdef{Readline vi Mode-title}{Readline vi Mode}
-@xrdef{Readline vi Mode-pg}{105}
+@xrdef{Readline vi Mode-pg}{107}
 @xrdef{Readline vi Mode-snt}{Section@tie 8.5}
 @xrdef{Programmable Completion-title}{Programmable Completion}
-@xrdef{Programmable Completion-pg}{105}
+@xrdef{Programmable Completion-pg}{107}
 @xrdef{Programmable Completion-snt}{Section@tie 8.6}
 @xrdef{Programmable Completion Builtins-title}{Programmable Completion Builtins}
-@xrdef{Programmable Completion Builtins-pg}{107}
+@xrdef{Programmable Completion Builtins-pg}{109}
 @xrdef{Programmable Completion Builtins-snt}{Section@tie 8.7}
 @xrdef{Using History Interactively-title}{Using History Interactively}
-@xrdef{Using History Interactively-pg}{111}
+@xrdef{Using History Interactively-pg}{113}
 @xrdef{Using History Interactively-snt}{Chapter@tie 9}
 @xrdef{Bash History Facilities-title}{Bash History Facilities}
-@xrdef{Bash History Facilities-pg}{111}
+@xrdef{Bash History Facilities-pg}{113}
 @xrdef{Bash History Facilities-snt}{Section@tie 9.1}
 @xrdef{Bash History Builtins-title}{Bash History Builtins}
-@xrdef{Bash History Builtins-pg}{111}
+@xrdef{Bash History Builtins-pg}{113}
 @xrdef{Bash History Builtins-snt}{Section@tie 9.2}
 @xrdef{History Interaction-title}{History Expansion}
-@xrdef{History Interaction-pg}{113}
+@xrdef{History Interaction-pg}{115}
 @xrdef{History Interaction-snt}{Section@tie 9.3}
 @xrdef{Event Designators-title}{Event Designators}
-@xrdef{Event Designators-pg}{113}
+@xrdef{Event Designators-pg}{115}
 @xrdef{Event Designators-snt}{Section@tie 9.3.1}
 @xrdef{Word Designators-title}{Word Designators}
-@xrdef{Word Designators-pg}{114}
+@xrdef{Word Designators-pg}{116}
 @xrdef{Word Designators-snt}{Section@tie 9.3.2}
 @xrdef{Modifiers-title}{Modifiers}
-@xrdef{Modifiers-pg}{115}
+@xrdef{Modifiers-pg}{117}
 @xrdef{Modifiers-snt}{Section@tie 9.3.3}
 @xrdef{Installing Bash-title}{Installing Bash}
-@xrdef{Installing Bash-pg}{117}
+@xrdef{Installing Bash-pg}{119}
 @xrdef{Installing Bash-snt}{Chapter@tie 10}
 @xrdef{Basic Installation-title}{Basic Installation}
-@xrdef{Basic Installation-pg}{117}
+@xrdef{Basic Installation-pg}{119}
 @xrdef{Basic Installation-snt}{Section@tie 10.1}
 @xrdef{Compilers and Options-title}{Compilers and Options}
-@xrdef{Compilers and Options-pg}{118}
+@xrdef{Compilers and Options-pg}{120}
 @xrdef{Compilers and Options-snt}{Section@tie 10.2}
 @xrdef{Compiling For Multiple Architectures-title}{Compiling For Multiple Architectures}
-@xrdef{Compiling For Multiple Architectures-pg}{118}
+@xrdef{Compiling For Multiple Architectures-pg}{120}
 @xrdef{Compiling For Multiple Architectures-snt}{Section@tie 10.3}
 @xrdef{Installation Names-title}{Installation Names}
-@xrdef{Installation Names-pg}{118}
+@xrdef{Installation Names-pg}{120}
 @xrdef{Installation Names-snt}{Section@tie 10.4}
 @xrdef{Specifying the System Type-title}{Specifying the System Type}
-@xrdef{Specifying the System Type-pg}{119}
+@xrdef{Specifying the System Type-pg}{121}
 @xrdef{Specifying the System Type-snt}{Section@tie 10.5}
 @xrdef{Sharing Defaults-title}{Sharing Defaults}
-@xrdef{Sharing Defaults-pg}{119}
+@xrdef{Sharing Defaults-pg}{121}
 @xrdef{Sharing Defaults-snt}{Section@tie 10.6}
 @xrdef{Operation Controls-title}{Operation Controls}
-@xrdef{Operation Controls-pg}{119}
+@xrdef{Operation Controls-pg}{121}
 @xrdef{Operation Controls-snt}{Section@tie 10.7}
 @xrdef{Optional Features-title}{Optional Features}
-@xrdef{Optional Features-pg}{119}
+@xrdef{Optional Features-pg}{121}
 @xrdef{Optional Features-snt}{Section@tie 10.8}
 @xrdef{Reporting Bugs-title}{Reporting Bugs}
-@xrdef{Reporting Bugs-pg}{125}
+@xrdef{Reporting Bugs-pg}{127}
 @xrdef{Reporting Bugs-snt}{Appendix@tie @char65{}}
 @xrdef{Major Differences From The Bourne Shell-title}{Major Differences From The Bourne Shell}
-@xrdef{Major Differences From The Bourne Shell-pg}{127}
+@xrdef{Major Differences From The Bourne Shell-pg}{129}
 @xrdef{Major Differences From The Bourne Shell-snt}{Appendix@tie @char66{}}
 @xrdef{Copying This Manual-title}{Copying This Manual}
-@xrdef{Copying This Manual-pg}{133}
+@xrdef{Copying This Manual-pg}{135}
 @xrdef{Copying This Manual-snt}{Appendix@tie @char67{}}
 @xrdef{GNU Free Documentation License-title}{GNU Free Documentation License}
-@xrdef{GNU Free Documentation License-pg}{133}
+@xrdef{GNU Free Documentation License-pg}{135}
 @xrdef{GNU Free Documentation License-snt}{Section@tie @char67.1}
 @xrdef{Builtin Index-title}{Index of Shell Builtin Commands}
-@xrdef{Builtin Index-pg}{141}
+@xrdef{Builtin Index-pg}{143}
 @xrdef{Builtin Index-snt}{}
 @xrdef{Reserved Word Index-title}{Index of Shell Reserved Words}
-@xrdef{Reserved Word Index-pg}{143}
+@xrdef{Reserved Word Index-pg}{145}
 @xrdef{Reserved Word Index-snt}{}
 @xrdef{Variable Index-title}{Parameter and Variable Index}
-@xrdef{Variable Index-pg}{145}
+@xrdef{Variable Index-pg}{147}
 @xrdef{Variable Index-snt}{}
 @xrdef{Function Index-title}{Function Index}
-@xrdef{Function Index-pg}{147}
+@xrdef{Function Index-pg}{149}
 @xrdef{Function Index-snt}{}
 @xrdef{Concept Index-title}{Concept Index}
-@xrdef{Concept Index-pg}{149}
+@xrdef{Concept Index-pg}{151}
 @xrdef{Concept Index-snt}{}

doc/bashref.bt

@@ -34,23 +34,23 @@
 \entry{printf}{44}{\code {printf}}
 \entry{read}{44}{\code {read}}
 \entry{shopt}{45}{\code {shopt}}
-\entry{source}{48}{\code {source}}
-\entry{type}{48}{\code {type}}
+\entry{source}{49}{\code {source}}
+\entry{type}{49}{\code {type}}
 \entry{typeset}{49}{\code {typeset}}
 \entry{ulimit}{49}{\code {ulimit}}
 \entry{unalias}{50}{\code {unalias}}
 \entry{set}{50}{\code {set}}
-\entry{dirs}{73}{\code {dirs}}
-\entry{popd}{74}{\code {popd}}
-\entry{pushd}{74}{\code {pushd}}
-\entry{bg}{82}{\code {bg}}
-\entry{fg}{82}{\code {fg}}
-\entry{jobs}{82}{\code {jobs}}
-\entry{kill}{83}{\code {kill}}
-\entry{wait}{83}{\code {wait}}
-\entry{disown}{83}{\code {disown}}
-\entry{suspend}{83}{\code {suspend}}
-\entry{compgen}{107}{\code {compgen}}
-\entry{complete}{107}{\code {complete}}
-\entry{fc}{111}{\code {fc}}
-\entry{history}{112}{\code {history}}
+\entry{dirs}{75}{\code {dirs}}
+\entry{popd}{76}{\code {popd}}
+\entry{pushd}{76}{\code {pushd}}
+\entry{bg}{84}{\code {bg}}
+\entry{fg}{84}{\code {fg}}
+\entry{jobs}{84}{\code {jobs}}
+\entry{kill}{85}{\code {kill}}
+\entry{wait}{85}{\code {wait}}
+\entry{disown}{85}{\code {disown}}
+\entry{suspend}{85}{\code {suspend}}
+\entry{compgen}{109}{\code {compgen}}
+\entry{complete}{109}{\code {complete}}
+\entry{fc}{113}{\code {fc}}
+\entry{history}{114}{\code {history}}

doc/bashref.bts

@@ -7,7 +7,7 @@
 \initial {A}
 \entry {\code {alias}}{39}
 \initial {B}
-\entry {\code {bg}}{82}
+\entry {\code {bg}}{84}
 \entry {\code {bind}}{39}
 \entry {\code {break}}{33}
 \entry {\code {builtin}}{40}
@@ -15,13 +15,13 @@
 \entry {\code {caller}}{40}
 \entry {\code {cd}}{33}
 \entry {\code {command}}{41}
-\entry {\code {compgen}}{107}
-\entry {\code {complete}}{107}
+\entry {\code {compgen}}{109}
+\entry {\code {complete}}{109}
 \entry {\code {continue}}{34}
 \initial {D}
 \entry {\code {declare}}{41}
-\entry {\code {dirs}}{73}
-\entry {\code {disown}}{83}
+\entry {\code {dirs}}{75}
+\entry {\code {disown}}{85}
 \initial {E}
 \entry {\code {echo}}{42}
 \entry {\code {enable}}{42}
@@ -30,26 +30,26 @@
 \entry {\code {exit}}{34}
 \entry {\code {export}}{34}
 \initial {F}
-\entry {\code {fc}}{111}
-\entry {\code {fg}}{82}
+\entry {\code {fc}}{113}
+\entry {\code {fg}}{84}
 \initial {G}
 \entry {\code {getopts}}{35}
 \initial {H}
 \entry {\code {hash}}{35}
 \entry {\code {help}}{43}
-\entry {\code {history}}{112}
+\entry {\code {history}}{114}
 \initial {J}
-\entry {\code {jobs}}{82}
+\entry {\code {jobs}}{84}
 \initial {K}
-\entry {\code {kill}}{83}
+\entry {\code {kill}}{85}
 \initial {L}
 \entry {\code {let}}{43}
 \entry {\code {local}}{43}
 \entry {\code {logout}}{43}
 \initial {P}
-\entry {\code {popd}}{74}
+\entry {\code {popd}}{76}
 \entry {\code {printf}}{44}
-\entry {\code {pushd}}{74}
+\entry {\code {pushd}}{76}
 \entry {\code {pwd}}{36}
 \initial {R}
 \entry {\code {read}}{44}
@@ -59,13 +59,13 @@
 \entry {\code {set}}{50}
 \entry {\code {shift}}{36}
 \entry {\code {shopt}}{45}
-\entry {\code {source}}{48}
-\entry {\code {suspend}}{83}
+\entry {\code {source}}{49}
+\entry {\code {suspend}}{85}
 \initial {T}
 \entry {\code {test}}{37}
 \entry {\code {times}}{38}
 \entry {\code {trap}}{38}
-\entry {\code {type}}{48}
+\entry {\code {type}}{49}
 \entry {\code {typeset}}{49}
 \initial {U}
 \entry {\code {ulimit}}{49}
@@ -73,4 +73,4 @@
 \entry {\code {unalias}}{50}
 \entry {\code {unset}}{39}
 \initial {W}
-\entry {\code {wait}}{83}
+\entry {\code {wait}}{85}

doc/bashref.cp

@@ -36,14 +36,14 @@
 \entry{commands, looping}{9}{commands, looping}
 \entry{commands, conditional}{10}{commands, conditional}
 \entry{commands, grouping}{13}{commands, grouping}
-\entry{shell function}{13}{shell function}
-\entry{functions, shell}{13}{functions, shell}
+\entry{shell function}{14}{shell function}
+\entry{functions, shell}{14}{functions, shell}
 \entry{parameters}{15}{parameters}
 \entry{variable, shell}{15}{variable, shell}
 \entry{shell variable}{15}{shell variable}
 \entry{parameters, positional}{15}{parameters, positional}
-\entry{parameters, special}{15}{parameters, special}
-\entry{expansion}{16}{expansion}
+\entry{parameters, special}{16}{parameters, special}
+\entry{expansion}{17}{expansion}
 \entry{brace expansion}{17}{brace expansion}
 \entry{expansion, brace}{17}{expansion, brace}
 \entry{tilde expansion}{18}{tilde expansion}
@@ -51,8 +51,8 @@
 \entry{parameter expansion}{19}{parameter expansion}
 \entry{expansion, parameter}{19}{expansion, parameter}
 \entry{command substitution}{21}{command substitution}
-\entry{expansion, arithmetic}{21}{expansion, arithmetic}
-\entry{arithmetic expansion}{21}{arithmetic expansion}
+\entry{expansion, arithmetic}{22}{expansion, arithmetic}
+\entry{arithmetic expansion}{22}{arithmetic expansion}
 \entry{process substitution}{22}{process substitution}
 \entry{word splitting}{22}{word splitting}
 \entry{expansion, filename}{23}{expansion, filename}
@@ -61,7 +61,7 @@
 \entry{pathname expansion}{23}{pathname expansion}
 \entry{pattern matching}{23}{pattern matching}
 \entry{matching, pattern}{23}{matching, pattern}
-\entry{redirection}{24}{redirection}
+\entry{redirection}{25}{redirection}
 \entry{command expansion}{28}{command expansion}
 \entry{command execution}{29}{command execution}
 \entry{command search}{29}{command search}
@@ -71,48 +71,48 @@
 \entry{signal handling}{31}{signal handling}
 \entry{shell script}{32}{shell script}
 \entry{special builtin}{54}{special builtin}
-\entry{login shell}{65}{login shell}
-\entry{interactive shell}{65}{interactive shell}
-\entry{startup files}{65}{startup files}
+\entry{login shell}{67}{login shell}
 \entry{interactive shell}{67}{interactive shell}
-\entry{shell, interactive}{67}{shell, interactive}
-\entry{expressions, conditional}{69}{expressions, conditional}
-\entry{arithmetic, shell}{70}{arithmetic, shell}
-\entry{shell arithmetic}{70}{shell arithmetic}
-\entry{expressions, arithmetic}{70}{expressions, arithmetic}
-\entry{evaluation, arithmetic}{70}{evaluation, arithmetic}
-\entry{arithmetic evaluation}{70}{arithmetic evaluation}
-\entry{alias expansion}{71}{alias expansion}
-\entry{arrays}{72}{arrays}
-\entry{directory stack}{73}{directory stack}
-\entry{prompting}{75}{prompting}
-\entry{restricted shell}{76}{restricted shell}
-\entry{POSIX Mode}{76}{POSIX Mode}
-\entry{job control}{81}{job control}
-\entry{foreground}{81}{foreground}
-\entry{background}{81}{background}
-\entry{suspending jobs}{81}{suspending jobs}
-\entry{Readline, how to use}{84}{Readline, how to use}
-\entry{interaction, readline}{85}{interaction, readline}
-\entry{notation, readline}{85}{notation, readline}
-\entry{command editing}{85}{command editing}
-\entry{editing command lines}{85}{editing command lines}
-\entry{killing text}{87}{killing text}
-\entry{yanking text}{87}{yanking text}
-\entry{kill ring}{87}{kill ring}
-\entry{initialization file, readline}{88}{initialization file, readline}
-\entry{variables, readline}{89}{variables, readline}
-\entry{programmable completion}{105}{programmable completion}
-\entry{completion builtins}{107}{completion builtins}
-\entry{History, how to use}{110}{History, how to use}
-\entry{command history}{111}{command history}
-\entry{history list}{111}{history list}
-\entry{history builtins}{111}{history builtins}
-\entry{history expansion}{113}{history expansion}
-\entry{event designators}{113}{event designators}
-\entry{history events}{113}{history events}
-\entry{installation}{117}{installation}
-\entry{configuration}{117}{configuration}
-\entry{Bash installation}{117}{Bash installation}
-\entry{Bash configuration}{117}{Bash configuration}
-\entry{FDL, GNU Free Documentation License}{133}{FDL, GNU Free Documentation License}
+\entry{startup files}{67}{startup files}
+\entry{interactive shell}{69}{interactive shell}
+\entry{shell, interactive}{69}{shell, interactive}
+\entry{expressions, conditional}{71}{expressions, conditional}
+\entry{arithmetic, shell}{72}{arithmetic, shell}
+\entry{shell arithmetic}{72}{shell arithmetic}
+\entry{expressions, arithmetic}{72}{expressions, arithmetic}
+\entry{evaluation, arithmetic}{72}{evaluation, arithmetic}
+\entry{arithmetic evaluation}{72}{arithmetic evaluation}
+\entry{alias expansion}{73}{alias expansion}
+\entry{arrays}{74}{arrays}
+\entry{directory stack}{75}{directory stack}
+\entry{prompting}{77}{prompting}
+\entry{restricted shell}{78}{restricted shell}
+\entry{POSIX Mode}{78}{POSIX Mode}
+\entry{job control}{83}{job control}
+\entry{foreground}{83}{foreground}
+\entry{background}{83}{background}
+\entry{suspending jobs}{83}{suspending jobs}
+\entry{Readline, how to use}{86}{Readline, how to use}
+\entry{interaction, readline}{87}{interaction, readline}
+\entry{notation, readline}{87}{notation, readline}
+\entry{command editing}{87}{command editing}
+\entry{editing command lines}{87}{editing command lines}
+\entry{killing text}{89}{killing text}
+\entry{yanking text}{89}{yanking text}
+\entry{kill ring}{89}{kill ring}
+\entry{initialization file, readline}{90}{initialization file, readline}
+\entry{variables, readline}{91}{variables, readline}
+\entry{programmable completion}{107}{programmable completion}
+\entry{completion builtins}{109}{completion builtins}
+\entry{History, how to use}{112}{History, how to use}
+\entry{command history}{113}{command history}
+\entry{history list}{113}{history list}
+\entry{history builtins}{113}{history builtins}
+\entry{history expansion}{115}{history expansion}
+\entry{event designators}{115}{event designators}
+\entry{history events}{115}{history events}
+\entry{installation}{119}{installation}
+\entry{configuration}{119}{configuration}
+\entry{Bash installation}{119}{Bash installation}
+\entry{Bash configuration}{119}{Bash configuration}
+\entry{FDL, GNU Free Documentation License}{135}{FDL, GNU Free Documentation License}

doc/bashref.cps

@@ -1,21 +1,21 @@
 \initial {A}
-\entry {alias expansion}{71}
-\entry {arithmetic evaluation}{70}
-\entry {arithmetic expansion}{21}
-\entry {arithmetic, shell}{70}
-\entry {arrays}{72}
+\entry {alias expansion}{73}
+\entry {arithmetic evaluation}{72}
+\entry {arithmetic expansion}{22}
+\entry {arithmetic, shell}{72}
+\entry {arrays}{74}
 \initial {B}
-\entry {background}{81}
-\entry {Bash configuration}{117}
-\entry {Bash installation}{117}
+\entry {background}{83}
+\entry {Bash configuration}{119}
+\entry {Bash installation}{119}
 \entry {Bourne shell}{5}
 \entry {brace expansion}{17}
 \entry {builtin}{3}
 \initial {C}
-\entry {command editing}{85}
+\entry {command editing}{87}
 \entry {command execution}{29}
 \entry {command expansion}{28}
-\entry {command history}{111}
+\entry {command history}{113}
 \entry {command search}{29}
 \entry {command substitution}{21}
 \entry {command timing}{8}
@@ -28,109 +28,109 @@
 \entry {commands, shell}{8}
 \entry {commands, simple}{8}
 \entry {comments, shell}{7}
-\entry {completion builtins}{107}
-\entry {configuration}{117}
+\entry {completion builtins}{109}
+\entry {configuration}{119}
 \entry {control operator}{3}
 \initial {D}
-\entry {directory stack}{73}
+\entry {directory stack}{75}
 \initial {E}
-\entry {editing command lines}{85}
+\entry {editing command lines}{87}
 \entry {environment}{30}
-\entry {evaluation, arithmetic}{70}
-\entry {event designators}{113}
+\entry {evaluation, arithmetic}{72}
+\entry {event designators}{115}
 \entry {execution environment}{29}
 \entry {exit status}{3, 31}
-\entry {expansion}{16}
-\entry {expansion, arithmetic}{21}
+\entry {expansion}{17}
+\entry {expansion, arithmetic}{22}
 \entry {expansion, brace}{17}
 \entry {expansion, filename}{23}
 \entry {expansion, parameter}{19}
 \entry {expansion, pathname}{23}
 \entry {expansion, tilde}{18}
-\entry {expressions, arithmetic}{70}
-\entry {expressions, conditional}{69}
+\entry {expressions, arithmetic}{72}
+\entry {expressions, conditional}{71}
 \initial {F}
-\entry {FDL, GNU Free Documentation License}{133}
+\entry {FDL, GNU Free Documentation License}{135}
 \entry {field}{3}
 \entry {filename}{3}
 \entry {filename expansion}{23}
-\entry {foreground}{81}
-\entry {functions, shell}{13}
+\entry {foreground}{83}
+\entry {functions, shell}{14}
 \initial {H}
-\entry {history builtins}{111}
-\entry {history events}{113}
-\entry {history expansion}{113}
-\entry {history list}{111}
-\entry {History, how to use}{110}
+\entry {history builtins}{113}
+\entry {history events}{115}
+\entry {history expansion}{115}
+\entry {history list}{113}
+\entry {History, how to use}{112}
 \initial {I}
 \entry {identifier}{3}
-\entry {initialization file, readline}{88}
-\entry {installation}{117}
-\entry {interaction, readline}{85}
-\entry {interactive shell}{65, 67}
+\entry {initialization file, readline}{90}
+\entry {installation}{119}
+\entry {interaction, readline}{87}
+\entry {interactive shell}{67, 69}
 \entry {internationalization}{7}
 \initial {J}
 \entry {job}{3}
-\entry {job control}{3, 81}
+\entry {job control}{3, 83}
 \initial {K}
-\entry {kill ring}{87}
-\entry {killing text}{87}
+\entry {kill ring}{89}
+\entry {killing text}{89}
 \initial {L}
 \entry {localization}{7}
-\entry {login shell}{65}
+\entry {login shell}{67}
 \initial {M}
 \entry {matching, pattern}{23}
 \entry {metacharacter}{3}
 \initial {N}
 \entry {name}{3}
 \entry {native languages}{7}
-\entry {notation, readline}{85}
+\entry {notation, readline}{87}
 \initial {O}
 \entry {operator, shell}{3}
 \initial {P}
 \entry {parameter expansion}{19}
 \entry {parameters}{15}
 \entry {parameters, positional}{15}
-\entry {parameters, special}{15}
+\entry {parameters, special}{16}
 \entry {pathname expansion}{23}
 \entry {pattern matching}{23}
 \entry {pipeline}{8}
 \entry {POSIX}{3}
-\entry {POSIX Mode}{76}
+\entry {POSIX Mode}{78}
 \entry {process group}{3}
 \entry {process group ID}{3}
 \entry {process substitution}{22}
-\entry {programmable completion}{105}
-\entry {prompting}{75}
+\entry {programmable completion}{107}
+\entry {prompting}{77}
 \initial {Q}
 \entry {quoting}{6}
 \entry {quoting, ANSI}{6}
 \initial {R}
-\entry {Readline, how to use}{84}
-\entry {redirection}{24}
+\entry {Readline, how to use}{86}
+\entry {redirection}{25}
 \entry {reserved word}{3}
-\entry {restricted shell}{76}
+\entry {restricted shell}{78}
 \entry {return status}{3}
 \initial {S}
-\entry {shell arithmetic}{70}
-\entry {shell function}{13}
+\entry {shell arithmetic}{72}
+\entry {shell function}{14}
 \entry {shell script}{32}
 \entry {shell variable}{15}
-\entry {shell, interactive}{67}
+\entry {shell, interactive}{69}
 \entry {signal}{4}
 \entry {signal handling}{31}
 \entry {special builtin}{4, 54}
-\entry {startup files}{65}
-\entry {suspending jobs}{81}
+\entry {startup files}{67}
+\entry {suspending jobs}{83}
 \initial {T}
 \entry {tilde expansion}{18}
 \entry {token}{4}
 \entry {translation, native languages}{7}
 \initial {V}
 \entry {variable, shell}{15}
-\entry {variables, readline}{89}
+\entry {variables, readline}{91}
 \initial {W}
 \entry {word}{4}
 \entry {word splitting}{22}
 \initial {Y}
-\entry {yanking text}{87}
+\entry {yanking text}{89}

doc/bashref.fn

@@ -1,96 +1,96 @@
-\entry{beginning-of-line (C-a)}{97}{\code {beginning-of-line (C-a)}}
-\entry{end-of-line (C-e)}{97}{\code {end-of-line (C-e)}}
-\entry{forward-char (C-f)}{97}{\code {forward-char (C-f)}}
-\entry{backward-char (C-b)}{97}{\code {backward-char (C-b)}}
-\entry{forward-word (M-f)}{97}{\code {forward-word (M-f)}}
-\entry{backward-word (M-b)}{97}{\code {backward-word (M-b)}}
-\entry{clear-screen (C-l)}{97}{\code {clear-screen (C-l)}}
-\entry{redraw-current-line ()}{97}{\code {redraw-current-line ()}}
-\entry{accept-line (Newline or Return)}{97}{\code {accept-line (Newline or Return)}}
-\entry{previous-history (C-p)}{98}{\code {previous-history (C-p)}}
-\entry{next-history (C-n)}{98}{\code {next-history (C-n)}}
-\entry{beginning-of-history (M-<)}{98}{\code {beginning-of-history (M-<)}}
-\entry{end-of-history (M->)}{98}{\code {end-of-history (M->)}}
-\entry{reverse-search-history (C-r)}{98}{\code {reverse-search-history (C-r)}}
-\entry{forward-search-history (C-s)}{98}{\code {forward-search-history (C-s)}}
-\entry{non-incremental-reverse-search-history (M-p)}{98}{\code {non-incremental-reverse-search-history (M-p)}}
-\entry{non-incremental-forward-search-history (M-n)}{98}{\code {non-incremental-forward-search-history (M-n)}}
-\entry{history-search-forward ()}{98}{\code {history-search-forward ()}}
-\entry{history-search-backward ()}{98}{\code {history-search-backward ()}}
-\entry{yank-nth-arg (M-C-y)}{98}{\code {yank-nth-arg (M-C-y)}}
-\entry{yank-last-arg (M-. or M-_)}{98}{\code {yank-last-arg (M-. or M-_)}}
-\entry{delete-char (C-d)}{99}{\code {delete-char (C-d)}}
-\entry{backward-delete-char (Rubout)}{99}{\code {backward-delete-char (Rubout)}}
-\entry{forward-backward-delete-char ()}{99}{\code {forward-backward-delete-char ()}}
-\entry{quoted-insert (C-q or C-v)}{99}{\code {quoted-insert (C-q or C-v)}}
-\entry{self-insert (a, b, A, 1, !, ...{})}{99}{\code {self-insert (a, b, A, 1, !, \dots {})}}
-\entry{transpose-chars (C-t)}{99}{\code {transpose-chars (C-t)}}
-\entry{transpose-words (M-t)}{99}{\code {transpose-words (M-t)}}
-\entry{upcase-word (M-u)}{99}{\code {upcase-word (M-u)}}
-\entry{downcase-word (M-l)}{99}{\code {downcase-word (M-l)}}
-\entry{capitalize-word (M-c)}{99}{\code {capitalize-word (M-c)}}
-\entry{overwrite-mode ()}{99}{\code {overwrite-mode ()}}
-\entry{kill-line (C-k)}{100}{\code {kill-line (C-k)}}
-\entry{backward-kill-line (C-x Rubout)}{100}{\code {backward-kill-line (C-x Rubout)}}
-\entry{unix-line-discard (C-u)}{100}{\code {unix-line-discard (C-u)}}
-\entry{kill-whole-line ()}{100}{\code {kill-whole-line ()}}
-\entry{kill-word (M-d)}{100}{\code {kill-word (M-d)}}
-\entry{backward-kill-word (M-DEL)}{100}{\code {backward-kill-word (M-\key {DEL})}}
-\entry{unix-word-rubout (C-w)}{100}{\code {unix-word-rubout (C-w)}}
-\entry{unix-filename-rubout ()}{100}{\code {unix-filename-rubout ()}}
-\entry{delete-horizontal-space ()}{100}{\code {delete-horizontal-space ()}}
-\entry{kill-region ()}{100}{\code {kill-region ()}}
-\entry{copy-region-as-kill ()}{100}{\code {copy-region-as-kill ()}}
-\entry{copy-backward-word ()}{100}{\code {copy-backward-word ()}}
-\entry{copy-forward-word ()}{100}{\code {copy-forward-word ()}}
-\entry{yank (C-y)}{101}{\code {yank (C-y)}}
-\entry{yank-pop (M-y)}{101}{\code {yank-pop (M-y)}}
-\entry{digit-argument (M-0, M-1, ...{} M--)}{101}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
-\entry{universal-argument ()}{101}{\code {universal-argument ()}}
-\entry{complete (TAB)}{101}{\code {complete (\key {TAB})}}
-\entry{possible-completions (M-?)}{101}{\code {possible-completions (M-?)}}
-\entry{insert-completions (M-*)}{101}{\code {insert-completions (M-*)}}
-\entry{menu-complete ()}{101}{\code {menu-complete ()}}
-\entry{delete-char-or-list ()}{102}{\code {delete-char-or-list ()}}
-\entry{complete-filename (M-/)}{102}{\code {complete-filename (M-/)}}
-\entry{possible-filename-completions (C-x /)}{102}{\code {possible-filename-completions (C-x /)}}
-\entry{complete-username (M-~)}{102}{\code {complete-username (M-~)}}
-\entry{possible-username-completions (C-x ~)}{102}{\code {possible-username-completions (C-x ~)}}
-\entry{complete-variable (M-$)}{102}{\code {complete-variable (M-$)}}
-\entry{possible-variable-completions (C-x $)}{102}{\code {possible-variable-completions (C-x $)}}
-\entry{complete-hostname (M-@)}{102}{\code {complete-hostname (M-@)}}
-\entry{possible-hostname-completions (C-x @)}{102}{\code {possible-hostname-completions (C-x @)}}
-\entry{complete-command (M-!)}{102}{\code {complete-command (M-!)}}
-\entry{possible-command-completions (C-x !)}{102}{\code {possible-command-completions (C-x !)}}
-\entry{dynamic-complete-history (M-TAB)}{102}{\code {dynamic-complete-history (M-\key {TAB})}}
-\entry{complete-into-braces (M-{\tt \char 123})}{102}{\code {complete-into-braces (M-{\tt \char 123})}}
-\entry{start-kbd-macro (C-x ()}{102}{\code {start-kbd-macro (C-x ()}}
-\entry{end-kbd-macro (C-x ))}{103}{\code {end-kbd-macro (C-x ))}}
-\entry{call-last-kbd-macro (C-x e)}{103}{\code {call-last-kbd-macro (C-x e)}}
-\entry{re-read-init-file (C-x C-r)}{103}{\code {re-read-init-file (C-x C-r)}}
-\entry{abort (C-g)}{103}{\code {abort (C-g)}}
-\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{103}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
-\entry{prefix-meta (ESC)}{103}{\code {prefix-meta (\key {ESC})}}
-\entry{undo (C-_ or C-x C-u)}{103}{\code {undo (C-_ or C-x C-u)}}
-\entry{revert-line (M-r)}{103}{\code {revert-line (M-r)}}
-\entry{tilde-expand (M-&)}{103}{\code {tilde-expand (M-&)}}
-\entry{set-mark (C-@)}{103}{\code {set-mark (C-@)}}
-\entry{exchange-point-and-mark (C-x C-x)}{103}{\code {exchange-point-and-mark (C-x C-x)}}
-\entry{character-search (C-])}{103}{\code {character-search (C-])}}
-\entry{character-search-backward (M-C-])}{103}{\code {character-search-backward (M-C-])}}
-\entry{insert-comment (M-#)}{104}{\code {insert-comment (M-#)}}
-\entry{dump-functions ()}{104}{\code {dump-functions ()}}
-\entry{dump-variables ()}{104}{\code {dump-variables ()}}
-\entry{dump-macros ()}{104}{\code {dump-macros ()}}
-\entry{glob-complete-word (M-g)}{104}{\code {glob-complete-word (M-g)}}
-\entry{glob-expand-word (C-x *)}{104}{\code {glob-expand-word (C-x *)}}
-\entry{glob-list-expansions (C-x g)}{104}{\code {glob-list-expansions (C-x g)}}
-\entry{display-shell-version (C-x C-v)}{104}{\code {display-shell-version (C-x C-v)}}
-\entry{shell-expand-line (M-C-e)}{104}{\code {shell-expand-line (M-C-e)}}
-\entry{history-expand-line (M-^)}{104}{\code {history-expand-line (M-^)}}
-\entry{magic-space ()}{105}{\code {magic-space ()}}
-\entry{alias-expand-line ()}{105}{\code {alias-expand-line ()}}
-\entry{history-and-alias-expand-line ()}{105}{\code {history-and-alias-expand-line ()}}
-\entry{insert-last-argument (M-. or M-_)}{105}{\code {insert-last-argument (M-. or M-_)}}
-\entry{operate-and-get-next (C-o)}{105}{\code {operate-and-get-next (C-o)}}
-\entry{edit-and-execute-command (C-xC-e)}{105}{\code {edit-and-execute-command (C-xC-e)}}
+\entry{beginning-of-line (C-a)}{99}{\code {beginning-of-line (C-a)}}
+\entry{end-of-line (C-e)}{99}{\code {end-of-line (C-e)}}
+\entry{forward-char (C-f)}{99}{\code {forward-char (C-f)}}
+\entry{backward-char (C-b)}{99}{\code {backward-char (C-b)}}
+\entry{forward-word (M-f)}{99}{\code {forward-word (M-f)}}
+\entry{backward-word (M-b)}{99}{\code {backward-word (M-b)}}
+\entry{clear-screen (C-l)}{99}{\code {clear-screen (C-l)}}
+\entry{redraw-current-line ()}{99}{\code {redraw-current-line ()}}
+\entry{accept-line (Newline or Return)}{99}{\code {accept-line (Newline or Return)}}
+\entry{previous-history (C-p)}{100}{\code {previous-history (C-p)}}
+\entry{next-history (C-n)}{100}{\code {next-history (C-n)}}
+\entry{beginning-of-history (M-<)}{100}{\code {beginning-of-history (M-<)}}
+\entry{end-of-history (M->)}{100}{\code {end-of-history (M->)}}
+\entry{reverse-search-history (C-r)}{100}{\code {reverse-search-history (C-r)}}
+\entry{forward-search-history (C-s)}{100}{\code {forward-search-history (C-s)}}
+\entry{non-incremental-reverse-search-history (M-p)}{100}{\code {non-incremental-reverse-search-history (M-p)}}
+\entry{non-incremental-forward-search-history (M-n)}{100}{\code {non-incremental-forward-search-history (M-n)}}
+\entry{history-search-forward ()}{100}{\code {history-search-forward ()}}
+\entry{history-search-backward ()}{100}{\code {history-search-backward ()}}
+\entry{yank-nth-arg (M-C-y)}{100}{\code {yank-nth-arg (M-C-y)}}
+\entry{yank-last-arg (M-. or M-_)}{100}{\code {yank-last-arg (M-. or M-_)}}
+\entry{delete-char (C-d)}{101}{\code {delete-char (C-d)}}
+\entry{backward-delete-char (Rubout)}{101}{\code {backward-delete-char (Rubout)}}
+\entry{forward-backward-delete-char ()}{101}{\code {forward-backward-delete-char ()}}
+\entry{quoted-insert (C-q or C-v)}{101}{\code {quoted-insert (C-q or C-v)}}
+\entry{self-insert (a, b, A, 1, !, ...{})}{101}{\code {self-insert (a, b, A, 1, !, \dots {})}}
+\entry{transpose-chars (C-t)}{101}{\code {transpose-chars (C-t)}}
+\entry{transpose-words (M-t)}{101}{\code {transpose-words (M-t)}}
+\entry{upcase-word (M-u)}{101}{\code {upcase-word (M-u)}}
+\entry{downcase-word (M-l)}{101}{\code {downcase-word (M-l)}}
+\entry{capitalize-word (M-c)}{101}{\code {capitalize-word (M-c)}}
+\entry{overwrite-mode ()}{101}{\code {overwrite-mode ()}}
+\entry{kill-line (C-k)}{102}{\code {kill-line (C-k)}}
+\entry{backward-kill-line (C-x Rubout)}{102}{\code {backward-kill-line (C-x Rubout)}}
+\entry{unix-line-discard (C-u)}{102}{\code {unix-line-discard (C-u)}}
+\entry{kill-whole-line ()}{102}{\code {kill-whole-line ()}}
+\entry{kill-word (M-d)}{102}{\code {kill-word (M-d)}}
+\entry{backward-kill-word (M-DEL)}{102}{\code {backward-kill-word (M-\key {DEL})}}
+\entry{unix-word-rubout (C-w)}{102}{\code {unix-word-rubout (C-w)}}
+\entry{unix-filename-rubout ()}{102}{\code {unix-filename-rubout ()}}
+\entry{delete-horizontal-space ()}{102}{\code {delete-horizontal-space ()}}
+\entry{kill-region ()}{102}{\code {kill-region ()}}
+\entry{copy-region-as-kill ()}{102}{\code {copy-region-as-kill ()}}
+\entry{copy-backward-word ()}{102}{\code {copy-backward-word ()}}
+\entry{copy-forward-word ()}{102}{\code {copy-forward-word ()}}
+\entry{yank (C-y)}{103}{\code {yank (C-y)}}
+\entry{yank-pop (M-y)}{103}{\code {yank-pop (M-y)}}
+\entry{digit-argument (M-0, M-1, ...{} M--)}{103}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
+\entry{universal-argument ()}{103}{\code {universal-argument ()}}
+\entry{complete (TAB)}{103}{\code {complete (\key {TAB})}}
+\entry{possible-completions (M-?)}{103}{\code {possible-completions (M-?)}}
+\entry{insert-completions (M-*)}{103}{\code {insert-completions (M-*)}}
+\entry{menu-complete ()}{103}{\code {menu-complete ()}}
+\entry{delete-char-or-list ()}{104}{\code {delete-char-or-list ()}}
+\entry{complete-filename (M-/)}{104}{\code {complete-filename (M-/)}}
+\entry{possible-filename-completions (C-x /)}{104}{\code {possible-filename-completions (C-x /)}}
+\entry{complete-username (M-~)}{104}{\code {complete-username (M-~)}}
+\entry{possible-username-completions (C-x ~)}{104}{\code {possible-username-completions (C-x ~)}}
+\entry{complete-variable (M-$)}{104}{\code {complete-variable (M-$)}}
+\entry{possible-variable-completions (C-x $)}{104}{\code {possible-variable-completions (C-x $)}}
+\entry{complete-hostname (M-@)}{104}{\code {complete-hostname (M-@)}}
+\entry{possible-hostname-completions (C-x @)}{104}{\code {possible-hostname-completions (C-x @)}}
+\entry{complete-command (M-!)}{104}{\code {complete-command (M-!)}}
+\entry{possible-command-completions (C-x !)}{104}{\code {possible-command-completions (C-x !)}}
+\entry{dynamic-complete-history (M-TAB)}{104}{\code {dynamic-complete-history (M-\key {TAB})}}
+\entry{complete-into-braces (M-{\tt \char 123})}{104}{\code {complete-into-braces (M-{\tt \char 123})}}
+\entry{start-kbd-macro (C-x ()}{104}{\code {start-kbd-macro (C-x ()}}
+\entry{end-kbd-macro (C-x ))}{105}{\code {end-kbd-macro (C-x ))}}
+\entry{call-last-kbd-macro (C-x e)}{105}{\code {call-last-kbd-macro (C-x e)}}
+\entry{re-read-init-file (C-x C-r)}{105}{\code {re-read-init-file (C-x C-r)}}
+\entry{abort (C-g)}{105}{\code {abort (C-g)}}
+\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{105}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
+\entry{prefix-meta (ESC)}{105}{\code {prefix-meta (\key {ESC})}}
+\entry{undo (C-_ or C-x C-u)}{105}{\code {undo (C-_ or C-x C-u)}}
+\entry{revert-line (M-r)}{105}{\code {revert-line (M-r)}}
+\entry{tilde-expand (M-&)}{105}{\code {tilde-expand (M-&)}}
+\entry{set-mark (C-@)}{105}{\code {set-mark (C-@)}}
+\entry{exchange-point-and-mark (C-x C-x)}{105}{\code {exchange-point-and-mark (C-x C-x)}}
+\entry{character-search (C-])}{105}{\code {character-search (C-])}}
+\entry{character-search-backward (M-C-])}{105}{\code {character-search-backward (M-C-])}}
+\entry{insert-comment (M-#)}{106}{\code {insert-comment (M-#)}}
+\entry{dump-functions ()}{106}{\code {dump-functions ()}}
+\entry{dump-variables ()}{106}{\code {dump-variables ()}}
+\entry{dump-macros ()}{106}{\code {dump-macros ()}}
+\entry{glob-complete-word (M-g)}{106}{\code {glob-complete-word (M-g)}}
+\entry{glob-expand-word (C-x *)}{106}{\code {glob-expand-word (C-x *)}}
+\entry{glob-list-expansions (C-x g)}{106}{\code {glob-list-expansions (C-x g)}}
+\entry{display-shell-version (C-x C-v)}{106}{\code {display-shell-version (C-x C-v)}}
+\entry{shell-expand-line (M-C-e)}{106}{\code {shell-expand-line (M-C-e)}}
+\entry{history-expand-line (M-^)}{106}{\code {history-expand-line (M-^)}}
+\entry{magic-space ()}{107}{\code {magic-space ()}}
+\entry{alias-expand-line ()}{107}{\code {alias-expand-line ()}}
+\entry{history-and-alias-expand-line ()}{107}{\code {history-and-alias-expand-line ()}}
+\entry{insert-last-argument (M-. or M-_)}{107}{\code {insert-last-argument (M-. or M-_)}}
+\entry{operate-and-get-next (C-o)}{107}{\code {operate-and-get-next (C-o)}}
+\entry{edit-and-execute-command (C-xC-e)}{107}{\code {edit-and-execute-command (C-xC-e)}}

doc/bashref.fns

@@ -1,116 +1,116 @@
 \initial {A}
-\entry {\code {abort (C-g)}}{103}
-\entry {\code {accept-line (Newline or Return)}}{97}
-\entry {\code {alias-expand-line ()}}{105}
+\entry {\code {abort (C-g)}}{105}
+\entry {\code {accept-line (Newline or Return)}}{99}
+\entry {\code {alias-expand-line ()}}{107}
 \initial {B}
-\entry {\code {backward-char (C-b)}}{97}
-\entry {\code {backward-delete-char (Rubout)}}{99}
-\entry {\code {backward-kill-line (C-x Rubout)}}{100}
-\entry {\code {backward-kill-word (M-\key {DEL})}}{100}
-\entry {\code {backward-word (M-b)}}{97}
-\entry {\code {beginning-of-history (M-<)}}{98}
-\entry {\code {beginning-of-line (C-a)}}{97}
+\entry {\code {backward-char (C-b)}}{99}
+\entry {\code {backward-delete-char (Rubout)}}{101}
+\entry {\code {backward-kill-line (C-x Rubout)}}{102}
+\entry {\code {backward-kill-word (M-\key {DEL})}}{102}
+\entry {\code {backward-word (M-b)}}{99}
+\entry {\code {beginning-of-history (M-<)}}{100}
+\entry {\code {beginning-of-line (C-a)}}{99}
 \initial {C}
-\entry {\code {call-last-kbd-macro (C-x e)}}{103}
-\entry {\code {capitalize-word (M-c)}}{99}
-\entry {\code {character-search (C-])}}{103}
-\entry {\code {character-search-backward (M-C-])}}{103}
-\entry {\code {clear-screen (C-l)}}{97}
-\entry {\code {complete (\key {TAB})}}{101}
-\entry {\code {complete-command (M-!)}}{102}
-\entry {\code {complete-filename (M-/)}}{102}
-\entry {\code {complete-hostname (M-@)}}{102}
-\entry {\code {complete-into-braces (M-{\tt \char 123})}}{102}
-\entry {\code {complete-username (M-~)}}{102}
-\entry {\code {complete-variable (M-$)}}{102}
-\entry {\code {copy-backward-word ()}}{100}
-\entry {\code {copy-forward-word ()}}{100}
-\entry {\code {copy-region-as-kill ()}}{100}
+\entry {\code {call-last-kbd-macro (C-x e)}}{105}
+\entry {\code {capitalize-word (M-c)}}{101}
+\entry {\code {character-search (C-])}}{105}
+\entry {\code {character-search-backward (M-C-])}}{105}
+\entry {\code {clear-screen (C-l)}}{99}
+\entry {\code {complete (\key {TAB})}}{103}
+\entry {\code {complete-command (M-!)}}{104}
+\entry {\code {complete-filename (M-/)}}{104}
+\entry {\code {complete-hostname (M-@)}}{104}
+\entry {\code {complete-into-braces (M-{\tt \char 123})}}{104}
+\entry {\code {complete-username (M-~)}}{104}
+\entry {\code {complete-variable (M-$)}}{104}
+\entry {\code {copy-backward-word ()}}{102}
+\entry {\code {copy-forward-word ()}}{102}
+\entry {\code {copy-region-as-kill ()}}{102}
 \initial {D}
-\entry {\code {delete-char (C-d)}}{99}
-\entry {\code {delete-char-or-list ()}}{102}
-\entry {\code {delete-horizontal-space ()}}{100}
-\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{101}
-\entry {\code {display-shell-version (C-x C-v)}}{104}
-\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{103}
-\entry {\code {downcase-word (M-l)}}{99}
-\entry {\code {dump-functions ()}}{104}
-\entry {\code {dump-macros ()}}{104}
-\entry {\code {dump-variables ()}}{104}
-\entry {\code {dynamic-complete-history (M-\key {TAB})}}{102}
+\entry {\code {delete-char (C-d)}}{101}
+\entry {\code {delete-char-or-list ()}}{104}
+\entry {\code {delete-horizontal-space ()}}{102}
+\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{103}
+\entry {\code {display-shell-version (C-x C-v)}}{106}
+\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{105}
+\entry {\code {downcase-word (M-l)}}{101}
+\entry {\code {dump-functions ()}}{106}
+\entry {\code {dump-macros ()}}{106}
+\entry {\code {dump-variables ()}}{106}
+\entry {\code {dynamic-complete-history (M-\key {TAB})}}{104}
 \initial {E}
-\entry {\code {edit-and-execute-command (C-xC-e)}}{105}
-\entry {\code {end-kbd-macro (C-x ))}}{103}
-\entry {\code {end-of-history (M->)}}{98}
-\entry {\code {end-of-line (C-e)}}{97}
-\entry {\code {exchange-point-and-mark (C-x C-x)}}{103}
+\entry {\code {edit-and-execute-command (C-xC-e)}}{107}
+\entry {\code {end-kbd-macro (C-x ))}}{105}
+\entry {\code {end-of-history (M->)}}{100}
+\entry {\code {end-of-line (C-e)}}{99}
+\entry {\code {exchange-point-and-mark (C-x C-x)}}{105}
 \initial {F}
-\entry {\code {forward-backward-delete-char ()}}{99}
-\entry {\code {forward-char (C-f)}}{97}
-\entry {\code {forward-search-history (C-s)}}{98}
-\entry {\code {forward-word (M-f)}}{97}
+\entry {\code {forward-backward-delete-char ()}}{101}
+\entry {\code {forward-char (C-f)}}{99}
+\entry {\code {forward-search-history (C-s)}}{100}
+\entry {\code {forward-word (M-f)}}{99}
 \initial {G}
-\entry {\code {glob-complete-word (M-g)}}{104}
-\entry {\code {glob-expand-word (C-x *)}}{104}
-\entry {\code {glob-list-expansions (C-x g)}}{104}
+\entry {\code {glob-complete-word (M-g)}}{106}
+\entry {\code {glob-expand-word (C-x *)}}{106}
+\entry {\code {glob-list-expansions (C-x g)}}{106}
 \initial {H}
-\entry {\code {history-and-alias-expand-line ()}}{105}
-\entry {\code {history-expand-line (M-^)}}{104}
-\entry {\code {history-search-backward ()}}{98}
-\entry {\code {history-search-forward ()}}{98}
+\entry {\code {history-and-alias-expand-line ()}}{107}
+\entry {\code {history-expand-line (M-^)}}{106}
+\entry {\code {history-search-backward ()}}{100}
+\entry {\code {history-search-forward ()}}{100}
 \initial {I}
-\entry {\code {insert-comment (M-#)}}{104}
-\entry {\code {insert-completions (M-*)}}{101}
-\entry {\code {insert-last-argument (M-. or M-_)}}{105}
+\entry {\code {insert-comment (M-#)}}{106}
+\entry {\code {insert-completions (M-*)}}{103}
+\entry {\code {insert-last-argument (M-. or M-_)}}{107}
 \initial {K}
-\entry {\code {kill-line (C-k)}}{100}
-\entry {\code {kill-region ()}}{100}
-\entry {\code {kill-whole-line ()}}{100}
-\entry {\code {kill-word (M-d)}}{100}
+\entry {\code {kill-line (C-k)}}{102}
+\entry {\code {kill-region ()}}{102}
+\entry {\code {kill-whole-line ()}}{102}
+\entry {\code {kill-word (M-d)}}{102}
 \initial {M}
-\entry {\code {magic-space ()}}{105}
-\entry {\code {menu-complete ()}}{101}
+\entry {\code {magic-space ()}}{107}
+\entry {\code {menu-complete ()}}{103}
 \initial {N}
-\entry {\code {next-history (C-n)}}{98}
-\entry {\code {non-incremental-forward-search-history (M-n)}}{98}
-\entry {\code {non-incremental-reverse-search-history (M-p)}}{98}
+\entry {\code {next-history (C-n)}}{100}
+\entry {\code {non-incremental-forward-search-history (M-n)}}{100}
+\entry {\code {non-incremental-reverse-search-history (M-p)}}{100}
 \initial {O}
-\entry {\code {operate-and-get-next (C-o)}}{105}
-\entry {\code {overwrite-mode ()}}{99}
+\entry {\code {operate-and-get-next (C-o)}}{107}
+\entry {\code {overwrite-mode ()}}{101}
 \initial {P}
-\entry {\code {possible-command-completions (C-x !)}}{102}
-\entry {\code {possible-completions (M-?)}}{101}
-\entry {\code {possible-filename-completions (C-x /)}}{102}
-\entry {\code {possible-hostname-completions (C-x @)}}{102}
-\entry {\code {possible-username-completions (C-x ~)}}{102}
-\entry {\code {possible-variable-completions (C-x $)}}{102}
-\entry {\code {prefix-meta (\key {ESC})}}{103}
-\entry {\code {previous-history (C-p)}}{98}
+\entry {\code {possible-command-completions (C-x !)}}{104}
+\entry {\code {possible-completions (M-?)}}{103}
+\entry {\code {possible-filename-completions (C-x /)}}{104}
+\entry {\code {possible-hostname-completions (C-x @)}}{104}
+\entry {\code {possible-username-completions (C-x ~)}}{104}
+\entry {\code {possible-variable-completions (C-x $)}}{104}
+\entry {\code {prefix-meta (\key {ESC})}}{105}
+\entry {\code {previous-history (C-p)}}{100}
 \initial {Q}
-\entry {\code {quoted-insert (C-q or C-v)}}{99}
+\entry {\code {quoted-insert (C-q or C-v)}}{101}
 \initial {R}
-\entry {\code {re-read-init-file (C-x C-r)}}{103}
-\entry {\code {redraw-current-line ()}}{97}
-\entry {\code {reverse-search-history (C-r)}}{98}
-\entry {\code {revert-line (M-r)}}{103}
+\entry {\code {re-read-init-file (C-x C-r)}}{105}
+\entry {\code {redraw-current-line ()}}{99}
+\entry {\code {reverse-search-history (C-r)}}{100}
+\entry {\code {revert-line (M-r)}}{105}
 \initial {S}
-\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{99}
-\entry {\code {set-mark (C-@)}}{103}
-\entry {\code {shell-expand-line (M-C-e)}}{104}
-\entry {\code {start-kbd-macro (C-x ()}}{102}
+\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{101}
+\entry {\code {set-mark (C-@)}}{105}
+\entry {\code {shell-expand-line (M-C-e)}}{106}
+\entry {\code {start-kbd-macro (C-x ()}}{104}
 \initial {T}
-\entry {\code {tilde-expand (M-&)}}{103}
-\entry {\code {transpose-chars (C-t)}}{99}
-\entry {\code {transpose-words (M-t)}}{99}
+\entry {\code {tilde-expand (M-&)}}{105}
+\entry {\code {transpose-chars (C-t)}}{101}
+\entry {\code {transpose-words (M-t)}}{101}
 \initial {U}
-\entry {\code {undo (C-_ or C-x C-u)}}{103}
-\entry {\code {universal-argument ()}}{101}
-\entry {\code {unix-filename-rubout ()}}{100}
-\entry {\code {unix-line-discard (C-u)}}{100}
-\entry {\code {unix-word-rubout (C-w)}}{100}
-\entry {\code {upcase-word (M-u)}}{99}
+\entry {\code {undo (C-_ or C-x C-u)}}{105}
+\entry {\code {universal-argument ()}}{103}
+\entry {\code {unix-filename-rubout ()}}{102}
+\entry {\code {unix-line-discard (C-u)}}{102}
+\entry {\code {unix-word-rubout (C-w)}}{102}
+\entry {\code {upcase-word (M-u)}}{101}
 \initial {Y}
-\entry {\code {yank (C-y)}}{101}
-\entry {\code {yank-last-arg (M-. or M-_)}}{98}
-\entry {\code {yank-nth-arg (M-C-y)}}{98}
-\entry {\code {yank-pop (M-y)}}{101}
+\entry {\code {yank (C-y)}}{103}
+\entry {\code {yank-last-arg (M-. or M-_)}}{100}
+\entry {\code {yank-nth-arg (M-C-y)}}{100}
+\entry {\code {yank-pop (M-y)}}{103}

doc/bashref.html

@@ -1,6 +1,6 @@
 <HTML>
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<!-- Created on February, 14  2005 by texi2html 1.64 -->
+<!-- Created on February, 22  2005 by texi2html 1.64 -->
 <!-- 
 Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
             Karl Berry  <karl@freefriends.org>
@@ -33,10 +33,10 @@ Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
 <H1>Bash Reference Manual</H1></P><P>
 
 This text is a brief description of the features that are present in
-the Bash shell (version 3.1-devel, 11 February 2005)..
+the Bash shell (version 3.1-devel, 19 February 2005)..
 </P><P>
 
-This is Edition 3.1-devel, last updated 11 February 2005,
+This is Edition 3.1-devel, last updated 19 February 2005,
 of <CITE>The GNU Bash Reference Manual</CITE>,
 for <CODE>Bash</CODE>, Version 3.1-devel.
 </P><P>
@@ -1266,6 +1266,10 @@ The syntax of the <CODE>case</CODE> command is:
 
 <CODE>case</CODE> will selectively execute the <VAR>command-list</VAR> corresponding to
 the first <VAR>pattern</VAR> that matches <VAR>word</VAR>.
+If the shell option <CODE>nocasematch</CODE>
+(see the description of <CODE>shopt</CODE> in <A HREF="bashref.html#SEC58">4.2 Bash Builtin Commands</A>)
+is enabled, the match is performed without regard to the case
+of alphabetic characters.
 The <SAMP>`|'</SAMP> is used to separate multiple patterns, and the <SAMP>`)'</SAMP>
 operator terminates a pattern list.
 A list of patterns and an associated command-list is known
@@ -1376,6 +1380,10 @@ as primaries.
 When the <SAMP>`=='</SAMP> and <SAMP>`!='</SAMP> operators are used, the string to the
 right of the operator is considered a pattern and matched according
 to the rules described below in <A HREF="bashref.html#SEC36">3.5.8.1 Pattern Matching</A>.
+If the shell option <CODE>nocasematch</CODE>
+(see the description of <CODE>shopt</CODE> in <A HREF="bashref.html#SEC58">4.2 Bash Builtin Commands</A>)
+is enabled, the match is performed without regard to the case
+of alphabetic characters.
 The return value is 0 if the string matches or does not match
 the pattern, respectively, and 1 otherwise.
 Any part of the pattern may be quoted to force it to be matched as a
@@ -1390,7 +1398,7 @@ The return value is 0 if the string matches
 the pattern, and 1 otherwise.
 If the regular expression is syntactically incorrect, the conditional
 expression's return value is 2.
-If the shell option <CODE>nocaseglob</CODE>
+If the shell option <CODE>nocasematch</CODE>
 (see the description of <CODE>shopt</CODE> in <A HREF="bashref.html#SEC58">4.2 Bash Builtin Commands</A>)
 is enabled, the match is performed without regard to the case
 of alphabetic characters.
@@ -4792,6 +4800,23 @@ If the command run by the <CODE>DEBUG</CODE> trap returns a value of 2, and the
 shell is executing in a subroutine (a shell function or a shell script
 executed by the <CODE>.</CODE> or <CODE>source</CODE> builtins), a call to
 <CODE>return</CODE> is simulated.
+<P>
+
+<LI>
+<CODE>BASH_ARGC</CODE> and <CODE>BASH_ARGV</CODE> are updated as described in their
+descriptions (see section <A HREF="bashref.html#SEC63">5.2 Bash Variables</A>).
+<P>
+
+<LI>
+Function tracing is enabled:  command substitution, shell functions, and
+subshells invoked with <CODE>( <VAR>command</VAR> )</CODE> inherit the
+<CODE>DEBUG</CODE> and <CODE>RETURN</CODE> traps.
+<P>
+
+<LI>
+Error tracing is enabled:  command substitution, shell functions, and
+subshells invoked with <CODE>( <VAR>command</VAR> )</CODE> inherit the
+<CODE>ERROR</CODE> trap.
 </OL>
 <P>
 
@@ -4891,6 +4916,12 @@ on an empty line.
 performing filename expansion.
 <P>
 
+<DT><CODE>nocasematch</CODE>
+<DD>If set, Bash matches patterns in a case-insensitive fashion when
+performing matching while executing <CODE>case</CODE> or <CODE>[[</CODE>
+conditional commands.
+<P>
+
 <DT><CODE>nullglob</CODE>
 <DD>If set, Bash allows filename patterns which match no
 files to expand to a null string, rather than themselves.
@@ -5650,6 +5681,10 @@ parameters to the current subroutine (shell function or script executed
 with <CODE>.</CODE> or <CODE>source</CODE>) is at the top of the stack.  When a
 subroutine is executed, the number of parameters passed is pushed onto
 <CODE>BASH_ARGC</CODE>.
+The shell sets <CODE>BASH_ARGC</CODE> only when in extended debugging mode
+(see <A HREF="bashref.html#SEC58">4.2 Bash Builtin Commands</A>  
+for a description of the <CODE>extdebug</CODE> option to the <CODE>shopt</CODE>
+builtin).
 <P>
 
 <A NAME="IDX134"></A>
@@ -5660,6 +5695,10 @@ execution call stack.  The final parameter of the last subroutine call
 is at the top of the stack; the first parameter of the initial call is
 at the bottom.  When a subroutine is executed, the parameters supplied
 are pushed onto <CODE>BASH_ARGV</CODE>.
+The shell sets <CODE>BASH_ARGV</CODE> only when in extended debugging mode
+(see <A HREF="bashref.html#SEC58">4.2 Bash Builtin Commands</A>  
+for a description of the <CODE>extdebug</CODE> option to the <CODE>shopt</CODE>
+builtin).
 <P>
 
 <A NAME="IDX136"></A>
@@ -8035,6 +8074,11 @@ does not refer to an existing directory, <CODE>cd</CODE> will fail instead of
 falling back to <VAR>physical</VAR> mode.
 <P>
 
+<LI>
+When the <CODE>pwd</CODE> builtin is supplied the <SAMP>`-P'</SAMP> option, it resets
+<CODE>$PWD</CODE> to a pathname containing no symlinks.
+<P>
+
 <LI>
 When listing the history, the <CODE>fc</CODE> builtin does not include an
 indication of whether or not a history entry has been modified.
@@ -15125,7 +15169,7 @@ to permit their use in free software.
 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="bashref.html#SEC_About"> ? </A>]</TD>
 </TR></TABLE>
 <H1>About this document</H1>
-This document was generated by <I>Chet Ramey</I> on <I>February, 14  2005</I>
+This document was generated by <I>Chet Ramey</I> on <I>February, 22  2005</I>
 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
 "><I>texi2html</I></A>
 <P></P>  
@@ -15287,7 +15331,7 @@ the following structure:
 <BR>  
 <FONT SIZE="-1">
 This document was generated
-by <I>Chet Ramey</I> on <I>February, 14  2005</I>
+by <I>Chet Ramey</I> on <I>February, 22  2005</I>
 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
 "><I>texi2html</I></A>
 

doc/bashref.info

@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 4.7 from
 /Users/chet/src/bash/src/doc/bashref.texi.
 
    This text is a brief description of the features that are present in
-the Bash shell (version 3.1-devel, 11 February 2005).
+the Bash shell (version 3.1-devel, 19 February 2005).
 
-   This is Edition 3.1-devel, last updated 11 February 2005, of `The
+   This is Edition 3.1-devel, last updated 19 February 2005, of `The
 GNU Bash Reference Manual', for `Bash', Version 3.1-devel.
 
    Copyright (C) 1988-2005 Free Software Foundation, Inc.
@@ -37,9 +37,9 @@ Bash Features
 *************
 
 This text is a brief description of the features that are present in
-the Bash shell (version 3.1-devel, 11 February 2005)..
+the Bash shell (version 3.1-devel, 19 February 2005)..
 
-   This is Edition 3.1-devel, last updated 11 February 2005, of `The
+   This is Edition 3.1-devel, last updated 19 February 2005, of `The
 GNU Bash Reference Manual', for `Bash', Version 3.1-devel.
 
    Bash contains features that appear in other popular shells, and some
@@ -770,7 +770,10 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
           `case WORD in [ [(] PATTERN [| PATTERN]...) COMMAND-LIST ;;]... esac'
 
      `case' will selectively execute the COMMAND-LIST corresponding to
-     the first PATTERN that matches WORD.  The `|' is used to separate
+     the first PATTERN that matches WORD.  If the shell option
+     `nocasematch' (see the description of `shopt' in *Note Bash
+     Builtins::) is enabled, the match is performed without regard to
+     the case of alphabetic characters.  The `|' is used to separate
      multiple patterns, and the `)' operator terminates a pattern list.
      A list of patterns and an associated command-list is known as a
      CLAUSE.  Each clause must be terminated with `;;'.  The WORD
@@ -856,8 +859,11 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
 
      When the `==' and `!=' operators are used, the string to the right
      of the operator is considered a pattern and matched according to
-     the rules described below in *Note Pattern Matching::.  The return
-     value is 0 if the string matches or does not match the pattern,
+     the rules described below in *Note Pattern Matching::.  If the
+     shell option `nocasematch' (see the description of `shopt' in
+     *Note Bash Builtins::) is enabled, the match is performed without
+     regard to the case of alphabetic characters.  The return value is
+     0 if the string matches or does not match the pattern,
      respectively, and 1 otherwise.  Any part of the pattern may be
      quoted to force it to be matched as a string.
 
@@ -867,7 +873,7 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
      and matched accordingly (as in regex3)).  The return value is 0 if
      the string matches the pattern, and 1 otherwise.  If the regular
      expression is syntactically incorrect, the conditional
-     expression's return value is 2.  If the shell option `nocaseglob'
+     expression's return value is 2.  If the shell option `nocasematch'
      (see the description of `shopt' in *Note Bash Builtins::) is
      enabled, the match is performed without regard to the case of
      alphabetic characters.  Substrings matched by parenthesized
@@ -3117,6 +3123,17 @@ POSIX 1003.2 standard.
                shell function or a shell script executed by the `.' or
                `source' builtins), a call to `return' is simulated.
 
+            4. `BASH_ARGC' and `BASH_ARGV' are updated as described in
+               their descriptions (*note Bash Variables::).
+
+            5. Function tracing is enabled:  command substitution,
+               shell functions, and subshells invoked with `( COMMAND
+               )' inherit the `DEBUG' and `RETURN' traps.
+
+            6. Error tracing is enabled:  command substitution, shell
+               functions, and subshells invoked with `( COMMAND )'
+               inherit the `ERROR' trap.
+
     `extglob'
           If set, the extended pattern matching features described above
           (*note Pattern Matching::) are enabled.
@@ -3194,6 +3211,11 @@ POSIX 1003.2 standard.
           If set, Bash matches filenames in a case-insensitive fashion
           when performing filename expansion.
 
+    `nocasematch'
+          If set, Bash matches patterns in a case-insensitive fashion
+          when performing matching while executing `case' or `[['
+          conditional commands.
+
     `nullglob'
           If set, Bash allows filename patterns which match no files to
           expand to a null string, rather than themselves.
@@ -3718,14 +3740,19 @@ Variables::).
      parameters to the current subroutine (shell function or script
      executed with `.' or `source') is at the top of the stack.  When a
      subroutine is executed, the number of parameters passed is pushed
-     onto `BASH_ARGC'.
+     onto `BASH_ARGC'.  The shell sets `BASH_ARGC' only when in
+     extended debugging mode (see *Note Bash Builtins:: for a
+     description of the `extdebug' option to the `shopt' builtin).
 
 `BASH_ARGV'
      An array variable containing all of the parameters in the current
      bash execution call stack.  The final parameter of the last
      subroutine call is at the top of the stack; the first parameter of
      the initial call is at the bottom.  When a subroutine is executed,
-     the parameters supplied are pushed onto `BASH_ARGV'.
+     the parameters supplied are pushed onto `BASH_ARGV'.  The shell
+     sets `BASH_ARGV' only when in extended debugging mode (see *Note
+     Bash Builtins:: for a description of the `extdebug' option to the
+     `shopt' builtin).
 
 `BASH_COMMAND'
      The command currently being executed or about to be executed,
@@ -5339,17 +5366,20 @@ startup files.
      argument does not refer to an existing directory, `cd' will fail
      instead of falling back to PHYSICAL mode.
 
- 35. When listing the history, the `fc' builtin does not include an
+ 35. When the `pwd' builtin is supplied the `-P' option, it resets
+     `$PWD' to a pathname containing no symlinks.
+
+ 36. When listing the history, the `fc' builtin does not include an
      indication of whether or not a history entry has been modified.
 
- 36. The default editor used by `fc' is `ed'.
+ 37. The default editor used by `fc' is `ed'.
 
- 37. The `type' and `command' builtins will not report a non-executable
+ 38. The `type' and `command' builtins will not report a non-executable
      file as having been found, though the shell will attempt to
      execute such a file if it is the only so-named file found in
      `$PATH'.
 
- 38. When the `xpg_echo' option is enabled, Bash does not attempt to
+ 39. When the `xpg_echo' option is enabled, Bash does not attempt to
      interpret any arguments to `echo' as options.  Each argument is
      displayed, after escape characters are converted.
 
@@ -8973,7 +9003,7 @@ Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                               (line 200)
 * shopt:                                 Bash Builtins.       (line 385)
-* source:                                Bash Builtins.       (line 600)
+* source:                                Bash Builtins.       (line 616)
 * suspend:                               Job Control Builtins.
                                                               (line  94)
 * test:                                  Bourne Shell Builtins.
@@ -8982,12 +9012,12 @@ Index of Shell Builtin Commands
                                                               (line 276)
 * trap:                                  Bourne Shell Builtins.
                                                               (line 281)
-* type:                                  Bash Builtins.       (line 604)
-* typeset:                               Bash Builtins.       (line 635)
-* ulimit:                                Bash Builtins.       (line 641)
+* type:                                  Bash Builtins.       (line 620)
+* typeset:                               Bash Builtins.       (line 651)
+* ulimit:                                Bash Builtins.       (line 657)
 * umask:                                 Bourne Shell Builtins.
                                                               (line 322)
-* unalias:                               Bash Builtins.       (line 703)
+* unalias:                               Bash Builtins.       (line 719)
 * unset:                                 Bourne Shell Builtins.
                                                               (line 339)
 * wait:                                  Job Control Builtins.
@@ -9004,9 +9034,9 @@ Index of Shell Reserved Words
 
 * !:                                     Pipelines.           (line   8)
 * [[:                                    Conditional Constructs.
-                                                              (line 105)
+                                                              (line 108)
 * ]]:                                    Conditional Constructs.
-                                                              (line 105)
+                                                              (line 108)
 * case:                                  Conditional Constructs.
                                                               (line  28)
 * do:                                    Looping Constructs.  (line  12)
@@ -9026,7 +9056,7 @@ Index of Shell Reserved Words
 * in:                                    Conditional Constructs.
                                                               (line  28)
 * select:                                Conditional Constructs.
-                                                              (line  64)
+                                                              (line  67)
 * then:                                  Conditional Constructs.
                                                               (line   7)
 * time:                                  Pipelines.           (line   8)
@@ -9057,91 +9087,91 @@ Parameter and Variable Index
                                                               (line   6)
 * BASH:                                  Bash Variables.      (line  13)
 * BASH_ARGC:                             Bash Variables.      (line  16)
-* BASH_ARGV:                             Bash Variables.      (line  24)
-* BASH_COMMAND:                          Bash Variables.      (line  31)
-* BASH_ENV:                              Bash Variables.      (line  36)
-* BASH_EXECUTION_STRING:                 Bash Variables.      (line  42)
-* BASH_LINENO:                           Bash Variables.      (line  45)
-* BASH_REMATCH:                          Bash Variables.      (line  53)
-* BASH_SOURCE:                           Bash Variables.      (line  61)
-* BASH_SUBSHELL:                         Bash Variables.      (line  65)
-* BASH_VERSINFO:                         Bash Variables.      (line  69)
-* BASH_VERSION:                          Bash Variables.      (line  93)
+* BASH_ARGV:                             Bash Variables.      (line  26)
+* BASH_COMMAND:                          Bash Variables.      (line  36)
+* BASH_ENV:                              Bash Variables.      (line  41)
+* BASH_EXECUTION_STRING:                 Bash Variables.      (line  47)
+* BASH_LINENO:                           Bash Variables.      (line  50)
+* BASH_REMATCH:                          Bash Variables.      (line  58)
+* BASH_SOURCE:                           Bash Variables.      (line  66)
+* BASH_SUBSHELL:                         Bash Variables.      (line  70)
+* BASH_VERSINFO:                         Bash Variables.      (line  74)
+* BASH_VERSION:                          Bash Variables.      (line  98)
 * bell-style:                            Readline Init File Syntax.
                                                               (line  34)
 * bind-tty-special-chars:                Readline Init File Syntax.
                                                               (line  41)
 * CDPATH:                                Bourne Shell Variables.
                                                               (line   9)
-* COLUMNS:                               Bash Variables.      (line  96)
+* COLUMNS:                               Bash Variables.      (line 101)
 * comment-begin:                         Readline Init File Syntax.
                                                               (line  46)
-* COMP_CWORD:                            Bash Variables.      (line 101)
-* COMP_LINE:                             Bash Variables.      (line 107)
-* COMP_POINT:                            Bash Variables.      (line 112)
-* COMP_WORDBREAKS:                       Bash Variables.      (line 120)
-* COMP_WORDS:                            Bash Variables.      (line 126)
+* COMP_CWORD:                            Bash Variables.      (line 106)
+* COMP_LINE:                             Bash Variables.      (line 112)
+* COMP_POINT:                            Bash Variables.      (line 117)
+* COMP_WORDBREAKS:                       Bash Variables.      (line 125)
+* COMP_WORDS:                            Bash Variables.      (line 131)
 * completion-query-items:                Readline Init File Syntax.
                                                               (line  56)
-* COMPREPLY:                             Bash Variables.      (line 132)
+* COMPREPLY:                             Bash Variables.      (line 137)
 * convert-meta:                          Readline Init File Syntax.
                                                               (line  65)
-* DIRSTACK:                              Bash Variables.      (line 137)
+* DIRSTACK:                              Bash Variables.      (line 142)
 * disable-completion:                    Readline Init File Syntax.
                                                               (line  71)
 * editing-mode:                          Readline Init File Syntax.
                                                               (line  76)
-* EMACS:                                 Bash Variables.      (line 147)
+* EMACS:                                 Bash Variables.      (line 152)
 * enable-keypad:                         Readline Init File Syntax.
                                                               (line  82)
-* EUID:                                  Bash Variables.      (line 152)
+* EUID:                                  Bash Variables.      (line 157)
 * expand-tilde:                          Readline Init File Syntax.
                                                               (line  87)
-* FCEDIT:                                Bash Variables.      (line 156)
-* FIGNORE:                               Bash Variables.      (line 160)
-* FUNCNAME:                              Bash Variables.      (line 166)
-* GLOBIGNORE:                            Bash Variables.      (line 175)
-* GROUPS:                                Bash Variables.      (line 181)
-* histchars:                             Bash Variables.      (line 187)
-* HISTCMD:                               Bash Variables.      (line 202)
-* HISTCONTROL:                           Bash Variables.      (line 207)
-* HISTFILE:                              Bash Variables.      (line 223)
-* HISTFILESIZE:                          Bash Variables.      (line 227)
-* HISTIGNORE:                            Bash Variables.      (line 234)
+* FCEDIT:                                Bash Variables.      (line 161)
+* FIGNORE:                               Bash Variables.      (line 165)
+* FUNCNAME:                              Bash Variables.      (line 171)
+* GLOBIGNORE:                            Bash Variables.      (line 180)
+* GROUPS:                                Bash Variables.      (line 186)
+* histchars:                             Bash Variables.      (line 192)
+* HISTCMD:                               Bash Variables.      (line 207)
+* HISTCONTROL:                           Bash Variables.      (line 212)
+* HISTFILE:                              Bash Variables.      (line 228)
+* HISTFILESIZE:                          Bash Variables.      (line 232)
+* HISTIGNORE:                            Bash Variables.      (line 239)
 * history-preserve-point:                Readline Init File Syntax.
                                                               (line  90)
-* HISTSIZE:                              Bash Variables.      (line 253)
-* HISTTIMEFORMAT:                        Bash Variables.      (line 257)
+* HISTSIZE:                              Bash Variables.      (line 258)
+* HISTTIMEFORMAT:                        Bash Variables.      (line 262)
 * HOME:                                  Bourne Shell Variables.
                                                               (line  13)
 * horizontal-scroll-mode:                Readline Init File Syntax.
                                                               (line  95)
-* HOSTFILE:                              Bash Variables.      (line 264)
-* HOSTNAME:                              Bash Variables.      (line 275)
-* HOSTTYPE:                              Bash Variables.      (line 278)
+* HOSTFILE:                              Bash Variables.      (line 269)
+* HOSTNAME:                              Bash Variables.      (line 280)
+* HOSTTYPE:                              Bash Variables.      (line 283)
 * IFS:                                   Bourne Shell Variables.
                                                               (line  18)
-* IGNOREEOF:                             Bash Variables.      (line 281)
+* IGNOREEOF:                             Bash Variables.      (line 286)
 * input-meta:                            Readline Init File Syntax.
                                                               (line 102)
-* INPUTRC:                               Bash Variables.      (line 291)
+* INPUTRC:                               Bash Variables.      (line 296)
 * isearch-terminators:                   Readline Init File Syntax.
                                                               (line 109)
 * keymap:                                Readline Init File Syntax.
                                                               (line 116)
-* LANG:                                  Bash Variables.      (line 295)
-* LC_ALL:                                Bash Variables.      (line 299)
-* LC_COLLATE:                            Bash Variables.      (line 303)
-* LC_CTYPE:                              Bash Variables.      (line 310)
+* LANG:                                  Bash Variables.      (line 300)
+* LC_ALL:                                Bash Variables.      (line 304)
+* LC_COLLATE:                            Bash Variables.      (line 308)
+* LC_CTYPE:                              Bash Variables.      (line 315)
 * LC_MESSAGES <1>:                       Locale Translation.  (line  11)
-* LC_MESSAGES:                           Bash Variables.      (line 315)
-* LC_NUMERIC:                            Bash Variables.      (line 319)
-* LINENO:                                Bash Variables.      (line 323)
-* LINES:                                 Bash Variables.      (line 327)
-* MACHTYPE:                              Bash Variables.      (line 332)
+* LC_MESSAGES:                           Bash Variables.      (line 320)
+* LC_NUMERIC:                            Bash Variables.      (line 324)
+* LINENO:                                Bash Variables.      (line 328)
+* LINES:                                 Bash Variables.      (line 332)
+* MACHTYPE:                              Bash Variables.      (line 337)
 * MAIL:                                  Bourne Shell Variables.
                                                               (line  22)
-* MAILCHECK:                             Bash Variables.      (line 336)
+* MAILCHECK:                             Bash Variables.      (line 341)
 * MAILPATH:                              Bourne Shell Variables.
                                                               (line  27)
 * mark-modified-lines:                   Readline Init File Syntax.
@@ -9152,45 +9182,45 @@ Parameter and Variable Index
                                                               (line 139)
 * meta-flag:                             Readline Init File Syntax.
                                                               (line 102)
-* OLDPWD:                                Bash Variables.      (line 344)
+* OLDPWD:                                Bash Variables.      (line 349)
 * OPTARG:                                Bourne Shell Variables.
                                                               (line  34)
-* OPTERR:                                Bash Variables.      (line 347)
+* OPTERR:                                Bash Variables.      (line 352)
 * OPTIND:                                Bourne Shell Variables.
                                                               (line  38)
-* OSTYPE:                                Bash Variables.      (line 351)
+* OSTYPE:                                Bash Variables.      (line 356)
 * output-meta:                           Readline Init File Syntax.
                                                               (line 146)
 * page-completions:                      Readline Init File Syntax.
                                                               (line 151)
 * PATH:                                  Bourne Shell Variables.
                                                               (line  42)
-* PIPESTATUS:                            Bash Variables.      (line 354)
-* POSIXLY_CORRECT:                       Bash Variables.      (line 359)
-* PPID:                                  Bash Variables.      (line 368)
-* PROMPT_COMMAND:                        Bash Variables.      (line 372)
+* PIPESTATUS:                            Bash Variables.      (line 359)
+* POSIXLY_CORRECT:                       Bash Variables.      (line 364)
+* PPID:                                  Bash Variables.      (line 373)
+* PROMPT_COMMAND:                        Bash Variables.      (line 377)
 * PS1:                                   Bourne Shell Variables.
                                                               (line  48)
 * PS2:                                   Bourne Shell Variables.
                                                               (line  53)
-* PS3:                                   Bash Variables.      (line 376)
-* PS4:                                   Bash Variables.      (line 381)
-* PWD:                                   Bash Variables.      (line 387)
-* RANDOM:                                Bash Variables.      (line 390)
-* REPLY:                                 Bash Variables.      (line 395)
-* SECONDS:                               Bash Variables.      (line 398)
-* SHELL:                                 Bash Variables.      (line 404)
-* SHELLOPTS:                             Bash Variables.      (line 409)
-* SHLVL:                                 Bash Variables.      (line 418)
+* PS3:                                   Bash Variables.      (line 381)
+* PS4:                                   Bash Variables.      (line 386)
+* PWD:                                   Bash Variables.      (line 392)
+* RANDOM:                                Bash Variables.      (line 395)
+* REPLY:                                 Bash Variables.      (line 400)
+* SECONDS:                               Bash Variables.      (line 403)
+* SHELL:                                 Bash Variables.      (line 409)
+* SHELLOPTS:                             Bash Variables.      (line 414)
+* SHLVL:                                 Bash Variables.      (line 423)
 * show-all-if-ambiguous:                 Readline Init File Syntax.
                                                               (line 161)
 * show-all-if-unmodified:                Readline Init File Syntax.
                                                               (line 167)
 * TEXTDOMAIN:                            Locale Translation.  (line  11)
 * TEXTDOMAINDIR:                         Locale Translation.  (line  11)
-* TIMEFORMAT:                            Bash Variables.      (line 423)
-* TMOUT:                                 Bash Variables.      (line 461)
-* UID:                                   Bash Variables.      (line 473)
+* TIMEFORMAT:                            Bash Variables.      (line 428)
+* TMOUT:                                 Bash Variables.      (line 466)
+* UID:                                   Bash Variables.      (line 478)
 * visible-stats:                         Readline Init File Syntax.
                                                               (line 176)
 
@@ -9480,107 +9510,107 @@ Node: Lists22686
 Node: Compound Commands24317
 Node: Looping Constructs25101
 Node: Conditional Constructs27548
-Node: Command Grouping34615
-Node: Shell Functions36064
-Node: Shell Parameters40354
-Node: Positional Parameters42684
-Node: Special Parameters43584
-Node: Shell Expansions46548
-Node: Brace Expansion48473
-Node: Tilde Expansion50798
-Node: Shell Parameter Expansion53149
-Node: Command Substitution60658
-Node: Arithmetic Expansion61991
-Node: Process Substitution62841
-Node: Word Splitting63891
-Node: Filename Expansion65352
-Node: Pattern Matching67488
-Node: Quote Removal70813
-Node: Redirections71108
-Node: Executing Commands78838
-Node: Simple Command Expansion79513
-Node: Command Search and Execution81443
-Node: Command Execution Environment83449
-Node: Environment86220
-Node: Exit Status87880
-Node: Signals89084
-Node: Shell Scripts91048
-Node: Shell Builtin Commands93566
-Node: Bourne Shell Builtins95145
-Node: Bash Builtins112098
-Node: The Set Builtin140238
-Node: Special Builtins148645
-Node: Shell Variables149622
-Node: Bourne Shell Variables150062
-Node: Bash Variables152043
-Node: Bash Features171750
-Node: Invoking Bash172633
-Node: Bash Startup Files178454
-Node: Interactive Shells183312
-Node: What is an Interactive Shell?183722
-Node: Is this Shell Interactive?184372
-Node: Interactive Shell Behavior185187
-Node: Bash Conditional Expressions188463
-Node: Shell Arithmetic192042
-Node: Aliases194788
-Node: Arrays197356
-Node: The Directory Stack200623
-Node: Directory Stack Builtins201337
-Node: Printing a Prompt204228
-Node: The Restricted Shell206942
-Node: Bash POSIX Mode208774
-Node: Job Control216107
-Node: Job Control Basics216574
-Node: Job Control Builtins220950
-Node: Job Control Variables225302
-Node: Command Line Editing226460
-Node: Introduction and Notation227459
-Node: Readline Interaction229081
-Node: Readline Bare Essentials230272
-Node: Readline Movement Commands232061
-Node: Readline Killing Commands233026
-Node: Readline Arguments234946
-Node: Searching235990
-Node: Readline Init File238176
-Node: Readline Init File Syntax239235
-Node: Conditional Init Constructs251094
-Node: Sample Init File253627
-Node: Bindable Readline Commands256744
-Node: Commands For Moving257951
-Node: Commands For History258812
-Node: Commands For Text261967
-Node: Commands For Killing264640
-Node: Numeric Arguments266782
-Node: Commands For Completion267921
-Node: Keyboard Macros271514
-Node: Miscellaneous Commands272085
-Node: Readline vi Mode277396
-Node: Programmable Completion278310
-Node: Programmable Completion Builtins284102
-Node: Using History Interactively291698
-Node: Bash History Facilities292378
-Node: Bash History Builtins295073
-Node: History Interaction298930
-Node: Event Designators301486
-Node: Word Designators302501
-Node: Modifiers304140
-Node: Installing Bash305546
-Node: Basic Installation306683
-Node: Compilers and Options309375
-Node: Compiling For Multiple Architectures310116
-Node: Installation Names311780
-Node: Specifying the System Type312598
-Node: Sharing Defaults313314
-Node: Operation Controls313987
-Node: Optional Features314945
-Node: Reporting Bugs323754
-Node: Major Differences From The Bourne Shell324948
-Node: Copying This Manual340856
-Node: GNU Free Documentation License341132
-Node: Builtin Index363538
-Node: Reserved Word Index370087
-Node: Variable Index372523
-Node: Function Index383383
-Node: Concept Index390103
+Node: Command Grouping35008
+Node: Shell Functions36457
+Node: Shell Parameters40747
+Node: Positional Parameters43077
+Node: Special Parameters43977
+Node: Shell Expansions46941
+Node: Brace Expansion48866
+Node: Tilde Expansion51191
+Node: Shell Parameter Expansion53542
+Node: Command Substitution61051
+Node: Arithmetic Expansion62384
+Node: Process Substitution63234
+Node: Word Splitting64284
+Node: Filename Expansion65745
+Node: Pattern Matching67881
+Node: Quote Removal71206
+Node: Redirections71501
+Node: Executing Commands79231
+Node: Simple Command Expansion79906
+Node: Command Search and Execution81836
+Node: Command Execution Environment83842
+Node: Environment86613
+Node: Exit Status88273
+Node: Signals89477
+Node: Shell Scripts91441
+Node: Shell Builtin Commands93959
+Node: Bourne Shell Builtins95538
+Node: Bash Builtins112491
+Node: The Set Builtin141325
+Node: Special Builtins149732
+Node: Shell Variables150709
+Node: Bourne Shell Variables151149
+Node: Bash Variables153130
+Node: Bash Features173182
+Node: Invoking Bash174065
+Node: Bash Startup Files179886
+Node: Interactive Shells184744
+Node: What is an Interactive Shell?185154
+Node: Is this Shell Interactive?185804
+Node: Interactive Shell Behavior186619
+Node: Bash Conditional Expressions189895
+Node: Shell Arithmetic193474
+Node: Aliases196220
+Node: Arrays198788
+Node: The Directory Stack202055
+Node: Directory Stack Builtins202769
+Node: Printing a Prompt205660
+Node: The Restricted Shell208374
+Node: Bash POSIX Mode210206
+Node: Job Control217657
+Node: Job Control Basics218124
+Node: Job Control Builtins222500
+Node: Job Control Variables226852
+Node: Command Line Editing228010
+Node: Introduction and Notation229009
+Node: Readline Interaction230631
+Node: Readline Bare Essentials231822
+Node: Readline Movement Commands233611
+Node: Readline Killing Commands234576
+Node: Readline Arguments236496
+Node: Searching237540
+Node: Readline Init File239726
+Node: Readline Init File Syntax240785
+Node: Conditional Init Constructs252644
+Node: Sample Init File255177
+Node: Bindable Readline Commands258294
+Node: Commands For Moving259501
+Node: Commands For History260362
+Node: Commands For Text263517
+Node: Commands For Killing266190
+Node: Numeric Arguments268332
+Node: Commands For Completion269471
+Node: Keyboard Macros273064
+Node: Miscellaneous Commands273635
+Node: Readline vi Mode278946
+Node: Programmable Completion279860
+Node: Programmable Completion Builtins285652
+Node: Using History Interactively293248
+Node: Bash History Facilities293928
+Node: Bash History Builtins296623
+Node: History Interaction300480
+Node: Event Designators303036
+Node: Word Designators304051
+Node: Modifiers305690
+Node: Installing Bash307096
+Node: Basic Installation308233
+Node: Compilers and Options310925
+Node: Compiling For Multiple Architectures311666
+Node: Installation Names313330
+Node: Specifying the System Type314148
+Node: Sharing Defaults314864
+Node: Operation Controls315537
+Node: Optional Features316495
+Node: Reporting Bugs325304
+Node: Major Differences From The Bourne Shell326498
+Node: Copying This Manual342406
+Node: GNU Free Documentation License342682
+Node: Builtin Index365088
+Node: Reserved Word Index371637
+Node: Variable Index374073
+Node: Function Index384933
+Node: Concept Index391653
 
 End Tag Table

doc/bashref.log

@@ -1,4 +1,4 @@
-This is TeX, Version 3.14159 (Web2C 7.4.5) (format=tex 2003.12.31)  14 FEB 2005 11:56
+This is TeX, Version 3.14159 (Web2C 7.4.5) (format=tex 2003.12.31)  22 FEB 2005 13:44
 **/Users/chet/src/bash/src/doc/bashref.texi
 (/Users/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
 Loading texinfo [version 2003-02-03.16]: Basics,
@@ -172,7 +172,7 @@ textttsl pat-tern@texttt ][]) @textttsl command-list @texttt ;;][] esac[][]
 
 [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23] [24] [25]
 [26] [27] [28] [29] [30] [31] Chapter 4 [32] [33] [34] [35] [36] [37] [38]
-Underfull \hbox (badness 5231) in paragraph at lines 3133--3146
+Underfull \hbox (badness 5231) in paragraph at lines 3141--3154
  @texttt emacs-meta[]@textrm , @texttt emacs-ctlx[]@textrm , @texttt vi[]@textr
 m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
 
@@ -185,7 +185,7 @@ m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
 .etc.
 
 [39] [40] [41] [42] [43]
-Overfull \hbox (43.33536pt too wide) in paragraph at lines 3471--3471
+Overfull \hbox (43.33536pt too wide) in paragraph at lines 3479--3479
  []@texttt read [-ers] [-a @textttsl aname@texttt ] [-d @textttsl de-lim@texttt
  ] [-n @textttsl nchars@texttt ] [-p @textttsl prompt@texttt ] [-t @textttsl ti
 me-
@@ -198,8 +198,24 @@ me-
 .@texttt a
 .etc.
 
-[44] [45] [46] [47] [48] [49] [50] [51]
-Underfull \hbox (badness 4036) in paragraph at lines 4083--4090
+[44] [45]
+Underfull \hbox (badness 2573) in paragraph at lines 3663--3667
+ [] []@textrm Error trac-ing is en-abled: com-mand sub-sti-tu-tion, shell
+
+@hbox(7.60416+2.12917)x433.62, glue set 2.95305
+.@glue(@leftskip) 137.31363
+.@hbox(0.0+0.0)x0.0
+.@glue 0.0
+.@hbox(7.05666+0.0)x0.0, glue set - 15.74411fil
+..@glue 0.0 plus 1.0fil minus 1.0fil
+..@textrm 6
+..@textrm .
+..@glue 7.22743
+.@textrm E
+.etc.
+
+[46] [47] [48] [49] [50] [51]
+Underfull \hbox (badness 4036) in paragraph at lines 4110--4117
  @texttt -x[]@textrm Print a trace of sim-ple com-mands, @texttt \@textrm fB-fo
 r@texttt \@textrm fP com-mands,
 
@@ -211,8 +227,9 @@ r@texttt \@textrm fP com-mands,
 .@texttt x
 .etc.
 
-[52] [53] Chapter 5 [54] [55] [56] [57] [58] [59] [60] [61] Chapter 6 [62]
-Overfull \hbox (51.96864pt too wide) in paragraph at lines 4802--4802
+[52] [53] Chapter 5 [54] [55] [56] [57] [58] [59] [60] [61] [62] Chapter 6
+[63] [64]
+Overfull \hbox (51.96864pt too wide) in paragraph at lines 4837--4837
  []@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
 exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 
@@ -225,7 +242,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 .etc.
 
 
-Overfull \hbox (76.23077pt too wide) in paragraph at lines 4803--4803
+Overfull \hbox (76.23077pt too wide) in paragraph at lines 4838--4838
  []@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt 
 ] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
 -
@@ -239,7 +256,7 @@ Overfull \hbox (76.23077pt too wide) in paragraph at lines 4803--4803
 .etc.
 
 
-Overfull \hbox (34.72258pt too wide) in paragraph at lines 4804--4804
+Overfull \hbox (34.72258pt too wide) in paragraph at lines 4839--4839
  []@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
 tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 
@@ -251,8 +268,8 @@ tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 .@texttt s
 .etc.
 
-[63] [64]
-Underfull \hbox (badness 2245) in paragraph at lines 4978--4980
+[65] [66]
+Underfull \hbox (badness 2245) in paragraph at lines 5013--5015
 []@textrm When a lo-gin shell ex-its, Bash reads and ex-e-cutes com-mands from 
 the file
 
@@ -264,10 +281,10 @@ the file
 .@textrm n
 .etc.
 
-[65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78]
-Chapter 7 [79] [80] [81] [82] [83]
-(/Users/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [84] [85]
-[86] [87] [88] [89]
+[67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80]
+Chapter 7 [81] [82] [83] [84] [85]
+(/Users/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [86] [87]
+[88] [89] [90] [91]
 Underfull \hbox (badness 5231) in paragraph at lines 494--510
  @texttt emacs-meta[]@textrm , @texttt emacs-ctlx[]@textrm , @texttt vi[]@textr
 m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
@@ -280,7 +297,7 @@ m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and
 .@texttt c
 .etc.
 
-[90] [91] [92] [93] [94]
+[92] [93] [94] [95] [96]
 Overfull \hbox (26.43913pt too wide) in paragraph at lines 807--807
  []@texttt Meta-Control-h: backward-kill-word Text after the function name is i
 gnored[] 
@@ -293,7 +310,7 @@ gnored[]
 .@texttt t
 .etc.
 
-[95] [96] [97] [98] [99] [100] [101] [102] [103] [104] [105] [106]
+[97] [98] [99] [100] [101] [102] [103] [104] [105] [106] [107] [108]
 Overfull \hbox (17.80585pt too wide) in paragraph at lines 1656--1656
  []@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-A @tex
 tttsl ac-tion@texttt ] [-G @textttsl glob-
@@ -306,7 +323,7 @@ tttsl ac-tion@texttt ] [-G @textttsl glob-
 .@texttt m
 .etc.
 
-[107] [108]
+[109] [110]
 Underfull \hbox (badness 2753) in paragraph at lines 1758--1761
  @texttt hostname[]@textrm Hostnames, as taken from the file spec-i-fied by
 
@@ -318,9 +335,9 @@ Underfull \hbox (badness 2753) in paragraph at lines 1758--1761
 .@texttt o
 .etc.
 
-[109]) (/Users/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
-[110] [111] [112] [113] [114]) Chapter 10 [115] [116] [117] [118] [119]
-Underfull \hbox (badness 2772) in paragraph at lines 6676--6680
+[111]) (/Users/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
+[112] [113] [114] [115] [116]) Chapter 10 [117] [118] [119] [120] [121]
+Underfull \hbox (badness 2772) in paragraph at lines 6715--6719
  []@textrm Enable sup-port for large files (@texttt http://www.sas.com/standard
 s/large_
 
@@ -332,9 +349,9 @@ s/large_
 .@textrm a
 .etc.
 
-[120] [121] [122] Appendix A [123] [124] Appendix B [125] [126] [127] [128]
-[129] [130] Appendix C [131] [132] (./fdl.texi [133] [134] [135] [136] [137]
-[138]) (Index of Shell Builtin Commands) [139] [140] (./bashref.bts)
+[122] [123] [124] Appendix A [125] [126] Appendix B [127] [128] [129] [130]
+[131] [132] Appendix C [133] [134] (./fdl.texi [135] [136] [137] [138] [139]
+[140]) (Index of Shell Builtin Commands) [141] [142] (./bashref.bts)
 (Index of Shell Reserved Words)
 Overfull \vbox (42.26959pt too high) has occurred while \output is active
 \vbox(643.19986+0.0)x433.62, glue set - 1.0
@@ -353,16 +370,16 @@ Overfull \vbox (42.26959pt too high) has occurred while \output is active
 .etc.
 
 
-[141] [142] (./bashref.rws) (Parameter and Variable Index) [143] [144]
-(./bashref.vrs [145]) (Function Index) [146] (./bashref.fns [147])
-(Concept Index) [148] (./bashref.cps [149]) [150] ) 
+[143] [144] (./bashref.rws) (Parameter and Variable Index) [145] [146]
+(./bashref.vrs [147]) (Function Index) [148] (./bashref.fns [149])
+(Concept Index) [150] (./bashref.cps [151]) [152] ) 
 Here is how much of TeX's memory you used:
  1726 strings out of 98002
  23501 string characters out of 1221986
- 52385 words of memory out of 1000001
+ 52386 words of memory out of 1000001
  2577 multiletter control sequences out of 10000+50000
  31953 words of font info for 111 fonts, out of 500000 for 1000
  19 hyphenation exceptions out of 1000
  15i,8n,11p,269b,465s stack positions out of 1500i,500n,5000p,200000b,5000s
 
-Output written on bashref.dvi (156 pages, 585568 bytes).
+Output written on bashref.dvi (158 pages, 587400 bytes).

doc/bashref.rw

@@ -18,4 +18,4 @@
 \entry{]]}{12}{\code {]]}}
 \entry{{\tt \char 123}}{13}{\code {{\tt \char 123}}}
 \entry{{\tt \char 125}}{13}{\code {{\tt \char 125}}}
-\entry{function}{13}{\code {function}}
+\entry{function}{14}{\code {function}}

doc/bashref.rws

@@ -20,7 +20,7 @@
 \initial {F}
 \entry {\code {fi}}{10}
 \entry {\code {for}}{10}
-\entry {\code {function}}{13}
+\entry {\code {function}}{14}
 \initial {I}
 \entry {\code {if}}{10}
 \entry {\code {in}}{11}

doc/bashref.texi

@@ -5924,7 +5924,8 @@ is stopped is `Stopped(@var{signame})', where @var{signame} is, for
 example, @code{SIGTSTP}.
 
 @item
-Reserved words may not be aliased.
+Reserved words appearing in a context where reserved words are recognized
+do not undergo alias expansion.
 
 @item
 The @sc{posix} 1003.2 @env{PS1} and @env{PS2} expansions of @samp{!} to
@@ -5985,12 +5986,6 @@ the POSIX.2 standard, and include things like passing incorrect options,
 redirection errors, variable assignment errors for assignments preceding
 the command name, and so on.
 
-@item
-If the @code{cd} builtin finds a directory to change to
-using @env{$CDPATH}, the
-value it assigns to the @env{PWD} variable does not contain any
-symbolic links, as if @samp{cd -P} had been executed.
-
 @item
 If @env{CDPATH} is set, the @code{cd} builtin will not implicitly
 append the current directory to it.  This means that @code{cd} will
@@ -6072,7 +6067,7 @@ does not refer to an existing directory, @code{cd} will fail instead of
 falling back to @var{physical} mode.
 
 @item
-When the @code{pwd} builtin is supplied the @opt{-P} option, it resets
+When the @code{pwd} builtin is supplied the @option{-P} option, it resets
 @code{$PWD} to a pathname containing no symlinks.
 
 @item

doc/bashref.toc

@@ -21,18 +21,18 @@
 \subsubsecentry{Conditional Constructs}{3}{2}{4}{2}{10}
 \subsubsecentry{Grouping Commands}{3}{2}{4}{3}{13}
 \secentry{Shell Functions}{3}{3}{13}
-\secentry{Shell Parameters}{3}{4}{14}
+\secentry{Shell Parameters}{3}{4}{15}
 \subsecentry{Positional Parameters}{3}{4}{1}{15}
-\subsecentry{Special Parameters}{3}{4}{2}{15}
-\secentry{Shell Expansions}{3}{5}{16}
+\subsecentry{Special Parameters}{3}{4}{2}{16}
+\secentry{Shell Expansions}{3}{5}{17}
 \subsecentry{Brace Expansion}{3}{5}{1}{17}
 \subsecentry{Tilde Expansion}{3}{5}{2}{18}
-\subsecentry{Shell Parameter Expansion}{3}{5}{3}{18}
+\subsecentry{Shell Parameter Expansion}{3}{5}{3}{19}
 \subsecentry{Command Substitution}{3}{5}{4}{21}
-\subsecentry{Arithmetic Expansion}{3}{5}{5}{21}
+\subsecentry{Arithmetic Expansion}{3}{5}{5}{22}
 \subsecentry{Process Substitution}{3}{5}{6}{22}
 \subsecentry{Word Splitting}{3}{5}{7}{22}
-\subsecentry{Filename Expansion}{3}{5}{8}{22}
+\subsecentry{Filename Expansion}{3}{5}{8}{23}
 \subsubsecentry{Pattern Matching}{3}{5}{8}{1}{23}
 \subsecentry{Quote Removal}{3}{5}{9}{24}
 \secentry{Redirections}{3}{6}{24}
@@ -47,7 +47,7 @@
 \subsecentry{Opening File Descriptors for Reading and Writing}{3}{6}{9}{28}
 \secentry{Executing Commands}{3}{7}{28}
 \subsecentry{Simple Command Expansion}{3}{7}{1}{28}
-\subsecentry{Command Search and Execution}{3}{7}{2}{28}
+\subsecentry{Command Search and Execution}{3}{7}{2}{29}
 \subsecentry{Command Execution Environment}{3}{7}{3}{29}
 \subsecentry{Environment}{3}{7}{4}{30}
 \subsecentry{Exit Status}{3}{7}{5}{31}
@@ -57,78 +57,78 @@
 \secentry{Bourne Shell Builtins}{4}{1}{33}
 \secentry{Bash Builtin Commands}{4}{2}{39}
 \secentry{The Set Builtin}{4}{3}{50}
-\secentry{Special Builtins}{4}{4}{53}
+\secentry{Special Builtins}{4}{4}{54}
 \chapentry{Shell Variables}{5}{55}
 \secentry{Bourne Shell Variables}{5}{1}{55}
 \secentry{Bash Variables}{5}{2}{55}
-\chapentry{Bash Features}{6}{63}
-\secentry{Invoking Bash}{6}{1}{63}
-\secentry{Bash Startup Files}{6}{2}{65}
-\secentry{Interactive Shells}{6}{3}{67}
-\subsecentry{What is an Interactive Shell?}{6}{3}{1}{67}
-\subsecentry{Is this Shell Interactive?}{6}{3}{2}{67}
-\subsecentry{Interactive Shell Behavior}{6}{3}{3}{67}
-\secentry{Bash Conditional Expressions}{6}{4}{68}
-\secentry{Shell Arithmetic}{6}{5}{70}
-\secentry{Aliases}{6}{6}{71}
-\secentry{Arrays}{6}{7}{72}
-\secentry{The Directory Stack}{6}{8}{73}
-\subsecentry{Directory Stack Builtins}{6}{8}{1}{73}
-\secentry{Controlling the Prompt}{6}{9}{74}
-\secentry{The Restricted Shell}{6}{10}{76}
-\secentry{Bash POSIX Mode}{6}{11}{76}
-\chapentry{Job Control}{7}{81}
-\secentry{Job Control Basics}{7}{1}{81}
-\secentry{Job Control Builtins}{7}{2}{82}
-\secentry{Job Control Variables}{7}{3}{83}
-\chapentry{Command Line Editing}{8}{85}
-\secentry{Introduction to Line Editing}{8}{1}{85}
-\secentry{Readline Interaction}{8}{2}{85}
-\subsecentry{Readline Bare Essentials}{8}{2}{1}{85}
-\subsecentry{Readline Movement Commands}{8}{2}{2}{86}
-\subsecentry{Readline Killing Commands}{8}{2}{3}{86}
-\subsecentry{Readline Arguments}{8}{2}{4}{87}
-\subsecentry{Searching for Commands in the History}{8}{2}{5}{87}
-\secentry{Readline Init File}{8}{3}{88}
-\subsecentry{Readline Init File Syntax}{8}{3}{1}{88}
-\subsecentry{Conditional Init Constructs}{8}{3}{2}{93}
-\subsecentry{Sample Init File}{8}{3}{3}{94}
-\secentry{Bindable Readline Commands}{8}{4}{97}
-\subsecentry{Commands For Moving}{8}{4}{1}{97}
-\subsecentry{Commands For Manipulating The History}{8}{4}{2}{97}
-\subsecentry{Commands For Changing Text}{8}{4}{3}{99}
-\subsecentry{Killing And Yanking}{8}{4}{4}{100}
-\subsecentry{Specifying Numeric Arguments}{8}{4}{5}{101}
-\subsecentry{Letting Readline Type For You}{8}{4}{6}{101}
-\subsecentry{Keyboard Macros}{8}{4}{7}{102}
-\subsecentry{Some Miscellaneous Commands}{8}{4}{8}{103}
-\secentry{Readline vi Mode}{8}{5}{105}
-\secentry{Programmable Completion}{8}{6}{105}
-\secentry{Programmable Completion Builtins}{8}{7}{107}
-\chapentry{Using History Interactively}{9}{111}
-\secentry{Bash History Facilities}{9}{1}{111}
-\secentry{Bash History Builtins}{9}{2}{111}
-\secentry{History Expansion}{9}{3}{113}
-\subsecentry{Event Designators}{9}{3}{1}{113}
-\subsecentry{Word Designators}{9}{3}{2}{114}
-\subsecentry{Modifiers}{9}{3}{3}{115}
-\chapentry{Installing Bash}{10}{117}
-\secentry{Basic Installation}{10}{1}{117}
-\secentry{Compilers and Options}{10}{2}{117}
-\secentry{Compiling For Multiple Architectures}{10}{3}{118}
-\secentry{Installation Names}{10}{4}{118}
-\secentry{Specifying the System Type}{10}{5}{118}
-\secentry{Sharing Defaults}{10}{6}{119}
-\secentry{Operation Controls}{10}{7}{119}
-\secentry{Optional Features}{10}{8}{119}
-\appendixentry{Reporting Bugs}{A}{125}
-\appendixentry{Major Differences From The Bourne Shell}{B}{127}
-\secentry{Implementation Differences From The SVR4.2 Shell}{B}{1}{131}
-\appendixentry{Copying This Manual}{C}{133}
-\secentry{GNU Free Documentation License}{C}{1}{133}
-\subsecentry{ADDENDUM: How to use this License for your documents}{C}{1}{1}{139}
-\unnumbchapentry{Index of Shell Builtin Commands}{10}{141}
-\unnumbchapentry{Index of Shell Reserved Words}{10}{143}
-\unnumbchapentry{Parameter and Variable Index}{10}{145}
-\unnumbchapentry{Function Index}{10}{147}
-\unnumbchapentry{Concept Index}{10}{149}
+\chapentry{Bash Features}{6}{65}
+\secentry{Invoking Bash}{6}{1}{65}
+\secentry{Bash Startup Files}{6}{2}{67}
+\secentry{Interactive Shells}{6}{3}{69}
+\subsecentry{What is an Interactive Shell?}{6}{3}{1}{69}
+\subsecentry{Is this Shell Interactive?}{6}{3}{2}{69}
+\subsecentry{Interactive Shell Behavior}{6}{3}{3}{69}
+\secentry{Bash Conditional Expressions}{6}{4}{70}
+\secentry{Shell Arithmetic}{6}{5}{72}
+\secentry{Aliases}{6}{6}{73}
+\secentry{Arrays}{6}{7}{74}
+\secentry{The Directory Stack}{6}{8}{75}
+\subsecentry{Directory Stack Builtins}{6}{8}{1}{75}
+\secentry{Controlling the Prompt}{6}{9}{76}
+\secentry{The Restricted Shell}{6}{10}{78}
+\secentry{Bash POSIX Mode}{6}{11}{78}
+\chapentry{Job Control}{7}{83}
+\secentry{Job Control Basics}{7}{1}{83}
+\secentry{Job Control Builtins}{7}{2}{84}
+\secentry{Job Control Variables}{7}{3}{85}
+\chapentry{Command Line Editing}{8}{87}
+\secentry{Introduction to Line Editing}{8}{1}{87}
+\secentry{Readline Interaction}{8}{2}{87}
+\subsecentry{Readline Bare Essentials}{8}{2}{1}{87}
+\subsecentry{Readline Movement Commands}{8}{2}{2}{88}
+\subsecentry{Readline Killing Commands}{8}{2}{3}{88}
+\subsecentry{Readline Arguments}{8}{2}{4}{89}
+\subsecentry{Searching for Commands in the History}{8}{2}{5}{89}
+\secentry{Readline Init File}{8}{3}{90}
+\subsecentry{Readline Init File Syntax}{8}{3}{1}{90}
+\subsecentry{Conditional Init Constructs}{8}{3}{2}{95}
+\subsecentry{Sample Init File}{8}{3}{3}{96}
+\secentry{Bindable Readline Commands}{8}{4}{99}
+\subsecentry{Commands For Moving}{8}{4}{1}{99}
+\subsecentry{Commands For Manipulating The History}{8}{4}{2}{99}
+\subsecentry{Commands For Changing Text}{8}{4}{3}{101}
+\subsecentry{Killing And Yanking}{8}{4}{4}{102}
+\subsecentry{Specifying Numeric Arguments}{8}{4}{5}{103}
+\subsecentry{Letting Readline Type For You}{8}{4}{6}{103}
+\subsecentry{Keyboard Macros}{8}{4}{7}{104}
+\subsecentry{Some Miscellaneous Commands}{8}{4}{8}{105}
+\secentry{Readline vi Mode}{8}{5}{107}
+\secentry{Programmable Completion}{8}{6}{107}
+\secentry{Programmable Completion Builtins}{8}{7}{109}
+\chapentry{Using History Interactively}{9}{113}
+\secentry{Bash History Facilities}{9}{1}{113}
+\secentry{Bash History Builtins}{9}{2}{113}
+\secentry{History Expansion}{9}{3}{115}
+\subsecentry{Event Designators}{9}{3}{1}{115}
+\subsecentry{Word Designators}{9}{3}{2}{116}
+\subsecentry{Modifiers}{9}{3}{3}{117}
+\chapentry{Installing Bash}{10}{119}
+\secentry{Basic Installation}{10}{1}{119}
+\secentry{Compilers and Options}{10}{2}{119}
+\secentry{Compiling For Multiple Architectures}{10}{3}{120}
+\secentry{Installation Names}{10}{4}{120}
+\secentry{Specifying the System Type}{10}{5}{120}
+\secentry{Sharing Defaults}{10}{6}{121}
+\secentry{Operation Controls}{10}{7}{121}
+\secentry{Optional Features}{10}{8}{121}
+\appendixentry{Reporting Bugs}{A}{127}
+\appendixentry{Major Differences From The Bourne Shell}{B}{129}
+\secentry{Implementation Differences From The SVR4.2 Shell}{B}{1}{133}
+\appendixentry{Copying This Manual}{C}{135}
+\secentry{GNU Free Documentation License}{C}{1}{135}
+\subsecentry{ADDENDUM: How to use this License for your documents}{C}{1}{1}{141}
+\unnumbchapentry{Index of Shell Builtin Commands}{10}{143}
+\unnumbchapentry{Index of Shell Reserved Words}{10}{145}
+\unnumbchapentry{Parameter and Variable Index}{10}{147}
+\unnumbchapentry{Function Index}{10}{149}
+\unnumbchapentry{Concept Index}{10}{151}

doc/bashref.vr

@@ -55,7 +55,7 @@
 \entry{HISTIGNORE}{59}{\code {HISTIGNORE}}
 \entry{HISTSIZE}{59}{\code {HISTSIZE}}
 \entry{HISTTIMEFORMAT}{59}{\code {HISTTIMEFORMAT}}
-\entry{HOSTFILE}{59}{\code {HOSTFILE}}
+\entry{HOSTFILE}{60}{\code {HOSTFILE}}
 \entry{HOSTNAME}{60}{\code {HOSTNAME}}
 \entry{HOSTTYPE}{60}{\code {HOSTTYPE}}
 \entry{IGNOREEOF}{60}{\code {IGNOREEOF}}
@@ -67,8 +67,8 @@
 \entry{LC_MESSAGES}{60}{\code {LC_MESSAGES}}
 \entry{LC_NUMERIC}{60}{\code {LC_NUMERIC}}
 \entry{LINENO}{60}{\code {LINENO}}
-\entry{LINES}{60}{\code {LINES}}
-\entry{MACHTYPE}{60}{\code {MACHTYPE}}
+\entry{LINES}{61}{\code {LINES}}
+\entry{MACHTYPE}{61}{\code {MACHTYPE}}
 \entry{MAILCHECK}{61}{\code {MAILCHECK}}
 \entry{OLDPWD}{61}{\code {OLDPWD}}
 \entry{OPTERR}{61}{\code {OPTERR}}
@@ -82,34 +82,34 @@
 \entry{PWD}{61}{\code {PWD}}
 \entry{RANDOM}{61}{\code {RANDOM}}
 \entry{REPLY}{61}{\code {REPLY}}
-\entry{SECONDS}{61}{\code {SECONDS}}
+\entry{SECONDS}{62}{\code {SECONDS}}
 \entry{SHELL}{62}{\code {SHELL}}
 \entry{SHELLOPTS}{62}{\code {SHELLOPTS}}
 \entry{SHLVL}{62}{\code {SHLVL}}
 \entry{TIMEFORMAT}{62}{\code {TIMEFORMAT}}
 \entry{TMOUT}{62}{\code {TMOUT}}
-\entry{UID}{62}{\code {UID}}
-\entry{auto_resume}{84}{\code {auto_resume}}
-\entry{bell-style}{89}{\code {bell-style}}
-\entry{bind-tty-special-chars}{89}{\code {bind-tty-special-chars}}
-\entry{comment-begin}{89}{\code {comment-begin}}
-\entry{completion-query-items}{89}{\code {completion-query-items}}
-\entry{convert-meta}{89}{\code {convert-meta}}
-\entry{disable-completion}{90}{\code {disable-completion}}
-\entry{editing-mode}{90}{\code {editing-mode}}
-\entry{enable-keypad}{90}{\code {enable-keypad}}
-\entry{expand-tilde}{90}{\code {expand-tilde}}
-\entry{history-preserve-point}{90}{\code {history-preserve-point}}
-\entry{horizontal-scroll-mode}{90}{\code {horizontal-scroll-mode}}
-\entry{input-meta}{90}{\code {input-meta}}
-\entry{meta-flag}{90}{\code {meta-flag}}
-\entry{isearch-terminators}{90}{\code {isearch-terminators}}
-\entry{keymap}{90}{\code {keymap}}
-\entry{mark-modified-lines}{91}{\code {mark-modified-lines}}
-\entry{mark-symlinked-directories}{91}{\code {mark-symlinked-directories}}
-\entry{match-hidden-files}{91}{\code {match-hidden-files}}
-\entry{output-meta}{91}{\code {output-meta}}
-\entry{page-completions}{91}{\code {page-completions}}
-\entry{show-all-if-ambiguous}{91}{\code {show-all-if-ambiguous}}
-\entry{show-all-if-unmodified}{91}{\code {show-all-if-unmodified}}
-\entry{visible-stats}{91}{\code {visible-stats}}
+\entry{UID}{63}{\code {UID}}
+\entry{auto_resume}{86}{\code {auto_resume}}
+\entry{bell-style}{91}{\code {bell-style}}
+\entry{bind-tty-special-chars}{91}{\code {bind-tty-special-chars}}
+\entry{comment-begin}{91}{\code {comment-begin}}
+\entry{completion-query-items}{91}{\code {completion-query-items}}
+\entry{convert-meta}{91}{\code {convert-meta}}
+\entry{disable-completion}{92}{\code {disable-completion}}
+\entry{editing-mode}{92}{\code {editing-mode}}
+\entry{enable-keypad}{92}{\code {enable-keypad}}
+\entry{expand-tilde}{92}{\code {expand-tilde}}
+\entry{history-preserve-point}{92}{\code {history-preserve-point}}
+\entry{horizontal-scroll-mode}{92}{\code {horizontal-scroll-mode}}
+\entry{input-meta}{92}{\code {input-meta}}
+\entry{meta-flag}{92}{\code {meta-flag}}
+\entry{isearch-terminators}{92}{\code {isearch-terminators}}
+\entry{keymap}{92}{\code {keymap}}
+\entry{mark-modified-lines}{93}{\code {mark-modified-lines}}
+\entry{mark-symlinked-directories}{93}{\code {mark-symlinked-directories}}
+\entry{match-hidden-files}{93}{\code {match-hidden-files}}
+\entry{output-meta}{93}{\code {output-meta}}
+\entry{page-completions}{93}{\code {page-completions}}
+\entry{show-all-if-ambiguous}{93}{\code {show-all-if-ambiguous}}
+\entry{show-all-if-unmodified}{93}{\code {show-all-if-unmodified}}
+\entry{visible-stats}{93}{\code {visible-stats}}

doc/bashref.vrs

@@ -17,7 +17,7 @@
 \initial {0}
 \entry {\code {0}}{16}
 \initial {A}
-\entry {\code {auto_resume}}{84}
+\entry {\code {auto_resume}}{86}
 \initial {B}
 \entry {\code {BASH}}{55}
 \entry {\code {BASH_ARGC}}{56}
@@ -31,29 +31,29 @@
 \entry {\code {BASH_SUBSHELL}}{56}
 \entry {\code {BASH_VERSINFO}}{56}
 \entry {\code {BASH_VERSION}}{57}
-\entry {\code {bell-style}}{89}
-\entry {\code {bind-tty-special-chars}}{89}
+\entry {\code {bell-style}}{91}
+\entry {\code {bind-tty-special-chars}}{91}
 \initial {C}
 \entry {\code {CDPATH}}{55}
 \entry {\code {COLUMNS}}{57}
-\entry {\code {comment-begin}}{89}
+\entry {\code {comment-begin}}{91}
 \entry {\code {COMP_CWORD}}{57}
 \entry {\code {COMP_LINE}}{57}
 \entry {\code {COMP_POINT}}{57}
 \entry {\code {COMP_WORDBREAKS}}{57}
 \entry {\code {COMP_WORDS}}{57}
-\entry {\code {completion-query-items}}{89}
+\entry {\code {completion-query-items}}{91}
 \entry {\code {COMPREPLY}}{58}
-\entry {\code {convert-meta}}{89}
+\entry {\code {convert-meta}}{91}
 \initial {D}
 \entry {\code {DIRSTACK}}{58}
-\entry {\code {disable-completion}}{90}
+\entry {\code {disable-completion}}{92}
 \initial {E}
-\entry {\code {editing-mode}}{90}
+\entry {\code {editing-mode}}{92}
 \entry {\code {EMACS}}{58}
-\entry {\code {enable-keypad}}{90}
+\entry {\code {enable-keypad}}{92}
 \entry {\code {EUID}}{58}
-\entry {\code {expand-tilde}}{90}
+\entry {\code {expand-tilde}}{92}
 \initial {F}
 \entry {\code {FCEDIT}}{58}
 \entry {\code {FIGNORE}}{58}
@@ -68,22 +68,22 @@
 \entry {\code {HISTFILE}}{59}
 \entry {\code {HISTFILESIZE}}{59}
 \entry {\code {HISTIGNORE}}{59}
-\entry {\code {history-preserve-point}}{90}
+\entry {\code {history-preserve-point}}{92}
 \entry {\code {HISTSIZE}}{59}
 \entry {\code {HISTTIMEFORMAT}}{59}
 \entry {\code {HOME}}{55}
-\entry {\code {horizontal-scroll-mode}}{90}
-\entry {\code {HOSTFILE}}{59}
+\entry {\code {horizontal-scroll-mode}}{92}
+\entry {\code {HOSTFILE}}{60}
 \entry {\code {HOSTNAME}}{60}
 \entry {\code {HOSTTYPE}}{60}
 \initial {I}
 \entry {\code {IFS}}{55}
 \entry {\code {IGNOREEOF}}{60}
-\entry {\code {input-meta}}{90}
+\entry {\code {input-meta}}{92}
 \entry {\code {INPUTRC}}{60}
-\entry {\code {isearch-terminators}}{90}
+\entry {\code {isearch-terminators}}{92}
 \initial {K}
-\entry {\code {keymap}}{90}
+\entry {\code {keymap}}{92}
 \initial {L}
 \entry {\code {LANG}}{60}
 \entry {\code {LC_ALL}}{60}
@@ -92,25 +92,25 @@
 \entry {\code {LC_MESSAGES}}{7, 60}
 \entry {\code {LC_NUMERIC}}{60}
 \entry {\code {LINENO}}{60}
-\entry {\code {LINES}}{60}
+\entry {\code {LINES}}{61}
 \initial {M}
-\entry {\code {MACHTYPE}}{60}
+\entry {\code {MACHTYPE}}{61}
 \entry {\code {MAIL}}{55}
 \entry {\code {MAILCHECK}}{61}
 \entry {\code {MAILPATH}}{55}
-\entry {\code {mark-modified-lines}}{91}
-\entry {\code {mark-symlinked-directories}}{91}
-\entry {\code {match-hidden-files}}{91}
-\entry {\code {meta-flag}}{90}
+\entry {\code {mark-modified-lines}}{93}
+\entry {\code {mark-symlinked-directories}}{93}
+\entry {\code {match-hidden-files}}{93}
+\entry {\code {meta-flag}}{92}
 \initial {O}
 \entry {\code {OLDPWD}}{61}
 \entry {\code {OPTARG}}{55}
 \entry {\code {OPTERR}}{61}
 \entry {\code {OPTIND}}{55}
 \entry {\code {OSTYPE}}{61}
-\entry {\code {output-meta}}{91}
+\entry {\code {output-meta}}{93}
 \initial {P}
-\entry {\code {page-completions}}{91}
+\entry {\code {page-completions}}{93}
 \entry {\code {PATH}}{55}
 \entry {\code {PIPESTATUS}}{61}
 \entry {\code {POSIXLY_CORRECT}}{61}
@@ -125,18 +125,18 @@
 \entry {\code {RANDOM}}{61}
 \entry {\code {REPLY}}{61}
 \initial {S}
-\entry {\code {SECONDS}}{61}
+\entry {\code {SECONDS}}{62}
 \entry {\code {SHELL}}{62}
 \entry {\code {SHELLOPTS}}{62}
 \entry {\code {SHLVL}}{62}
-\entry {\code {show-all-if-ambiguous}}{91}
-\entry {\code {show-all-if-unmodified}}{91}
+\entry {\code {show-all-if-ambiguous}}{93}
+\entry {\code {show-all-if-unmodified}}{93}
 \initial {T}
 \entry {\code {TEXTDOMAIN}}{7}
 \entry {\code {TEXTDOMAINDIR}}{7}
 \entry {\code {TIMEFORMAT}}{62}
 \entry {\code {TMOUT}}{62}
 \initial {U}
-\entry {\code {UID}}{62}
+\entry {\code {UID}}{63}
 \initial {V}
-\entry {\code {visible-stats}}{91}
+\entry {\code {visible-stats}}{93}

doc/builtins.0

@@ -1081,74 +1081,86 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
                              routine (a shell function or a shell script  exe-
                              cuted  by  the  ..  or ssoouurrccee builtins), a call to
                              rreettuurrnn is simulated.
+                      44..     BBAASSHH__AARRGGCC and BBAASSHH__AARRGGVV are updated as  described
+                             in their descriptions above.
+                      55..     Function  tracing  is enabled:  command substitu-
+                             tion, shell functions, and subshells invoked with
+                             (( _c_o_m_m_a_n_d )) inherit the DDEEBBUUGG and RREETTUURRNN traps.
+                      66..     Error  tracing is enabled:  command substitution,
+                             shell functions, and  subshells  invoked  with  ((
+                             _c_o_m_m_a_n_d )) inherit the EERRRROORR trap.
               eexxttgglloobb If set, the extended pattern matching features described
                       above under PPaatthhnnaammee EExxppaannssiioonn are enabled.
               eexxttqquuoottee
-                      If  set,  $$'_s_t_r_i_n_g'  and  $$"_s_t_r_i_n_g" quoting is performed
-                      within  $${{_p_a_r_a_m_e_t_e_r}}  expansions  enclosed   in   double
+                      If set, $$'_s_t_r_i_n_g' and  $$"_s_t_r_i_n_g"  quoting  is  performed
+                      within   $${{_p_a_r_a_m_e_t_e_r}}   expansions  enclosed  in  double
                       quotes.  This option is enabled by default.
               ffaaiillgglloobb
-                      If  set,  patterns  which fail to match filenames during
+                      If set, patterns which fail to  match  filenames  during
                       pathname expansion result in an expansion error.
               ffoorrccee__ffiiggnnoorree
-                      If set, the suffixes  specified  by  the  FFIIGGNNOORREE  shell
-                      variable  cause words to be ignored when performing word
+                      If  set,  the  suffixes  specified  by the FFIIGGNNOORREE shell
+                      variable cause words to be ignored when performing  word
                       completion even if the ignored words are the only possi-
                       ble  completions.   See  SSHHEELLLL  VVAARRIIAABBLLEESS  above  for  a
-                      description of  FFIIGGNNOORREE.   This  option  is  enabled  by
+                      description  of  FFIIGGNNOORREE.   This  option  is  enabled by
                       default.
               ggnnuu__eerrrrffmmtt
                       If set, shell error messages are written in the standard
                       GNU error message format.
               hhiissttaappppeenndd
-                      If set, the history list is appended to the  file  named
-                      by  the  value  of  the HHIISSTTFFIILLEE variable when the shell
+                      If  set,  the history list is appended to the file named
+                      by the value of the HHIISSTTFFIILLEE  variable  when  the  shell
                       exits, rather than overwriting the file.
               hhiissttrreeeeddiitt
-                      If set, and rreeaaddlliinnee is being used, a user is given  the
+                      If  set, and rreeaaddlliinnee is being used, a user is given the
                       opportunity to re-edit a failed history substitution.
               hhiissttvveerriiffyy
-                      If  set, and rreeaaddlliinnee is being used, the results of his-
-                      tory substitution are  not  immediately  passed  to  the
-                      shell  parser.   Instead,  the  resulting line is loaded
+                      If set, and rreeaaddlliinnee is being used, the results of  his-
+                      tory  substitution  are  not  immediately  passed to the
+                      shell parser.  Instead, the  resulting  line  is  loaded
                       into the rreeaaddlliinnee editing buffer, allowing further modi-
                       fication.
               hhoossttccoommpplleettee
                       If set, and rreeaaddlliinnee is being used, bbaasshh will attempt to
-                      perform hostname completion when a word containing  a  @@
-                      is   being  completed  (see  CCoommpplleettiinngg  under  RREEAADDLLIINNEE
+                      perform  hostname  completion when a word containing a @@
+                      is  being  completed  (see  CCoommpplleettiinngg  under   RREEAADDLLIINNEE
                       above).  This is enabled by default.
               hhuuppoonneexxiitt
                       If set, bbaasshh will send SSIIGGHHUUPP to all jobs when an inter-
                       active login shell exits.
               iinntteerraaccttiivvee__ccoommmmeennttss
                       If set, allow a word beginning with ## to cause that word
-                      and all remaining characters on that line to be  ignored
-                      in  an  interactive  shell  (see  CCOOMMMMEENNTTSS above).  This
+                      and  all remaining characters on that line to be ignored
+                      in an interactive  shell  (see  CCOOMMMMEENNTTSS  above).   This
                       option is enabled by default.
-              lliitthhiisstt If set, and the ccmmddhhiisstt option  is  enabled,  multi-line
+              lliitthhiisstt If  set,  and  the ccmmddhhiisstt option is enabled, multi-line
                       commands are saved to the history with embedded newlines
                       rather than using semicolon separators where possible.
               llooggiinn__sshheellll
-                      The shell sets this option if it is started as  a  login
-                      shell  (see  IINNVVOOCCAATTIIOONN  above).   The  value may not be
+                      The  shell  sets this option if it is started as a login
+                      shell (see IINNVVOOCCAATTIIOONN above).   The  value  may  not  be
                       changed.
               mmaaiillwwaarrnn
-                      If set, and a file that bbaasshh is checking  for  mail  has
-                      been  accessed  since  the last time it was checked, the
-                      message ``The mail in _m_a_i_l_f_i_l_e has been read''  is  dis-
+                      If  set,  and  a file that bbaasshh is checking for mail has
+                      been accessed since the last time it  was  checked,  the
+                      message  ``The  mail in _m_a_i_l_f_i_l_e has been read'' is dis-
                       played.
               nnoo__eemmppttyy__ccmmdd__ccoommpplleettiioonn
-                      If  set,  and  rreeaaddlliinnee  is  being  used,  bbaasshh will not
+                      If set, and  rreeaaddlliinnee  is  being  used,  bbaasshh  will  not
                       attempt to search the PPAATTHH for possible completions when
                       completion is attempted on an empty line.
               nnooccaasseegglloobb
-                      If  set,  bbaasshh  matches  filenames in a case-insensitive
+                      If set, bbaasshh matches  filenames  in  a  case-insensitive
                       fashion when performing pathname expansion (see PPaatthhnnaammee
                       EExxppaannssiioonn above).
+              nnooccaasseemmaattcchh
+                      If set, bbaasshh  matches  patterns  in  a  case-insensitive
+                      fashion when performing matching while executing ccaassee or
+                      [[[[ conditional commands.
               nnuullllgglloobb
-                      If  set,  bbaasshh allows patterns which match no files (see
-                      PPaatthhnnaammee EExxppaannssiioonn above) to expand to  a  null  string,
+                      If set, bbaasshh allows patterns which match no  files  (see
+                      PPaatthhnnaammee  EExxppaannssiioonn  above)  to expand to a null string,
                       rather than themselves.
               pprrooggccoommpp
                       If set, the programmable completion facilities (see PPrroo--
@@ -1156,44 +1168,44 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
                       enabled by default.
               pprroommppttvvaarrss
                       If set, prompt strings undergo parameter expansion, com-
-                      mand  substitution,  arithmetic  expansion,  and   quote
-                      removal  after  being expanded as described in PPRROOMMPPTTIINNGG
+                      mand   substitution,  arithmetic  expansion,  and  quote
+                      removal after being expanded as described  in  PPRROOMMPPTTIINNGG
                       above.  This option is enabled by default.
               rreessttrriicctteedd__sshheellll
-                      The  shell  sets  this  option  if  it  is  started   in
+                      The   shell  sets  this  option  if  it  is  started  in
                       restricted mode (see RREESSTTRRIICCTTEEDD SSHHEELLLL below).  The value
-                      may not be changed.  This is not reset when the  startup
-                      files  are  executed, allowing the startup files to dis-
+                      may  not be changed.  This is not reset when the startup
+                      files are executed, allowing the startup files  to  dis-
                       cover whether or not a shell is restricted.
               sshhiifftt__vveerrbboossee
-                      If set, the sshhiifftt builtin prints an error  message  when
+                      If  set,  the sshhiifftt builtin prints an error message when
                       the shift count exceeds the number of positional parame-
                       ters.
               ssoouurrcceeppaatthh
                       If set, the ssoouurrccee (..) builtin uses the value of PPAATTHH to
-                      find  the  directory  containing the file supplied as an
+                      find the directory containing the file  supplied  as  an
                       argument.  This option is enabled by default.
               xxppgg__eecchhoo
-                      If  set,  the  eecchhoo  builtin  expands   backslash-escape
+                      If   set,  the  eecchhoo  builtin  expands  backslash-escape
                       sequences by default.
        ssuussppeenndd [--ff]
-              Suspend  the execution of this shell until it receives a SSIIGGCCOONNTT
-              signal.  The --ff option says not to complain if this is  a  login
-              shell;  just  suspend anyway.  The return status is 0 unless the
+              Suspend the execution of this shell until it receives a  SSIIGGCCOONNTT
+              signal.   The  --ff option says not to complain if this is a login
+              shell; just suspend anyway.  The return status is 0  unless  the
               shell is a login shell and --ff is not supplied, or if job control
               is not enabled.
        tteesstt _e_x_p_r
        [[ _e_x_p_r ]]
-              Return  a  status  of  0 or 1 depending on the evaluation of the
-              conditional expression _e_x_p_r.  Each operator and operand must  be
-              a  separate argument.  Expressions are composed of the primaries
+              Return a status of 0 or 1 depending on  the  evaluation  of  the
+              conditional  expression _e_x_p_r.  Each operator and operand must be
+              a separate argument.  Expressions are composed of the  primaries
               described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS.
 
-              Expressions may  be  combined  using  the  following  operators,
+              Expressions  may  be  combined  using  the  following operators,
               listed in decreasing order of precedence.
               !! _e_x_p_r True if _e_x_p_r is false.
               (( _e_x_p_r ))
-                     Returns  the value of _e_x_p_r.  This may be used to override
+                     Returns the value of _e_x_p_r.  This may be used to  override
                      the normal precedence of operators.
               _e_x_p_r_1 -aa _e_x_p_r_2
                      True if both _e_x_p_r_1 and _e_x_p_r_2 are true.
@@ -1210,109 +1222,109 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
                      null.
               2 arguments
                      If the first argument is !!, the expression is true if and
-                     only  if the second argument is null.  If the first argu-
-                     ment is one of the  unary  conditional  operators  listed
-                     above  under  CCOONNDDIITTIIOONNAALL  EEXXPPRREESSSSIIOONNSS, the expression is
+                     only if the second argument is null.  If the first  argu-
+                     ment  is  one  of  the unary conditional operators listed
+                     above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS,  the  expression  is
                      true if the unary test is true.  If the first argument is
                      not a valid unary conditional operator, the expression is
                      false.
               3 arguments
-                     If the second argument is one of the  binary  conditional
+                     If  the  second argument is one of the binary conditional
                      operators listed above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the
                      result of the expression is the result of the binary test
-                     using  the first and third arguments as operands.  If the
-                     first argument is !!, the value is  the  negation  of  the
-                     two-argument  test  using the second and third arguments.
+                     using the first and third arguments as operands.  If  the
+                     first  argument  is  !!,  the value is the negation of the
+                     two-argument test using the second and  third  arguments.
                      If the first argument is exactly (( and the third argument
-                     is  exactly )), the result is the one-argument test of the
-                     second argument.  Otherwise,  the  expression  is  false.
-                     The  --aa  and --oo operators are considered binary operators
+                     is exactly )), the result is the one-argument test of  the
+                     second  argument.   Otherwise,  the  expression is false.
+                     The --aa and --oo operators are considered  binary  operators
                      in this case.
               4 arguments
                      If the first argument is !!, the result is the negation of
-                     the  three-argument  expression composed of the remaining
+                     the three-argument expression composed of  the  remaining
                      arguments.  Otherwise, the expression is parsed and eval-
-                     uated  according  to  precedence  using  the rules listed
+                     uated according to  precedence  using  the  rules  listed
                      above.
               5 or more arguments
-                     The expression  is  parsed  and  evaluated  according  to
+                     The  expression  is  parsed  and  evaluated  according to
                      precedence using the rules listed above.
 
-       ttiimmeess  Print  the  accumulated  user and system times for the shell and
+       ttiimmeess  Print the accumulated user and system times for  the  shell  and
               for processes run from the shell.  The return status is 0.
 
        ttrraapp [--llpp] [[_a_r_g] _s_i_g_s_p_e_c ...]
-              The command _a_r_g is to  be  read  and  executed  when  the  shell
-              receives  signal(s)  _s_i_g_s_p_e_c.   If _a_r_g is absent (and there is a
-              single _s_i_g_s_p_e_c) or --, each specified  signal  is  reset  to  its
-              original  disposition  (the  value  it  had upon entrance to the
-              shell).  If _a_r_g is the null string the signal specified by  each
-              _s_i_g_s_p_e_c  is ignored by the shell and by the commands it invokes.
-              If _a_r_g is not present and --pp has been supplied,  then  the  trap
-              commands  associated  with  each  _s_i_g_s_p_e_c  are displayed.  If no
-              arguments are supplied or if only --pp is given, ttrraapp  prints  the
-              list  of  commands  associated  with each signal.  The --ll option
-              causes the shell to print a list of signal names and their  cor-
-              responding  numbers.   Each  _s_i_g_s_p_e_c  is  either  a  signal name
-              defined in <_s_i_g_n_a_l_._h>, or a signal  number.   Signal  names  are
-              case  insensitive  and the SIG prefix is optional.  If a _s_i_g_s_p_e_c
-              is EEXXIITT (0) the command _a_r_g is executed on exit from the  shell.
-              If  a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is executed before every
+              The  command  _a_r_g  is  to  be  read  and executed when the shell
+              receives signal(s) _s_i_g_s_p_e_c.  If _a_r_g is absent (and  there  is  a
+              single  _s_i_g_s_p_e_c)  or  --,  each  specified signal is reset to its
+              original disposition (the value it  had  upon  entrance  to  the
+              shell).   If _a_r_g is the null string the signal specified by each
+              _s_i_g_s_p_e_c is ignored by the shell and by the commands it  invokes.
+              If  _a_r_g  is  not present and --pp has been supplied, then the trap
+              commands associated with each  _s_i_g_s_p_e_c  are  displayed.   If  no
+              arguments  are  supplied or if only --pp is given, ttrraapp prints the
+              list of commands associated with each  signal.   The  --ll  option
+              causes  the shell to print a list of signal names and their cor-
+              responding numbers.   Each  _s_i_g_s_p_e_c  is  either  a  signal  name
+              defined  in  <_s_i_g_n_a_l_._h>,  or  a signal number.  Signal names are
+              case insensitive and the SIG prefix is optional.  If  a  _s_i_g_s_p_e_c
+              is  EEXXIITT (0) the command _a_r_g is executed on exit from the shell.
+              If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is executed before  every
               _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command, _s_e_l_e_c_t command, every
               arithmetic _f_o_r command, and before the first command executes in
-              a shell function  (see  SSHHEELLLL  GGRRAAMMMMAARR  above).   Refer  to  the
-              description  of  the  eexxttddeebbuugg  option  to the sshhoopptt builtin for
-              details of its effect on the DDEEBBUUGG trap.  If a _s_i_g_s_p_e_c  is  EERRRR,
-              the  command  _a_r_g  is  executed  whenever a simple command has a
-              non-zero exit status, subject to the following conditions.   The
-              EERRRR  trap  is  not executed if the failed command is part of the
-              command list immediately following a  wwhhiillee  or  uunnttiill  keyword,
+              a  shell  function  (see  SSHHEELLLL  GGRRAAMMMMAARR  above).   Refer to the
+              description of the eexxttddeebbuugg option  to  the  sshhoopptt  builtin  for
+              details  of  its effect on the DDEEBBUUGG trap.  If a _s_i_g_s_p_e_c is EERRRR,
+              the command _a_r_g is executed whenever  a  simple  command  has  a
+              non-zero  exit status, subject to the following conditions.  The
+              EERRRR trap is not executed if the failed command is  part  of  the
+              command  list  immediately  following  a wwhhiillee or uunnttiill keyword,
               part of the test in an _i_f statement, part of a &&&& or |||| list, or
-              if the command's return value is being inverted  via  !!.   These
-              are  the  same  conditions  obeyed  by the eerrrreexxiitt option.  If a
+              if  the  command's  return value is being inverted via !!.  These
+              are the same conditions obeyed by  the  eerrrreexxiitt  option.   If  a
               _s_i_g_s_p_e_c is RREETTUURRNN, the command _a_r_g is executed each time a shell
               function or a script executed with the .. or ssoouurrccee builtins fin-
               ishes executing.  Signals ignored upon entry to the shell cannot
-              be  trapped or reset.  Trapped signals are reset to their origi-
-              nal values in a child process when it is  created.   The  return
-              status  is  false  if  any  _s_i_g_s_p_e_c  is  invalid; otherwise ttrraapp
+              be trapped or reset.  Trapped signals are reset to their  origi-
+              nal  values  in  a child process when it is created.  The return
+              status is false  if  any  _s_i_g_s_p_e_c  is  invalid;  otherwise  ttrraapp
               returns true.
 
        ttyyppee [--aaffttppPP] _n_a_m_e [_n_a_m_e ...]
-              With no options, indicate how each _n_a_m_e would be interpreted  if
+              With  no options, indicate how each _n_a_m_e would be interpreted if
               used as a command name.  If the --tt option is used, ttyyppee prints a
-              string which is one of _a_l_i_a_s,  _k_e_y_w_o_r_d,  _f_u_n_c_t_i_o_n,  _b_u_i_l_t_i_n,  or
-              _f_i_l_e  if  _n_a_m_e  is  an  alias,  shell  reserved  word, function,
-              builtin, or disk file, respectively.  If the _n_a_m_e is not  found,
-              then  nothing  is  printed,  and  an  exit  status  of  false is
-              returned.  If the --pp option is used,  ttyyppee  either  returns  the
+              string  which  is  one  of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or
+              _f_i_l_e if  _n_a_m_e  is  an  alias,  shell  reserved  word,  function,
+              builtin,  or disk file, respectively.  If the _n_a_m_e is not found,
+              then nothing  is  printed,  and  an  exit  status  of  false  is
+              returned.   If  the  --pp  option is used, ttyyppee either returns the
               name of the disk file that would be executed if _n_a_m_e were speci-
               fied as a command name, or nothing if ``type -t name'' would not
-              return  _f_i_l_e.  The --PP option forces a PPAATTHH search for each _n_a_m_e,
+              return _f_i_l_e.  The --PP option forces a PPAATTHH search for each  _n_a_m_e,
               even if ``type -t name'' would not return _f_i_l_e.  If a command is
-              hashed,  --pp  and  --PP print the hashed value, not necessarily the
+              hashed, --pp and --PP print the hashed value,  not  necessarily  the
               file that appears first in PPAATTHH.  If the --aa option is used, ttyyppee
-              prints  all of the places that contain an executable named _n_a_m_e.
-              This includes aliases and functions,  if  and  only  if  the  --pp
-              option  is  not  also used.  The table of hashed commands is not
-              consulted when using --aa.  The --ff option suppresses  shell  func-
-              tion  lookup, as with the ccoommmmaanndd builtin.  ttyyppee returns true if
+              prints all of the places that contain an executable named  _n_a_m_e.
+              This  includes  aliases  and  functions,  if  and only if the --pp
+              option is not also used.  The table of hashed  commands  is  not
+              consulted  when  using --aa.  The --ff option suppresses shell func-
+              tion lookup, as with the ccoommmmaanndd builtin.  ttyyppee returns true  if
               any of the arguments are found, false if none are found.
 
        uulliimmiitt [--SSHHaaccddffllmmnnppssttuuvv [_l_i_m_i_t]]
-              Provides control over the resources available to the  shell  and
-              to  processes started by it, on systems that allow such control.
+              Provides  control  over the resources available to the shell and
+              to processes started by it, on systems that allow such  control.
               The --HH and --SS options specify that the hard or soft limit is set
-              for  the  given resource.  A hard limit cannot be increased once
-              it is set; a soft limit may be increased up to the value of  the
-              hard  limit.   If  neither --HH nor --SS is specified, both the soft
-              and hard limits are set.  The value of _l_i_m_i_t can be a number  in
+              for the given resource.  A hard limit cannot be  increased  once
+              it  is set; a soft limit may be increased up to the value of the
+              hard limit.  If neither --HH nor --SS is specified,  both  the  soft
+              and  hard limits are set.  The value of _l_i_m_i_t can be a number in
               the unit specified for the resource or one of the special values
-              hhaarrdd, ssoofftt, or uunnlliimmiitteedd,  which  stand  for  the  current  hard
-              limit,  the  current soft limit, and no limit, respectively.  If
-              _l_i_m_i_t is omitted, the current value of the  soft  limit  of  the
-              resource  is  printed, unless the --HH option is given.  When more
-              than one resource is specified, the  limit  name  and  unit  are
+              hhaarrdd,  ssoofftt,  or  uunnlliimmiitteedd,  which  stand  for the current hard
+              limit, the current soft limit, and no limit,  respectively.   If
+              _l_i_m_i_t  is  omitted,  the  current value of the soft limit of the
+              resource is printed, unless the --HH option is given.   When  more
+              than  one  resource  is  specified,  the limit name and unit are
               printed before the value.  Other options are interpreted as fol-
               lows:
               --aa     All current limits are reported
@@ -1326,56 +1338,56 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
               --pp     The pipe size in 512-byte blocks (this may not be set)
               --ss     The maximum stack size
               --tt     The maximum amount of cpu time in seconds
-              --uu     The  maximum  number  of  processes available to a single
+              --uu     The maximum number of processes  available  to  a  single
                      user
-              --vv     The maximum amount of virtual  memory  available  to  the
+              --vv     The  maximum  amount  of  virtual memory available to the
                      shell
 
               If _l_i_m_i_t is given, it is the new value of the specified resource
               (the --aa option is display only).  If no option is given, then --ff
-              is  assumed.  Values are in 1024-byte increments, except for --tt,
-              which is in seconds, --pp, which is in units of  512-byte  blocks,
-              and  --nn and --uu, which are unscaled values.  The return status is
-              0 unless an invalid option or argument is supplied, or an  error
+              is assumed.  Values are in 1024-byte increments, except for  --tt,
+              which  is  in seconds, --pp, which is in units of 512-byte blocks,
+              and --nn and --uu, which are unscaled values.  The return status  is
+              0  unless an invalid option or argument is supplied, or an error
               occurs while setting a new limit.
 
        uummaasskk [--pp] [--SS] [_m_o_d_e]
               The user file-creation mask is set to _m_o_d_e.  If _m_o_d_e begins with
-              a digit, it is interpreted as an octal number; otherwise  it  is
-              interpreted  as a symbolic mode mask similar to that accepted by
-              _c_h_m_o_d(1).  If _m_o_d_e is omitted, the current value of the mask  is
-              printed.   The  --SS  option causes the mask to be printed in sym-
-              bolic form; the default output is an octal number.   If  the  --pp
+              a  digit,  it is interpreted as an octal number; otherwise it is
+              interpreted as a symbolic mode mask similar to that accepted  by
+              _c_h_m_o_d(1).   If _m_o_d_e is omitted, the current value of the mask is
+              printed.  The --SS option causes the mask to be  printed  in  sym-
+              bolic  form;  the  default output is an octal number.  If the --pp
               option is supplied, and _m_o_d_e is omitted, the output is in a form
               that may be reused as input.  The return status is 0 if the mode
-              was  successfully  changed  or if no _m_o_d_e argument was supplied,
+              was successfully changed or if no _m_o_d_e  argument  was  supplied,
               and false otherwise.
 
        uunnaalliiaass [-aa] [_n_a_m_e ...]
-              Remove each _n_a_m_e from the list of defined  aliases.   If  --aa  is
-              supplied,  all  alias definitions are removed.  The return value
+              Remove  each  _n_a_m_e  from  the list of defined aliases.  If --aa is
+              supplied, all alias definitions are removed.  The  return  value
               is true unless a supplied _n_a_m_e is not a defined alias.
 
        uunnsseett [-ffvv] [_n_a_m_e ...]
-              For each _n_a_m_e, remove the corresponding  variable  or  function.
+              For  each  _n_a_m_e,  remove the corresponding variable or function.
               If no options are supplied, or the --vv option is given, each _n_a_m_e
-              refers to a shell variable.   Read-only  variables  may  not  be
-              unset.   If  --ff  is specified, each _n_a_m_e refers to a shell func-
-              tion, and the function definition is removed.  Each unset  vari-
-              able  or function is removed from the environment passed to sub-
-              sequent commands.  If any of RRAANNDDOOMM, SSEECCOONNDDSS,  LLIINNEENNOO,  HHIISSTTCCMMDD,
+              refers  to  a  shell  variable.   Read-only variables may not be
+              unset.  If --ff is specified, each _n_a_m_e refers to  a  shell  func-
+              tion,  and the function definition is removed.  Each unset vari-
+              able or function is removed from the environment passed to  sub-
+              sequent  commands.   If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD,
               FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are unset, they lose their special
-              properties, even if they are subsequently reset.  The exit  sta-
+              properties,  even if they are subsequently reset.  The exit sta-
               tus is true unless a _n_a_m_e is readonly.
 
        wwaaiitt [_n _._._.]
-              Wait  for each specified process and return its termination sta-
-              tus.  Each _n may be a process ID or a job  specification;  if  a
-              job  spec  is  given,  all  processes in that job's pipeline are
-              waited for.  If _n is not given, all currently active child  pro-
-              cesses  are  waited  for,  and  the return status is zero.  If _n
-              specifies a non-existent process or job, the  return  status  is
-              127.   Otherwise,  the  return  status is the exit status of the
+              Wait for each specified process and return its termination  sta-
+              tus.   Each  _n  may be a process ID or a job specification; if a
+              job spec is given, all processes  in  that  job's  pipeline  are
+              waited  for.  If _n is not given, all currently active child pro-
+              cesses are waited for, and the return  status  is  zero.   If  _n
+              specifies  a  non-existent  process or job, the return status is
+              127.  Otherwise, the return status is the  exit  status  of  the
               last process or job waited for.
 
 SSEEEE AALLSSOO

doc/builtins.ps

@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.18.1
-%%CreationDate: Mon Feb 14 11:56:35 2005
+%%CreationDate: Tue Feb 22 13:37:34 2005
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%+ font Times-Italic
@@ -1871,458 +1871,471 @@ F2 1.159(This option is)5.659 F
 (outine \(a shell function or a shell script exe-)-.18 F(cuted by the)
 220 300 Q F1(.)2.5 E F2(or)2.5 E F1(source)2.5 E F2
 (builtins\), a call to)2.5 E F1(return)2.5 E F2(is simulated.)2.5 E F1
-(extglob)144 312 Q F2 .432(If set, the extended pattern matching featur)
-6.11 F .432(es described above under)-.18 F F1(Pathname)2.932 E
-(Expansion)184 324 Q F2(ar)2.5 E 2.5(ee)-.18 G(nabled.)-2.5 E F1
-(extquote)144 336 Q F2 .143(If set,)184 348 R F1($)2.643 E F2(')A/F5 10
-/Palatino-Italic@0 SF(string)A F2 2.643('a)C(nd)-2.643 E F1($)2.643 E F2
-(")A F5(string)A F2 2.643("q)C .143(uoting is performed within)-2.643 F
-F1(${)2.643 E F5(parameter)A F1(})A F2(expansions)2.643 E
-(enclosed in double quotes.)184 360 Q
-(This option is enabled by default.)5 E F1(failglob)144 372 Q F2 .507(I\
+26(4. BASH_ARGC)184 312 R F2(and)5.149 E F1(BASH_ARGV)5.149 E F2(ar)
+5.149 E 5.149(eu)-.18 G 2.649(pdated as described in their)-5.149 F
+(descriptions above.)220 324 Q F1(5.)184 336 Q F2 .163
+(Function tracing is enabled:)28.5 F .164
+(command substitution, shell functions, and)5.164 F 1.112
+(subshells invoked with)220 348 R F1(\()3.612 E/F5 10/Palatino-Italic@0
+SF(command)3.612 E F1(\))3.612 E F2 1.112(inherit the)3.612 F F1(DEBUG)
+3.612 E F2(and)3.612 E F1(RETURN)3.612 E F2(traps.)220 360 Q F1(6.)184
+372 Q F2(Err)28.5 E 2.171(or tracing is enabled:)-.18 F 2.171
+(command substitution, shell functions, and)7.171 F
+(subshells invoked with)220 384 Q F1(\()2.5 E F5(command)2.5 E F1(\))2.5
+E F2(inherit the)2.5 E F1(ERROR)2.5 E F2(trap.)2.5 E F1(extglob)144 396
+Q F2 .432(If set, the extended pattern matching featur)6.11 F .432
+(es described above under)-.18 F F1(Pathname)2.932 E(Expansion)184 408 Q
+F2(ar)2.5 E 2.5(ee)-.18 G(nabled.)-2.5 E F1(extquote)144 420 Q F2 .143
+(If set,)184 432 R F1($)2.643 E F2(')A F5(string)A F2 2.643('a)C(nd)
+-2.643 E F1($)2.643 E F2(")A F5(string)A F2 2.643("q)C .143
+(uoting is performed within)-2.643 F F1(${)2.643 E F5(parameter)A F1(})A
+F2(expansions)2.643 E(enclosed in double quotes.)184 444 Q
+(This option is enabled by default.)5 E F1(failglob)144 456 Q F2 .507(I\
 f set, patterns which fail to match \214lenames during pathname expansi\
-on r)184 384 R(esult)-.18 E(in an expansion err)184 396 Q(or)-.18 E(.)
--.74 E F1(force_\214gnore)144 408 Q F2 1.118(If set, the suf)184 420 R
+on r)184 468 R(esult)-.18 E(in an expansion err)184 480 Q(or)-.18 E(.)
+-.74 E F1(force_\214gnore)144 492 Q F2 1.118(If set, the suf)184 504 R
 1.118(\214xes speci\214ed by the)-.18 F F1(FIGNORE)3.618 E F2 1.119
-(shell variable cause wor)3.619 F 1.119(ds to be)-.18 F(ignor)184 432 Q
+(shell variable cause wor)3.619 F 1.119(ds to be)-.18 F(ignor)184 516 Q
 1.291(ed when performing wor)-.18 F 3.791(dc)-.18 G 1.291
 (ompletion even if the ignor)-3.791 F 1.291(ed wor)-.18 F 1.291(ds ar)
--.18 F 3.79(et)-.18 G(he)-3.79 E 1.7(only possible completions.)184 444
+-.18 F 3.79(et)-.18 G(he)-3.79 E 1.7(only possible completions.)184 528
 R(See)6.7 E F3 1.7(SHELL V)4.2 F(ARIABLES)-1.161 E F2 1.701
-(above for a description of)3.95 F F1(FIGNORE)184 456 Q F2 5(.T)C
-(his option is enabled by default.)-5 E F1(gnu_errfmt)144 468 Q F2 .843
-(If set, shell err)184 480 R .843(or messages ar)-.18 F 3.342(ew)-.18 G
+(above for a description of)3.95 F F1(FIGNORE)184 540 Q F2 5(.T)C
+(his option is enabled by default.)-5 E F1(gnu_errfmt)144 552 Q F2 .843
+(If set, shell err)184 564 R .843(or messages ar)-.18 F 3.342(ew)-.18 G
 .842(ritten in the standar)-3.342 F 3.342(dG)-.18 G .842(NU err)-3.342 F
-.842(or message for)-.18 F(-)-.18 E(mat.)184 492 Q F1(histappend)144 504
+.842(or message for)-.18 F(-)-.18 E(mat.)184 576 Q F1(histappend)144 588
 Q F2 1.127(If set, the history list is appended to the \214le named by \
-the value of the)184 516 R F1(HIST)3.627 E(-)-.92 E(FILE)184 528 Q F2
+the value of the)184 600 R F1(HIST)3.627 E(-)-.92 E(FILE)184 612 Q F2
 (variable when the shell exits, rather than overwriting the \214le.)2.5
-E F1(histreedit)144 540 Q F2 1.381(If set, and)184 552 R F1(readline)
+E F1(histreedit)144 624 Q F2 1.381(If set, and)184 636 R F1(readline)
 3.881 E F2 1.381(is being used, a user is given the opportunity to r)
-3.881 F 1.38(e-edit a)-.18 F(failed history substitution.)184 564 Q F1
-(histverify)144 576 Q F2 2.133(If set, and)184 588 R F1(readline)4.633 E
+3.881 F 1.38(e-edit a)-.18 F(failed history substitution.)184 648 Q F1
+(histverify)144 660 Q F2 2.133(If set, and)184 672 R F1(readline)4.633 E
 F2 2.133(is being used, the r)4.633 F 2.133
 (esults of history substitution ar)-.18 F 4.634(en)-.18 G(ot)-4.634 E
-.383(immediately passed to the shell parser)184 600 R 5.383(.I)-.74 G
+.383(immediately passed to the shell parser)184 684 R 5.383(.I)-.74 G
 .382(nstead, the r)-5.383 F .382(esulting line is loaded into)-.18 F
-(the)184 612 Q F1(readline)2.5 E F2(editing buf)2.5 E(fer)-.18 E 2.5(,a)
--.74 G(llowing further modi\214cation.)-2.5 E F1(hostcomplete)144 624 Q
-F2 .647(If set, and)184 636 R F1(readline)3.147 E F2 .648
-(is being used,)3.147 F F1(bash)3.148 E F2 .648
-(will attempt to perform hostname com-)3.148 F .44(pletion when a wor)
-184 648 R 2.939(dc)-.18 G .439(ontaining a)-2.939 F F1(@)2.939 E F2 .439
-(is being completed \(see)2.939 F F1(Completing)2.939 E F2(under)2.939 E
-F3(READLINE)184 660 Q F2 2.5(above\). This)2.25 F
-(is enabled by default.)2.5 E F1(huponexit)144 672 Q F2(If set,)184 684
-Q F1(bash)2.5 E F2(will send)2.5 E F3(SIGHUP)2.5 E F2
-(to all jobs when an interactive login shell exits.)2.25 E F1
-(interactive_comments)144 696 Q F2 .26(If set, allow a wor)184 708 R
-2.76(db)-.18 G .26(eginning with)-2.76 F F1(#)2.76 E F2 .26
-(to cause that wor)2.76 F 2.76(da)-.18 G .26(nd all r)-2.76 F .26
-(emaining char)-.18 F(-)-.18 E .512(acters on that line to be ignor)184
-720 R .512(ed in an interactive shell \(see)-.18 F F3(COMMENTS)3.012 E
-F2(above\).)2.762 E F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(15)
-198.725 E 0 Cg EP
+(the)184 696 Q F1(readline)2.5 E F2(editing buf)2.5 E(fer)-.18 E 2.5(,a)
+-.74 G(llowing further modi\214cation.)-2.5 E F0(GNU Bash-3.0)72 768 Q
+(2004 Apr 20)148.735 E(15)198.725 E 0 Cg EP
 %%Page: 16 16
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
-/Palatino-Roman@0 SF(This option is enabled by default.)184 84 Q/F2 10
-/Palatino-Bold@0 SF(lithist)144 96 Q F1 .513(If set, and the)12.8 F F2
-(cmdhist)3.013 E F1 .513(option is enabled, multi-line commands ar)3.013
-F 3.013(es)-.18 G .513(aved to the)-3.013 F .643(history with embedded \
-newlines rather than using semicolon separators wher)184 108 R(e)-.18 E
-(possible.)184 120 Q F2(login_shell)144 132 Q F1 2.454
+/Palatino-Bold@0 SF(hostcomplete)144 84 Q/F2 10/Palatino-Roman@0 SF .647
+(If set, and)184 96 R F1(readline)3.147 E F2 .648(is being used,)3.147 F
+F1(bash)3.148 E F2 .648(will attempt to perform hostname com-)3.148 F
+.44(pletion when a wor)184 108 R 2.939(dc)-.18 G .439(ontaining a)-2.939
+F F1(@)2.939 E F2 .439(is being completed \(see)2.939 F F1(Completing)
+2.939 E F2(under)2.939 E/F3 9/Palatino-Bold@0 SF(READLINE)184 120 Q F2
+2.5(above\). This)2.25 F(is enabled by default.)2.5 E F1(huponexit)144
+132 Q F2(If set,)184 144 Q F1(bash)2.5 E F2(will send)2.5 E F3(SIGHUP)
+2.5 E F2(to all jobs when an interactive login shell exits.)2.25 E F1
+(interactive_comments)144 156 Q F2 .26(If set, allow a wor)184 168 R
+2.76(db)-.18 G .26(eginning with)-2.76 F F1(#)2.76 E F2 .26
+(to cause that wor)2.76 F 2.76(da)-.18 G .26(nd all r)-2.76 F .26
+(emaining char)-.18 F(-)-.18 E .512(acters on that line to be ignor)184
+180 R .512(ed in an interactive shell \(see)-.18 F F3(COMMENTS)3.012 E
+F2(above\).)2.762 E(This option is enabled by default.)184 192 Q F1
+(lithist)144 204 Q F2 .513(If set, and the)12.8 F F1(cmdhist)3.013 E F2
+.513(option is enabled, multi-line commands ar)3.013 F 3.013(es)-.18 G
+.513(aved to the)-3.013 F .643(history with embedded newlines rather th\
+an using semicolon separators wher)184 216 R(e)-.18 E(possible.)184 228
+Q F1(login_shell)144 240 Q F2 2.454
 (The shell sets this option if it is started as a login shell \(see)184
-144 R/F3 9/Palatino-Bold@0 SF(INVOCA)4.954 E(TION)-.828 E F1 2.5
-(above\). The)184 156 R(value may not be changed.)2.5 E F2(mailwarn)144
-168 Q F1 .965(If set, and a \214le that)184 180 R F2(bash)3.465 E F1
-.964(is checking for mail has been accessed since the last)3.464 F 1.647
-(time it was checked, the message `)184 192 R 1.647(`The mail in)-.37 F
-/F4 10/Palatino-Italic@0 SF(mail\214le)4.147 E F1 1.647(has been r)4.147
+252 R F3(INVOCA)4.954 E(TION)-.828 E F2 2.5(above\). The)184 264 R
+(value may not be changed.)2.5 E F1(mailwarn)144 276 Q F2 .965
+(If set, and a \214le that)184 288 R F1(bash)3.465 E F2 .964
+(is checking for mail has been accessed since the last)3.464 F 1.647
+(time it was checked, the message `)184 300 R 1.647(`The mail in)-.37 F
+/F4 10/Palatino-Italic@0 SF(mail\214le)4.147 E F2 1.647(has been r)4.147
 F(ead')-.18 E 4.148('i)-.37 G 4.148(sd)-4.148 G(is-)-4.148 E(played.)184
-204 Q F2(no_empty_cmd_completion)144 216 Q F1 .572(If set, and)184 228 R
-F2(readline)3.072 E F1 .572(is being used,)3.072 F F2(bash)3.072 E F1
-.572(will not attempt to sear)3.072 F .572(ch the)-.18 F F2 -.74(PA)
-3.072 G(TH)-.18 E F1(for)3.072 E
+312 Q F1(no_empty_cmd_completion)144 324 Q F2 .572(If set, and)184 336 R
+F1(readline)3.072 E F2 .572(is being used,)3.072 F F1(bash)3.072 E F2
+.572(will not attempt to sear)3.072 F .572(ch the)-.18 F F1 -.74(PA)
+3.072 G(TH)-.18 E F2(for)3.072 E
 (possible completions when completion is attempted on an empty line.)184
-240 Q F2(nocaseglob)144 252 Q F1 1.548(If set,)184 264 R F2(bash)4.048 E
-F1 1.548
+348 Q F1(nocaseglob)144 360 Q F2 1.548(If set,)184 372 R F1(bash)4.048 E
+F2 1.548
 (matches \214lenames in a case\255insensitive fashion when performing)
-4.048 F(pathname expansion \(see)184 276 Q F2(Pathname Expansion)2.5 E
-F1(above\).)2.5 E F2(nullglob)144 288 Q F1 2.34(If set,)184 300 R F2
-(bash)4.84 E F1 2.34(allows patterns which match no \214les \(see)4.84 F
-F2 2.34(Pathname Expansion)4.84 F F1
-(above\) to expand to a null string, rather than themselves.)184 312 Q
-F2(progcomp)144 324 Q F1 1.198(If set, the pr)184 336 R 1.199
-(ogrammable completion facilities \(see)-.18 F F2 1.199
-(Programmable Completion)3.699 F F1(above\) ar)184 348 Q 2.5(ee)-.18 G
-2.5(nabled. This)-2.5 F(option is enabled by default.)2.5 E F2
-(promptvars)144 360 Q F1 2.553(If set, pr)184 372 R 2.553
-(ompt strings under)-.18 F 2.552
+4.048 F(pathname expansion \(see)184 384 Q F1(Pathname Expansion)2.5 E
+F2(above\).)2.5 E F1(nocasematch)144 396 Q F2 2.158(If set,)184 408 R F1
+(bash)4.658 E F2 2.158
+(matches patterns in a case\255insensitive fashion when performing)4.658
+F(matching while executing)184 420 Q F1(case)2.5 E F2(or)2.5 E F1([[)2.5
+E F2(conditional commands.)2.5 E F1(nullglob)144 432 Q F2 2.34(If set,)
+184 444 R F1(bash)4.84 E F2 2.34
+(allows patterns which match no \214les \(see)4.84 F F1 2.34
+(Pathname Expansion)4.84 F F2
+(above\) to expand to a null string, rather than themselves.)184 456 Q
+F1(progcomp)144 468 Q F2 1.199(If set, the pr)184 480 R 1.199
+(ogrammable completion facilities \(see)-.18 F F1 1.198
+(Programmable Completion)3.698 F F2(above\) ar)184 492 Q 2.5(ee)-.18 G
+2.5(nabled. This)-2.5 F(option is enabled by default.)2.5 E F1
+(promptvars)144 504 Q F2 2.552(If set, pr)184 516 R 2.552
+(ompt strings under)-.18 F 2.553
 (go parameter expansion, command substitution,)-.18 F 1.007
-(arithmetic expansion, and quote r)184 384 R 1.007
-(emoval after being expanded as described in)-.18 F F3(PROMPTING)184 396
-Q F1 2.5(above. This)2.25 F(option is enabled by default.)2.5 E F2
-(restricted_shell)144 408 Q F1 1.743
-(The shell sets this option if it is started in r)184 420 R 1.742
-(estricted mode \(see)-.18 F F3(RESTRICTED)4.242 E(SHELL)184 432 Q F1
-4.862(below\). The)4.612 F 2.362(value may not be changed.)4.862 F 2.362
-(This is not r)7.362 F 2.362(eset when the)-.18 F .294
-(startup \214les ar)184 444 R 2.794(ee)-.18 G .294
+(arithmetic expansion, and quote r)184 528 R 1.007
+(emoval after being expanded as described in)-.18 F F3(PROMPTING)184 540
+Q F2 2.5(above. This)2.25 F(option is enabled by default.)2.5 E F1
+(restricted_shell)144 552 Q F2 1.743
+(The shell sets this option if it is started in r)184 564 R 1.743
+(estricted mode \(see)-.18 F F3(RESTRICTED)4.243 E(SHELL)184 576 Q F2
+4.862(below\). The)4.613 F 2.362(value may not be changed.)4.862 F 2.362
+(This is not r)7.362 F 2.362(eset when the)-.18 F .293
+(startup \214les ar)184 588 R 2.794(ee)-.18 G .294
 (xecuted, allowing the startup \214les to discover whether or not a)
--2.794 F(shell is r)184 456 Q(estricted.)-.18 E F2(shift_verbose)144 468
-Q F1 .527(If set, the)184 480 R F2(shift)3.028 E F1 .528
+-2.794 F(shell is r)184 600 Q(estricted.)-.18 E F1(shift_verbose)144 612
+Q F2 .528(If set, the)184 624 R F1(shift)3.028 E F2 .528
 (builtin prints an err)3.028 F .528
 (or message when the shift count exceeds the)-.18 F
-(number of positional parameters.)184 492 Q F2(sourcepath)144 504 Q F1
-.515(If set, the)184 516 R F2(source)3.015 E F1(\()3.014 E F2(.)A F1
+(number of positional parameters.)184 636 Q F1(sourcepath)144 648 Q F2
+.514(If set, the)184 660 R F1(source)3.014 E F2(\()3.014 E F1(.)A F2
 3.014(\)b)C .514(uiltin uses the value of)-3.014 F F3 -.666(PA)3.014 G
-(TH)-.162 E F1 .514(to \214nd the dir)2.764 F .514(ectory contain-)-.18
-F(ing the \214le supplied as an ar)184 528 Q 2.5(gument. This)-.18 F
-(option is enabled by default.)2.5 E F2(xpg_echo)144 540 Q F1
-(If set, the)184 552 Q F2(echo)2.5 E F1
-(builtin expands backslash-escape sequences by default.)2.5 E F2
-(suspend)108 564 Q F1([)2.5 E F2<ad66>A F1(])A .048
-(Suspend the execution of this shell until it r)144 576 R .048
-(eceives a)-.18 F F3(SIGCONT)2.548 E F1 2.548(signal. The)2.298 F F2
-<ad66>2.548 E F1 .048(option says)2.548 F .327
-(not to complain if this is a login shell; just suspend anyway)144 588 R
-5.327(.T)-1.11 G .327(he r)-5.327 F .327(eturn status is 0 unless)-.18 F
-(the shell is a login shell and)144 600 Q F2<ad66>2.5 E F1
-(is not supplied, or if job contr)2.5 E(ol is not enabled.)-.18 E F2
-(test)108 612 Q F4(expr)2.5 E F2([)108 624 Q F4(expr)2.5 E F2(])2.5 E F1
-.544(Return a status of 0 or 1 depending on the evaluation of the condi\
-tional expr)6.56 F(ession)-.18 E F4(expr)3.044 E F1(.).45 E .789
-(Each operator and operand must be a separate ar)144 636 R 3.288
-(gument. Expr)-.18 F .788(essions ar)-.18 F 3.288(ec)-.18 G .788
-(omposed of)-3.288 F(the primaries described above under)144 648 Q F3
-(CONDITIONAL EXPRESSIONS)2.5 E/F5 9/Palatino-Roman@0 SF(.)A F1(Expr)144
-666 Q .054
-(essions may be combined using the following operators, listed in decr)
--.18 F .055(easing or)-.18 F .055(der of)-.18 F(pr)144 678 Q(ecedence.)
--.18 E F2(!)144 690 Q F4(expr)2.5 E F1 -.78 -.9(Tr u)12.94 H 2.5(ei).9 G
-(f)-2.5 E F4(expr)2.85 E F1(is false.)2.95 E F2(\()144 702 Q F4(expr)2.5
-E F2(\))2.5 E F1 .847(Returns the value of)6.56 F F4(expr)3.347 E F1
-5.847(.T)C .847(his may be used to override the normal pr)-5.847 F
-(ecedence)-.18 E(of operators.)180 714 Q F0(GNU Bash-3.0)72 768 Q
-(2004 Apr 20)148.735 E(16)198.725 E 0 Cg EP
+(TH)-.162 E F2 .515(to \214nd the dir)2.764 F .515(ectory contain-)-.18
+F(ing the \214le supplied as an ar)184 672 Q 2.5(gument. This)-.18 F
+(option is enabled by default.)2.5 E F1(xpg_echo)144 684 Q F2
+(If set, the)184 696 Q F1(echo)2.5 E F2
+(builtin expands backslash-escape sequences by default.)2.5 E F0
+(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(16)198.725 E 0 Cg EP
 %%Page: 17 17
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
-/Palatino-Italic@0 SF(expr1)144 84 Q/F2 10/Palatino-Roman@0 SF<ad>2.5 E
-/F3 10/Palatino-Bold@0 SF(a)A F1(expr2)2.5 E F2 -.78 -.9(Tr u)180 96 T
-2.5(ei).9 G 2.5(fb)-2.5 G(oth)-2.5 E F1(expr1)2.85 E F2(and)2.5 E F1
-(expr2)2.85 E F2(ar)2.5 E 2.5(et)-.18 G -.08(ru)-2.5 G(e.).08 E F1
-(expr1)144 108 Q F2<ad>2.5 E F3(o)A F1(expr2)2.5 E F2 -.78 -.9(Tr u)180
-120 T 2.5(ei).9 G 2.5(fe)-2.5 G(ither)-2.5 E F1(expr1)2.85 E F2(or)2.5 E
-F1(expr2)2.85 E F2(is tr)2.5 E(ue.)-.08 E F3(test)144 136.8 Q F2(and)
-3.576 E F3([)3.576 E F2 1.076(evaluate conditional expr)3.576 F 1.076
-(essions using a set of r)-.18 F 1.076(ules based on the number of)-.08
-F(ar)144 148.8 Q(guments.)-.18 E 2.5(0a)144 166.8 S -.18(rg)-2.5 G
-(uments).18 E(The expr)180 178.8 Q(ession is false.)-.18 E 2.5(1a)144
-190.8 S -.18(rg)-2.5 G(ument).18 E(The expr)180 202.8 Q(ession is tr)
--.18 E(ue if and only if the ar)-.08 E(gument is not null.)-.18 E 2.5
-(2a)144 214.8 S -.18(rg)-2.5 G(uments).18 E .209(If the \214rst ar)180
-226.8 R .208(gument is)-.18 F F3(!)2.708 E F2 2.708(,t)C .208(he expr)
--2.708 F .208(ession is tr)-.18 F .208(ue if and only if the second ar)
--.08 F(gument)-.18 E 2.143(is null.)180 238.8 R 2.144(If the \214rst ar)
-7.143 F 2.144(gument is one of the unary conditional operators listed)
--.18 F 1.402(above under)180 250.8 R/F4 9/Palatino-Bold@0 SF 1.401
-(CONDITIONAL EXPRESSIONS)3.901 F/F5 9/Palatino-Roman@0 SF(,)A F2 1.401
-(the expr)3.651 F 1.401(ession is tr)-.18 F 1.401(ue if the unary)-.08 F
-1.355(test is tr)180 262.8 R 3.855(ue. If)-.08 F 1.356(the \214rst ar)
-3.855 F 1.356(gument is not a valid unary conditional operator)-.18 F
-3.856(,t)-.74 G(he)-3.856 E(expr)180 274.8 Q(ession is false.)-.18 E 2.5
-(3a)144 286.8 S -.18(rg)-2.5 G(uments).18 E 1.5(If the second ar)180
-298.8 R 1.499
+/Palatino-Bold@0 SF(suspend)108 84 Q/F2 10/Palatino-Roman@0 SF([)2.5 E
+F1<ad66>A F2(])A .048(Suspend the execution of this shell until it r)144
+96 R .048(eceives a)-.18 F/F3 9/Palatino-Bold@0 SF(SIGCONT)2.548 E F2
+2.548(signal. The)2.298 F F1<ad66>2.548 E F2 .047(option says)2.547 F
+.327(not to complain if this is a login shell; just suspend anyway)144
+108 R 5.327(.T)-1.11 G .327(he r)-5.327 F .327(eturn status is 0 unless)
+-.18 F(the shell is a login shell and)144 120 Q F1<ad66>2.5 E F2
+(is not supplied, or if job contr)2.5 E(ol is not enabled.)-.18 E F1
+(test)108 132 Q/F4 10/Palatino-Italic@0 SF(expr)2.5 E F1([)108 144 Q F4
+(expr)2.5 E F1(])2.5 E F2 .544(Return a status of 0 or 1 depending on t\
+he evaluation of the conditional expr)6.56 F(ession)-.18 E F4(expr)3.044
+E F2(.).45 E .788(Each operator and operand must be a separate ar)144
+156 R 3.289(gument. Expr)-.18 F .789(essions ar)-.18 F 3.289(ec)-.18 G
+.789(omposed of)-3.289 F(the primaries described above under)144 168 Q
+F3(CONDITIONAL EXPRESSIONS)2.5 E/F5 9/Palatino-Roman@0 SF(.)A F2(Expr)
+144 186 Q .054
+(essions may be combined using the following operators, listed in decr)
+-.18 F .054(easing or)-.18 F .054(der of)-.18 F(pr)144 198 Q(ecedence.)
+-.18 E F1(!)144 210 Q F4(expr)2.5 E F2 -.78 -.9(Tr u)12.94 H 2.5(ei).9 G
+(f)-2.5 E F4(expr)2.85 E F2(is false.)2.95 E F1(\()144 222 Q F4(expr)2.5
+E F1(\))2.5 E F2 .847(Returns the value of)6.56 F F4(expr)3.347 E F2
+5.847(.T)C .847(his may be used to override the normal pr)-5.847 F
+(ecedence)-.18 E(of operators.)180 234 Q F4(expr1)144 246 Q F2<ad>2.5 E
+F1(a)A F4(expr2)2.5 E F2 -.78 -.9(Tr u)180 258 T 2.5(ei).9 G 2.5(fb)-2.5
+G(oth)-2.5 E F4(expr1)2.85 E F2(and)2.5 E F4(expr2)2.85 E F2(ar)2.5 E
+2.5(et)-.18 G -.08(ru)-2.5 G(e.).08 E F4(expr1)144 270 Q F2<ad>2.5 E F1
+(o)A F4(expr2)2.5 E F2 -.78 -.9(Tr u)180 282 T 2.5(ei).9 G 2.5(fe)-2.5 G
+(ither)-2.5 E F4(expr1)2.85 E F2(or)2.5 E F4(expr2)2.85 E F2(is tr)2.5 E
+(ue.)-.08 E F1(test)144 298.8 Q F2(and)3.576 E F1([)3.576 E F2 1.076
+(evaluate conditional expr)3.576 F 1.076(essions using a set of r)-.18 F
+1.076(ules based on the number of)-.08 F(ar)144 310.8 Q(guments.)-.18 E
+2.5(0a)144 328.8 S -.18(rg)-2.5 G(uments).18 E(The expr)180 340.8 Q
+(ession is false.)-.18 E 2.5(1a)144 352.8 S -.18(rg)-2.5 G(ument).18 E
+(The expr)180 364.8 Q(ession is tr)-.18 E(ue if and only if the ar)-.08
+E(gument is not null.)-.18 E 2.5(2a)144 376.8 S -.18(rg)-2.5 G(uments)
+.18 E .208(If the \214rst ar)180 388.8 R .208(gument is)-.18 F F1(!)
+2.708 E F2 2.708(,t)C .208(he expr)-2.708 F .208(ession is tr)-.18 F
+.208(ue if and only if the second ar)-.08 F(gument)-.18 E 2.144
+(is null.)180 400.8 R 2.144(If the \214rst ar)7.144 F 2.144
+(gument is one of the unary conditional operators listed)-.18 F 1.401
+(above under)180 412.8 R F3 1.401(CONDITIONAL EXPRESSIONS)3.901 F F5(,)A
+F2 1.401(the expr)3.651 F 1.401(ession is tr)-.18 F 1.401
+(ue if the unary)-.08 F 1.356(test is tr)180 424.8 R 3.856(ue. If)-.08 F
+1.356(the \214rst ar)3.856 F 1.356
+(gument is not a valid unary conditional operator)-.18 F 3.855(,t)-.74 G
+(he)-3.855 E(expr)180 436.8 Q(ession is false.)-.18 E 2.5(3a)144 448.8 S
+-.18(rg)-2.5 G(uments).18 E 1.499(If the second ar)180 460.8 R 1.499
 (gument is one of the binary conditional operators listed above)-.18 F
-(under)180 310.8 Q F4 .64(CONDITIONAL EXPRESSIONS)3.14 F F5(,)A F2 .64
+(under)180 472.8 Q F3 .64(CONDITIONAL EXPRESSIONS)3.141 F F5(,)A F2 .64
 (the r)2.89 F .64(esult of the expr)-.18 F .64(ession is the r)-.18 F
-.641(esult of)-.18 F .529(the binary test using the \214rst and thir)180
-322.8 R 3.029(da)-.18 G -.18(rg)-3.029 G .528(uments as operands.).18 F
-.528(If the \214rst ar)5.528 F(gu-)-.18 E .106(ment is)180 334.8 R F3(!)
-2.606 E F2 2.606(,t)C .107(he value is the negation of the two-ar)-2.606
-F .107(gument test using the second and)-.18 F(thir)180 346.8 Q 4.633
-(da)-.18 G -.18(rg)-4.633 G 4.633(uments. If).18 F 2.133(the \214rst ar)
-4.633 F 2.132(gument is exactly)-.18 F F3(\()4.632 E F2 2.132
-(and the thir)4.632 F 4.632(da)-.18 G -.18(rg)-4.632 G 2.132(ument is)
-.18 F(exactly)180 358.8 Q F3(\))2.925 E F2 2.925(,t)C .426(he r)-2.925 F
+.64(esult of)-.18 F .528(the binary test using the \214rst and thir)180
+484.8 R 3.029(da)-.18 G -.18(rg)-3.029 G .529(uments as operands.).18 F
+.529(If the \214rst ar)5.529 F(gu-)-.18 E .107(ment is)180 496.8 R F1(!)
+2.607 E F2 2.607(,t)C .107(he value is the negation of the two-ar)-2.607
+F .106(gument test using the second and)-.18 F(thir)180 508.8 Q 4.632
+(da)-.18 G -.18(rg)-4.632 G 4.632(uments. If).18 F 2.132(the \214rst ar)
+4.632 F 2.132(gument is exactly)-.18 F F1(\()4.632 E F2 2.133
+(and the thir)4.632 F 4.633(da)-.18 G -.18(rg)-4.633 G 2.133(ument is)
+.18 F(exactly)180 520.8 Q F1(\))2.926 E F2 2.926(,t)C .426(he r)-2.926 F
 .426(esult is the one-ar)-.18 F .426(gument test of the second ar)-.18 F
-2.926(gument. Otherwise,)-.18 F .43(the expr)180 370.8 R .43
-(ession is false.)-.18 F(The)5.43 E F3<ad61>2.93 E F2(and)2.93 E F3
+2.925(gument. Otherwise,)-.18 F .43(the expr)180 532.8 R .43
+(ession is false.)-.18 F(The)5.43 E F1<ad61>2.93 E F2(and)2.93 E F1
 <ad6f>2.93 E F2 .43(operators ar)2.93 F 2.93(ec)-.18 G(onsider)-2.93 E
-.43(ed binary operators)-.18 F(in this case.)180 382.8 Q 2.5(4a)144
-394.8 S -.18(rg)-2.5 G(uments).18 E .668(If the \214rst ar)180 406.8 R
-.668(gument is)-.18 F F3(!)3.168 E F2 3.168(,t)C .669(he r)-3.168 F .669
-(esult is the negation of the thr)-.18 F(ee-ar)-.18 E .669(gument expr)
--.18 F(es-)-.18 E .409(sion composed of the r)180 418.8 R .409
+.43(ed binary operators)-.18 F(in this case.)180 544.8 Q 2.5(4a)144
+556.8 S -.18(rg)-2.5 G(uments).18 E .669(If the \214rst ar)180 568.8 R
+.669(gument is)-.18 F F1(!)3.169 E F2 3.169(,t)C .669(he r)-3.169 F .668
+(esult is the negation of the thr)-.18 F(ee-ar)-.18 E .668(gument expr)
+-.18 F(es-)-.18 E .409(sion composed of the r)180 580.8 R .409
 (emaining ar)-.18 F 2.909(guments. Otherwise,)-.18 F .409(the expr)2.909
-F .409(ession is parsed)-.18 F(and evaluated accor)180 430.8 Q
+F .409(ession is parsed)-.18 F(and evaluated accor)180 592.8 Q
 (ding to pr)-.18 E(ecedence using the r)-.18 E(ules listed above.)-.08 E
-2.5(5o)144 442.8 S 2.5(rm)-2.5 G(or)-2.5 E 2.5(ea)-.18 G -.18(rg)-2.5 G
-(uments).18 E .781(The expr)180 454.8 R .782
-(ession is parsed and evaluated accor)-.18 F .782(ding to pr)-.18 F .782
-(ecedence using the r)-.18 F(ules)-.08 E(listed above.)180 466.8 Q F3
-(times)108 483.6 Q F2 .334
+2.5(5o)144 604.8 S 2.5(rm)-2.5 G(or)-2.5 E 2.5(ea)-.18 G -.18(rg)-2.5 G
+(uments).18 E .782(The expr)180 616.8 R .782
+(ession is parsed and evaluated accor)-.18 F .782(ding to pr)-.18 F .781
+(ecedence using the r)-.18 F(ules)-.08 E(listed above.)180 628.8 Q F1
+(times)108 645.6 Q F2 .334
 (Print the accumulated user and system times for the shell and for pr)
 11.01 F .334(ocesses r)-.18 F .334(un fr)-.08 F .334(om the)-.18 F 2.5
-(shell. The)144 495.6 R -.18(re)2.5 G(turn status is 0.).18 E F3(trap)
-108 512.4 Q F2([)2.5 E F3(\255lp)A F2 2.5(][)C([)-2.5 E F1(ar)A(g)-.18 E
-F2(])A F1(sigspec)2.5 E F2(...])2.5 E .563(The command)144 524.4 R F1
-(ar)3.523 E(g)-.18 E F2 .563(is to be r)3.543 F .563
-(ead and executed when the shell r)-.18 F .564(eceives signal\(s\))-.18
-F F1(sigspec)3.064 E F2 5.564(.I).32 G(f)-5.564 E F1(ar)144.46 536.4 Q
-(g)-.18 E F2 .153(is absent \(and ther)3.133 F 2.653(ei)-.18 G 2.653
-(sas)-2.653 G(ingle)-2.653 E F1(sigspec)2.653 E F2 2.653(\)o)C(r)-2.653
-E F3<ad>2.653 E F2 2.653(,e)C .153(ach speci\214ed signal is r)-2.653 F
-.152(eset to its original)-.18 F .069
-(disposition \(the value it had upon entrance to the shell\).)144 548.4
-R(If)5.069 E F1(ar)3.03 E(g)-.18 E F2 .07(is the null string the signal)
-3.05 F .142(speci\214ed by each)144 560.4 R F1(sigspec)3.052 E F2 .142
-(is ignor)2.962 F .142(ed by the shell and by the commands it invokes.)
--.18 F(If)5.141 E F1(ar)3.101 E(g)-.18 E F2(is)3.121 E 1.795(not pr)144
-572.4 R 1.795(esent and)-.18 F F3<ad70>4.295 E F2 1.796
-(has been supplied, then the trap commands associated with each)4.295 F
-F1(sigspec)144.41 584.4 Q F2(ar)3.218 E 2.898(ed)-.18 G 2.898
-(isplayed. If)-2.898 F .398(no ar)2.898 F .398(guments ar)-.18 F 2.898
-(es)-.18 G .397(upplied or if only)-2.898 F F3<ad70>2.897 E F2 .397
-(is given,)2.897 F F3(trap)2.897 E F2 .397(prints the)2.897 F .035
-(list of commands associated with each signal.)144 596.4 R(The)5.036 E
-F3<ad6c>2.536 E F2 .036(option causes the shell to print a list)2.536 F
-1.095(of signal names and their corr)144 608.4 R 1.095
-(esponding numbers.)-.18 F(Each)6.095 E F1(sigspec)4.005 E F2 1.094
-(is either a signal name)3.914 F .672(de\214ned in <)144 620.4 R F1
-(signal.h)A F2 .673(>, or a signal number)B 5.673(.S)-.74 G .673
-(ignal names ar)-5.673 F 3.173(ec)-.18 G .673
-(ase insensitive and the SIG)-3.173 F(pr)144 632.4 Q .977
-(e\214x is optional.)-.18 F .976(If a)5.976 F F1(sigspec)3.886 E F2(is)
-3.796 E F4(EXIT)3.476 E F2 .976(\(0\) the command)3.226 F F1(ar)3.936 E
-(g)-.18 E F2 .976(is executed on exit fr)3.956 F .976(om the)-.18 F
-3.404(shell. If)144 644.4 R(a)3.404 E F1(sigspec)3.814 E F2(is)3.724 E
-F4(DEBUG)3.404 E F5(,)A F2 .904(the command)3.154 F F1(ar)3.864 E(g)-.18
-E F2 .905(is executed befor)3.885 F 3.405(ee)-.18 G(very)-3.405 E F1
-.905(simple command)3.405 F F2(,)A F1(for)144 656.4 Q F2(command,)3.016
-E F1(case)3.016 E F2(command,)3.016 E F1(select)3.016 E F2 .515
-(command, every arithmetic)3.016 F F1(for)3.015 E F2 .515
-(command, and befor)3.015 F(e)-.18 E 1.001
-(the \214rst command executes in a shell function \(see)144 668.4 R F4
-1.001(SHELL GRAMMAR)3.501 F F2 3.501(above\). Refer)3.251 F(to)3.501 E
-.679(the description of the)144 680.4 R F3(extdebug)3.178 E F2 .678
-(option to the)3.178 F F3(shopt)3.178 E F2 .678
-(builtin for details of its ef)3.178 F .678(fect on the)-.18 F F3(DEBUG)
-144 692.4 Q F2 3.153(trap. If)3.153 F(a)3.153 E F1(sigspec)3.563 E F2
-(is)3.473 E F4(ERR)3.153 E F5(,)A F2 .653(the command)2.903 F F1(ar)
-3.613 E(g)-.18 E F2 .653(is executed whenever a simple com-)3.633 F .241
-(mand has a non\255zer)144 704.4 R 2.741(oe)-.18 G .24
-(xit status, subject to the following conditions.)-2.741 F(The)5.24 E F4
-(ERR)2.74 E F2 .24(trap is not)2.49 F 1.926(executed if the failed comm\
-and is part of the command list immediately following a)144 716.4 R F3
-(while)144 728.4 Q F2(or)2.552 E F3(until)2.552 E F2(keywor)2.552 E .052
-(d, part of the test in an)-.18 F F1(if)2.712 E F2 .052
-(statement, part of a)4.402 F F3(&&)2.552 E F2(or)2.552 E/F6 10/Symbol
-SF<efef>2.552 E F2 .051(list, or if the)2.552 F F0(GNU Bash-3.0)72 768 Q
-(2004 Apr 20)148.735 E(17)198.725 E 0 Cg EP
+(shell. The)144 657.6 R -.18(re)2.5 G(turn status is 0.).18 E F1(trap)
+108 674.4 Q F2([)2.5 E F1(\255lp)A F2 2.5(][)C([)-2.5 E F4(ar)A(g)-.18 E
+F2(])A F4(sigspec)2.5 E F2(...])2.5 E .564(The command)144 686.4 R F4
+(ar)3.524 E(g)-.18 E F2 .564(is to be r)3.544 F .563
+(ead and executed when the shell r)-.18 F .563(eceives signal\(s\))-.18
+F F4(sigspec)3.063 E F2 5.563(.I).32 G(f)-5.563 E F4(ar)144.46 698.4 Q
+(g)-.18 E F2 .152(is absent \(and ther)3.132 F 2.653(ei)-.18 G 2.653
+(sas)-2.653 G(ingle)-2.653 E F4(sigspec)2.653 E F2 2.653(\)o)C(r)-2.653
+E F1<ad>2.653 E F2 2.653(,e)C .153(ach speci\214ed signal is r)-2.653 F
+.153(eset to its original)-.18 F .07
+(disposition \(the value it had upon entrance to the shell\).)144 710.4
+R(If)5.069 E F4(ar)3.029 E(g)-.18 E F2 .069
+(is the null string the signal)3.049 F .141(speci\214ed by each)144
+722.4 R F4(sigspec)3.051 E F2 .142(is ignor)2.961 F .142
+(ed by the shell and by the commands it invokes.)-.18 F(If)5.142 E F4
+(ar)3.102 E(g)-.18 E F2(is)3.122 E F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)
+148.735 E(17)198.725 E 0 Cg EP
 %%Page: 18 18
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
-/Palatino-Roman@0 SF .092(command's r)144 84 R .092
-(eturn value is being inverted via)-.18 F/F2 10/Palatino-Bold@0 SF(!)
-2.592 E F1 5.092(.T)C .092(hese ar)-5.092 F 2.592(et)-.18 G .092
-(he same conditions obeyed by)-2.592 F(the)144 96 Q F2(errexit)2.825 E
-F1 2.825(option. If)2.825 F(a)2.825 E/F3 10/Palatino-Italic@0 SF
-(sigspec)3.235 E F1(is)3.145 E/F4 9/Palatino-Bold@0 SF(RETURN)2.825 E/F5
-9/Palatino-Roman@0 SF(,)A F1 .325(the command)2.575 F F3(ar)3.284 E(g)
--.18 E F1 .324(is executed each time a shell)3.304 F 1.95
-(function or a script executed with the)144 108 R F2(.)4.451 E F1(or)
-4.451 E F2(source)4.451 E F1 1.951(builtins \214nishes executing.)4.451
-F(Signals)6.951 E(ignor)144 120 Q .847
-(ed upon entry to the shell cannot be trapped or r)-.18 F 3.346(eset. T)
--.18 F .846(rapped signals ar)-.9 F 3.346(er)-.18 G .846(eset to)-3.526
-F .298(their original values in a child pr)144 132 R .299
-(ocess when it is cr)-.18 F 2.799(eated. The)-.18 F -.18(re)2.799 G .299
-(turn status is false if any).18 F F3(sigspec)144.41 144 Q F1
+/Palatino-Roman@0 SF 1.796(not pr)144 84 R 1.796(esent and)-.18 F/F2 10
+/Palatino-Bold@0 SF<ad70>4.296 E F1 1.795
+(has been supplied, then the trap commands associated with each)4.296 F
+/F3 10/Palatino-Italic@0 SF(sigspec)144.41 96 Q F1(ar)3.217 E 2.897(ed)
+-.18 G 2.897(isplayed. If)-2.897 F .397(no ar)2.897 F .397(guments ar)
+-.18 F 2.897(es)-.18 G .398(upplied or if only)-2.897 F F2<ad70>2.898 E
+F1 .398(is given,)2.898 F F2(trap)2.898 E F1 .398(prints the)2.898 F
+.036(list of commands associated with each signal.)144 108 R(The)5.036 E
+F2<ad6c>2.536 E F1 .035(option causes the shell to print a list)2.536 F
+1.094(of signal names and their corr)144 120 R 1.095(esponding numbers.)
+-.18 F(Each)6.095 E F3(sigspec)4.005 E F1 1.095(is either a signal name)
+3.915 F .673(de\214ned in <)144 132 R F3(signal.h)A F1 .673
+(>, or a signal number)B 5.673(.S)-.74 G .673(ignal names ar)-5.673 F
+3.173(ec)-.18 G .673(ase insensitive and the SIG)-3.173 F(pr)144 144 Q
+.976(e\214x is optional.)-.18 F .976(If a)5.976 F F3(sigspec)3.886 E F1
+(is)3.796 E/F4 9/Palatino-Bold@0 SF(EXIT)3.476 E F1 .976
+(\(0\) the command)3.226 F F3(ar)3.936 E(g)-.18 E F1 .976
+(is executed on exit fr)3.956 F .977(om the)-.18 F 3.405(shell. If)144
+156 R(a)3.405 E F3(sigspec)3.815 E F1(is)3.725 E F4(DEBUG)3.405 E/F5 9
+/Palatino-Roman@0 SF(,)A F1 .904(the command)3.155 F F3(ar)3.864 E(g)
+-.18 E F1 .904(is executed befor)3.884 F 3.404(ee)-.18 G(very)-3.404 E
+F3 .904(simple command)3.404 F F1(,)A F3(for)144 168 Q F1(command,)3.015
+E F3(case)3.015 E F1(command,)3.015 E F3(select)3.015 E F1 .515
+(command, every arithmetic)3.015 F F3(for)3.016 E F1 .516
+(command, and befor)3.016 F(e)-.18 E 1.001
+(the \214rst command executes in a shell function \(see)144 180 R F4
+1.001(SHELL GRAMMAR)3.501 F F1 3.5(above\). Refer)3.25 F(to)3.5 E .678
+(the description of the)144 192 R F2(extdebug)3.178 E F1 .678
+(option to the)3.178 F F2(shopt)3.178 E F1 .678
+(builtin for details of its ef)3.178 F .679(fect on the)-.18 F F2(DEBUG)
+144 204 Q F1 3.153(trap. If)3.153 F(a)3.153 E F3(sigspec)3.563 E F1(is)
+3.473 E F4(ERR)3.153 E F5(,)A F1 .653(the command)2.903 F F3(ar)3.613 E
+(g)-.18 E F1 .653(is executed whenever a simple com-)3.633 F .24
+(mand has a non\255zer)144 216 R 2.74(oe)-.18 G .24
+(xit status, subject to the following conditions.)-2.74 F(The)5.241 E F4
+(ERR)2.741 E F1 .241(trap is not)2.491 F 1.926(executed if the failed c\
+ommand is part of the command list immediately following a)144 228 R F2
+(while)144 240 Q F1(or)2.551 E F2(until)2.551 E F1(keywor)2.552 E .052
+(d, part of the test in an)-.18 F F3(if)2.712 E F1 .052
+(statement, part of a)4.402 F F2(&&)2.552 E F1(or)2.552 E/F6 10/Symbol
+SF<efef>2.552 E F1 .052(list, or if the)2.552 F .093(command's r)144 252
+R .092(eturn value is being inverted via)-.18 F F2(!)2.592 E F1 5.092
+(.T)C .092(hese ar)-5.092 F 2.592(et)-.18 G .092
+(he same conditions obeyed by)-2.592 F(the)144 264 Q F2(errexit)2.824 E
+F1 2.824(option. If)2.824 F(a)2.824 E F3(sigspec)3.234 E F1(is)3.144 E
+F4(RETURN)2.824 E F5(,)A F1 .325(the command)2.575 F F3(ar)3.285 E(g)
+-.18 E F1 .325(is executed each time a shell)3.305 F 1.951
+(function or a script executed with the)144 276 R F2(.)4.451 E F1(or)
+4.451 E F2(source)4.451 E F1 1.95(builtins \214nishes executing.)4.451 F
+(Signals)6.95 E(ignor)144 288 Q .846
+(ed upon entry to the shell cannot be trapped or r)-.18 F 3.347(eset. T)
+-.18 F .847(rapped signals ar)-.9 F 3.347(er)-.18 G .847(eset to)-3.527
+F .299(their original values in a child pr)144 300 R .299
+(ocess when it is cr)-.18 F 2.799(eated. The)-.18 F -.18(re)2.799 G .298
+(turn status is false if any).18 F F3(sigspec)144.41 312 Q F1
 (is invalid; otherwise)2.82 E F2(trap)2.5 E F1 -.18(re)2.5 G(turns tr)
-.18 E(ue.)-.08 E F2(type)108 160.8 Q F1([)2.5 E F2(\255aftpP)A F1(])A F3
-(name)2.5 E F1([)2.5 E F3(name)A F1(...])2.5 E -.55(Wi)144 172.8 S 1.476
+.18 E(ue.)-.08 E F2(type)108 328.8 Q F1([)2.5 E F2(\255aftpP)A F1(])A F3
+(name)2.5 E F1([)2.5 E F3(name)A F1(...])2.5 E -.55(Wi)144 340.8 S 1.475
 (th no options, indicate how each).55 F F3(name)4.236 E F1 1.476
-(would be interpr)4.326 F 1.475(eted if used as a command)-.18 F 2.725
-(name. If)144 184.8 R(the)2.725 E F2<ad74>2.725 E F1 .225
-(option is used,)2.725 F F2(type)2.725 E F1 .225
-(prints a string which is one of)2.725 F F3(alias)2.726 E F1(,).06 E F3
-(keyword)2.726 E F1(,).33 E F3(function)2.726 E F1(,).08 E F3(builtin)
-144 196.8 Q F1 2.556(,o).08 G(r)-2.556 E F3(\214le)4.676 E F1(if)2.906 E
-F3(name)2.816 E F1 .056(is an alias, shell r)2.906 F .056(eserved wor)
--.18 F .055(d, function, builtin, or disk \214le, r)-.18 F(espec-)-.18 E
-(tively)144 208.8 Q 6.634(.I)-1.11 G 4.134(ft)-6.634 G(he)-4.134 E F3
-(name)4.394 E F1 1.635
+(would be interpr)4.326 F 1.476(eted if used as a command)-.18 F 2.726
+(name. If)144 352.8 R(the)2.726 E F2<ad74>2.726 E F1 .226
+(option is used,)2.726 F F2(type)2.725 E F1 .225
+(prints a string which is one of)2.725 F F3(alias)2.725 E F1(,).06 E F3
+(keyword)2.725 E F1(,).33 E F3(function)2.725 E F1(,).08 E F3(builtin)
+144 364.8 Q F1 2.555(,o).08 G(r)-2.555 E F3(\214le)4.675 E F1(if)2.905 E
+F3(name)2.815 E F1 .056(is an alias, shell r)2.905 F .056(eserved wor)
+-.18 F .056(d, function, builtin, or disk \214le, r)-.18 F(espec-)-.18 E
+(tively)144 376.8 Q 6.635(.I)-1.11 G 4.135(ft)-6.635 G(he)-4.135 E F3
+(name)4.395 E F1 1.635
 (is not found, then nothing is printed, and an exit status of false is)
-4.484 F -.18(re)144 220.8 S 2.523(turned. If).18 F(the)2.523 E F2<ad70>
+4.485 F -.18(re)144 388.8 S 2.522(turned. If).18 F(the)2.523 E F2<ad70>
 2.523 E F1 .023(option is used,)2.523 F F2(type)2.523 E F1 .023
 (either r)2.523 F .023(eturns the name of the disk \214le that would)
--.18 F 1.086(be executed if)144 232.8 R F3(name)3.846 E F1(wer)3.936 E
+-.18 F 1.086(be executed if)144 400.8 R F3(name)3.846 E F1(wer)3.936 E
 3.586(es)-.18 G 1.086(peci\214ed as a command name, or nothing if)-3.586
-F/F6 10/Courier@0 SF 1.086(type -t name)3.586 F F1 .016(would not r)144
-244.8 R(eturn)-.18 E F3(\214le)2.516 E F1 5.016(.T).35 G(he)-5.016 E F2
-<ad50>2.516 E F1 .016(option for)2.516 F .016(ces a)-.18 F F4 -.666(PA)
-2.515 G(TH)-.162 E F1(sear)2.265 E .015(ch for each)-.18 F F3(name)2.515
-E F1 2.515(,e)C .015(ven if)-2.515 F F6 .015(type -t)2.515 F(name)144
-256.8 Q F1 .645(would not r)3.145 F(eturn)-.18 E F3(\214le)3.145 E F1
+F/F7 10/Courier@0 SF 1.086(type -t name)3.586 F F1 .015(would not r)144
+412.8 R(eturn)-.18 E F3(\214le)2.515 E F1 5.015(.T).35 G(he)-5.015 E F2
+<ad50>2.515 E F1 .015(option for)2.515 F .015(ces a)-.18 F F4 -.666(PA)
+2.515 G(TH)-.162 E F1(sear)2.266 E .016(ch for each)-.18 F F3(name)2.516
+E F1 2.516(,e)C .016(ven if)-2.516 F F7 .016(type -t)2.516 F(name)144
+424.8 Q F1 .645(would not r)3.145 F(eturn)-.18 E F3(\214le)3.145 E F1
 5.645(.I).35 G 3.145(fac)-5.645 G .645(ommand is hashed,)-3.145 F F2
 <ad70>3.145 E F1(and)3.145 E F2<ad50>3.145 E F1 .645
-(print the hashed value,)3.145 F .411
-(not necessarily the \214le that appears \214rst in)144 268.8 R F4 -.666
+(print the hashed value,)3.145 F .41
+(not necessarily the \214le that appears \214rst in)144 436.8 R F4 -.666
 (PA)2.911 G(TH)-.162 E F5(.)A F1 .411(If the)4.911 F F2<ad61>2.911 E F1
-.411(option is used,)2.911 F F2(type)2.91 E F1 .41(prints all)2.91 F
-.164(of the places that contain an executable named)144 280.8 R F3(name)
+.411(option is used,)2.911 F F2(type)2.911 E F1 .411(prints all)2.911 F
+.164(of the places that contain an executable named)144 448.8 R F3(name)
 2.664 E F1 5.164(.T).35 G .164(his includes aliases and functions,)
--5.164 F .73(if and only if the)144 292.8 R F2<ad70>3.23 E F1 .73
+-5.164 F .73(if and only if the)144 460.8 R F2<ad70>3.23 E F1 .73
 (option is not also used.)3.23 F .73
-(The table of hashed commands is not con-)5.73 F .497(sulted when using)
-144 304.8 R F2<ad61>2.998 E F1 5.498(.T)C(he)-5.498 E F2<ad66>2.998 E F1
+(The table of hashed commands is not con-)5.73 F .498(sulted when using)
+144 472.8 R F2<ad61>2.998 E F1 5.498(.T)C(he)-5.498 E F2<ad66>2.998 E F1
 .498(option suppr)2.998 F .498(esses shell function lookup, as with the)
--.18 F F2(com-)2.998 E(mand)144 316.8 Q F1(builtin.)4.558 E F2(type)
-7.058 E F1 -.18(re)4.558 G 2.058(turns tr).18 F 2.057
-(ue if any of the ar)-.08 F 2.057(guments ar)-.18 F 4.557(ef)-.18 G
-2.057(ound, false if none ar)-4.557 F(e)-.18 E(found.)144 328.8 Q F2
-(ulimit)108 345.6 Q F1([)2.5 E F2(\255SHacd\215mnpstuv)A F1([)2.5 E F3
-(limit)A F1(]])A(Pr)144 357.6 Q .061(ovides contr)-.18 F .061
+-.18 F F2(com-)2.997 E(mand)144 484.8 Q F1(builtin.)4.557 E F2(type)
+7.057 E F1 -.18(re)4.557 G 2.057(turns tr).18 F 2.057
+(ue if any of the ar)-.08 F 2.057(guments ar)-.18 F 4.558(ef)-.18 G
+2.058(ound, false if none ar)-4.558 F(e)-.18 E(found.)144 496.8 Q F2
+(ulimit)108 513.6 Q F1([)2.5 E F2(\255SHacd\215mnpstuv)A F1([)2.5 E F3
+(limit)A F1(]])A(Pr)144 525.6 Q .062(ovides contr)-.18 F .062
 (ol over the r)-.18 F(esour)-.18 E .061
-(ces available to the shell and to pr)-.18 F .062
-(ocesses started by it, on)-.18 F 1.497(systems that allow such contr)
-144 369.6 R 3.997(ol. The)-.18 F F2<ad48>3.997 E F1(and)3.997 E F2<ad53>
-3.997 E F1 1.496(options specify that the har)3.997 F 3.996(do)-.18 G
-3.996(rs)-3.996 G(oft)-3.996 E .884(limit is set for the given r)144
-381.6 R(esour)-.18 E 3.384(ce. A)-.18 F(har)3.384 E 3.384(dl)-.18 G .884
+(ces available to the shell and to pr)-.18 F .061
+(ocesses started by it, on)-.18 F 1.496(systems that allow such contr)
+144 537.6 R 3.996(ol. The)-.18 F F2<ad48>3.997 E F1(and)3.997 E F2<ad53>
+3.997 E F1 1.497(options specify that the har)3.997 F 3.997(do)-.18 G
+3.997(rs)-3.997 G(oft)-3.997 E .884(limit is set for the given r)144
+549.6 R(esour)-.18 E 3.384(ce. A)-.18 F(har)3.384 E 3.384(dl)-.18 G .884
 (imit cannot be incr)-3.384 F .884(eased once it is set; a soft)-.18 F
-.089(limit may be incr)144 393.6 R .088
+.088(limit may be incr)144 561.6 R .088
 (eased up to the value of the har)-.18 F 2.588(dl)-.18 G 2.588(imit. If)
--2.588 F(neither)2.588 E F2<ad48>2.588 E F1(nor)2.588 E F2<ad53>2.588 E
-F1 .088(is speci\214ed,)2.588 F .162(both the soft and har)144 405.6 R
-2.662(dl)-.18 G .162(imits ar)-2.662 F 2.662(es)-.18 G 2.663(et. The)
--2.662 F .163(value of)2.663 F F3(limit)2.803 E F1 .163
-(can be a number in the unit speci-)2.933 F .176(\214ed for the r)144
-417.6 R(esour)-.18 E .176(ce or one of the special values)-.18 F F2
-(hard)2.676 E F1(,)A F2(soft)2.675 E F1 2.675(,o)C(r)-2.675 E F2
-(unlimited)2.675 E F1 2.675(,w)C .175(hich stand for)-2.675 F .242
-(the curr)144 429.6 R .242(ent har)-.18 F 2.742(dl)-.18 G .242
-(imit, the curr)-2.742 F .243(ent soft limit, and no limit, r)-.18 F
-(espectively)-.18 E 5.243(.I)-1.11 G(f)-5.243 E F3(limit)2.883 E F1 .243
-(is omitted,)3.013 F .082(the curr)144 441.6 R .081
+-2.588 F(neither)2.589 E F2<ad48>2.589 E F1(nor)2.589 E F2<ad53>2.589 E
+F1 .089(is speci\214ed,)2.589 F .163(both the soft and har)144 573.6 R
+2.663(dl)-.18 G .163(imits ar)-2.663 F 2.663(es)-.18 G 2.663(et. The)
+-2.663 F .163(value of)2.663 F F3(limit)2.803 E F1 .162
+(can be a number in the unit speci-)2.933 F .175(\214ed for the r)144
+585.6 R(esour)-.18 E .175(ce or one of the special values)-.18 F F2
+(hard)2.676 E F1(,)A F2(soft)2.676 E F1 2.676(,o)C(r)-2.676 E F2
+(unlimited)2.676 E F1 2.676(,w)C .176(hich stand for)-2.676 F .243
+(the curr)144 597.6 R .243(ent har)-.18 F 2.743(dl)-.18 G .243
+(imit, the curr)-2.743 F .243(ent soft limit, and no limit, r)-.18 F
+(espectively)-.18 E 5.242(.I)-1.11 G(f)-5.242 E F3(limit)2.882 E F1 .242
+(is omitted,)3.012 F .081(the curr)144 609.6 R .081
 (ent value of the soft limit of the r)-.18 F(esour)-.18 E .081
-(ce is printed, unless the)-.18 F F2<ad48>2.581 E F1 .081
-(option is given.)2.581 F .329(When mor)144 453.6 R 2.829(et)-.18 G .329
-(han one r)-2.829 F(esour)-.18 E .329
-(ce is speci\214ed, the limit name and unit ar)-.18 F 2.83(ep)-.18 G .33
-(rinted befor)-2.83 F 2.83(et)-.18 G(he)-2.83 E 2.5(value. Other)144
-465.6 R(options ar)2.5 E 2.5(ei)-.18 G(nterpr)-2.5 E(eted as follows:)
--.18 E F2<ad61>144 477.6 Q F1(All curr)24.94 E(ent limits ar)-.18 E 2.5
-(er)-.18 G(eported)-2.68 E F2<ad63>144 489.6 Q F1
-(The maximum size of cor)25.5 E 2.5<658c>-.18 G(les cr)-2.5 E(eated)-.18
-E F2<ad64>144 501.6 Q F1(The maximum size of a pr)23.83 E
-(ocess's data segment)-.18 E F2<ad66>144 513.6 Q F1
+(ce is printed, unless the)-.18 F F2<ad48>2.581 E F1 .082
+(option is given.)2.582 F .33(When mor)144 621.6 R 2.83(et)-.18 G .33
+(han one r)-2.83 F(esour)-.18 E .329
+(ce is speci\214ed, the limit name and unit ar)-.18 F 2.829(ep)-.18 G
+.329(rinted befor)-2.829 F 2.829(et)-.18 G(he)-2.829 E 2.5(value. Other)
+144 633.6 R(options ar)2.5 E 2.5(ei)-.18 G(nterpr)-2.5 E
+(eted as follows:)-.18 E F2<ad61>144 645.6 Q F1(All curr)24.94 E
+(ent limits ar)-.18 E 2.5(er)-.18 G(eported)-2.68 E F2<ad63>144 657.6 Q
+F1(The maximum size of cor)25.5 E 2.5<658c>-.18 G(les cr)-2.5 E(eated)
+-.18 E F2<ad64>144 669.6 Q F1(The maximum size of a pr)23.83 E
+(ocess's data segment)-.18 E F2<ad66>144 681.6 Q F1
 (The maximum size of \214les cr)26.05 E(eated by the shell)-.18 E F2
-<ad6c>144 525.6 Q F1(The maximum size that may be locked into memory)
-26.61 E F2<ad6d>144 537.6 Q F1(The maximum r)21.05 E(esident set size)
--.18 E F2<ad6e>144 549.6 Q F1 .958(The maximum number of open \214le de\
+<ad6c>144 693.6 Q F1(The maximum size that may be locked into memory)
+26.61 E F2<ad6d>144 705.6 Q F1(The maximum r)21.05 E(esident set size)
+-.18 E F2<ad6e>144 717.6 Q F1 .958(The maximum number of open \214le de\
 scriptors \(most systems do not allow this)23.83 F(value to be set\))180
-561.6 Q F2<ad70>144 573.6 Q F1
-(The pipe size in 512-byte blocks \(this may not be set\))23.83 E F2
-<ad73>144 585.6 Q F1(The maximum stack size)25.5 E F2<ad74>144 597.6 Q
-F1(The maximum amount of cpu time in seconds)26.61 E F2<ad75>144 609.6 Q
-F1(The maximum number of pr)23.83 E(ocesses available to a single user)
--.18 E F2<ad76>144 621.6 Q F1
-(The maximum amount of virtual memory available to the shell)24.38 E(If)
-144 638.4 Q F3(limit)4.15 E F1 1.51
-(is given, it is the new value of the speci\214ed r)4.28 F(esour)-.18 E
-1.511(ce \(the)-.18 F F2<ad61>4.011 E F1 1.511(option is display)4.011 F
-4.315(only\). If)144 650.4 R 1.815(no option is given, then)4.315 F F2
-<ad66>4.315 E F1 1.815(is assumed.)4.315 F -.92(Va)6.815 G 1.815
-(lues ar).92 F 4.315(ei)-.18 G 4.315(n1)-4.315 G 1.815(024-byte incr)
--4.315 F(ements,)-.18 E .972(except for)144 662.4 R F2<ad74>3.473 E F1
-3.473(,w)C .973(hich is in seconds,)-3.473 F F2<ad70>3.473 E F1 3.473
-(,w)C .973(hich is in units of 512-byte blocks, and)-3.473 F F2<ad6e>
-3.473 E F1(and)3.473 E F2<ad75>144 674.4 Q F1 3.518(,w)C 1.018(hich ar)
--3.518 F 3.518(eu)-.18 G 1.018(nscaled values.)-3.518 F 1.017(The r)
-6.018 F 1.017(eturn status is 0 unless an invalid option or ar)-.18 F
-(gu-)-.18 E(ment is supplied, or an err)144 686.4 Q
-(or occurs while setting a new limit.)-.18 E F2(umask)108 703.2 Q F1([)
-2.5 E F2<ad70>A F1 2.5(][)C F2<ad53>-2.5 E F1 2.5(][)C F3(mode)-2.5 E F1
-(])A .535(The user \214le-cr)144 715.2 R .535(eation mask is set to)-.18
-F F3(mode)3.035 E F1 5.535(.I).35 G(f)-5.535 E F3(mode)3.295 E F1 .536
-(begins with a digit, it is interpr)3.385 F .536(eted as)-.18 F 1.827
-(an octal number; otherwise it is interpr)144 727.2 R 1.826
-(eted as a symbolic mode mask similar to that)-.18 F F0(GNU Bash-3.0)72
-768 Q(2004 Apr 20)148.735 E(18)198.725 E 0 Cg EP
+729.6 Q F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(18)198.725 E 0 Cg
+EP
 %%Page: 19 19
 %%BeginPageSetup
 BP
 %%EndPageSetup
 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
-/Palatino-Roman@0 SF .95(accepted by)144 84 R/F2 10/Palatino-Italic@0 SF
-(chmod)3.45 E F1 3.45(\(1\). If).33 F F2(mode)3.71 E F1 .951
-(is omitted, the curr)3.8 F .951(ent value of the mask is printed.)-.18
-F(The)5.951 E/F3 10/Palatino-Bold@0 SF<ad53>144 96 Q F1 .607(option cau\
-ses the mask to be printed in symbolic form; the default output is an o\
-ctal)3.107 F(number)144 108 Q 6.02(.I)-.74 G 3.52(ft)-6.02 G(he)-3.52 E
-F3<ad70>3.52 E F1 1.02(option is supplied, and)3.52 F F2(mode)3.78 E F1
-1.02(is omitted, the output is in a form that)3.87 F .237(may be r)144
-120 R .237(eused as input.)-.18 F .237(The r)5.237 F .236
+/Palatino-Bold@0 SF<ad70>144 84 Q/F2 10/Palatino-Roman@0 SF
+(The pipe size in 512-byte blocks \(this may not be set\))23.83 E F1
+<ad73>144 96 Q F2(The maximum stack size)25.5 E F1<ad74>144 108 Q F2
+(The maximum amount of cpu time in seconds)26.61 E F1<ad75>144 120 Q F2
+(The maximum number of pr)23.83 E(ocesses available to a single user)
+-.18 E F1<ad76>144 132 Q F2
+(The maximum amount of virtual memory available to the shell)24.38 E(If)
+144 148.8 Q/F3 10/Palatino-Italic@0 SF(limit)4.151 E F2 1.511
+(is given, it is the new value of the speci\214ed r)4.281 F(esour)-.18 E
+1.51(ce \(the)-.18 F F1<ad61>4.01 E F2 1.51(option is display)4.01 F
+4.315(only\). If)144 160.8 R 1.815(no option is given, then)4.315 F F1
+<ad66>4.315 E F2 1.815(is assumed.)4.315 F -.92(Va)6.815 G 1.815
+(lues ar).92 F 4.315(ei)-.18 G 4.315(n1)-4.315 G 1.815(024-byte incr)
+-4.315 F(ements,)-.18 E .973(except for)144 172.8 R F1<ad74>3.473 E F2
+3.473(,w)C .973(hich is in seconds,)-3.473 F F1<ad70>3.473 E F2 3.473
+(,w)C .973(hich is in units of 512-byte blocks, and)-3.473 F F1<ad6e>
+3.473 E F2(and)3.472 E F1<ad75>144 184.8 Q F2 3.517(,w)C 1.017(hich ar)
+-3.517 F 3.517(eu)-.18 G 1.017(nscaled values.)-3.517 F 1.017(The r)
+6.017 F 1.018(eturn status is 0 unless an invalid option or ar)-.18 F
+(gu-)-.18 E(ment is supplied, or an err)144 196.8 Q
+(or occurs while setting a new limit.)-.18 E F1(umask)108 213.6 Q F2([)
+2.5 E F1<ad70>A F2 2.5(][)C F1<ad53>-2.5 E F2 2.5(][)C F3(mode)-2.5 E F2
+(])A .536(The user \214le-cr)144 225.6 R .536(eation mask is set to)-.18
+F F3(mode)3.035 E F2 5.535(.I).35 G(f)-5.535 E F3(mode)3.295 E F2 .535
+(begins with a digit, it is interpr)3.385 F .535(eted as)-.18 F 1.826
+(an octal number; otherwise it is interpr)144 237.6 R 1.827
+(eted as a symbolic mode mask similar to that)-.18 F .951(accepted by)
+144 249.6 R F3(chmod)3.451 E F2 3.451(\(1\). If).33 F F3(mode)3.711 E F2
+.951(is omitted, the curr)3.801 F .95(ent value of the mask is printed.)
+-.18 F(The)5.95 E F1<ad53>144 261.6 Q F2 .607(option causes the mask to\
+ be printed in symbolic form; the default output is an octal)3.106 F
+(number)144 273.6 Q 6.02(.I)-.74 G 3.52(ft)-6.02 G(he)-3.52 E F1<ad70>
+3.52 E F2 1.02(option is supplied, and)3.52 F F3(mode)3.78 E F2 1.02
+(is omitted, the output is in a form that)3.87 F .236(may be r)144 285.6
+R .236(eused as input.)-.18 F .236(The r)5.236 F .237
 (eturn status is 0 if the mode was successfully changed or if)-.18 F(no)
-144 132 Q F2(mode)2.5 E F1(ar)2.5 E
-(gument was supplied, and false otherwise.)-.18 E F3(unalias)108 148.8 Q
-F1<5bad>2.5 E F3(a)A F1 2.5(][)C F2(name)-2.5 E F1(...])2.5 E .718
-(Remove each)144 160.8 R F2(name)3.218 E F1(fr)3.218 E .719
-(om the list of de\214ned aliases.)-.18 F(If)5.719 E F3<ad61>3.219 E F1
-.719(is supplied, all alias de\214nitions)3.219 F(ar)144 172.8 Q 2.5(er)
+144 297.6 Q F3(mode)2.5 E F2(ar)2.5 E
+(gument was supplied, and false otherwise.)-.18 E F1(unalias)108 314.4 Q
+F2<5bad>2.5 E F1(a)A F2 2.5(][)C F3(name)-2.5 E F2(...])2.5 E .719
+(Remove each)144 326.4 R F3(name)3.219 E F2(fr)3.219 E .719
+(om the list of de\214ned aliases.)-.18 F(If)5.719 E F1<ad61>3.219 E F2
+.718(is supplied, all alias de\214nitions)3.218 F(ar)144 338.4 Q 2.5(er)
 -.18 G 2.5(emoved. The)-2.68 F -.18(re)2.5 G(turn value is tr).18 E
-(ue unless a supplied)-.08 E F2(name)2.76 E F1
-(is not a de\214ned alias.)2.85 E F3(unset)108 189.6 Q F1<5bad>2.5 E F3
-(fv)A F1 2.5(][)C F2(name)-2.5 E F1(...])2.5 E 1.61(For each)144 201.6 R
-F2(name)4.11 E F1 4.11(,r).35 G 1.61(emove the corr)-4.29 F 1.61
+(ue unless a supplied)-.08 E F3(name)2.76 E F2
+(is not a de\214ned alias.)2.85 E F1(unset)108 355.2 Q F2<5bad>2.5 E F1
+(fv)A F2 2.5(][)C F3(name)-2.5 E F2(...])2.5 E 1.61(For each)144 367.2 R
+F3(name)4.11 E F2 4.11(,r).35 G 1.61(emove the corr)-4.29 F 1.61
 (esponding variable or function.)-.18 F 1.61(If no options ar)6.61 F
-4.11(es)-.18 G(up-)-4.11 E .473(plied, or the)144 213.6 R F3<ad76>2.973
-E F1 .473(option is given, each)2.973 F F2(name)3.233 E F1 -.18(re)3.323
-G .474(fers to a shell variable.).18 F .474(Read-only variables)5.474 F
-.32(may not be unset.)144 225.6 R(If)5.32 E F3<ad66>2.82 E F1 .32
-(is speci\214ed, each)2.82 F F2(name)3.08 E F1 -.18(re)3.17 G .32
+4.11(es)-.18 G(up-)-4.11 E .474(plied, or the)144 379.2 R F1<ad76>2.974
+E F2 .473(option is given, each)2.974 F F3(name)3.233 E F2 -.18(re)3.323
+G .473(fers to a shell variable.).18 F .473(Read-only variables)5.473 F
+.32(may not be unset.)144 391.2 R(If)5.32 E F1<ad66>2.82 E F2 .32
+(is speci\214ed, each)2.82 F F3(name)3.08 E F2 -.18(re)3.17 G .32
 (fers to a shell function, and the function).18 F .405
-(de\214nition is r)144 237.6 R 2.905(emoved. Each)-.18 F .405
+(de\214nition is r)144 403.2 R 2.905(emoved. Each)-.18 F .405
 (unset variable or function is r)2.905 F .405(emoved fr)-.18 F .405
-(om the envir)-.18 F(onment)-.18 E 1.475(passed to subsequent commands.)
-144 249.6 R 1.475(If any of)6.475 F/F4 9/Palatino-Bold@0 SF(RANDOM)3.975
-E/F5 9/Palatino-Roman@0 SF(,)A F4(SECONDS)3.725 E F5(,)A F4(LINENO)3.724
-E F5(,)A F4(HISTCMD)3.724 E F5(,)A F4(FUNCNAME)144 261.6 Q F5(,)A F4
-(GROUPS)2.803 E F5(,)A F1(or)2.803 E F4(DIRST)3.053 E(ACK)-.828 E F1(ar)
+(om the envir)-.18 F(onment)-.18 E 1.474(passed to subsequent commands.)
+144 415.2 R 1.475(If any of)6.475 F/F4 9/Palatino-Bold@0 SF(RANDOM)3.975
+E/F5 9/Palatino-Roman@0 SF(,)A F4(SECONDS)3.725 E F5(,)A F4(LINENO)3.725
+E F5(,)A F4(HISTCMD)3.725 E F5(,)A F4(FUNCNAME)144 427.2 Q F5(,)A F4
+(GROUPS)2.804 E F5(,)A F2(or)2.803 E F4(DIRST)3.053 E(ACK)-.828 E F2(ar)
 2.803 E 3.053(eu)-.18 G .553(nset, they lose their special pr)-3.053 F
-.553(operties, even if)-.18 F(they ar)144 273.6 Q 2.5(es)-.18 G
+.553(operties, even if)-.18 F(they ar)144 439.2 Q 2.5(es)-.18 G
 (ubsequently r)-2.5 E 2.5(eset. The)-.18 F(exit status is tr)2.5 E
-(ue unless a)-.08 E F2(name)2.76 E F1(is r)2.85 E(eadonly)-.18 E(.)-1.11
-E F3(wait)108 290.4 Q F1([)2.5 E F2 2.5(n.)C(..)-2.5 E F1(])A -.92(Wa)
-144 302.4 S .016(it for each speci\214ed pr).92 F .016(ocess and r)-.18
-F .016(eturn its termination status.)-.18 F(Each)5.016 E F2(n)2.776 E F1
-.016(may be a pr)2.596 F(ocess)-.18 E 1.733
-(ID or a job speci\214cation; if a job spec is given, all pr)144 314.4 R
-1.733(ocesses in that job's pipeline ar)-.18 F(e)-.18 E 1.015
-(waited for)144 326.4 R 6.015(.I)-.74 G(f)-6.015 E F2(n)3.775 E F1 1.015
-(is not given, all curr)3.595 F 1.014(ently active child pr)-.18 F 1.014
-(ocesses ar)-.18 F 3.514(ew)-.18 G 1.014(aited for)-3.514 F 3.514(,a)
--.74 G 1.014(nd the)-3.514 F -.18(re)144 338.4 S .693
-(turn status is zer).18 F 3.193(o. If)-.18 F F2(n)3.453 E F1 .693
+(ue unless a)-.08 E F3(name)2.76 E F2(is r)2.85 E(eadonly)-.18 E(.)-1.11
+E F1(wait)108 456 Q F2([)2.5 E F3 2.5(n.)C(..)-2.5 E F2(])A -.92(Wa)144
+468 S .016(it for each speci\214ed pr).92 F .016(ocess and r)-.18 F .016
+(eturn its termination status.)-.18 F(Each)5.016 E F3(n)2.776 E F2 .016
+(may be a pr)2.596 F(ocess)-.18 E 1.733
+(ID or a job speci\214cation; if a job spec is given, all pr)144 480 R
+1.733(ocesses in that job's pipeline ar)-.18 F(e)-.18 E 1.014
+(waited for)144 492 R 6.014(.I)-.74 G(f)-6.014 E F3(n)3.774 E F2 1.014
+(is not given, all curr)3.594 F 1.014(ently active child pr)-.18 F 1.015
+(ocesses ar)-.18 F 3.515(ew)-.18 G 1.015(aited for)-3.515 F 3.515(,a)
+-.74 G 1.015(nd the)-3.515 F -.18(re)144 504 S .694(turn status is zer)
+.18 F 3.193(o. If)-.18 F F3(n)3.453 E F2 .693
 (speci\214es a non-existent pr)3.273 F .693(ocess or job, the r)-.18 F
-.694(eturn status is 127.)-.18 F(Otherwise, the r)144 350.4 Q
+.693(eturn status is 127.)-.18 F(Otherwise, the r)144 516 Q
 (eturn status is the exit status of the last pr)-.18 E
 (ocess or job waited for)-.18 E(.)-.74 E/F6 10.95/Palatino-Bold@0 SF
-(SEE ALSO)72 367.2 Q F1(bash\(1\), sh\(1\))108 379.2 Q F0(GNU Bash-3.0)
+(SEE ALSO)72 532.8 Q F2(bash\(1\), sh\(1\))108 544.8 Q F0(GNU Bash-3.0)
 72 768 Q(2004 Apr 20)148.735 E(19)198.725 E 0 Cg EP
 %%Trailer
 end

doc/rbash.ps

@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.18.1
-%%CreationDate: Mon Feb 14 11:56:35 2005
+%%CreationDate: Tue Feb 22 13:37:34 2005
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%DocumentSuppliedResources: procset grops 1.18 1

doc/version.texi

@@ -2,9 +2,9 @@
 Copyright (C) 1988-2005 Free Software Foundation, Inc.
 @end ignore
 
-@set LASTCHANGE Sat Feb 19 17:38:46 EST 2005
+@set LASTCHANGE Wed Feb 23 16:45:53 EST 2005
 
 @set EDITION 3.1-devel
 @set VERSION 3.1-devel
-@set UPDATED 19 February 2005
+@set UPDATED 23 February 2005
 @set UPDATED-MONTH February 2005

lib/sh/pathcanon.c

@@ -75,10 +75,11 @@ static int
 _path_isdir (path)
      char *path;
 {
-  int l, x;
+  int l;
   struct stat sb;
 
   /* This should leave errno set to the correct value. */
+  errno = 0;
   l = stat (path, &sb) == 0 && S_ISDIR (sb.st_mode);
 #if defined (__CYGWIN__)
   if (l == 0)

subst.c

@@ -1974,7 +1974,13 @@ list_string (string, separators, quoted)
 	 field delimiter, not a separate delimiter that would result in an
 	 empty field.  Look at POSIX.2, 3.6.5, (3)(b). */
       if (string[sindex] && whitesep && issep (string[sindex]) && !spctabnl (string[sindex]))
-	sindex++;
+	{
+	  sindex++;
+	  /* An IFS character that is not IFS white space, along with any
+	     adjacent IFS white space, shall delimit a field. (SUSv3) */
+	  while (s[sindex] && spctabnl (s[sindex]) && isifs (s[sindex]))
+	    sindex++;
+	}
     }
   return (REVERSE_LIST (result, WORD_LIST *));
 }
@@ -2059,7 +2065,13 @@ get_word_from_string (stringp, separators, endptr)
      delimiter, not a separate delimiter that would result in an empty field.
      Look at POSIX.2, 3.6.5, (3)(b). */
   if (s[sindex] && whitesep && isifs (s[sindex]) && !spctabnl (s[sindex]))
-    sindex++;
+    {
+      sindex++;
+      /* An IFS character that is not IFS white space, along with any adjacent
+	 IFS white space, shall delimit a field. */
+      while (s[sindex] && spctabnl (s[sindex]) && isifs (s[sindex]))
+	sindex++;
+    }
 
   /* Update STRING to point to the next field. */
   *stringp = s + sindex;

subst.c~

@@ -1,10 +1,10 @@
-/* subst.c -- The part of the shell that does parameter, command, and
-   globbing substitutions. */
+/* subst.c -- The part of the shell that does parameter, command, arithmetic,
+   and globbing substitutions. */
 
 /* ``Have a little faith, there's magic in the night.  You ain't a
      beauty, but, hey, you're alright.'' */
 
-/* Copyright (C) 1987-2004 Free Software Foundation, Inc.
+/* Copyright (C) 1987-2005 Free Software Foundation, Inc.
 
    This file is part of GNU Bash, the Bourne Again SHell.
 
@@ -1974,7 +1974,13 @@ list_string (string, separators, quoted)
 	 field delimiter, not a separate delimiter that would result in an
 	 empty field.  Look at POSIX.2, 3.6.5, (3)(b). */
       if (string[sindex] && whitesep && issep (string[sindex]) && !spctabnl (string[sindex]))
+{
 	sindex++;
+    /* An IFS character that is not IFS whitespace, along with any adjacent
+       IFS white space, shall delimit a field. */
+while (s[sindex] && spctabnl (s[sindex]) && isifs (s[sindex]))
+  sindex++;
+}
     }
   return (REVERSE_LIST (result, WORD_LIST *));
 }
@@ -2059,7 +2065,13 @@ get_word_from_string (stringp, separators, endptr)
      delimiter, not a separate delimiter that would result in an empty field.
      Look at POSIX.2, 3.6.5, (3)(b). */
   if (s[sindex] && whitesep && isifs (s[sindex]) && !spctabnl (s[sindex]))
+{
     sindex++;
+    /* An IFS character that is not IFS whitespace, along with any adjacent
+       IFS white space, shall delimit a field. */
+while (s[sindex] && spctabnl (s[sindex]) && isifs (s[sindex]))
+  sindex++;
+}
 
   /* Update STRING to point to the next field. */
   *stringp = s + sindex;

tests/builtins.right

@@ -63,6 +63,7 @@ enable return
 enable set
 enable shift
 enable source
+enable times
 enable trap
 enable unset
 enable .
@@ -78,6 +79,7 @@ enable return
 enable set
 enable shift
 enable source
+enable times
 enable trap
 enable unset
 enable -n test worked

tests/read.right

@@ -1,6 +1,6 @@
 a.
 -a-b-
--a-b-
+-a-b -
 -a  b-
 -a  b-
 -a-b\-
@@ -51,8 +51,7 @@ echo "$var"
 done 3<$0
 argv[1] = <>
 argv[1] = <>
-argv[1] = <:>
-argv[1] = <:>
+argv[1] = <>
 FOO
 argv[1] = <>
 argv[1] = <3>