commit bash-20200807 snapshot

2026-06-29 00:19:51 +02:00 · 2020-08-12 14:39:05 -04:00
parent 216762309c
commit 7a257517b7
109 changed files with 11698 additions and 10810 deletions
@@ -1,3 +1,83 @@
+This document details the changes between this version, bash-5.1-beta, and
+the previous version, bash-5.1-alpha.
+
+1. Changes to Bash
+
+a. Fixed a bug that caused name references to variables to not update the
+   referenced variable's assignment side effects.
+
+b. Tightened up the parameter transformation error checking for invalid
+   transformation operators.
+
+c. System-specific changes for: FreeBSD
+
+d. A few minor changes to move potential uses of stdio functions out of signal
+   handling paths.
+
+e. Make sure SIGCHLD is blocked in all cases where waitchld() is not called
+   from a signal handler.
+
+f. Changed `command' builtin processing so it no longer starts an extra process
+   when run asynchronously (command x &).
+
+g. Avoid performing tilde expansion after `:' in words that look like assignment
+   statements when in posix mode.
+
+h. Slight changes to how the `complete' builtin prints out options and actions
+   for completion specifications.
+
+i. Several changes to how `local -' restores the values of options and
+   $SHELLOPTS.
+
+j. Don't treat a word in a compound assignment as an assignment statement
+   unless it has a valid subscript before the `='.
+
+k. Fixed a bug with the DEBUG trap and process substitution that caused the
+   terminal's process group to be set incorrectly.
+
+l. Fixed a bug that left readline's signal handlers installed while running a
+   shell command from a bindable readline command.
+
+m. Fixed the `fc' builtin to clamp out of range history specifications at the
+   boundaries of the history list for POSIX conformance.
+
+2. New Features in Bash
+
+a. If the hash builtin is listing hashed filenames portably, don't print
+   anything if the table is empty.
+
+b. GLOBIGNORE now ignores `.' and `..' as a terminal pathname component.
+
+c. Bash attempts to optimize away forks in the last command in a function body
+   under appropriate circumstances.
+
+d. The globbing code now uses fnmatch(3) to check collation elements (if
+   available) even in cases without multibyte characters.
+
+e. The `fg' and `bg' builtins now return an error in a command substitution
+   when asked to restart a job inherited from the parent shell.
+
+f. The shell now attempts to unlink all FIFOs on exit, whether a consuming
+   process has finished with them or not.
+
+3. Changes to Readline
+
+a. Make sure that all undo groups are closed when leaving vi insertion mode.
+
+b. Make sure that the vi-mode `C' and `c' commands enter insert mode even if
+   the motion command doesn't have any effect.
+
+c. Fixed several potential memory leaks in the callback mode context handling.
+
+d. If readline is handling a SIGTTOU, make sure SIGTTOU is blocked while
+   executing the terminal cleanup code, since it's no longer run in a signal
+   handling context.
+
+4. New Features in Readline
+
+a. The signal cleanup code now blocks SIGINT while processing after a SIGINT.
+
+------------------------------------------------------------------------------
 This document details the changes between this version, bash-5.1-alpha, and
 the previous version, bash-5.0-release.

@@ -1,3 +1,83 @@
+This document details the changes between this version, bash-5.1-beta, and
+the previous version, bash-5.1-alpha.
+
+1. Changes to Bash
+
+a. Fixed a bug that caused name references to variables to not update the
+   referenced variable's assignment side effects.
+
+b. Tightened up the parameter transformation error checking for invalid
+   transformation operators.
+
+c. System-specific changes for: FreeBSD
+
+d. A few minor changes to move potential uses of stdio functions out of signal
+   handling paths.
+
+e. Make sure SIGCHLD is blocked in all cases where waitchld() is not called
+   from a signal handler.
+
+f. Changed `command' builtin processing so it no longer starts an extra process
+   when run asynchronously (command x &).
+
+g. Avoid performing tilde expansion after `:' in words that look like assignment
+   statements when in posix mode.
+
+h. Slight changes to how the `complete' builtin prints out options and actions
+   for completion specifications.
+
+i. Several changes to how `local -' restores the values of options and
+   $SHELLOPTS.
+
+j. Don't treat a word in a compound assignment as an assignment statement
+   unless it has a valid subscript before the `='.
+
+k. Fixed a bug with the DEBUG trap and process substitution that caused the
+   terminal's process group to be set incorrectly.
+
+l. Fixed a bug that left readline's signal handlers installed while running a
+   shell command from a bindable readline command.
+
+m. Fixed the `fc' builtin to clamp out of range history specifications at the
+   boundaries of the history list for POSIX conformance.
+
+2. New Features in Bash
+
+a. If the hash builtin is listing hashed filenames portably, don't print
+   anything if the table is empty.
+
+b. GLOBIGNORE now ignores `.' and `..' as a terminal pathname component.
+
+c. Bash attempts to optimize away forks in the last command in a function body
+   under appropriate circumstances.
+
+d. The globbing code now uses fnmatch(3) to check collation elements (if
+   available) even in cases without multibyte characters.
+
+e. The `fg' and `bg' builtins now return an error in a command substitution
+   when asked to restart a job inherited from the parent shell.
+
+f. The shell now attempts to unlink all FIFOs on exit, whether a consuming
+   process has finished with them or not.
+
+3. Changes to Readline
+
+a. Make sure that all undo groups are closed when leaving vi insertion mode.
+
+b. Make sure that the vi-mode `C' and `c' commands enter insert mode even if
+   the motion command doesn't have any effect.
+
+c. Fixed several potential memory leaks in the callback mode context handling.
+
+d. If readline is handling a SIGTTOU, make sure SIGTTOU is blocked while
+   executing the terminal cleanup code, since it's no longer run in a signal
+   handling context.
+
+4. New Features in Readline
+
+a. The signal cleanup code now blocks SIGINT while processing after a SIGINT.
+
+------------------------------------------------------------------------------
 This document details the changes between this version, bash-5.1-alpha, and
 the previous version, bash-5.0-release.

@@ -2,7 +2,7 @@ Compatibility with previous versions
 ====================================

 This document details the incompatibilities between this version of bash,
