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

commit bash-20160401 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2016-04-07 11:40:23 -04:00
parent b78207dd0c
commit b729dac1c8
28 changed files with 7103 additions and 6761 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+25
View File
@@ -10576,3 +10576,28 @@ findcmd.c
since the attempt to execute the last-ditch path will circumvent the
EXECIGNORE setting. Fixes bug reported by Dennis Williamson
<dennistwilliamson@gmail.com>
3/28
----
lib/readline/display.c
- rl_redisplay: when computing where the cursor should go (and the
physical cursor position) after displaying the prompt, don't adjust
the cursor position by wadjust if there are no multibyte chars in
the prompt. lpos is already a physical cursor position; _rl_screenwidth
is the physical screen width, and we're not calling _rl_col_width and
don't need to take invisible characters into account again. Fixes
bug reported by Andreas Schwab <schwab@linux-m68k.org>
4/1
---
parse.y
- parse_comsub: when we read `esac' followed by a break character,
turn on the LEX_RESWDOK flag because we can now read another case
statement or other compound command. Fixes bug reported by
Christian Franke <Christian.Franke@t-online.de>, original version
of patch from Piotr Grzybowski <narsil.pl@gmail.com>
- parse_comsub: leave the reserved-word-ok flag set for four-char
reserved words (then/else/elif/done/time) that can be followed by
reserved words; set lex_rwlen to 0 so we know to start reading a
new one
MANIFEST
+1
View File
@@ -887,6 +887,7 @@ tests/comsub.tests f
tests/comsub.right f
tests/comsub1.sub f
tests/comsub2.sub f
tests/comsub3.sub f
tests/comsub-eof.tests f
tests/comsub-eof0.sub f
tests/comsub-eof1.sub f
doc/bash.0
+879 -857
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+1 -1
View File
@@ -4222,7 +4222,7 @@ By default, no limit is imposed on the number of recursive calls.
.SH "ARITHMETIC EVALUATION"
The shell allows arithmetic expressions to be evaluated, under
certain circumstances (see the \fBlet\fP and \fBdeclare\fP builtin
commands and \fBArithmetic Expansion\fP).
commands, the \fB((\fP compound command, and \fBArithmetic Expansion\fP).
Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
The operators and their precedence, associativity, and values
doc/bash.html
+46 -14
View File
@@ -2566,11 +2566,14 @@ used when the shell is invoked in POSIX mode.
<DD>
A colon-separated list of shell patterns (see <B>Pattern Matching</B>)
defining the list of filenames to be ignored by command search.
defining the list of filenames to be ignored by command search using
<B>PATH</B>.
Files whose full pathnames match one of these patterns are not considered
executable files for the purposes of completion and command execution.
executable files for the purposes of completion and command execution
via <B>PATH</B> lookup.
This does not affect the behavior of the <B>[</B>, <B>test</B>, and <B>[[</B>
commands.
Full pathnames in the command hash table are not subject to <B>EXECIGNORE</B>.
Use this variable to ignore shared library files that have the executable
bit set, but are not executable files.
The pattern matching honors the setting of the <B>extglob</B> shell
@@ -4964,10 +4967,10 @@ No parameter and variable expansion, command substitution,
arithmetic expansion, or pathname expansion is performed on
<I>word</I>.
If any characters in
If any part of
<I>word</I>
are quoted, the
is quoted, the
<I>delimiter</I>
is the result of quote removal on
@@ -5396,7 +5399,7 @@ By default, no limit is imposed on the number of recursive calls.
The shell allows arithmetic expressions to be evaluated, under
certain circumstances (see the <B>let</B> and <B>declare</B> builtin
commands and <B>Arithmetic Expansion</B>).
commands, the <B>((</B> compound command, and <B>Arithmetic Expansion</B>).
Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
The operators and their precedence, associativity, and values
@@ -7008,6 +7011,11 @@ If set to <B>audible</B>, readline attempts to ring the terminal's bell.
If set to <B>On</B>, readline attempts to bind the control characters
treated specially by the kernel's terminal driver to their readline
equivalents.
<DT><B>blink-matching-paren (Off)</B>
<DD>
If set to <B>On</B>, readline attempts to briefly move the cursor to an
opening parenthesis when a closing parenthesis is inserted.
<DT><B>colored-completion-prefix (Off)</B>
<DD>
@@ -7036,11 +7044,26 @@ in emacs mode and to
<B>#</B>
in vi command mode.
<DT><B>completion-display-width (-1)</B>
<DD>
The number of screen columns used to display possible matches
when performing completion.
The value is ignored if it is less than 0 or greater than the terminal
screen width.
A value of 0 will cause matches to be displayed one per line.
The default value is -1.
<DT><B>completion-ignore-case (Off)</B>
<DD>
If set to <B>On</B>, readline performs filename matching and completion
in a case-insensitive fashion.
<DT><B>completion-map-case (Off)</B>
<DD>
If set to <B>On</B>, and <B>completion-ignore-case</B> is enabled, readline
treats hyphens (<I>-</I>) and underscores (<I>_</I>) as equivalent when
performing case-insensitive filename matching and completion.
<DT><B>completion-prefix-display-length (0)</B>
<DD>
@@ -7066,12 +7089,20 @@ If set to <B>On</B>, readline will convert characters with the
eighth bit set to an ASCII key sequence
by stripping the eighth bit and prefixing an
escape character (in effect, using escape as the <I>meta prefix</I>).
The default is <I>On</I>, but readline will set it to <I>Off</I> if the
locale contains eight-bit characters.
<DT><B>disable-completion (Off)</B>
<DD>
If set to <B>On</B>, readline will inhibit word completion. Completion
characters will be inserted into the line as if they had been
mapped to <B>self-insert</B>.
<DT><B>echo-control-characters (On)</B>
<DD>
When set to <B>On</B>, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
<DT><B>editing-mode (emacs)</B>
<DD>
@@ -7085,12 +7116,6 @@ can be set to either
or
<B>vi</B>.
<DT><B>echo-control-characters (On)</B>
<DD>
When set to <B>On</B>, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
<DT><B>enable-bracketed-paste (Off)</B>
<DD>
@@ -7130,7 +7155,10 @@ If set to zero, any existing history entries are deleted and no new entries
are saved.
If set to a value less than zero, the number of history entries is not
limited.
By default, the number of history entries is not limited.
By default, the number of history entries is set to the value of the
<B>HISTSIZE</B> shell variable.
If an attempt is made to set <I>history-size</I> to a non-numeric value,
the maximum number of history entries will be set to 500.
<DT><B>horizontal-scroll-mode (Off)</B>
<DD>
@@ -7141,11 +7169,13 @@ becomes longer than the screen width rather than wrapping to a new line.
<DD>
If set to <B>On</B>, readline will enable eight-bit input (that is,
it will not strip the high bit from the characters it reads),
it will not strip the eighth bit from the characters it reads),
regardless of what the terminal claims it can support. The name
<B>meta-flag</B>
is a synonym for this variable.
The default is <I>Off</I>, but readline will set it to <I>On</I> if the
locale contains eight-bit characters.
<DT><B>isearch-terminators (``C-[C-J'')</B>
<DD>
@@ -7229,6 +7259,8 @@ the list.
If set to <B>On</B>, readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is <I>Off</I>, but readline will set it to <I>On</I> if the
locale contains eight-bit characters.
<DT><B>page-completions (On)</B>
<DD>
@@ -13583,6 +13615,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 08 February 2016 10:17:49 EST
Time: 29 March 2016 09:29:07 EDT
</BODY>
</HTML>
doc/bash.info
+253 -245
View File
@@ -2,9 +2,9 @@ This is bash.info, produced by makeinfo version 6.0 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 8 February 2016).
Bash shell (version 4.4, 28 February 2016).
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2016 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 4.4, 8 February 2016). The Bash home page is
Bash shell (version 4.4, 28 February 2016). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -2317,13 +2317,13 @@ command.
DELIMITER
No parameter and variable expansion, command substitution, arithmetic
expansion, or filename expansion is performed on WORD. If any
characters in WORD are quoted, the DELIMITER is the result of quote
removal on WORD, and the lines in the here-document are not expanded.
If WORD is unquoted, all lines of the here-document are subjected to
parameter expansion, command substitution, and arithmetic expansion, the
character sequence '\newline' is ignored, and '\' must be used to quote
the characters '\', '$', and '`'.
expansion, or filename expansion is performed on WORD. If any part of
WORD is quoted, the DELIMITER is the result of quote removal on WORD,
and the lines in the here-document are not expanded. If WORD is
unquoted, all lines of the here-document are subjected to parameter
expansion, command substitution, and arithmetic expansion, the character
sequence '\newline' is ignored, and '\' must be used to quote the
characters '\', '$', and '`'.
If the redirection operator is '<<-', then all leading tab characters
are stripped from input lines and the line containing DELIMITER. This
@@ -3053,7 +3053,7 @@ standard.
'['
test EXPR
Evaluate a conditional express ion EXPR and return a status of 0
Evaluate a conditional expression EXPR and return a status of 0
(true) or 1 (false). Each operator and operand must be a separate
argument. Expressions are composed of the primaries described
below in *note Bash Conditional Expressions::. 'test' does not
@@ -3203,7 +3203,7 @@ standard.
Remove each variable or function NAME. If the '-v' option is
given, each NAME refers to a shell variable and that variable is
remvoved. If the '-f' option is given, the NAMEs refer to shell
removed. If the '-f' option is given, the NAMEs refer to shell
functions, and the function definition is removed. If the '-n'
option is supplied, and NAME is a variable with the NAMEREF
attribute, NAME will be unset rather than the variable it
@@ -4927,14 +4927,16 @@ Variables::).
'EXECIGNORE'
A colon-separated list of shell patterns (*note Pattern Matching::)
defining the list of filenames to be ignored by command search.
Files whose full pathnames match one of these patterns are not
considered executable files for the purposes of completion and
command execution. This does not affect the behavior of the '[',
'test', and '[[' commands. Use this variable to ignore shared
library files that have the executable bit set, but are not
executable files. The pattern matching honors the setting of the
'extglob' shell option.
defining the list of filenames to be ignored by command search
using 'PATH'. Files whose full pathnames match one of these
patterns are not considered executable files for the purposes of
completion and command execution via 'PATH' lookup. This does not
affect the behavior of the '[', 'test', and '[[' commands. Full
pathnames in the command hash table are not subject to
'EXECIGNORE'. Use this variable to ignore shared library files
that have the executable bit set, but are not executable files.
The pattern matching honors the setting of the 'extglob' shell
option.
'FCEDIT'
The editor used as a default by the '-e' option to the 'fc' builtin
@@ -5877,8 +5879,8 @@ File: bash.info, Node: Shell Arithmetic, Next: Aliases, Prev: Bash Conditiona
====================
The shell allows arithmetic expressions to be evaluated, as one of the
shell expansions or by the 'let' and the '-i' option to the 'declare'
builtins.
shell expansions or by using the '((' compound command, the 'let'
builtin, or the '-i' option to the 'declare' builtin.
Evaluation is done in fixed-width integers with no check for
overflow, though division by 0 is trapped and flagged as an error. The
@@ -7225,13 +7227,20 @@ Variable Settings
If set to 'on', Readline will convert characters with the
eighth bit set to an ASCII key sequence by stripping the
eighth bit and prefixing an <ESC> character, converting them
to a meta-prefixed key sequence. The default value is 'on'.
to a meta-prefixed key sequence. The default value is 'on',
but will be set to 'off' if the locale is one that contains
eight-bit characters.
'disable-completion'
If set to 'On', Readline will inhibit word completion.
Completion characters will be inserted into the line as if
they had been mapped to 'self-insert'. The default is 'off'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'editing-mode'
The 'editing-mode' variable controls which default set of key
bindings is used. By default, Readline starts up in Emacs
@@ -7248,11 +7257,6 @@ Variable Settings
embed a terminal control sequence into the mode string. The
default is '@'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'enable-bracketed-paste'
When set to 'On', Readline will configure the terminal in a
way that will enable it to insert each paste into the editing
@@ -7287,7 +7291,9 @@ Variable Settings
list. If set to zero, any existing history entries are
deleted and no new entries are saved. If set to a value less
than zero, the number of history entries is not limited. By
default, the number of history entries is not limited.
default, the number of history entries is not limited. If an
attempt is made to set HISTORY-SIZE to a non-numeric value,
the maximum number of history entries will be set to 500.
'horizontal-scroll-mode'
This variable can be set to either 'on' or 'off'. Setting it
@@ -7300,8 +7306,9 @@ Variable Settings
If set to 'on', Readline will enable eight-bit input (it will
not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support. The
default value is 'off'. The name 'meta-flag' is a synonym for
this variable.
default value is 'off', but Readline will set it to 'on' if
the locale contains eight-bit characters. The name
'meta-flag' is a synonym for this variable.
'isearch-terminators'
The string of characters that should terminate an incremental
@@ -7365,7 +7372,8 @@ Variable Settings
'output-meta'
If set to 'on', Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is 'off'.
sequence. The default is 'off', but Readline will set it to
'on' if the locale contains eight-bit characters.
'page-completions'
If set to 'on', Readline uses an internal 'more'-like pager to
@@ -10824,141 +10832,141 @@ D.3 Parameter and Variable Index
* COPROC: Bash Variables. (line 231)
* DIRSTACK: Bash Variables. (line 235)
* disable-completion: Readline Init File Syntax.
(line 114)
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 135)
(line 121)
* editing-mode: Readline Init File Syntax.
(line 119)
(line 126)
* EMACS: Bash Variables. (line 245)
* emacs-mode-string: Readline Init File Syntax.
(line 125)
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 140)
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 148)
(line 150)
* ENV: Bash Variables. (line 250)
* EUID: Bash Variables. (line 254)
* EXECIGNORE: Bash Variables. (line 258)
* expand-tilde: Readline Init File Syntax.
(line 159)
* FCEDIT: Bash Variables. (line 269)
* FIGNORE: Bash Variables. (line 273)
* FUNCNAME: Bash Variables. (line 279)
* FUNCNEST: Bash Variables. (line 296)
* GLOBIGNORE: Bash Variables. (line 301)
* GROUPS: Bash Variables. (line 308)
* histchars: Bash Variables. (line 314)
* HISTCMD: Bash Variables. (line 329)
* HISTCONTROL: Bash Variables. (line 334)
* HISTFILE: Bash Variables. (line 350)
* HISTFILESIZE: Bash Variables. (line 354)
* HISTIGNORE: Bash Variables. (line 365)
(line 161)
* FCEDIT: Bash Variables. (line 271)
* FIGNORE: Bash Variables. (line 275)
* FUNCNAME: Bash Variables. (line 281)
* FUNCNEST: Bash Variables. (line 298)
* GLOBIGNORE: Bash Variables. (line 303)
* GROUPS: Bash Variables. (line 310)
* histchars: Bash Variables. (line 316)
* HISTCMD: Bash Variables. (line 331)
* HISTCONTROL: Bash Variables. (line 336)
* HISTFILE: Bash Variables. (line 352)
* HISTFILESIZE: Bash Variables. (line 356)
* HISTIGNORE: Bash Variables. (line 367)
* history-preserve-point: Readline Init File Syntax.
(line 163)
(line 165)
* history-size: Readline Init File Syntax.
(line 169)
* HISTSIZE: Bash Variables. (line 385)
* HISTTIMEFORMAT: Bash Variables. (line 392)
(line 171)
* HISTSIZE: Bash Variables. (line 387)
* HISTTIMEFORMAT: Bash Variables. (line 394)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 176)
* HOSTFILE: Bash Variables. (line 400)
* HOSTNAME: Bash Variables. (line 411)
* HOSTTYPE: Bash Variables. (line 414)
(line 180)
* HOSTFILE: Bash Variables. (line 402)
* HOSTNAME: Bash Variables. (line 413)
* HOSTTYPE: Bash Variables. (line 416)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 417)
* IGNOREEOF: Bash Variables. (line 419)
* input-meta: Readline Init File Syntax.
(line 183)
* INPUTRC: Bash Variables. (line 427)
(line 187)
* INPUTRC: Bash Variables. (line 429)
* isearch-terminators: Readline Init File Syntax.
(line 190)
(line 195)
* keymap: Readline Init File Syntax.
(line 197)
* LANG: Bash Variables. (line 431)
* LC_ALL: Bash Variables. (line 435)
* LC_COLLATE: Bash Variables. (line 439)
* LC_CTYPE: Bash Variables. (line 446)
(line 202)
* LANG: Bash Variables. (line 433)
* LC_ALL: Bash Variables. (line 437)
* LC_COLLATE: Bash Variables. (line 441)
* LC_CTYPE: Bash Variables. (line 448)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 451)
* LC_NUMERIC: Bash Variables. (line 455)
* LC_TIME: Bash Variables. (line 459)
* LINENO: Bash Variables. (line 463)
* LINES: Bash Variables. (line 467)
* MACHTYPE: Bash Variables. (line 473)
* LC_MESSAGES <1>: Bash Variables. (line 453)
* LC_NUMERIC: Bash Variables. (line 457)
* LC_TIME: Bash Variables. (line 461)
* LINENO: Bash Variables. (line 465)
* LINES: Bash Variables. (line 469)
* MACHTYPE: Bash Variables. (line 475)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 477)
* MAILCHECK: Bash Variables. (line 479)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 485)
* MAPFILE: Bash Variables. (line 487)
* mark-modified-lines: Readline Init File Syntax.
(line 227)
* mark-symlinked-directories: Readline Init File Syntax.
(line 232)
* match-hidden-files: Readline Init File Syntax.
* mark-symlinked-directories: Readline Init File Syntax.
(line 237)
* match-hidden-files: Readline Init File Syntax.
(line 242)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 244)
(line 249)
* meta-flag: Readline Init File Syntax.
(line 183)
* OLDPWD: Bash Variables. (line 489)
(line 187)
* OLDPWD: Bash Variables. (line 491)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 492)
* OPTERR: Bash Variables. (line 494)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 496)
* OSTYPE: Bash Variables. (line 498)
* output-meta: Readline Init File Syntax.
(line 249)
* page-completions: Readline Init File Syntax.
(line 254)
* page-completions: Readline Init File Syntax.
(line 260)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 499)
* POSIXLY_CORRECT: Bash Variables. (line 504)
* PPID: Bash Variables. (line 513)
* PROMPT_COMMAND: Bash Variables. (line 517)
* PROMPT_DIRTRIM: Bash Variables. (line 521)
* PS0: Bash Variables. (line 527)
* PIPESTATUS: Bash Variables. (line 501)
* POSIXLY_CORRECT: Bash Variables. (line 506)
* PPID: Bash Variables. (line 515)
* PROMPT_COMMAND: Bash Variables. (line 519)
* PROMPT_DIRTRIM: Bash Variables. (line 523)
* PS0: Bash Variables. (line 529)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 532)
* PS4: Bash Variables. (line 537)
* PWD: Bash Variables. (line 543)
* RANDOM: Bash Variables. (line 546)
* READLINE_LINE: Bash Variables. (line 551)
* READLINE_POINT: Bash Variables. (line 555)
* REPLY: Bash Variables. (line 559)
* PS3: Bash Variables. (line 534)
* PS4: Bash Variables. (line 539)
* PWD: Bash Variables. (line 545)
* RANDOM: Bash Variables. (line 548)
* READLINE_LINE: Bash Variables. (line 553)
* READLINE_POINT: Bash Variables. (line 557)
* REPLY: Bash Variables. (line 561)
* revert-all-at-newline: Readline Init File Syntax.
(line 264)
* SECONDS: Bash Variables. (line 562)
* SHELL: Bash Variables. (line 568)
* SHELLOPTS: Bash Variables. (line 573)
* SHLVL: Bash Variables. (line 582)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 270)
* show-all-if-unmodified: Readline Init File Syntax.
* SECONDS: Bash Variables. (line 564)
* SHELL: Bash Variables. (line 570)
* SHELLOPTS: Bash Variables. (line 575)
* SHLVL: Bash Variables. (line 584)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
* show-all-if-unmodified: Readline Init File Syntax.
(line 282)
* show-mode-in-prompt: Readline Init File Syntax.
(line 285)
* skip-completed-text: Readline Init File Syntax.
(line 291)
* skip-completed-text: Readline Init File Syntax.
(line 297)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 587)
* TMOUT: Bash Variables. (line 625)
* TMPDIR: Bash Variables. (line 637)
* UID: Bash Variables. (line 641)
* TIMEFORMAT: Bash Variables. (line 589)
* TMOUT: Bash Variables. (line 627)
* TMPDIR: Bash Variables. (line 639)
* UID: Bash Variables. (line 643)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 304)
(line 310)
* vi-ins-mode-string: Readline Init File Syntax.
(line 314)
(line 320)
* visible-stats: Readline Init File Syntax.
(line 324)
(line 330)

File: bash.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -11320,134 +11328,134 @@ D.5 Concept Index

Tag Table:
Node: Top895
Node: Introduction2813
Node: What is Bash?3029
Node: What is a shell?4143
Node: Definitions6681
Node: Basic Shell Features9632
Node: Shell Syntax10851
Node: Shell Operation11877
Node: Quoting13170
Node: Escape Character14470
Node: Single Quotes14955
Node: Double Quotes15303
Node: ANSI-C Quoting16581
Node: Locale Translation17834
Node: Comments18730
Node: Shell Commands19348
Node: Simple Commands20220
Node: Pipelines20851
Node: Lists23594
Node: Compound Commands25323
Node: Looping Constructs26326
Node: Conditional Constructs28789
Node: Command Grouping39710
Node: Coprocesses41189
Node: GNU Parallel43021
Node: Shell Functions46994
Node: Shell Parameters52200
Node: Positional Parameters56602
Node: Special Parameters57502
Node: Shell Expansions60839
Node: Brace Expansion62776
Node: Tilde Expansion65557
Node: Shell Parameter Expansion67905
Node: Command Substitution82037
Node: Arithmetic Expansion83392
Node: Process Substitution84324
Node: Word Splitting85444
Node: Filename Expansion87388
Node: Pattern Matching89672
Node: Quote Removal93370
Node: Redirections93665
Node: Executing Commands102914
Node: Simple Command Expansion103584
Node: Command Search and Execution105514
Node: Command Execution Environment107850
Node: Environment110834
Node: Exit Status112493
Node: Signals114163
Node: Shell Scripts116130
Node: Shell Builtin Commands118645
Node: Bourne Shell Builtins120679
Node: Bash Builtins141281
Node: Modifying Shell Behavior169911
Node: The Set Builtin170256
Node: The Shopt Builtin180669
Node: Special Builtins196289
Node: Shell Variables197268
Node: Bourne Shell Variables197705
Node: Bash Variables199736
Node: Bash Features228000
Node: Invoking Bash228899
Node: Bash Startup Files234848
Node: Interactive Shells239951
Node: What is an Interactive Shell?240361
Node: Is this Shell Interactive?241010
Node: Interactive Shell Behavior241825
Node: Bash Conditional Expressions245200
Node: Shell Arithmetic249201
Node: Aliases251978
Node: Arrays254526
Node: The Directory Stack259610
Node: Directory Stack Builtins260394
Node: Controlling the Prompt263362
Node: The Restricted Shell266108
Node: Bash POSIX Mode267933
Node: Job Control277845
Node: Job Control Basics278305
Node: Job Control Builtins283024
Node: Job Control Variables287554
Node: Command Line Editing288710
Node: Introduction and Notation290381
Node: Readline Interaction292004
Node: Readline Bare Essentials293195
Node: Readline Movement Commands294978
Node: Readline Killing Commands295938
Node: Readline Arguments297856
Node: Searching298900
Node: Readline Init File301086
Node: Readline Init File Syntax302233
Node: Conditional Init Constructs321997
Node: Sample Init File324522
Node: Bindable Readline Commands327639
Node: Commands For Moving328843
Node: Commands For History329986
Node: Commands For Text334275
Node: Commands For Killing337664
Node: Numeric Arguments340145
Node: Commands For Completion341284
Node: Keyboard Macros345475
Node: Miscellaneous Commands346162
Node: Readline vi Mode351966
Node: Programmable Completion352873
Node: Programmable Completion Builtins360334
Node: A Programmable Completion Example370220
Node: Using History Interactively375472
Node: Bash History Facilities376156
Node: Bash History Builtins379157
Node: History Interaction383154
Node: Event Designators386118
Node: Word Designators387337
Node: Modifiers388974
Node: Installing Bash390376
Node: Basic Installation391513
Node: Compilers and Options394204
Node: Compiling For Multiple Architectures394945
Node: Installation Names396608
Node: Specifying the System Type397426
Node: Sharing Defaults398142
Node: Operation Controls398815
Node: Optional Features399773
Node: Reporting Bugs410030
Node: Major Differences From The Bourne Shell411224
Node: GNU Free Documentation License428076
Node: Indexes453253
Node: Builtin Index453707
Node: Reserved Word Index460534
Node: Variable Index462982
Node: Function Index478441
Node: Concept Index491661
Node: Top897
Node: Introduction2817
Node: What is Bash?3033
Node: What is a shell?4147
Node: Definitions6685
Node: Basic Shell Features9636
Node: Shell Syntax10855
Node: Shell Operation11881
Node: Quoting13174
Node: Escape Character14474
Node: Single Quotes14959
Node: Double Quotes15307
Node: ANSI-C Quoting16585
Node: Locale Translation17838
Node: Comments18734
Node: Shell Commands19352
Node: Simple Commands20224
Node: Pipelines20855
Node: Lists23598
Node: Compound Commands25327
Node: Looping Constructs26330
Node: Conditional Constructs28793
Node: Command Grouping39714
Node: Coprocesses41193
Node: GNU Parallel43025
Node: Shell Functions46998
Node: Shell Parameters52204
Node: Positional Parameters56606
Node: Special Parameters57506
Node: Shell Expansions60843
Node: Brace Expansion62780
Node: Tilde Expansion65561
Node: Shell Parameter Expansion67909
Node: Command Substitution82041
Node: Arithmetic Expansion83396
Node: Process Substitution84328
Node: Word Splitting85448
Node: Filename Expansion87392
Node: Pattern Matching89676
Node: Quote Removal93374
Node: Redirections93669
Node: Executing Commands102912
Node: Simple Command Expansion103582
Node: Command Search and Execution105512
Node: Command Execution Environment107848
Node: Environment110832
Node: Exit Status112491
Node: Signals114161
Node: Shell Scripts116128
Node: Shell Builtin Commands118643
Node: Bourne Shell Builtins120677
Node: Bash Builtins141277
Node: Modifying Shell Behavior169907
Node: The Set Builtin170252
Node: The Shopt Builtin180665
Node: Special Builtins196285
Node: Shell Variables197264
Node: Bourne Shell Variables197701
Node: Bash Variables199732
Node: Bash Features228112
Node: Invoking Bash229011
Node: Bash Startup Files234960
Node: Interactive Shells240063
Node: What is an Interactive Shell?240473
Node: Is this Shell Interactive?241122
Node: Interactive Shell Behavior241937
Node: Bash Conditional Expressions245312
Node: Shell Arithmetic249313
Node: Aliases252130
Node: Arrays254678
Node: The Directory Stack259762
Node: Directory Stack Builtins260546
Node: Controlling the Prompt263514
Node: The Restricted Shell266260
Node: Bash POSIX Mode268085
Node: Job Control277997
Node: Job Control Basics278457
Node: Job Control Builtins283176
Node: Job Control Variables287706
Node: Command Line Editing288862
Node: Introduction and Notation290533
Node: Readline Interaction292156
Node: Readline Bare Essentials293347
Node: Readline Movement Commands295130
Node: Readline Killing Commands296090
Node: Readline Arguments298008
Node: Searching299052
Node: Readline Init File301238
Node: Readline Init File Syntax302385
Node: Conditional Init Constructs322572
Node: Sample Init File325097
Node: Bindable Readline Commands328214
Node: Commands For Moving329418
Node: Commands For History330561
Node: Commands For Text334850
Node: Commands For Killing338239
Node: Numeric Arguments340720
Node: Commands For Completion341859
Node: Keyboard Macros346050
Node: Miscellaneous Commands346737
Node: Readline vi Mode352541
Node: Programmable Completion353448
Node: Programmable Completion Builtins360909
Node: A Programmable Completion Example370795
Node: Using History Interactively376047
Node: Bash History Facilities376731
Node: Bash History Builtins379732
Node: History Interaction383729
Node: Event Designators386693
Node: Word Designators387912
Node: Modifiers389549
Node: Installing Bash390951
Node: Basic Installation392088
Node: Compilers and Options394779
Node: Compiling For Multiple Architectures395520
Node: Installation Names397183
Node: Specifying the System Type398001
Node: Sharing Defaults398717
Node: Operation Controls399390
Node: Optional Features400348
Node: Reporting Bugs410605
Node: Major Differences From The Bourne Shell411799
Node: GNU Free Documentation License428651
Node: Indexes453828
Node: Builtin Index454282
Node: Reserved Word Index461109
Node: Variable Index463557
Node: Function Index479016
Node: Concept Index492236

End Tag Table
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+4329 -4295
View File
File diff suppressed because it is too large Load Diff
doc/bashbug.0
+5 -4
View File
@@ -1,4 +1,4 @@
BASHBUG(1) BASHBUG(1)
BASHBUG(1) General Commands Manual BASHBUG(1)
@@ -27,8 +27,9 @@ DDEESSCCRRIIPPTTIIOONN
EENNVVIIRROONNMMEENNTT
bbaasshhbbuugg will utilize the following environment variables if they exist:
EEDDIITTOORR Specifies the preferred editor. If EEDDIITTOORR is not set, bbaasshhbbuugg
defaults to eemmaaccss.
EEDDIITTOORR Specifies the preferred editor. If EEDDIITTOORR is not set, bbaasshhbbuugg
attempts to locate a number of alternative editors, including
eemmaaccss, and defaults to vvii.
HHOOMMEE Directory in which the failed bug report is saved if the mail
fails.
@@ -47,4 +48,4 @@ AAUUTTHHOORRSS
GNU Bash-4.0 1998 July 30 BASHBUG(1)
GNU Bash-4.4 2016 February 15 BASHBUG(1)
doc/bashbug.ps
+39 -29
View File
@@ -1,20 +1,20 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Mon Nov 17 17:38:06 2008
%%Creator: groff version 1.22.3
%%CreationDate: Mon Mar 28 15:34:55 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.19 2
%%DocumentSuppliedResources: procset grops 1.22 3
%%Pages: 1
%%PageOrder: Ascend
%%DocumentMedia: Default 595 842 0 () ()
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%%BeginResource: procset grops 1.22 3
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
@@ -72,6 +72,7 @@ exch pop add exch pop
/level0 save def
1 setlinecap
1 setlinejoin
DEFS/BPhook known{DEFS begin BPhook end}if
72 RES div dup scale
LS{
90 rotate
@@ -137,7 +138,10 @@ pop
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
1 index/FID ne
2 index/UniqueID ne
and
{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
@@ -175,8 +179,10 @@ newpath
userdict begin
/showpage{}def
/setpagedevice{}def
mark
}bind def
/PEND{
cleartomark
countdictstack CNT sub{end}repeat
level1 restore
}bind def
@@ -189,17 +195,17 @@ setpacking
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 595 842 ] /ImagingBBox null >> setpagedevice
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
@@ -229,13 +235,14 @@ def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SHB).35 E 347.52(UG\(1\) B)-.1 F
(ASHB)-.35 E(UG\(1\))-.1 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME)
.219 E F0(bashb)108 96 Q(ug \255 report a b)-.2 E(ug in bash)-.2 E F1
(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(bashb)108 124.8 Q(ug)-.2 E F0
([)2.5 E/F3 10/Times-Italic@0 SF(--ver)A(sion)-.1 E F0 2.5(][)C F3
(--help)-2.5 E F0 2.5(][)C F3(email-addr)-2.5 E(ess)-.37 E F0(])A F1
(DESCRIPTION)72 141.6 Q F2(bashb)108 153.6 Q(ug)-.2 E F0 .446
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SHB).35 E 116.13
(UG\(1\) General)-.1 F(Commands Manual)2.5 E -.35(BA)118.63 G(SHB).35 E
(UG\(1\))-.1 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0
(bashb)108 96 Q(ug \255 report a b)-.2 E(ug in bash)-.2 E F1(SYNOPSIS)72
112.8 Q/F2 10/Times-Bold@0 SF(bashb)108 124.8 Q(ug)-.2 E F0([)2.5 E/F3
10/Times-Italic@0 SF(--ver)A(sion)-.1 E F0 2.5(][)C F3(--help)-2.5 E F0
2.5(][)C F3(email-addr)-2.5 E(ess)-.37 E F0(])A F1(DESCRIPTION)72 141.6
Q F2(bashb)108 153.6 Q(ug)-.2 E F0 .446
(is a shell script to help the user compose and mail b)2.947 F .446
(ug reports concerning bash in a standard for)-.2 F(-)-.2 E(mat.)108
165.6 Q F2(bashb)5.961 E(ug)-.2 E F0(in)3.461 E -.2(vo)-.4 G -.1(ke).2 G
@@ -265,20 +272,23 @@ F0(in the in)2.5 E -.2(vo)-.4 G(king user').2 E 2.5(sh)-.55 G
(Fix)5 E(es are encouraged.)-.15 E F1(ENVIR)72 271.2 Q(ONMENT)-.329 E F2
(bashb)108 283.2 Q(ug)-.2 E F0(will utilize the follo)2.5 E(wing en)-.25
E(vironment v)-.4 E(ariables if the)-.25 E 2.5(ye)-.15 G(xist:)-2.65 E
F2(EDIT)108 300 Q(OR)-.18 E F0(Speci\214es the preferred editor)144 312
Q 2.5(.I)-.55 G(f)-2.5 E F4(EDIT)2.5 E(OR)-.162 E F0(is not set,)2.25 E
F2(bashb)2.5 E(ug)-.2 E F0(def)2.5 E(aults to)-.1 E F2(emacs)2.5 E F0(.)
A F2(HOME)108 328.8 Q F0(Directory in which the f)144 340.8 Q(ailed b)
-.1 E(ug report is sa)-.2 E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G
(he mail f)-2.5 E(ails.)-.1 E F2(TMPDIR)108 357.6 Q F0
F2(EDIT)108 300 Q(OR)-.18 E F0 .327(Speci\214es the preferred editor)144
312 R 2.827(.I)-.55 G(f)-2.827 E F4(EDIT)2.827 E(OR)-.162 E F0 .327
(is not set,)2.577 F F2(bashb)2.827 E(ug)-.2 E F0 .328
(attempts to locate a number of alter)2.827 F(-)-.2 E(nati)144 324 Q .3
-.15(ve e)-.25 H(ditors, including).15 E F2(emacs)2.5 E F0 2.5(,a)C
(nd def)-2.5 E(aults to)-.1 E F2(vi)2.5 E F0(.)A F2(HOME)108 340.8 Q F0
(Directory in which the f)144 352.8 Q(ailed b)-.1 E(ug report is sa)-.2
E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G(he mail f)-2.5 E(ails.)-.1 E
F2(TMPDIR)108 369.6 Q F0
(Directory in which to create temporary \214les and directories.)144
369.6 Q F1(SEE ALSO)72 386.4 Q F3(bash)108 398.4 Q F0(\(1\))A F1 -.548
(AU)72 415.2 S(THORS).548 E F0(Brian F)108 427.2 Q(ox, Free Softw)-.15 E
(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 439.2 Q(g)-.18 E
(Chet Rame)108 456 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
381.6 Q F1(SEE ALSO)72 398.4 Q F3(bash)108 410.4 Q F0(\(1\))A F1 -.548
(AU)72 427.2 S(THORS).548 E F0(Brian F)108 439.2 Q(ox, Free Softw)-.15 E
(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 451.2 Q(g)-.18 E
(Chet Rame)108 468 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E(chet@po.cwru.edu)
108 468 Q(GNU Bash-4.0)72 768 Q(1998 July 30)148.175 E(1)203.165 E 0 Cg
EP
108 480 Q(GNU Bash-4.4)72 768 Q(2016 February 15)138.46 E(1)193.45 E 0
Cg EP
%%Trailer
end
%%EOF
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+32 -23
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 4.4, 8 February 2016).
the Bash shell (version 4.4, 28 February 2016).
This is Edition 4.4, last updated 8 February 2016,
This is Edition 4.4, last updated 28 February 2016,
of The GNU Bash Reference Manual,
for Bash, Version 4.4.
@@ -285,10 +285,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
<h1 class="top">Bash Features</h1>
<p>This text is a brief description of the features that are present in
the Bash shell (version 4.4, 8 February 2016).
the Bash shell (version 4.4, 28 February 2016).
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 4.4, last updated 8 February 2016,
<p>This is Edition 4.4, last updated 28 February 2016,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 4.4.
</p>
@@ -3327,7 +3327,7 @@ input (or file descriptor <var>n</var> if <var>n</var> is specified) for a comma
<p>No parameter and variable expansion, command substitution,
arithmetic expansion, or filename expansion is performed on
<var>word</var>. If any characters in <var>word</var> are quoted, the
<var>word</var>. If any part of <var>word</var> is quoted, the
<var>delimiter</var> is the result of quote removal on <var>word</var>,
and the lines in the here-document are not expanded.
If <var>word</var> is unquoted,
@@ -4275,8 +4275,7 @@ less than zero, non-zero otherwise.
<pre class="example">test <var>expr</var>
</pre></div>
<p>Evaluate a conditional express
ion <var>expr</var> and return a status of 0
<p>Evaluate a conditional expression <var>expr</var> and return a status of 0
(true) or 1 (false).
Each operator and operand must be a separate argument.
Expressions are composed of the primaries described below in
@@ -4469,7 +4468,7 @@ results in permissions of <code>755</code>.
<p>Remove each variable or function <var>name</var>.
If the <samp>-v</samp> option is given, each
<var>name</var> refers to a shell variable and that variable is remvoved.
<var>name</var> refers to a shell variable and that variable is removed.
If the <samp>-f</samp> option is given, the <var>name</var>s refer to shell
functions, and the function definition is removed.
If the <samp>-n</samp> option is supplied, and <var>name</var> is a variable with
@@ -6773,11 +6772,14 @@ is readonly.
<a name="index-EXECIGNORE"></a>
</dt>
<dd><p>A colon-separated list of shell patterns (see <a href="#Pattern-Matching">Pattern Matching</a>)
defining the list of filenames to be ignored by command search.
defining the list of filenames to be ignored by command search using
<code>PATH</code>.
Files whose full pathnames match one of these patterns are not considered
executable files for the purposes of completion and command execution.
executable files for the purposes of completion and command execution
via <code>PATH</code> lookup.
This does not affect the behavior of the <code>[</code>, <code>test</code>, and <code>[[</code>
commands.
Full pathnames in the command hash table are not subject to <code>EXECIGNORE</code>.
Use this variable to ignore shared library files that have the executable
bit set, but are not executable files.
The pattern matching honors the setting of the <code>extglob</code> shell
@@ -8078,8 +8080,8 @@ Next: <a href="#Aliases" accesskey="n" rel="next">Aliases</a>, Previous: <a href
<a name="index-arithmetic-evaluation"></a>
<p>The shell allows arithmetic expressions to be evaluated, as one of
the shell expansions or by the <code>let</code> and the <samp>-i</samp> option
to the <code>declare</code> builtins.
the shell expansions or by using the <code>((</code> compound command, the
<code>let</code> builtin, or the <samp>-i</samp> option to the <code>declare</code> builtin.
</p>
<p>Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
@@ -9822,7 +9824,9 @@ The default limit is <code>100</code>.
<p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will convert characters with the
eighth bit set to an <small>ASCII</small> key sequence by stripping the eighth
bit and prefixing an <tt class="key">ESC</tt> character, converting them to a
meta-prefixed key sequence. The default value is &lsquo;<samp>on</samp>&rsquo;.
meta-prefixed key sequence. The default value is &lsquo;<samp>on</samp>&rsquo;, but
will be set to &lsquo;<samp>off</samp>&rsquo; if the locale is one that contains
eight-bit characters.
</p>
</dd>
<dt><code>disable-completion</code></dt>
@@ -9832,6 +9836,13 @@ Completion characters will be inserted into the line as if they had
been mapped to <code>self-insert</code>. The default is &lsquo;<samp>off</samp>&rsquo;.
</p>
</dd>
<dt><code>echo-control-characters</code></dt>
<dd><a name="index-echo_002dcontrol_002dcharacters"></a>
<p>When set to &lsquo;<samp>on</samp>&rsquo;, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard. The default is &lsquo;<samp>on</samp>&rsquo;.
</p>
</dd>
<dt><code>editing-mode</code></dt>
<dd><a name="index-editing_002dmode"></a>
<p>The <code>editing-mode</code> variable controls which default set of
@@ -9852,13 +9863,6 @@ sequence into the mode string.
The default is &lsquo;<samp>@</samp>&rsquo;.
</p>
</dd>
<dt><code>echo-control-characters</code></dt>
<dd><a name="index-echo_002dcontrol_002dcharacters"></a>
<p>When set to &lsquo;<samp>on</samp>&rsquo;, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard. The default is &lsquo;<samp>on</samp>&rsquo;.
</p>
</dd>
<dt><code>enable-bracketed-paste</code></dt>
<dd><a name="index-enable_002dbracketed_002dpaste"></a>
<p>When set to &lsquo;<samp>On</samp>&rsquo;, Readline will configure the terminal in a way
@@ -9904,6 +9908,8 @@ are saved.
If set to a value less than zero, the number of history entries is not
limited.
By default, the number of history entries is not limited.
If an attempt is made to set <var>history-size</var> to a non-numeric value,
the maximum number of history entries will be set to 500.
</p>
</dd>
<dt><code>horizontal-scroll-mode</code></dt>
@@ -9921,8 +9927,9 @@ this variable is set to &lsquo;<samp>off</samp>&rsquo;.
<p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will enable eight-bit input (it
will not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support. The
default value is &lsquo;<samp>off</samp>&rsquo;. The name <code>meta-flag</code> is a
synonym for this variable.
default value is &lsquo;<samp>off</samp>&rsquo;, but Readline will set it to &lsquo;<samp>on</samp>&rsquo; if the
locale contains eight-bit characters.
The name <code>meta-flag</code> is a synonym for this variable.
</p>
</dd>
<dt><code>isearch-terminators</code></dt>
@@ -10010,7 +10017,9 @@ the list. The default is &lsquo;<samp>off</samp>&rsquo;.
<dd><a name="index-output_002dmeta"></a>
<p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is &lsquo;<samp>off</samp>&rsquo;.
sequence.
The default is &lsquo;<samp>off</samp>&rsquo;, but Readline will set it to &lsquo;<samp>on</samp>&rsquo; if the
locale contains eight-bit characters.
</p>
</dd>
<dt><code>page-completions</code></dt>
doc/bashref.info
+253 -245
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.0 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 8 February 2016).
Bash shell (version 4.4, 28 February 2016).
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2016 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 4.4, 8 February 2016). The Bash home page is
Bash shell (version 4.4, 28 February 2016). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -2317,13 +2317,13 @@ command.
DELIMITER
No parameter and variable expansion, command substitution, arithmetic
expansion, or filename expansion is performed on WORD. If any
characters in WORD are quoted, the DELIMITER is the result of quote
removal on WORD, and the lines in the here-document are not expanded.
If WORD is unquoted, all lines of the here-document are subjected to
parameter expansion, command substitution, and arithmetic expansion, the
character sequence '\newline' is ignored, and '\' must be used to quote
the characters '\', '$', and '`'.
expansion, or filename expansion is performed on WORD. If any part of
WORD is quoted, the DELIMITER is the result of quote removal on WORD,
and the lines in the here-document are not expanded. If WORD is
unquoted, all lines of the here-document are subjected to parameter
expansion, command substitution, and arithmetic expansion, the character
sequence '\newline' is ignored, and '\' must be used to quote the
characters '\', '$', and '`'.
If the redirection operator is '<<-', then all leading tab characters
are stripped from input lines and the line containing DELIMITER. This
@@ -3053,7 +3053,7 @@ standard.
'['
test EXPR
Evaluate a conditional express ion EXPR and return a status of 0
Evaluate a conditional expression EXPR and return a status of 0
(true) or 1 (false). Each operator and operand must be a separate
argument. Expressions are composed of the primaries described
below in *note Bash Conditional Expressions::. 'test' does not
@@ -3203,7 +3203,7 @@ standard.
Remove each variable or function NAME. If the '-v' option is
given, each NAME refers to a shell variable and that variable is
remvoved. If the '-f' option is given, the NAMEs refer to shell
removed. If the '-f' option is given, the NAMEs refer to shell
functions, and the function definition is removed. If the '-n'
option is supplied, and NAME is a variable with the NAMEREF
attribute, NAME will be unset rather than the variable it
@@ -4927,14 +4927,16 @@ Variables::).
'EXECIGNORE'
A colon-separated list of shell patterns (*note Pattern Matching::)
defining the list of filenames to be ignored by command search.
Files whose full pathnames match one of these patterns are not
considered executable files for the purposes of completion and
command execution. This does not affect the behavior of the '[',
'test', and '[[' commands. Use this variable to ignore shared
library files that have the executable bit set, but are not
executable files. The pattern matching honors the setting of the
'extglob' shell option.
defining the list of filenames to be ignored by command search
using 'PATH'. Files whose full pathnames match one of these
patterns are not considered executable files for the purposes of
completion and command execution via 'PATH' lookup. This does not
affect the behavior of the '[', 'test', and '[[' commands. Full
pathnames in the command hash table are not subject to
'EXECIGNORE'. Use this variable to ignore shared library files
that have the executable bit set, but are not executable files.
The pattern matching honors the setting of the 'extglob' shell
option.
'FCEDIT'
The editor used as a default by the '-e' option to the 'fc' builtin
@@ -5877,8 +5879,8 @@ File: bashref.info, Node: Shell Arithmetic, Next: Aliases, Prev: Bash Conditi
====================
The shell allows arithmetic expressions to be evaluated, as one of the
shell expansions or by the 'let' and the '-i' option to the 'declare'
builtins.
shell expansions or by using the '((' compound command, the 'let'
builtin, or the '-i' option to the 'declare' builtin.
Evaluation is done in fixed-width integers with no check for
overflow, though division by 0 is trapped and flagged as an error. The
@@ -7225,13 +7227,20 @@ Variable Settings
If set to 'on', Readline will convert characters with the
eighth bit set to an ASCII key sequence by stripping the
eighth bit and prefixing an <ESC> character, converting them
to a meta-prefixed key sequence. The default value is 'on'.
to a meta-prefixed key sequence. The default value is 'on',
but will be set to 'off' if the locale is one that contains
eight-bit characters.
'disable-completion'
If set to 'On', Readline will inhibit word completion.
Completion characters will be inserted into the line as if
they had been mapped to 'self-insert'. The default is 'off'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'editing-mode'
The 'editing-mode' variable controls which default set of key
bindings is used. By default, Readline starts up in Emacs
@@ -7248,11 +7257,6 @@ Variable Settings
embed a terminal control sequence into the mode string. The
default is '@'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'enable-bracketed-paste'
When set to 'On', Readline will configure the terminal in a
way that will enable it to insert each paste into the editing
@@ -7287,7 +7291,9 @@ Variable Settings
list. If set to zero, any existing history entries are
deleted and no new entries are saved. If set to a value less
than zero, the number of history entries is not limited. By
default, the number of history entries is not limited.
default, the number of history entries is not limited. If an
attempt is made to set HISTORY-SIZE to a non-numeric value,
the maximum number of history entries will be set to 500.
'horizontal-scroll-mode'
This variable can be set to either 'on' or 'off'. Setting it
@@ -7300,8 +7306,9 @@ Variable Settings
If set to 'on', Readline will enable eight-bit input (it will
not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support. The
default value is 'off'. The name 'meta-flag' is a synonym for
this variable.
default value is 'off', but Readline will set it to 'on' if
the locale contains eight-bit characters. The name
'meta-flag' is a synonym for this variable.
'isearch-terminators'
The string of characters that should terminate an incremental
@@ -7365,7 +7372,8 @@ Variable Settings
'output-meta'
If set to 'on', Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is 'off'.
sequence. The default is 'off', but Readline will set it to
'on' if the locale contains eight-bit characters.
'page-completions'
If set to 'on', Readline uses an internal 'more'-like pager to
@@ -10824,141 +10832,141 @@ D.3 Parameter and Variable Index
* COPROC: Bash Variables. (line 231)
* DIRSTACK: Bash Variables. (line 235)
* disable-completion: Readline Init File Syntax.
(line 114)
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 135)
(line 121)
* editing-mode: Readline Init File Syntax.
(line 119)
(line 126)
* EMACS: Bash Variables. (line 245)
* emacs-mode-string: Readline Init File Syntax.
(line 125)
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 140)
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 148)
(line 150)
* ENV: Bash Variables. (line 250)
* EUID: Bash Variables. (line 254)
* EXECIGNORE: Bash Variables. (line 258)
* expand-tilde: Readline Init File Syntax.
(line 159)
* FCEDIT: Bash Variables. (line 269)
* FIGNORE: Bash Variables. (line 273)
* FUNCNAME: Bash Variables. (line 279)
* FUNCNEST: Bash Variables. (line 296)
* GLOBIGNORE: Bash Variables. (line 301)
* GROUPS: Bash Variables. (line 308)
* histchars: Bash Variables. (line 314)
* HISTCMD: Bash Variables. (line 329)
* HISTCONTROL: Bash Variables. (line 334)
* HISTFILE: Bash Variables. (line 350)
* HISTFILESIZE: Bash Variables. (line 354)
* HISTIGNORE: Bash Variables. (line 365)
(line 161)
* FCEDIT: Bash Variables. (line 271)
* FIGNORE: Bash Variables. (line 275)
* FUNCNAME: Bash Variables. (line 281)
* FUNCNEST: Bash Variables. (line 298)
* GLOBIGNORE: Bash Variables. (line 303)
* GROUPS: Bash Variables. (line 310)
* histchars: Bash Variables. (line 316)
* HISTCMD: Bash Variables. (line 331)
* HISTCONTROL: Bash Variables. (line 336)
* HISTFILE: Bash Variables. (line 352)
* HISTFILESIZE: Bash Variables. (line 356)
* HISTIGNORE: Bash Variables. (line 367)
* history-preserve-point: Readline Init File Syntax.
(line 163)
(line 165)
* history-size: Readline Init File Syntax.
(line 169)
* HISTSIZE: Bash Variables. (line 385)
* HISTTIMEFORMAT: Bash Variables. (line 392)
(line 171)
* HISTSIZE: Bash Variables. (line 387)
* HISTTIMEFORMAT: Bash Variables. (line 394)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 176)
* HOSTFILE: Bash Variables. (line 400)
* HOSTNAME: Bash Variables. (line 411)
* HOSTTYPE: Bash Variables. (line 414)
(line 180)
* HOSTFILE: Bash Variables. (line 402)
* HOSTNAME: Bash Variables. (line 413)
* HOSTTYPE: Bash Variables. (line 416)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 417)
* IGNOREEOF: Bash Variables. (line 419)
* input-meta: Readline Init File Syntax.
(line 183)
* INPUTRC: Bash Variables. (line 427)
(line 187)
* INPUTRC: Bash Variables. (line 429)
* isearch-terminators: Readline Init File Syntax.
(line 190)
(line 195)
* keymap: Readline Init File Syntax.
(line 197)
* LANG: Bash Variables. (line 431)
* LC_ALL: Bash Variables. (line 435)
* LC_COLLATE: Bash Variables. (line 439)
* LC_CTYPE: Bash Variables. (line 446)
(line 202)
* LANG: Bash Variables. (line 433)
* LC_ALL: Bash Variables. (line 437)
* LC_COLLATE: Bash Variables. (line 441)
* LC_CTYPE: Bash Variables. (line 448)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 451)
* LC_NUMERIC: Bash Variables. (line 455)
* LC_TIME: Bash Variables. (line 459)
* LINENO: Bash Variables. (line 463)
* LINES: Bash Variables. (line 467)
* MACHTYPE: Bash Variables. (line 473)
* LC_MESSAGES <1>: Bash Variables. (line 453)
* LC_NUMERIC: Bash Variables. (line 457)
* LC_TIME: Bash Variables. (line 461)
* LINENO: Bash Variables. (line 465)
* LINES: Bash Variables. (line 469)
* MACHTYPE: Bash Variables. (line 475)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 477)
* MAILCHECK: Bash Variables. (line 479)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 485)
* MAPFILE: Bash Variables. (line 487)
* mark-modified-lines: Readline Init File Syntax.
(line 227)
* mark-symlinked-directories: Readline Init File Syntax.
(line 232)
* match-hidden-files: Readline Init File Syntax.
* mark-symlinked-directories: Readline Init File Syntax.
(line 237)
* match-hidden-files: Readline Init File Syntax.
(line 242)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 244)
(line 249)
* meta-flag: Readline Init File Syntax.
(line 183)
* OLDPWD: Bash Variables. (line 489)
(line 187)
* OLDPWD: Bash Variables. (line 491)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 492)
* OPTERR: Bash Variables. (line 494)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 496)
* OSTYPE: Bash Variables. (line 498)
* output-meta: Readline Init File Syntax.
(line 249)
* page-completions: Readline Init File Syntax.
(line 254)
* page-completions: Readline Init File Syntax.
(line 260)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 499)
* POSIXLY_CORRECT: Bash Variables. (line 504)
* PPID: Bash Variables. (line 513)
* PROMPT_COMMAND: Bash Variables. (line 517)
* PROMPT_DIRTRIM: Bash Variables. (line 521)
* PS0: Bash Variables. (line 527)
* PIPESTATUS: Bash Variables. (line 501)
* POSIXLY_CORRECT: Bash Variables. (line 506)
* PPID: Bash Variables. (line 515)
* PROMPT_COMMAND: Bash Variables. (line 519)
* PROMPT_DIRTRIM: Bash Variables. (line 523)
* PS0: Bash Variables. (line 529)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 532)
* PS4: Bash Variables. (line 537)
* PWD: Bash Variables. (line 543)
* RANDOM: Bash Variables. (line 546)
* READLINE_LINE: Bash Variables. (line 551)
* READLINE_POINT: Bash Variables. (line 555)
* REPLY: Bash Variables. (line 559)
* PS3: Bash Variables. (line 534)
* PS4: Bash Variables. (line 539)
* PWD: Bash Variables. (line 545)
* RANDOM: Bash Variables. (line 548)
* READLINE_LINE: Bash Variables. (line 553)
* READLINE_POINT: Bash Variables. (line 557)
* REPLY: Bash Variables. (line 561)
* revert-all-at-newline: Readline Init File Syntax.
(line 264)
* SECONDS: Bash Variables. (line 562)
* SHELL: Bash Variables. (line 568)
* SHELLOPTS: Bash Variables. (line 573)
* SHLVL: Bash Variables. (line 582)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 270)
* show-all-if-unmodified: Readline Init File Syntax.
* SECONDS: Bash Variables. (line 564)
* SHELL: Bash Variables. (line 570)
* SHELLOPTS: Bash Variables. (line 575)
* SHLVL: Bash Variables. (line 584)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
* show-all-if-unmodified: Readline Init File Syntax.
(line 282)
* show-mode-in-prompt: Readline Init File Syntax.
(line 285)
* skip-completed-text: Readline Init File Syntax.
(line 291)
* skip-completed-text: Readline Init File Syntax.
(line 297)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 587)
* TMOUT: Bash Variables. (line 625)
* TMPDIR: Bash Variables. (line 637)
* UID: Bash Variables. (line 641)
* TIMEFORMAT: Bash Variables. (line 589)
* TMOUT: Bash Variables. (line 627)
* TMPDIR: Bash Variables. (line 639)
* UID: Bash Variables. (line 643)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 304)
(line 310)
* vi-ins-mode-string: Readline Init File Syntax.
(line 314)
(line 320)
* visible-stats: Readline Init File Syntax.
(line 324)
(line 330)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -11320,134 +11328,134 @@ D.5 Concept Index

Tag Table:
Node: Top895
Node: Introduction2813
Node: What is Bash?3029
Node: What is a shell?4143
Node: Definitions6681
Node: Basic Shell Features9632
Node: Shell Syntax10851
Node: Shell Operation11877
Node: Quoting13170
Node: Escape Character14470
Node: Single Quotes14955
Node: Double Quotes15303
Node: ANSI-C Quoting16581
Node: Locale Translation17834
Node: Comments18730
Node: Shell Commands19348
Node: Simple Commands20220
Node: Pipelines20851
Node: Lists23594
Node: Compound Commands25323
Node: Looping Constructs26326
Node: Conditional Constructs28789
Node: Command Grouping39710
Node: Coprocesses41189
Node: GNU Parallel43021
Node: Shell Functions46994
Node: Shell Parameters52200
Node: Positional Parameters56602
Node: Special Parameters57502
Node: Shell Expansions60839
Node: Brace Expansion62776
Node: Tilde Expansion65557
Node: Shell Parameter Expansion67905
Node: Command Substitution82037
Node: Arithmetic Expansion83392
Node: Process Substitution84324
Node: Word Splitting85444
Node: Filename Expansion87388
Node: Pattern Matching89672
Node: Quote Removal93370
Node: Redirections93665
Node: Executing Commands102914
Node: Simple Command Expansion103584
Node: Command Search and Execution105514
Node: Command Execution Environment107850
Node: Environment110834
Node: Exit Status112493
Node: Signals114163
Node: Shell Scripts116130
Node: Shell Builtin Commands118645
Node: Bourne Shell Builtins120679
Node: Bash Builtins141281
Node: Modifying Shell Behavior169911
Node: The Set Builtin170256
Node: The Shopt Builtin180669
Node: Special Builtins196289
Node: Shell Variables197268
Node: Bourne Shell Variables197705
Node: Bash Variables199736
Node: Bash Features228000
Node: Invoking Bash228899
Node: Bash Startup Files234848
Node: Interactive Shells239951
Node: What is an Interactive Shell?240361
Node: Is this Shell Interactive?241010
Node: Interactive Shell Behavior241825
Node: Bash Conditional Expressions245200
Node: Shell Arithmetic249201
Node: Aliases251978
Node: Arrays254526
Node: The Directory Stack259610
Node: Directory Stack Builtins260394
Node: Controlling the Prompt263362
Node: The Restricted Shell266108
Node: Bash POSIX Mode267933
Node: Job Control277845
Node: Job Control Basics278305
Node: Job Control Builtins283024
Node: Job Control Variables287554
Node: Command Line Editing288710
Node: Introduction and Notation290381
Node: Readline Interaction292004
Node: Readline Bare Essentials293195
Node: Readline Movement Commands294978
Node: Readline Killing Commands295938
Node: Readline Arguments297856
Node: Searching298900
Node: Readline Init File301086
Node: Readline Init File Syntax302233
Node: Conditional Init Constructs321997
Node: Sample Init File324522
Node: Bindable Readline Commands327639
Node: Commands For Moving328843
Node: Commands For History329986
Node: Commands For Text334275
Node: Commands For Killing337664
Node: Numeric Arguments340145
Node: Commands For Completion341284
Node: Keyboard Macros345475
Node: Miscellaneous Commands346162
Node: Readline vi Mode351966
Node: Programmable Completion352873
Node: Programmable Completion Builtins360334
Node: A Programmable Completion Example370220
Node: Using History Interactively375472
Node: Bash History Facilities376156
Node: Bash History Builtins379157
Node: History Interaction383154
Node: Event Designators386118
Node: Word Designators387337
Node: Modifiers388974
Node: Installing Bash390376
Node: Basic Installation391513
Node: Compilers and Options394204
Node: Compiling For Multiple Architectures394945
Node: Installation Names396608
Node: Specifying the System Type397426
Node: Sharing Defaults398142
Node: Operation Controls398815
Node: Optional Features399773
Node: Reporting Bugs410030
Node: Major Differences From The Bourne Shell411224
Node: GNU Free Documentation License428076
Node: Indexes453253
Node: Builtin Index453707
Node: Reserved Word Index460534
Node: Variable Index462982
Node: Function Index478441
Node: Concept Index491661
Node: Top897
Node: Introduction2817
Node: What is Bash?3033
Node: What is a shell?4147
Node: Definitions6685
Node: Basic Shell Features9636
Node: Shell Syntax10855
Node: Shell Operation11881
Node: Quoting13174
Node: Escape Character14474
Node: Single Quotes14959
Node: Double Quotes15307
Node: ANSI-C Quoting16585
Node: Locale Translation17838
Node: Comments18734
Node: Shell Commands19352
Node: Simple Commands20224
Node: Pipelines20855
Node: Lists23598
Node: Compound Commands25327
Node: Looping Constructs26330
Node: Conditional Constructs28793
Node: Command Grouping39714
Node: Coprocesses41193
Node: GNU Parallel43025
Node: Shell Functions46998
Node: Shell Parameters52204
Node: Positional Parameters56606
Node: Special Parameters57506
Node: Shell Expansions60843
Node: Brace Expansion62780
Node: Tilde Expansion65561
Node: Shell Parameter Expansion67909
Node: Command Substitution82041
Node: Arithmetic Expansion83396
Node: Process Substitution84328
Node: Word Splitting85448
Node: Filename Expansion87392
Node: Pattern Matching89676
Node: Quote Removal93374
Node: Redirections93669
Node: Executing Commands102912
Node: Simple Command Expansion103582
Node: Command Search and Execution105512
Node: Command Execution Environment107848
Node: Environment110832
Node: Exit Status112491
Node: Signals114161
Node: Shell Scripts116128
Node: Shell Builtin Commands118643
Node: Bourne Shell Builtins120677
Node: Bash Builtins141277
Node: Modifying Shell Behavior169907
Node: The Set Builtin170252
Node: The Shopt Builtin180665
Node: Special Builtins196285
Node: Shell Variables197264
Node: Bourne Shell Variables197701
Node: Bash Variables199732
Node: Bash Features228112
Node: Invoking Bash229011
Node: Bash Startup Files234960
Node: Interactive Shells240063
Node: What is an Interactive Shell?240473
Node: Is this Shell Interactive?241122
Node: Interactive Shell Behavior241937
Node: Bash Conditional Expressions245312
Node: Shell Arithmetic249313
Node: Aliases252130
Node: Arrays254678
Node: The Directory Stack259762
Node: Directory Stack Builtins260546
Node: Controlling the Prompt263514
Node: The Restricted Shell266260
Node: Bash POSIX Mode268085
Node: Job Control277997
Node: Job Control Basics278457
Node: Job Control Builtins283176
Node: Job Control Variables287706
Node: Command Line Editing288862
Node: Introduction and Notation290533
Node: Readline Interaction292156
Node: Readline Bare Essentials293347
Node: Readline Movement Commands295130
Node: Readline Killing Commands296090
Node: Readline Arguments298008
Node: Searching299052
Node: Readline Init File301238
Node: Readline Init File Syntax302385
Node: Conditional Init Constructs322572
Node: Sample Init File325097
Node: Bindable Readline Commands328214
Node: Commands For Moving329418
Node: Commands For History330561
Node: Commands For Text334850
Node: Commands For Killing338239
Node: Numeric Arguments340720
Node: Commands For Completion341859
Node: Keyboard Macros346050
Node: Miscellaneous Commands346737
Node: Readline vi Mode352541
Node: Programmable Completion353448
Node: Programmable Completion Builtins360909
Node: A Programmable Completion Example370795
Node: Using History Interactively376047
Node: Bash History Facilities376731
Node: Bash History Builtins379732
Node: History Interaction383729
Node: Event Designators386693
Node: Word Designators387912
Node: Modifiers389549
Node: Installing Bash390951
Node: Basic Installation392088
Node: Compilers and Options394779
Node: Compiling For Multiple Architectures395520
Node: Installation Names397183
Node: Specifying the System Type398001
Node: Sharing Defaults398717
Node: Operation Controls399390
Node: Optional Features400348
Node: Reporting Bugs410605
Node: Major Differences From The Bourne Shell411799
Node: GNU Free Documentation License428651
Node: Indexes453828
Node: Builtin Index454282
Node: Reserved Word Index461109
Node: Variable Index463557
Node: Function Index479016
Node: Concept Index492236

End Tag Table
doc/bashref.log
+12 -12
View File
@@ -1,4 +1,4 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/MacPorts 2015_7) (preloaded format=pdfetex 2015.7.15) 8 FEB 2016 10:18
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/MacPorts 2015_7) (preloaded format=pdfetex 2015.7.15) 29 MAR 2016 09:29
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
@@ -241,7 +241,7 @@ arallel -k traceroute[]
[41] [42] [43]
[44] [45] [46] [47] [48] [49] [50] [51] [52] [53]
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4261--4261
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4260--4260
[]@texttt mapfile [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ] [
-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl f
d@texttt ][]
@@ -255,7 +255,7 @@ d@texttt ][]
.etc.
[54] [55]
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4465--4465
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4464--4464
[]@texttt readarray [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ]
[-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl
fd@texttt ][]
@@ -270,7 +270,7 @@ Overfull \hbox (38.26584pt too wide) in paragraph at lines 4465--4465
[56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67] [68] Chapter 5
[69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] Chapter 6 [80]
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6171--6171
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6173--6173
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -283,7 +283,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6172--6172
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6174--6174
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -297,7 +297,7 @@ Overfull \hbox (72.42863pt too wide) in paragraph at lines 6172--6172
.etc.
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6173--6173
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6175--6175
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -316,7 +316,7 @@ texinfo.tex: doing @include of rluser.texi
(/usr/homes/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [102]
[103] [104] [105] [106] [107] [108] [109] [110] [111] [112]
Underfull \hbox (badness 7540) in paragraph at lines 795--801
Underfull \hbox (badness 7540) in paragraph at lines 802--808
[]@textrm In the above ex-am-ple, @textttsl C-u[] @textrm is bound to the func
-tion
@@ -329,7 +329,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 795--801
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 795--801
Underfull \hbox (badness 10000) in paragraph at lines 802--808
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -342,7 +342,7 @@ e func-tion
.etc.
[113] [114] [115]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 990--990
Overfull \hbox (26.43913pt too wide) in paragraph at lines 997--997
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -360,7 +360,7 @@ gnored[]
[118] [119] [120] [121] [122] [123] [124] [125] [126] [127]
[128] [129] [130] [131] [132] [133]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 2226--2226
Overfull \hbox (26.43913pt too wide) in paragraph at lines 2233--2233
[] @texttt # Tilde expansion, with side effect of expanding tilde to full p
athname[]
@@ -398,7 +398,7 @@ Overfull \vbox (2.87483pt too high) has occurred while \output is active
Here is how much of TeX's memory you used:
4059 strings out of 497110
46657 string characters out of 6206872
138667 words of memory out of 5000000
138669 words of memory out of 5000000
4845 multiletter control sequences out of 15000+600000
33547 words of font info for 115 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
@@ -419,7 +419,7 @@ hare/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/
texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf
-texlive/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texli
ve/fonts/type1/public/cm-super/sfrm1095.pfb>
Output written on bashref.pdf (177 pages, 730636 bytes).
Output written on bashref.pdf (177 pages, 731245 bytes).
PDF statistics:
2569 PDF objects out of 2984 (max. 8388607)
2348 compressed objects within 24 object streams
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1037 -1020
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+6 -2
View File
@@ -6754,8 +6754,8 @@ may be positive or negative integers.
@cindex arithmetic evaluation
The shell allows arithmetic expressions to be evaluated, as one of
the shell expansions or by the @code{let} and the @option{-i} option
to the @code{declare} builtins.
the shell expansions or by using the @code{((} compound command, the
@code{let} builtin, or the @option{-i} option to the @code{declare} builtin.
Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
@@ -7568,6 +7568,10 @@ has been set.
If Bash receives a trapped signal while executing @code{read}, the trap
handler executes and @code{read} returns an exit status greater than 128.
@item
Bash removes an exited background process's status from the list of such
statuses after the @code{wait} builtin is used to obtain it.
@end enumerate
There is other @sc{posix} behavior that Bash does not implement by
doc/bashref.vr
+1 -1
View File
@@ -133,9 +133,9 @@
\entry{completion-query-items}{108}{\code {completion-query-items}}
\entry{convert-meta}{108}{\code {convert-meta}}
\entry{disable-completion}{108}{\code {disable-completion}}
\entry{echo-control-characters}{108}{\code {echo-control-characters}}
\entry{editing-mode}{108}{\code {editing-mode}}
\entry{emacs-mode-string}{108}{\code {emacs-mode-string}}
\entry{echo-control-characters}{109}{\code {echo-control-characters}}
\entry{enable-bracketed-paste}{109}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{109}{\code {enable-keypad}}
\entry{expand-tilde}{109}{\code {expand-tilde}}
doc/bashref.vrs
+1 -1
View File
@@ -76,7 +76,7 @@
\entry {\code {DIRSTACK}}{74}
\entry {\code {disable-completion}}{108}
\initial {E}
\entry {\code {echo-control-characters}}{109}
\entry {\code {echo-control-characters}}{108}
\entry {\code {editing-mode}}{108}
\entry {\code {emacs-mode-string}}{108}
\entry {\code {EMACS}}{74}
doc/builtins.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Feb 8 10:16:53 2016
%%CreationDate: Mon Mar 28 15:34:56 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Feb 8 10:16:54 2016
%%CreationDate: Mon Mar 28 15:34:56 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 3
jobs.c
+2
View File
@@ -4679,6 +4679,8 @@ set_maxchild (nchild)
{
static int lmaxchild = -1;
itrace("set_maxchild (%d)", nchild);
if (lmaxchild < 0)
lmaxchild = getmaxchild ();
if (lmaxchild < 0)
lib/readline/display.c
+1 -1
View File
@@ -826,7 +826,7 @@ rl_redisplay ()
lpos -= _rl_col_width (local_prompt, n0, num, 1) - wadjust;
else
#endif
lpos -= _rl_screenwidth - wadjust;
lpos -= _rl_screenwidth; /* all physical cursor positions */
}
prompt_last_screen_line = newlines;
parse.y
+129 -8
View File
@@ -3318,7 +3318,8 @@ tokword:
#define LEX_INHEREDOC 0x080
#define LEX_HEREDELIM 0x100 /* reading here-doc delimiter */
#define LEX_STRIPDOC 0x200 /* <<- strip tabs from here doc delim */
#define LEX_INWORD 0x400
#define LEX_QUOTEDDOC 0x400 /* here doc with quoted delim */
#define LEX_INWORD 0x800
#define COMSUB_META(ch) ((ch) == ';' || (ch) == '&' || (ch) == '|')
@@ -3610,6 +3611,81 @@ parse_dollar_word:
return ret;
}
#if defined (DEBUG)
static void
dump_tflags (flags)
int flags;
{
int f;
f = flags;
fprintf (stderr, "%d -> ", f);
if (f & LEX_WASDOL)
{
f &= ~LEX_WASDOL;
fprintf (stderr, "LEX_WASDOL%s", f ? "|" : "");
}
if (f & LEX_CKCOMMENT)
{
f &= ~LEX_CKCOMMENT;
fprintf (stderr, "LEX_CKCOMMENT%s", f ? "|" : "");
}
if (f & LEX_INCOMMENT)
{
f &= ~LEX_INCOMMENT;
fprintf (stderr, "LEX_INCOMMENT%s", f ? "|" : "");
}
if (f & LEX_PASSNEXT)
{
f &= ~LEX_PASSNEXT;
fprintf (stderr, "LEX_PASSNEXT%s", f ? "|" : "");
}
if (f & LEX_RESWDOK)
{
f &= ~LEX_RESWDOK;
fprintf (stderr, "LEX_RESWDOK%s", f ? "|" : "");
}
if (f & LEX_CKCASE)
{
f &= ~LEX_CKCASE;
fprintf (stderr, "LEX_CKCASE%s", f ? "|" : "");
}
if (f & LEX_INCASE)
{
f &= ~LEX_INCASE;
fprintf (stderr, "LEX_INCASE%s", f ? "|" : "");
}
if (f & LEX_INHEREDOC)
{
f &= ~LEX_INHEREDOC;
fprintf (stderr, "LEX_INHEREDOC%s", f ? "|" : "");
}
if (f & LEX_HEREDELIM)
{
f &= ~LEX_HEREDELIM;
fprintf (stderr, "LEX_HEREDELIM%s", f ? "|" : "");
}
if (f & LEX_STRIPDOC)
{
f &= ~LEX_STRIPDOC;
fprintf (stderr, "LEX_WASDOL%s", f ? "|" : "");
}
if (f & LEX_QUOTEDDOC)
{
f &= ~LEX_QUOTEDDOC;
fprintf (stderr, "LEX_QUOTEDDOC%s", f ? "|" : "");
}
if (f & LEX_INWORD)
{
f &= ~LEX_INWORD;
fprintf (stderr, "LEX_INWORD%s", f ? "|" : "");
}
fprintf (stderr, "\n");
fflush (stderr);
}
#endif
/* Parse a $(...) command substitution. This is messier than I'd like, and
reproduces a lot more of the token-reading code than I'd like. */
static char *
@@ -3687,7 +3763,7 @@ eof_error:
tind++;
if (STREQN (ret + tind, heredelim, hdlen))
{
tflags &= ~(LEX_STRIPDOC|LEX_INHEREDOC);
tflags &= ~(LEX_STRIPDOC|LEX_INHEREDOC|LEX_QUOTEDDOC);
/*itrace("parse_comsub:%d: found here doc end `%s'", line_number, ret + tind);*/
free (heredelim);
heredelim = 0;
@@ -3707,21 +3783,29 @@ eof_error:
if ((tflags & LEX_INHEREDOC) && ch == close && count == 1)
{
int tind;
/*itrace("parse_comsub: in here doc, ch == close, retind - firstind = %d hdlen = %d retind = %d", retind-lex_firstind, hdlen, retind);*/
/*itrace("parse_comsub:%d: in here doc, ch == close, retind - firstind = %d hdlen = %d retind = %d", line_number, retind-lex_firstind, hdlen, retind);*/
tind = lex_firstind;
while ((tflags & LEX_STRIPDOC) && ret[tind] == '\t')
tind++;
if (retind-tind == hdlen && STREQN (ret + tind, heredelim, hdlen))
{
tflags &= ~(LEX_STRIPDOC|LEX_INHEREDOC);
/*itrace("parse_comsub:%d: found here doc end `%s'", line_number, ret + tind);*/
tflags &= ~(LEX_STRIPDOC|LEX_INHEREDOC|LEX_QUOTEDDOC);
/*itrace("parse_comsub:%d: found here doc end `%*s'", line_number, hdlen, ret + tind);*/
free (heredelim);
heredelim = 0;
lex_firstind = -1;
}
}
/* Don't bother counting parens or doing anything else if in a comment */
/* Don't bother counting parens or doing anything else if in a comment or
here document (not exactly right for here-docs -- if we want to allow
recursive calls to parse_comsub to have their own here documents,
change the LEX_INHEREDOC to LEX_QUOTEDDOC here and uncomment the next
clause below. Note that to make this work completely, we need to make
additional changes to allow xparse_dolparen to work right when the
command substitution is parsed, because read_secondary_line doesn't know
to recursively parse through command substitutions embedded in here-
documents */
if (tflags & (LEX_INCOMMENT|LEX_INHEREDOC))
{
/* Add this character. */
@@ -3736,6 +3820,21 @@ eof_error:
continue;
}
#if 0
/* If we're going to recursively parse a command substitution inside a
here-document, make sure we call parse_comsub recursively below. See
above for additional caveats. */
if ((tflags & LEX_INHEREDOC) && ((tflags & LEX_WASDOL) == 0 || ch != '(')) /*)*/
{
/* Add this character. */
RESIZE_MALLOCED_BUFFER (ret, retind, 1, retsize, 64);
ret[retind++] = ch;
if MBTEST(ch == '$')
tflags |= LEX_WASDOL;
else
tflags &= ~LEX_WASDOL;
}
#endif
if (tflags & LEX_PASSNEXT) /* last char was backslash */
{
@@ -3816,6 +3915,8 @@ eof_error:
free (nestret);
hdlen = STRLEN(heredelim);
/*itrace("parse_comsub:%d: found here doc delimiter `%s' (%d)", line_number, heredelim, hdlen);*/
if (STREQ (heredelim, nestret) == 0)
tflags |= LEX_QUOTEDDOC;
}
if (ch == '\n')
{
@@ -3878,14 +3979,34 @@ eof_error:
if (STREQN (ret + retind - 4, "case", 4))
{
tflags |= LEX_INCASE;
tflags &= ~LEX_RESWDOK;
/*itrace("parse_comsub:%d: found `case', lex_incase -> 1 lex_reswdok -> 0", line_number);*/
}
else if (STREQN (ret + retind - 4, "esac", 4))
{
tflags &= ~LEX_INCASE;
/*itrace("parse_comsub:%d: found `esac', lex_incase -> 0 lex_reswdok -> 0", line_number);*/
/*itrace("parse_comsub:%d: found `esac', lex_incase -> 0 lex_reswdok -> 1", line_number);*/
tflags |= LEX_RESWDOK;
lex_rwlen = 0;
}
else if (STREQN (ret + retind - 4, "done", 4) ||
STREQN (ret + retind - 4, "then", 4) ||
STREQN (ret + retind - 4, "else", 4) ||
STREQN (ret + retind - 4, "elif", 4) ||
STREQN (ret + retind - 4, "time", 4))
{
/* these are four-character reserved words that can be
followed by a reserved word; anything else turns off
the reserved-word-ok flag */
/*itrace("parse_comsub:%d: found `%.4s', lex_reswdok -> 1", line_number, ret+retind-4);*/
tflags |= LEX_RESWDOK;
lex_rwlen = 0;
}
else
{
tflags &= ~LEX_RESWDOK;
/*itrace("parse_comsub:%d: found `%.4s', lex_reswdok -> 0", line_number, ret+retind-4);*/
}
tflags &= ~LEX_RESWDOK;
}
else if MBTEST((tflags & LEX_CKCOMMENT) && ch == '#' && (lex_rwlen == 0 || ((tflags & LEX_INWORD) && lex_wlen == 0)))
; /* don't modify LEX_RESWDOK if we're starting a comment */
tests/RUN-ONE-TEST
+1 -1
View File
@@ -1,4 +1,4 @@
BUILD_DIR=/usr/local/build/chet/bash/bash-current
BUILD_DIR=/usr/local/build/bash/bash-current
THIS_SH=$BUILD_DIR/bash
PATH=$PATH:$BUILD_DIR
tests/comsub.right
+16
View File
@@ -32,3 +32,19 @@ xyz
/tmp/foo/bar
/tmp/foo/bar
/tmp/foo/bar
1
2
3
4
5
6
5
6
a
b
c
a
b
c
1
2
tests/comsub.tests
+1
View File
@@ -46,3 +46,4 @@ echo ${foo:-$(echo a{b,c})} >/dev/null
${THIS_SH} ./comsub1.sub
${THIS_SH} ./comsub2.sub
${THIS_SH} ./comsub3.sub
tests/comsub3.sub
+31
View File
@@ -0,0 +1,31 @@
x=$(
case 1 in
1) echo 1
esac
case 2 in
2) echo 2
esac
)
echo "$x"
x=$(case 1 in 1) echo 3;; esac; case 2 in 2) echo 4;; esac;)
echo "$x"
x=$(case 1 in 1) echo 5;; esac; case 2 in 2) echo 6;; esac)
echo "$x"
x=$(case 1 in 1) echo 5;; esac; case 2 in 2) echo 6;; esac; for f in a b c; do echo "$f" ; done)
echo "$x"
x=$(
for f in a b c; do
echo $f
done
case 1 in
1) echo 1
esac
case 2 in
2) echo 2
esac
)
echo "$x"