pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-06-24 06:17:57 +02:00
Code Issues Packages Projects Releases Wiki Activity

commit bash-20191127 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2019-12-02 17:23:48 -05:00
parent fc35c477cd
commit 091c6bc481
34 changed files with 5916 additions and 5603 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+42
View File
@@ -6906,3 +6906,45 @@ buitins/wait.def
doc/{bash.1,bashref.texi}
- wait: document new -p option
11/25
-----
lib/readline/display.c
- rl_redisplay: auto-set horizontal scrolling if the terminal has
only one line; disable it if we auto-set it if the terminal grows
to more than one line. Fix from S枚ren Tempel
<soeren@soeren-tempel.net>
lib/readline/doc/{readline.3,rluser.texi},doc/bash.1
- horizontal-scroll-mode: document auto-setting behavior
builtins/set.def
- set_posix_mode: make setting posix mode when it's already set, or
unsetting it when it's not set, a no-op. Inspired by a report
from Ulrich Mueller <ulm@gentoo.org>
11/26
-----
doc/{bash.1,bashref.texi}
- functions: clarify that when in default mode, function names are not
limited to shell identifiers.
Suggested by Reuti <reuti@staff.uni-marburg.de>
11/27
-----
lib/readline/display.c
- _rl_optimize_redisplay: tell the redisplay routines to not worry
about calculating differences between the lines and just draw the
new one. Right now, it just sets the _rl_quick_redisplay flag
- rl_redisplay: if _rl_quick_redisplay is set, just draw NEW onto
the screen at column 0 with a dumb update and clear the rest of
the line. Intended to be used when the caller knows the new line is
sufficiently different from the old one (e.g., when drawing the
i-search prompt for the first time) that it doesn't pay off to do
the calculations. As a side effect, fixes the bug reported by
行恍敌貉械泄 楔懈谢懈薪 <rootlexx@mail.ru>
lib/readline/isearch.c
- rl_display_search: if there isn't a search string, assume this is
the first time this is called and call _rl_optimize_redisplay to
give the redisplay code a hint
builtins/set.def
+5
View File
@@ -395,6 +395,11 @@ set_posix_mode (on_or_off, option_name)
int on_or_off;
char *option_name;
{
/* short-circuit on no-op */
if ((on_or_off == FLAG_ON && posixly_correct) ||
(on_or_off == FLAG_OFF && posixly_correct == 0))
return 0;
posixly_correct = on_or_off == FLAG_ON;
if (posixly_correct == 0)
unbind_variable_noref ("POSIXLY_CORRECT");
doc/bash.0
+1344 -1341
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+20 -16
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Fri Nov 22 15:26:59 EST 2019
.\" Last Change: Tue Nov 26 11:15:17 EST 2019
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2019 November 22" "GNU Bash 5.0"
.TH BASH 1 "2019 November 26" "GNU Bash 5.0"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -50,8 +50,8 @@ bash \- GNU Bourne-Again SHell
[options]
[command_string | file]
.SH COPYRIGHT
.if n Bash is Copyright (C) 1989-2018 by the Free Software Foundation, Inc.
.if t Bash is Copyright \(co 1989-2018 by the Free Software Foundation, Inc.
.if n Bash is Copyright (C) 1989-2019 by the Free Software Foundation, Inc.
.if t Bash is Copyright \(co 1989-2019 by the Free Software Foundation, Inc.
.SH DESCRIPTION
.B Bash
is an \fBsh\fR-compatible command language interpreter that
@@ -994,12 +994,12 @@ A shell function is an object that is called like a simple command and
executes a compound command with a new set of positional parameters.
Shell functions are declared as follows:
.TP
\fIname\fP () \fIcompound\-command\fP [\fIredirection\fP]
\fIfname\fP () \fIcompound\-command\fP [\fIredirection\fP]
.PD 0
.TP
\fBfunction\fP \fIname\fP [()] \fIcompound\-command\fP [\fIredirection\fP]
\fBfunction\fP \fIfname\fP [()] \fIcompound\-command\fP [\fIredirection\fP]
.PD
This defines a function named \fIname\fP.
This defines a function named \fIfname\fP.
The reserved word \fBfunction\fP is optional.
If the \fBfunction\fP reserved word is supplied, the parentheses are optional.
The \fIbody\fP of the function is the compound command
@@ -1009,10 +1009,13 @@ That command is usually a \fIlist\fP of commands between { and }, but
may be any command listed under \fBCompound Commands\fP above,
with one exception: If the \fBfunction\fP reserved word is used, but the
parentheses are not supplied, the braces are required.
\fIcompound\-command\fP is executed whenever \fIname\fP is specified as the
\fIcompound\-command\fP is executed whenever \fIfname\fP is specified as the
name of a simple command.
When in \fIposix mode\fP, \fIname\fP may not be the name of one of the
When in \fIposix mode\fP, \fIfname\fP must be a valid shell \fIname\fP
and may not be the name of one of the
POSIX \fIspecial builtins\fP.
In default mode, a function name can be any unquoted shell word that does
not contain \fB$\fP.
Any redirections (see
.SM
.B REDIRECTION
@@ -1437,6 +1440,12 @@ executed, if one is present. Otherwise, it is set
to the filename used to invoke
.BR bash ,
as given by argument zero.
.PD
.SS Shell Variables
.PP
The following variables are set by the shell:
.PP
.PD 0
.TP
.B _
At shell startup, set to the absolute pathname used to invoke the
@@ -1448,12 +1457,6 @@ Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file
currently being checked.
.PD
.SS Shell Variables
.PP
The following variables are set by the shell:
.PP
.PD 0
.TP
.B BASH
Expands to the full filename used to invoke this instance of
@@ -5842,6 +5845,7 @@ the maximum number of history entries will be set to 500.
When set to \fBOn\fP, makes readline use a single line for display,
scrolling the input horizontally on a single screen line when it
becomes longer than the screen width rather than wrapping to a new line.
This setting is automatically enabled for terminals of height 1.
.TP
.B input\-meta (Off)
If set to \fBOn\fP, readline will enable eight-bit input (that is,
@@ -9931,7 +9935,7 @@ If set,
when in \fIposix mode\fP, 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.
quoted. This is the behavior of <posix mode through version 4.1.
The default bash behavior remains as in previous versions.
.TP 8
.B compat42
doc/bash.html
+26 -22
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2019 November 22<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2019 November 26<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -54,7 +54,7 @@ bash - GNU Bourne-Again SHell
<H3>COPYRIGHT</H3>
Bash is Copyright &#169; 1989-2018 by the Free Software Foundation, Inc.
Bash is Copyright &#169; 1989-2019 by the Free Software Foundation, Inc.
<A NAME="lbAE">&nbsp;</A>
<H3>DESCRIPTION</H3>
@@ -1273,11 +1273,11 @@ A shell function is an object that is called like a simple command and
executes a compound command with a new set of positional parameters.
Shell functions are declared as follows:
<DL COMPACT>
<DT><I>name</I> () <I>compound-command</I> [<I>redirection</I>]<DD>
<DT><I>fname</I> () <I>compound-command</I> [<I>redirection</I>]<DD>
<DT><B>function</B> <I>name</I> [()] <I>compound-command</I> [<I>redirection</I>]<DD>
<DT><B>function</B> <I>fname</I> [()] <I>compound-command</I> [<I>redirection</I>]<DD>
This defines a function named <I>name</I>.
This defines a function named <I>fname</I>.
The reserved word <B>function</B> is optional.
If the <B>function</B> reserved word is supplied, the parentheses are optional.
The <I>body</I> of the function is the compound command
@@ -1288,10 +1288,13 @@ That command is usually a <I>list</I> of commands between { and }, but
may be any command listed under <B>Compound Commands</B> above,
with one exception: If the <B>function</B> reserved word is used, but the
parentheses are not supplied, the braces are required.
<I>compound-command</I> is executed whenever <I>name</I> is specified as the
<I>compound-command</I> is executed whenever <I>fname</I> is specified as the
name of a simple command.
When in <I>posix mode</I>, <I>name</I> may not be the name of one of the
When in <I>posix mode</I>, <I>fname</I> must be a valid shell <I>name</I>
and may not be the name of one of the
POSIX <I>special builtins</I>.
In default mode, a function name can be any unquoted shell word that does
not contain <B>$</B>.
Any redirections (see
<FONT SIZE=-1><B>REDIRECTION</B>
@@ -1848,18 +1851,6 @@ to the filename used to invoke
<B>bash</B>,
as given by argument zero.
<DT><B>_</B>
<DD>
At shell startup, set to the absolute pathname used to invoke the
shell or shell script being executed as passed in the environment
or argument list.
Subsequently, expands to the last argument to the previous simple
command executed in the foreground, after expansion.
Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file
currently being checked.
</DL>
<A NAME="lbAW">&nbsp;</A>
@@ -1872,6 +1863,18 @@ The following variables are set by the shell:
<DL COMPACT>
<DT><B>_</B>
<DD>
At shell startup, set to the absolute pathname used to invoke the
shell or shell script being executed as passed in the environment
or argument list.
Subsequently, expands to the last argument to the previous simple
command executed in the foreground, after expansion.
Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file
currently being checked.
<DT><B>BASH</B>
<DD>
@@ -7482,6 +7485,7 @@ the maximum number of history entries will be set to 500.
When set to <B>On</B>, makes readline use a single line for display,
scrolling the input horizontally on a single screen line when it
becomes longer than the screen width rather than wrapping to a new line.
This setting is automatically enabled for terminals of height 1.
<DT><B>input-meta (Off)</B>
<DD>
@@ -12583,7 +12587,7 @@ If set,
when in <I>posix mode</I>, 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.
quoted. This is the behavior of &lt;posix mode through version 4.1.
The default bash behavior remains as in previous versions.
<DT><B>compat42</B>
@@ -14040,7 +14044,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 5.0<TH ALIGN=CENTER width=33%>2019 November 22<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 5.0<TH ALIGN=CENTER width=33%>2019 November 26<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -14146,6 +14150,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 22 November 2019 15:53:56 EST
Time: 26 November 2019 11:18:28 EST
</BODY>
</HTML>
doc/bash.info
+247 -244
View File
@@ -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.0, 22 November 2019).
Bash shell (version 5.0, 26 November 2019).
This is Edition 5.0, last updated 22 November 2019, of 'The GNU Bash
This is Edition 5.0, last updated 26 November 2019, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.0.
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.0, 22 November 2019). The Bash home page is
Bash shell (version 5.0, 26 November 2019). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.0, last updated 22 November 2019, of 'The GNU Bash
This is Edition 5.0, last updated 26 November 2019, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.0.
Bash contains features that appear in other popular shells, and some
@@ -1176,27 +1176,28 @@ executed. Shell functions are executed in the current shell context; no
new process is created to interpret them.
Functions are declared using this syntax:
NAME () COMPOUND-COMMAND [ REDIRECTIONS ]
FNAME () COMPOUND-COMMAND [ REDIRECTIONS ]
or
function NAME [()] COMPOUND-COMMAND [ REDIRECTIONS ]
function FNAME [()] COMPOUND-COMMAND [ REDIRECTIONS ]
This defines a shell function named NAME. The reserved word
This defines a shell function named FNAME. The reserved word
'function' is optional. If the 'function' reserved word is supplied,
the parentheses are optional. The BODY of the function is the compound
command COMPOUND-COMMAND (*note Compound Commands::). That command is
usually a LIST enclosed between { and }, but may be any compound command
listed above, with one exception: If the 'function' reserved word is
used, but the parentheses are not supplied, the braces are required.
COMPOUND-COMMAND is executed whenever NAME is specified as the name of a
command. When the shell is in POSIX mode (*note Bash POSIX Mode::),
NAME may not be the same as one of the special builtins (*note Special
Builtins::). Any redirections (*note Redirections::) associated with
the shell function are performed when the function is executed.
A function definition may be deleted using the '-f' option to the
'unset' builtin (*note Bourne Shell Builtins::).
COMPOUND-COMMAND is executed whenever FNAME is specified as the name of
a command. When the shell is in POSIX mode (*note Bash POSIX Mode::),
FNAME must be a valid shell NAME and may not be the same as one of the
special builtins (*note Special Builtins::). In default mode, a
function name can be any unquoted shell word that does not contain '$'.
Any redirections (*note Redirections::) associated with the shell
function are performed when the function is executed. A function
definition may be deleted using the '-f' option to the 'unset' builtin
(*note Bourne Shell Builtins::).
The exit status of a function definition is zero unless a syntax
error occurs or a readonly function with the same name already exists.
@@ -1479,16 +1480,6 @@ only be referenced; assignment to them is not allowed.
be executed, if one is present. Otherwise, it is set to the
filename used to invoke Bash, as given by argument zero.
'_'
($_, an underscore.) At shell startup, set to the absolute
pathname used to invoke the shell or shell script being executed as
passed in the environment or argument list. Subsequently, expands
to the last argument to the previous simple command executed in the
foreground, after expansion. Also set to the full pathname used to
invoke each command executed and placed in the environment exported
to that command. When checking mail, this parameter holds the name
of the mail file.

File: bash.info, Node: Shell Expansions, Next: Redirections, Prev: Shell Parameters, Up: Basic Shell Features
@@ -4859,6 +4850,16 @@ normally treat them specially.
variables for controlling the job control facilities (*note Job Control
Variables::).
'_'
($_, an underscore.) At shell startup, set to the absolute
pathname used to invoke the shell or shell script being executed as
passed in the environment or argument list. Subsequently, expands
to the last argument to the previous simple command executed in the
foreground, after expansion. Also set to the full pathname used to
invoke each command executed and placed in the environment exported
to that command. When checking mail, this parameter holds the name
of the mail file.
'BASH'
The full pathname used to execute the current instance of Bash.
@@ -7607,7 +7608,9 @@ Variable Settings
to 'on' means that the text of the lines being edited will
scroll horizontally on a single screen line when they are
longer than the width of the screen, instead of wrapping onto
a new screen line. By default, this variable is set to 'off'.
a new screen line. This variable is automatically set to 'on'
for terminals of height 1. By default, this variable is set
to 'off'.
'input-meta'
If set to 'on', Readline will enable eight-bit input (it will
@@ -11197,35 +11200,35 @@ D.3 Parameter and Variable Index
* $0: Special Parameters. (line 62)
* $?: Special Parameters. (line 43)
* $@: Special Parameters. (line 23)
* $_: Special Parameters. (line 71)
* $_: Bash Variables. (line 14)
* *: Special Parameters. (line 9)
* -: Special Parameters. (line 46)
* 0: Special Parameters. (line 61)
* ?: Special Parameters. (line 42)
* @: Special Parameters. (line 22)
* _: Special Parameters. (line 70)
* _: Bash Variables. (line 13)
* auto_resume: Job Control Variables.
(line 6)
* BASH: Bash Variables. (line 13)
* BASHOPTS: Bash Variables. (line 16)
* BASHPID: Bash Variables. (line 25)
* BASH_ALIASES: Bash Variables. (line 32)
* BASH_ARGC: Bash Variables. (line 41)
* BASH_ARGV: Bash Variables. (line 54)
* BASH_ARGV0: Bash Variables. (line 66)
* BASH_CMDS: Bash Variables. (line 74)
* BASH_COMMAND: Bash Variables. (line 83)
* BASH_COMPAT: Bash Variables. (line 90)
* BASH_ENV: Bash Variables. (line 105)
* BASH_EXECUTION_STRING: Bash Variables. (line 111)
* BASH_LINENO: Bash Variables. (line 114)
* BASH_LOADABLES_PATH: Bash Variables. (line 122)
* BASH_REMATCH: Bash Variables. (line 126)
* BASH_SOURCE: Bash Variables. (line 134)
* BASH_SUBSHELL: Bash Variables. (line 141)
* BASH_VERSINFO: Bash Variables. (line 147)
* BASH_VERSION: Bash Variables. (line 170)
* BASH_XTRACEFD: Bash Variables. (line 173)
* BASH: Bash Variables. (line 23)
* BASHOPTS: Bash Variables. (line 26)
* BASHPID: Bash Variables. (line 35)
* BASH_ALIASES: Bash Variables. (line 42)
* BASH_ARGC: Bash Variables. (line 51)
* BASH_ARGV: Bash Variables. (line 64)
* BASH_ARGV0: Bash Variables. (line 76)
* BASH_CMDS: Bash Variables. (line 84)
* BASH_COMMAND: Bash Variables. (line 93)
* BASH_COMPAT: Bash Variables. (line 100)
* BASH_ENV: Bash Variables. (line 115)
* BASH_EXECUTION_STRING: Bash Variables. (line 121)
* BASH_LINENO: Bash Variables. (line 124)
* BASH_LOADABLES_PATH: Bash Variables. (line 132)
* BASH_REMATCH: Bash Variables. (line 136)
* BASH_SOURCE: Bash Variables. (line 144)
* BASH_SUBSHELL: Bash Variables. (line 151)
* BASH_VERSINFO: Bash Variables. (line 157)
* BASH_VERSION: Bash Variables. (line 180)
* BASH_XTRACEFD: Bash Variables. (line 183)
* bell-style: Readline Init File Syntax.
(line 38)
* bind-tty-special-chars: Readline Init File Syntax.
@@ -11234,12 +11237,12 @@ D.3 Parameter and Variable Index
(line 50)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 184)
* CHILD_MAX: Bash Variables. (line 194)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
* colored-stats: Readline Init File Syntax.
(line 62)
* COLUMNS: Bash Variables. (line 191)
* COLUMNS: Bash Variables. (line 201)
* comment-begin: Readline Init File Syntax.
(line 68)
* completion-display-width: Readline Init File Syntax.
@@ -11252,158 +11255,158 @@ D.3 Parameter and Variable Index
(line 91)
* completion-query-items: Readline Init File Syntax.
(line 98)
* COMPREPLY: Bash Variables. (line 243)
* COMP_CWORD: Bash Variables. (line 197)
* COMP_KEY: Bash Variables. (line 226)
* COMP_LINE: Bash Variables. (line 203)
* COMP_POINT: Bash Variables. (line 208)
* COMP_TYPE: Bash Variables. (line 216)
* COMP_WORDBREAKS: Bash Variables. (line 230)
* COMP_WORDS: Bash Variables. (line 236)
* COMPREPLY: Bash Variables. (line 253)
* COMP_CWORD: Bash Variables. (line 207)
* COMP_KEY: Bash Variables. (line 236)
* COMP_LINE: Bash Variables. (line 213)
* COMP_POINT: Bash Variables. (line 218)
* COMP_TYPE: Bash Variables. (line 226)
* COMP_WORDBREAKS: Bash Variables. (line 240)
* COMP_WORDS: Bash Variables. (line 246)
* convert-meta: Readline Init File Syntax.
(line 108)
* COPROC: Bash Variables. (line 249)
* DIRSTACK: Bash Variables. (line 253)
* COPROC: Bash Variables. (line 259)
* DIRSTACK: Bash Variables. (line 263)
* disable-completion: Readline Init File Syntax.
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 121)
* editing-mode: Readline Init File Syntax.
(line 126)
* EMACS: Bash Variables. (line 263)
* EMACS: Bash Variables. (line 273)
* emacs-mode-string: Readline Init File Syntax.
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 150)
* ENV: Bash Variables. (line 268)
* EPOCHREALTIME: Bash Variables. (line 272)
* EPOCHSECONDS: Bash Variables. (line 280)
* EUID: Bash Variables. (line 287)
* EXECIGNORE: Bash Variables. (line 291)
* ENV: Bash Variables. (line 278)
* EPOCHREALTIME: Bash Variables. (line 282)
* EPOCHSECONDS: Bash Variables. (line 290)
* EUID: Bash Variables. (line 297)
* EXECIGNORE: Bash Variables. (line 301)
* expand-tilde: Readline Init File Syntax.
(line 161)
* FCEDIT: Bash Variables. (line 304)
* FIGNORE: Bash Variables. (line 308)
* FUNCNAME: Bash Variables. (line 314)
* FUNCNEST: Bash Variables. (line 331)
* GLOBIGNORE: Bash Variables. (line 336)
* GROUPS: Bash Variables. (line 343)
* histchars: Bash Variables. (line 349)
* HISTCMD: Bash Variables. (line 364)
* HISTCONTROL: Bash Variables. (line 369)
* HISTFILE: Bash Variables. (line 385)
* HISTFILESIZE: Bash Variables. (line 389)
* HISTIGNORE: Bash Variables. (line 400)
* FCEDIT: Bash Variables. (line 314)
* FIGNORE: Bash Variables. (line 318)
* FUNCNAME: Bash Variables. (line 324)
* FUNCNEST: Bash Variables. (line 341)
* GLOBIGNORE: Bash Variables. (line 346)
* GROUPS: Bash Variables. (line 353)
* histchars: Bash Variables. (line 359)
* HISTCMD: Bash Variables. (line 374)
* HISTCONTROL: Bash Variables. (line 379)
* HISTFILE: Bash Variables. (line 395)
* HISTFILESIZE: Bash Variables. (line 399)
* HISTIGNORE: Bash Variables. (line 410)
* history-preserve-point: Readline Init File Syntax.
(line 165)
* history-size: Readline Init File Syntax.
(line 171)
* HISTSIZE: Bash Variables. (line 420)
* HISTTIMEFORMAT: Bash Variables. (line 427)
* HISTSIZE: Bash Variables. (line 430)
* HISTTIMEFORMAT: Bash Variables. (line 437)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 180)
* HOSTFILE: Bash Variables. (line 435)
* HOSTNAME: Bash Variables. (line 446)
* HOSTTYPE: Bash Variables. (line 449)
* HOSTFILE: Bash Variables. (line 445)
* HOSTNAME: Bash Variables. (line 456)
* HOSTTYPE: Bash Variables. (line 459)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 452)
* IGNOREEOF: Bash Variables. (line 462)
* input-meta: Readline Init File Syntax.
(line 187)
* INPUTRC: Bash Variables. (line 462)
* INSIDE_EMACS: Bash Variables. (line 466)
(line 189)
* INPUTRC: Bash Variables. (line 472)
* INSIDE_EMACS: Bash Variables. (line 476)
* isearch-terminators: Readline Init File Syntax.
(line 195)
(line 197)
* keymap: Readline Init File Syntax.
(line 202)
* LANG: Bash Variables. (line 472)
* LC_ALL: Bash Variables. (line 476)
* LC_COLLATE: Bash Variables. (line 480)
* LC_CTYPE: Bash Variables. (line 487)
(line 204)
* LANG: Bash Variables. (line 482)
* LC_ALL: Bash Variables. (line 486)
* LC_COLLATE: Bash Variables. (line 490)
* LC_CTYPE: Bash Variables. (line 497)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 492)
* LC_NUMERIC: Bash Variables. (line 496)
* LC_TIME: Bash Variables. (line 500)
* LINENO: Bash Variables. (line 504)
* LINES: Bash Variables. (line 509)
* MACHTYPE: Bash Variables. (line 515)
* LC_MESSAGES <1>: Bash Variables. (line 502)
* LC_NUMERIC: Bash Variables. (line 506)
* LC_TIME: Bash Variables. (line 510)
* LINENO: Bash Variables. (line 514)
* LINES: Bash Variables. (line 519)
* MACHTYPE: Bash Variables. (line 525)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 519)
* MAILCHECK: Bash Variables. (line 529)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 527)
* MAPFILE: Bash Variables. (line 537)
* mark-modified-lines: Readline Init File Syntax.
(line 232)
(line 234)
* mark-symlinked-directories: Readline Init File Syntax.
(line 237)
(line 239)
* match-hidden-files: Readline Init File Syntax.
(line 242)
(line 244)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 249)
(line 251)
* meta-flag: Readline Init File Syntax.
(line 187)
* OLDPWD: Bash Variables. (line 531)
(line 189)
* OLDPWD: Bash Variables. (line 541)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 534)
* OPTERR: Bash Variables. (line 544)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 538)
* OSTYPE: Bash Variables. (line 548)
* output-meta: Readline Init File Syntax.
(line 254)
(line 256)
* page-completions: Readline Init File Syntax.
(line 260)
(line 262)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 541)
* POSIXLY_CORRECT: Bash Variables. (line 546)
* PPID: Bash Variables. (line 556)
* PROMPT_COMMAND: Bash Variables. (line 560)
* PROMPT_DIRTRIM: Bash Variables. (line 564)
* PS0: Bash Variables. (line 570)
* PIPESTATUS: Bash Variables. (line 551)
* POSIXLY_CORRECT: Bash Variables. (line 556)
* PPID: Bash Variables. (line 566)
* PROMPT_COMMAND: Bash Variables. (line 570)
* PROMPT_DIRTRIM: Bash Variables. (line 574)
* PS0: Bash Variables. (line 580)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 575)
* PS4: Bash Variables. (line 580)
* PWD: Bash Variables. (line 588)
* RANDOM: Bash Variables. (line 591)
* READLINE_LINE: Bash Variables. (line 597)
* READLINE_POINT: Bash Variables. (line 601)
* REPLY: Bash Variables. (line 605)
* PS3: Bash Variables. (line 585)
* PS4: Bash Variables. (line 590)
* PWD: Bash Variables. (line 598)
* RANDOM: Bash Variables. (line 601)
* READLINE_LINE: Bash Variables. (line 607)
* READLINE_POINT: Bash Variables. (line 611)
* REPLY: Bash Variables. (line 615)
* revert-all-at-newline: Readline Init File Syntax.
(line 270)
* SECONDS: Bash Variables. (line 608)
* SHELL: Bash Variables. (line 615)
* SHELLOPTS: Bash Variables. (line 620)
* SHLVL: Bash Variables. (line 629)
(line 272)
* SECONDS: Bash Variables. (line 618)
* SHELL: Bash Variables. (line 625)
* SHELLOPTS: Bash Variables. (line 630)
* SHLVL: Bash Variables. (line 639)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
(line 278)
* show-all-if-unmodified: Readline Init File Syntax.
(line 282)
(line 284)
* show-mode-in-prompt: Readline Init File Syntax.
(line 291)
(line 293)
* skip-completed-text: Readline Init File Syntax.
(line 297)
* SRANDOM: Bash Variables. (line 634)
(line 299)
* SRANDOM: Bash Variables. (line 644)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 643)
* TMOUT: Bash Variables. (line 681)
* TMPDIR: Bash Variables. (line 693)
* UID: Bash Variables. (line 697)
* TIMEFORMAT: Bash Variables. (line 653)
* TMOUT: Bash Variables. (line 691)
* TMPDIR: Bash Variables. (line 703)
* UID: Bash Variables. (line 707)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 310)
(line 312)
* vi-ins-mode-string: Readline Init File Syntax.
(line 321)
(line 323)
* visible-stats: Readline Init File Syntax.
(line 332)
(line 334)

