From 2f5dfe5a18b4670eb4cea32c1c76295eb70a8865 Mon Sep 17 00:00:00 2001 From: Chet Ramey Date: Mon, 17 Sep 2018 15:10:56 -0400 Subject: bash-5.0-beta release --- doc/bash.html | 90 ++++++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 65 insertions(+), 25 deletions(-) (limited to 'doc/bash.html') diff --git a/doc/bash.html b/doc/bash.html index 54b42fec..08e1b4a4 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -3,7 +3,7 @@ -

BASH(1)	2018 March 15	BASH(1) +	BASH(1)	2018 August 7	BASH(1)

Index @@ -965,7 +965,7 @@ to be matched as a string. An additional binary operator, =~, is available, with the same precedence as == and !=. When it is used, the string to the right of the operator is considered -an extended regular expression and matched accordingly (as in regex(3)). +a POSIX extended regular expression and matched accordingly (as in regex(3)). The return value is 0 if the string matches the pattern, and 1 otherwise. If the regular expression is syntactically incorrect, the conditional @@ -1738,7 +1738,14 @@ is null, the parameters are joined without intervening separators.

-Expands to the positional parameters, starting from one. When the +Expands to the positional parameters, starting from one. +In contexts where word splitting is performed, this expands each +positional parameter to a separate word; if not within double +quotes, these words are subject to word splitting. +In contexts where word splitting is not performed, +this expands to a single word +with each positional parameter separated by a space. +When the expansion occurs within double quotes, each parameter expands to a separate word. That is, "$@" is equivalent to "$1" "$2" ... @@ -1922,7 +1929,8 @@ option to the shopt builtin below). -Setting extdebug after the shell has started to execute a script +Setting extdebug after the shell has started to execute a script, +or referencing this variable when extdebug is not set, may result in inconsistent values.

BASH_ARGV @@ -1947,7 +1955,8 @@ option to the shopt builtin below). -Setting extdebug after the shell has started to execute a script +Setting extdebug after the shell has started to execute a script, +or referencing this variable when extdebug is not set, may result in inconsistent values.

BASH_ARGV0 @@ -2634,7 +2643,7 @@ Similar to BASH_ENV; -used when the shell is invoked in POSIX mode. +used when the shell is invoked in posix mode.

EXECIGNORE

@@ -2887,6 +2896,12 @@ startup file, overriding the default of below). +

INSIDE_EMACS + +

+If this variable appears in the environment when the shell starts, +bash assumes that it is running inside an Emacs shell buffer +and may disable line editing, depending on the value of TERM.

LANG

@@ -3043,6 +3058,8 @@ running, bash enables posix mode, as if the command set -o posix had been executed. +When the shell enters posix mode, it sets this variable if it was +not already set.

PROMPT_COMMAND

@@ -3698,6 +3715,16 @@ and and the shell assigns the expanded value. +

+ +Bash also performs tilde expansion on words satisfying the conditions of +variable assignments (as described above under +PARAMETERS) + + +when they appear as arguments to simple commands. +Bash does not do this, except for the declaration commands listed +above, when in posix mode.

Parameter Expansion

@@ -3738,16 +3765,16 @@ The parameter is a shell parameter as described above If the first character of parameter is an exclamation point (!), and parameter is not a nameref, -it introduces a level of variable indirection. -Bash uses the value of the variable formed from the rest of -parameter as the name of the variable; this variable is then -expanded and that value is used in the rest of the substitution, rather -than the value of parameter itself. +it introduces a level of indirection. +Bash uses the value formed by expanding the rest of +parameter as the new parameter; this is then +expanded and that value is used in the rest of the expansion, rather +than the expansion of the original parameter. This is known as indirect expansion. The value is subject to tilde expansion, parameter expansion, command substitution, and arithmetic expansion. If parameter is a nameref, this expands to the name of the -variable referenced by parameter instead of performing the +parameter referenced by parameter instead of performing the complete indirect expansion. The exceptions to this are the expansions of ${!prefix*} and ${!name[@]} described below. @@ -6125,7 +6152,7 @@ cannot affect the shell's execution environment.