-bash-5.1, and the previous widely-available versions, bash-3.x (which is
+bash-5.1, and the previous widely-available versions, bash-3.2 (which is
 still the `standard' version for Mac OS X), 4.2/4.3 (which are still
 standard on a few Linux distributions), and bash-4.4/bash-5.0, the current
 widely-available versions.  These were discovered by users of bash-2.x
@@ -543,6 +543,7 @@ compat50 (set using BASH_COMPAT)
 	  output in a format that can be reused as input (-l). Bash-5.1
 	  suppresses that message if -l is supplied

+
 -------------------------------------------------------------------------------

 Copying and distribution of this file, with or without modification,
@@ -8853,3 +8853,23 @@ arrayfunc.c
 	- quote_compound_array_list: turn empty strings into '' instead of
 	  leaving them unmodified. Fixes bug in changes from 4/29 reported
 	  by andy_bash <andy_bash@objectmail.com>
+
+				   8/10
+				   ----
+bashline.c
+	- edit_and_execute_command,bash_execute_unix_command: restore the bash
+	  signal handlers before running parse_and_execute() so bash will catch
+	  and handle signals, instead of letting readline catch them without
+	  any opportunity to run _rl_handle_signal(). Fixes bug reported by
+	  Stan Marsh <gazelle@xmission.com>
+
+				   8/11
+				   ----
+builtins/fc.def
+	- fc_gethnum: return HIST_INVALID for -0 if not in listing mode
+	- fc_builtin: throw an out-of-range error if histbeg or histend gets
+	  set to HIST_INVALID
+	- fc_builtin: don't throw errors for other out-of-range history
+	  specifications, clamp them at the beginning or end of the history
+	  list, as appropriate, per POSIX. Report and fix from Martijn Dekker
+	  <martijn@inlv.org>
@@ -128,6 +128,23 @@ nn. HISTFILE is now readonly in a restricted shell.
 oo. The bash malloc now returns memory that is 16-byte aligned on 64-bit
    systems.

+pp. If the hash builtin is listing hashed filenames portably, don't print
+   anything if the table is empty.
+
+qq. GLOBIGNORE now ignores `.' and `..' as a terminal pathname component.
+
+rr. Bash attempts to optimize away forks in the last command in a function body
+    under appropriate circumstances.
+
+ss. The globbing code now uses fnmatch(3) to check collation elements (if
+    available) even in cases without multibyte characters.
+
+tt. The `fg' and `bg' builtins now return an error in a command substitution
+    when asked to restart a job inherited from the parent shell.
+
+uu. The shell now attempts to unlink all FIFOs on exit, whether a consuming
+    process has finished with them or not.
+
 2. New Features in Readline

 a. If a second consecutive completion attempt produces matches where the first
@@ -161,6 +178,8 @@ i. Readline tries to take advantage of the more regular structure of UTF-8
 j. The bindable operate-and-get-next command (and its default bindings) are
   now part of readline instead of a bash-specific addition.

+k. The signal cleanup code now blocks SIGINT while processing after a SIGINT.
+
 -------------------------------------------------------------------------------
 This is a terse description of the new features added to bash-5.0 since
 the release of bash-4.4.  As always, the manual page (doc/bash.1) is
@@ -128,6 +128,23 @@ nn. HISTFILE is now readonly in a restricted shell.
 oo. The bash malloc now returns memory that is 16-byte aligned on 64-bit
    systems.  

+pp. If the hash builtin is listing hashed filenames portably, don't print
+   anything if the table is empty.
+
+qq. GLOBIGNORE now ignores `.' and `..' as a terminal pathname component.
+
+rr. Bash attempts to optimize away forks in the last command in a function body
+    under appropriate circumstances.
+
+ss. The globbing code now uses fnmatch(3) to check collation elements (if
+    available) even in cases without multibyte characters.
+
+tt. The `fg' and `bg' builtins now return an error in a command substitution
+    when asked to restart a job inherited from the parent shell.
+
+uu. The shell now attempts to unlink all FIFOs on exit, whether a consuming
+    process has finished with them or not.
+
 2. New Features in Readline

 a. If a second consecutive completion attempt produces matches where the first
@@ -160,3 +177,5 @@ i. Readline tries to take advantage of the more regular structure of UTF-8

 j. The bindable operate-and-get-next command (and its default bindings) are
   now part of readline instead of a bash-specific addition.
+
+k. The signal cleanup code now blocks SIGINT while processing after a SIGINT.
@@ -968,6 +968,7 @@ edit_and_execute_command (count, c, editing_mode, edit_command)
  
  if (rl_deprep_term_function)
    (*rl_deprep_term_function) ();
+  rl_clear_signals ();
  save_parser_state (&ps);
  r = parse_and_execute (command, (editing_mode == VI_EDITING_MODE) ? "v" : "C-xC-e", SEVAL_NOHIST);
  restore_parser_state (&ps);
@@ -977,6 +978,7 @@ edit_and_execute_command (count, c, editing_mode, edit_command)

  if (rl_prep_term_function)
    (*rl_prep_term_function) (metaflag);
+  rl_set_signals ();

  current_command_line_count = saved_command_line_count;

@@ -4337,7 +4339,9 @@ bash_execute_unix_command (count, key)
  array_needs_making = 1;

  save_parser_state (&ps);
+  rl_clear_signals ();
  r = parse_and_execute (savestring (cmd), "bash_execute_unix_command", SEVAL_NOHIST|SEVAL_NOFREE);
+  rl_set_signals ();
  restore_parser_state (&ps);

  v = find_variable ("READLINE_LINE");
@@ -86,6 +86,9 @@ $END
 extern int errno;
 #endif /* !errno */

+#define HIST_INVALID INT_MIN
+#define HIST_ERANGE  INT_MIN+1
+
 extern int unlink PARAMS((const char *));

 extern FILE *sh_mktmpfp PARAMS((char *, int, char **));
@@ -321,10 +324,7 @@ fc_builtin (list)
    while (last_hist >= 0 && hlist[last_hist] == 0)
      last_hist--;
  if (last_hist < 0)
-    {
-      sh_erange ((char *)NULL, _("history specification"));
-      return (EXECUTION_FAILURE);
-    }
+    last_hist = 0;		/* per POSIX */

  if (list)
    {
@@ -353,13 +353,18 @@ fc_builtin (list)
 	histbeg = histend = last_hist;
    }

-  /* We print error messages for line specifications out of range. */
-  if ((histbeg < 0) || (histend < 0))
+  if (histbeg == HIST_INVALID || histend == HIST_INVALID)
    {
-      sh_erange ((char *)NULL, _("history specification"));
+      sh_erange ((char *)NULL, _("history specification")); 
      return (EXECUTION_FAILURE);
    }

+  /* We don't throw an error for line specifications out of range, per POSIX */
+  if (histbeg < 0)
+    histbeg = 0;
+  if (histend < 0)
+    histend = 0;
+
  /* "When not listing, the fc command that caused the editing shall not be
     entered into the history list." */
  if (listing == 0 && hist_last_line_added)
@@ -382,13 +387,18 @@ fc_builtin (list)
 	histbeg = last_hist;
    }

-  /* We print error messages for line specifications out of range. */
-  if ((histbeg < 0) || (histend < 0))
+  if (histbeg == HIST_INVALID || histend == HIST_INVALID)
    {
-      sh_erange ((char *)NULL, _("history specification"));
+      sh_erange ((char *)NULL, _("history specification")); 
      return (EXECUTION_FAILURE);
    }

+  /* We don't throw an error for line specifications out of range, per POSIX */
+  if (histbeg < 0)
+    histbeg = 0;
+  if (histend < 0)
+    histend = 0;
+
  if (histend < histbeg)
    {
      i = histend;
@@ -578,7 +588,7 @@ fc_gethnum (command, hlist, mode)
 	  return (n < 0 ? 0 : n);
 	}
      else if (n == 0)
-	return ((sign == -1) ? (mode ? real_last : -1) : i);
+	return ((sign == -1) ? (mode ? real_last : HIST_INVALID) : i);
      else
 	{
 	  n -= history_base;
@@ -1,7 +1,7 @@
 #! /bin/sh
 # From configure.ac for Bash 5.1, version 5.021.
 # Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.69 for bash 5.1-alpha.
+# Generated by GNU Autoconf 2.69 for bash 5.1-beta.
 #
 # Report bugs to <bug-bash@gnu.org>.
 #
@@ -581,8 +581,8 @@ MAKEFLAGS=
 # Identity of this package.
 PACKAGE_NAME='bash'
 PACKAGE_TARNAME='bash'
-PACKAGE_VERSION='5.1-alpha'
-PACKAGE_STRING='bash 5.1-alpha'
+PACKAGE_VERSION='5.1-beta'
+PACKAGE_STRING='bash 5.1-beta'
 PACKAGE_BUGREPORT='bug-bash@gnu.org'
 PACKAGE_URL=''

@@ -1427,7 +1427,7 @@ if test "$ac_init_help" = "long"; then
  # Omit some internal or obsolete options to make the list less imposing.
  # This message is too long to be a string in the A/UX 3.1 sh.
  cat <<_ACEOF
-\`configure' configures bash 5.1-alpha to adapt to many kinds of systems.
+\`configure' configures bash 5.1-beta to adapt to many kinds of systems.

 Usage: $0 [OPTION]... [VAR=VALUE]...

@@ -1492,7 +1492,7 @@ fi

 if test -n "$ac_init_help"; then
  case $ac_init_help in
-     short | recursive ) echo "Configuration of bash 5.1-alpha:";;
+     short | recursive ) echo "Configuration of bash 5.1-beta:";;
   esac
  cat <<\_ACEOF

@@ -1693,7 +1693,7 @@ fi
 test -n "$ac_init_help" && exit $ac_status
 if $ac_init_version; then
  cat <<\_ACEOF
-bash configure 5.1-alpha
+bash configure 5.1-beta
 generated by GNU Autoconf 2.69

 Copyright (C) 2012 Free Software Foundation, Inc.
@@ -2402,7 +2402,7 @@ cat >config.log <<_ACEOF
 This file contains any messages produced by compilers while
 running configure, to aid debugging if configure makes a mistake.

-It was created by bash $as_me 5.1-alpha, which was
+It was created by bash $as_me 5.1-beta, which was
 generated by GNU Autoconf 2.69.  Invocation command line was

  $ $0 $@
@@ -2800,7 +2800,7 @@ ac_config_headers="$ac_config_headers config.h"


 BASHVERS=5.1
-RELSTATUS=alpha
+RELSTATUS=beta

 case "$RELSTATUS" in
 alp*|bet*|dev*|rc*|releng*|maint*)	DEBUG='-DDEBUG' MALLOC_DEBUG='-DMALLOC_DEBUG' ;;
@@ -21057,7 +21057,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
 # report actual input values of CONFIG_FILES etc. instead of their
 # values after options handling.
 ac_log="
-This file was extended by bash $as_me 5.1-alpha, which was
+This file was extended by bash $as_me 5.1-beta, which was
 generated by GNU Autoconf 2.69.  Invocation command line was

  CONFIG_FILES    = $CONFIG_FILES
@@ -21123,7 +21123,7 @@ _ACEOF
 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
 ac_cs_version="\\
-bash config.status 5.1-alpha
+bash config.status 5.1-beta
 configured by $0, generated by GNU Autoconf 2.69,
  with options \\"\$ac_cs_config\\"

@@ -24,7 +24,7 @@ dnl Process this file with autoconf to produce a configure script.
 AC_REVISION([for Bash 5.1, version 5.021])dnl

 define(bashvers, 5.1)
-define(relstatus, alpha)
+define(relstatus, beta)

 AC_INIT([bash], bashvers-relstatus, [bug-bash@gnu.org])

@@ -5090,11 +5090,13 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
              is  made  local to the function in which llooccaall is invoked: shell
              options changed using the sseett builtin inside  the  function  are
              restored  to  their  original  values when the function returns.
-              With no operands, llooccaall writes a list of local variables to  the
-              standard  output.  It is an error to use llooccaall when not within a
-              function.  The return status is 0 unless llooccaall is used outside a
-              function,  an  invalid  _n_a_m_e  is supplied, or _n_a_m_e is a readonly
-              variable.
+              The restore is effected as if a series of sseett commands were exe-
+              cuted  to restore the values that were in place before the func-
+              tion.  With no operands, llooccaall writes a list of local  variables
+              to  the  standard  output.  It is an error to use llooccaall when not
+              within a function.  The return status is 0 unless llooccaall is  used
+              outside  a  function,  an invalid _n_a_m_e is supplied, or _n_a_m_e is a
+              readonly variable.

       llooggoouutt Exit a login shell.

@@ -6399,4 +6401,4 @@ BBUUGGSS



-GNU Bash 5.1                     2020 June 16                          BASH(1)
+GNU Bash 5.1                     2020 August 3                         BASH(1)
@@ -3,7 +3,7 @@
 </HEAD>
 <BODY><TABLE WIDTH=100%>
 <TR>
-<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2020 June 16<TH ALIGN=RIGHT width=33%>BASH(1)
+<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2020 August 3<TH ALIGN=RIGHT width=33%>BASH(1)
 </TR>
 </TABLE>
 <BR><A HREF="#index">Index</A>
@@ -11311,6 +11311,8 @@ If <I>name</I> is -, the set of shell options is made local to the function
 in which <B>local</B> is invoked: shell options changed using the
 <B>set</B> builtin inside the function are restored to their original values
 when the function returns.
+The restore is effected as if a series of <B>set</B> commands were executed
+to restore the values that were in place before the function.
 With no operands,
 <B>local</B>

@@ -14252,7 +14254,7 @@ There may be only one active coprocess at a time.
 <HR>
 <TABLE WIDTH=100%>
 <TR>
-<TH ALIGN=LEFT width=33%>GNU Bash 5.1<TH ALIGN=CENTER width=33%>2020 June 16<TH ALIGN=RIGHT width=33%>BASH(1)
+<TH ALIGN=LEFT width=33%>GNU Bash 5.1<TH ALIGN=CENTER width=33%>2020 August 3<TH ALIGN=RIGHT width=33%>BASH(1)
 </TR>
 </TABLE>
 <HR>
@@ -14359,6 +14361,6 @@ There may be only one active coprocess at a time.
 </DL>
 <HR>
 This document was created by man2html from bash.1.<BR>
-Time: 17 July 2020 15:12:43 EDT
+Time: 07 August 2020 11:58:21 EDT
 </BODY>
 </HTML>
@@ -2,9 +2,9 @@ This is bash.info, produced by makeinfo version 6.7 from
 bashref.texi.

 This text is a brief description of the features that are present in the
-Bash shell (version 5.1, 2 July 2020).
+Bash shell (version 5.1, 3 August 2020).

-   This is Edition 5.1, last updated 2 July 2020, of 'The GNU Bash
+   This is Edition 5.1, last updated 3 August 2020, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.

   Copyright (C) 1988-2018 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
 *************

 This text is a brief description of the features that are present in the
-Bash shell (version 5.1, 2 July 2020).  The Bash home page is
+Bash shell (version 5.1, 3 August 2020).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.1, last updated 2 July 2020, of 'The GNU Bash
+   This is Edition 5.1, last updated 3 August 2020, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.

   Bash contains features that appear in other popular shells, and some
@@ -3746,9 +3746,11 @@ standard.
     and its children.  If NAME is '-', the set of shell options is made
     local to the function in which 'local' is invoked: shell options
     changed using the 'set' builtin inside the function are restored to
-     their original values when the function returns.  The return status
-     is zero unless 'local' is used outside a function, an invalid NAME
-     is supplied, or NAME is a readonly variable.
+     their original values when the function returns.  The restore is
+     effected as if a series of 'set' commands were executed to restore
+     the values that were in place before the function.  The return
+     status is zero unless 'local' is used outside a function, an
+     invalid NAME is supplied, or NAME is a readonly variable.

 'logout'
          logout [N]
@@ -8523,10 +8525,14 @@ File: bash.info,  Node: Commands For Killing,  Next: Numeric Arguments,  Prev: C
 -------------------------

 'kill-line (C-k)'
-     Kill the text from point to the end of the line.
+     Kill the text from point to the end of the line.  With a negative
+     numeric argument, kill backward from the cursor to the beginning of
+     the current line.

 'backward-kill-line (C-x Rubout)'
     Kill backward from the cursor to the beginning of the current line.
+     With a negative numeric argument, kill forward from the cursor to
+     the end of the current line.

 'unix-line-discard (C-u)'
     Kill backward from the cursor to the beginning of the current line.
@@ -11294,17 +11300,17 @@ D.1 Index of Shell Builtin Commands
                                                              (line  58)
 * let:                                   Bash Builtins.       (line 350)
 * local:                                 Bash Builtins.       (line 358)
-* logout:                                Bash Builtins.       (line 372)
-* mapfile:                               Bash Builtins.       (line 377)
+* logout:                                Bash Builtins.       (line 374)
+* mapfile:                               Bash Builtins.       (line 379)
 * popd:                                  Directory Stack Builtins.
                                                              (line  35)
-* printf:                                Bash Builtins.       (line 423)
+* printf:                                Bash Builtins.       (line 425)
 * pushd:                                 Directory Stack Builtins.
                                                              (line  53)
 * pwd:                                   Bourne Shell Builtins.
                                                              (line 207)
-* read:                                  Bash Builtins.       (line 472)
-* readarray:                             Bash Builtins.       (line 568)
+* read:                                  Bash Builtins.       (line 474)
+* readarray:                             Bash Builtins.       (line 570)
 * readonly:                              Bourne Shell Builtins.
                                                              (line 217)
 * return:                                Bourne Shell Builtins.
@@ -11313,7 +11319,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                              (line 257)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 577)
+* source:                                Bash Builtins.       (line 579)
 * suspend:                               Job Control Builtins.
                                                              (line 113)
 * test:                                  Bourne Shell Builtins.
@@ -11322,12 +11328,12 @@ D.1 Index of Shell Builtin Commands
                                                              (line 349)
 * trap:                                  Bourne Shell Builtins.
                                                              (line 355)
-* type:                                  Bash Builtins.       (line 582)
-* typeset:                               Bash Builtins.       (line 614)
-* ulimit:                                Bash Builtins.       (line 620)
+* type:                                  Bash Builtins.       (line 584)
+* typeset:                               Bash Builtins.       (line 616)
+* ulimit:                                Bash Builtins.       (line 622)
 * umask:                                 Bourne Shell Builtins.
                                                              (line 404)
-* unalias:                               Bash Builtins.       (line 723)
+* unalias:                               Bash Builtins.       (line 725)
 * unset:                                 Bourne Shell Builtins.
                                                              (line 422)
 * wait:                                  Job Control Builtins.
@@ -11622,9 +11628,9 @@ D.4 Function Index
 * backward-char (C-b):                   Commands For Moving. (line  15)
 * backward-delete-char (Rubout):         Commands For Text.   (line  17)
 * backward-kill-line (C-x Rubout):       Commands For Killing.
-                                                              (line   9)
+                                                              (line  11)
 * backward-kill-word (M-<DEL>):          Commands For Killing.
-                                                              (line  24)
+                                                              (line  28)
 * backward-word (M-b):                   Commands For Moving. (line  22)
 * beginning-of-history (M-<):            Commands For History.
                                                              (line  20)
@@ -11653,18 +11659,18 @@ D.4 Function Index
 * complete-variable (M-$):               Commands For Completion.
                                                              (line  64)
 * copy-backward-word ():                 Commands For Killing.
-                                                              (line  65)
+                                                              (line  69)
 * copy-forward-word ():                  Commands For Killing.
-                                                              (line  70)
+                                                              (line  74)
 * copy-region-as-kill ():                Commands For Killing.
-                                                              (line  61)
+                                                              (line  65)
 * dabbrev-expand ():                     Commands For Completion.
                                                              (line  95)
 * delete-char (C-d):                     Commands For Text.   (line  12)
 * delete-char-or-list ():                Commands For Completion.
                                                              (line  43)
 * delete-horizontal-space ():            Commands For Killing.
-                                                              (line  53)
+                                                              (line  57)
 * digit-argument (M-0, M-1, ... M--):    Numeric Arguments.   (line   6)
 * display-shell-version (C-x C-v):       Miscellaneous Commands.
                                                              (line 110)
@@ -11720,11 +11726,11 @@ D.4 Function Index
 * kill-line (C-k):                       Commands For Killing.
                                                              (line   6)
 * kill-region ():                        Commands For Killing.
-                                                              (line  57)
+                                                              (line  61)
 * kill-whole-line ():                    Commands For Killing.
-                                                              (line  15)
-* kill-word (M-d):                       Commands For Killing.
                                                              (line  19)
+* kill-word (M-d):                       Commands For Killing.
+                                                              (line  23)
 * magic-space ():                        Miscellaneous Commands.
                                                              (line 121)
 * menu-complete ():                      Commands For Completion.
@@ -11771,15 +11777,15 @@ D.4 Function Index
 * set-mark (C-@):                        Miscellaneous Commands.
                                                              (line  33)
 * shell-backward-kill-word ():           Commands For Killing.
-                                                              (line  33)
+                                                              (line  37)
 * shell-backward-word (M-C-b):           Commands For Moving. (line  30)
 * shell-expand-line (M-C-e):             Miscellaneous Commands.
                                                              (line 113)
 * shell-forward-word (M-C-f):            Commands For Moving. (line  26)
 * shell-kill-word (M-C-d):               Commands For Killing.
-                                                              (line  28)
+                                                              (line  32)
 * shell-transpose-words (M-C-t):         Commands For Killing.
-                                                              (line  37)
+                                                              (line  41)
 * skip-csi-sequence ():                  Miscellaneous Commands.
                                                              (line  52)
 * start-kbd-macro (C-x ():               Keyboard Macros.     (line   6)
@@ -11791,20 +11797,20 @@ D.4 Function Index
                                                              (line  23)
 * universal-argument ():                 Numeric Arguments.   (line  10)
 * unix-filename-rubout ():               Commands For Killing.
-                                                              (line  48)
+                                                              (line  52)
 * unix-line-discard (C-u):               Commands For Killing.
-                                                              (line  12)
+                                                              (line  16)
 * unix-word-rubout (C-w):                Commands For Killing.
-                                                              (line  44)
+                                                              (line  48)
 * upcase-word (M-u):                     Commands For Text.   (line  58)
 * yank (C-y):                            Commands For Killing.
-                                                              (line  75)
+                                                              (line  79)
 * yank-last-arg (M-. or M-_):            Commands For History.
                                                              (line  84)
 * yank-nth-arg (M-C-y):                  Commands For History.
                                                              (line  75)
 * yank-pop (M-y):                        Commands For Killing.
-                                                              (line  78)
+                                                              (line  82)


 File: bash.info,  Node: Concept Index,  Prev: Function Index,  Up: Indexes
@@ -11973,137 +11979,137 @@ D.5 Concept Index


 Tag Table:
-Node: Top887
-Node: Introduction2797
-Node: What is Bash?3013
-Node: What is a shell?4127
-Node: Definitions6665
-Node: Basic Shell Features9616
-Node: Shell Syntax10835
-Node: Shell Operation11861
-Node: Quoting13154
-Node: Escape Character14454
-Node: Single Quotes14939
-Node: Double Quotes15287
-Node: ANSI-C Quoting16565
-Node: Locale Translation17824
-Node: Comments18977
-Node: Shell Commands19595
-Node: Reserved Words20533
-Node: Simple Commands21289
-Node: Pipelines21943
-Node: Lists24875
-Node: Compound Commands26666
-Node: Looping Constructs27678
-Node: Conditional Constructs30173
-Node: Command Grouping41744
-Node: Coprocesses43223
-Node: GNU Parallel45126
-Node: Shell Functions49427
-Node: Shell Parameters56634
-Node: Positional Parameters61047
-Node: Special Parameters61947
-Node: Shell Expansions65171
-Node: Brace Expansion67294
-Node: Tilde Expansion70017
-Node: Shell Parameter Expansion72634
-Node: Command Substitution87763
-Node: Arithmetic Expansion89118
-Node: Process Substitution90050
-Node: Word Splitting91170
-Node: Filename Expansion93114
-Node: Pattern Matching95663
-Node: Quote Removal99649
-Node: Redirections99944
-Node: Executing Commands109514
-Node: Simple Command Expansion110184
-Node: Command Search and Execution112138
-Node: Command Execution Environment114514
-Node: Environment117498
-Node: Exit Status119157
-Node: Signals120827
-Node: Shell Scripts122794
-Node: Shell Builtin Commands125806
-Node: Bourne Shell Builtins127844
-Node: Bash Builtins148773
-Node: Modifying Shell Behavior178564
-Node: The Set Builtin178909
-Node: The Shopt Builtin189322
-Node: Special Builtins204232
-Node: Shell Variables205211
-Node: Bourne Shell Variables205648
-Node: Bash Variables207752
-Node: Bash Features240330
-Node: Invoking Bash241343
-Node: Bash Startup Files247356
-Node: Interactive Shells252459
-Node: What is an Interactive Shell?252869
-Node: Is this Shell Interactive?253518
-Node: Interactive Shell Behavior254333
-Node: Bash Conditional Expressions257847
-Node: Shell Arithmetic262424
-Node: Aliases265364
-Node: Arrays267984
-Node: The Directory Stack273993
-Node: Directory Stack Builtins274777
-Node: Controlling the Prompt277745
-Node: The Restricted Shell280695
-Node: Bash POSIX Mode283289
-Node: Shell Compatibility Mode294325
-Node: Job Control300981
-Node: Job Control Basics301441
-Node: Job Control Builtins306437
-Node: Job Control Variables311837
-Node: Command Line Editing312993
-Node: Introduction and Notation314664
-Node: Readline Interaction316287
-Node: Readline Bare Essentials317478
-Node: Readline Movement Commands319261
-Node: Readline Killing Commands320221
-Node: Readline Arguments322139
-Node: Searching323183
-Node: Readline Init File325369
-Node: Readline Init File Syntax326628
-Node: Conditional Init Constructs347167
-Node: Sample Init File351363
-Node: Bindable Readline Commands354487
-Node: Commands For Moving355691
-Node: Commands For History357742
-Node: Commands For Text362535
-Node: Commands For Killing366184
-Node: Numeric Arguments368999
-Node: Commands For Completion370138
-Node: Keyboard Macros374329
-Node: Miscellaneous Commands375016
-Node: Readline vi Mode380700
-Node: Programmable Completion381607
-Node: Programmable Completion Builtins389387
-Node: A Programmable Completion Example400082
-Node: Using History Interactively405329
-Node: Bash History Facilities406013
-Node: Bash History Builtins409018
-Node: History Interaction413747
-Node: Event Designators417367
-Node: Word Designators418721
-Node: Modifiers420481
-Node: Installing Bash422292
-Node: Basic Installation423429
-Node: Compilers and Options426687
-Node: Compiling For Multiple Architectures427428
-Node: Installation Names429121
-Node: Specifying the System Type429939
-Node: Sharing Defaults430655
-Node: Operation Controls431328
-Node: Optional Features432286
-Node: Reporting Bugs442804
-Node: Major Differences From The Bourne Shell443998
-Node: GNU Free Documentation License460850
-Node: Indexes486027
-Node: Builtin Index486481
-Node: Reserved Word Index493308
-Node: Variable Index495756
-Node: Function Index511653
-Node: Concept Index525163
+Node: Top891
+Node: Introduction2805
+Node: What is Bash?3021
+Node: What is a shell?4135
+Node: Definitions6673
+Node: Basic Shell Features9624
+Node: Shell Syntax10843
+Node: Shell Operation11869
+Node: Quoting13162
+Node: Escape Character14462
+Node: Single Quotes14947
+Node: Double Quotes15295
+Node: ANSI-C Quoting16573
+Node: Locale Translation17832
+Node: Comments18985
+Node: Shell Commands19603
+Node: Reserved Words20541
+Node: Simple Commands21297
+Node: Pipelines21951
+Node: Lists24883
+Node: Compound Commands26674
+Node: Looping Constructs27686
+Node: Conditional Constructs30181
+Node: Command Grouping41752
+Node: Coprocesses43231
+Node: GNU Parallel45134
+Node: Shell Functions49435
+Node: Shell Parameters56642
+Node: Positional Parameters61055
+Node: Special Parameters61955
+Node: Shell Expansions65179
+Node: Brace Expansion67302
+Node: Tilde Expansion70025
+Node: Shell Parameter Expansion72642
+Node: Command Substitution87771
+Node: Arithmetic Expansion89126
+Node: Process Substitution90058
+Node: Word Splitting91178
+Node: Filename Expansion93122
+Node: Pattern Matching95671
+Node: Quote Removal99657
+Node: Redirections99952
+Node: Executing Commands109522
+Node: Simple Command Expansion110192
+Node: Command Search and Execution112146
+Node: Command Execution Environment114522
+Node: Environment117506
+Node: Exit Status119165
+Node: Signals120835
+Node: Shell Scripts122802
+Node: Shell Builtin Commands125814
+Node: Bourne Shell Builtins127852
+Node: Bash Builtins148781
+Node: Modifying Shell Behavior178716
+Node: The Set Builtin179061
+Node: The Shopt Builtin189474
+Node: Special Builtins204384
+Node: Shell Variables205363
+Node: Bourne Shell Variables205800
+Node: Bash Variables207904
+Node: Bash Features240482
+Node: Invoking Bash241495
+Node: Bash Startup Files247508
+Node: Interactive Shells252611
+Node: What is an Interactive Shell?253021
+Node: Is this Shell Interactive?253670
+Node: Interactive Shell Behavior254485
+Node: Bash Conditional Expressions257999
+Node: Shell Arithmetic262576
+Node: Aliases265516
+Node: Arrays268136
+Node: The Directory Stack274145
+Node: Directory Stack Builtins274929
+Node: Controlling the Prompt277897
+Node: The Restricted Shell280847
+Node: Bash POSIX Mode283441
+Node: Shell Compatibility Mode294477
+Node: Job Control301133
+Node: Job Control Basics301593
+Node: Job Control Builtins306589
+Node: Job Control Variables311989
+Node: Command Line Editing313145
+Node: Introduction and Notation314816
+Node: Readline Interaction316439
+Node: Readline Bare Essentials317630
+Node: Readline Movement Commands319413
+Node: Readline Killing Commands320373
+Node: Readline Arguments322291
+Node: Searching323335
+Node: Readline Init File325521
+Node: Readline Init File Syntax326780
+Node: Conditional Init Constructs347319
+Node: Sample Init File351515
+Node: Bindable Readline Commands354639
+Node: Commands For Moving355843
+Node: Commands For History357894
+Node: Commands For Text362687
+Node: Commands For Killing366336
+Node: Numeric Arguments369369
+Node: Commands For Completion370508
+Node: Keyboard Macros374699
+Node: Miscellaneous Commands375386
+Node: Readline vi Mode381070
+Node: Programmable Completion381977
+Node: Programmable Completion Builtins389757
+Node: A Programmable Completion Example400452
+Node: Using History Interactively405699
+Node: Bash History Facilities406383
+Node: Bash History Builtins409388
+Node: History Interaction414117
+Node: Event Designators417737
+Node: Word Designators419091
+Node: Modifiers420851
+Node: Installing Bash422662
+Node: Basic Installation423799
+Node: Compilers and Options427057
+Node: Compiling For Multiple Architectures427798
+Node: Installation Names429491
+Node: Specifying the System Type430309
+Node: Sharing Defaults431025
+Node: Operation Controls431698
+Node: Optional Features432656
+Node: Reporting Bugs443174
+Node: Major Differences From The Bourne Shell444368
+Node: GNU Free Documentation License461220
+Node: Indexes486397
+Node: Builtin Index486851
+Node: Reserved Word Index493678
+Node: Variable Index496126
+Node: Function Index512023
+Node: Concept Index525533

 End Tag Table

@@ -29,9 +29,10 @@ EENNVVIIRROONNMMEENNTT

       EEDDIITTOORR Specifies the preferred editor. If EEDDIITTOORR is  not  set,  bbaasshhbbuugg
              attempts  to  locate  a number of alternative editors, including
-              eemmaaccss, and defaults to vvii.
+              eemmaaccss.  If bbaasshhbbuugg cannot locate any of the alternative editors,
+              it attempts to execute vvii.

-       HHOOMMEE   Directory in which the failed bug report is saved  if  the  mail
+       HHOOMMEE   Directory  in  which  the failed bug report is saved if the mail
              fails.

       TTMMPPDDIIRR Directory in which to create temporary files and directories.
@@ -48,4 +49,4 @@ AAUUTTHHOORRSS



-GNU Bash-4.4                   2016 February 15                     BASHBUG(1)
+GNU Bash 5.1                     2020 August 1                      BASHBUG(1)
@@ -1,10 +1,10 @@
 %!PS-Adobe-3.0
-%%Creator: groff version 1.22.3
-%%CreationDate: Mon Mar 28 15:34:55 2016
+%%Creator: groff version 1.22.4
+%%CreationDate: Fri Aug  7 11:58:10 2020
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%+ font Times-Italic
-%%DocumentSuppliedResources: procset grops 1.22 3
+%%DocumentSuppliedResources: procset grops 1.22 4
 %%Pages: 1
 %%PageOrder: Ascend
 %%DocumentMedia: Default 612 792 0 () ()
@@ -14,7 +14,7 @@
 %%PageMedia: Default
 %%EndDefaults
 %%BeginProlog
-%%BeginResource: procset grops 1.22 3
+%%BeginResource: procset grops 1.22 4
 %!PS-Adobe-3.0 Resource-ProcSet
 /setpacking where{
 pop
@@ -275,20 +275,23 @@ E(vironment v)-.4 E(ariables if the)-.25 E 2.5(ye)-.15 G(xist:)-2.65 E
 F2(EDIT)108 300 Q(OR)-.18 E F0 .327(Speci\214es the preferred editor)144
 312 R 2.827(.I)-.55 G(f)-2.827 E F4(EDIT)2.827 E(OR)-.162 E F0 .327
 (is not set,)2.577 F F2(bashb)2.827 E(ug)-.2 E F0 .328
-(attempts to locate a number of alter)2.827 F(-)-.2 E(nati)144 324 Q .3
-.15(ve e)-.25 H(ditors, including).15 E F2(emacs)2.5 E F0 2.5(,a)C
-(nd def)-2.5 E(aults to)-.1 E F2(vi)2.5 E F0(.)A F2(HOME)108 340.8 Q F0
-(Directory in which the f)144 352.8 Q(ailed b)-.1 E(ug report is sa)-.2
-E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G(he mail f)-2.5 E(ails.)-.1 E
-F2(TMPDIR)108 369.6 Q F0
+(attempts to locate a number of alter)2.827 F(-)-.2 E(nati)144 324 Q
+1.925 -.15(ve e)-.25 H 1.625(ditors, including).15 F F2(emacs)4.125 E F0
+6.625(.I)C(f)-6.625 E F2(bashb)4.125 E(ug)-.2 E F0 1.625
+(cannot locate an)4.125 F 4.125(yo)-.15 G 4.125(ft)-4.125 G 1.625
+(he alternati)-4.125 F 1.925 -.15(ve e)-.25 H 1.625(ditors, it at-).15 F
+(tempts to e)144 336 Q -.15(xe)-.15 G(cute).15 E F2(vi)2.5 E F0(.)A F2
+(HOME)108 352.8 Q F0(Directory in which the f)144 364.8 Q(ailed b)-.1 E
+(ug report is sa)-.2 E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G
+(he mail f)-2.5 E(ails.)-.1 E F2(TMPDIR)108 381.6 Q F0
 (Directory in which to create temporary \214les and directories.)144
-381.6 Q F1(SEE ALSO)72 398.4 Q F3(bash)108 410.4 Q F0(\(1\))A F1 -.548
-(AU)72 427.2 S(THORS).548 E F0(Brian F)108 439.2 Q(ox, Free Softw)-.15 E
-(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 451.2 Q(g)-.18 E
-(Chet Rame)108 468 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
+393.6 Q F1(SEE ALSO)72 410.4 Q F3(bash)108 422.4 Q F0(\(1\))A F1 -.548
+(AU)72 439.2 S(THORS).548 E F0(Brian F)108 451.2 Q(ox, Free Softw)-.15 E
+(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 463.2 Q(g)-.18 E
+(Chet Rame)108 480 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E(chet@po.cwru.edu)
-108 480 Q(GNU Bash-4.4)72 768 Q(2016 February 15)138.46 E(1)193.45 E 0
-Cg EP
+108 492 Q(GNU Bash 5.1)72 768 Q(2020 August 1)145.395 E(1)199.555 E 0 Cg
+EP
 %%Trailer
 end
 %%EOF
@@ -1,9 +1,9 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <!-- This text is a brief description of the features that are present in
-the Bash shell (version 5.1, 2 July 2020).
+the Bash shell (version 5.1, 3 August 2020).

-This is Edition 5.1, last updated 2 July 2020,
+This is Edition 5.1, last updated 3 August 2020,
 of The GNU Bash Reference Manual,
 for Bash, Version 5.1.

@@ -63,6 +63,7 @@ ul.no-bullet {list-style: none}



+
 <span id="SEC_Contents"></span>
 <h2 class="contents-heading">Table of Contents</h2>

@@ -275,10 +276,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
 <span id="Bash-Features-1"></span><h1 class="top">Bash Features</h1>

 <p>This text is a brief description of the features that are present in
-the Bash shell (version 5.1, 2 July 2020).
+the Bash shell (version 5.1, 3 August 2020).
 The Bash home page is <a href="http://www.gnu.org/software/bash/">http://www.gnu.org/software/bash/</a>.
 </p>
-<p>This is Edition 5.1, last updated 2 July 2020,
+<p>This is Edition 5.1, last updated 3 August 2020,
 of <cite>The GNU Bash Reference Manual</cite>,
 for <code>Bash</code>, Version 5.1.
 </p>
@@ -5040,6 +5041,8 @@ If <var>name</var> is &lsquo;<samp>-</samp>&rsquo;, the set of shell options is
 function in which <code>local</code> is invoked: shell options changed using
 the <code>set</code> builtin inside the function are restored to their original
 values when the function returns.
+The restore is effected as if a series of <code>set</code> commands were executed
+to restore the values that were in place before the function.
 The return status is zero unless <code>local</code> is used outside
 a function, an invalid <var>name</var> is supplied, or <var>name</var> is a
 readonly variable.
@@ -11363,12 +11366,16 @@ Next: <a href="#Numeric-Arguments" accesskey="n" rel="next">Numeric Arguments</a
 <span id="index-kill_002dline-_0028C_002dk_0029"></span>
 </dt>
 <dd><p>Kill the text from point to the end of the line.
+With a negative numeric argument, kill backward from the cursor to the
+beginning of the current line.
 </p>
 </dd>
 <dt><code>backward-kill-line (C-x Rubout)</code>
 <span id="index-backward_002dkill_002dline-_0028C_002dx-Rubout_0029"></span>
 </dt>
 <dd><p>Kill backward from the cursor to the beginning of the current line.
+With a negative numeric argument, kill forward from the cursor to the
+end of the current line.
 </p>
 </dd>
 <dt><code>unix-line-discard (C-u)</code>
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.7 from
 bashref.texi.

 This text is a brief description of the features that are present in the
-Bash shell (version 5.1, 2 July 2020).
+Bash shell (version 5.1, 3 August 2020).

-   This is Edition 5.1, last updated 2 July 2020, of 'The GNU Bash
+   This is Edition 5.1, last updated 3 August 2020, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.

   Copyright (C) 1988-2018 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
 *************

 This text is a brief description of the features that are present in the
-Bash shell (version 5.1, 2 July 2020).  The Bash home page is
+Bash shell (version 5.1, 3 August 2020).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.1, last updated 2 July 2020, of 'The GNU Bash
+   This is Edition 5.1, last updated 3 August 2020, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.

   Bash contains features that appear in other popular shells, and some
@@ -3746,9 +3746,11 @@ standard.
     and its children.  If NAME is '-', the set of shell options is made
     local to the function in which 'local' is invoked: shell options
     changed using the 'set' builtin inside the function are restored to
-     their original values when the function returns.  The return status
-     is zero unless 'local' is used outside a function, an invalid NAME
-     is supplied, or NAME is a readonly variable.
+     their original values when the function returns.  The restore is
+     effected as if a series of 'set' commands were executed to restore
+     the values that were in place before the function.  The return
+     status is zero unless 'local' is used outside a function, an
+     invalid NAME is supplied, or NAME is a readonly variable.

 'logout'
          logout [N]
@@ -8523,10 +8525,14 @@ File: bashref.info,  Node: Commands For Killing,  Next: Numeric Arguments,  Prev
 -------------------------

 'kill-line (C-k)'
-     Kill the text from point to the end of the line.
+     Kill the text from point to the end of the line.  With a negative
+     numeric argument, kill backward from the cursor to the beginning of
+     the current line.

 'backward-kill-line (C-x Rubout)'
     Kill backward from the cursor to the beginning of the current line.
+     With a negative numeric argument, kill forward from the cursor to
+     the end of the current line.

 'unix-line-discard (C-u)'
     Kill backward from the cursor to the beginning of the current line.
@@ -11294,17 +11300,17 @@ D.1 Index of Shell Builtin Commands
                                                              (line  58)
 * let:                                   Bash Builtins.       (line 350)
 * local:                                 Bash Builtins.       (line 358)
-* logout:                                Bash Builtins.       (line 372)
-* mapfile:                               Bash Builtins.       (line 377)
+* logout:                                Bash Builtins.       (line 374)
+* mapfile:                               Bash Builtins.       (line 379)
 * popd:                                  Directory Stack Builtins.
                                                              (line  35)
-* printf:                                Bash Builtins.       (line 423)
+* printf:                                Bash Builtins.       (line 425)
 * pushd:                                 Directory Stack Builtins.
                                                              (line  53)
 * pwd:                                   Bourne Shell Builtins.
                                                              (line 207)
-* read:                                  Bash Builtins.       (line 472)
-* readarray:                             Bash Builtins.       (line 568)
+* read:                                  Bash Builtins.       (line 474)
+* readarray:                             Bash Builtins.       (line 570)
 * readonly:                              Bourne Shell Builtins.
                                                              (line 217)
 * return:                                Bourne Shell Builtins.
@@ -11313,7 +11319,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                              (line 257)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 577)
+* source:                                Bash Builtins.       (line 579)
 * suspend:                               Job Control Builtins.
                                                              (line 113)
 * test:                                  Bourne Shell Builtins.
@@ -11322,12 +11328,12 @@ D.1 Index of Shell Builtin Commands
                                                              (line 349)
 * trap:                                  Bourne Shell Builtins.
                                                              (line 355)
-* type:                                  Bash Builtins.       (line 582)
-* typeset:                               Bash Builtins.       (line 614)
-* ulimit:                                Bash Builtins.       (line 620)
+* type:                                  Bash Builtins.       (line 584)
+* typeset:                               Bash Builtins.       (line 616)
+* ulimit:                                Bash Builtins.       (line 622)
 * umask:                                 Bourne Shell Builtins.
                                                              (line 404)
-* unalias:                               Bash Builtins.       (line 723)
+* unalias:                               Bash Builtins.       (line 725)
 * unset:                                 Bourne Shell Builtins.
                                                              (line 422)
 * wait:                                  Job Control Builtins.
@@ -11622,9 +11628,9 @@ D.4 Function Index
 * backward-char (C-b):                   Commands For Moving. (line  15)
 * backward-delete-char (Rubout):         Commands For Text.   (line  17)
 * backward-kill-line (C-x Rubout):       Commands For Killing.
-                                                              (line   9)
+                                                              (line  11)
 * backward-kill-word (M-<DEL>):          Commands For Killing.
-                                                              (line  24)
+                                                              (line  28)
 * backward-word (M-b):                   Commands For Moving. (line  22)
 * beginning-of-history (M-<):            Commands For History.
                                                              (line  20)
@@ -11653,18 +11659,18 @@ D.4 Function Index
 * complete-variable (M-$):               Commands For Completion.
                                                              (line  64)
 * copy-backward-word ():                 Commands For Killing.
-                                                              (line  65)
+                                                              (line  69)
 * copy-forward-word ():                  Commands For Killing.
-                                                              (line  70)
+                                                              (line  74)
 * copy-region-as-kill ():                Commands For Killing.
-                                                              (line  61)
+                                                              (line  65)
 * dabbrev-expand ():                     Commands For Completion.
                                                              (line  95)
 * delete-char (C-d):                     Commands For Text.   (line  12)
 * delete-char-or-list ():                Commands For Completion.
                                                              (line  43)
 * delete-horizontal-space ():            Commands For Killing.
-                                                              (line  53)
+                                                              (line  57)
 * digit-argument (M-0, M-1, ... M--):    Numeric Arguments.   (line   6)
 * display-shell-version (C-x C-v):       Miscellaneous Commands.
                                                              (line 110)
@@ -11720,11 +11726,11 @@ D.4 Function Index
 * kill-line (C-k):                       Commands For Killing.
                                                              (line   6)
 * kill-region ():                        Commands For Killing.
-                                                              (line  57)
+                                                              (line  61)
 * kill-whole-line ():                    Commands For Killing.
-                                                              (line  15)
-* kill-word (M-d):                       Commands For Killing.
                                                              (line  19)
+* kill-word (M-d):                       Commands For Killing.
+                                                              (line  23)
 * magic-space ():                        Miscellaneous Commands.
                                                              (line 121)
 * menu-complete ():                      Commands For Completion.
@@ -11771,15 +11777,15 @@ D.4 Function Index
 * set-mark (C-@):                        Miscellaneous Commands.
                                                              (line  33)
 * shell-backward-kill-word ():           Commands For Killing.
-                                                              (line  33)
+                                                              (line  37)
 * shell-backward-word (M-C-b):           Commands For Moving. (line  30)
 * shell-expand-line (M-C-e):             Miscellaneous Commands.
                                                              (line 113)
 * shell-forward-word (M-C-f):            Commands For Moving. (line  26)
 * shell-kill-word (M-C-d):               Commands For Killing.
-                                                              (line  28)
+                                                              (line  32)
 * shell-transpose-words (M-C-t):         Commands For Killing.
-                                                              (line  37)
+                                                              (line  41)
 * skip-csi-sequence ():                  Miscellaneous Commands.
                                                              (line  52)
 * start-kbd-macro (C-x ():               Keyboard Macros.     (line   6)
@@ -11791,20 +11797,20 @@ D.4 Function Index
                                                              (line  23)
 * universal-argument ():                 Numeric Arguments.   (line  10)
 * unix-filename-rubout ():               Commands For Killing.
-                                                              (line  48)
+                                                              (line  52)
 * unix-line-discard (C-u):               Commands For Killing.
-                                                              (line  12)
+                                                              (line  16)
 * unix-word-rubout (C-w):                Commands For Killing.
-                                                              (line  44)
+                                                              (line  48)
 * upcase-word (M-u):                     Commands For Text.   (line  58)
 * yank (C-y):                            Commands For Killing.
-                                                              (line  75)
+                                                              (line  79)
 * yank-last-arg (M-. or M-_):            Commands For History.
                                                              (line  84)
 * yank-nth-arg (M-C-y):                  Commands For History.
                                                              (line  75)
 * yank-pop (M-y):                        Commands For Killing.
-                                                              (line  78)
+                                                              (line  82)


 File: bashref.info,  Node: Concept Index,  Prev: Function Index,  Up: Indexes
@@ -11973,137 +11979,137 @@ D.5 Concept Index


 Tag Table:
-Node: Top887
-Node: Introduction2797
-Node: What is Bash?3013
-Node: What is a shell?4127
-Node: Definitions6665
-Node: Basic Shell Features9616
-Node: Shell Syntax10835
-Node: Shell Operation11861
-Node: Quoting13154
-Node: Escape Character14454
-Node: Single Quotes14939
-Node: Double Quotes15287
-Node: ANSI-C Quoting16565
-Node: Locale Translation17824
-Node: Comments18977
-Node: Shell Commands19595
-Node: Reserved Words20533
-Node: Simple Commands21289
-Node: Pipelines21943
-Node: Lists24875
-Node: Compound Commands26666
-Node: Looping Constructs27678
-Node: Conditional Constructs30173
-Node: Command Grouping41744
-Node: Coprocesses43223
-Node: GNU Parallel45126
-Node: Shell Functions49427
-Node: Shell Parameters56634
-Node: Positional Parameters61047
-Node: Special Parameters61947
-Node: Shell Expansions65171
-Node: Brace Expansion67294
-Node: Tilde Expansion70017
-Node: Shell Parameter Expansion72634
-Node: Command Substitution87763
-Node: Arithmetic Expansion89118
-Node: Process Substitution90050
-Node: Word Splitting91170
-Node: Filename Expansion93114
-Node: Pattern Matching95663
-Node: Quote Removal99649
-Node: Redirections99944
-Node: Executing Commands109514
-Node: Simple Command Expansion110184
-Node: Command Search and Execution112138
-Node: Command Execution Environment114514
-Node: Environment117498
-Node: Exit Status119157
-Node: Signals120827
-Node: Shell Scripts122794
-Node: Shell Builtin Commands125806
-Node: Bourne Shell Builtins127844
-Node: Bash Builtins148773
-Node: Modifying Shell Behavior178564
-Node: The Set Builtin178909
-Node: The Shopt Builtin189322
-Node: Special Builtins204232
-Node: Shell Variables205211
-Node: Bourne Shell Variables205648
-Node: Bash Variables207752
-Node: Bash Features240330
-Node: Invoking Bash241343
-Node: Bash Startup Files247356
-Node: Interactive Shells252459
-Node: What is an Interactive Shell?252869
-Node: Is this Shell Interactive?253518
-Node: Interactive Shell Behavior254333
-Node: Bash Conditional Expressions257847
-Node: Shell Arithmetic262424
-Node: Aliases265364
-Node: Arrays267984
-Node: The Directory Stack273993
-Node: Directory Stack Builtins274777
-Node: Controlling the Prompt277745
-Node: The Restricted Shell280695
-Node: Bash POSIX Mode283289
-Node: Shell Compatibility Mode294325
-Node: Job Control300981
-Node: Job Control Basics301441
-Node: Job Control Builtins306437
-Node: Job Control Variables311837
-Node: Command Line Editing312993
-Node: Introduction and Notation314664
-Node: Readline Interaction316287
-Node: Readline Bare Essentials317478
-Node: Readline Movement Commands319261
-Node: Readline Killing Commands320221
-Node: Readline Arguments322139
-Node: Searching323183
-Node: Readline Init File325369
-Node: Readline Init File Syntax326628
-Node: Conditional Init Constructs347167
-Node: Sample Init File351363
-Node: Bindable Readline Commands354487
-Node: Commands For Moving355691
-Node: Commands For History357742
-Node: Commands For Text362535
-Node: Commands For Killing366184
-Node: Numeric Arguments368999
-Node: Commands For Completion370138
-Node: Keyboard Macros374329
-Node: Miscellaneous Commands375016
-Node: Readline vi Mode380700
-Node: Programmable Completion381607
-Node: Programmable Completion Builtins389387
-Node: A Programmable Completion Example400082
-Node: Using History Interactively405329
-Node: Bash History Facilities406013
-Node: Bash History Builtins409018
-Node: History Interaction413747
-Node: Event Designators417367
-Node: Word Designators418721
-Node: Modifiers420481
-Node: Installing Bash422292
-Node: Basic Installation423429
-Node: Compilers and Options426687
-Node: Compiling For Multiple Architectures427428
-Node: Installation Names429121
-Node: Specifying the System Type429939
-Node: Sharing Defaults430655
-Node: Operation Controls431328
-Node: Optional Features432286
-Node: Reporting Bugs442804
-Node: Major Differences From The Bourne Shell443998
-Node: GNU Free Documentation License460850
-Node: Indexes486027
-Node: Builtin Index486481
-Node: Reserved Word Index493308
-Node: Variable Index495756
-Node: Function Index511653
-Node: Concept Index525163
+Node: Top891
+Node: Introduction2805
+Node: What is Bash?3021
+Node: What is a shell?4135
+Node: Definitions6673
+Node: Basic Shell Features9624
+Node: Shell Syntax10843
+Node: Shell Operation11869
+Node: Quoting13162
+Node: Escape Character14462
+Node: Single Quotes14947
+Node: Double Quotes15295
+Node: ANSI-C Quoting16573
+Node: Locale Translation17832
+Node: Comments18985
+Node: Shell Commands19603
+Node: Reserved Words20541
+Node: Simple Commands21297
+Node: Pipelines21951
+Node: Lists24883
+Node: Compound Commands26674
+Node: Looping Constructs27686
+Node: Conditional Constructs30181
+Node: Command Grouping41752
+Node: Coprocesses43231
+Node: GNU Parallel45134
+Node: Shell Functions49435
+Node: Shell Parameters56642
+Node: Positional Parameters61055
+Node: Special Parameters61955
+Node: Shell Expansions65179
+Node: Brace Expansion67302
+Node: Tilde Expansion70025
+Node: Shell Parameter Expansion72642
+Node: Command Substitution87771
+Node: Arithmetic Expansion89126
+Node: Process Substitution90058
+Node: Word Splitting91178
+Node: Filename Expansion93122
+Node: Pattern Matching95671
+Node: Quote Removal99657
+Node: Redirections99952
+Node: Executing Commands109522
+Node: Simple Command Expansion110192
+Node: Command Search and Execution112146
+Node: Command Execution Environment114522
+Node: Environment117506
+Node: Exit Status119165
+Node: Signals120835
+Node: Shell Scripts122802
+Node: Shell Builtin Commands125814
+Node: Bourne Shell Builtins127852
+Node: Bash Builtins148781
+Node: Modifying Shell Behavior178716
+Node: The Set Builtin179061
+Node: The Shopt Builtin189474
+Node: Special Builtins204384
+Node: Shell Variables205363
+Node: Bourne Shell Variables205800
+Node: Bash Variables207904
+Node: Bash Features240482
+Node: Invoking Bash241495
+Node: Bash Startup Files247508
+Node: Interactive Shells252611
+Node: What is an Interactive Shell?253021
+Node: Is this Shell Interactive?253670
+Node: Interactive Shell Behavior254485
+Node: Bash Conditional Expressions257999
+Node: Shell Arithmetic262576
+Node: Aliases265516
+Node: Arrays268136
+Node: The Directory Stack274145
+Node: Directory Stack Builtins274929
+Node: Controlling the Prompt277897
+Node: The Restricted Shell280847
+Node: Bash POSIX Mode283441
+Node: Shell Compatibility Mode294477
+Node: Job Control301133
+Node: Job Control Basics301593
+Node: Job Control Builtins306589
+Node: Job Control Variables311989
+Node: Command Line Editing313145
+Node: Introduction and Notation314816
+Node: Readline Interaction316439
+Node: Readline Bare Essentials317630
+Node: Readline Movement Commands319413
+Node: Readline Killing Commands320373
+Node: Readline Arguments322291
+Node: Searching323335
+Node: Readline Init File325521
+Node: Readline Init File Syntax326780
+Node: Conditional Init Constructs347319
+Node: Sample Init File351515
+Node: Bindable Readline Commands354639
+Node: Commands For Moving355843
+Node: Commands For History357894
+Node: Commands For Text362687
+Node: Commands For Killing366336
+Node: Numeric Arguments369369
+Node: Commands For Completion370508
+Node: Keyboard Macros374699
+Node: Miscellaneous Commands375386
+Node: Readline vi Mode381070
+Node: Programmable Completion381977
+Node: Programmable Completion Builtins389757
+Node: A Programmable Completion Example400452
+Node: Using History Interactively405699
+Node: Bash History Facilities406383
+Node: Bash History Builtins409388
+Node: History Interaction414117
+Node: Event Designators417737
+Node: Word Designators419091
+Node: Modifiers420851
+Node: Installing Bash422662
+Node: Basic Installation423799
+Node: Compilers and Options427057
+Node: Compiling For Multiple Architectures427798
+Node: Installation Names429491
+Node: Specifying the System Type430309
+Node: Sharing Defaults431025
+Node: Operation Controls431698
+Node: Optional Features432656
+Node: Reporting Bugs443174
+Node: Major Differences From The Bourne Shell444368
+Node: GNU Free Documentation License461220
+Node: Indexes486397
+Node: Builtin Index486851
+Node: Reserved Word Index493678
+Node: Variable Index496126
+Node: Function Index512023
+Node: Concept Index525533

 End Tag Table

@@ -1,4 +1,4 @@
-This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019/MacPorts 2019.50896_2) (preloaded format=pdfetex 2019.11.6)  17 JUL 2020 15:12
+This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019/MacPorts 2019.50896_2) (preloaded format=pdfetex 2019.11.6)  7 AUG 2020 11:58
 entering extended mode
 restricted \write18 enabled.
 file:line:error style messages enabled.
@@ -280,7 +280,7 @@ gnored[]

 [127] [128] [129] [130] [131] [132] [133] [134] [135] [136]
 [137] [138] [139]
-Overfull \hbox (15.27109pt too wide) in paragraph at lines 2058--2058
+Overfull \hbox (15.27109pt too wide) in paragraph at lines 2062--2062
 []@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-DEI] [
 -A @textttsl ac-tion@texttt ] [-

@@ -308,7 +308,7 @@ texinfo.tex: doing @include of fdl.texi
 Here is how much of TeX's memory you used:
 4088 strings out of 497098
 47386 string characters out of 6206772
- 139199 words of memory out of 5000000
+ 139203 words of memory out of 5000000
 4863 multiletter control sequences out of 15000+600000
 34315 words of font info for 116 fonts, out of 8000000 for 9000
 51 hyphenation exceptions out of 8191
@@ -330,7 +330,7 @@ e/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texlive/fon
 ts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/typ
 e1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
 lic/cm-super/sfrm1440.pfb>
-Output written on bashref.pdf (189 pages, 768833 bytes).
+Output written on bashref.pdf (189 pages, 769145 bytes).
 PDF statistics:
 2680 PDF objects out of 2984 (max. 8388607)
 2445 compressed objects within 25 object streams
@@ -827,11 +827,13 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
              is made local to the function in which llooccaall is  invoked:  shell
              options  changed  using  the sseett builtin inside the function are
              restored to their original values  when  the  function  returns.
-              With  no operands, llooccaall writes a list of local variables to the
-              standard output.  It is an error to use llooccaall when not within  a
-              function.  The return status is 0 unless llooccaall is used outside a
-              function, an invalid _n_a_m_e is supplied, or  _n_a_m_e  is  a  readonly
-              variable.
+              The restore is effected as if a series of sseett commands were exe-
+              cuted to restore the values that were in place before the  func-
+              tion.   With no operands, llooccaall writes a list of local variables
+              to the standard output.  It is an error to use  llooccaall  when  not
+              within  a function.  The return status is 0 unless llooccaall is used
+              outside a function, an invalid _n_a_m_e is supplied, or  _n_a_m_e  is  a
+              readonly variable.

       llooggoouutt Exit a login shell.

@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.22.4
-%%CreationDate: Fri Jul 17 15:12:32 2020
+%%CreationDate: Fri Aug  7 11:58:10 2020
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%DocumentSuppliedResources: procset grops 1.22 4
@@ -62,6 +62,7 @@
 #include <stdio.h>
 #include <ctype.h>
 #include <time.h>
+#include <errno.h>

 #if defined(TM_IN_SYS_TIME)
 #include <sys/types.h>
@@ -80,6 +81,10 @@

 #undef strchr	/* avoid AIX weirdness */

+#if !defined (errno)
+extern int errno;
+#endif
+
 #if defined (SHELL)
 extern char *get_string_value (const char *);
 #endif
@@ -172,7 +177,7 @@ strftime(char *s, size_t maxsize, const char *format, const struct tm *timeptr)
 	char *start = s;
 	auto char tbuf[100];
 	long off;
-	int i, w;
+	int i, w, oerrno;
 	long y;
 	static short first = 1;
 #ifdef POSIX_SEMANTICS
@@ -217,6 +222,8 @@ strftime(char *s, size_t maxsize, const char *format, const struct tm *timeptr)
 	};
 	static const char *ampm[] = { "AM", "PM", };

+	oerrno = errno;
+
 	if (s == NULL || format == NULL || timeptr == NULL || maxsize == 0)
 		return 0;

@@ -716,6 +723,8 @@ strftime(char *s, size_t maxsize, const char *format, const struct tm *timeptr)
 out:
 	if (s < endp && *format == '\0') {
 		*s = '\0';
+		if (s == start)
+			errno = oerrno;
 		return (s - start);
 	} else
 		return 0;
--- a/Show More
+++ b/Show More