File: bash.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -11794,109 +11797,109 @@ Node: Command Grouping40662
Node: Coprocesses42141
Node: GNU Parallel44044
Node: Shell Functions48345
Node: Shell Parameters55428
Node: Positional Parameters59841
Node: Special Parameters60741
Node: Shell Expansions64495
Node: Brace Expansion66618
Node: Tilde Expansion69341
Node: Shell Parameter Expansion71958
Node: Command Substitution86391
Node: Arithmetic Expansion87746
Node: Process Substitution88678
Node: Word Splitting89798
Node: Filename Expansion91742
Node: Pattern Matching94291
Node: Quote Removal98277
Node: Redirections98572
Node: Executing Commands108130
Node: Simple Command Expansion108800
Node: Command Search and Execution110754
Node: Command Execution Environment113130
Node: Environment116114
Node: Exit Status117773
Node: Signals119443
Node: Shell Scripts121410
Node: Shell Builtin Commands124422
Node: Bourne Shell Builtins126460
Node: Bash Builtins147376
Node: Modifying Shell Behavior176301
Node: The Set Builtin176646
Node: The Shopt Builtin187059
Node: Special Builtins204729
Node: Shell Variables205708
Node: Bourne Shell Variables206145
Node: Bash Variables208249
Node: Bash Features239661
Node: Invoking Bash240560
Node: Bash Startup Files246573
Node: Interactive Shells251676
Node: What is an Interactive Shell?252086
Node: Is this Shell Interactive?252735
Node: Interactive Shell Behavior253550
Node: Bash Conditional Expressions257037
Node: Shell Arithmetic261614
Node: Aliases264554
Node: Arrays267174
Node: The Directory Stack272539
Node: Directory Stack Builtins273323
Node: Controlling the Prompt276291
Node: The Restricted Shell279212
Node: Bash POSIX Mode281694
Node: Job Control292627
Node: Job Control Basics293087
Node: Job Control Builtins298051
Node: Job Control Variables303197
Node: Command Line Editing304353
Node: Introduction and Notation306024
Node: Readline Interaction307647
Node: Readline Bare Essentials308838
Node: Readline Movement Commands310621
Node: Readline Killing Commands311581
Node: Readline Arguments313499
Node: Searching314543
Node: Readline Init File316729
Node: Readline Init File Syntax317988
Node: Conditional Init Constructs338427
Node: Sample Init File342623
Node: Bindable Readline Commands345740
Node: Commands For Moving346944
Node: Commands For History348803
Node: Commands For Text353098
Node: Commands For Killing356486
Node: Numeric Arguments359301
Node: Commands For Completion360440
Node: Keyboard Macros364631
Node: Miscellaneous Commands365318
Node: Readline vi Mode371271
Node: Programmable Completion372178
Node: Programmable Completion Builtins379958
Node: A Programmable Completion Example390653
Node: Using History Interactively395900
Node: Bash History Facilities396584
Node: Bash History Builtins399589
Node: History Interaction404120
Node: Event Designators407740
Node: Word Designators409094
Node: Modifiers410854
Node: Installing Bash412665
Node: Basic Installation413802
Node: Compilers and Options417060
Node: Compiling For Multiple Architectures417801
Node: Installation Names419494
Node: Specifying the System Type420312
Node: Sharing Defaults421028
Node: Operation Controls421701
Node: Optional Features422659
Node: Reporting Bugs433177
Node: Major Differences From The Bourne Shell434371
Node: GNU Free Documentation License451223
Node: Indexes476400
Node: Builtin Index476854
Node: Reserved Word Index483681
Node: Variable Index486129
Node: Function Index501953
Node: Concept Index515392
Node: Shell Parameters55552
Node: Positional Parameters59965
Node: Special Parameters60865
Node: Shell Expansions64089
Node: Brace Expansion66212
Node: Tilde Expansion68935
Node: Shell Parameter Expansion71552
Node: Command Substitution85985
Node: Arithmetic Expansion87340
Node: Process Substitution88272
Node: Word Splitting89392
Node: Filename Expansion91336
Node: Pattern Matching93885
Node: Quote Removal97871
Node: Redirections98166
Node: Executing Commands107724
Node: Simple Command Expansion108394
Node: Command Search and Execution110348
Node: Command Execution Environment112724
Node: Environment115708
Node: Exit Status117367
Node: Signals119037
Node: Shell Scripts121004
Node: Shell Builtin Commands124016
Node: Bourne Shell Builtins126054
Node: Bash Builtins146970
Node: Modifying Shell Behavior175895
Node: The Set Builtin176240
Node: The Shopt Builtin186653
Node: Special Builtins204323
Node: Shell Variables205302
Node: Bourne Shell Variables205739
Node: Bash Variables207843
Node: Bash Features239785
Node: Invoking Bash240684
Node: Bash Startup Files246697
Node: Interactive Shells251800
Node: What is an Interactive Shell?252210
Node: Is this Shell Interactive?252859
Node: Interactive Shell Behavior253674
Node: Bash Conditional Expressions257161
Node: Shell Arithmetic261738
Node: Aliases264678
Node: Arrays267298
Node: The Directory Stack272663
Node: Directory Stack Builtins273447
Node: Controlling the Prompt276415
Node: The Restricted Shell279336
Node: Bash POSIX Mode281818
Node: Job Control292751
Node: Job Control Basics293211
Node: Job Control Builtins298175
Node: Job Control Variables303321
Node: Command Line Editing304477
Node: Introduction and Notation306148
Node: Readline Interaction307771
Node: Readline Bare Essentials308962
Node: Readline Movement Commands310745
Node: Readline Killing Commands311705
Node: Readline Arguments313623
Node: Searching314667
Node: Readline Init File316853
Node: Readline Init File Syntax318112
Node: Conditional Init Constructs338642
Node: Sample Init File342838
Node: Bindable Readline Commands345955
Node: Commands For Moving347159
Node: Commands For History349018
Node: Commands For Text353313
Node: Commands For Killing356701
Node: Numeric Arguments359516
Node: Commands For Completion360655
Node: Keyboard Macros364846
Node: Miscellaneous Commands365533
Node: Readline vi Mode371486
Node: Programmable Completion372393
Node: Programmable Completion Builtins380173
Node: A Programmable Completion Example390868
Node: Using History Interactively396115
Node: Bash History Facilities396799
Node: Bash History Builtins399804
Node: History Interaction404335
Node: Event Designators407955
Node: Word Designators409309
Node: Modifiers411069
Node: Installing Bash412880
Node: Basic Installation414017
Node: Compilers and Options417275
Node: Compiling For Multiple Architectures418016
Node: Installation Names419709
Node: Specifying the System Type420527
Node: Sharing Defaults421243
Node: Operation Controls421916
Node: Optional Features422874
Node: Reporting Bugs433392
Node: Major Differences From The Bourne Shell434586
Node: GNU Free Documentation License451438
Node: Indexes476615
Node: Builtin Index477069
Node: Reserved Word Index483896
Node: Variable Index486344
Node: Function Index502168
Node: Concept Index515607

