bash-5.1 beta release

doc/bash.1

@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Fri Jun  5 14:46:57 EDT 2020
+.\"	Last Change: Tue Aug 25 09:58:55 EDT 2020
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2020 June 5" "GNU Bash 5.1"
+.TH BASH 1 "2020 August 25" "GNU Bash 5.1"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -2037,7 +2037,8 @@ below.
 .B BASH_COMPAT
 The value is used to set the shell's compatibility level.
 See
-\fBSHELL COMPATIBILITY MODE\fP
+.SM
+.B SHELL COMPATIBILITY MODE
 below for a description of the various compatibility
 levels and their effects.
 The value may be a decimal number (e.g., 4.2) or an integer (e.g., 42)
@@ -2049,7 +2050,8 @@ compatibility levels, the shell prints an error message and sets the
 compatibility level to the default for the current version.
 The valid values correspond to the compatibility levels
 described below under
-\fBSHELL COMPATIBILITY MODE\fP.
+.SM
+.BR BSHELL COMPATIBILITY MODE .
 For example, 4.2 and 42 are valid values that correspond
 to the \fBcompat42\fP \fBshopt\fP option
 and set the compatibility level to 42.
@@ -2473,13 +2475,12 @@ had been executed.
 When the shell enters \fIposix mode\fP, it sets this variable if it was
 not already set.
 .TP
-.B PROMPT_COMMANDS
-If this array variable is set,
+.B PROMPT_COMMAND
+If this variable is set, and is an array,
 the value of each set element is executed as a command
 prior to issuing each primary prompt.
-If this is not set, but
-.B PROMPT_COMMAND
-is set to a value, its value is used as a command to execute instead.
+If this is set but not an array variable, 
+its value is used as a command to execute instead.
 .TP
 .B PROMPT_DIRTRIM
 If set to a number greater than zero, the value is used as the number of
@@ -5793,11 +5794,11 @@ replaced with an ellipsis when displaying possible completions.
 This determines when the user is queried about viewing
 the number of possible completions
 generated by the \fBpossible\-completions\fP command.
-It may be set to any integer value greater than or equal to
-zero.  If the number of possible completions is greater than
-or equal to the value of this variable, the user is asked whether
-or not he wishes to view them; otherwise they are simply listed
-on the terminal.
+It may be set to any integer value greater than or equal to zero.
+If the number of possible completions is greater than
+or equal to the value of this variable,
+readline will ask whether or not the user wishes to view them;
+otherwise they are simply listed on the terminal.
 .TP
 .B convert\-meta (On)
 If set to \fBOn\fP, readline will convert characters with the
@@ -8960,6 +8961,8 @@ If \fIname\fP is \-, the set of shell options is made local to the function
 in which \fBlocal\fP is invoked: shell options changed using the
 \fBset\fP builtin inside the function are restored to their original values
 when the function returns.
+The restore is effected as if a series of \fBset\fP commands were executed
+to restore the values that were in place before the function.
 With no operands,
 .B local
 writes a list of local variables to the standard output.  It is
@@ -9337,7 +9340,9 @@ Read input from file descriptor \fIfd\fP.
 .PP
 If no
 .I names
-are supplied, the line read is assigned to the variable
+are supplied, the line read,
+without the ending delimiter but otherwise unmodified,
+is assigned to the variable
 .SM
 .BR REPLY .
 The exit status is zero, unless end-of-file is encountered, \fBread\fP
@@ -11058,6 +11063,11 @@ so seeding the random number generator by assigning a value to
 .SM
 .B RANDOM
 will produce the same sequence as in bash-5.0
+.IP \(bu
+If the command hash table is empty, bash versions prior to bash-5.1
+printed an informational message to that effect, even when producing
+output that can be reused as input. Bash-5.1 suppresses that message
+when the \fB\-l\fP option is supplied.
 .RE
 .PD
 .\" bash_builtins