Subshells spawned to execute command substitutions inherit the value of -the -e option from the parent shell. When not in posix mode, +the -e option from the parent shell. When not in posix mode, bash clears the -e option in such subshells.

@@ -9745,12 +9772,12 @@ will be displayed.

The return value is true unless an invalid option is supplied, or no matches were generated. -

complete [-abcdefgjksuv] [-o comp-option] [-DE] [-A action] [-G globpat] [-W wordlist] [-F function] [-C command]

complete [-abcdefgjksuv] [-o comp-option] [-DEI] [-A action] [-G globpat] [-W wordlist] [-F function] [-C command]

[-X filterpat] [-P prefix] [-S suffix] name [name ...] -

complete -pr [-DE] [name ...]

complete -pr [-DEI] [name ...]

Specify how arguments to each name should be completed. If the -p option is supplied, or if no options are supplied, @@ -9759,12 +9786,21 @@ them to be reused as input. The -r option removes a completion specification for each name, or, if no names are supplied, all completion specifications. -The -D option indicates that the remaining options and actions should +The -D option indicates that other supplied options and actions should apply to the ``default'' command completion; that is, completion attempted on a command for which no completion has previously been defined. -The -E option indicates that the remaining options and actions should +The -E option indicates that other supplied options and actions should apply to ``empty'' command completion; that is, completion attempted on a blank line. +The -I option indicates that other supplied options and actions should +apply to completion on the inital non-assignment word on the line, or after +a command delimiter such as ; or |, which is usually command +name completion. +If multiple options are supplied, the -D option takes precedence +over -E, and both take precedence over -I. +If any of -D, -E, or -I are supplied, any other +name arguments are ignored; these completions only apply to the case +specified by the option.

The process of applying these completion specifications when word completion is attempted is described above under Programmable Completion. @@ -9995,7 +10031,7 @@ a name for which no specification exists, or an error occurs adding a completion specification. -

compopt [-o option] [-DE] [+o option] [name]

compopt [-o option] [-DEI] [+o option] [name]

Modify completion options for each name according to the options, or for the currently-executing completion if no names are supplied. @@ -10003,12 +10039,16 @@ If no options are given, display the completion options for each name or the current completion. The possible values of option are those valid for the complete builtin described above. -The -D option indicates that the remaining options should +The -D option indicates that other supplied options should apply to the ``default'' command completion; that is, completion attempted on a command for which no completion has previously been defined. -The -E option indicates that the remaining options should +The -E option indicates that other supplied options should apply to ``empty'' command completion; that is, completion attempted on a blank line. +The -I option indicates that other supplied options should +apply to completion on the inital non-assignment word on the line, +or after a command delimiter such as ; or |, which is usually +command name completion.

The return value is true unless an invalid option is supplied, an attempt is made to modify the options for a name for which no completion @@ -11727,7 +11767,7 @@ Without options, the name and value of each shell variable are displayed in a format that can be reused as input for setting or resetting the currently-set variables. Read-only variables cannot be reset. -In posix mode, only shell variables are listed. +In posix mode, only shell variables are listed. The output is sorted according to the current locale. When options are specified, they set or unset shell attributes. Any arguments remaining after option processing are treated @@ -12444,7 +12484,7 @@ interrupt; previous versions continue with the next command in the list. If set, bash, -when in posix mode, treats a single quote in a double-quoted +when in posix mode, treats a single quote in a double-quoted parameter expansion as a special character. The single quotes must match (an even number) and the characters between the single quotes are considered quoted. This is the behavior of posix mode through version 4.1. @@ -13426,7 +13466,7 @@ and -u, which are unscaled values; -and, when in Posix mode, +and, when in posix mode, -c and @@ -13852,7 +13892,7 @@ There may be only one active coprocess at a time.

GNU Bash 5.0	2018 March 15	BASH(1) +	GNU Bash 5.0	2018 August 7	BASH(1)

@@ -13958,6 +13998,6 @@ There may be only one active coprocess at a time.

This document was created by man2html from bash.1.
-Time: 19 March 2018 09:43:32 EDT +Time: 07 September 2018 16:15:28 EDT -- cgit v1.2.1