diff options
Diffstat (limited to 'doc/bashref.html')
| -rw-r--r-- | doc/bashref.html | 74 |
1 files changed, 44 insertions, 30 deletions
diff --git a/doc/bashref.html b/doc/bashref.html index 0a871c6a..2c1cfadf 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -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, 5 June 2020). +the Bash shell (version 5.1, 25 August 2020). -This is Edition 5.1, last updated 5 June 2020, +This is Edition 5.1, last updated 25 August 2020, of The GNU Bash Reference Manual, for Bash, Version 5.1. @@ -275,10 +275,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, 5 June 2020). +the Bash shell (version 5.1, 25 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 5 June 2020, +<p>This is Edition 5.1, last updated 25 August 2020, of <cite>The GNU Bash Reference Manual</cite>, for <code>Bash</code>, Version 5.1. </p> @@ -3229,7 +3229,7 @@ by {<var>varname</var>}, the value of <var>varname</var> defines the file descriptor to close. If {<var>varname</var>} is supplied, the redirection persists beyond the scope of the command, allowing the shell programmer to manage -the file descriptor himself. +the file descriptor’s lifetime manually. </p> <p>In the following descriptions, if the file descriptor number is omitted, and the first character of the redirection operator is @@ -4322,7 +4322,7 @@ and not during the execution of a script by <code>.</code> or <code>source</code <p>Shift the positional parameters to the left by <var>n</var>. The positional parameters from <var>n</var>+1 … <code>$#</code> are renamed to <code>$1</code> … <code>$#</code>-<var>n</var>. -Parameters represented by the numbers <code>$#</code> to <code>$#</code>-<var>n</var>+1 +Parameters represented by the numbers <code>$#</code> down to <code>$#</code>-<var>n</var>+1 are unset. <var>n</var> must be a non-negative number less than or equal to <code>$#</code>. If <var>n</var> is zero or greater than <code>$#</code>, the positional parameters @@ -5040,6 +5040,8 @@ If <var>name</var> is ‘<samp>-</samp>’, 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. @@ -5197,12 +5199,6 @@ are used to split the line into words using the same rules the shell uses for expansion (described above in <a href="#Word-Splitting">Word Splitting</a>). The backslash character ‘<samp>\</samp>’ may be used to remove any special meaning for the next character read and for line continuation. -If no names are supplied, the line read is assigned to the -variable <code>REPLY</code>. -The exit status is zero, unless end-of-file is encountered, <code>read</code> -times out (in which case the status is greater than 128), -a variable assignment error (such as assigning to a readonly variable) occurs, -or an invalid file descriptor is supplied as the argument to <samp>-u</samp>. </p> <p>Options, if supplied, have the following meanings: </p> @@ -5290,6 +5286,15 @@ The exit status is greater than 128 if the timeout is exceeded. </p></dd> </dl> +<p>If no <var>name</var>s are supplied, the line read, +without the ending delimiter but otherwise unmodified, +is assigned to the +variable <code>REPLY</code>. +The exit status is zero, unless end-of-file is encountered, <code>read</code> +times out (in which case the status is greater than 128), +a variable assignment error (such as assigning to a readonly variable) occurs, +or an invalid file descriptor is supplied as the argument to <samp>-u</samp>. +</p> </dd> <dt><code>readarray</code></dt> <dd><span id="index-readarray"></span> @@ -6289,12 +6294,7 @@ by default. </p> </dd> </dl> - -<p>The return status when listing options is zero if all <var>optnames</var> -are enabled, non-zero otherwise. -When setting or unsetting options, the return status is zero unless an -<var>optname</var> is not a valid shell option. -</p></dd> +</dd> </dl> <hr> @@ -7322,15 +7322,14 @@ not already set. is readonly. </p> </dd> -<dt><code>PROMPT_COMMANDS</code> -<span id="index-PROMPT_005fCOMMANDS"></span> +<dt><code>PROMPT_COMMAND</code> +<span id="index-PROMPT_005fCOMMAND"></span> </dt> -<dd><p>If this array variable is set, +<dd><p>If this variable is set, and is an array, the value of each set element is interpreted as a command to execute before printing the primary prompt (<code>$PS1</code>). -If this is not set, but -<code>PROMPT_COMMAND</code> -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. </p> </dd> <dt><code>PROMPT_DIRTRIM</code> @@ -9347,6 +9346,10 @@ more randomness. If the shell compatibility level is set to 50 or lower, it reverts to the method from bash-5.0 and previous versions, so seeding the random number generator by assigning a value to <code>RANDOM</code> will produce the same sequence as in bash-5.0 +</li><li> 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 <samp>-l</samp> option is supplied. </li></ul> </dd> </dl> @@ -10218,9 +10221,9 @@ replaced with an ellipsis when displaying possible completions. <dd><span id="index-completion_002dquery_002ditems"></span> <p>The number of possible completions that determines when the user is asked whether the list of possibilities should be displayed. -If the number of possible completions is greater than this value, -Readline will ask the user whether or not he wishes to view -them; otherwise, they are simply listed. +If the number of possible completions is greater than or equal to this value, +Readline will ask whether or not the user wishes to view them; +otherwise, they are simply listed. This variable must be set to an integer value greater than or equal to 0. A negative value means Readline should never ask. The default limit is <code>100</code>. @@ -10907,8 +10910,8 @@ set convert-meta off # rather than as meta-prefixed characters set output-meta on -# if there are more than 150 possible completions for -# a word, ask the user if he wants to see all of them +# if there are 150 or more possible completions for a word, +# ask whether or not the user wants to see all of them set completion-query-items 150 # For FTP @@ -11108,6 +11111,7 @@ being entered. </dt> <dd><p>Search backward starting at the current line and moving ‘up’ through the history as necessary. This is an incremental search. +This command sets the region to the matched text and activates the mark. </p> </dd> <dt><code>forward-search-history (C-s)</code> @@ -11115,6 +11119,7 @@ the history as necessary. This is an incremental search. </dt> <dd><p>Search forward starting at the current line and moving ‘down’ through the history as necessary. This is an incremental search. +This command sets the region to the matched text and activates the mark. </p> </dd> <dt><code>non-incremental-reverse-search-history (M-p)</code> @@ -11281,6 +11286,11 @@ each character as if it had been read from the keyboard. The characters are inserted as if each one was bound to <code>self-insert</code> instead of executing any editing commands. </p> +<p>Bracketed paste sets the region (the characters between point and the mark) +to the inserted text. It uses the concept of an <em>active mark</em>: when the +mark is active, Readline redisplay uses the terminal’s standout mode to +denote the region. +</p> </dd> <dt><code>transpose-chars (C-t)</code> <span id="index-transpose_002dchars-_0028C_002dt_0029"></span> @@ -11354,12 +11364,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> @@ -15230,7 +15244,7 @@ Next: <a href="#Function-Index" accesskey="n" rel="next">Function Index</a>, Pre <tr><td></td><td valign="top"><a href="#index-PIPESTATUS"><code>PIPESTATUS</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-POSIXLY_005fCORRECT"><code>POSIXLY_CORRECT</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PPID"><code>PPID</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-PROMPT_005fCOMMANDS"><code>PROMPT_COMMANDS</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-PROMPT_005fCOMMAND"><code>PROMPT_COMMAND</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PROMPT_005fDIRTRIM"><code>PROMPT_DIRTRIM</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PS0"><code>PS0</code></a>:</td><td> </td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PS1"><code>PS1</code></a>:</td><td> </td><td valign="top"><a href="#Bourne-Shell-Variables">Bourne Shell Variables</a></td></tr> |