End Tag Table
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+1542 -1535
View File
File diff suppressed because it is too large Load Diff
doc/bashref.aux
+5 -5
View File
@@ -87,13 +87,13 @@
@xrdef{Shell Expansions-pg}{22}
@xrdef{Brace Expansion-title}{Brace Expansion}
@xrdef{Brace Expansion-snt}{Section@tie 3.5.1}
@xrdef{Brace Expansion-pg}{23}
@xrdef{Tilde Expansion-title}{Tilde Expansion}
@xrdef{Tilde Expansion-snt}{Section@tie 3.5.2}
@xrdef{Tilde Expansion-pg}{24}
@xrdef{Brace Expansion-pg}{23}
@xrdef{Shell Parameter Expansion-title}{Shell Parameter Expansion}
@xrdef{Shell Parameter Expansion-snt}{Section@tie 3.5.3}
@xrdef{Shell Parameter Expansion-pg}{25}
@xrdef{Tilde Expansion-pg}{24}
@xrdef{Shell Parameter Expansion-pg}{24}
@xrdef{Command Substitution-title}{Command Substitution}
@xrdef{Command Substitution-snt}{Section@tie 3.5.4}
@xrdef{Arithmetic Expansion-title}{Arithmetic Expansion}
@@ -122,10 +122,10 @@
@xrdef{Executing Commands-snt}{Section@tie 3.7}
@xrdef{Simple Command Expansion-title}{Simple Command Expansion}
@xrdef{Simple Command Expansion-snt}{Section@tie 3.7.1}
@xrdef{Executing Commands-pg}{38}
@xrdef{Simple Command Expansion-pg}{38}
@xrdef{Command Search and Execution-title}{Command Search and Execution}
@xrdef{Command Search and Execution-snt}{Section@tie 3.7.2}
@xrdef{Executing Commands-pg}{38}
@xrdef{Simple Command Expansion-pg}{38}
@xrdef{Command Execution Environment-title}{Command Execution Environment}
@xrdef{Command Execution Environment-snt}{Section@tie 3.7.3}
@xrdef{Command Search and Execution-pg}{39}
doc/bashref.cp
+2 -2
View File
@@ -49,8 +49,8 @@
\entry{expansion, brace}{23}{expansion, brace}
\entry{tilde expansion}{24}{tilde expansion}
\entry{expansion, tilde}{24}{expansion, tilde}
\entry{parameter expansion}{25}{parameter expansion}
\entry{expansion, parameter}{25}{expansion, parameter}
\entry{parameter expansion}{24}{parameter expansion}
\entry{expansion, parameter}{24}{expansion, parameter}
\entry{command substitution}{31}{command substitution}
\entry{expansion, arithmetic}{31}{expansion, arithmetic}
\entry{arithmetic expansion}{31}{arithmetic expansion}
doc/bashref.cps
+2 -2
View File
@@ -45,7 +45,7 @@
\entry{expansion, arithmetic}{31}
\entry{expansion, brace}{23}
\entry{expansion, filename}{32}
\entry{expansion, parameter}{25}
\entry{expansion, parameter}{24}
\entry{expansion, pathname}{32}
\entry{expansion, tilde}{24}
\entry{expressions, arithmetic}{93}
@@ -88,7 +88,7 @@
\initial {O}
\entry{operator, shell}{3}
\initial {P}
\entry{parameter expansion}{25}
\entry{parameter expansion}{24}
\entry{parameters}{20}
\entry{parameters, positional}{21}
\entry{parameters, special}{21}
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+33 -30
View File
@@ -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.0, 22 November 2019).
the Bash shell (version 5.0, 26 November 2019).
This is Edition 5.0, last updated 22 November 2019,
This is Edition 5.0, last updated 26 November 2019,
of The GNU Bash Reference Manual,
for Bash, Version 5.0.
@@ -273,10 +273,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.0, 22 November 2019).
the Bash shell (version 5.0, 26 November 2019).
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.0, last updated 22 November 2019,
<p>This is Edition 5.0, last updated 26 November 2019,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 5.0.
</p>
@@ -1755,16 +1755,16 @@ shell context; no new process is created to interpret them.
<p>Functions are declared using this syntax:
<span id="index-function"></span>
</p><div class="example">
<pre class="example"><var>name</var> () <var>compound-command</var> [ <var>redirections</var> ]
<pre class="example"><var>fname</var> () <var>compound-command</var> [ <var>redirections</var> ]
</pre></div>
<p>or
</p>
<div class="example">
<pre class="example">function <var>name</var> [()] <var>compound-command</var> [ <var>redirections</var> ]
<pre class="example">function <var>fname</var> [()] <var>compound-command</var> [ <var>redirections</var> ]
</pre></div>
<p>This defines a shell function named <var>name</var>. The reserved
<p>This defines a shell function named <var>fname</var>. The reserved
word <code>function</code> is optional.
If the <code>function</code> reserved
word is supplied, the parentheses are optional.
@@ -1774,15 +1774,17 @@ That command is usually a <var>list</var> enclosed between { and }, but
may be any compound command listed above,
with one exception: If the <code>function</code> reserved word is used, but the
parentheses are not supplied, the braces are required.
<var>compound-command</var> is executed whenever <var>name</var> is specified as the
<var>compound-command</var> is executed whenever <var>fname</var> is specified as the
name of a command.
When the shell is in <small>POSIX</small> mode (see <a href="#Bash-POSIX-Mode">Bash POSIX Mode</a>),
<var>name</var> may not be the same as one of the special builtins
<var>fname</var> must be a valid shell <var>name</var> and
may not be the same as one of the special builtins
(see <a href="#Special-Builtins">Special Builtins</a>).
In default mode, a function name can be any unquoted shell word that does
not contain &lsquo;<samp>$</samp>&rsquo;.
Any redirections (see <a href="#Redirections">Redirections</a>) associated with the shell function
are performed when the function is executed.
</p>
<p>A function definition may be deleted using the <samp>-f</samp> option to the
A function definition may be deleted using the <samp>-f</samp> option to the
<code>unset</code> builtin (see <a href="#Bourne-Shell-Builtins">Bourne Shell Builtins</a>).
</p>
<p>The exit status of a function definition is zero unless a syntax error
@@ -2160,21 +2162,6 @@ If Bash is started with the <samp>-c</samp> option (see <a href="#Invoking-Bash"
then <code>$0</code> is set to the first argument after the string to be
executed, if one is present. Otherwise, it is set
to the filename used to invoke Bash, as given by argument zero.
</p>
</dd>
<dt><code>_</code>
<span id="index-_005f"></span>
</dt>
<dd><span id="index-_0024_005f"></span>
<p>($_, an underscore.)
At shell startup, set to the absolute pathname used to invoke the
shell or shell script being executed as passed in the environment
or argument list.
Subsequently, expands to the last argument to the previous simple
command executed in the foreground, after expansion.
Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file.
</p></dd>
</dl>
@@ -6453,6 +6440,21 @@ variables for controlling the job control facilities
(see <a href="#Job-Control-Variables">Job Control Variables</a>).
</p>
<dl compact="compact">
<dt><code>_</code>
<span id="index-_005f"></span>
</dt>
<dd><span id="index-_0024_005f"></span>
<p>($_, an underscore.)
At shell startup, set to the absolute pathname used to invoke the
shell or shell script being executed as passed in the environment
or argument list.
Subsequently, expands to the last argument to the previous simple
command executed in the foreground, after expansion.
Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file.
</p>
</dd>
<dt><code>BASH</code>
<span id="index-BASH"></span>
</dt>
@@ -10096,8 +10098,9 @@ the maximum number of history entries will be set to 500.
<p>This variable can be set to either &lsquo;<samp>on</samp>&rsquo; or &lsquo;<samp>off</samp>&rsquo;. Setting it
to &lsquo;<samp>on</samp>&rsquo; means that the text of the lines being edited will scroll
horizontally on a single screen line when they are longer than the width
of the screen, instead of wrapping onto a new screen line. By default,
this variable is set to &lsquo;<samp>off</samp>&rsquo;.
of the screen, instead of wrapping onto a new screen line.
This variable is automatically set to &lsquo;<samp>on</samp>&rsquo; for terminals of height 1.
By default, this variable is set to &lsquo;<samp>off</samp>&rsquo;.
</p>
</dd>
<dt><code>input-meta</code></dt>
@@ -14817,7 +14820,7 @@ Next: <a href="#Function-Index" accesskey="n" rel="next">Function Index</a>, Pre
<tr><td></td><td valign="top"><a href="#index-_00240"><code>$0</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0024_003f"><code>$?</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0024_0040"><code>$@</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0024_005f"><code>$_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0024_005f"><code>$_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Variable-Index_vr_symbol-4">*</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002a"><code>*</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
@@ -14835,7 +14838,7 @@ Next: <a href="#Function-Index" accesskey="n" rel="next">Function Index</a>, Pre
<tr><td></td><td valign="top"><a href="#index-_0040"><code>@</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Variable-Index_vr_symbol-9">_</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005f"><code>_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-Parameters">Special Parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005f"><code>_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Variable-Index_vr_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-auto_005fresume"><code>auto_resume</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Job-Control-Variables">Job Control Variables</a></td></tr>
doc/bashref.info
+247 -244
View File
@@ -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.0, 22 November 2019).
Bash shell (version 5.0, 26 November 2019).
This is Edition 5.0, last updated 22 November 2019, of 'The GNU Bash
This is Edition 5.0, last updated 26 November 2019, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.0.
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.0, 22 November 2019). The Bash home page is
Bash shell (version 5.0, 26 November 2019). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.0, last updated 22 November 2019, of 'The GNU Bash
This is Edition 5.0, last updated 26 November 2019, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.0.
Bash contains features that appear in other popular shells, and some
@@ -1176,27 +1176,28 @@ executed. Shell functions are executed in the current shell context; no
new process is created to interpret them.
Functions are declared using this syntax:
NAME () COMPOUND-COMMAND [ REDIRECTIONS ]
FNAME () COMPOUND-COMMAND [ REDIRECTIONS ]
or
function NAME [()] COMPOUND-COMMAND [ REDIRECTIONS ]
function FNAME [()] COMPOUND-COMMAND [ REDIRECTIONS ]
This defines a shell function named NAME. The reserved word
This defines a shell function named FNAME. The reserved word
'function' is optional. If the 'function' reserved word is supplied,
the parentheses are optional. The BODY of the function is the compound
command COMPOUND-COMMAND (*note Compound Commands::). That command is
usually a LIST enclosed between { and }, but may be any compound command
listed above, with one exception: If the 'function' reserved word is
used, but the parentheses are not supplied, the braces are required.
COMPOUND-COMMAND is executed whenever NAME is specified as the name of a
command. When the shell is in POSIX mode (*note Bash POSIX Mode::),
NAME may not be the same as one of the special builtins (*note Special
Builtins::). Any redirections (*note Redirections::) associated with
the shell function are performed when the function is executed.
A function definition may be deleted using the '-f' option to the
'unset' builtin (*note Bourne Shell Builtins::).
COMPOUND-COMMAND is executed whenever FNAME is specified as the name of
a command. When the shell is in POSIX mode (*note Bash POSIX Mode::),
FNAME must be a valid shell NAME and may not be the same as one of the
special builtins (*note Special Builtins::). In default mode, a
function name can be any unquoted shell word that does not contain '$'.
Any redirections (*note Redirections::) associated with the shell
function are performed when the function is executed. A function
definition may be deleted using the '-f' option to the 'unset' builtin
(*note Bourne Shell Builtins::).
The exit status of a function definition is zero unless a syntax
error occurs or a readonly function with the same name already exists.
@@ -1479,16 +1480,6 @@ only be referenced; assignment to them is not allowed.
be executed, if one is present. Otherwise, it is set to the
filename used to invoke Bash, as given by argument zero.
'_'
($_, an underscore.) At shell startup, set to the absolute
pathname used to invoke the shell or shell script being executed as
passed in the environment or argument list. Subsequently, expands
to the last argument to the previous simple command executed in the
foreground, after expansion. Also set to the full pathname used to
invoke each command executed and placed in the environment exported
to that command. When checking mail, this parameter holds the name
of the mail file.

File: bashref.info, Node: Shell Expansions, Next: Redirections, Prev: Shell Parameters, Up: Basic Shell Features
@@ -4859,6 +4850,16 @@ normally treat them specially.
variables for controlling the job control facilities (*note Job Control
Variables::).
'_'
($_, an underscore.) At shell startup, set to the absolute
pathname used to invoke the shell or shell script being executed as
passed in the environment or argument list. Subsequently, expands
to the last argument to the previous simple command executed in the
foreground, after expansion. Also set to the full pathname used to
invoke each command executed and placed in the environment exported
to that command. When checking mail, this parameter holds the name
of the mail file.
'BASH'
The full pathname used to execute the current instance of Bash.
@@ -7607,7 +7608,9 @@ Variable Settings
to 'on' means that the text of the lines being edited will
scroll horizontally on a single screen line when they are
longer than the width of the screen, instead of wrapping onto
a new screen line. By default, this variable is set to 'off'.
a new screen line. This variable is automatically set to 'on'
for terminals of height 1. By default, this variable is set
to 'off'.
'input-meta'
If set to 'on', Readline will enable eight-bit input (it will
@@ -11197,35 +11200,35 @@ D.3 Parameter and Variable Index
* $0: Special Parameters. (line 62)
* $?: Special Parameters. (line 43)
* $@: Special Parameters. (line 23)
* $_: Special Parameters. (line 71)
* $_: Bash Variables. (line 14)
* *: Special Parameters. (line 9)
* -: Special Parameters. (line 46)
* 0: Special Parameters. (line 61)
* ?: Special Parameters. (line 42)
* @: Special Parameters. (line 22)
* _: Special Parameters. (line 70)
* _: Bash Variables. (line 13)
* auto_resume: Job Control Variables.
(line 6)
* BASH: Bash Variables. (line 13)
* BASHOPTS: Bash Variables. (line 16)
* BASHPID: Bash Variables. (line 25)
* BASH_ALIASES: Bash Variables. (line 32)
* BASH_ARGC: Bash Variables. (line 41)
* BASH_ARGV: Bash Variables. (line 54)
* BASH_ARGV0: Bash Variables. (line 66)
* BASH_CMDS: Bash Variables. (line 74)
* BASH_COMMAND: Bash Variables. (line 83)
* BASH_COMPAT: Bash Variables. (line 90)
* BASH_ENV: Bash Variables. (line 105)
* BASH_EXECUTION_STRING: Bash Variables. (line 111)
* BASH_LINENO: Bash Variables. (line 114)
* BASH_LOADABLES_PATH: Bash Variables. (line 122)
* BASH_REMATCH: Bash Variables. (line 126)
* BASH_SOURCE: Bash Variables. (line 134)
* BASH_SUBSHELL: Bash Variables. (line 141)
* BASH_VERSINFO: Bash Variables. (line 147)
* BASH_VERSION: Bash Variables. (line 170)
* BASH_XTRACEFD: Bash Variables. (line 173)
* BASH: Bash Variables. (line 23)
* BASHOPTS: Bash Variables. (line 26)
* BASHPID: Bash Variables. (line 35)
* BASH_ALIASES: Bash Variables. (line 42)
* BASH_ARGC: Bash Variables. (line 51)
* BASH_ARGV: Bash Variables. (line 64)
* BASH_ARGV0: Bash Variables. (line 76)
* BASH_CMDS: Bash Variables. (line 84)
* BASH_COMMAND: Bash Variables. (line 93)
* BASH_COMPAT: Bash Variables. (line 100)
* BASH_ENV: Bash Variables. (line 115)
* BASH_EXECUTION_STRING: Bash Variables. (line 121)
* BASH_LINENO: Bash Variables. (line 124)
* BASH_LOADABLES_PATH: Bash Variables. (line 132)
* BASH_REMATCH: Bash Variables. (line 136)
* BASH_SOURCE: Bash Variables. (line 144)
* BASH_SUBSHELL: Bash Variables. (line 151)
* BASH_VERSINFO: Bash Variables. (line 157)
* BASH_VERSION: Bash Variables. (line 180)
* BASH_XTRACEFD: Bash Variables. (line 183)
* bell-style: Readline Init File Syntax.
(line 38)
* bind-tty-special-chars: Readline Init File Syntax.
@@ -11234,12 +11237,12 @@ D.3 Parameter and Variable Index
(line 50)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 184)
* CHILD_MAX: Bash Variables. (line 194)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
* colored-stats: Readline Init File Syntax.
(line 62)
* COLUMNS: Bash Variables. (line 191)
* COLUMNS: Bash Variables. (line 201)
* comment-begin: Readline Init File Syntax.
(line 68)
* completion-display-width: Readline Init File Syntax.
@@ -11252,158 +11255,158 @@ D.3 Parameter and Variable Index
(line 91)
* completion-query-items: Readline Init File Syntax.
(line 98)
* COMPREPLY: Bash Variables. (line 243)
* COMP_CWORD: Bash Variables. (line 197)
* COMP_KEY: Bash Variables. (line 226)
* COMP_LINE: Bash Variables. (line 203)
* COMP_POINT: Bash Variables. (line 208)
* COMP_TYPE: Bash Variables. (line 216)
* COMP_WORDBREAKS: Bash Variables. (line 230)
* COMP_WORDS: Bash Variables. (line 236)
* COMPREPLY: Bash Variables. (line 253)
* COMP_CWORD: Bash Variables. (line 207)
* COMP_KEY: Bash Variables. (line 236)
* COMP_LINE: Bash Variables. (line 213)
* COMP_POINT: Bash Variables. (line 218)
* COMP_TYPE: Bash Variables. (line 226)
* COMP_WORDBREAKS: Bash Variables. (line 240)
* COMP_WORDS: Bash Variables. (line 246)
* convert-meta: Readline Init File Syntax.
(line 108)
* COPROC: Bash Variables. (line 249)
* DIRSTACK: Bash Variables. (line 253)
* COPROC: Bash Variables. (line 259)
* DIRSTACK: Bash Variables. (line 263)
* disable-completion: Readline Init File Syntax.
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 121)
* editing-mode: Readline Init File Syntax.
(line 126)
* EMACS: Bash Variables. (line 263)
* EMACS: Bash Variables. (line 273)
* emacs-mode-string: Readline Init File Syntax.
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 150)
* ENV: Bash Variables. (line 268)
* EPOCHREALTIME: Bash Variables. (line 272)
* EPOCHSECONDS: Bash Variables. (line 280)
* EUID: Bash Variables. (line 287)
* EXECIGNORE: Bash Variables. (line 291)
* ENV: Bash Variables. (line 278)
* EPOCHREALTIME: Bash Variables. (line 282)
* EPOCHSECONDS: Bash Variables. (line 290)
* EUID: Bash Variables. (line 297)
* EXECIGNORE: Bash Variables. (line 301)
* expand-tilde: Readline Init File Syntax.
(line 161)
* FCEDIT: Bash Variables. (line 304)
* FIGNORE: Bash Variables. (line 308)
* FUNCNAME: Bash Variables. (line 314)
* FUNCNEST: Bash Variables. (line 331)
* GLOBIGNORE: Bash Variables. (line 336)
* GROUPS: Bash Variables. (line 343)
* histchars: Bash Variables. (line 349)
* HISTCMD: Bash Variables. (line 364)
* HISTCONTROL: Bash Variables. (line 369)
* HISTFILE: Bash Variables. (line 385)
* HISTFILESIZE: Bash Variables. (line 389)
* HISTIGNORE: Bash Variables. (line 400)
* FCEDIT: Bash Variables. (line 314)
* FIGNORE: Bash Variables. (line 318)
* FUNCNAME: Bash Variables. (line 324)
* FUNCNEST: Bash Variables. (line 341)
* GLOBIGNORE: Bash Variables. (line 346)
* GROUPS: Bash Variables. (line 353)
* histchars: Bash Variables. (line 359)
* HISTCMD: Bash Variables. (line 374)
* HISTCONTROL: Bash Variables. (line 379)
* HISTFILE: Bash Variables. (line 395)
* HISTFILESIZE: Bash Variables. (line 399)
* HISTIGNORE: Bash Variables. (line 410)
* history-preserve-point: Readline Init File Syntax.
(line 165)
* history-size: Readline Init File Syntax.
(line 171)
* HISTSIZE: Bash Variables. (line 420)
* HISTTIMEFORMAT: Bash Variables. (line 427)
* HISTSIZE: Bash Variables. (line 430)
* HISTTIMEFORMAT: Bash Variables. (line 437)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 180)
* HOSTFILE: Bash Variables. (line 435)
* HOSTNAME: Bash Variables. (line 446)
* HOSTTYPE: Bash Variables. (line 449)
* HOSTFILE: Bash Variables. (line 445)
* HOSTNAME: Bash Variables. (line 456)
* HOSTTYPE: Bash Variables. (line 459)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 452)
* IGNOREEOF: Bash Variables. (line 462)
* input-meta: Readline Init File Syntax.
(line 187)
* INPUTRC: Bash Variables. (line 462)
* INSIDE_EMACS: Bash Variables. (line 466)
(line 189)
* INPUTRC: Bash Variables. (line 472)
* INSIDE_EMACS: Bash Variables. (line 476)
* isearch-terminators: Readline Init File Syntax.
(line 195)
(line 197)
* keymap: Readline Init File Syntax.
(line 202)
* LANG: Bash Variables. (line 472)
* LC_ALL: Bash Variables. (line 476)
* LC_COLLATE: Bash Variables. (line 480)
* LC_CTYPE: Bash Variables. (line 487)
(line 204)
* LANG: Bash Variables. (line 482)
* LC_ALL: Bash Variables. (line 486)
* LC_COLLATE: Bash Variables. (line 490)
* LC_CTYPE: Bash Variables. (line 497)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 492)
* LC_NUMERIC: Bash Variables. (line 496)
* LC_TIME: Bash Variables. (line 500)
* LINENO: Bash Variables. (line 504)
* LINES: Bash Variables. (line 509)
* MACHTYPE: Bash Variables. (line 515)
* LC_MESSAGES <1>: Bash Variables. (line 502)
* LC_NUMERIC: Bash Variables. (line 506)
* LC_TIME: Bash Variables. (line 510)
* LINENO: Bash Variables. (line 514)
* LINES: Bash Variables. (line 519)
* MACHTYPE: Bash Variables. (line 525)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 519)
* MAILCHECK: Bash Variables. (line 529)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 527)
* MAPFILE: Bash Variables. (line 537)
* mark-modified-lines: Readline Init File Syntax.
(line 232)
(line 234)
* mark-symlinked-directories: Readline Init File Syntax.
(line 237)
(line 239)
* match-hidden-files: Readline Init File Syntax.
(line 242)
(line 244)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 249)
(line 251)
* meta-flag: Readline Init File Syntax.
(line 187)
* OLDPWD: Bash Variables. (line 531)
(line 189)
* OLDPWD: Bash Variables. (line 541)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 534)
* OPTERR: Bash Variables. (line 544)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 538)
* OSTYPE: Bash Variables. (line 548)
* output-meta: Readline Init File Syntax.
(line 254)
(line 256)
* page-completions: Readline Init File Syntax.
(line 260)
(line 262)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 541)
* POSIXLY_CORRECT: Bash Variables. (line 546)
* PPID: Bash Variables. (line 556)
* PROMPT_COMMAND: Bash Variables. (line 560)
* PROMPT_DIRTRIM: Bash Variables. (line 564)
* PS0: Bash Variables. (line 570)
* PIPESTATUS: Bash Variables. (line 551)
* POSIXLY_CORRECT: Bash Variables. (line 556)
* PPID: Bash Variables. (line 566)
* PROMPT_COMMAND: Bash Variables. (line 570)
* PROMPT_DIRTRIM: Bash Variables. (line 574)
* PS0: Bash Variables. (line 580)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 575)
* PS4: Bash Variables. (line 580)
* PWD: Bash Variables. (line 588)
* RANDOM: Bash Variables. (line 591)
* READLINE_LINE: Bash Variables. (line 597)
* READLINE_POINT: Bash Variables. (line 601)
* REPLY: Bash Variables. (line 605)
* PS3: Bash Variables. (line 585)
* PS4: Bash Variables. (line 590)
* PWD: Bash Variables. (line 598)
* RANDOM: Bash Variables. (line 601)
* READLINE_LINE: Bash Variables. (line 607)
* READLINE_POINT: Bash Variables. (line 611)
* REPLY: Bash Variables. (line 615)
* revert-all-at-newline: Readline Init File Syntax.
(line 270)
* SECONDS: Bash Variables. (line 608)
* SHELL: Bash Variables. (line 615)
* SHELLOPTS: Bash Variables. (line 620)
* SHLVL: Bash Variables. (line 629)
(line 272)
* SECONDS: Bash Variables. (line 618)
* SHELL: Bash Variables. (line 625)
* SHELLOPTS: Bash Variables. (line 630)
* SHLVL: Bash Variables. (line 639)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
(line 278)
* show-all-if-unmodified: Readline Init File Syntax.
(line 282)
(line 284)
* show-mode-in-prompt: Readline Init File Syntax.
(line 291)
(line 293)
* skip-completed-text: Readline Init File Syntax.
(line 297)
* SRANDOM: Bash Variables. (line 634)
(line 299)
* SRANDOM: Bash Variables. (line 644)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 643)
* TMOUT: Bash Variables. (line 681)
* TMPDIR: Bash Variables. (line 693)
* UID: Bash Variables. (line 697)
* TIMEFORMAT: Bash Variables. (line 653)
* TMOUT: Bash Variables. (line 691)
* TMPDIR: Bash Variables. (line 703)
* UID: Bash Variables. (line 707)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 310)
(line 312)
* vi-ins-mode-string: Readline Init File Syntax.
(line 321)
(line 323)
* visible-stats: Readline Init File Syntax.
(line 332)
(line 334)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -11794,109 +11797,109 @@ Node: Command Grouping40662
Node: Coprocesses42141
Node: GNU Parallel44044
Node: Shell Functions48345
Node: Shell Parameters55428
Node: Positional Parameters59841
Node: Special Parameters60741
Node: Shell Expansions64495
Node: Brace Expansion66618
Node: Tilde Expansion69341
Node: Shell Parameter Expansion71958
Node: Command Substitution86391
Node: Arithmetic Expansion87746
Node: Process Substitution88678
Node: Word Splitting89798
Node: Filename Expansion91742
Node: Pattern Matching94291
Node: Quote Removal98277
Node: Redirections98572
Node: Executing Commands108130
Node: Simple Command Expansion108800
Node: Command Search and Execution110754
Node: Command Execution Environment113130
Node: Environment116114
Node: Exit Status117773
Node: Signals119443
Node: Shell Scripts121410
Node: Shell Builtin Commands124422
Node: Bourne Shell Builtins126460
Node: Bash Builtins147376
Node: Modifying Shell Behavior176301
Node: The Set Builtin176646
Node: The Shopt Builtin187059
Node: Special Builtins204729
Node: Shell Variables205708
Node: Bourne Shell Variables206145
Node: Bash Variables208249
Node: Bash Features239661
Node: Invoking Bash240560
Node: Bash Startup Files246573
Node: Interactive Shells251676
Node: What is an Interactive Shell?252086
Node: Is this Shell Interactive?252735
Node: Interactive Shell Behavior253550
Node: Bash Conditional Expressions257037
Node: Shell Arithmetic261614
Node: Aliases264554
Node: Arrays267174
Node: The Directory Stack272539
Node: Directory Stack Builtins273323
Node: Controlling the Prompt276291
Node: The Restricted Shell279212
Node: Bash POSIX Mode281694
Node: Job Control292627
Node: Job Control Basics293087
Node: Job Control Builtins298051
Node: Job Control Variables303197
Node: Command Line Editing304353
Node: Introduction and Notation306024
Node: Readline Interaction307647
Node: Readline Bare Essentials308838
Node: Readline Movement Commands310621
Node: Readline Killing Commands311581
Node: Readline Arguments313499
Node: Searching314543
Node: Readline Init File316729
Node: Readline Init File Syntax317988
Node: Conditional Init Constructs338427
Node: Sample Init File342623
Node: Bindable Readline Commands345740
Node: Commands For Moving346944
Node: Commands For History348803
Node: Commands For Text353098
Node: Commands For Killing356486
Node: Numeric Arguments359301
Node: Commands For Completion360440
Node: Keyboard Macros364631
Node: Miscellaneous Commands365318
Node: Readline vi Mode371271
Node: Programmable Completion372178
Node: Programmable Completion Builtins379958
Node: A Programmable Completion Example390653
Node: Using History Interactively395900
Node: Bash History Facilities396584
Node: Bash History Builtins399589
Node: History Interaction404120
Node: Event Designators407740
Node: Word Designators409094
Node: Modifiers410854
Node: Installing Bash412665
Node: Basic Installation413802
Node: Compilers and Options417060
Node: Compiling For Multiple Architectures417801
Node: Installation Names419494
Node: Specifying the System Type420312
Node: Sharing Defaults421028
Node: Operation Controls421701
Node: Optional Features422659
Node: Reporting Bugs433177
Node: Major Differences From The Bourne Shell434371
Node: GNU Free Documentation License451223
Node: Indexes476400
Node: Builtin Index476854
Node: Reserved Word Index483681
Node: Variable Index486129
Node: Function Index501953
Node: Concept Index515392
Node: Shell Parameters55552
Node: Positional Parameters59965
Node: Special Parameters60865
Node: Shell Expansions64089
Node: Brace Expansion66212
Node: Tilde Expansion68935
Node: Shell Parameter Expansion71552
Node: Command Substitution85985
Node: Arithmetic Expansion87340
Node: Process Substitution88272
Node: Word Splitting89392
Node: Filename Expansion91336
Node: Pattern Matching93885
Node: Quote Removal97871
Node: Redirections98166
Node: Executing Commands107724
Node: Simple Command Expansion108394
Node: Command Search and Execution110348
Node: Command Execution Environment112724
Node: Environment115708
Node: Exit Status117367
Node: Signals119037
Node: Shell Scripts121004
Node: Shell Builtin Commands124016
Node: Bourne Shell Builtins126054
Node: Bash Builtins146970
Node: Modifying Shell Behavior175895
Node: The Set Builtin176240
Node: The Shopt Builtin186653
Node: Special Builtins204323
Node: Shell Variables205302
Node: Bourne Shell Variables205739
Node: Bash Variables207843
Node: Bash Features239785
Node: Invoking Bash240684
Node: Bash Startup Files246697
Node: Interactive Shells251800
Node: What is an Interactive Shell?252210
Node: Is this Shell Interactive?252859
Node: Interactive Shell Behavior253674
Node: Bash Conditional Expressions257161
Node: Shell Arithmetic261738
Node: Aliases264678
Node: Arrays267298
Node: The Directory Stack272663
Node: Directory Stack Builtins273447
Node: Controlling the Prompt276415
Node: The Restricted Shell279336
Node: Bash POSIX Mode281818
Node: Job Control292751
Node: Job Control Basics293211
Node: Job Control Builtins298175
Node: Job Control Variables303321
Node: Command Line Editing304477
Node: Introduction and Notation306148
Node: Readline Interaction307771
Node: Readline Bare Essentials308962
Node: Readline Movement Commands310745
Node: Readline Killing Commands311705
Node: Readline Arguments313623
Node: Searching314667
Node: Readline Init File316853
Node: Readline Init File Syntax318112
Node: Conditional Init Constructs338642
Node: Sample Init File342838
Node: Bindable Readline Commands345955
Node: Commands For Moving347159
Node: Commands For History349018
Node: Commands For Text353313
Node: Commands For Killing356701
Node: Numeric Arguments359516
Node: Commands For Completion360655
Node: Keyboard Macros364846
Node: Miscellaneous Commands365533
Node: Readline vi Mode371486
Node: Programmable Completion372393
Node: Programmable Completion Builtins380173
Node: A Programmable Completion Example390868
Node: Using History Interactively396115
Node: Bash History Facilities396799
Node: Bash History Builtins399804
Node: History Interaction404335
Node: Event Designators407955
Node: Word Designators409309
Node: Modifiers411069
Node: Installing Bash412880
Node: Basic Installation414017
Node: Compilers and Options417275
Node: Compiling For Multiple Architectures418016
Node: Installation Names419709
Node: Specifying the System Type420527
Node: Sharing Defaults421243
Node: Operation Controls421916
Node: Optional Features422874
Node: Reporting Bugs433392
Node: Major Differences From The Bourne Shell434586
Node: GNU Free Documentation License451438
Node: Indexes476615
Node: Builtin Index477069
Node: Reserved Word Index483896
Node: Variable Index486344
Node: Function Index502168
Node: Concept Index515607

End Tag Table
doc/bashref.log
+39 -14
View File
@@ -1,4 +1,4 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019/MacPorts 2019.50896_1) (preloaded format=etex 2019.11.6) 22 NOV 2019 15:35
This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019/MacPorts 2019.50896_1) (preloaded format=pdfetex 2019.11.6) 26 NOV 2019 11:18
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
@@ -161,8 +161,11 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(/usr/homes/chet/src/bash/src/doc/version.texi) [1] [2]
(/usr/homes/chet/src/bash/src/doc/bashref.toc [-1] [-2] [-3]) [-4] Chapter 1
(/usr/homes/chet/src/bash/src/doc/version.texi) [1{/opt/local/var/db/texmf/font
s/map/pdftex/updmap/pdftex.map}] [2]
(/usr/homes/chet/src/bash/src/doc/bashref.toc [-1] [-2] [-3]) [-4]
(/usr/homes/chet/src/bash/src/doc/bashref.toc)
(/usr/homes/chet/src/bash/src/doc/bashref.toc) Chapter 1
\openout0 = `bashref.toc'.
@@ -190,7 +193,7 @@ texinfo.tex: doing @include of version.texi
[44] [45] [46] [47]
[48] [49] [50] [51] [52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62]
[63] [64] [65] [66] [67] [68] [69] [70] [71] Chapter 5 [72] [73] [74] [75]
[63] [64] [65] [66] [67] [68] [69] [70] [71] [72] Chapter 5 [73] [74] [75]
[76] [77] [78] [79] [80] [81] [82] [83] [84] Chapter 6 [85] [86] [87] [88]
[89] [90] [91] [92] [93] [94] [95] [96] [97] [98] [99] [100] [101] [102]
[103] Chapter 7 [104] [105] [106] [107]
@@ -199,7 +202,7 @@ texinfo.tex: doing @include of rluser.texi
(/usr/homes/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [108]
[109] [110] [111] [112] [113] [114] [115] [116] [117] [118]
Underfull \hbox (badness 7540) in paragraph at lines 812--818
Underfull \hbox (badness 7540) in paragraph at lines 813--819
[]@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
-tion
@@ -212,7 +215,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 812--818
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 812--818
Underfull \hbox (badness 10000) in paragraph at lines 813--819
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -225,7 +228,7 @@ e func-tion
.etc.
[119] [120] [121] [122]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1046--1046
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1047--1047
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -243,7 +246,7 @@ gnored[]
[125] [126] [127] [128] [129] [130] [131] [132] [133] [134]
[135] [136]
Overfull \hbox (15.27109pt too wide) in paragraph at lines 2042--2042
Overfull \hbox (15.27109pt too wide) in paragraph at lines 2043--2043
[]@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-DEI] [
-A @textttsl ac-tion@texttt ] [-
@@ -283,12 +286,34 @@ Overfull \vbox (0.67252pt too high) has occurred while \output is active
[177] [178] [179] [180] [181] )
Here is how much of TeX's memory you used:
3517 strings out of 497108
39941 string characters out of 6207178
86576 words of memory out of 5000000
4683 multiletter control sequences out of 15000+600000
4068 strings out of 497098
47117 string characters out of 6206772
138084 words of memory out of 5000000
4848 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
16i,6n,16p,339b,936s stack positions out of 5000i,500n,10000p,200000b,80000s
16i,6n,16p,339b,968s stack positions out of 5000i,500n,10000p,200000b,80000s
{/opt/local/share/texmf-texlive/fonts/enc/dvips/
cm-super/cm-super-t1.enc}</opt/local/share/texmf-texlive/fonts/type1/public/ams
fonts/cm/cmbx12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts
/cm/cmcsc10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/
cmmi10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi1
2.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi9.pfb>
</opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr10.pfb></opt/
local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr9.pfb></opt/local/s
hare/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsl10.pfb></opt/local/share/
texmf-texlive/fonts/type1/public/amsfonts/cm/cmsltt10.pfb></opt/local/share/tex
mf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb></opt/local/share/texmf-te
xlive/fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/share/texmf-texlive
/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/texmf-texlive/font
s/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texlive/fonts/typ
e1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
lic/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm
-super/sfrm1440.pfb>
Output written on bashref.pdf (187 pages, 759184 bytes).
PDF statistics:
2644 PDF objects out of 2984 (max. 8388607)
2411 compressed objects within 25 object streams
313 named destinations out of 1000 (max. 500000)
1125 words of extra memory for PDF output out of 10000 (max. 10000000)
Output written on bashref.dvi (187 pages, 774688 bytes).
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1809 -1802
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+20 -18
View File
@@ -1375,16 +1375,16 @@ shell context; no new process is created to interpret them.
Functions are declared using this syntax:
@rwindex function
@example
@var{name} () @var{compound-command} [ @var{redirections} ]
@var{fname} () @var{compound-command} [ @var{redirections} ]
@end example
or
@example
function @var{name} [()] @var{compound-command} [ @var{redirections} ]
function @var{fname} [()] @var{compound-command} [ @var{redirections} ]
@end example
This defines a shell function named @var{name}. The reserved
This defines a shell function named @var{fname}. The reserved
word @code{function} is optional.
If the @code{function} reserved
word is supplied, the parentheses are optional.
@@ -1394,14 +1394,16 @@ That command is usually a @var{list} enclosed between @{ and @}, but
may be any compound command listed above,
with one exception: If the @code{function} reserved word is used, but the
parentheses are not supplied, the braces are required.
@var{compound-command} is executed whenever @var{name} is specified as the
@var{compound-command} is executed whenever @var{fname} is specified as the
name of a command.
When the shell is in @sc{posix} mode (@pxref{Bash POSIX Mode}),
@var{name} may not be the same as one of the special builtins
@var{fname} must be a valid shell @var{name} and
may not be the same as one of the special builtins
(@pxref{Special Builtins}).
In default mode, a function name can be any unquoted shell word that does
not contain @samp{$}.
Any redirections (@pxref{Redirections}) associated with the shell function
are performed when the function is executed.
A function definition may be deleted using the @option{-f} option to the
@code{unset} builtin (@pxref{Bourne Shell Builtins}).
@@ -1746,18 +1748,6 @@ If Bash is started with the @option{-c} option (@pxref{Invoking Bash}),
then @code{$0} is set to the first argument after the string to be
executed, if one is present. Otherwise, it is set
to the filename used to invoke Bash, as given by argument zero.
@item _
@vindex $_
($_, an underscore.)
At shell startup, set to the absolute pathname used to invoke the
shell or shell script being executed as passed in the environment
or argument list.
Subsequently, expands to the last argument to the previous simple
command executed in the foreground, after expansion.
Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file.
@end vtable
@node Shell Expansions
@@ -5649,6 +5639,18 @@ variables for controlling the job control facilities
@vtable @code
@item _
@vindex $_
($_, an underscore.)
At shell startup, set to the absolute pathname used to invoke the
shell or shell script being executed as passed in the environment
or argument list.
Subsequently, expands to the last argument to the previous simple
command executed in the foreground, after expansion.
Also set to the full pathname used to invoke each command executed
and placed in the environment exported to that command.
When checking mail, this parameter holds the name of the mail file.
@item BASH
The full pathname used to execute the current instance of Bash.
doc/bashref.toc
+2 -2
View File
@@ -29,7 +29,7 @@
@numsecentry{Shell Expansions}{3.5}{Shell Expansions}{22}
@numsubsecentry{Brace Expansion}{3.5.1}{Brace Expansion}{23}
@numsubsecentry{Tilde Expansion}{3.5.2}{Tilde Expansion}{24}
@numsubsecentry{Shell Parameter Expansion}{3.5.3}{Shell Parameter Expansion}{25}
@numsubsecentry{Shell Parameter Expansion}{3.5.3}{Shell Parameter Expansion}{24}
@numsubsecentry{Command Substitution}{3.5.4}{Command Substitution}{31}
@numsubsecentry{Arithmetic Expansion}{3.5.5}{Arithmetic Expansion}{31}
@numsubsecentry{Process Substitution}{3.5.6}{Process Substitution}{31}
@@ -38,7 +38,7 @@
@numsubsubsecentry{Pattern Matching}{3.5.8.1}{Pattern Matching}{33}
@numsubsecentry{Quote Removal}{3.5.9}{Quote Removal}{34}
@numsecentry{Redirections}{3.6}{Redirections}{34}
@numsubsecentry{Redirecting Input}{3.6.1}{}{36}
@numsubsecentry{Redirecting Input}{3.6.1}{}{35}
@numsubsecentry{Redirecting Output}{3.6.2}{}{36}
@numsubsecentry{Appending Redirected Output}{3.6.3}{}{36}
@numsubsecentry{Redirecting Standard Output and Standard Error}{3.6.4}{}{36}
doc/bashref.vr
+14 -14
View File
@@ -17,8 +17,6 @@
\entry{$!}{22}{\code {$!}}
\entry{0}{22}{\code {0}}
\entry{$0}{22}{\code {$0}}
\entry{_}{22}{\code {_}}
\entry{$_}{22}{\code {$_}}
\entry{CDPATH}{74}{\code {CDPATH}}
\entry{HOME}{74}{\code {HOME}}
\entry{IFS}{74}{\code {IFS}}
@@ -29,13 +27,15 @@
\entry{PATH}{74}{\code {PATH}}
\entry{PS1}{74}{\code {PS1}}
\entry{PS2}{74}{\code {PS2}}
\entry{BASH}{74}{\code {BASH}}
\entry{_}{74}{\code {_}}
\entry{$_}{74}{\code {$_}}
\entry{BASH}{75}{\code {BASH}}
\entry{BASHOPTS}{75}{\code {BASHOPTS}}
\entry{BASHPID}{75}{\code {BASHPID}}
\entry{BASH_ALIASES}{75}{\code {BASH_ALIASES}}
\entry{BASH_ARGC}{75}{\code {BASH_ARGC}}
\entry{BASH_ARGV}{75}{\code {BASH_ARGV}}
\entry{BASH_ARGV0}{75}{\code {BASH_ARGV0}}
\entry{BASH_ARGV0}{76}{\code {BASH_ARGV0}}
\entry{BASH_CMDS}{76}{\code {BASH_CMDS}}
\entry{BASH_COMMAND}{76}{\code {BASH_COMMAND}}
\entry{BASH_COMPAT}{76}{\code {BASH_COMPAT}}
@@ -43,13 +43,13 @@
\entry{BASH_EXECUTION_STRING}{76}{\code {BASH_EXECUTION_STRING}}
\entry{BASH_LINENO}{76}{\code {BASH_LINENO}}
\entry{BASH_LOADABLES_PATH}{76}{\code {BASH_LOADABLES_PATH}}
\entry{BASH_REMATCH}{76}{\code {BASH_REMATCH}}
\entry{BASH_REMATCH}{77}{\code {BASH_REMATCH}}
\entry{BASH_SOURCE}{77}{\code {BASH_SOURCE}}
\entry{BASH_SUBSHELL}{77}{\code {BASH_SUBSHELL}}
\entry{BASH_VERSINFO}{77}{\code {BASH_VERSINFO}}
\entry{BASH_VERSION}{77}{\code {BASH_VERSION}}
\entry{BASH_XTRACEFD}{77}{\code {BASH_XTRACEFD}}
\entry{CHILD_MAX}{77}{\code {CHILD_MAX}}
\entry{CHILD_MAX}{78}{\code {CHILD_MAX}}
\entry{COLUMNS}{78}{\code {COLUMNS}}
\entry{COMP_CWORD}{78}{\code {COMP_CWORD}}
\entry{COMP_LINE}{78}{\code {COMP_LINE}}
@@ -58,7 +58,7 @@
\entry{COMP_KEY}{78}{\code {COMP_KEY}}
\entry{COMP_WORDBREAKS}{78}{\code {COMP_WORDBREAKS}}
\entry{COMP_WORDS}{78}{\code {COMP_WORDS}}
\entry{COMPREPLY}{78}{\code {COMPREPLY}}
\entry{COMPREPLY}{79}{\code {COMPREPLY}}
\entry{COPROC}{79}{\code {COPROC}}
\entry{DIRSTACK}{79}{\code {DIRSTACK}}
\entry{EMACS}{79}{\code {EMACS}}
@@ -68,8 +68,8 @@
\entry{EUID}{79}{\code {EUID}}
\entry{EXECIGNORE}{79}{\code {EXECIGNORE}}
\entry{FCEDIT}{79}{\code {FCEDIT}}
\entry{FIGNORE}{79}{\code {FIGNORE}}
\entry{FUNCNAME}{79}{\code {FUNCNAME}}
\entry{FIGNORE}{80}{\code {FIGNORE}}
\entry{FUNCNAME}{80}{\code {FUNCNAME}}
\entry{FUNCNEST}{80}{\code {FUNCNEST}}
\entry{GLOBIGNORE}{80}{\code {GLOBIGNORE}}
\entry{GROUPS}{80}{\code {GROUPS}}
@@ -95,8 +95,8 @@
\entry{LC_NUMERIC}{82}{\code {LC_NUMERIC}}
\entry{LC_TIME}{82}{\code {LC_TIME}}
\entry{LINENO}{82}{\code {LINENO}}
\entry{LINES}{82}{\code {LINES}}
\entry{MACHTYPE}{82}{\code {MACHTYPE}}
\entry{LINES}{83}{\code {LINES}}
\entry{MACHTYPE}{83}{\code {MACHTYPE}}
\entry{MAILCHECK}{83}{\code {MAILCHECK}}
\entry{MAPFILE}{83}{\code {MAPFILE}}
\entry{OLDPWD}{83}{\code {OLDPWD}}
@@ -108,8 +108,8 @@
\entry{PROMPT_COMMAND}{83}{\code {PROMPT_COMMAND}}
\entry{PROMPT_DIRTRIM}{83}{\code {PROMPT_DIRTRIM}}
\entry{PS0}{83}{\code {PS0}}
\entry{PS3}{83}{\code {PS3}}
\entry{PS4}{83}{\code {PS4}}
\entry{PS3}{84}{\code {PS3}}
\entry{PS4}{84}{\code {PS4}}
\entry{PWD}{84}{\code {PWD}}
\entry{RANDOM}{84}{\code {RANDOM}}
\entry{READLINE_LINE}{84}{\code {READLINE_LINE}}
@@ -120,7 +120,7 @@
\entry{SHELLOPTS}{84}{\code {SHELLOPTS}}
\entry{SHLVL}{84}{\code {SHLVL}}
\entry{SRANDOM}{84}{\code {SRANDOM}}
\entry{TIMEFORMAT}{84}{\code {TIMEFORMAT}}
\entry{TIMEFORMAT}{85}{\code {TIMEFORMAT}}
\entry{TMOUT}{85}{\code {TMOUT}}
\entry{TMPDIR}{85}{\code {TMPDIR}}
\entry{UID}{85}{\code {UID}}
doc/bashref.vrs
+14 -14
View File
@@ -11,7 +11,7 @@
\entry{\code {$-}}{22}
\entry{\code {$?}}{22}
\entry{\code {$@}}{21}
\entry{\code {$_}}{22}
\entry{\code {$_}}{74}
\entry{\code {$0}}{22}
\initial {*}
\entry{\code {*}}{21}
@@ -22,17 +22,17 @@
\initial {@}
\entry{\code {@}}{21}
\initial {_}
\entry{\code {_}}{22}
\entry{\code {_}}{74}
\initial {0}
\entry{\code {0}}{22}
\initial {A}
\entry{\code {auto_resume}}{108}
\initial {B}
\entry{\code {BASH}}{74}
\entry{\code {BASH}}{75}
\entry{\code {BASH_ALIASES}}{75}
\entry{\code {BASH_ARGC}}{75}
\entry{\code {BASH_ARGV}}{75}
\entry{\code {BASH_ARGV0}}{75}
\entry{\code {BASH_ARGV0}}{76}
\entry{\code {BASH_CMDS}}{76}
\entry{\code {BASH_COMMAND}}{76}
\entry{\code {BASH_COMPAT}}{76}
@@ -40,7 +40,7 @@
\entry{\code {BASH_EXECUTION_STRING}}{76}
\entry{\code {BASH_LINENO}}{76}
\entry{\code {BASH_LOADABLES_PATH}}{76}
\entry{\code {BASH_REMATCH}}{76}
\entry{\code {BASH_REMATCH}}{77}
\entry{\code {BASH_SOURCE}}{77}
\entry{\code {BASH_SUBSHELL}}{77}
\entry{\code {BASH_VERSINFO}}{77}
@@ -53,7 +53,7 @@
\entry{\code {blink-matching-paren}}{113}
\initial {C}
\entry{\code {CDPATH}}{74}
\entry{\code {CHILD_MAX}}{77}
\entry{\code {CHILD_MAX}}{78}
\entry{\code {colored-completion-prefix}}{113}
\entry{\code {colored-stats}}{113}
\entry{\code {COLUMNS}}{78}
@@ -70,7 +70,7 @@
\entry{\code {completion-map-case}}{114}
\entry{\code {completion-prefix-display-length}}{114}
\entry{\code {completion-query-items}}{114}
\entry{\code {COMPREPLY}}{78}
\entry{\code {COMPREPLY}}{79}
\entry{\code {convert-meta}}{114}
\entry{\code {COPROC}}{79}
\initial {D}
@@ -91,8 +91,8 @@
\entry{\code {expand-tilde}}{115}
\initial {F}
\entry{\code {FCEDIT}}{79}
\entry{\code {FIGNORE}}{79}
\entry{\code {FUNCNAME}}{79}
\entry{\code {FIGNORE}}{80}
\entry{\code {FUNCNAME}}{80}
\entry{\code {FUNCNEST}}{80}
\initial {G}
\entry{\code {GLOBIGNORE}}{80}
@@ -131,9 +131,9 @@
\entry{\code {LC_NUMERIC}}{82}
\entry{\code {LC_TIME}}{82}
\entry{\code {LINENO}}{82}
\entry{\code {LINES}}{82}
\entry{\code {LINES}}{83}
\initial {M}
\entry{\code {MACHTYPE}}{82}
\entry{\code {MACHTYPE}}{83}
\entry{\code {MAIL}}{74}
\entry{\code {MAILCHECK}}{83}
\entry{\code {MAILPATH}}{74}
@@ -161,8 +161,8 @@
\entry{\code {PS0}}{83}
\entry{\code {PS1}}{74}
\entry{\code {PS2}}{74}
\entry{\code {PS3}}{83}
\entry{\code {PS4}}{83}
\entry{\code {PS3}}{84}
\entry{\code {PS4}}{84}
\entry{\code {PWD}}{84}
\initial {R}
\entry{\code {RANDOM}}{84}
@@ -183,7 +183,7 @@
\initial {T}
\entry{\code {TEXTDOMAIN}}{7}
\entry{\code {TEXTDOMAINDIR}}{7}
\entry{\code {TIMEFORMAT}}{84}
\entry{\code {TIMEFORMAT}}{85}
\entry{\code {TMOUT}}{85}
\entry{\code {TMPDIR}}{85}
\initial {U}
doc/builtins.0
+1 -1
View File
@@ -1379,7 +1379,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
in a double-quoted parameter expansion as a special
character. The single quotes must match (an even num-
ber) and the characters between the single quotes are
considered quoted. This is the behavior of posix mode
considered quoted. This is the behavior of <posix mode
through version 4.1. The default bash behavior remains
as in previous versions.
ccoommppaatt4422
doc/builtins.ps
+4 -4
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Fri Nov 22 15:53:55 2019
%%CreationDate: Tue Nov 26 11:15:40 2019
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@@ -2423,9 +2423,9 @@ F1(compat31)2.782 E F0 2.782(\)a)C .282(nd the ef)-2.782 F .282
(he single quotes must match \(an e)-5.502 F -.15(ve)-.25 G 3.002(nn).15
G .502(umber\) and the)-3.002 F 1.866
(characters between the single quotes are considered quoted.)184 600 R
1.866(This is the beha)6.866 F 1.866(vior of)-.2 F .59
(posix mode through v)184 612 R .589(ersion 4.1.)-.15 F .589(The def)
5.589 F .589(ault bash beha)-.1 F .589(vior remains as in pre)-.2 F .589
1.866(This is the beha)6.866 F 1.866(vior of)-.2 F .156
(<posix mode through v)184 612 R .156(ersion 4.1.)-.15 F .155(The def)
5.156 F .155(ault bash beha)-.1 F .155(vior remains as in pre)-.2 F .155
(vious v)-.25 F(er)-.15 E(-)-.2 E(sions.)184 624 Q F1(compat42)144 636 Q
F0 .587(If set,)184 648 R F1(bash)3.087 E F0 .588
(does not process the replacement string in the pattern substitution w)
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Fri Nov 22 15:53:55 2019
%%CreationDate: Tue Nov 26 11:15:40 2019
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 4
doc/version.texi
+2 -2
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2019 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Fri Nov 22 15:27:24 EST 2019
@set LASTCHANGE Tue Nov 26 11:14:58 EST 2019
@set EDITION 5.0
@set VERSION 5.0
@set UPDATED 22 November 2019
@set UPDATED 26 November 2019
@set UPDATED-MONTH November 2019
general.c
+9
View File
@@ -97,6 +97,8 @@ static struct {
0
};
static char *saved_posix_vars;
void
posix_initialize (on)
int on;
@@ -138,6 +140,13 @@ get_posix_options (bitmap)
return bitmap;
}
#undef save_posix_options
void
save_posix_options ()
{
saved_posix_vars = get_posix_options (saved_posix_vars);
}
void
set_posix_options (bitmap)
const char *bitmap;
general.h
+3
View File
@@ -307,6 +307,9 @@ extern int num_posix_options __P((void));
extern char *get_posix_options __P((char *));
extern void set_posix_options __P((const char *));
extern void save_posix_options __P((void));
#define save_posix_options() saved_posix_vars = get_posix_options (saved_posix_vars)
#if defined (RLIMTYPE)
extern RLIMTYPE string_to_rlimtype __P((char *));
extern void print_rlimtype __P((RLIMTYPE, int));
lib/readline/display.c
+82 -12
View File
@@ -1,6 +1,6 @@
/* display.c -- readline redisplay facility. */
/* Copyright (C) 1987-2017 Free Software Foundation, Inc.
/* Copyright (C) 1987-2019 Free Software Foundation, Inc.
This file is part of the GNU Readline Library (Readline), a library
for reading lines of text with interactive input and history editing.
@@ -192,6 +192,8 @@ int _rl_last_v_pos = 0;
on screen minus 1. */
int _rl_vis_botlin = 0;
static int _rl_quick_redisplay = 0;
/* This is a hint update_line gives to rl_redisplay that it has adjusted the
value of _rl_last_c_pos *and* taken the presence of any invisible chars in
the prompt into account. rl_redisplay notes this and does not do the
@@ -223,6 +225,10 @@ static int forced_display;
/* Default and initial buffer size. Can grow. */
static int line_size = DEFAULT_LINE_BUFFER_SIZE;
/* Set to a non-zero value if horizontal scrolling has been enabled
automatically because the terminal was resized to height 1. */
static int horizontal_scrolling_autoset = 0; /* explicit initialization */
/* Variables to keep track of the expanded prompt string, which may
include invisible characters. */
@@ -653,7 +659,21 @@ init_line_structures (int minsize)
line_structures_initialized = 1;
}
/* Do whatever tests are necessary and tell update_line that it can do a
quick, dumb redisplay on the assumption that there are so many
differences between the old and new lines that it would be a waste to
compute all the differences.
Right now, it just sets _rl_quick_redisplay if the current visible line
is a single line (so we don't have to move vertically or mess with line
wrapping). */
void
_rl_optimize_redisplay (void)
{
if (_rl_vis_botlin == 0)
_rl_quick_redisplay = 1;
}
/* Basic redisplay algorithm. See comments inline. */
void
rl_redisplay (void)
@@ -690,7 +710,18 @@ rl_redisplay (void)
}
else if (line_size <= _rl_screenwidth)
init_line_structures (_rl_screenwidth + 1);
/* Enable horizontal scrolling automatically for terminals of height 1
where wrapping lines doesn't work. Disable it as soon as the terminal
height is increased again if it was automatically enabled. */
if (_rl_screenheight <= 1)
{
if (_rl_horizontal_scroll_mode == 0)
horizontal_scrolling_autoset = 1;
_rl_horizontal_scroll_mode = 1;
}
else if (horizontal_scrolling_autoset)
_rl_horizontal_scroll_mode = 0;
/* Draw the line into the buffer. */
cpos_buffer_position = -1;
@@ -1210,19 +1241,35 @@ rl_redisplay (void)
_rl_clear_to_eol (nleft);
}
#if 0
/* This segment is intended to handle the case where the prompt
has invisible characters on the second line and the new line
/* This segment is intended to handle the case where the old
visible prompt has invisible characters and the new line
to be displayed needs to clear the rest of the old characters
out (e.g., when printing the i-search prompt). In general,
the case of the new line being shorter than the old.
Incomplete */
else if (linenum == prompt_last_screen_line &&
prompt_physical_chars > _rl_screenwidth &&
wrap_offset != prompt_invis_chars_first_line &&
out (e.g., when printing the i-search prompt): in general,
the case of the new line being shorter than the old. We need
to be at the end of the new line and the old line needs to be
longer than the current cursor position. It's not perfect,
since it uses the byte length of the first line, but this will
at worst result in some extra clear-to-end-of-lines. We can't
use the prompt length variables because they may not
correspond to the visible line (see printing the i-search
prompt above). The tests for differing numbers of invisible
characters may not matter and can probably be removed. */
else if (linenum == 0 &&
linenum == prompt_last_screen_line &&
_rl_last_c_pos == out &&
_rl_last_c_pos < visible_first_line_len &&
visible_wrap_offset &&
visible_wrap_offset != wrap_offset)
{
if (mb_cur_max > 1 && rl_byte_oriented == 0)
nleft = _rl_screenwidth - _rl_last_c_pos;
else
nleft = _rl_screenwidth + wrap_offset - _rl_last_c_pos;
if (nleft)
_rl_clear_to_eol (nleft);
}
#endif
/* Since the new first line is now visible, save its length. */
if (linenum == 0)
visible_first_line_len = (inv_botlin > 0) ? inv_lbreaks[1] : out - wrap_offset;
@@ -1445,6 +1492,8 @@ rl_redisplay (void)
visible_wrap_offset = 0;
else
visible_wrap_offset = wrap_offset;
_rl_quick_redisplay = 0;
}
RL_UNSETSTATE (RL_STATE_REDISPLAYING);
@@ -1657,6 +1706,19 @@ update_line (char *old, char *new, int current_line, int omax, int nmax, int inv
}
}
if (_rl_quick_redisplay)
{
nfd = new;
ofd = old;
for (od = 0, oe = ofd; od < omax && *oe; oe++, od++);
for (nd = 0, ne = nfd; nd < nmax && *ne; ne++, nd++);
od = nd = 0;
_rl_move_cursor_relative (0, old);
cpos_adjusted = 1;
goto dumb_update;
}
/* Find first difference. */
#if defined (HANDLE_MULTIBYTE)
if (mb_cur_max > 1 && rl_byte_oriented == 0)
@@ -1963,6 +2025,14 @@ dumb_update:
else
col_lendiff = lendiff;
/* col_lendiff uses _rl_col_width(), which doesn't know about whether or not
the multibyte characters it counts are invisible, so the count is short by
the number of bytes in the invisible multibyte characters - the number of
multibyte characters. We don't have a good way to solve this without
moving to something like a bitmap that indicates which characters are
visible and which are invisible. We fix it up (imperfectly) in the
caller. */
/* If we are changing the number of invisible characters in a line, and
the spot of first difference is before the end of the invisible chars,
lendiff needs to be adjusted. */
lib/readline/doc/readline.3
+3 -2
View File
@@ -6,9 +6,9 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Thu Dec 28 14:49:51 EST 2017
.\" Last Change: Mon Nov 25 10:53:27 EST 2019
.\"
.TH READLINE 3 "2017 December 28" "GNU Readline 8.0"
.TH READLINE 3 "2019 November 25" "GNU Readline 8.0"
.\"
.\" File Name macro. This used to be `.PN', for Path Name,
.\" but Sun doesn't seem to like that very much.
@@ -488,6 +488,7 @@ the maximum number of history entries will be set to 500.
When set to \fBOn\fP, makes readline use a single line for display,
scrolling the input horizontally on a single screen line when it
becomes longer than the screen width rather than wrapping to a new line.
This setting is automatically enabled for terminals of height 1.
.TP
.B input\-meta (Off)
If set to \fBOn\fP, readline will enable eight-bit input (that is,
lib/readline/doc/rluser.texi
+3 -2
View File
@@ -588,8 +588,9 @@ the maximum number of history entries will be set to 500.
This variable can be set to either @samp{on} or @samp{off}. Setting it
to @samp{on} means that the text of the lines being edited will scroll
horizontally on a single screen line when they are longer than the width
of the screen, instead of wrapping onto a new screen line. By default,
this variable is set to @samp{off}.
of the screen, instead of wrapping onto a new screen line.
This variable is automatically set to @samp{on} for terminals of height 1.
By default, this variable is set to @samp{off}.
@item input-meta
@vindex input-meta
lib/readline/doc/version.texi
+2 -2
View File
@@ -4,7 +4,7 @@ Copyright (C) 1988-2019 Free Software Foundation, Inc.
@set EDITION 8.0
@set VERSION 8.0
@set UPDATED 15 November 2019
@set UPDATED 25 November 2019
@set UPDATED-MONTH November 2019
@set LASTCHANGE Fri Nov 15 09:34:19 EST 2019
@set LASTCHANGE Mon Nov 25 10:53:13 EST 2019
lib/readline/isearch.c
+3 -1
View File
@@ -185,11 +185,13 @@ rl_display_search (char *search_string, int flags, int where)
strcpy (message + msglen, "i-search)`");
msglen += 10;
if (search_string)
if (search_string && *search_string)
{
strcpy (message + msglen, search_string);
msglen += searchlen;
}
else
_rl_optimize_redisplay ();
strcpy (message + msglen, "': ");
lib/readline/rlprivate.h
+1
View File
@@ -276,6 +276,7 @@ extern void _rl_erase_at_end_of_line PARAMS((int));
extern void _rl_clear_to_eol PARAMS((int));
extern void _rl_clear_screen PARAMS((void));
extern void _rl_update_final PARAMS((void));
extern void _rl_optimize_redisplay PARAMS((void));
extern void _rl_redisplay_after_sigwinch PARAMS((void));
extern void _rl_clean_up_for_exit PARAMS((void));
extern void _rl_erase_entire_line PARAMS((void));
po/ko.po
+389 -271
View File
File diff suppressed because it is too large Load Diff