diff --git a/doc/bash.0 b/doc/bash.0 index 7f6504aa..c5b9026a 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -6043,8 +6043,8 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS _n_a_m_e will be unset rather than the variable it references. --nn has no effect if the --ff option is supplied. If no options are supplied, each _n_a_m_e refers to a variable; if there is no vari- - able by that name, any function with that name is unset. Each - unset variable or function is removed from the environment + able by that name, a function with that name, if any, is unset. + Each unset variable or function is removed from the environment passed to subsequent commands. If any of BBAASSHH__AALLIIAASSEESS, BBAASSHH__AARRGGVV00, BBAASSHH__CCMMDDSS, BBAASSHH__CCOOMMMMAANNDD, BBAASSHH__SSUUBBSSHHEELLLL, BBAASSHHPPIIDD, CCOOMMPP__WWOORRDDBBRREEAAKKSS, DDIIRRSSTTAACCKK, EEPPOOCCHHRREEAALLTTIIMMEE, EEPPOOCCHHSSEECCOONNDDSS, FFUUNNCC-- diff --git a/doc/bash.html b/doc/bash.html index 6db72eb5..b01e3d81 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -13663,7 +13663,7 @@ attribute, name will be unset rather than the variable it references. -n has no effect if the -f option is supplied. If no options are supplied, each name refers to a variable; if -there is no variable by that name, any function with that name is +there is no variable by that name, a function with that name, if any, is unset. Each unset variable or function is removed from the environment passed to subsequent commands. @@ -14150,6 +14150,6 @@ There may be only one active coprocess at a time.
This document was created by man2html from bash.1.
-Time: 26 November 2019 11:18:28 EST +Time: 06 January 2020 08:53:48 EST diff --git a/doc/bash.info b/doc/bash.info index c55464c9..89d92e50 100644 --- a/doc/bash.info +++ b/doc/bash.info @@ -3332,9 +3332,9 @@ standard. attribute, NAME will be unset rather than the variable it references. '-n' has no effect if the '-f' option is supplied. If no options are supplied, each NAME refers to a variable; if there - is no variable by that name, any function with that name is unset. - Readonly variables and functions may not be unset. Some shell - variables lose their special behavior if they are unset; such + is no variable by that name, a function with that name, if any, is + unset. Readonly variables and functions may not be unset. Some + shell variables lose their special behavior if they are unset; such behavior is noted in the description of the individual variables. The return status is zero unless a NAME is readonly. @@ -3884,7 +3884,7 @@ standard. from regular files. If 'read' times out, 'read' saves any partial input read into the specified variable NAME. If TIMEOUT is 0, 'read' returns immediately, without trying to - read and data. The exit status is 0 if input is available on + read any data. The exit status is 0 if input is available on the specified file descriptor, non-zero otherwise. The exit status is greater than 128 if the timeout is exceeded. @@ -9335,7 +9335,7 @@ history file. In the second form, COMMAND is re-executed after each instance of PAT in the selected command is replaced by REP. COMMAND is - intepreted the same as FIRST above. + interpreted the same as FIRST above. A useful alias to use with the 'fc' command is 'r='fc -s'', so that typing 'r cc' runs the last command beginning with 'cc' and typing @@ -11822,84 +11822,84 @@ 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 +Node: Bash Builtins146978 +Node: Modifying Shell Behavior175903 +Node: The Set Builtin176248 +Node: The Shopt Builtin186661 +Node: Special Builtins204331 +Node: Shell Variables205310 +Node: Bourne Shell Variables205747 +Node: Bash Variables207851 +Node: Bash Features239793 +Node: Invoking Bash240692 +Node: Bash Startup Files246705 +Node: Interactive Shells251808 +Node: What is an Interactive Shell?252218 +Node: Is this Shell Interactive?252867 +Node: Interactive Shell Behavior253682 +Node: Bash Conditional Expressions257169 +Node: Shell Arithmetic261746 +Node: Aliases264686 +Node: Arrays267306 +Node: The Directory Stack272671 +Node: Directory Stack Builtins273455 +Node: Controlling the Prompt276423 +Node: The Restricted Shell279344 +Node: Bash POSIX Mode281826 +Node: Job Control292759 +Node: Job Control Basics293219 +Node: Job Control Builtins298183 +Node: Job Control Variables303329 +Node: Command Line Editing304485 +Node: Introduction and Notation306156 +Node: Readline Interaction307779 +Node: Readline Bare Essentials308970 +Node: Readline Movement Commands310753 +Node: Readline Killing Commands311713 +Node: Readline Arguments313631 +Node: Searching314675 +Node: Readline Init File316861 +Node: Readline Init File Syntax318120 +Node: Conditional Init Constructs338650 +Node: Sample Init File342846 +Node: Bindable Readline Commands345963 +Node: Commands For Moving347167 +Node: Commands For History349026 +Node: Commands For Text353321 +Node: Commands For Killing356709 +Node: Numeric Arguments359524 +Node: Commands For Completion360663 +Node: Keyboard Macros364854 +Node: Miscellaneous Commands365541 +Node: Readline vi Mode371494 +Node: Programmable Completion372401 +Node: Programmable Completion Builtins380181 +Node: A Programmable Completion Example390876 +Node: Using History Interactively396123 +Node: Bash History Facilities396807 +Node: Bash History Builtins399812 +Node: History Interaction404344 +Node: Event Designators407964 +Node: Word Designators409318 +Node: Modifiers411078 +Node: Installing Bash412889 +Node: Basic Installation414026 +Node: Compilers and Options417284 +Node: Compiling For Multiple Architectures418025 +Node: Installation Names419718 +Node: Specifying the System Type420536 +Node: Sharing Defaults421252 +Node: Operation Controls421925 +Node: Optional Features422883 +Node: Reporting Bugs433401 +Node: Major Differences From The Bourne Shell434595 +Node: GNU Free Documentation License451447 +Node: Indexes476624 +Node: Builtin Index477078 +Node: Reserved Word Index483905 +Node: Variable Index486353 +Node: Function Index502177 +Node: Concept Index515616  End Tag Table diff --git a/doc/bash.pdf b/doc/bash.pdf index d98df249..b797c9d6 100644 Binary files a/doc/bash.pdf and b/doc/bash.pdf differ diff --git a/doc/bash.ps b/doc/bash.ps index 5a6d9cba..33af6747 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Tue Nov 26 11:15:40 2019 +%%CreationDate: Mon Jan 6 08:53:34 2020 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -9640,37 +9640,36 @@ F0 .404(option is supplied, and)2.904 F F2(name)2.904 E F0 .404(is a v) .72(rather than the v)144 427.2 R .72(ariable it references.)-.25 F F1 5.72 E F0 .72(has no ef)3.22 F .719(fect if the)-.25 F F1 3.219 E F0 .719(option is supplied.)3.219 F .719(If no options)5.719 F -.189(are supplied, each)144 439.2 R F2(name)2.689 E F0 .189 -(refers to a v)2.689 F .189(ariable; if there is no v)-.25 F .19 -(ariable by that name, an)-.25 F 2.69(yf)-.15 G .19(unction with)-2.69 F -1.116(that name is unset.)144 451.2 R 1.116(Each unset v)6.116 F 1.115 -(ariable or function is remo)-.25 F -.15(ve)-.15 G 3.615(df).15 G 1.115 -(rom the en)-3.615 F 1.115(vironment passed to)-.4 F 1.5 -(subsequent commands.)144 463.2 R 1.501(If an)6.5 F 4.001(yo)-.15 G(f) --4.001 E/F3 9/Times-Bold@0 SF -.27(BA)4.001 G(SH_ALIASES).27 E/F4 9 -/Times-Roman@0 SF(,)A F3 -.27(BA)3.751 G(SH_ARGV0).27 E F4(,)A F3 -.27 -(BA)3.751 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)3.751 G(SH_COM-).27 E(MAND) -144 475.2 Q F4(,)A F3 -.27(BA)2.846 G(SH_SUBSHELL).27 E F4(,)A F3 -.27 -(BA)2.846 G(SHPID).27 E F4(,)A F3(COMP_W)2.846 E(ORDBREAKS)-.09 E F4(,)A -F3(DIRST)2.846 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL)2.845 E -(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)144 487.2 Q F4(,)A F3(FUNCN)6.48 E -(AME)-.18 E F4(,)A F3(GR)6.48 E(OUPS)-.27 E F4(,)A F3(HISTCMD)6.48 E F4 -(,)A F3(LINENO)6.481 E F4(,)A F3(RANDOM)6.481 E F4(,)A F3(SECONDS)6.481 -E F4(,)A F0(or)6.481 E F3(SRANDOM)144 499.2 Q F0 .832(are unset, the) -3.082 F 3.332(yl)-.15 G .832(ose their special properties, e)-3.332 F --.15(ve)-.25 G 3.332(ni).15 G 3.332(ft)-3.332 G(he)-3.332 E 3.332(ya) --.15 G .832(re subsequently reset.)-3.332 F(The)5.831 E -.15(ex)144 -511.2 S(it status is true unless a).15 E F2(name)2.86 E F0(is readonly) -2.68 E(.)-.65 E F1(wait)108 528 Q F0([)2.5 E F1(\255fn)A F0 2.5(][)C F1 --2.5 E F2(varname)2.5 E F0 2.5(][)C F2(id ...)-2.5 E F0(])A -.8 -(Wa)144 540 S .659(it for each speci\214ed child process and return its\ - termination status.).8 F(Each)5.659 E F2(id)3.169 E F0 .659 -(may be a process)3.929 F .009 -(ID or a job speci\214cation; if a job spec is gi)144 552 R -.15(ve)-.25 -G .008(n, all processes in that job').15 F 2.508(sp)-.55 G .008 -(ipeline are w)-2.508 F .008(aited for)-.1 F 5.008(.I)-.55 G(f)-5.008 E -F2(id)144.01 564 Q F0 .441(is not gi)3.711 F -.15(ve)-.25 G(n,).15 E F1 -(wait)2.941 E F0 -.1(wa)2.941 G .441 +.736(are supplied, each)144 439.2 R F2(name)3.236 E F0 .736 +(refers to a v)3.236 F .737(ariable; if there is no v)-.25 F .737 +(ariable by that name, a function with)-.25 F 1.762(that name, if an)144 +451.2 R 3.062 -.65(y, i)-.15 H 4.262(su).65 G 4.261(nset. Each)-4.262 F +1.761(unset v)4.261 F 1.761(ariable or function is remo)-.25 F -.15(ve) +-.15 G 4.261(df).15 G 1.761(rom the en)-4.261 F(vironment)-.4 E 3.171 +(passed to subsequent commands.)144 463.2 R 3.172(If an)8.172 F 5.672 +(yo)-.15 G(f)-5.672 E/F3 9/Times-Bold@0 SF -.27(BA)5.672 G(SH_ALIASES) +.27 E/F4 9/Times-Roman@0 SF(,)A F3 -.27(BA)5.422 G(SH_ARGV0).27 E F4(,)A +F3 -.27(BA)5.422 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)144 475.2 S +(SH_COMMAND).27 E F4(,)A F3 -.27(BA)11.482 G(SH_SUBSHELL).27 E F4(,)A F3 +-.27(BA)11.482 G(SHPID).27 E F4(,)A F3(COMP_W)11.482 E(ORDBREAKS)-.09 E +F4(,)A F3(DIRST)11.481 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL) +144 487.2 Q(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)2.67 E F4(,)A F3(FUNCN) +2.67 E(AME)-.18 E F4(,)A F3(GR)2.67 E(OUPS)-.27 E F4(,)A F3(HISTCMD)2.67 +E F4(,)A F3(LINENO)2.67 E F4(,)A F3(RANDOM)2.67 E F4(,)A F3(SECONDS)144 +499.2 Q F4(,)A F0(or)4.03 E F3(SRANDOM)4.28 E F0 1.779(are unset, the) +4.03 F 4.279(yl)-.15 G 1.779(ose their special properties, e)-4.279 F +-.15(ve)-.25 G 4.279(ni).15 G 4.279(ft)-4.279 G(he)-4.279 E 4.279(ya) +-.15 G 1.779(re subse-)-4.279 F(quently reset.)144 511.2 Q(The e)5 E +(xit status is true unless a)-.15 E F2(name)2.86 E F0(is readonly)2.68 E +(.)-.65 E F1(wait)108 528 Q F0([)2.5 E F1(\255fn)A F0 2.5(][)C F1 +-2.5 E F2(varname)2.5 E F0 2.5(][)C F2(id ...)-2.5 E F0(])A -.8(Wa)144 +540 S .659(it for each speci\214ed child process and return its termina\ +tion status.).8 F(Each)5.659 E F2(id)3.169 E F0 .659(may be a process) +3.929 F .009(ID or a job speci\214cation; if a job spec is gi)144 552 R +-.15(ve)-.25 G .008(n, all processes in that job').15 F 2.508(sp)-.55 G +.008(ipeline are w)-2.508 F .008(aited for)-.1 F 5.008(.I)-.55 G(f) +-5.008 E F2(id)144.01 564 Q F0 .441(is not gi)3.711 F -.15(ve)-.25 G(n,) +.15 E F1(wait)2.941 E F0 -.1(wa)2.941 G .441 (its for all running background jobs and the last-e).1 F -.15(xe)-.15 G .442(cuted process substitu-).15 F .598 (tion, if its process id is the same as)144 576 R F1($!)3.098 E F0 3.098 diff --git a/doc/bashref.aux b/doc/bashref.aux index 59572fde..34cffe01 100644 --- a/doc/bashref.aux +++ b/doc/bashref.aux @@ -162,7 +162,7 @@ @xrdef{The Shopt Builtin-pg}{66} @xrdef{Special Builtins-title}{Special Builtins} @xrdef{Special Builtins-snt}{Section@tie 4.4} -@xrdef{Special Builtins-pg}{72} +@xrdef{Special Builtins-pg}{73} @xrdef{Shell Variables-title}{Shell Variables} @xrdef{Shell Variables-snt}{Chapter@tie 5} @xrdef{Bourne Shell Variables-title}{Bourne Shell Variables} diff --git a/doc/bashref.bt b/doc/bashref.bt index 725ea2c2..1dc47c58 100644 --- a/doc/bashref.bt +++ b/doc/bashref.bt @@ -29,7 +29,7 @@ \entry{enable}{56}{\code {enable}} \entry{help}{56}{\code {help}} \entry{let}{56}{\code {let}} -\entry{local}{56}{\code {local}} +\entry{local}{57}{\code {local}} \entry{logout}{57}{\code {logout}} \entry{mapfile}{57}{\code {mapfile}} \entry{printf}{57}{\code {printf}} @@ -38,7 +38,7 @@ \entry{source}{60}{\code {source}} \entry{type}{60}{\code {type}} \entry{typeset}{60}{\code {typeset}} -\entry{ulimit}{60}{\code {ulimit}} +\entry{ulimit}{61}{\code {ulimit}} \entry{unalias}{62}{\code {unalias}} \entry{set}{62}{\code {set}} \entry{shopt}{66}{\code {shopt}} diff --git a/doc/bashref.bts b/doc/bashref.bts index b920ac06..0accde84 100644 --- a/doc/bashref.bts +++ b/doc/bashref.bts @@ -45,7 +45,7 @@ \entry{\code {kill}}{107} \initial {L} \entry{\code {let}}{56} -\entry{\code {local}}{56} +\entry{\code {local}}{57} \entry{\code {logout}}{57} \initial {M} \entry{\code {mapfile}}{57} @@ -72,7 +72,7 @@ \entry{\code {type}}{60} \entry{\code {typeset}}{60} \initial {U} -\entry{\code {ulimit}}{60} +\entry{\code {ulimit}}{61} \entry{\code {umask}}{51} \entry{\code {unalias}}{62} \entry{\code {unset}}{51} diff --git a/doc/bashref.cp b/doc/bashref.cp index 768b26e4..bd395b51 100644 --- a/doc/bashref.cp +++ b/doc/bashref.cp @@ -71,7 +71,7 @@ \entry{exit status}{41}{exit status} \entry{signal handling}{41}{signal handling} \entry{shell script}{42}{shell script} -\entry{special builtin}{72}{special builtin} +\entry{special builtin}{73}{special builtin} \entry{login shell}{88}{login shell} \entry{interactive shell}{88}{interactive shell} \entry{startup files}{88}{startup files} diff --git a/doc/bashref.cps b/doc/bashref.cps index 83f677f1..2e8a197a 100644 --- a/doc/bashref.cps +++ b/doc/bashref.cps @@ -119,7 +119,7 @@ \entry{shell, interactive}{89} \entry{signal}{4} \entry{signal handling}{41} -\entry{special builtin}{4, 72} +\entry{special builtin}{4, 73} \entry{startup files}{88} \entry{suspending jobs}{105} \initial {T} diff --git a/doc/bashref.dvi b/doc/bashref.dvi index fbedaffc..b53210ab 100644 Binary files a/doc/bashref.dvi and b/doc/bashref.dvi differ diff --git a/doc/bashref.html b/doc/bashref.html index d03a64a2..8b3a3fb7 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -4491,7 +4491,7 @@ the nameref attribute, name will be unset rather than the variable it references. -n has no effect if the -f option is supplied. If no options are supplied, each name refers to a variable; if -there is no variable by that name, any function with that name is +there is no variable by that name, a function with that name, if any, is unset. Readonly variables and functions may not be unset. Some shell variables lose their special behavior if they are unset; such @@ -5215,7 +5215,7 @@ from regular files. If read times out, read saves any partial input read into the specified variable name. If timeout is 0, read returns immediately, without trying to -read and data. The exit status is 0 if input is available on +read any data. The exit status is 0 if input is available on the specified file descriptor, non-zero otherwise. The exit status is greater than 128 if the timeout is exceeded.

@@ -12479,7 +12479,7 @@ When editing is complete, the edited commands are echoed and executed.

In the second form, command is re-executed after each instance of pat in the selected command is replaced by rep. -command is intepreted the same as first above. +command is interpreted the same as first above.

A useful alias to use with the fc command is r='fc -s', so that typing ‘r cc’ runs the last command beginning with cc diff --git a/doc/bashref.info b/doc/bashref.info index 7828c0cc..d097e5a9 100644 --- a/doc/bashref.info +++ b/doc/bashref.info @@ -3332,9 +3332,9 @@ standard. attribute, NAME will be unset rather than the variable it references. '-n' has no effect if the '-f' option is supplied. If no options are supplied, each NAME refers to a variable; if there - is no variable by that name, any function with that name is unset. - Readonly variables and functions may not be unset. Some shell - variables lose their special behavior if they are unset; such + is no variable by that name, a function with that name, if any, is + unset. Readonly variables and functions may not be unset. Some + shell variables lose their special behavior if they are unset; such behavior is noted in the description of the individual variables. The return status is zero unless a NAME is readonly. @@ -3884,7 +3884,7 @@ standard. from regular files. If 'read' times out, 'read' saves any partial input read into the specified variable NAME. If TIMEOUT is 0, 'read' returns immediately, without trying to - read and data. The exit status is 0 if input is available on + read any data. The exit status is 0 if input is available on the specified file descriptor, non-zero otherwise. The exit status is greater than 128 if the timeout is exceeded. @@ -9335,7 +9335,7 @@ history file. In the second form, COMMAND is re-executed after each instance of PAT in the selected command is replaced by REP. COMMAND is - intepreted the same as FIRST above. + interpreted the same as FIRST above. A useful alias to use with the 'fc' command is 'r='fc -s'', so that typing 'r cc' runs the last command beginning with 'cc' and typing @@ -11822,84 +11822,84 @@ 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 +Node: Bash Builtins146978 +Node: Modifying Shell Behavior175903 +Node: The Set Builtin176248 +Node: The Shopt Builtin186661 +Node: Special Builtins204331 +Node: Shell Variables205310 +Node: Bourne Shell Variables205747 +Node: Bash Variables207851 +Node: Bash Features239793 +Node: Invoking Bash240692 +Node: Bash Startup Files246705 +Node: Interactive Shells251808 +Node: What is an Interactive Shell?252218 +Node: Is this Shell Interactive?252867 +Node: Interactive Shell Behavior253682 +Node: Bash Conditional Expressions257169 +Node: Shell Arithmetic261746 +Node: Aliases264686 +Node: Arrays267306 +Node: The Directory Stack272671 +Node: Directory Stack Builtins273455 +Node: Controlling the Prompt276423 +Node: The Restricted Shell279344 +Node: Bash POSIX Mode281826 +Node: Job Control292759 +Node: Job Control Basics293219 +Node: Job Control Builtins298183 +Node: Job Control Variables303329 +Node: Command Line Editing304485 +Node: Introduction and Notation306156 +Node: Readline Interaction307779 +Node: Readline Bare Essentials308970 +Node: Readline Movement Commands310753 +Node: Readline Killing Commands311713 +Node: Readline Arguments313631 +Node: Searching314675 +Node: Readline Init File316861 +Node: Readline Init File Syntax318120 +Node: Conditional Init Constructs338650 +Node: Sample Init File342846 +Node: Bindable Readline Commands345963 +Node: Commands For Moving347167 +Node: Commands For History349026 +Node: Commands For Text353321 +Node: Commands For Killing356709 +Node: Numeric Arguments359524 +Node: Commands For Completion360663 +Node: Keyboard Macros364854 +Node: Miscellaneous Commands365541 +Node: Readline vi Mode371494 +Node: Programmable Completion372401 +Node: Programmable Completion Builtins380181 +Node: A Programmable Completion Example390876 +Node: Using History Interactively396123 +Node: Bash History Facilities396807 +Node: Bash History Builtins399812 +Node: History Interaction404344 +Node: Event Designators407964 +Node: Word Designators409318 +Node: Modifiers411078 +Node: Installing Bash412889 +Node: Basic Installation414026 +Node: Compilers and Options417284 +Node: Compiling For Multiple Architectures418025 +Node: Installation Names419718 +Node: Specifying the System Type420536 +Node: Sharing Defaults421252 +Node: Operation Controls421925 +Node: Optional Features422883 +Node: Reporting Bugs433401 +Node: Major Differences From The Bourne Shell434595 +Node: GNU Free Documentation License451447 +Node: Indexes476624 +Node: Builtin Index477078 +Node: Reserved Word Index483905 +Node: Variable Index486353 +Node: Function Index502177 +Node: Concept Index515616  End Tag Table diff --git a/doc/bashref.log b/doc/bashref.log index 6bc30795..6de9d2ee 100644 --- a/doc/bashref.log +++ b/doc/bashref.log @@ -1,11 +1,9 @@ -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 +This is pdfTeX, Version 3.14159265-2.6-1.40.20 (TeX Live 2019/MacPorts 2019.50896_1) (preloaded format=pdftex 2019.11.6) 6 JAN 2020 09:08 entering extended mode restricted \write18 enabled. - file:line:error style messages enabled. %&-line parsing enabled. -**\nonstopmode \input /usr/homes/chet/src/bash/src/doc/bashref.texi -(/usr/homes/chet/src/bash/src/doc/bashref.texi -(/usr/homes/chet/src/bash/src/doc/texinfo.tex +**/usr/homes/chet/src/bash/src/doc/bashref.texi +(/usr/homes/chet/src/bash/src/doc/bashref.texi (./texinfo.tex Loading texinfo [version 2015-11-22.14]: \outerhsize=\dimen16 \outervsize=\dimen17 @@ -161,23 +159,19 @@ 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{/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 +(./version.texi) [1{/opt/local/var/db/texmf/fonts/map/pdftex/updmap/pdftex.map} +] [2] (./bashref.toc [-1] [-2] [-3]) [-4] (./bashref.toc) (./bashref.toc) +Chapter 1 \openout0 = `bashref.toc'. - -(/usr/homes/chet/src/bash/src/doc/bashref.aux) + (./bashref.aux) \openout1 = `bashref.aux'. Chapter 2 [1] [2] @cpindfile=@write2 \openout2 = `bashref.cp'. - [3] Chapter 3 -[4] [5] [6] + [3] Chapter 3 [4] [5] [6] @vrindfile=@write3 \openout3 = `bashref.vr'. @@ -185,18 +179,19 @@ s/map/pdftex/updmap/pdftex.map}] [2] @rwindfile=@write4 \openout4 = `bashref.rw'. - [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] -[20] [21] [22] [23] [24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] -[35] [36] [37] [38] [39] [40] [41] [42] Chapter 4 [43] + +[8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] +[23] [24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] +[38] [39] [40] [41] [42] Chapter 4 [43] @btindfile=@write5 \openout5 = `bashref.bt'. - [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] [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] + [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] [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] texinfo.tex: doing @include of rluser.texi @@ -268,9 +263,8 @@ texinfo.tex: doing @include of hsuser.texi [163] Appendix C [164] texinfo.tex: doing @include of fdl.texi - (/usr/homes/chet/src/bash/src/doc/fdl.texi [165] -[166] [167] [168] [169] [170] [171]) Appendix D [172] [173] [174] [175] -[176] + (./fdl.texi [165] [166] [167] [168] [169] [170] [171]) +Appendix D [172] [173] [174] [175] [176] Overfull \vbox (0.67252pt too high) has occurred while \output is active \vbox(340.17245+0.0)x207.80492 .\glue(\topskip) 0.0 @@ -287,12 +281,12 @@ 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: 4068 strings out of 497098 - 47117 string characters out of 6206772 - 138084 words of memory out of 5000000 + 46669 string characters out of 6206775 + 137084 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,968s stack positions out of 5000i,500n,10000p,200000b,80000s + 16i,6n,16p,319b,968s stack positions out of 5000i,500n,10000p,200000b,80000s {/opt/local/share/texmf-texlive/fonts/enc/dvips/ cm-super/cm-super-t1.enc} -Output written on bashref.pdf (187 pages, 759184 bytes). +Output written on bashref.pdf (187 pages, 759178 bytes). PDF statistics: 2644 PDF objects out of 2984 (max. 8388607) 2411 compressed objects within 25 object streams diff --git a/doc/bashref.pdf b/doc/bashref.pdf index 07bfa4c9..f96fd14d 100644 Binary files a/doc/bashref.pdf and b/doc/bashref.pdf differ diff --git a/doc/bashref.ps b/doc/bashref.ps index 670d03c4..dded7b4b 100644 --- a/doc/bashref.ps +++ b/doc/bashref.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 5.999 Copyright 2019 Radical Eye Software %%Title: bashref.dvi -%%CreationDate: Tue Nov 26 16:18:24 2019 +%%CreationDate: Mon Jan 6 13:53:44 2020 %%Pages: 187 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2019.11.26:1118 +%DVIPSSource: TeX output 2020.01.06:0853 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -7886,7 +7886,7 @@ h(:)f(:)h(:)f(:)g(:)h(:)34 b Fu(66)275 2882 y(4.4)92 b(Sp)s(ecial)30 b(Builtins)9 b Fn(:)16 b(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:) f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h (:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:) -f(:)g(:)h(:)f(:)22 b Fu(72)150 3132 y Fs(5)135 b(Shell)45 +f(:)g(:)h(:)f(:)22 b Fu(73)150 3132 y Fs(5)135 b(Shell)45 b(V)-11 b(ariables)11 b Fo(:)20 b(:)g(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f (:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:) f(:)h(:)f(:)g(:)h(:)f(:)24 b Fs(74)275 3269 y Fu(5.1)92 @@ -9326,7 +9326,7 @@ Fm(posix)f Fu(mo)s(de)h(\(see)i(Section)f(6.11)h([Bash)e(POSIX)g(Mo)s 1933 y(v)-5 b(alid)37 b(shell)f Fr(name)42 b Fu(and)36 b(ma)m(y)h(not)f(b)s(e)g(the)g(same)h(as)g(one)f(of)h(the)g(sp)s(ecial) g(builtins)e(\(see)j(Section)f(4.4)150 2042 y([Sp)s(ecial)e(Builtins],) -h(page)e(72\).)54 b(In)33 b(default)h(mo)s(de,)h(a)g(function)f(name)g +h(page)e(73\).)54 b(In)33 b(default)h(mo)s(de,)h(a)g(function)f(name)g (can)g(b)s(e)g(an)m(y)g(unquoted)g(shell)150 2152 y(w)m(ord)g(that)h (do)s(es)e(not)i(con)m(tain)g(`)p Ft($)p Fu('.)53 b(An)m(y)34 b(redirections)h(\(see)g(Section)g(3.6)g([Redirections],)i(page)e(34\)) @@ -11874,1509 +11874,1500 @@ b(or)f(function)f Fr(name)p Fu(.)52 b(If)33 b(the)i Ft(-v)e Fu(option)h(is)g(giv)m(en,)j(eac)m(h)e Fr(name)630 2234 y Fu(refers)27 b(to)h(a)g(shell)f(v)-5 b(ariable)28 b(and)f(that)h(v)-5 b(ariable)28 b(is)f(remo)m(v)m(ed.)41 b(If)27 b(the)g -Ft(-f)g Fu(option)g(is)h(giv)m(en,)630 2343 y(the)d Fr(name)5 -b Fu(s)25 b(refer)g(to)h(shell)f(functions,)h(and)e(the)i(function)e -(de\014nition)h(is)g(remo)m(v)m(ed.)40 b(If)25 b(the)630 -2453 y Ft(-n)h Fu(option)g(is)h(supplied,)f(and)g Fr(name)31 -b Fu(is)c(a)f(v)-5 b(ariable)27 b(with)f(the)h Fr(nameref)44 -b Fu(attribute,)28 b Fr(name)630 2563 y Fu(will)35 b(b)s(e)e(unset)h -(rather)g(than)g(the)g(v)-5 b(ariable)35 b(it)g(references.)53 -b Ft(-n)33 b Fu(has)h(no)g(e\013ect)i(if)e(the)h Ft(-f)630 -2672 y Fu(option)g(is)f(supplied.)51 b(If)34 b(no)g(options)g(are)h -(supplied,)f(eac)m(h)h Fr(name)40 b Fu(refers)33 b(to)i(a)g(v)-5 -b(ariable;)630 2782 y(if)41 b(there)g(is)g(no)g(v)-5 -b(ariable)42 b(b)m(y)f(that)g(name,)j(an)m(y)d(function)g(with)g(that)g -(name)g(is)g(unset.)630 2891 y(Readonly)34 b(v)-5 b(ariables)33 -b(and)g(functions)g(ma)m(y)h(not)f(b)s(e)g(unset.)48 -b(Some)34 b(shell)f(v)-5 b(ariables)34 b(lose)630 3001 -y(their)23 b(sp)s(ecial)h(b)s(eha)m(vior)f(if)g(they)h(are)f(unset;)j -(suc)m(h)d(b)s(eha)m(vior)g(is)g(noted)h(in)f(the)g(description)630 -3110 y(of)k(the)h(individual)e(v)-5 b(ariables.)41 b(The)26 -b(return)h(status)g(is)g(zero)h(unless)f(a)h Fr(name)k -Fu(is)27 b(readonly)-8 b(.)150 3354 y Fs(4.2)68 b(Bash)45 -b(Builtin)g(Commands)150 3514 y Fu(This)c(section)h(describ)s(es)f -(builtin)f(commands)h(whic)m(h)g(are)h(unique)e(to)j(or)e(ha)m(v)m(e)h -(b)s(een)f(extended)g(in)150 3623 y(Bash.)g(Some)30 b(of)h(these)g -(commands)f(are)g(sp)s(eci\014ed)g(in)g(the)h Fm(posix)e -Fu(standard.)150 3786 y Ft(alias)870 3921 y(alias)46 -b([-p])h([)p Fj(name)p Ft([=)p Fj(value)p Ft(])d(...)o(])630 -4057 y Fu(Without)26 b(argumen)m(ts)f(or)g(with)f(the)h -Ft(-p)g Fu(option,)h Ft(alias)e Fu(prin)m(ts)g(the)h(list)h(of)f -(aliases)h(on)f(the)630 4166 y(standard)g(output)g(in)g(a)h(form)f +Ft(-f)g Fu(option)g(is)h(giv)m(en,)630 2343 y(the)37 +b Fr(name)5 b Fu(s)37 b(refer)f(to)i(shell)f(functions,)h(and)e(the)h +(function)g(de\014nition)f(is)h(remo)m(v)m(ed.)61 b(If)630 +2453 y(the)34 b Ft(-n)e Fu(option)i(is)g(supplied,)f(and)g +Fr(name)38 b Fu(is)c(a)f(v)-5 b(ariable)34 b(with)g(the)f +Fr(nameref)51 b Fu(attribute,)630 2563 y Fr(name)42 b +Fu(will)37 b(b)s(e)f(unset)g(rather)g(than)h(the)g(v)-5 +b(ariable)37 b(it)g(references.)60 b Ft(-n)36 b Fu(has)g(no)h(e\013ect) +h(if)630 2672 y(the)h Ft(-f)g Fu(option)g(is)h(supplied.)65 +b(If)39 b(no)g(options)h(are)f(supplied,)h(eac)m(h)h +Fr(name)j Fu(refers)39 b(to)h(a)630 2782 y(v)-5 b(ariable;)45 +b(if)39 b(there)g(is)g(no)g(v)-5 b(ariable)40 b(b)m(y)f(that)h(name,)h +(a)f(function)f(with)g(that)g(name,)j(if)630 2891 y(an)m(y)-8 +b(,)34 b(is)e(unset.)46 b(Readonly)33 b(v)-5 b(ariables)33 +b(and)f(functions)g(ma)m(y)h(not)f(b)s(e)g(unset.)46 +b(Some)33 b(shell)630 3001 y(v)-5 b(ariables)29 b(lose)h(their)e(sp)s +(ecial)h(b)s(eha)m(vior)g(if)f(they)h(are)g(unset;)g(suc)m(h)f(b)s(eha) +m(vior)h(is)g(noted)f(in)630 3110 y(the)35 b(description)h(of)f(the)g +(individual)g(v)-5 b(ariables.)56 b(The)34 b(return)g(status)i(is)f +(zero)h(unless)f(a)630 3220 y Fr(name)h Fu(is)30 b(readonly)-8 +b(.)150 3464 y Fs(4.2)68 b(Bash)45 b(Builtin)g(Commands)150 +3623 y Fu(This)c(section)h(describ)s(es)f(builtin)f(commands)h(whic)m +(h)g(are)h(unique)e(to)j(or)e(ha)m(v)m(e)h(b)s(een)f(extended)g(in)150 +3733 y(Bash.)g(Some)30 b(of)h(these)g(commands)f(are)g(sp)s(eci\014ed)g +(in)g(the)h Fm(posix)e Fu(standard.)150 3895 y Ft(alias)870 +4031 y(alias)46 b([-p])h([)p Fj(name)p Ft([=)p Fj(value)p +Ft(])d(...)o(])630 4166 y Fu(Without)26 b(argumen)m(ts)f(or)g(with)f +(the)h Ft(-p)g Fu(option,)h Ft(alias)e Fu(prin)m(ts)g(the)h(list)h(of)f +(aliases)h(on)f(the)630 4276 y(standard)g(output)g(in)g(a)h(form)f (that)h(allo)m(ws)h(them)e(to)h(b)s(e)f(reused)g(as)g(input.)39 -b(If)25 b(argumen)m(ts)630 4276 y(are)j(supplied,)e(an)i(alias)g(is)f +b(If)25 b(argumen)m(ts)630 4385 y(are)j(supplied,)e(an)i(alias)g(is)f (de\014ned)f(for)h(eac)m(h)h Fr(name)33 b Fu(whose)27 b Fr(v)-5 b(alue)33 b Fu(is)27 b(giv)m(en.)41 b(If)26 -b(no)h Fr(v)-5 b(alue)630 4385 y Fu(is)37 b(giv)m(en,)j(the)d(name)g +b(no)h Fr(v)-5 b(alue)630 4495 y Fu(is)37 b(giv)m(en,)j(the)d(name)g (and)g(v)-5 b(alue)37 b(of)h(the)f(alias)h(is)f(prin)m(ted.)61 -b(Aliases)38 b(are)f(describ)s(ed)f(in)630 4495 y(Section)31 -b(6.6)h([Aliases],)g(page)f(94.)150 4657 y Ft(bind)870 -4792 y(bind)47 b([-m)g Fj(keymap)p Ft(])e([-lpsvPSVX])870 -4902 y(bind)i([-m)g Fj(keymap)p Ft(])e([-q)i Fj(function)p +b(Aliases)38 b(are)f(describ)s(ed)f(in)630 4605 y(Section)31 +b(6.6)h([Aliases],)g(page)f(94.)150 4766 y Ft(bind)870 +4902 y(bind)47 b([-m)g Fj(keymap)p Ft(])e([-lpsvPSVX])870 +5011 y(bind)i([-m)g Fj(keymap)p Ft(])e([-q)i Fj(function)p Ft(])f([-u)g Fj(function)p Ft(])g([-r)h Fj(keyseq)p Ft(])870 -5011 y(bind)g([-m)g Fj(keymap)p Ft(])e(-f)j Fj(filename)870 -5121 y Ft(bind)f([-m)g Fj(keymap)p Ft(])e(-x)j Fj(keyseq:shell-command) -870 5230 y Ft(bind)f([-m)g Fj(keymap)p Ft(])e Fj(keyseq:function-name) -870 5340 y Ft(bind)i([-m)g Fj(keymap)p Ft(])e Fj -(keyseq:readline-command)p eop end +5121 y(bind)g([-m)g Fj(keymap)p Ft(])e(-f)j Fj(filename)870 +5230 y Ft(bind)f([-m)g Fj(keymap)p Ft(])e(-x)j Fj(keyseq:shell-command) +870 5340 y Ft(bind)f([-m)g Fj(keymap)p Ft(])e Fj(keyseq:function-name)p +eop end %%Page: 52 58 TeXDict begin 52 57 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(52)630 299 y(Displa)m(y)22 -b(curren)m(t)f(Readline)h(\(see)f(Chapter)g(8)g([Command)f(Line)h -(Editing],)j(page)e(109\))g(k)m(ey)630 408 y(and)36 b(function)g -(bindings,)i(bind)d(a)i(k)m(ey)g(sequence)g(to)h(a)f(Readline)g -(function)f(or)h(macro,)630 518 y(or)44 b(set)h(a)g(Readline)f(v)-5 -b(ariable.)83 b(Eac)m(h)45 b(non-option)g(argumen)m(t)f(is)g(a)h -(command)f(as)g(it)630 628 y(w)m(ould)e(app)s(ear)f(in)h(a)h(Readline)g -(initialization)i(\014le)d(\(see)h(Section)g(8.3)g([Readline)g(Init)630 -737 y(File],)c(page)d(112\),)j(but)c(eac)m(h)h(binding)f(or)g(command)h -(m)m(ust)f(b)s(e)g(passed)g(as)h(a)g(separate)630 847 +b(Shell)30 b(Builtin)h(Commands)2069 b(52)870 299 y Ft(bind)47 +b([-m)g Fj(keymap)p Ft(])e Fj(keyseq:readline-command)630 +436 y Fu(Displa)m(y)22 b(curren)m(t)f(Readline)h(\(see)f(Chapter)g(8)g +([Command)f(Line)h(Editing],)j(page)e(109\))g(k)m(ey)630 +545 y(and)36 b(function)g(bindings,)i(bind)d(a)i(k)m(ey)g(sequence)g +(to)h(a)f(Readline)g(function)f(or)h(macro,)630 655 y(or)44 +b(set)h(a)g(Readline)f(v)-5 b(ariable.)83 b(Eac)m(h)45 +b(non-option)g(argumen)m(t)f(is)g(a)h(command)f(as)g(it)630 +765 y(w)m(ould)e(app)s(ear)f(in)h(a)h(Readline)g(initialization)i +(\014le)d(\(see)h(Section)g(8.3)g([Readline)g(Init)630 +874 y(File],)c(page)d(112\),)j(but)c(eac)m(h)h(binding)f(or)g(command)h +(m)m(ust)f(b)s(e)g(passed)g(as)h(a)g(separate)630 984 y(argumen)m(t;)31 b(e.g.,)h(`)p Ft("\\C-x\\C-r":re-read-init-f)o(ile)p -Fu('.)630 979 y(Options,)e(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo)m -(wing)h(meanings:)630 1134 y Ft(-m)e Fj(keymap)66 b Fu(Use)54 +Fu('.)630 1121 y(Options,)e(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo)m +(wing)h(meanings:)630 1285 y Ft(-m)e Fj(keymap)66 b Fu(Use)54 b Fr(k)m(eymap)j Fu(as)d(the)g(k)m(eymap)g(to)h(b)s(e)e(a\013ected)i(b) -m(y)f(the)g(subsequen)m(t)1110 1244 y(bindings.)46 b(Acceptable)34 +m(y)f(the)g(subsequen)m(t)1110 1395 y(bindings.)46 b(Acceptable)34 b Fr(k)m(eymap)i Fu(names)c(are)h Ft(emacs)p Fu(,)f Ft(emacs-standard)p -Fu(,)1110 1353 y Ft(emacs-meta)p Fu(,)99 b Ft(emacs-ctlx)p +Fu(,)1110 1504 y Ft(emacs-meta)p Fu(,)99 b Ft(emacs-ctlx)p Fu(,)f Ft(vi)p Fu(,)j Ft(vi-move)p Fu(,)f Ft(vi-command)p -Fu(,)f(and)1110 1463 y Ft(vi-insert)p Fu(.)81 b Ft(vi)44 +Fu(,)f(and)1110 1614 y Ft(vi-insert)p Fu(.)81 b Ft(vi)44 b Fu(is)h(equiv)-5 b(alen)m(t)46 b(to)g Ft(vi-command)c -Fu(\()p Ft(vi-move)h Fu(is)i(also)h(a)1110 1572 y(synon)m(ym\);)30 +Fu(\()p Ft(vi-move)h Fu(is)i(also)h(a)1110 1724 y(synon)m(ym\);)30 b Ft(emacs)f Fu(is)i(equiv)-5 b(alen)m(t)32 b(to)f Ft(emacs-standard)p -Fu(.)630 1727 y Ft(-l)384 b Fu(List)31 b(the)f(names)g(of)h(all)g -(Readline)g(functions.)630 1882 y Ft(-p)384 b Fu(Displa)m(y)34 +Fu(.)630 1888 y Ft(-l)384 b Fu(List)31 b(the)f(names)g(of)h(all)g +(Readline)g(functions.)630 2052 y Ft(-p)384 b Fu(Displa)m(y)34 b(Readline)f(function)g(names)g(and)f(bindings)f(in)i(suc)m(h)f(a)i(w)m -(a)m(y)f(that)1110 1992 y(they)e(can)f(b)s(e)g(used)g(as)g(input)g(or)g -(in)g(a)h(Readline)g(initialization)i(\014le.)630 2147 +(a)m(y)f(that)1110 2162 y(they)e(can)f(b)s(e)g(used)g(as)g(input)g(or)g +(in)g(a)h(Readline)g(initialization)i(\014le.)630 2326 y Ft(-P)384 b Fu(List)31 b(curren)m(t)f(Readline)h(function)f(names)g -(and)g(bindings.)630 2302 y Ft(-v)384 b Fu(Displa)m(y)25 +(and)g(bindings.)630 2491 y Ft(-v)384 b Fu(Displa)m(y)25 b(Readline)f(v)-5 b(ariable)25 b(names)f(and)f(v)-5 b(alues)24 -b(in)g(suc)m(h)f(a)i(w)m(a)m(y)f(that)h(they)1110 2411 +b(in)g(suc)m(h)f(a)i(w)m(a)m(y)f(that)h(they)1110 2600 y(can)31 b(b)s(e)e(used)h(as)h(input)e(or)h(in)g(a)h(Readline)g -(initialization)j(\014le.)630 2566 y Ft(-V)384 b Fu(List)31 +(initialization)j(\014le.)630 2765 y Ft(-V)384 b Fu(List)31 b(curren)m(t)f(Readline)h(v)-5 b(ariable)31 b(names)f(and)g(v)-5 -b(alues.)630 2721 y Ft(-s)384 b Fu(Displa)m(y)39 b(Readline)f(k)m(ey)g +b(alues.)630 2929 y Ft(-s)384 b Fu(Displa)m(y)39 b(Readline)f(k)m(ey)g (sequences)f(b)s(ound)f(to)i(macros)g(and)f(the)g(strings)1110 -2831 y(they)d(output)f(in)h(suc)m(h)f(a)h(w)m(a)m(y)h(that)f(they)g -(can)g(b)s(e)f(used)g(as)h(input)e(or)i(in)g(a)1110 2940 -y(Readline)d(initialization)i(\014le.)630 3095 y Ft(-S)384 +3039 y(they)d(output)f(in)h(suc)m(h)f(a)h(w)m(a)m(y)h(that)f(they)g +(can)g(b)s(e)f(used)g(as)h(input)e(or)i(in)g(a)1110 3148 +y(Readline)d(initialization)i(\014le.)630 3313 y Ft(-S)384 b Fu(Displa)m(y)39 b(Readline)f(k)m(ey)g(sequences)f(b)s(ound)f(to)i -(macros)g(and)f(the)g(strings)1110 3205 y(they)31 b(output.)630 -3360 y Ft(-f)f Fj(filename)1110 3469 y Fu(Read)h(k)m(ey)g(bindings)e -(from)h Fr(\014lename)p Fu(.)630 3624 y Ft(-q)g Fj(function)1110 -3734 y Fu(Query)g(ab)s(out)g(whic)m(h)g(k)m(eys)h(in)m(v)m(ok)m(e)h -(the)f(named)f Fr(function)p Fu(.)630 3889 y Ft(-u)g -Fj(function)1110 3998 y Fu(Un)m(bind)f(all)i(k)m(eys)g(b)s(ound)e(to)i -(the)f(named)g Fr(function)p Fu(.)630 4153 y Ft(-r)g +(macros)g(and)f(the)g(strings)1110 3422 y(they)31 b(output.)630 +3587 y Ft(-f)f Fj(filename)1110 3696 y Fu(Read)h(k)m(ey)g(bindings)e +(from)h Fr(\014lename)p Fu(.)630 3861 y Ft(-q)g Fj(function)1110 +3970 y Fu(Query)g(ab)s(out)g(whic)m(h)g(k)m(eys)h(in)m(v)m(ok)m(e)h +(the)f(named)f Fr(function)p Fu(.)630 4134 y Ft(-u)g +Fj(function)1110 4244 y Fu(Un)m(bind)f(all)i(k)m(eys)g(b)s(ound)e(to)i +(the)f(named)g Fr(function)p Fu(.)630 4408 y Ft(-r)g Fj(keyseq)66 b Fu(Remo)m(v)m(e)32 b(an)m(y)f(curren)m(t)f(binding)f -(for)h Fr(k)m(eyseq)p Fu(.)630 4308 y Ft(-x)g Fj(keyseq:shell-command) -1110 4418 y Fu(Cause)35 b Fr(shell-command)k Fu(to)d(b)s(e)f(executed)h +(for)h Fr(k)m(eyseq)p Fu(.)630 4573 y Ft(-x)g Fj(keyseq:shell-command) +1110 4682 y Fu(Cause)35 b Fr(shell-command)k Fu(to)d(b)s(e)f(executed)h (whenev)m(er)f Fr(k)m(eyseq)j Fu(is)d(en)m(tered.)1110 -4528 y(When)46 b Fr(shell-command)k Fu(is)c(executed,)51 -b(the)46 b(shell)g(sets)g(the)g Ft(READLINE_)1110 4637 +4792 y(When)46 b Fr(shell-command)k Fu(is)c(executed,)51 +b(the)46 b(shell)g(sets)g(the)g Ft(READLINE_)1110 4902 y(LINE)37 b Fu(v)-5 b(ariable)38 b(to)g(the)g(con)m(ten)m(ts)i(of)e -(the)g(Readline)g(line)g(bu\013er)f(and)g(the)1110 4747 +(the)g(Readline)g(line)g(bu\013er)f(and)g(the)1110 5011 y Ft(READLINE_POINT)e Fu(v)-5 b(ariable)39 b(to)h(the)e(curren)m(t)h -(lo)s(cation)h(of)f(the)g(insertion)1110 4856 y(p)s(oin)m(t.)59 +(lo)s(cation)h(of)f(the)g(insertion)1110 5121 y(p)s(oin)m(t.)59 b(If)37 b(the)f(executed)i(command)e(c)m(hanges)i(the)f(v)-5 -b(alue)37 b(of)f Ft(READLINE_)1110 4966 y(LINE)29 b Fu(or)h +b(alue)37 b(of)f Ft(READLINE_)1110 5230 y(LINE)29 b Fu(or)h Ft(READLINE_POINT)p Fu(,)c(those)31 b(new)e(v)-5 b(alues)31 -b(will)f(b)s(e)f(re\015ected)i(in)f(the)1110 5075 y(editing)h(state.) -630 5230 y Ft(-X)384 b Fu(List)27 b(all)i(k)m(ey)f(sequences)f(b)s -(ound)e(to)j(shell)g(commands)e(and)h(the)g(asso)s(ciated)1110 -5340 y(commands)j(in)g(a)h(format)g(that)f(can)h(b)s(e)f(reused)f(as)i -(input.)p eop end +b(will)f(b)s(e)f(re\015ected)i(in)f(the)1110 5340 y(editing)h(state.)p +eop end %%Page: 53 59 TeXDict begin 53 58 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(53)630 299 y(The)26 -b(return)f(status)i(is)f(zero)i(unless)d(an)i(in)m(v)-5 +b(Shell)30 b(Builtin)h(Commands)2069 b(53)630 299 y Ft(-X)384 +b Fu(List)27 b(all)i(k)m(ey)f(sequences)f(b)s(ound)e(to)j(shell)g +(commands)e(and)h(the)g(asso)s(ciated)1110 408 y(commands)j(in)g(a)h +(format)g(that)f(can)h(b)s(e)f(reused)f(as)i(input.)630 +568 y(The)26 b(return)f(status)i(is)f(zero)i(unless)d(an)i(in)m(v)-5 b(alid)27 b(option)g(is)f(supplied)f(or)i(an)f(error)g(o)s(ccurs.)150 -450 y Ft(builtin)870 581 y(builtin)46 b([)p Fj(shell-builtin)e -Ft([)p Fj(args)p Ft(]])630 711 y Fu(Run)35 b(a)i(shell)f(builtin,)i +727 y Ft(builtin)870 862 y(builtin)46 b([)p Fj(shell-builtin)e +Ft([)p Fj(args)p Ft(]])630 996 y Fu(Run)35 b(a)i(shell)f(builtin,)i (passing)e(it)h Fr(args)p Fu(,)h(and)e(return)f(its)i(exit)g(status.)59 -b(This)35 b(is)i(useful)630 821 y(when)29 b(de\014ning)h(a)g(shell)h +b(This)35 b(is)i(useful)630 1106 y(when)29 b(de\014ning)h(a)g(shell)h (function)f(with)g(the)g(same)h(name)f(as)h(a)g(shell)f(builtin,)g -(retaining)630 930 y(the)k(functionalit)m(y)h(of)f(the)f(builtin)g +(retaining)630 1215 y(the)k(functionalit)m(y)h(of)f(the)f(builtin)g (within)g(the)h(function.)50 b(The)33 b(return)g(status)h(is)f(non-)630 -1040 y(zero)e(if)g Fr(shell-builtin)f Fu(is)g(not)h(a)g(shell)f -(builtin)g(command.)150 1191 y Ft(caller)870 1322 y(caller)46 -b([)p Fj(expr)p Ft(])630 1452 y Fu(Returns)34 b(the)g(con)m(text)j(of)e +1325 y(zero)e(if)g Fr(shell-builtin)f Fu(is)g(not)h(a)g(shell)f +(builtin)g(command.)150 1484 y Ft(caller)870 1619 y(caller)46 +b([)p Fj(expr)p Ft(])630 1753 y Fu(Returns)34 b(the)g(con)m(text)j(of)e (an)m(y)g(activ)m(e)i(subroutine)c(call)j(\(a)f(shell)g(function)f(or)h -(a)g(script)630 1562 y(executed)c(with)f(the)h Ft(.)f -Fu(or)g Ft(source)f Fu(builtins\).)630 1692 y(Without)45 +(a)g(script)630 1863 y(executed)c(with)f(the)h Ft(.)f +Fu(or)g Ft(source)f Fu(builtins\).)630 1998 y(Without)45 b Fr(expr)p Fu(,)j Ft(caller)43 b Fu(displa)m(ys)i(the)f(line)h(n)m(um) -m(b)s(er)f(and)g(source)g(\014lename)h(of)g(the)630 1802 +m(b)s(er)f(and)g(source)g(\014lename)h(of)g(the)630 2107 y(curren)m(t)35 b(subroutine)g(call.)58 b(If)35 b(a)h(non-negativ)m(e)i (in)m(teger)f(is)f(supplied)e(as)i Fr(expr)p Fu(,)h Ft(caller)630 -1911 y Fu(displa)m(ys)k(the)f(line)h(n)m(um)m(b)s(er,)h(subroutine)d +2217 y Fu(displa)m(ys)k(the)f(line)h(n)m(um)m(b)s(er,)h(subroutine)d (name,)44 b(and)c(source)g(\014le)h(corresp)s(onding)e(to)630 -2021 y(that)c(p)s(osition)g(in)f(the)h(curren)m(t)f(execution)i(call)g +2326 y(that)c(p)s(osition)g(in)f(the)h(curren)m(t)f(execution)i(call)g (stac)m(k.)54 b(This)34 b(extra)h(information)g(ma)m(y)630 -2131 y(b)s(e)30 b(used,)g(for)g(example,)h(to)g(prin)m(t)f(a)h(stac)m +2436 y(b)s(e)30 b(used,)g(for)g(example,)h(to)g(prin)m(t)f(a)h(stac)m (k)h(trace.)42 b(The)29 b(curren)m(t)i(frame)f(is)g(frame)h(0.)630 -2261 y(The)d(return)g(v)-5 b(alue)29 b(is)g(0)g(unless)f(the)h(shell)g +2570 y(The)d(return)g(v)-5 b(alue)29 b(is)g(0)g(unless)f(the)h(shell)g (is)g(not)g(executing)h(a)f(subroutine)e(call)j(or)f -Fr(expr)630 2371 y Fu(do)s(es)h(not)h(corresp)s(ond)e(to)i(a)g(v)-5 +Fr(expr)630 2680 y Fu(do)s(es)h(not)h(corresp)s(ond)e(to)i(a)g(v)-5 b(alid)30 b(p)s(osition)h(in)f(the)g(call)i(stac)m(k.)150 -2522 y Ft(command)870 2652 y(command)46 b([-pVv])g Fj(command)g -Ft([)p Fj(arguments)f Ft(...)o(])630 2783 y Fu(Runs)32 +2839 y Ft(command)870 2974 y(command)46 b([-pVv])g Fj(command)g +Ft([)p Fj(arguments)f Ft(...)o(])630 3108 y Fu(Runs)32 b Fr(command)k Fu(with)d Fr(argumen)m(ts)k Fu(ignoring)c(an)m(y)g -(shell)h(function)e(named)h Fr(command)p Fu(.)630 2892 +(shell)h(function)e(named)h Fr(command)p Fu(.)630 3218 y(Only)39 b(shell)i(builtin)e(commands)h(or)g(commands)f(found)g(b)m(y) -h(searc)m(hing)h(the)f Ft(PATH)f Fu(are)630 3002 y(executed.)59 +h(searc)m(hing)h(the)f Ft(PATH)f Fu(are)630 3328 y(executed.)59 b(If)36 b(there)h(is)f(a)h(shell)f(function)g(named)g Ft(ls)p Fu(,)h(running)e(`)p Ft(command)29 b(ls)p Fu(')35 -b(within)630 3112 y(the)c(function)f(will)h(execute)g(the)g(external)g +b(within)630 3437 y(the)c(function)f(will)h(execute)g(the)g(external)g (command)g Ft(ls)f Fu(instead)g(of)h(calling)h(the)f(func-)630 -3221 y(tion)36 b(recursiv)m(ely)-8 b(.)56 b(The)34 b +3547 y(tion)36 b(recursiv)m(ely)-8 b(.)56 b(The)34 b Ft(-p)h Fu(option)g(means)g(to)h(use)f(a)g(default)h(v)-5 -b(alue)35 b(for)g Ft(PATH)f Fu(that)i(is)630 3331 y(guaran)m(teed)f(to) +b(alue)35 b(for)g Ft(PATH)f Fu(that)i(is)630 3656 y(guaran)m(teed)f(to) f(\014nd)e(all)j(of)f(the)g(standard)f(utilities.)52 -b(The)33 b(return)g(status)h(in)f(this)h(case)630 3440 +b(The)33 b(return)g(status)h(in)f(this)h(case)630 3766 y(is)29 b(127)g(if)g Fr(command)j Fu(cannot)d(b)s(e)e(found)h(or)g(an)g (error)h(o)s(ccurred,)f(and)g(the)h(exit)g(status)g(of)630 -3550 y Fr(command)34 b Fu(otherwise.)630 3680 y(If)e(either)h(the)f +3875 y Fr(command)34 b Fu(otherwise.)630 4010 y(If)e(either)h(the)f Ft(-V)g Fu(or)g Ft(-v)g Fu(option)h(is)f(supplied,)g(a)h(description)f -(of)h Fr(command)j Fu(is)c(prin)m(ted.)630 3790 y(The)f +(of)h Fr(command)j Fu(is)c(prin)m(ted.)630 4120 y(The)f Ft(-v)h Fu(option)g(causes)g(a)g(single)h(w)m(ord)f(indicating)g(the)g -(command)g(or)g(\014le)g(name)g(used)630 3900 y(to)40 +(command)g(or)g(\014le)g(name)g(used)630 4229 y(to)40 b(in)m(v)m(ok)m(e)h Fr(command)h Fu(to)e(b)s(e)e(displa)m(y)m(ed;)44 b(the)39 b Ft(-V)f Fu(option)i(pro)s(duces)d(a)j(more)f(v)m(erb)s(ose) -630 4009 y(description.)61 b(In)36 b(this)h(case,)j(the)e(return)e +630 4339 y(description.)61 b(In)36 b(this)h(case,)j(the)e(return)e (status)h(is)g(zero)h(if)f Fr(command)k Fu(is)c(found,)h(and)630 -4119 y(non-zero)31 b(if)f(not.)150 4270 y Ft(declare)870 -4401 y(declare)46 b([-aAfFgilnrtux])d([-p])k([)p Fj(name)p -Ft([=)p Fj(value)p Ft(])d(...)o(])630 4531 y Fu(Declare)29 +4448 y(non-zero)31 b(if)f(not.)150 4608 y Ft(declare)870 +4742 y(declare)46 b([-aAfFgilnrtux])d([-p])k([)p Fj(name)p +Ft([=)p Fj(value)p Ft(])d(...)o(])630 4877 y Fu(Declare)29 b(v)-5 b(ariables)28 b(and)e(giv)m(e)j(them)e(attributes.)40 b(If)27 b(no)g Fr(name)5 b Fu(s)27 b(are)h(giv)m(en,)h(then)e(displa)m -(y)630 4641 y(the)k(v)-5 b(alues)30 b(of)h(v)-5 b(ariables)31 -b(instead.)630 4771 y(The)k Ft(-p)f Fu(option)i(will)g(displa)m(y)f +(y)630 4986 y(the)k(v)-5 b(alues)30 b(of)h(v)-5 b(ariables)31 +b(instead.)630 5121 y(The)k Ft(-p)f Fu(option)i(will)g(displa)m(y)f (the)h(attributes)g(and)e(v)-5 b(alues)36 b(of)f(eac)m(h)i -Fr(name)p Fu(.)55 b(When)36 b Ft(-p)630 4881 y Fu(is)i(used)g(with)g +Fr(name)p Fu(.)55 b(When)36 b Ft(-p)630 5230 y Fu(is)i(used)g(with)g Fr(name)43 b Fu(argumen)m(ts,)e(additional)e(options,)i(other)d(than)g -Ft(-f)g Fu(and)g Ft(-F)p Fu(,)i(are)630 4990 y(ignored.)630 -5121 y(When)g Ft(-p)g Fu(is)g(supplied)f(without)i Fr(name)k -Fu(argumen)m(ts,)f Ft(declare)38 b Fu(will)j(displa)m(y)f(the)h(at-)630 -5230 y(tributes)31 b(and)f(v)-5 b(alues)31 b(of)g(all)h(v)-5 -b(ariables)31 b(ha)m(ving)h(the)f(attributes)g(sp)s(eci\014ed)f(b)m(y)h -(the)g(addi-)630 5340 y(tional)k(options.)52 b(If)34 -b(no)g(other)g(options)g(are)g(supplied)f(with)h Ft(-p)p -Fu(,)g Ft(declare)e Fu(will)j(displa)m(y)p eop end +Ft(-f)g Fu(and)g Ft(-F)p Fu(,)i(are)630 5340 y(ignored.)p +eop end %%Page: 54 60 TeXDict begin 54 59 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(54)630 299 y(the)33 -b(attributes)h(and)e(v)-5 b(alues)33 b(of)g(all)h(shell)f(v)-5 -b(ariables.)50 b(The)32 b Ft(-f)g Fu(option)i(will)f(restrict)h(the)630 -408 y(displa)m(y)d(to)g(shell)f(functions.)630 544 y(The)41 -b Ft(-F)f Fu(option)i(inhibits)e(the)i(displa)m(y)f(of)g(function)g -(de\014nitions;)47 b(only)41 b(the)g(function)630 654 -y(name)30 b(and)f(attributes)i(are)f(prin)m(ted.)40 b(If)30 -b(the)g Ft(extdebug)e Fu(shell)i(option)g(is)g(enabled)g(using)630 -764 y Ft(shopt)24 b Fu(\(see)i(Section)g(4.3.2)i([The)d(Shopt)f -(Builtin],)k(page)e(66\),)i(the)d(source)h(\014le)f(name)h(and)630 -873 y(line)31 b(n)m(um)m(b)s(er)e(where)h(eac)m(h)h Fr(name)36 -b Fu(is)30 b(de\014ned)f(are)i(displa)m(y)m(ed)g(as)g(w)m(ell.)41 -b Ft(-F)30 b Fu(implies)h Ft(-f)p Fu(.)630 1009 y(The)36 -b Ft(-g)g Fu(option)h(forces)g(v)-5 b(ariables)37 b(to)g(b)s(e)f -(created)i(or)e(mo)s(di\014ed)g(at)h(the)g(global)h(scop)s(e,)630 -1119 y(ev)m(en)g(when)e Ft(declare)f Fu(is)j(executed)g(in)f(a)g(shell) -h(function.)61 b(It)37 b(is)g(ignored)h(in)f(all)h(other)630 -1228 y(cases.)630 1364 y(The)27 b(follo)m(wing)h(options)g(can)f(b)s(e) +b(Shell)30 b(Builtin)h(Commands)2069 b(54)630 299 y(When)40 +b Ft(-p)g Fu(is)g(supplied)f(without)i Fr(name)k Fu(argumen)m(ts,)f +Ft(declare)38 b Fu(will)j(displa)m(y)f(the)h(at-)630 +408 y(tributes)31 b(and)f(v)-5 b(alues)31 b(of)g(all)h(v)-5 +b(ariables)31 b(ha)m(ving)h(the)f(attributes)g(sp)s(eci\014ed)f(b)m(y)h +(the)g(addi-)630 518 y(tional)k(options.)52 b(If)34 b(no)g(other)g +(options)g(are)g(supplied)f(with)h Ft(-p)p Fu(,)g Ft(declare)e +Fu(will)j(displa)m(y)630 628 y(the)e(attributes)h(and)e(v)-5 +b(alues)33 b(of)g(all)h(shell)f(v)-5 b(ariables.)50 b(The)32 +b Ft(-f)g Fu(option)i(will)f(restrict)h(the)630 737 y(displa)m(y)d(to)g +(shell)f(functions.)630 873 y(The)41 b Ft(-F)f Fu(option)i(inhibits)e +(the)i(displa)m(y)f(of)g(function)g(de\014nitions;)47 +b(only)41 b(the)g(function)630 983 y(name)30 b(and)f(attributes)i(are)f +(prin)m(ted.)40 b(If)30 b(the)g Ft(extdebug)e Fu(shell)i(option)g(is)g +(enabled)g(using)630 1092 y Ft(shopt)24 b Fu(\(see)i(Section)g(4.3.2)i +([The)d(Shopt)f(Builtin],)k(page)e(66\),)i(the)d(source)h(\014le)f +(name)h(and)630 1202 y(line)31 b(n)m(um)m(b)s(er)e(where)h(eac)m(h)h +Fr(name)36 b Fu(is)30 b(de\014ned)f(are)i(displa)m(y)m(ed)g(as)g(w)m +(ell.)41 b Ft(-F)30 b Fu(implies)h Ft(-f)p Fu(.)630 1338 +y(The)36 b Ft(-g)g Fu(option)h(forces)g(v)-5 b(ariables)37 +b(to)g(b)s(e)f(created)i(or)e(mo)s(di\014ed)g(at)h(the)g(global)h(scop) +s(e,)630 1447 y(ev)m(en)g(when)e Ft(declare)f Fu(is)j(executed)g(in)f +(a)g(shell)h(function.)61 b(It)37 b(is)g(ignored)h(in)f(all)h(other)630 +1557 y(cases.)630 1693 y(The)27 b(follo)m(wing)h(options)g(can)f(b)s(e) g(used)f(to)i(restrict)g(output)e(to)i(v)-5 b(ariables)28 -b(with)f(the)g(sp)s(ec-)630 1474 y(i\014ed)j(attributes)h(or)f(to)h -(giv)m(e)h(v)-5 b(ariables)31 b(attributes:)630 1636 +b(with)f(the)g(sp)s(ec-)630 1802 y(i\014ed)j(attributes)h(or)f(to)h +(giv)m(e)h(v)-5 b(ariables)31 b(attributes:)630 1965 y Ft(-a)384 b Fu(Eac)m(h)36 b Fr(name)k Fu(is)34 b(an)h(indexed)g(arra) m(y)g(v)-5 b(ariable)36 b(\(see)f(Section)h(6.7)g([Arra)m(ys],)1110 -1745 y(page)31 b(95\).)630 1908 y Ft(-A)384 b Fu(Eac)m(h)24 +2074 y(page)31 b(95\).)630 2236 y Ft(-A)384 b Fu(Eac)m(h)24 b Fr(name)k Fu(is)23 b(an)g(asso)s(ciativ)m(e)j(arra)m(y)e(v)-5 b(ariable)24 b(\(see)g(Section)g(6.7)g([Arra)m(ys],)1110 -2017 y(page)31 b(95\).)630 2179 y Ft(-f)384 b Fu(Use)31 -b(function)f(names)g(only)-8 b(.)630 2342 y Ft(-i)384 +2346 y(page)31 b(95\).)630 2508 y Ft(-f)384 b Fu(Use)31 +b(function)f(names)g(only)-8 b(.)630 2670 y Ft(-i)384 b Fu(The)36 b(v)-5 b(ariable)37 b(is)f(to)h(b)s(e)f(treated)h(as)g(an)f (in)m(teger;)41 b(arithmetic)c(ev)-5 b(aluation)1110 -2451 y(\(see)29 b(Section)f(6.5)h([Shell)f(Arithmetic],)i(page)e(93\))h -(is)f(p)s(erformed)e(when)h(the)1110 2561 y(v)-5 b(ariable)31 -b(is)g(assigned)f(a)h(v)-5 b(alue.)630 2723 y Ft(-l)384 +2780 y(\(see)29 b(Section)f(6.5)h([Shell)f(Arithmetic],)i(page)e(93\))h +(is)f(p)s(erformed)e(when)h(the)1110 2890 y(v)-5 b(ariable)31 +b(is)g(assigned)f(a)h(v)-5 b(alue.)630 3052 y Ft(-l)384 b Fu(When)26 b(the)g(v)-5 b(ariable)27 b(is)f(assigned)g(a)g(v)-5 b(alue,)28 b(all)f(upp)s(er-case)e(c)m(haracters)j(are)1110 -2833 y(con)m(v)m(erted)k(to)f(lo)m(w)m(er-case.)43 b(The)30 -b(upp)s(er-case)g(attribute)h(is)g(disabled.)630 2995 +3161 y(con)m(v)m(erted)k(to)f(lo)m(w)m(er-case.)43 b(The)30 +b(upp)s(er-case)g(attribute)h(is)g(disabled.)630 3324 y Ft(-n)384 b Fu(Giv)m(e)28 b(eac)m(h)g Fr(name)k Fu(the)27 b Fr(nameref)44 b Fu(attribute,)28 b(making)f(it)h(a)f(name)f -(reference)1110 3104 y(to)32 b(another)g(v)-5 b(ariable.)46 +(reference)1110 3433 y(to)32 b(another)g(v)-5 b(ariable.)46 b(That)31 b(other)h(v)-5 b(ariable)33 b(is)f(de\014ned)e(b)m(y)i(the)g -(v)-5 b(alue)32 b(of)1110 3214 y Fr(name)p Fu(.)54 b(All)35 +(v)-5 b(alue)32 b(of)1110 3543 y Fr(name)p Fu(.)54 b(All)35 b(references,)h(assignmen)m(ts,)h(and)d(attribute)h(mo)s(di\014cations) -g(to)1110 3324 y Fr(name)p Fu(,)27 b(except)f(for)f(those)h(using)f(or) +g(to)1110 3652 y Fr(name)p Fu(,)27 b(except)f(for)f(those)h(using)f(or) g(c)m(hanging)h(the)f Ft(-n)g Fu(attribute)h(itself,)i(are)1110 -3433 y(p)s(erformed)22 b(on)h(the)g(v)-5 b(ariable)25 +3762 y(p)s(erformed)22 b(on)h(the)g(v)-5 b(ariable)25 b(referenced)e(b)m(y)g Fr(name)5 b Fu('s)23 b(v)-5 b(alue.)39 -b(The)23 b(nameref)1110 3543 y(attribute)31 b(cannot)g(b)s(e)f(applied) -g(to)h(arra)m(y)g(v)-5 b(ariables.)630 3705 y Ft(-r)384 +b(The)23 b(nameref)1110 3871 y(attribute)31 b(cannot)g(b)s(e)f(applied) +g(to)h(arra)m(y)g(v)-5 b(ariables.)630 4034 y Ft(-r)384 b Fu(Mak)m(e)25 b Fr(name)5 b Fu(s)23 b(readonly)-8 b(.)39 b(These)24 b(names)f(cannot)h(then)f(b)s(e)g(assigned)h(v)-5 -b(alues)1110 3814 y(b)m(y)30 b(subsequen)m(t)g(assignmen)m(t)h -(statemen)m(ts)h(or)f(unset.)630 3977 y Ft(-t)384 b Fu(Giv)m(e)33 +b(alues)1110 4143 y(b)m(y)30 b(subsequen)m(t)g(assignmen)m(t)h +(statemen)m(ts)h(or)f(unset.)630 4305 y Ft(-t)384 b Fu(Giv)m(e)33 b(eac)m(h)h Fr(name)j Fu(the)32 b Ft(trace)f Fu(attribute.)46 -b(T)-8 b(raced)32 b(functions)g(inherit)g(the)1110 4086 +b(T)-8 b(raced)32 b(functions)g(inherit)g(the)1110 4415 y Ft(DEBUG)26 b Fu(and)h Ft(RETURN)f Fu(traps)h(from)g(the)h(calling)h -(shell.)40 b(The)27 b(trace)i(attribute)1110 4196 y(has)h(no)g(sp)s -(ecial)h(meaning)g(for)f(v)-5 b(ariables.)630 4358 y +(shell.)40 b(The)27 b(trace)i(attribute)1110 4525 y(has)h(no)g(sp)s +(ecial)h(meaning)g(for)f(v)-5 b(ariables.)630 4687 y Ft(-u)384 b Fu(When)28 b(the)h(v)-5 b(ariable)29 b(is)f(assigned)h(a)f (v)-5 b(alue,)30 b(all)f(lo)m(w)m(er-case)i(c)m(haracters)f(are)1110 -4468 y(con)m(v)m(erted)i(to)f(upp)s(er-case.)40 b(The)30 -b(lo)m(w)m(er-case)j(attribute)e(is)g(disabled.)630 4630 +4796 y(con)m(v)m(erted)i(to)f(upp)s(er-case.)40 b(The)30 +b(lo)m(w)m(er-case)j(attribute)e(is)g(disabled.)630 4959 y Ft(-x)384 b Fu(Mark)30 b(eac)m(h)h Fr(name)k Fu(for)29 b(exp)s(ort)h(to)g(subsequen)m(t)f(commands)h(via)g(the)g(en)m(vi-)1110 -4739 y(ronmen)m(t.)630 4902 y(Using)e(`)p Ft(+)p Fu(')h(instead)f(of)g +5068 y(ronmen)m(t.)630 5230 y(Using)e(`)p Ft(+)p Fu(')h(instead)f(of)g (`)p Ft(-)p Fu(')g(turns)f(o\013)i(the)f(attribute)h(instead,)g(with)f -(the)g(exceptions)h(that)630 5011 y(`)p Ft(+a)p Fu(')23 +(the)g(exceptions)h(that)630 5340 y(`)p Ft(+a)p Fu(')23 b(and)f(`)p Ft(+A)p Fu(')h(ma)m(y)h(not)f(b)s(e)f(used)g(to)i(destro)m (y)g(arra)m(y)f(v)-5 b(ariables)24 b(and)e(`)p Ft(+r)p -Fu(')h(will)g(not)g(remo)m(v)m(e)630 5121 y(the)36 b(readonly)h -(attribute.)59 b(When)36 b(used)f(in)h(a)h(function,)g -Ft(declare)d Fu(mak)m(es)j(eac)m(h)h Fr(name)630 5230 -y Fu(lo)s(cal,)e(as)d(with)h(the)f Ft(local)f Fu(command,)j(unless)d -(the)i Ft(-g)f Fu(option)h(is)f(used.)49 b(If)33 b(a)h(v)-5 -b(ariable)630 5340 y(name)30 b(is)h(follo)m(w)m(ed)h(b)m(y)e(=)p -Fr(v)-5 b(alue)p Fu(,)31 b(the)f(v)-5 b(alue)31 b(of)g(the)f(v)-5 -b(ariable)32 b(is)e(set)h(to)g Fr(v)-5 b(alue)p Fu(.)p -eop end +Fu(')h(will)g(not)g(remo)m(v)m(e)p eop end %%Page: 55 61 TeXDict begin 55 60 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(55)630 299 y(When)41 -b(using)g Ft(-a)g Fu(or)h Ft(-A)e Fu(and)h(the)h(comp)s(ound)e -(assignmen)m(t)i(syn)m(tax)g(to)g(create)h(arra)m(y)630 -408 y(v)-5 b(ariables,)28 b(additional)f(attributes)g(do)f(not)h(tak)m +b(Shell)30 b(Builtin)h(Commands)2069 b(55)630 299 y(the)36 +b(readonly)h(attribute.)59 b(When)36 b(used)f(in)h(a)h(function,)g +Ft(declare)d Fu(mak)m(es)j(eac)m(h)h Fr(name)630 408 +y Fu(lo)s(cal,)e(as)d(with)h(the)f Ft(local)f Fu(command,)j(unless)d +(the)i Ft(-g)f Fu(option)h(is)f(used.)49 b(If)33 b(a)h(v)-5 +b(ariable)630 518 y(name)30 b(is)h(follo)m(w)m(ed)h(b)m(y)e(=)p +Fr(v)-5 b(alue)p Fu(,)31 b(the)f(v)-5 b(alue)31 b(of)g(the)f(v)-5 +b(ariable)32 b(is)e(set)h(to)g Fr(v)-5 b(alue)p Fu(.)630 +656 y(When)41 b(using)g Ft(-a)g Fu(or)h Ft(-A)e Fu(and)h(the)h(comp)s +(ound)e(assignmen)m(t)i(syn)m(tax)g(to)g(create)h(arra)m(y)630 +766 y(v)-5 b(ariables,)28 b(additional)f(attributes)g(do)f(not)h(tak)m (e)h(e\013ect)g(un)m(til)e(subsequen)m(t)g(assignmen)m(ts.)630 -537 y(The)35 b(return)f(status)i(is)g(zero)g(unless)f(an)g(in)m(v)-5 +903 y(The)35 b(return)f(status)i(is)g(zero)g(unless)f(an)g(in)m(v)-5 b(alid)36 b(option)g(is)g(encoun)m(tered,)h(an)f(attempt)630 -647 y(is)c(made)g(to)g(de\014ne)f(a)h(function)g(using)f(`)p +1013 y(is)c(made)g(to)g(de\014ne)f(a)h(function)g(using)f(`)p Ft(-f)f(foo=bar)p Fu(',)h(an)h(attempt)g(is)g(made)g(to)h(assign)630 -757 y(a)42 b(v)-5 b(alue)43 b(to)g(a)f(readonly)g(v)-5 +1123 y(a)42 b(v)-5 b(alue)43 b(to)g(a)f(readonly)g(v)-5 b(ariable,)47 b(an)42 b(attempt)h(is)f(made)g(to)h(assign)f(a)h(v)-5 -b(alue)42 b(to)h(an)630 866 y(arra)m(y)30 b(v)-5 b(ariable)30 +b(alue)42 b(to)h(an)630 1232 y(arra)m(y)30 b(v)-5 b(ariable)30 b(without)g(using)e(the)i(comp)s(ound)e(assignmen)m(t)i(syn)m(tax)g -(\(see)h(Section)f(6.7)630 976 y([Arra)m(ys],)47 b(page)c(95\),)48 +(\(see)h(Section)f(6.7)630 1342 y([Arra)m(ys],)47 b(page)c(95\),)48 b(one)43 b(of)g(the)g Fr(names)k Fu(is)c(not)g(a)g(v)-5 b(alid)43 b(shell)g(v)-5 b(ariable)44 b(name,)i(an)630 -1085 y(attempt)28 b(is)f(made)h(to)f(turn)f(o\013)i(readonly)f(status)g +1451 y(attempt)28 b(is)f(made)h(to)f(turn)f(o\013)i(readonly)f(status)g (for)g(a)h(readonly)f(v)-5 b(ariable,)29 b(an)e(attempt)630 -1195 y(is)h(made)h(to)g(turn)e(o\013)i(arra)m(y)f(status)h(for)f(an)g +1561 y(is)h(made)h(to)g(turn)e(o\013)i(arra)m(y)f(status)h(for)f(an)g (arra)m(y)h(v)-5 b(ariable,)30 b(or)e(an)g(attempt)i(is)e(made)g(to)630 -1305 y(displa)m(y)j(a)f(non-existen)m(t)i(function)e(with)g -Ft(-f)p Fu(.)150 1453 y Ft(echo)870 1582 y(echo)47 b([-neE])f([)p -Fj(arg)g Ft(...])630 1711 y Fu(Output)31 b(the)i Fr(arg)8 +1671 y(displa)m(y)j(a)f(non-existen)m(t)i(function)e(with)g +Ft(-f)p Fu(.)150 1837 y Ft(echo)870 1975 y(echo)47 b([-neE])f([)p +Fj(arg)g Ft(...])630 2112 y Fu(Output)31 b(the)i Fr(arg)8 b Fu(s,)33 b(separated)g(b)m(y)g(spaces,)g(terminated)g(with)f(a)h -(newline.)47 b(The)32 b(return)630 1820 y(status)f(is)f(0)h(unless)f(a) +(newline.)47 b(The)32 b(return)630 2222 y(status)f(is)f(0)h(unless)f(a) h(write)g(error)f(o)s(ccurs.)41 b(If)30 b Ft(-n)g Fu(is)h(sp)s -(eci\014ed,)f(the)h(trailing)g(newline)g(is)630 1930 +(eci\014ed,)f(the)h(trailing)g(newline)g(is)630 2332 y(suppressed.)38 b(If)29 b(the)h Ft(-e)f Fu(option)h(is)f(giv)m(en,)i (in)m(terpretation)g(of)e(the)h(follo)m(wing)h(bac)m(kslash-)630 -2039 y(escap)s(ed)43 b(c)m(haracters)h(is)e(enabled.)78 +2441 y(escap)s(ed)43 b(c)m(haracters)h(is)e(enabled.)78 b(The)42 b Ft(-E)g Fu(option)h(disables)g(the)g(in)m(terpretation)h(of) -630 2149 y(these)27 b(escap)s(e)g(c)m(haracters,)i(ev)m(en)e(on)g +630 2551 y(these)27 b(escap)s(e)g(c)m(haracters,)i(ev)m(en)e(on)g (systems)f(where)g(they)h(are)g(in)m(terpreted)g(b)m(y)f(default.)630 -2259 y(The)32 b Ft(xpg_echo)f Fu(shell)i(option)g(ma)m(y)h(b)s(e)e +2660 y(The)32 b Ft(xpg_echo)f Fu(shell)i(option)g(ma)m(y)h(b)s(e)e (used)g(to)h(dynamically)h(determine)f(whether)f(or)630 -2368 y(not)h Ft(echo)f Fu(expands)g(these)h(escap)s(e)h(c)m(haracters)g +2770 y(not)h Ft(echo)f Fu(expands)g(these)h(escap)s(e)h(c)m(haracters)g (b)m(y)f(default.)48 b Ft(echo)32 b Fu(do)s(es)g(not)i(in)m(terpret)630 -2478 y Ft(--)c Fu(to)h(mean)f(the)h(end)f(of)g(options.)630 -2607 y Ft(echo)f Fu(in)m(terprets)i(the)f(follo)m(wing)i(escap)s(e)f -(sequences:)630 2755 y Ft(\\a)384 b Fu(alert)31 b(\(b)s(ell\))630 -2903 y Ft(\\b)384 b Fu(bac)m(kspace)630 3051 y Ft(\\c)g -Fu(suppress)28 b(further)h(output)630 3200 y Ft(\\e)630 -3309 y(\\E)384 b Fu(escap)s(e)630 3458 y Ft(\\f)g Fu(form)30 -b(feed)630 3606 y Ft(\\n)384 b Fu(new)30 b(line)630 3754 -y Ft(\\r)384 b Fu(carriage)32 b(return)630 3902 y Ft(\\t)384 -b Fu(horizon)m(tal)32 b(tab)630 4051 y Ft(\\v)384 b Fu(v)m(ertical)32 -b(tab)630 4199 y Ft(\\\\)384 b Fu(bac)m(kslash)630 4347 +2880 y Ft(--)c Fu(to)h(mean)f(the)h(end)f(of)g(options.)630 +3017 y Ft(echo)f Fu(in)m(terprets)i(the)f(follo)m(wing)i(escap)s(e)f +(sequences:)630 3184 y Ft(\\a)384 b Fu(alert)31 b(\(b)s(ell\))630 +3350 y Ft(\\b)384 b Fu(bac)m(kspace)630 3516 y Ft(\\c)g +Fu(suppress)28 b(further)h(output)630 3682 y Ft(\\e)630 +3792 y(\\E)384 b Fu(escap)s(e)630 3958 y Ft(\\f)g Fu(form)30 +b(feed)630 4124 y Ft(\\n)384 b Fu(new)30 b(line)630 4290 +y Ft(\\r)384 b Fu(carriage)32 b(return)630 4456 y Ft(\\t)384 +b Fu(horizon)m(tal)32 b(tab)630 4622 y Ft(\\v)384 b Fu(v)m(ertical)32 +b(tab)630 4788 y Ft(\\\\)384 b Fu(bac)m(kslash)630 4955 y Ft(\\0)p Fj(nnn)240 b Fu(the)32 b(eigh)m(t-bit)i(c)m(haracter)g (whose)e(v)-5 b(alue)33 b(is)f(the)g(o)s(ctal)i(v)-5 -b(alue)32 b Fr(nnn)f Fu(\(zero)i(to)1110 4457 y(three)e(o)s(ctal)g -(digits\))630 4605 y Ft(\\x)p Fj(HH)288 b Fu(the)38 b(eigh)m(t-bit)i(c) +b(alue)32 b Fr(nnn)f Fu(\(zero)i(to)1110 5064 y(three)e(o)s(ctal)g +(digits\))630 5230 y Ft(\\x)p Fj(HH)288 b Fu(the)38 b(eigh)m(t-bit)i(c) m(haracter)g(whose)e(v)-5 b(alue)39 b(is)f(the)h(hexadecimal)g(v)-5 -b(alue)39 b Fr(HH)1110 4715 y Fu(\(one)31 b(or)f(t)m(w)m(o)i(hex)e -(digits\))630 4863 y Ft(\\u)p Fj(HHHH)192 b Fu(the)41 -b(Unico)s(de)g(\(ISO/IEC)f(10646\))j(c)m(haracter)g(whose)e(v)-5 -b(alue)41 b(is)g(the)g(hex-)1110 4973 y(adecimal)32 b(v)-5 -b(alue)31 b Fr(HHHH)41 b Fu(\(one)31 b(to)g(four)e(hex)h(digits\))630 -5121 y Ft(\\U)p Fj(HHHHHHHH)1110 5230 y Fu(the)41 b(Unico)s(de)g -(\(ISO/IEC)f(10646\))j(c)m(haracter)g(whose)e(v)-5 b(alue)41 -b(is)g(the)g(hex-)1110 5340 y(adecimal)32 b(v)-5 b(alue)31 -b Fr(HHHHHHHH)41 b Fu(\(one)31 b(to)g(eigh)m(t)h(hex)e(digits\))p -eop end +b(alue)39 b Fr(HH)1110 5340 y Fu(\(one)31 b(or)f(t)m(w)m(o)i(hex)e +(digits\))p eop end %%Page: 56 62 TeXDict begin 56 61 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(56)150 299 y Ft(enable)870 -433 y(enable)46 b([-a])h([-dnps])f([-f)g Fj(filename)p -Ft(])g([)p Fj(name)g Ft(...)o(])630 567 y Fu(Enable)36 -b(and)f(disable)h(builtin)g(shell)g(commands.)56 b(Disabling)37 -b(a)g(builtin)e(allo)m(ws)i(a)f(disk)630 676 y(command)e(whic)m(h)g -(has)g(the)g(same)h(name)f(as)h(a)f(shell)h(builtin)e(to)i(b)s(e)f -(executed)h(without)630 786 y(sp)s(ecifying)27 b(a)g(full)g(pathname,)g -(ev)m(en)h(though)f(the)g(shell)g(normally)g(searc)m(hes)h(for)f -(builtins)630 896 y(b)s(efore)35 b(disk)g(commands.)55 -b(If)35 b Ft(-n)g Fu(is)g(used,)h(the)g Fr(name)5 b Fu(s)35 -b(b)s(ecome)h(disabled.)55 b(Otherwise)630 1005 y Fr(name)5 -b Fu(s)44 b(are)h(enabled.)82 b(F)-8 b(or)45 b(example,)k(to)c(use)f -(the)g Ft(test)f Fu(binary)h(found)f(via)h Ft($PATH)630 -1115 y Fu(instead)31 b(of)f(the)h(shell)f(builtin)g(v)m(ersion,)h(t)m -(yp)s(e)g(`)p Ft(enable)e(-n)h(test)p Fu('.)630 1249 -y(If)45 b(the)i Ft(-p)e Fu(option)h(is)g(supplied,)j(or)d(no)g -Fr(name)51 b Fu(argumen)m(ts)46 b(app)s(ear,)k(a)c(list)h(of)f(shell) -630 1358 y(builtins)37 b(is)h(prin)m(ted.)63 b(With)38 +b(Shell)30 b(Builtin)h(Commands)2069 b(56)630 299 y Ft(\\u)p +Fj(HHHH)192 b Fu(the)41 b(Unico)s(de)g(\(ISO/IEC)f(10646\))j(c)m +(haracter)g(whose)e(v)-5 b(alue)41 b(is)g(the)g(hex-)1110 +408 y(adecimal)32 b(v)-5 b(alue)31 b Fr(HHHH)41 b Fu(\(one)31 +b(to)g(four)e(hex)h(digits\))630 567 y Ft(\\U)p Fj(HHHHHHHH)1110 +676 y Fu(the)41 b(Unico)s(de)g(\(ISO/IEC)f(10646\))j(c)m(haracter)g +(whose)e(v)-5 b(alue)41 b(is)g(the)g(hex-)1110 786 y(adecimal)32 +b(v)-5 b(alue)31 b Fr(HHHHHHHH)41 b Fu(\(one)31 b(to)g(eigh)m(t)h(hex)e +(digits\))150 944 y Ft(enable)870 1078 y(enable)46 b([-a])h([-dnps])f +([-f)g Fj(filename)p Ft(])g([)p Fj(name)g Ft(...)o(])630 +1212 y Fu(Enable)36 b(and)f(disable)h(builtin)g(shell)g(commands.)56 +b(Disabling)37 b(a)g(builtin)e(allo)m(ws)i(a)f(disk)630 +1322 y(command)e(whic)m(h)g(has)g(the)g(same)h(name)f(as)h(a)f(shell)h +(builtin)e(to)i(b)s(e)f(executed)h(without)630 1431 y(sp)s(ecifying)27 +b(a)g(full)g(pathname,)g(ev)m(en)h(though)f(the)g(shell)g(normally)g +(searc)m(hes)h(for)f(builtins)630 1541 y(b)s(efore)35 +b(disk)g(commands.)55 b(If)35 b Ft(-n)g Fu(is)g(used,)h(the)g +Fr(name)5 b Fu(s)35 b(b)s(ecome)h(disabled.)55 b(Otherwise)630 +1650 y Fr(name)5 b Fu(s)44 b(are)h(enabled.)82 b(F)-8 +b(or)45 b(example,)k(to)c(use)f(the)g Ft(test)f Fu(binary)h(found)f +(via)h Ft($PATH)630 1760 y Fu(instead)31 b(of)f(the)h(shell)f(builtin)g +(v)m(ersion,)h(t)m(yp)s(e)g(`)p Ft(enable)e(-n)h(test)p +Fu('.)630 1894 y(If)45 b(the)i Ft(-p)e Fu(option)h(is)g(supplied,)j(or) +d(no)g Fr(name)51 b Fu(argumen)m(ts)46 b(app)s(ear,)k(a)c(list)h(of)f +(shell)630 2004 y(builtins)37 b(is)h(prin)m(ted.)63 b(With)38 b(no)f(other)h(argumen)m(ts,)j(the)d(list)g(consists)g(of)g(all)h -(enabled)630 1468 y(shell)d(builtins.)57 b(The)35 b Ft(-a)h +(enabled)630 2113 y(shell)d(builtins.)57 b(The)35 b Ft(-a)h Fu(option)g(means)g(to)g(list)h(eac)m(h)g(builtin)f(with)f(an)h -(indication)h(of)630 1577 y(whether)30 b(or)g(not)h(it)g(is)f(enabled.) -630 1711 y(The)22 b Ft(-f)f Fu(option)h(means)g(to)h(load)g(the)f(new)g +(indication)h(of)630 2223 y(whether)30 b(or)g(not)h(it)g(is)f(enabled.) +630 2357 y(The)22 b Ft(-f)f Fu(option)h(means)g(to)h(load)g(the)f(new)g (builtin)f(command)h Fr(name)27 b Fu(from)22 b(shared)f(ob)5 -b(ject)630 1821 y Fr(\014lename)p Fu(,)33 b(on)e(systems)h(that)h(supp) +b(ject)630 2466 y Fr(\014lename)p Fu(,)33 b(on)e(systems)h(that)h(supp) s(ort)d(dynamic)i(loading.)46 b(The)31 b Ft(-d)g Fu(option)h(will)h -(delete)630 1931 y(a)e(builtin)f(loaded)h(with)f Ft(-f)p -Fu(.)630 2064 y(If)j(there)i(are)f(no)g(options,)h(a)f(list)h(of)f(the) +(delete)630 2576 y(a)e(builtin)f(loaded)h(with)f Ft(-f)p +Fu(.)630 2710 y(If)j(there)i(are)f(no)g(options,)h(a)f(list)h(of)f(the) g(shell)g(builtins)g(is)g(displa)m(y)m(ed.)52 b(The)33 -b Ft(-s)g Fu(option)630 2174 y(restricts)j Ft(enable)d +b Ft(-s)g Fu(option)630 2819 y(restricts)j Ft(enable)d Fu(to)j(the)f Fm(posix)f Fu(sp)s(ecial)i(builtins.)54 b(If)34 b Ft(-s)h Fu(is)g(used)f(with)g Ft(-f)p Fu(,)i(the)f(new)630 -2284 y(builtin)30 b(b)s(ecomes)h(a)f(sp)s(ecial)h(builtin)f(\(see)i -(Section)f(4.4)g([Sp)s(ecial)g(Builtins],)g(page)g(72\).)630 -2418 y(The)26 b(return)f(status)h(is)g(zero)h(unless)e(a)i +2929 y(builtin)30 b(b)s(ecomes)h(a)f(sp)s(ecial)h(builtin)f(\(see)i +(Section)f(4.4)g([Sp)s(ecial)g(Builtins],)g(page)g(73\).)630 +3063 y(The)26 b(return)f(status)h(is)g(zero)h(unless)e(a)i Fr(name)k Fu(is)26 b(not)g(a)h(shell)f(builtin)g(or)g(there)g(is)g(an)g -(error)630 2527 y(loading)31 b(a)g(new)f(builtin)g(from)g(a)g(shared)g -(ob)5 b(ject.)150 2685 y Ft(help)870 2819 y(help)47 b([-dms])f([)p -Fj(pattern)p Ft(])630 2953 y Fu(Displa)m(y)40 b(helpful)e(information)h +(error)630 3173 y(loading)31 b(a)g(new)f(builtin)g(from)g(a)g(shared)g +(ob)5 b(ject.)150 3331 y Ft(help)870 3465 y(help)47 b([-dms])f([)p +Fj(pattern)p Ft(])630 3599 y Fu(Displa)m(y)40 b(helpful)e(information)h (ab)s(out)g(builtin)f(commands.)66 b(If)38 b Fr(pattern)h -Fu(is)g(sp)s(eci\014ed,)630 3063 y Ft(help)28 b Fu(giv)m(es)i(detailed) +Fu(is)g(sp)s(eci\014ed,)630 3708 y Ft(help)28 b Fu(giv)m(es)i(detailed) g(help)e(on)h(all)h(commands)e(matc)m(hing)i Fr(pattern)p -Fu(,)g(otherwise)f(a)g(list)h(of)630 3173 y(the)h(builtins)e(is)i(prin) -m(ted.)630 3306 y(Options,)f(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo) -m(wing)h(meanings:)630 3465 y Ft(-d)384 b Fu(Displa)m(y)32 +Fu(,)g(otherwise)f(a)g(list)h(of)630 3818 y(the)h(builtins)e(is)i(prin) +m(ted.)630 3952 y(Options,)f(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo) +m(wing)h(meanings:)630 4110 y Ft(-d)384 b Fu(Displa)m(y)32 b(a)e(short)g(description)h(of)f(eac)m(h)i Fr(pattern)630 -3623 y Ft(-m)384 b Fu(Displa)m(y)32 b(the)e(description)g(of)h(eac)m(h) +4268 y Ft(-m)384 b Fu(Displa)m(y)32 b(the)e(description)g(of)h(eac)m(h) h Fr(pattern)e Fu(in)g(a)h(manpage-lik)m(e)h(format)630 -3781 y Ft(-s)384 b Fu(Displa)m(y)32 b(only)e(a)h(short)f(usage)h -(synopsis)e(for)i(eac)m(h)g Fr(pattern)630 3940 y Fu(The)f(return)f +4427 y Ft(-s)384 b Fu(Displa)m(y)32 b(only)e(a)h(short)f(usage)h +(synopsis)e(for)i(eac)m(h)g Fr(pattern)630 4585 y Fu(The)f(return)f (status)i(is)f(zero)h(unless)f(no)g(command)h(matc)m(hes)g -Fr(pattern)p Fu(.)150 4098 y Ft(let)870 4232 y(let)47 +Fr(pattern)p Fu(.)150 4743 y Ft(let)870 4877 y(let)47 b Fj(expression)e Ft([)p Fj(expression)g Ft(...)o(])630 -4366 y Fu(The)c Ft(let)g Fu(builtin)g(allo)m(ws)i(arithmetic)f(to)h(b)s +5011 y Fu(The)c Ft(let)g Fu(builtin)g(allo)m(ws)i(arithmetic)f(to)h(b)s (e)d(p)s(erformed)g(on)i(shell)g(v)-5 b(ariables.)74 -b(Eac)m(h)630 4475 y Fr(expression)31 b Fu(is)g(ev)-5 +b(Eac)m(h)630 5121 y Fr(expression)31 b Fu(is)g(ev)-5 b(aluated)32 b(according)f(to)h(the)f(rules)g(giv)m(en)h(b)s(elo)m(w)f -(in)f(Section)i(6.5)g([Shell)630 4585 y(Arithmetic],)51 +(in)f(Section)i(6.5)g([Shell)630 5230 y(Arithmetic],)51 b(page)46 b(93.)87 b(If)45 b(the)g(last)h Fr(expression)g Fu(ev)-5 b(aluates)47 b(to)f(0,)k Ft(let)44 b Fu(returns)g(1;)630 -4695 y(otherwise)31 b(0)g(is)f(returned.)150 4853 y Ft(local)870 -4987 y(local)46 b([)p Fj(option)p Ft(])g Fj(name)p Ft([=)p -Fj(value)p Ft(])e(...)630 5121 y Fu(F)-8 b(or)27 b(eac)m(h)g(argumen)m -(t,)g(a)f(lo)s(cal)h(v)-5 b(ariable)27 b(named)e Fr(name)31 -b Fu(is)26 b(created,)i(and)d(assigned)h Fr(v)-5 b(alue)p -Fu(.)630 5230 y(The)37 b Fr(option)h Fu(can)f(b)s(e)g(an)m(y)h(of)f -(the)h(options)g(accepted)g(b)m(y)g Ft(declare)p Fu(.)59 -b Ft(local)36 b Fu(can)i(only)630 5340 y(b)s(e)j(used)h(within)f(a)i -(function;)48 b(it)42 b(mak)m(es)h(the)f(v)-5 b(ariable)43 -b Fr(name)48 b Fu(ha)m(v)m(e)43 b(a)f(visible)h(scop)s(e)p -eop end +5340 y(otherwise)31 b(0)g(is)f(returned.)p eop end %%Page: 57 63 TeXDict begin 57 62 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(57)630 299 y(restricted)44 -b(to)f(that)h(function)e(and)g(its)i(c)m(hildren.)78 +b(Shell)30 b(Builtin)h(Commands)2069 b(57)150 299 y Ft(local)870 +432 y(local)46 b([)p Fj(option)p Ft(])g Fj(name)p Ft([=)p +Fj(value)p Ft(])e(...)630 565 y Fu(F)-8 b(or)27 b(eac)m(h)g(argumen)m +(t,)g(a)f(lo)s(cal)h(v)-5 b(ariable)27 b(named)e Fr(name)31 +b Fu(is)26 b(created,)i(and)d(assigned)h Fr(v)-5 b(alue)p +Fu(.)630 674 y(The)37 b Fr(option)h Fu(can)f(b)s(e)g(an)m(y)h(of)f(the) +h(options)g(accepted)g(b)m(y)g Ft(declare)p Fu(.)59 b +Ft(local)36 b Fu(can)i(only)630 784 y(b)s(e)j(used)h(within)f(a)i +(function;)48 b(it)42 b(mak)m(es)h(the)f(v)-5 b(ariable)43 +b Fr(name)48 b Fu(ha)m(v)m(e)43 b(a)f(visible)h(scop)s(e)630 +893 y(restricted)h(to)f(that)h(function)e(and)g(its)i(c)m(hildren.)78 b(If)42 b Fr(name)48 b Fu(is)43 b(`)p Ft(-)p Fu(',)j(the)d(set)h(of)f -(shell)630 408 y(options)34 b(is)f(made)g(lo)s(cal)i(to)f(the)f +(shell)630 1003 y(options)34 b(is)f(made)g(lo)s(cal)i(to)f(the)f (function)g(in)g(whic)m(h)g Ft(local)f Fu(is)h(in)m(v)m(ok)m(ed:)48 -b(shell)34 b(options)630 518 y(c)m(hanged)e(using)e(the)i +b(shell)34 b(options)630 1112 y(c)m(hanged)e(using)e(the)i Ft(set)e Fu(builtin)h(inside)g(the)g(function)g(are)g(restored)h(to)g -(their)f(original)630 628 y(v)-5 b(alues)25 b(when)e(the)i(function)f +(their)f(original)630 1222 y(v)-5 b(alues)25 b(when)e(the)i(function)f (returns.)37 b(The)24 b(return)f(status)i(is)f(zero)i(unless)d -Ft(local)g Fu(is)i(used)630 737 y(outside)k(a)f(function,)h(an)f(in)m +Ft(local)g Fu(is)i(used)630 1332 y(outside)k(a)f(function,)h(an)f(in)m (v)-5 b(alid)29 b Fr(name)k Fu(is)28 b(supplied,)g(or)g Fr(name)34 b Fu(is)28 b(a)h(readonly)f(v)-5 b(ariable.)150 -887 y Ft(logout)870 1016 y(logout)46 b([)p Fj(n)p Ft(])630 -1146 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i(status)g(of)f -Fr(n)g Fu(to)h(the)g(shell's)f(paren)m(t.)150 1295 y -Ft(mapfile)870 1425 y(mapfile)46 b([-d)h Fj(delim)p Ft(])f([-n)h +1488 y Ft(logout)870 1621 y(logout)46 b([)p Fj(n)p Ft(])630 +1753 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i(status)g(of)f +Fr(n)g Fu(to)h(the)g(shell's)f(paren)m(t.)150 1910 y +Ft(mapfile)870 2042 y(mapfile)46 b([-d)h Fj(delim)p Ft(])f([-n)h Fj(count)p Ft(])f([-O)h Fj(origin)p Ft(])f([-s)g Fj(count)p -Ft(])1061 1534 y([-t])h([-u)f Fj(fd)p Ft(])h([-C)g Fj(callback)p +Ft(])1061 2152 y([-t])h([-u)f Fj(fd)p Ft(])h([-C)g Fj(callback)p Ft(])f([-c)g Fj(quantum)p Ft(])g([)p Fj(array)p Ft(])630 -1664 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j +2285 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j (the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38 b Fr(arra)m(y)p -Fu(,)i(or)630 1773 y(from)28 b(\014le)h(descriptor)f +Fu(,)i(or)630 2394 y(from)28 b(\014le)h(descriptor)f Fr(fd)k Fu(if)c(the)h Ft(-u)f Fu(option)h(is)g(supplied.)39 b(The)28 b(v)-5 b(ariable)29 b Ft(MAPFILE)e Fu(is)i(the)630 -1883 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30 +2504 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30 b(if)g(supplied,)g(ha)m(v)m(e)h(the)g(follo)m(wing)h(meanings:)630 -2032 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f +2660 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f Fr(delim)g Fu(is)f(used)g(to)h(terminate)h(eac)m(h)g(input)d(line,)1110 -2142 y(rather)41 b(than)h(newline.)74 b(If)41 b Fr(delim)h +2770 y(rather)41 b(than)h(newline.)74 b(If)41 b Fr(delim)h Fu(is)g(the)f(empt)m(y)h(string,)j Ft(mapfile)40 b Fu(will)1110 -2252 y(terminate)31 b(a)g(line)g(when)e(it)i(reads)f(a)h(NUL)g(c)m -(haracter.)630 2401 y Ft(-n)384 b Fu(Cop)m(y)30 b(at)h(most)g +2879 y(terminate)31 b(a)g(line)g(when)e(it)i(reads)f(a)h(NUL)g(c)m +(haracter.)630 3035 y Ft(-n)384 b Fu(Cop)m(y)30 b(at)h(most)g Fr(coun)m(t)i Fu(lines.)41 b(If)30 b Fr(coun)m(t)j Fu(is)d(0,)h(all)h -(lines)e(are)h(copied.)630 2550 y Ft(-O)384 b Fu(Begin)31 +(lines)e(are)h(copied.)630 3191 y Ft(-O)384 b Fu(Begin)31 b(assigning)g(to)g Fr(arra)m(y)39 b Fu(at)31 b(index)f Fr(origin)p Fu(.)41 b(The)30 b(default)h(index)f(is)g(0.)630 -2700 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g Fr(coun)m(t)j -Fu(lines)e(read.)630 2849 y Ft(-t)384 b Fu(Remo)m(v)m(e)32 +3347 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g Fr(coun)m(t)j +Fu(lines)e(read.)630 3504 y Ft(-t)384 b Fu(Remo)m(v)m(e)32 b(a)f(trailing)g Fr(delim)g Fu(\(default)g(newline\))f(from)g(eac)m(h)i -(line)f(read.)630 2999 y Ft(-u)384 b Fu(Read)31 b(lines)f(from)g +(line)f(read.)630 3660 y Ft(-u)384 b Fu(Read)31 b(lines)f(from)g (\014le)h(descriptor)f Fr(fd)j Fu(instead)e(of)f(the)h(standard)e -(input.)630 3148 y Ft(-C)384 b Fu(Ev)-5 b(aluate)26 b +(input.)630 3816 y Ft(-C)384 b Fu(Ev)-5 b(aluate)26 b Fr(callbac)m(k)33 b Fu(eac)m(h)26 b(time)g Fr(quan)m(tum)f Fu(lines)g(are)g(read.)39 b(The)25 b Ft(-c)f Fu(option)1110 -3258 y(sp)s(eci\014es)30 b Fr(quan)m(tum)p Fu(.)630 3407 +3925 y(sp)s(eci\014es)30 b Fr(quan)m(tum)p Fu(.)630 4081 y Ft(-c)384 b Fu(Sp)s(ecify)30 b(the)g(n)m(um)m(b)s(er)f(of)i(lines)f (read)h(b)s(et)m(w)m(een)g(eac)m(h)g(call)h(to)f Fr(callbac)m(k)p -Fu(.)630 3557 y(If)36 b Ft(-C)g Fu(is)g(sp)s(eci\014ed)g(without)g +Fu(.)630 4237 y(If)36 b Ft(-C)g Fu(is)g(sp)s(eci\014ed)g(without)g Ft(-c)p Fu(,)h(the)g(default)f(quan)m(tum)g(is)h(5000.)60 -b(When)36 b Fr(callbac)m(k)44 b Fu(is)630 3666 y(ev)-5 +b(When)36 b Fr(callbac)m(k)44 b Fu(is)630 4347 y(ev)-5 b(aluated,)30 b(it)e(is)g(supplied)f(the)h(index)f(of)i(the)f(next)g (arra)m(y)g(elemen)m(t)h(to)g(b)s(e)e(assigned)i(and)630 -3776 y(the)39 b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i +4457 y(the)39 b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i (as)e(additional)h(argumen)m(ts.)66 b Fr(callbac)m(k)47 -b Fu(is)630 3885 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read) +b Fu(is)630 4566 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read) g(but)g(b)s(efore)g(the)h(arra)m(y)g(elemen)m(t)g(is)g(assigned.)630 -4015 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g +4699 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g Ft(mapfile)c Fu(will)j(clear)g Fr(arra)m(y)34 b Fu(b)s(efore)24 -b(assigning)630 4125 y(to)31 b(it.)630 4254 y Ft(mapfile)41 +b(assigning)630 4809 y(to)31 b(it.)630 4941 y Ft(mapfile)41 b Fu(returns)g(successfully)i(unless)e(an)i(in)m(v)-5 b(alid)43 b(option)g(or)g(option)g(argumen)m(t)g(is)630 -4364 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5 +5051 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5 b(alid)31 b(or)g(unassignable,)f(or)h Fr(arra)m(y)38 b Fu(is)31 b(not)f(an)h(indexed)e(arra)m(y)-8 b(.)150 -4513 y Ft(printf)870 4643 y(printf)46 b([-v)h Fj(var)p -Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])630 4772 -y Fu(W)-8 b(rite)27 b(the)g(formatted)f Fr(argumen)m(ts)k -Fu(to)d(the)f(standard)f(output)h(under)e(the)i(con)m(trol)i(of)e(the) -630 4882 y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g -(the)g(output)g(to)g(b)s(e)f(assigned)h(to)h(the)f(v)-5 -b(ariable)39 b Fr(v)-5 b(ar)630 4991 y Fu(rather)30 b(than)g(b)s(eing)g -(prin)m(ted)g(to)h(the)g(standard)e(output.)630 5121 -y(The)36 b Fr(format)i Fu(is)f(a)f(c)m(haracter)i(string)e(whic)m(h)g -(con)m(tains)i(three)e(t)m(yp)s(es)g(of)h(ob)5 b(jects:)53 -b(plain)630 5230 y(c)m(haracters,)41 b(whic)m(h)c(are)h(simply)e -(copied)i(to)g(standard)f(output,)i(c)m(haracter)g(escap)s(e)e(se-)630 -5340 y(quences,)g(whic)m(h)f(are)g(con)m(v)m(erted)h(and)f(copied)g(to) -g(the)g(standard)f(output,)i(and)f(format)p eop end +5207 y Ft(printf)870 5340 y(printf)46 b([-v)h Fj(var)p +Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])p eop end %%Page: 58 64 TeXDict begin 58 63 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(58)630 299 y(sp)s -(eci\014cations,)39 b(eac)m(h)e(of)g(whic)m(h)f(causes)g(prin)m(ting)g -(of)h(the)f(next)h(successiv)m(e)g Fr(argumen)m(t)p Fu(.)630 -408 y(In)24 b(addition)h(to)g(the)g(standard)f Ft(printf\(1\))e -Fu(formats,)27 b Ft(printf)c Fu(in)m(terprets)i(the)f(follo)m(wing)630 -518 y(extensions:)630 690 y Ft(\045b)384 b Fu(Causes)38 -b Ft(printf)f Fu(to)j(expand)e(bac)m(kslash)h(escap)s(e)g(sequences)g -(in)f(the)h(cor-)1110 800 y(resp)s(onding)31 b Fr(argumen)m(t)j -Fu(in)e(the)h(same)f(w)m(a)m(y)h(as)g Ft(echo)c(-e)j -Fu(\(see)h(Section)g(4.2)1110 909 y([Bash)e(Builtins],)g(page)g(51\).) -630 1082 y Ft(\045q)384 b Fu(Causes)32 b Ft(printf)e -Fu(to)i(output)g(the)g(corresp)s(onding)f Fr(argumen)m(t)j -Fu(in)d(a)i(format)1110 1191 y(that)e(can)g(b)s(e)e(reused)h(as)h -(shell)f(input.)630 1363 y Ft(\045\()p Fj(datefmt)p Ft(\)T)1110 -1473 y Fu(Causes)f Ft(printf)e Fu(to)j(output)f(the)g(date-time)i -(string)e(resulting)h(from)e(using)1110 1583 y Fr(datefm)m(t)45 -b Fu(as)d(a)g(format)g(string)g(for)g Ft(strftime)p Fu(\(3\).)74 -b(The)41 b(corresp)s(onding)1110 1692 y Fr(argumen)m(t)h -Fu(is)e(an)g(in)m(teger)i(represen)m(ting)e(the)g(n)m(um)m(b)s(er)f(of) -h(seconds)g(since)1110 1802 y(the)24 b(ep)s(o)s(c)m(h.)38 -b(Tw)m(o)24 b(sp)s(ecial)h(argumen)m(t)f(v)-5 b(alues)24 -b(ma)m(y)h(b)s(e)e(used:)36 b(-1)25 b(represen)m(ts)1110 -1911 y(the)30 b(curren)m(t)g(time,)h(and)e(-2)i(represen)m(ts)f(the)g -(time)h(the)f(shell)g(w)m(as)g(in)m(v)m(ok)m(ed.)1110 -2021 y(If)38 b(no)g(argumen)m(t)h(is)f(sp)s(eci\014ed,)i(con)m(v)m +b(Shell)30 b(Builtin)h(Commands)2069 b(58)630 299 y(W)-8 +b(rite)27 b(the)g(formatted)f Fr(argumen)m(ts)k Fu(to)d(the)f(standard) +f(output)h(under)e(the)i(con)m(trol)i(of)e(the)630 408 +y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g(the)g +(output)g(to)g(b)s(e)f(assigned)h(to)h(the)f(v)-5 b(ariable)39 +b Fr(v)-5 b(ar)630 518 y Fu(rather)30 b(than)g(b)s(eing)g(prin)m(ted)g +(to)h(the)g(standard)e(output.)630 651 y(The)36 b Fr(format)i +Fu(is)f(a)f(c)m(haracter)i(string)e(whic)m(h)g(con)m(tains)i(three)e(t) +m(yp)s(es)g(of)h(ob)5 b(jects:)53 b(plain)630 761 y(c)m(haracters,)41 +b(whic)m(h)c(are)h(simply)e(copied)i(to)g(standard)f(output,)i(c)m +(haracter)g(escap)s(e)e(se-)630 870 y(quences,)g(whic)m(h)f(are)g(con)m +(v)m(erted)h(and)f(copied)g(to)g(the)g(standard)f(output,)i(and)f +(format)630 980 y(sp)s(eci\014cations,)j(eac)m(h)e(of)g(whic)m(h)f +(causes)g(prin)m(ting)g(of)h(the)f(next)h(successiv)m(e)g +Fr(argumen)m(t)p Fu(.)630 1089 y(In)24 b(addition)h(to)g(the)g +(standard)f Ft(printf\(1\))e Fu(formats,)27 b Ft(printf)c +Fu(in)m(terprets)i(the)f(follo)m(wing)630 1199 y(extensions:)630 +1356 y Ft(\045b)384 b Fu(Causes)38 b Ft(printf)f Fu(to)j(expand)e(bac)m +(kslash)h(escap)s(e)g(sequences)g(in)f(the)h(cor-)1110 +1465 y(resp)s(onding)31 b Fr(argumen)m(t)j Fu(in)e(the)h(same)f(w)m(a)m +(y)h(as)g Ft(echo)c(-e)j Fu(\(see)h(Section)g(4.2)1110 +1575 y([Bash)e(Builtins],)g(page)g(51\).)630 1731 y Ft(\045q)384 +b Fu(Causes)32 b Ft(printf)e Fu(to)i(output)g(the)g(corresp)s(onding)f +Fr(argumen)m(t)j Fu(in)d(a)i(format)1110 1841 y(that)e(can)g(b)s(e)e +(reused)h(as)h(shell)f(input.)630 1998 y Ft(\045\()p +Fj(datefmt)p Ft(\)T)1110 2107 y Fu(Causes)f Ft(printf)e +Fu(to)j(output)f(the)g(date-time)i(string)e(resulting)h(from)e(using) +1110 2217 y Fr(datefm)m(t)45 b Fu(as)d(a)g(format)g(string)g(for)g +Ft(strftime)p Fu(\(3\).)74 b(The)41 b(corresp)s(onding)1110 +2326 y Fr(argumen)m(t)h Fu(is)e(an)g(in)m(teger)i(represen)m(ting)e +(the)g(n)m(um)m(b)s(er)f(of)h(seconds)g(since)1110 2436 +y(the)24 b(ep)s(o)s(c)m(h.)38 b(Tw)m(o)24 b(sp)s(ecial)h(argumen)m(t)f +(v)-5 b(alues)24 b(ma)m(y)h(b)s(e)e(used:)36 b(-1)25 +b(represen)m(ts)1110 2545 y(the)30 b(curren)m(t)g(time,)h(and)e(-2)i +(represen)m(ts)f(the)g(time)h(the)f(shell)g(w)m(as)g(in)m(v)m(ok)m(ed.) +1110 2655 y(If)38 b(no)g(argumen)m(t)h(is)f(sp)s(eci\014ed,)i(con)m(v)m (ersion)f(b)s(eha)m(v)m(es)g(as)g(if)f(-1)h(had)f(b)s(een)1110 -2131 y(giv)m(en.)k(This)29 b(is)i(an)f(exception)i(to)f(the)f(usual)g -Ft(printf)f Fu(b)s(eha)m(vior.)630 2303 y(Argumen)m(ts)f(to)h +2765 y(giv)m(en.)k(This)29 b(is)i(an)f(exception)i(to)f(the)f(usual)g +Ft(printf)f Fu(b)s(eha)m(vior.)630 2921 y(Argumen)m(ts)f(to)h (non-string)e(format)i(sp)s(eci\014ers)e(are)h(treated)h(as)g(C)e -(language)j(constan)m(ts,)630 2412 y(except)22 b(that)g(a)g(leading)g +(language)j(constan)m(ts,)630 3031 y(except)22 b(that)g(a)g(leading)g (plus)e(or)h(min)m(us)f(sign)i(is)f(allo)m(w)m(ed,)k(and)c(if)g(the)g -(leading)h(c)m(haracter)h(is)630 2522 y(a)i(single)g(or)f(double)h +(leading)h(c)m(haracter)h(is)630 3140 y(a)i(single)g(or)f(double)h (quote,)h(the)f(v)-5 b(alue)25 b(is)f(the)h(ASCI)s(I)e(v)-5 b(alue)25 b(of)f(the)h(follo)m(wing)h(c)m(haracter.)630 -2663 y(The)31 b Fr(format)i Fu(is)f(reused)e(as)i(necessary)f(to)i +3273 y(The)31 b Fr(format)i Fu(is)f(reused)e(as)i(necessary)f(to)i (consume)e(all)h(of)f(the)h Fr(argumen)m(ts)p Fu(.)44 -b(If)30 b(the)i Fr(for-)630 2772 y(mat)c Fu(requires)e(more)g +b(If)30 b(the)i Fr(for-)630 3383 y(mat)c Fu(requires)e(more)g Fr(argumen)m(ts)k Fu(than)25 b(are)i(supplied,)e(the)h(extra)h(format)f -(sp)s(eci\014cations)630 2882 y(b)s(eha)m(v)m(e)j(as)g(if)f(a)h(zero)g +(sp)s(eci\014cations)630 3493 y(b)s(eha)m(v)m(e)j(as)g(if)f(a)h(zero)g (v)-5 b(alue)29 b(or)g(n)m(ull)f(string,)h(as)g(appropriate,)g(had)f(b) -s(een)g(supplied.)38 b(The)630 2992 y(return)29 b(v)-5 +s(een)g(supplied.)38 b(The)630 3602 y(return)29 b(v)-5 b(alue)31 b(is)g(zero)g(on)f(success,)h(non-zero)g(on)f(failure.)150 -3164 y Ft(read)870 3305 y(read)47 b([-ers])f([-a)h Fj(aname)p +3759 y Ft(read)870 3892 y(read)47 b([-ers])f([-a)h Fj(aname)p Ft(])f([-d)h Fj(delim)p Ft(])f([-i)h Fj(text)p Ft(])f([-n)h -Fj(nchars)p Ft(])1061 3414 y([-N)g Fj(nchars)p Ft(])f([-p)h +Fj(nchars)p Ft(])1061 4001 y([-N)g Fj(nchars)p Ft(])f([-p)h Fj(prompt)p Ft(])e([-t)i Fj(timeout)p Ft(])f([-u)h Fj(fd)p -Ft(])g([)p Fj(name)f Ft(...)o(])630 3555 y Fu(One)38 +Ft(])g([)p Fj(name)f Ft(...)o(])630 4134 y Fu(One)38 b(line)g(is)g(read)g(from)g(the)g(standard)f(input,)j(or)e(from)f(the)i -(\014le)f(descriptor)g Fr(fd)j Fu(sup-)630 3665 y(plied)34 +(\014le)f(descriptor)g Fr(fd)j Fu(sup-)630 4244 y(plied)34 b(as)h(an)f(argumen)m(t)h(to)g(the)f Ft(-u)g Fu(option,)i(split)f(in)m (to)g(w)m(ords)f(as)g(describ)s(ed)g(ab)s(o)m(v)m(e)h(in)630 -3774 y(Section)j(3.5.7)h([W)-8 b(ord)38 b(Splitting],)i(page)e(32,)j +4354 y(Section)j(3.5.7)h([W)-8 b(ord)38 b(Splitting],)i(page)e(32,)j (and)36 b(the)i(\014rst)f(w)m(ord)g(is)g(assigned)h(to)g(the)630 -3884 y(\014rst)32 b Fr(name)p Fu(,)h(the)g(second)g(w)m(ord)f(to)h(the) +4463 y(\014rst)32 b Fr(name)p Fu(,)h(the)g(second)g(w)m(ord)f(to)h(the) g(second)g Fr(name)p Fu(,)g(and)f(so)h(on.)47 b(If)32 -b(there)h(are)g(more)630 3994 y(w)m(ords)39 b(than)g(names,)j(the)e +b(there)h(are)g(more)630 4573 y(w)m(ords)39 b(than)g(names,)j(the)e (remaining)f(w)m(ords)g(and)g(their)h(in)m(terv)m(ening)g(delimiters)h -(are)630 4103 y(assigned)29 b(to)h(the)g(last)g Fr(name)p +(are)630 4682 y(assigned)29 b(to)h(the)g(last)g Fr(name)p Fu(.)40 b(If)29 b(there)g(are)h(few)m(er)f(w)m(ords)g(read)g(from)g -(the)g(input)g(stream)630 4213 y(than)35 b(names,)i(the)e(remaining)h +(the)g(input)g(stream)630 4792 y(than)35 b(names,)i(the)e(remaining)h (names)f(are)h(assigned)f(empt)m(y)h(v)-5 b(alues.)56 -b(The)34 b(c)m(haracters)630 4322 y(in)e(the)h(v)-5 b(alue)33 +b(The)34 b(c)m(haracters)630 4902 y(in)e(the)h(v)-5 b(alue)33 b(of)g(the)g Ft(IFS)f Fu(v)-5 b(ariable)33 b(are)h(used)d(to)j(split)f -(the)g(line)g(in)m(to)g(w)m(ords)g(using)f(the)630 4432 +(the)g(line)g(in)m(to)g(w)m(ords)g(using)f(the)630 5011 y(same)d(rules)f(the)g(shell)h(uses)f(for)g(expansion)g(\(describ)s(ed) g(ab)s(o)m(v)m(e)i(in)e(Section)h(3.5.7)h([W)-8 b(ord)630 -4542 y(Splitting],)38 b(page)f(32\).)60 b(The)35 b(bac)m(kslash)i(c)m +5121 y(Splitting],)38 b(page)f(32\).)60 b(The)35 b(bac)m(kslash)i(c)m (haracter)h(`)p Ft(\\)p Fu(')e(ma)m(y)h(b)s(e)f(used)f(to)i(remo)m(v)m -(e)h(an)m(y)630 4651 y(sp)s(ecial)i(meaning)g(for)f(the)g(next)h(c)m +(e)h(an)m(y)630 5230 y(sp)s(ecial)i(meaning)g(for)f(the)g(next)h(c)m (haracter)h(read)e(and)g(for)g(line)h(con)m(tin)m(uation.)69 -b(If)39 b(no)630 4761 y(names)c(are)h(supplied,)f(the)h(line)g(read)f +b(If)39 b(no)630 5340 y(names)c(are)h(supplied,)f(the)h(line)g(read)f (is)g(assigned)h(to)g(the)f(v)-5 b(ariable)36 b Ft(REPLY)p -Fu(.)54 b(The)35 b(exit)630 4870 y(status)f(is)f(zero,)i(unless)e -(end-of-\014le)h(is)f(encoun)m(tered,)i Ft(read)e Fu(times)h(out)f -(\(in)h(whic)m(h)f(case)630 4980 y(the)g(status)h(is)f(greater)i(than)e -(128\),)j(a)e(v)-5 b(ariable)34 b(assignmen)m(t)g(error)f(\(suc)m(h)g -(as)g(assigning)630 5089 y(to)38 b(a)f(readonly)g(v)-5 -b(ariable\))38 b(o)s(ccurs,)h(or)e(an)g(in)m(v)-5 b(alid)38 -b(\014le)f(descriptor)g(is)g(supplied)e(as)j(the)630 -5199 y(argumen)m(t)31 b(to)g Ft(-u)p Fu(.)630 5340 y(Options,)f(if)h -(supplied,)e(ha)m(v)m(e)i(the)g(follo)m(wing)h(meanings:)p -eop end +Fu(.)54 b(The)35 b(exit)p eop end %%Page: 59 65 TeXDict begin 59 64 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(59)630 299 y Ft(-a)30 -b Fj(aname)114 b Fu(The)34 b(w)m(ords)f(are)i(assigned)f(to)h(sequen)m -(tial)h(indices)e(of)g(the)g(arra)m(y)h(v)-5 b(ariable)1110 -408 y Fr(aname)p Fu(,)29 b(starting)h(at)f(0.)40 b(All)29 -b(elemen)m(ts)h(are)e(remo)m(v)m(ed)i(from)d Fr(aname)34 -b Fu(b)s(efore)1110 518 y(the)d(assignmen)m(t.)41 b(Other)30 -b Fr(name)36 b Fu(argumen)m(ts)30 b(are)h(ignored.)630 -671 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f +b(Shell)30 b(Builtin)h(Commands)2069 b(59)630 299 y(status)34 +b(is)f(zero,)i(unless)e(end-of-\014le)h(is)f(encoun)m(tered,)i +Ft(read)e Fu(times)h(out)f(\(in)h(whic)m(h)f(case)630 +408 y(the)g(status)h(is)f(greater)i(than)e(128\),)j(a)e(v)-5 +b(ariable)34 b(assignmen)m(t)g(error)f(\(suc)m(h)g(as)g(assigning)630 +518 y(to)38 b(a)f(readonly)g(v)-5 b(ariable\))38 b(o)s(ccurs,)h(or)e +(an)g(in)m(v)-5 b(alid)38 b(\014le)f(descriptor)g(is)g(supplied)e(as)j +(the)630 628 y(argumen)m(t)31 b(to)g Ft(-u)p Fu(.)630 +763 y(Options,)f(if)h(supplied,)e(ha)m(v)m(e)i(the)g(follo)m(wing)h +(meanings:)630 925 y Ft(-a)e Fj(aname)114 b Fu(The)34 +b(w)m(ords)f(are)i(assigned)f(to)h(sequen)m(tial)h(indices)e(of)g(the)g +(arra)m(y)h(v)-5 b(ariable)1110 1035 y Fr(aname)p Fu(,)29 +b(starting)h(at)f(0.)40 b(All)29 b(elemen)m(ts)h(are)e(remo)m(v)m(ed)i +(from)d Fr(aname)34 b Fu(b)s(efore)1110 1144 y(the)d(assignmen)m(t.)41 +b(Other)30 b Fr(name)36 b Fu(argumen)m(ts)30 b(are)h(ignored.)630 +1306 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f Fr(delim)g Fu(is)g(used)g(to)g(terminate)h(the)f(input)f(line,)1110 -781 y(rather)31 b(than)g(newline.)42 b(If)30 b Fr(delim)h +1416 y(rather)31 b(than)g(newline.)42 b(If)30 b Fr(delim)h Fu(is)g(the)h(empt)m(y)f(string,)g Ft(read)f Fu(will)h(termi-)1110 -891 y(nate)g(a)g(line)f(when)g(it)h(reads)f(a)h(NUL)f(c)m(haracter.)630 -1044 y Ft(-e)384 b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command)f -(Line)h(Editing],)50 b(page)45 b(109\))i(is)1110 1154 +1525 y(nate)g(a)g(line)f(when)g(it)h(reads)f(a)h(NUL)f(c)m(haracter.) +630 1687 y Ft(-e)384 b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command) +f(Line)h(Editing],)50 b(page)45 b(109\))i(is)1110 1797 y(used)37 b(to)i(obtain)g(the)f(line.)65 b(Readline)39 b(uses)e(the)i(curren)m(t)f(\(or)g(default,)j(if)1110 -1263 y(line)h(editing)g(w)m(as)g(not)g(previously)f(activ)m(e\))k -(editing)d(settings,)j(but)c(uses)1110 1373 y(Readline's)31 -b(default)g(\014lename)f(completion.)630 1526 y Ft(-i)g +1906 y(line)h(editing)g(w)m(as)g(not)g(previously)f(activ)m(e\))k +(editing)d(settings,)j(but)c(uses)1110 2016 y(Readline's)31 +b(default)g(\014lename)f(completion.)630 2178 y Ft(-i)g Fj(text)162 b Fu(If)36 b(Readline)i(is)f(b)s(eing)g(used)f(to)h(read)g (the)g(line,)j Fr(text)f Fu(is)e(placed)h(in)m(to)g(the)1110 -1636 y(editing)31 b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630 -1789 y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j +2287 y(editing)31 b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630 +2449 y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j (reading)f Fr(nc)m(hars)j Fu(c)m(haracters)e(rather)f(than)g(w)m -(aiting)1110 1899 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f -(honors)g(a)h(delimiter)g(if)f(few)m(er)h(than)1110 2008 +(aiting)1110 2559 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f +(honors)g(a)h(delimiter)g(if)f(few)m(er)h(than)1110 2668 y Fr(nc)m(hars)d Fu(c)m(haracters)e(are)e(read)h(b)s(efore)f(the)g -(delimiter.)630 2162 y Ft(-N)g Fj(nchars)66 b Ft(read)39 +(delimiter.)630 2830 y Ft(-N)g Fj(nchars)66 b Ft(read)39 b Fu(returns)f(after)j(reading)e(exactly)j Fr(nc)m(hars)h -Fu(c)m(haracters)f(rather)d(than)1110 2271 y(w)m(aiting)32 +Fu(c)m(haracters)f(rather)d(than)1110 2939 y(w)m(aiting)32 b(for)f(a)g(complete)i(line)e(of)g(input,)g(unless)f(EOF)h(is)g(encoun) -m(tered)g(or)1110 2381 y Ft(read)f Fu(times)i(out.)43 +m(tered)g(or)1110 3049 y Ft(read)f Fu(times)i(out.)43 b(Delimiter)33 b(c)m(haracters)f(encoun)m(tered)g(in)f(the)g(input)g -(are)1110 2491 y(not)g(treated)h(sp)s(ecially)f(and)f(do)h(not)g(cause) +(are)1110 3159 y(not)g(treated)h(sp)s(ecially)f(and)f(do)h(not)g(cause) g Ft(read)e Fu(to)j(return)d(un)m(til)i Fr(nc)m(hars)1110 -2600 y Fu(c)m(haracters)26 b(are)f(read.)38 b(The)24 +3268 y Fu(c)m(haracters)26 b(are)f(read.)38 b(The)24 b(result)g(is)h(not)f(split)h(on)f(the)h(c)m(haracters)h(in)e -Ft(IFS)p Fu(;)1110 2710 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5 +Ft(IFS)p Fu(;)1110 3378 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5 b(ariable)23 b(is)f(assigned)g(exactly)i(the)e(c)m(haracters)i(read) -1110 2819 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g -(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 2973 y +1110 3487 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g +(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 3649 y Ft(-p)f Fj(prompt)66 b Fu(Displa)m(y)38 b Fr(prompt)p Fu(,)g(without)e(a)h(trailing)h(newline,)h(b)s(efore)d(attempting)i(to) -1110 3082 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m -(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 3192 y(from)30 -b(a)h(terminal.)630 3345 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f +1110 3759 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m +(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 3868 y(from)30 +b(a)h(terminal.)630 4030 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f (giv)m(en,)k(bac)m(kslash)d(do)s(es)f(not)h(act)h(as)f(an)f(escap)s(e)h -(c)m(haracter.)1110 3455 y(The)30 b(bac)m(kslash)i(is)f(considered)g +(c)m(haracter.)1110 4140 y(The)30 b(bac)m(kslash)i(is)f(considered)g (to)h(b)s(e)e(part)h(of)g(the)g(line.)43 b(In)30 b(particular,)i(a)1110 -3565 y(bac)m(kslash-newline)26 b(pair)e(ma)m(y)h(not)g(then)g(b)s(e)f -(used)g(as)h(a)g(line)g(con)m(tin)m(uation.)630 3718 +4249 y(bac)m(kslash-newline)26 b(pair)e(ma)m(y)h(not)g(then)g(b)s(e)f +(used)g(as)h(a)g(line)g(con)m(tin)m(uation.)630 4411 y Ft(-s)384 b Fu(Silen)m(t)28 b(mo)s(de.)40 b(If)27 b(input)f(is)i (coming)g(from)f(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 -3828 y(ec)m(ho)s(ed.)630 3981 y Ft(-t)i Fj(timeout)1110 -4091 y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f -(failure)i(if)g(a)g(complete)h(line)f(of)1110 4200 y(input)26 +4521 y(ec)m(ho)s(ed.)630 4682 y Ft(-t)i Fj(timeout)1110 +4792 y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f +(failure)i(if)g(a)g(complete)h(line)f(of)1110 4902 y(input)26 b(\(or)h(a)g(sp)s(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters\))h -(is)f(not)g(read)g(within)f Fr(time-)1110 4310 y(out)37 +(is)f(not)g(read)g(within)f Fr(time-)1110 5011 y(out)37 b Fu(seconds.)53 b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h(decimal)h(n) -m(um)m(b)s(er)d(with)h(a)h(fractional)1110 4419 y(p)s(ortion)29 +m(um)m(b)s(er)d(with)h(a)h(fractional)1110 5121 y(p)s(ortion)29 b(follo)m(wing)h(the)f(decimal)h(p)s(oin)m(t.)40 b(This)29 -b(option)g(is)g(only)g(e\013ectiv)m(e)j(if)1110 4529 +b(option)g(is)g(only)g(e\013ectiv)m(e)j(if)1110 5230 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h(terminal,)i(pip)s(e,)e -(or)g(other)f(sp)s(ecial)i(\014le;)1110 4639 y(it)31 +(or)g(other)f(sp)s(ecial)i(\014le;)1110 5340 y(it)31 b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g(\014les.)42 -b(If)30 b Ft(read)g Fu(times)h(out,)1110 4748 y Ft(read)d -Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)m(to)h(the)e(sp)s -(eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p Fu(.)1110 -4858 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e Fu(returns)f -(immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110 -4967 y(and)30 b(data.)44 b(The)30 b(exit)i(status)f(is)g(0)g(if)g -(input)f(is)h(a)m(v)-5 b(ailable)34 b(on)c(the)i(sp)s(eci\014ed)1110 -5077 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46 -b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 5187 -y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 5340 -y Ft(-u)g Fj(fd)258 b Fu(Read)31 b(input)e(from)h(\014le)g(descriptor)h -Fr(fd)p Fu(.)p eop end +b(If)30 b Ft(read)g Fu(times)h(out,)p eop end %%Page: 60 66 TeXDict begin 60 65 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(60)150 299 y Ft(readarray)870 -408 y(readarray)45 b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p -Ft(])f([-O)h Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])1061 -518 y([-t])g([-u)f Fj(fd)p Ft(])h([-C)g Fj(callback)p -Ft(])f([-c)g Fj(quantum)p Ft(])g([)p Fj(array)p Ft(])630 -650 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j -(the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38 b Fr(arra)m(y)p -Fu(,)i(or)630 760 y(from)30 b(\014le)g(descriptor)h Fr(fd)i -Fu(if)d(the)h Ft(-u)e Fu(option)i(is)g(supplied.)630 -892 y(A)f(synon)m(ym)g(for)g Ft(mapfile)p Fu(.)150 1047 -y Ft(source)870 1179 y(source)46 b Fj(filename)630 1312 -y Fu(A)30 b(synon)m(ym)g(for)g Ft(.)g Fu(\(see)i(Section)f(4.1)g -([Bourne)g(Shell)f(Builtins],)h(page)g(44\).)150 1467 -y Ft(type)870 1599 y(type)47 b([-afptP])e([)p Fj(name)i -Ft(...)o(])630 1731 y Fu(F)-8 b(or)42 b(eac)m(h)g Fr(name)p -Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m(terpreted)g(if) -g(used)f(as)i(a)f(command)630 1841 y(name.)630 1973 y(If)g(the)g -Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c Fu(prin)m(ts)h(a)h(single)g -(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p Ft(alias)p -Fu(',)630 2083 y(`)p Ft(function)p Fu(',)32 b(`)p Ft(builtin)p -Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p Ft(keyword)p Fu(',)f(if)h -Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e(function,)630 -2192 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h(reserv)m(ed)g -(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55 b(If)34 b(the)h -Fr(name)40 b Fu(is)35 b(not)630 2302 y(found,)29 b(then)h(nothing)h(is) -f(prin)m(ted,)g(and)g Ft(type)f Fu(returns)g(a)i(failure)g(status.)630 -2434 y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h -Ft(type)e Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g -(that)h(w)m(ould)630 2544 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g +b(Shell)30 b(Builtin)h(Commands)2069 b(60)1110 299 y +Ft(read)28 b Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)m +(to)h(the)e(sp)s(eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p +Fu(.)1110 408 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e +Fu(returns)f(immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110 +518 y(an)m(y)c(data.)44 b(The)31 b(exit)h(status)f(is)h(0)f(if)h(input) +e(is)h(a)m(v)-5 b(ailable)34 b(on)d(the)h(sp)s(eci\014ed)1110 +628 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46 +b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 737 +y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 908 y +Ft(-u)g Fj(fd)258 b Fu(Read)31 b(input)e(from)h(\014le)g(descriptor)h +Fr(fd)p Fu(.)150 1079 y Ft(readarray)870 1189 y(readarray)45 +b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p Ft(])f([-O)h +Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])1061 1298 y([-t])g([-u)f +Fj(fd)p Ft(])h([-C)g Fj(callback)p Ft(])f([-c)g Fj(quantum)p +Ft(])g([)p Fj(array)p Ft(])630 1439 y Fu(Read)38 b(lines)f(from)g(the)h +(standard)e(input)g(in)m(to)j(the)e(indexed)g(arra)m(y)h(v)-5 +b(ariable)38 b Fr(arra)m(y)p Fu(,)i(or)630 1548 y(from)30 +b(\014le)g(descriptor)h Fr(fd)i Fu(if)d(the)h Ft(-u)e +Fu(option)i(is)g(supplied.)630 1688 y(A)f(synon)m(ym)g(for)g +Ft(mapfile)p Fu(.)150 1859 y Ft(source)870 2000 y(source)46 +b Fj(filename)630 2140 y Fu(A)30 b(synon)m(ym)g(for)g +Ft(.)g Fu(\(see)i(Section)f(4.1)g([Bourne)g(Shell)f(Builtins],)h(page)g +(44\).)150 2311 y Ft(type)870 2451 y(type)47 b([-afptP])e([)p +Fj(name)i Ft(...)o(])630 2591 y Fu(F)-8 b(or)42 b(eac)m(h)g +Fr(name)p Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m +(terpreted)g(if)g(used)f(as)i(a)f(command)630 2701 y(name.)630 +2841 y(If)g(the)g Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c +Fu(prin)m(ts)h(a)h(single)g(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p +Ft(alias)p Fu(',)630 2951 y(`)p Ft(function)p Fu(',)32 +b(`)p Ft(builtin)p Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p +Ft(keyword)p Fu(',)f(if)h Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e +(function,)630 3061 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h +(reserv)m(ed)g(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55 +b(If)34 b(the)h Fr(name)40 b Fu(is)35 b(not)630 3170 +y(found,)29 b(then)h(nothing)h(is)f(prin)m(ted,)g(and)g +Ft(type)f Fu(returns)g(a)i(failure)g(status.)630 3310 +y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h Ft(type)e +Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g(that)h(w) +m(ould)630 3420 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g Ft(-t)g Fu(w)m(ould)g(not)h(return)e(`)p Ft(file)p Fu('.)630 -2676 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g +3560 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g (eac)m(h)g Fr(name)p Fu(,)g(ev)m(en)g(if)g Ft(-t)f Fu(w)m(ould)g(not)h -(return)630 2785 y(`)p Ft(file)p Fu('.)630 2918 y(If)f(a)g(command)g +(return)630 3670 y(`)p Ft(file)p Fu('.)630 3810 y(If)f(a)g(command)g (is)g(hashed,)f Ft(-p)h Fu(and)f Ft(-P)g Fu(prin)m(t)h(the)g(hashed)f -(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 3027 +(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 3920 y(sarily)h(the)f(\014le)h(that)g(app)s(ears)e(\014rst)h(in)g -Ft($PATH)p Fu(.)630 3160 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g +Ft($PATH)p Fu(.)630 4060 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g (used,)h Ft(type)e Fu(returns)f(all)j(of)f(the)g(places)h(that)f(con)m -(tain)i(an)d(executable)630 3269 y(named)32 b Fr(\014le)p +(tain)i(an)d(executable)630 4170 y(named)32 b Fr(\014le)p Fu(.)49 b(This)32 b(includes)h(aliases)h(and)e(functions,)i(if)f(and)f -(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 3379 y(not)d(also)g -(used.)630 3511 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e +(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 4279 y(not)d(also)g +(used.)630 4419 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e Ft(type)g Fu(do)s(es)h(not)h(attempt)g(to)g(\014nd)d(shell)j -(functions,)f(as)g(with)630 3621 y(the)h Ft(command)d -Fu(builtin.)630 3753 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h +(functions,)f(as)g(with)630 4529 y(the)h Ft(command)d +Fu(builtin.)630 4669 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h (of)f(the)h Fr(names)i Fu(are)e(found,)e(non-zero)i(if)f(an)m(y)g(are)h -(not)630 3862 y(found.)150 4017 y Ft(typeset)870 4150 +(not)630 4779 y(found.)150 4950 y Ft(typeset)870 5090 y(typeset)46 b([-afFgrxilnrtux])d([-p])k([)p Fj(name)p -Ft([=)p Fj(value)p Ft(])d(...)o(])630 4282 y Fu(The)31 +Ft([=)p Fj(value)p Ft(])d(...)o(])630 5230 y Fu(The)31 b Ft(typeset)e Fu(command)i(is)g(supplied)f(for)h(compatibilit)m(y)i -(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 4391 -y(a)g(synon)m(ym)f(for)g(the)g Ft(declare)f Fu(builtin)h(command.)150 -4546 y Ft(ulimit)870 4679 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c -([)p Fj(limit)p Ft(])630 4811 y(ulimit)25 b Fu(pro)m(vides)h(con)m -(trol)i(o)m(v)m(er)g(the)f(resources)f(a)m(v)-5 b(ailable)29 -b(to)e(pro)s(cesses)f(started)h(b)m(y)g(the)630 4921 -y(shell,)i(on)f(systems)g(that)h(allo)m(w)h(suc)m(h)e(con)m(trol.)41 -b(If)28 b(an)g(option)h(is)f(giv)m(en,)i(it)e(is)h(in)m(terpreted)630 -5030 y(as)i(follo)m(ws:)630 5185 y Ft(-S)384 b Fu(Change)30 -b(and)g(rep)s(ort)g(the)g(soft)h(limit)g(asso)s(ciated)h(with)e(a)h -(resource.)630 5340 y Ft(-H)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the) -g(hard)g(limit)h(asso)s(ciated)h(with)e(a)h(resource.)p +(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 5340 +y(a)g(synon)m(ym)f(for)g(the)g Ft(declare)f Fu(builtin)h(command.)p eop end %%Page: 61 67 TeXDict begin 61 66 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(61)630 299 y Ft(-a)384 -b Fu(All)31 b(curren)m(t)f(limits)h(are)g(rep)s(orted.)630 -454 y Ft(-b)384 b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e -(size.)630 610 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(core) -g(\014les)f(created.)630 765 y Ft(-d)384 b Fu(The)30 +b(Shell)30 b(Builtin)h(Commands)2069 b(61)150 299 y Ft(ulimit)870 +433 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c([)p +Fj(limit)p Ft(])630 566 y(ulimit)25 b Fu(pro)m(vides)h(con)m(trol)i(o)m +(v)m(er)g(the)f(resources)f(a)m(v)-5 b(ailable)29 b(to)e(pro)s(cesses)f +(started)h(b)m(y)g(the)630 676 y(shell,)i(on)f(systems)g(that)h(allo)m +(w)h(suc)m(h)e(con)m(trol.)41 b(If)28 b(an)g(option)h(is)f(giv)m(en,)i +(it)e(is)h(in)m(terpreted)630 785 y(as)i(follo)m(ws:)630 +943 y Ft(-S)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the)g(soft)h(limit)g +(asso)s(ciated)h(with)e(a)h(resource.)630 1101 y Ft(-H)384 +b Fu(Change)30 b(and)g(rep)s(ort)g(the)g(hard)g(limit)h(asso)s(ciated)h +(with)e(a)h(resource.)630 1259 y Ft(-a)384 b Fu(All)31 +b(curren)m(t)f(limits)h(are)g(rep)s(orted.)630 1417 y +Ft(-b)384 b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e +(size.)630 1574 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g +(core)g(\014les)f(created.)630 1732 y Ft(-d)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(a)g(pro)s(cess's)f(data)h(segmen)m(t.)630 -921 y Ft(-e)384 b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m(y) -f(\()p Ft(")p Fu(nice)p Ft(")p Fu(\).)630 1076 y Ft(-f)384 +1890 y Ft(-e)384 b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m +(y)f(\()p Ft(")p Fu(nice)p Ft(")p Fu(\).)630 2048 y Ft(-f)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the) -g(shell)h(and)f(its)h(c)m(hildren.)630 1232 y Ft(-i)384 +g(shell)h(and)f(its)h(c)m(hildren.)630 2206 y Ft(-i)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(p)s(ending)e -(signals.)630 1387 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s +(signals.)630 2364 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s (er)f(of)i(kqueues)f(that)h(ma)m(y)g(b)s(e)e(allo)s(cated.)630 -1543 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s -(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 1698 +2521 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s +(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 2679 y Ft(-m)384 b Fu(The)36 b(maxim)m(um)g(residen)m(t)h(set)g(size)g -(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 1808 -y(limit\).)630 1963 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s +(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 2789 +y(limit\).)630 2947 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s (er)e(of)i(op)s(en)f(\014le)h(descriptors)g(\(most)g(systems)g(do)1110 -2073 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).) -630 2228 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630 -2384 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m -(ytes)g(in)f(POSIX)f(message)j(queues.)630 2539 y Ft(-r)384 +3056 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).) +630 3214 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630 +3372 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m +(ytes)g(in)f(POSIX)f(message)j(queues.)630 3530 y Ft(-r)384 b Fu(The)30 b(maxim)m(um)g(real-time)i(sc)m(heduling)f(priorit)m(y)-8 -b(.)630 2695 y Ft(-s)384 b Fu(The)30 b(maxim)m(um)g(stac)m(k)i(size.) -630 2850 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g -(time)h(in)f(seconds.)630 3005 y Ft(-u)384 b Fu(The)30 +b(.)630 3687 y Ft(-s)384 b Fu(The)30 b(maxim)m(um)g(stac)m(k)i(size.) +630 3845 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g +(time)h(in)f(seconds.)630 4003 y Ft(-u)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pro)s(cesses)f(a)m(v)-5 -b(ailable)33 b(to)e(a)f(single)i(user.)630 3161 y Ft(-v)384 +b(ailable)33 b(to)e(a)f(single)i(user.)630 4161 y Ft(-v)384 b Fu(The)41 b(maxim)m(um)h(amoun)m(t)g(of)h(virtual)f(memory)g(a)m(v)-5 -b(ailable)44 b(to)e(the)g(shell,)1110 3271 y(and,)30 +b(ailable)44 b(to)e(the)g(shell,)1110 4270 y(and,)30 b(on)g(some)h(systems,)g(to)g(its)g(c)m(hildren.)630 -3426 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i -(\014le)f(lo)s(c)m(ks.)630 3581 y Ft(-P)384 b Fu(The)30 +4428 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i +(\014le)f(lo)s(c)m(ks.)630 4586 y Ft(-P)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pseudoterminals.)630 -3737 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i -(threads.)630 3892 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h +4744 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i +(threads.)630 4902 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h Ft(-a)f Fu(option)h(is)f(not)h(used,)h Fr(limit)h Fu(is)e(the)g(new)f -(v)-5 b(alue)37 b(of)g(the)630 4002 y(sp)s(eci\014ed)c(resource.)51 +(v)-5 b(alue)37 b(of)g(the)630 5011 y(sp)s(eci\014ed)c(resource.)51 b(The)34 b(sp)s(ecial)g Fr(limit)j Fu(v)-5 b(alues)34 b Ft(hard)p Fu(,)g Ft(soft)p Fu(,)g(and)f Ft(unlimited)e -Fu(stand)630 4112 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g +Fu(stand)630 5121 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g (curren)m(t)f(soft)g(limit,)h(and)f(no)g(limit,)h(resp)s(ectiv)m(ely)-8 -b(.)48 b(A)630 4221 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b) +b(.)48 b(A)630 5230 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b) m(y)f(a)h(non-ro)s(ot)g(user)f(once)i(it)f(is)g(set;)k(a)c(soft)g -(limit)630 4331 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5 +(limit)630 5340 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5 b(alue)40 b(of)g(the)h(hard)e(limit.)70 b(Otherwise,)43 -b(the)d(curren)m(t)630 4440 y(v)-5 b(alue)29 b(of)h(the)f(soft)g(limit) -h(for)e(the)h(sp)s(eci\014ed)g(resource)g(is)g(prin)m(ted,)g(unless)f -(the)h Ft(-H)f Fu(option)630 4550 y(is)h(supplied.)39 -b(When)29 b(setting)h(new)f(limits,)h(if)f(neither)g -Ft(-H)g Fu(nor)f Ft(-S)h Fu(is)g(supplied,)f(b)s(oth)h(the)630 -4660 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 b(If)31 -b(no)i(option)f(is)h(giv)m(en,)h(then)e Ft(-f)g Fu(is)g(assumed.)46 -b(V)-8 b(alues)630 4769 y(are)31 b(in)f(1024-b)m(yte)j(incremen)m(ts,)e -(except)g(for)f Ft(-t)p Fu(,)g(whic)m(h)g(is)g(in)g(seconds;)h -Ft(-p)p Fu(,)f(whic)m(h)g(is)g(in)630 4879 y(units)h(of)g(512-b)m(yte)j -(blo)s(c)m(ks;)e Ft(-P)p Fu(,)f Ft(-T)p Fu(,)h Ft(-b)p -Fu(,)f Ft(-k)p Fu(,)g Ft(-n)g Fu(and)f Ft(-u)p Fu(,)h(whic)m(h)h(are)f -(unscaled)g(v)-5 b(alues;)630 4988 y(and,)28 b(when)e(in)h -Fm(posix)f Fu(Mo)s(de)i(\(see)g(Section)g(6.11)h([Bash)f(POSIX)e(Mo)s -(de],)j(page)f(100\),)i Ft(-c)630 5098 y Fu(and)g Ft(-f)p -Fu(,)g(whic)m(h)g(are)h(in)f(512-b)m(yte)i(incremen)m(ts.)630 -5230 y(The)i(return)g(status)h(is)f(zero)i(unless)e(an)g(in)m(v)-5 -b(alid)36 b(option)f(or)f(argumen)m(t)i(is)e(supplied,)h(or)630 -5340 y(an)30 b(error)g(o)s(ccurs)g(while)h(setting)g(a)g(new)f(limit.)p -eop end +b(the)d(curren)m(t)p eop end %%Page: 62 68 TeXDict begin 62 67 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(62)150 299 y Ft(unalias)870 -428 y(unalias)46 b([-a])g([)p Fj(name)h Ft(...)g(])630 -558 y Fu(Remo)m(v)m(e)42 b(eac)m(h)f Fr(name)k Fu(from)39 -b(the)i(list)f(of)g(aliases.)71 b(If)40 b Ft(-a)f Fu(is)h(supplied,)h -(all)g(aliases)h(are)630 668 y(remo)m(v)m(ed.)g(Aliases)31 -b(are)g(describ)s(ed)e(in)h(Section)i(6.6)f([Aliases],)h(page)f(94.)150 -898 y Fs(4.3)68 b(Mo)t(difying)45 b(Shell)g(Beha)l(vior)150 -1118 y Fk(4.3.1)63 b(The)41 b(Set)g(Builtin)150 1265 -y Fu(This)35 b(builtin)h(is)g(so)g(complicated)i(that)f(it)f(deserv)m -(es)h(its)f(o)m(wn)g(section.)59 b Ft(set)35 b Fu(allo)m(ws)j(y)m(ou)e -(to)h(c)m(hange)150 1374 y(the)c(v)-5 b(alues)34 b(of)f(shell)g -(options)h(and)e(set)i(the)f(p)s(ositional)h(parameters,)h(or)e(to)h -(displa)m(y)f(the)g(names)h(and)150 1484 y(v)-5 b(alues)31 -b(of)f(shell)h(v)-5 b(ariables.)150 1633 y Ft(set)870 -1763 y(set)47 b([--abefhkmnptuvxBCEHPT])41 b([-o)47 b -Fj(option-name)p Ft(])e([)p Fj(argument)g Ft(...)o(])870 -1873 y(set)i([+abefhkmnptuvxBCEHPT])42 b([+o)47 b Fj(option-name)p -Ft(])d([)p Fj(argument)h Ft(...)o(])630 2002 y Fu(If)22 -b(no)h(options)g(or)g(argumen)m(ts)g(are)g(supplied,)g -Ft(set)f Fu(displa)m(ys)g(the)h(names)g(and)f(v)-5 b(alues)23 -b(of)g(all)630 2112 y(shell)j(v)-5 b(ariables)27 b(and)e(functions,)h -(sorted)g(according)h(to)g(the)f(curren)m(t)f(lo)s(cale,)k(in)c(a)i -(format)630 2221 y(that)i(ma)m(y)h(b)s(e)e(reused)g(as)h(input)f(for)h -(setting)h(or)e(resetting)i(the)f(curren)m(tly-set)h(v)-5 -b(ariables.)630 2331 y(Read-only)37 b(v)-5 b(ariables)37 +b(Shell)30 b(Builtin)h(Commands)2069 b(62)630 299 y(v)-5 +b(alue)29 b(of)h(the)f(soft)g(limit)h(for)e(the)h(sp)s(eci\014ed)g +(resource)g(is)g(prin)m(ted,)g(unless)f(the)h Ft(-H)f +Fu(option)630 408 y(is)h(supplied.)39 b(When)29 b(setting)h(new)f +(limits,)h(if)f(neither)g Ft(-H)g Fu(nor)f Ft(-S)h Fu(is)g(supplied,)f +(b)s(oth)h(the)630 518 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 +b(If)31 b(no)i(option)f(is)h(giv)m(en,)h(then)e Ft(-f)g +Fu(is)g(assumed.)46 b(V)-8 b(alues)630 628 y(are)31 b(in)f(1024-b)m +(yte)j(incremen)m(ts,)e(except)g(for)f Ft(-t)p Fu(,)g(whic)m(h)g(is)g +(in)g(seconds;)h Ft(-p)p Fu(,)f(whic)m(h)g(is)g(in)630 +737 y(units)h(of)g(512-b)m(yte)j(blo)s(c)m(ks;)e Ft(-P)p +Fu(,)f Ft(-T)p Fu(,)h Ft(-b)p Fu(,)f Ft(-k)p Fu(,)g Ft(-n)g +Fu(and)f Ft(-u)p Fu(,)h(whic)m(h)h(are)f(unscaled)g(v)-5 +b(alues;)630 847 y(and,)28 b(when)e(in)h Fm(posix)f Fu(Mo)s(de)i(\(see) +g(Section)g(6.11)h([Bash)f(POSIX)e(Mo)s(de],)j(page)f(100\),)i +Ft(-c)630 956 y Fu(and)g Ft(-f)p Fu(,)g(whic)m(h)g(are)h(in)f(512-b)m +(yte)i(incremen)m(ts.)630 1090 y(The)i(return)g(status)h(is)f(zero)i +(unless)e(an)g(in)m(v)-5 b(alid)36 b(option)f(or)f(argumen)m(t)i(is)e +(supplied,)h(or)630 1199 y(an)30 b(error)g(o)s(ccurs)g(while)h(setting) +g(a)g(new)f(limit.)150 1356 y Ft(unalias)870 1489 y(unalias)46 +b([-a])g([)p Fj(name)h Ft(...)g(])630 1623 y Fu(Remo)m(v)m(e)42 +b(eac)m(h)f Fr(name)k Fu(from)39 b(the)i(list)f(of)g(aliases.)71 +b(If)40 b Ft(-a)f Fu(is)h(supplied,)h(all)g(aliases)h(are)630 +1732 y(remo)m(v)m(ed.)g(Aliases)31 b(are)g(describ)s(ed)e(in)h(Section) +i(6.6)f([Aliases],)h(page)f(94.)150 1970 y Fs(4.3)68 +b(Mo)t(difying)45 b(Shell)g(Beha)l(vior)150 2193 y Fk(4.3.1)63 +b(The)41 b(Set)g(Builtin)150 2340 y Fu(This)35 b(builtin)h(is)g(so)g +(complicated)i(that)f(it)f(deserv)m(es)h(its)f(o)m(wn)g(section.)59 +b Ft(set)35 b Fu(allo)m(ws)j(y)m(ou)e(to)h(c)m(hange)150 +2450 y(the)c(v)-5 b(alues)34 b(of)f(shell)g(options)h(and)e(set)i(the)f +(p)s(ositional)h(parameters,)h(or)e(to)h(displa)m(y)f(the)g(names)h +(and)150 2559 y(v)-5 b(alues)31 b(of)f(shell)h(v)-5 b(ariables.)150 +2716 y Ft(set)870 2849 y(set)47 b([--abefhkmnptuvxBCEHPT])41 +b([-o)47 b Fj(option-name)p Ft(])e([)p Fj(argument)g +Ft(...)o(])870 2959 y(set)i([+abefhkmnptuvxBCEHPT])42 +b([+o)47 b Fj(option-name)p Ft(])d([)p Fj(argument)h +Ft(...)o(])630 3092 y Fu(If)22 b(no)h(options)g(or)g(argumen)m(ts)g +(are)g(supplied,)g Ft(set)f Fu(displa)m(ys)g(the)h(names)g(and)f(v)-5 +b(alues)23 b(of)g(all)630 3202 y(shell)j(v)-5 b(ariables)27 +b(and)e(functions,)h(sorted)g(according)h(to)g(the)f(curren)m(t)f(lo)s +(cale,)k(in)c(a)i(format)630 3311 y(that)i(ma)m(y)h(b)s(e)e(reused)g +(as)h(input)f(for)h(setting)h(or)e(resetting)i(the)f(curren)m(tly-set)h +(v)-5 b(ariables.)630 3421 y(Read-only)37 b(v)-5 b(ariables)37 b(cannot)h(b)s(e)e(reset.)59 b(In)36 b Fm(posix)g Fu(mo)s(de,)i(only)f -(shell)f(v)-5 b(ariables)38 b(are)630 2440 y(listed.)630 -2570 y(When)29 b(options)g(are)g(supplied,)f(they)h(set)h(or)f(unset)f +(shell)f(v)-5 b(ariables)38 b(are)630 3531 y(listed.)630 +3664 y(When)29 b(options)g(are)g(supplied,)f(they)h(set)h(or)f(unset)f (shell)h(attributes.)41 b(Options,)29 b(if)g(sp)s(ec-)630 -2680 y(i\014ed,)h(ha)m(v)m(e)i(the)e(follo)m(wing)i(meanings:)630 -2829 y Ft(-a)384 b Fu(Eac)m(h)37 b(v)-5 b(ariable)36 +3773 y(i\014ed,)h(ha)m(v)m(e)i(the)e(follo)m(wing)i(meanings:)630 +3930 y Ft(-a)384 b Fu(Eac)m(h)37 b(v)-5 b(ariable)36 b(or)g(function)g(that)g(is)g(created)h(or)f(mo)s(di\014ed)f(is)h(giv)m -(en)h(the)1110 2939 y(exp)s(ort)28 b(attribute)h(and)f(mark)m(ed)g(for) +(en)h(the)1110 4040 y(exp)s(ort)28 b(attribute)h(and)f(mark)m(ed)g(for) g(exp)s(ort)g(to)h(the)g(en)m(vironmen)m(t)f(of)h(sub-)1110 -3048 y(sequen)m(t)i(commands.)630 3198 y Ft(-b)384 b +4150 y(sequen)m(t)i(commands.)630 4306 y Ft(-b)384 b Fu(Cause)44 b(the)h(status)g(of)f(terminated)h(bac)m(kground)g(jobs)f -(to)h(b)s(e)f(rep)s(orted)1110 3307 y(immediately)-8 +(to)h(b)s(e)f(rep)s(orted)1110 4416 y(immediately)-8 b(,)30 b(rather)d(than)f(b)s(efore)h(prin)m(ting)g(the)g(next)g -(primary)g(prompt.)630 3457 y Ft(-e)384 b Fu(Exit)65 +(primary)g(prompt.)630 4573 y Ft(-e)384 b Fu(Exit)65 b(immediately)g(if)f(a)h(pip)s(eline)e(\(see)i(Section)g(3.2.2)h([Pip)s -(elines],)1110 3567 y(page)56 b(8\),)62 b(whic)m(h)55 +(elines],)1110 4682 y(page)56 b(8\),)62 b(whic)m(h)55 b(ma)m(y)h(consist)f(of)h(a)f(single)h(simple)f(command)g(\(see)1110 -3676 y(Section)30 b(3.2.1)i([Simple)d(Commands],)g(page)h(8\),)h(a)f -(list)g(\(see)h(Section)f(3.2.3)1110 3786 y([Lists],)66 +4792 y(Section)30 b(3.2.1)i([Simple)d(Commands],)g(page)h(8\),)h(a)f +(list)g(\(see)h(Section)f(3.2.3)1110 4902 y([Lists],)66 b(page)59 b(9\),)67 b(or)58 b(a)h(comp)s(ound)e(command)h(\(see)h -(Section)g(3.2.4)1110 3895 y([Comp)s(ound)67 b(Commands],)77 +(Section)g(3.2.4)1110 5011 y([Comp)s(ound)67 b(Commands],)77 b(page)69 b(9\))g(returns)e(a)i(non-zero)g(status.)1110 -4005 y(The)41 b(shell)g(do)s(es)g(not)g(exit)h(if)f(the)h(command)f -(that)h(fails)f(is)g(part)g(of)h(the)1110 4115 y(command)g(list)h +5121 y(The)41 b(shell)g(do)s(es)g(not)g(exit)h(if)f(the)h(command)f +(that)h(fails)f(is)g(part)g(of)h(the)1110 5230 y(command)g(list)h (immediately)g(follo)m(wing)g(a)g Ft(while)e Fu(or)h -Ft(until)e Fu(k)m(eyw)m(ord,)1110 4224 y(part)61 b(of)g(the)g(test)h +Ft(until)e Fu(k)m(eyw)m(ord,)1110 5340 y(part)61 b(of)g(the)g(test)h (in)e(an)h Ft(if)f Fu(statemen)m(t,)71 b(part)61 b(of)g(an)m(y)g -(command)1110 4334 y(executed)50 b(in)e(a)h Ft(&&)f Fu(or)h -Ft(||)f Fu(list)h(except)g(the)g(command)g(follo)m(wing)h(the)1110 -4443 y(\014nal)37 b Ft(&&)g Fu(or)g Ft(||)p Fu(,)h(an)m(y)g(command)f -(in)g(a)g(pip)s(eline)g(but)g(the)g(last,)j(or)e(if)f(the)1110 -4553 y(command's)c(return)f(status)h(is)g(b)s(eing)g(in)m(v)m(erted)h -(with)e Ft(!)p Fu(.)48 b(If)33 b(a)g(comp)s(ound)1110 -4662 y(command)g(other)g(than)f(a)i(subshell)d(returns)h(a)h(non-zero)h -(status)f(b)s(ecause)1110 4772 y(a)k(command)g(failed)g(while)g -Ft(-e)f Fu(w)m(as)i(b)s(eing)e(ignored,)j(the)e(shell)g(do)s(es)g(not) -1110 4882 y(exit.)42 b(A)30 b(trap)g(on)h Ft(ERR)p Fu(,)e(if)i(set,)g -(is)f(executed)i(b)s(efore)e(the)g(shell)h(exits.)1110 -5011 y(This)f(option)h(applies)f(to)h(the)g(shell)g(en)m(vironmen)m(t)g -(and)f(eac)m(h)h(subshell)f(en-)1110 5121 y(vironmen)m(t)j(separately)i -(\(see)f(Section)g(3.7.3)h([Command)d(Execution)i(En-)1110 -5230 y(vironmen)m(t],)i(page)f(39\),)i(and)d(ma)m(y)h(cause)f -(subshells)g(to)h(exit)g(b)s(efore)f(exe-)1110 5340 y(cuting)d(all)g -(the)g(commands)f(in)g(the)g(subshell.)p eop end +(command)p eop end %%Page: 63 69 TeXDict begin 63 68 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(63)1110 299 y(If)41 -b(a)g(comp)s(ound)e(command)i(or)g(shell)g(function)g(executes)h(in)f -(a)g(con)m(text)1110 408 y(where)31 b Ft(-e)g Fu(is)g(b)s(eing)g -(ignored,)h(none)f(of)h(the)f(commands)g(executed)h(within)1110 -518 y(the)j(comp)s(ound)f(command)h(or)g(function)f(b)s(o)s(dy)g(will)h -(b)s(e)f(a\013ected)j(b)m(y)e(the)1110 628 y Ft(-e)25 -b Fu(setting,)j(ev)m(en)e(if)g Ft(-e)f Fu(is)h(set)g(and)f(a)h(command) -g(returns)e(a)i(failure)g(status.)1110 737 y(If)32 b(a)i(comp)s(ound)d -(command)i(or)g(shell)g(function)f(sets)i Ft(-e)e Fu(while)h(executing) -1110 847 y(in)40 b(a)h(con)m(text)i(where)d Ft(-e)g Fu(is)h(ignored,)j -(that)d(setting)h(will)f(not)g(ha)m(v)m(e)h(an)m(y)1110 -956 y(e\013ect)g(un)m(til)e(the)h(comp)s(ound)e(command)h(or)g(the)g -(command)g(con)m(taining)1110 1066 y(the)31 b(function)f(call)h -(completes.)630 1217 y Ft(-f)384 b Fu(Disable)31 b(\014lename)g -(expansion)f(\(globbing\).)630 1367 y Ft(-h)384 b Fu(Lo)s(cate)33 -b(and)e(remem)m(b)s(er)h(\(hash\))g(commands)f(as)h(they)g(are)g(lo)s -(ok)m(ed)h(up)e(for)1110 1477 y(execution.)42 b(This)29 -b(option)i(is)g(enabled)f(b)m(y)g(default.)630 1628 y -Ft(-k)384 b Fu(All)34 b(argumen)m(ts)g(in)f(the)h(form)f(of)g -(assignmen)m(t)h(statemen)m(ts)i(are)d(placed)h(in)1110 -1737 y(the)k(en)m(vironmen)m(t)g(for)g(a)g(command,)h(not)f(just)f -(those)i(that)f(precede)g(the)1110 1847 y(command)30 -b(name.)630 1998 y Ft(-m)384 b Fu(Job)28 b(con)m(trol)h(is)f(enabled)g +b(Shell)30 b(Builtin)h(Commands)2069 b(63)1110 299 y(executed)50 +b(in)e(a)h Ft(&&)f Fu(or)h Ft(||)f Fu(list)h(except)g(the)g(command)g +(follo)m(wing)h(the)1110 408 y(\014nal)37 b Ft(&&)g Fu(or)g +Ft(||)p Fu(,)h(an)m(y)g(command)f(in)g(a)g(pip)s(eline)g(but)g(the)g +(last,)j(or)e(if)f(the)1110 518 y(command's)c(return)f(status)h(is)g(b) +s(eing)g(in)m(v)m(erted)h(with)e Ft(!)p Fu(.)48 b(If)33 +b(a)g(comp)s(ound)1110 628 y(command)g(other)g(than)f(a)i(subshell)d +(returns)h(a)h(non-zero)h(status)f(b)s(ecause)1110 737 +y(a)k(command)g(failed)g(while)g Ft(-e)f Fu(w)m(as)i(b)s(eing)e +(ignored,)j(the)e(shell)g(do)s(es)g(not)1110 847 y(exit.)42 +b(A)30 b(trap)g(on)h Ft(ERR)p Fu(,)e(if)i(set,)g(is)f(executed)i(b)s +(efore)e(the)g(shell)h(exits.)1110 984 y(This)f(option)h(applies)f(to)h +(the)g(shell)g(en)m(vironmen)m(t)g(and)f(eac)m(h)h(subshell)f(en-)1110 +1093 y(vironmen)m(t)j(separately)i(\(see)f(Section)g(3.7.3)h([Command)d +(Execution)i(En-)1110 1203 y(vironmen)m(t],)i(page)f(39\),)i(and)d(ma)m +(y)h(cause)f(subshells)g(to)h(exit)g(b)s(efore)f(exe-)1110 +1313 y(cuting)d(all)g(the)g(commands)f(in)g(the)g(subshell.)1110 +1450 y(If)41 b(a)g(comp)s(ound)e(command)i(or)g(shell)g(function)g +(executes)h(in)f(a)g(con)m(text)1110 1559 y(where)31 +b Ft(-e)g Fu(is)g(b)s(eing)g(ignored,)h(none)f(of)h(the)f(commands)g +(executed)h(within)1110 1669 y(the)j(comp)s(ound)f(command)h(or)g +(function)f(b)s(o)s(dy)g(will)h(b)s(e)f(a\013ected)j(b)m(y)e(the)1110 +1778 y Ft(-e)25 b Fu(setting,)j(ev)m(en)e(if)g Ft(-e)f +Fu(is)h(set)g(and)f(a)h(command)g(returns)e(a)i(failure)g(status.)1110 +1888 y(If)32 b(a)i(comp)s(ound)d(command)i(or)g(shell)g(function)f +(sets)i Ft(-e)e Fu(while)h(executing)1110 1998 y(in)40 +b(a)h(con)m(text)i(where)d Ft(-e)g Fu(is)h(ignored,)j(that)d(setting)h +(will)f(not)g(ha)m(v)m(e)h(an)m(y)1110 2107 y(e\013ect)g(un)m(til)e +(the)h(comp)s(ound)e(command)h(or)g(the)g(command)g(con)m(taining)1110 +2217 y(the)31 b(function)f(call)h(completes.)630 2381 +y Ft(-f)384 b Fu(Disable)31 b(\014lename)g(expansion)f(\(globbing\).) +630 2545 y Ft(-h)384 b Fu(Lo)s(cate)33 b(and)e(remem)m(b)s(er)h +(\(hash\))g(commands)f(as)h(they)g(are)g(lo)s(ok)m(ed)h(up)e(for)1110 +2655 y(execution.)42 b(This)29 b(option)i(is)g(enabled)f(b)m(y)g +(default.)630 2819 y Ft(-k)384 b Fu(All)34 b(argumen)m(ts)g(in)f(the)h +(form)f(of)g(assignmen)m(t)h(statemen)m(ts)i(are)d(placed)h(in)1110 +2929 y(the)k(en)m(vironmen)m(t)g(for)g(a)g(command,)h(not)f(just)f +(those)i(that)f(precede)g(the)1110 3039 y(command)30 +b(name.)630 3203 y Ft(-m)384 b Fu(Job)28 b(con)m(trol)h(is)f(enabled)g (\(see)h(Chapter)f(7)g([Job)g(Con)m(trol],)i(page)f(105\).)41 -b(All)1110 2107 y(pro)s(cesses)27 b(run)f(in)i(a)g(separate)g(pro)s +b(All)1110 3313 y(pro)s(cesses)27 b(run)f(in)i(a)g(separate)g(pro)s (cess)f(group.)40 b(When)27 b(a)h(bac)m(kground)f(job)1110 -2217 y(completes,)32 b(the)f(shell)f(prin)m(ts)g(a)h(line)f(con)m -(taining)i(its)f(exit)g(status.)630 2367 y Ft(-n)384 +3422 y(completes,)32 b(the)f(shell)f(prin)m(ts)g(a)h(line)f(con)m +(taining)i(its)f(exit)g(status.)630 3587 y Ft(-n)384 b Fu(Read)38 b(commands)f(but)f(do)i(not)f(execute)i(them.)62 -b(This)37 b(ma)m(y)h(b)s(e)f(used)f(to)1110 2477 y(c)m(hec)m(k)d(a)e +b(This)37 b(ma)m(y)h(b)s(e)f(used)f(to)1110 3696 y(c)m(hec)m(k)d(a)e (script)g(for)g(syn)m(tax)h(errors.)42 b(This)30 b(option)i(is)f -(ignored)g(b)m(y)g(in)m(terac-)1110 2587 y(tiv)m(e)h(shells.)630 -2737 y Ft(-o)e Fj(option-name)1110 2847 y Fu(Set)h(the)f(option)h +(ignored)g(b)m(y)g(in)m(terac-)1110 3806 y(tiv)m(e)h(shells.)630 +3970 y Ft(-o)e Fj(option-name)1110 4080 y Fu(Set)h(the)f(option)h (corresp)s(onding)e(to)i Fr(option-name)5 b Fu(:)1110 -2998 y Ft(allexport)1590 3107 y Fu(Same)30 b(as)h Ft(-a)p -Fu(.)1110 3258 y Ft(braceexpand)1590 3367 y Fu(Same)f(as)h -Ft(-B)p Fu(.)1110 3518 y Ft(emacs)240 b Fu(Use)25 b(an)f +4244 y Ft(allexport)1590 4354 y Fu(Same)30 b(as)h Ft(-a)p +Fu(.)1110 4518 y Ft(braceexpand)1590 4628 y Fu(Same)f(as)h +Ft(-B)p Fu(.)1110 4792 y Ft(emacs)240 b Fu(Use)25 b(an)f Ft(emacs)p Fu(-st)m(yle)h(line)f(editing)h(in)m(terface)h(\(see)g -(Chapter)e(8)1590 3628 y([Command)33 b(Line)g(Editing],)h(page)h -(109\).)51 b(This)32 b(also)i(a\013ects)1590 3737 y(the)d(editing)g(in) -m(terface)h(used)d(for)h Ft(read)f(-e)p Fu(.)1110 3888 +(Chapter)e(8)1590 4902 y([Command)33 b(Line)g(Editing],)h(page)h +(109\).)51 b(This)32 b(also)i(a\013ects)1590 5011 y(the)d(editing)g(in) +m(terface)h(used)d(for)h Ft(read)f(-e)p Fu(.)1110 5176 y Ft(errexit)144 b Fu(Same)30 b(as)h Ft(-e)p Fu(.)1110 -4039 y Ft(errtrace)96 b Fu(Same)30 b(as)h Ft(-E)p Fu(.)1110 -4189 y Ft(functrace)1590 4299 y Fu(Same)f(as)h Ft(-T)p -Fu(.)1110 4450 y Ft(hashall)144 b Fu(Same)30 b(as)h Ft(-h)p -Fu(.)1110 4600 y Ft(histexpand)1590 4710 y Fu(Same)f(as)h -Ft(-H)p Fu(.)1110 4861 y Ft(history)144 b Fu(Enable)39 -b(command)g(history)-8 b(,)42 b(as)d(describ)s(ed)f(in)h(Section)h(9.1) -1590 4970 y([Bash)d(History)g(F)-8 b(acilities],)41 b(page)c(144.)60 -b(This)36 b(option)h(is)f(on)1590 5080 y(b)m(y)30 b(default)h(in)f(in)m -(teractiv)m(e)j(shells.)1110 5230 y Ft(ignoreeof)1590 -5340 y Fu(An)d(in)m(teractiv)m(e)j(shell)e(will)g(not)f(exit)h(up)s(on) -e(reading)i(EOF.)p eop end +5340 y Ft(errtrace)96 b Fu(Same)30 b(as)h Ft(-E)p Fu(.)p +eop end %%Page: 64 70 TeXDict begin 64 69 bop 150 -116 a Fu(Chapter)30 b(4:)41 b(Shell)30 b(Builtin)h(Commands)2069 b(64)1110 299 y -Ft(keyword)144 b Fu(Same)30 b(as)h Ft(-k)p Fu(.)1110 -457 y Ft(monitor)144 b Fu(Same)30 b(as)h Ft(-m)p Fu(.)1110 -615 y Ft(noclobber)1590 725 y Fu(Same)f(as)h Ft(-C)p -Fu(.)1110 883 y Ft(noexec)192 b Fu(Same)30 b(as)h Ft(-n)p -Fu(.)1110 1042 y Ft(noglob)192 b Fu(Same)30 b(as)h Ft(-f)p -Fu(.)1110 1200 y Ft(nolog)240 b Fu(Curren)m(tly)30 b(ignored.)1110 -1358 y Ft(notify)192 b Fu(Same)30 b(as)h Ft(-b)p Fu(.)1110 -1517 y Ft(nounset)144 b Fu(Same)30 b(as)h Ft(-u)p Fu(.)1110 -1675 y Ft(onecmd)192 b Fu(Same)30 b(as)h Ft(-t)p Fu(.)1110 -1833 y Ft(physical)96 b Fu(Same)30 b(as)h Ft(-P)p Fu(.)1110 -1991 y Ft(pipefail)96 b Fu(If)44 b(set,)k(the)d(return)e(v)-5 -b(alue)45 b(of)f(a)h(pip)s(eline)e(is)i(the)f(v)-5 b(alue)45 -b(of)1590 2101 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h -(exit)g(with)f(a)g(non-zero)1590 2211 y(status,)28 b(or)f(zero)g(if)f -(all)i(commands)e(in)g(the)h(pip)s(eline)f(exit)i(suc-)1590 -2320 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h -(default.)1110 2478 y Ft(posix)240 b Fu(Change)30 b(the)g(b)s(eha)m -(vior)h(of)f(Bash)g(where)g(the)g(default)h(op)s(era-)1590 -2588 y(tion)25 b(di\013ers)f(from)g(the)h Fm(posix)f -Fu(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 2698 y(dard)h(\(see)j -(Section)f(6.11)h([Bash)f(POSIX)e(Mo)s(de],)j(page)f(100\).)1590 -2807 y(This)37 b(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m(v)m -(e)g(as)g(a)f(strict)h(su-)1590 2917 y(p)s(erset)30 b(of)h(that)f -(standard.)1110 3075 y Ft(privileged)1590 3185 y Fu(Same)g(as)h -Ft(-p)p Fu(.)1110 3343 y Ft(verbose)144 b Fu(Same)30 -b(as)h Ft(-v)p Fu(.)1110 3501 y Ft(vi)384 b Fu(Use)36 -b(a)g Ft(vi)p Fu(-st)m(yle)g(line)g(editing)g(in)m(terface.)58 -b(This)35 b(also)h(a\013ects)1590 3611 y(the)31 b(editing)g(in)m -(terface)h(used)d(for)h Ft(read)f(-e)p Fu(.)1110 3769 -y Ft(xtrace)192 b Fu(Same)30 b(as)h Ft(-x)p Fu(.)630 -3927 y Ft(-p)384 b Fu(T)-8 b(urn)33 b(on)h(privileged)h(mo)s(de.)51 -b(In)34 b(this)g(mo)s(de,)h(the)f Ft($BASH_ENV)e Fu(and)h -Ft($ENV)1110 4037 y Fu(\014les)23 b(are)h(not)f(pro)s(cessed,)h(shell)g -(functions)e(are)i(not)f(inherited)g(from)f(the)i(en-)1110 -4147 y(vironmen)m(t,)h(and)e(the)g Ft(SHELLOPTS)p Fu(,)f -Ft(BASHOPTS)p Fu(,)h Ft(CDPATH)e Fu(and)i Ft(GLOBIGNORE)1110 -4256 y Fu(v)-5 b(ariables,)23 b(if)e(they)g(app)s(ear)f(in)g(the)h(en)m -(vironmen)m(t,)i(are)e(ignored.)38 b(If)20 b(the)h(shell)1110 -4366 y(is)37 b(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d -(\(group\))g(id)g(not)g(equal)h(to)g(the)f(real)1110 -4475 y(user)h(\(group\))h(id,)i(and)d(the)h Ft(-p)f Fu(option)i(is)e -(not)i(supplied,)f(these)h(actions)1110 4585 y(are)32 -b(tak)m(en)i(and)d(the)h(e\013ectiv)m(e)j(user)c(id)h(is)g(set)h(to)f -(the)h(real)f(user)g(id.)45 b(If)32 b(the)1110 4695 y -Ft(-p)i Fu(option)h(is)g(supplied)f(at)h(startup,)h(the)f(e\013ectiv)m -(e)i(user)d(id)g(is)h(not)g(reset.)1110 4804 y(T)-8 b(urning)35 -b(this)i(option)g(o\013)g(causes)g(the)g(e\013ectiv)m(e)i(user)d(and)g -(group)g(ids)g(to)1110 4914 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f -(and)g(group)g(ids.)630 5072 y Ft(-t)384 b Fu(Exit)31 -b(after)g(reading)f(and)g(executing)h(one)g(command.)630 -5230 y Ft(-u)384 b Fu(T)-8 b(reat)25 b(unset)e(v)-5 b(ariables)25 -b(and)e(parameters)h(other)h(than)e(the)h(sp)s(ecial)h(param-)1110 -5340 y(eters)35 b(`)p Ft(@)p Fu(')f(or)g(`)p Ft(*)p Fu(')h(as)f(an)g -(error)g(when)f(p)s(erforming)g(parameter)i(expansion.)p -eop end +Ft(functrace)1590 408 y Fu(Same)30 b(as)h Ft(-T)p Fu(.)1110 +578 y Ft(hashall)144 b Fu(Same)30 b(as)h Ft(-h)p Fu(.)1110 +748 y Ft(histexpand)1590 858 y Fu(Same)f(as)h Ft(-H)p +Fu(.)1110 1028 y Ft(history)144 b Fu(Enable)39 b(command)g(history)-8 +b(,)42 b(as)d(describ)s(ed)f(in)h(Section)h(9.1)1590 +1137 y([Bash)d(History)g(F)-8 b(acilities],)41 b(page)c(144.)60 +b(This)36 b(option)h(is)f(on)1590 1247 y(b)m(y)30 b(default)h(in)f(in)m +(teractiv)m(e)j(shells.)1110 1417 y Ft(ignoreeof)1590 +1526 y Fu(An)d(in)m(teractiv)m(e)j(shell)e(will)g(not)f(exit)h(up)s(on) +e(reading)i(EOF.)1110 1696 y Ft(keyword)144 b Fu(Same)30 +b(as)h Ft(-k)p Fu(.)1110 1866 y Ft(monitor)144 b Fu(Same)30 +b(as)h Ft(-m)p Fu(.)1110 2036 y Ft(noclobber)1590 2145 +y Fu(Same)f(as)h Ft(-C)p Fu(.)1110 2315 y Ft(noexec)192 +b Fu(Same)30 b(as)h Ft(-n)p Fu(.)1110 2485 y Ft(noglob)192 +b Fu(Same)30 b(as)h Ft(-f)p Fu(.)1110 2655 y Ft(nolog)240 +b Fu(Curren)m(tly)30 b(ignored.)1110 2825 y Ft(notify)192 +b Fu(Same)30 b(as)h Ft(-b)p Fu(.)1110 2995 y Ft(nounset)144 +b Fu(Same)30 b(as)h Ft(-u)p Fu(.)1110 3165 y Ft(onecmd)192 +b Fu(Same)30 b(as)h Ft(-t)p Fu(.)1110 3334 y Ft(physical)96 +b Fu(Same)30 b(as)h Ft(-P)p Fu(.)1110 3504 y Ft(pipefail)96 +b Fu(If)44 b(set,)k(the)d(return)e(v)-5 b(alue)45 b(of)f(a)h(pip)s +(eline)e(is)i(the)f(v)-5 b(alue)45 b(of)1590 3614 y(the)33 +b(last)h(\(righ)m(tmost\))h(command)e(to)h(exit)g(with)f(a)g(non-zero) +1590 3724 y(status,)28 b(or)f(zero)g(if)f(all)i(commands)e(in)g(the)h +(pip)s(eline)f(exit)i(suc-)1590 3833 y(cessfully)-8 b(.)41 +b(This)30 b(option)h(is)f(disabled)g(b)m(y)h(default.)1110 +4003 y Ft(posix)240 b Fu(Change)30 b(the)g(b)s(eha)m(vior)h(of)f(Bash)g +(where)g(the)g(default)h(op)s(era-)1590 4113 y(tion)25 +b(di\013ers)f(from)g(the)h Fm(posix)f Fu(standard)f(to)i(matc)m(h)h +(the)f(stan-)1590 4222 y(dard)h(\(see)j(Section)f(6.11)h([Bash)f(POSIX) +e(Mo)s(de],)j(page)f(100\).)1590 4332 y(This)37 b(is)g(in)m(tended)g +(to)h(mak)m(e)g(Bash)g(b)s(eha)m(v)m(e)g(as)g(a)f(strict)h(su-)1590 +4441 y(p)s(erset)30 b(of)h(that)f(standard.)1110 4611 +y Ft(privileged)1590 4721 y Fu(Same)g(as)h Ft(-p)p Fu(.)1110 +4891 y Ft(verbose)144 b Fu(Same)30 b(as)h Ft(-v)p Fu(.)1110 +5061 y Ft(vi)384 b Fu(Use)36 b(a)g Ft(vi)p Fu(-st)m(yle)g(line)g +(editing)g(in)m(terface.)58 b(This)35 b(also)h(a\013ects)1590 +5170 y(the)31 b(editing)g(in)m(terface)h(used)d(for)h +Ft(read)f(-e)p Fu(.)1110 5340 y Ft(xtrace)192 b Fu(Same)30 +b(as)h Ft(-x)p Fu(.)p eop end %%Page: 65 71 TeXDict begin 65 70 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(65)1110 299 y(An)28 -b(error)h(message)g(will)g(b)s(e)f(written)h(to)h(the)e(standard)g -(error,)h(and)f(a)h(non-)1110 408 y(in)m(teractiv)m(e)k(shell)e(will)g -(exit.)630 568 y Ft(-v)384 b Fu(Prin)m(t)30 b(shell)h(input)e(lines)i -(as)g(they)f(are)h(read.)630 727 y Ft(-x)384 b Fu(Prin)m(t)21 -b(a)h(trace)h(of)f(simple)f(commands,)i Ft(for)e Fu(commands,)i -Ft(case)d Fu(commands,)1110 837 y Ft(select)29 b Fu(commands,)j(and)e +b(Shell)30 b(Builtin)h(Commands)2069 b(65)630 299 y Ft(-p)384 +b Fu(T)-8 b(urn)33 b(on)h(privileged)h(mo)s(de.)51 b(In)34 +b(this)g(mo)s(de,)h(the)f Ft($BASH_ENV)e Fu(and)h Ft($ENV)1110 +408 y Fu(\014les)23 b(are)h(not)f(pro)s(cessed,)h(shell)g(functions)e +(are)i(not)f(inherited)g(from)f(the)i(en-)1110 518 y(vironmen)m(t,)h +(and)e(the)g Ft(SHELLOPTS)p Fu(,)f Ft(BASHOPTS)p Fu(,)h +Ft(CDPATH)e Fu(and)i Ft(GLOBIGNORE)1110 628 y Fu(v)-5 +b(ariables,)23 b(if)e(they)g(app)s(ear)f(in)g(the)h(en)m(vironmen)m(t,) +i(are)e(ignored.)38 b(If)20 b(the)h(shell)1110 737 y(is)37 +b(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d(\(group\))g(id)g(not)g +(equal)h(to)g(the)f(real)1110 847 y(user)h(\(group\))h(id,)i(and)d(the) +h Ft(-p)f Fu(option)i(is)e(not)i(supplied,)f(these)h(actions)1110 +956 y(are)32 b(tak)m(en)i(and)d(the)h(e\013ectiv)m(e)j(user)c(id)h(is)g +(set)h(to)f(the)h(real)f(user)g(id.)45 b(If)32 b(the)1110 +1066 y Ft(-p)i Fu(option)h(is)g(supplied)f(at)h(startup,)h(the)f +(e\013ectiv)m(e)i(user)d(id)g(is)h(not)g(reset.)1110 +1176 y(T)-8 b(urning)35 b(this)i(option)g(o\013)g(causes)g(the)g +(e\013ectiv)m(e)i(user)d(and)g(group)g(ids)g(to)1110 +1285 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f(and)g(group)g(ids.)630 +1450 y Ft(-t)384 b Fu(Exit)31 b(after)g(reading)f(and)g(executing)h +(one)g(command.)630 1614 y Ft(-u)384 b Fu(T)-8 b(reat)25 +b(unset)e(v)-5 b(ariables)25 b(and)e(parameters)h(other)h(than)e(the)h +(sp)s(ecial)h(param-)1110 1724 y(eters)35 b(`)p Ft(@)p +Fu(')f(or)g(`)p Ft(*)p Fu(')h(as)f(an)g(error)g(when)f(p)s(erforming)g +(parameter)i(expansion.)1110 1833 y(An)28 b(error)h(message)g(will)g(b) +s(e)f(written)h(to)h(the)e(standard)g(error,)h(and)f(a)h(non-)1110 +1943 y(in)m(teractiv)m(e)k(shell)e(will)g(exit.)630 2107 +y Ft(-v)384 b Fu(Prin)m(t)30 b(shell)h(input)e(lines)i(as)g(they)f(are) +h(read.)630 2271 y Ft(-x)384 b Fu(Prin)m(t)21 b(a)h(trace)h(of)f +(simple)f(commands,)i Ft(for)e Fu(commands,)i Ft(case)d +Fu(commands,)1110 2381 y Ft(select)29 b Fu(commands,)j(and)e (arithmetic)j Ft(for)d Fu(commands)h(and)f(their)i(argu-)1110 -946 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f -(are)h(expanded)f(and)f(b)s(efore)1110 1056 y(they)i(are)g(executed.)49 +2491 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f +(are)h(expanded)f(and)f(b)s(efore)1110 2600 y(they)i(are)g(executed.)49 b(The)32 b(v)-5 b(alue)33 b(of)g(the)g Ft(PS4)f Fu(v)-5 -b(ariable)34 b(is)f(expanded)f(and)1110 1166 y(the)24 +b(ariable)34 b(is)f(expanded)f(and)1110 2710 y(the)24 b(resultan)m(t)h(v)-5 b(alue)24 b(is)g(prin)m(ted)g(b)s(efore)f(the)h -(command)g(and)f(its)i(expanded)1110 1275 y(argumen)m(ts.)630 -1435 y Ft(-B)384 b Fu(The)41 b(shell)g(will)g(p)s(erform)f(brace)h -(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 1544 +(command)g(and)f(its)i(expanded)1110 2819 y(argumen)m(ts.)630 +2984 y Ft(-B)384 b Fu(The)41 b(shell)g(will)g(p)s(erform)f(brace)h +(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 3093 y(Expansion],)30 b(page)h(23\).)42 b(This)30 b(option)h(is)f(on)g(b)m -(y)h(default.)630 1704 y Ft(-C)384 b Fu(Prev)m(en)m(t)25 +(y)h(default.)630 3258 y Ft(-C)384 b Fu(Prev)m(en)m(t)25 b(output)e(redirection)h(using)f(`)p Ft(>)p Fu(',)i(`)p Ft(>&)p Fu(',)g(and)e(`)p Ft(<>)p Fu(')g(from)h(o)m(v)m(erwriting)1110 -1813 y(existing)31 b(\014les.)630 1973 y Ft(-E)384 b +3367 y(existing)31 b(\014les.)630 3532 y Ft(-E)384 b Fu(If)39 b(set,)j(an)m(y)e(trap)f(on)g Ft(ERR)g Fu(is)g(inherited)g(b)m -(y)g(shell)h(functions,)h(command)1110 2082 y(substitutions,)35 +(y)g(shell)h(functions,)h(command)1110 3641 y(substitutions,)35 b(and)e(commands)g(executed)i(in)f(a)g(subshell)f(en)m(vironmen)m(t.) -1110 2192 y(The)d Ft(ERR)f Fu(trap)i(is)f(normally)h(not)f(inherited)g -(in)g(suc)m(h)g(cases.)630 2351 y Ft(-H)384 b Fu(Enable)38 +1110 3751 y(The)d Ft(ERR)f Fu(trap)i(is)f(normally)h(not)f(inherited)g +(in)g(suc)m(h)g(cases.)630 3915 y Ft(-H)384 b Fu(Enable)38 b(`)p Ft(!)p Fu(')h(st)m(yle)h(history)e(substitution)g(\(see)h -(Section)h(9.3)f([History)g(In-)1110 2461 y(teraction],)g(page)d +(Section)h(9.3)f([History)g(In-)1110 4025 y(teraction],)g(page)d (146\).)57 b(This)34 b(option)i(is)f(on)g(b)m(y)h(default)f(for)g(in)m -(teractiv)m(e)1110 2570 y(shells.)630 2730 y Ft(-P)384 +(teractiv)m(e)1110 4134 y(shells.)630 4299 y Ft(-P)384 b Fu(If)39 b(set,)j(do)d(not)g(resolv)m(e)i(sym)m(b)s(olic)e(links)g -(when)f(p)s(erforming)g(commands)1110 2839 y(suc)m(h)29 +(when)f(p)s(erforming)g(commands)1110 4408 y(suc)m(h)29 b(as)h Ft(cd)f Fu(whic)m(h)g(c)m(hange)h(the)g(curren)m(t)f(directory) --8 b(.)42 b(The)28 b(ph)m(ysical)j(direc-)1110 2949 y(tory)j(is)g(used) +-8 b(.)42 b(The)28 b(ph)m(ysical)j(direc-)1110 4518 y(tory)j(is)g(used) f(instead.)52 b(By)34 b(default,)h(Bash)f(follo)m(ws)h(the)f(logical)i -(c)m(hain)f(of)1110 3059 y(directories)j(when)d(p)s(erforming)h +(c)m(hain)f(of)1110 4628 y(directories)j(when)d(p)s(erforming)h (commands)g(whic)m(h)g(c)m(hange)i(the)f(curren)m(t)1110 -3168 y(directory)-8 b(.)1110 3303 y(F)g(or)42 b(example,)i(if)d +4737 y(directory)-8 b(.)1110 4874 y(F)g(or)42 b(example,)i(if)d Ft(/usr/sys)e Fu(is)i(a)g(sym)m(b)s(olic)g(link)g(to)h -Ft(/usr/local/sys)1110 3412 y Fu(then:)1350 3547 y Ft($)47 -b(cd)h(/usr/sys;)d(echo)i($PWD)1350 3656 y(/usr/sys)1350 -3766 y($)g(cd)h(..;)f(pwd)1350 3875 y(/usr)1110 4010 -y Fu(If)30 b Ft(set)f(-P)h Fu(is)h(on,)f(then:)1350 4144 -y Ft($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 4254 y(/usr/local/sys) -1350 4364 y($)g(cd)h(..;)f(pwd)1350 4473 y(/usr/local)630 -4633 y(-T)384 b Fu(If)34 b(set,)j(an)m(y)e(trap)g(on)g -Ft(DEBUG)e Fu(and)i Ft(RETURN)e Fu(are)i(inherited)g(b)m(y)f(shell)i -(func-)1110 4742 y(tions,)k(command)d(substitutions,)h(and)f(commands)g -(executed)h(in)f(a)h(sub-)1110 4852 y(shell)33 b(en)m(vironmen)m(t.)49 -b(The)32 b Ft(DEBUG)g Fu(and)g Ft(RETURN)f Fu(traps)h(are)i(normally)f -(not)1110 4961 y(inherited)d(in)g(suc)m(h)g(cases.)630 -5121 y Ft(--)384 b Fu(If)44 b(no)g(argumen)m(ts)g(follo)m(w)i(this)e -(option,)k(then)c(the)h(p)s(ositional)g(parame-)1110 -5230 y(ters)31 b(are)g(unset.)40 b(Otherwise,)31 b(the)f(p)s(ositional) -i(parameters)f(are)f(set)h(to)h(the)1110 5340 y Fr(argumen)m(ts)p -Fu(,)f(ev)m(en)g(if)f(some)h(of)g(them)f(b)s(egin)g(with)g(a)h(`)p -Ft(-)p Fu('.)p eop end +Ft(/usr/local/sys)1110 4984 y Fu(then:)1350 5121 y Ft($)47 +b(cd)h(/usr/sys;)d(echo)i($PWD)1350 5230 y(/usr/sys)1350 +5340 y($)g(cd)h(..;)f(pwd)p eop end %%Page: 66 72 TeXDict begin 66 71 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(66)630 299 y Ft(-)432 -b Fu(Signal)45 b(the)g(end)f(of)h(options,)k(cause)c(all)h(remaining)e -Fr(argumen)m(ts)49 b Fu(to)d(b)s(e)1110 408 y(assigned)33 -b(to)h(the)g(p)s(ositional)g(parameters.)49 b(The)33 -b Ft(-x)g Fu(and)f Ft(-v)h Fu(options)h(are)1110 518 -y(turned)k(o\013.)68 b(If)38 b(there)i(are)f(no)g(argumen)m(ts,)j(the)e -(p)s(ositional)g(parameters)1110 628 y(remain)30 b(unc)m(hanged.)630 -775 y(Using)d(`)p Ft(+)p Fu(')h(rather)f(than)g(`)p Ft(-)p -Fu(')g(causes)h(these)f(options)h(to)g(b)s(e)e(turned)g(o\013.)40 -b(The)27 b(options)h(can)630 884 y(also)36 b(b)s(e)f(used)f(up)s(on)g -(in)m(v)m(o)s(cation)j(of)e(the)g(shell.)56 b(The)34 -b(curren)m(t)h(set)h(of)f(options)h(ma)m(y)g(b)s(e)630 -994 y(found)29 b(in)h Ft($-)p Fu(.)630 1122 y(The)43 +b(Shell)30 b(Builtin)h(Commands)2069 b(66)1350 299 y +Ft(/usr)1110 433 y Fu(If)30 b Ft(set)f(-P)h Fu(is)h(on,)f(then:)1350 +566 y Ft($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 676 +y(/usr/local/sys)1350 786 y($)g(cd)h(..;)f(pwd)1350 895 +y(/usr/local)630 1053 y(-T)384 b Fu(If)34 b(set,)j(an)m(y)e(trap)g(on)g +Ft(DEBUG)e Fu(and)i Ft(RETURN)e Fu(are)i(inherited)g(b)m(y)f(shell)i +(func-)1110 1163 y(tions,)k(command)d(substitutions,)h(and)f(commands)g +(executed)h(in)f(a)h(sub-)1110 1272 y(shell)33 b(en)m(vironmen)m(t.)49 +b(The)32 b Ft(DEBUG)g Fu(and)g Ft(RETURN)f Fu(traps)h(are)i(normally)f +(not)1110 1382 y(inherited)d(in)g(suc)m(h)g(cases.)630 +1540 y Ft(--)384 b Fu(If)44 b(no)g(argumen)m(ts)g(follo)m(w)i(this)e +(option,)k(then)c(the)h(p)s(ositional)g(parame-)1110 +1649 y(ters)31 b(are)g(unset.)40 b(Otherwise,)31 b(the)f(p)s(ositional) +i(parameters)f(are)f(set)h(to)h(the)1110 1759 y Fr(argumen)m(ts)p +Fu(,)f(ev)m(en)g(if)f(some)h(of)g(them)f(b)s(egin)g(with)g(a)h(`)p +Ft(-)p Fu('.)630 1917 y Ft(-)432 b Fu(Signal)45 b(the)g(end)f(of)h +(options,)k(cause)c(all)h(remaining)e Fr(argumen)m(ts)49 +b Fu(to)d(b)s(e)1110 2027 y(assigned)33 b(to)h(the)g(p)s(ositional)g +(parameters.)49 b(The)33 b Ft(-x)g Fu(and)f Ft(-v)h Fu(options)h(are) +1110 2136 y(turned)k(o\013.)68 b(If)38 b(there)i(are)f(no)g(argumen)m +(ts,)j(the)e(p)s(ositional)g(parameters)1110 2246 y(remain)30 +b(unc)m(hanged.)630 2404 y(Using)d(`)p Ft(+)p Fu(')h(rather)f(than)g(`) +p Ft(-)p Fu(')g(causes)h(these)f(options)h(to)g(b)s(e)e(turned)g +(o\013.)40 b(The)27 b(options)h(can)630 2513 y(also)36 +b(b)s(e)f(used)f(up)s(on)g(in)m(v)m(o)s(cation)j(of)e(the)g(shell.)56 +b(The)34 b(curren)m(t)h(set)h(of)f(options)h(ma)m(y)g(b)s(e)630 +2623 y(found)29 b(in)h Ft($-)p Fu(.)630 2757 y(The)43 b(remaining)h(N)f Fr(argumen)m(ts)48 b Fu(are)c(p)s(ositional)g -(parameters)g(and)f(are)h(assigned,)j(in)630 1232 y(order,)30 +(parameters)g(and)f(are)h(assigned,)j(in)630 2866 y(order,)30 b(to)h Ft($1)p Fu(,)f Ft($2)p Fu(,)36 b(.)22 b(.)g(.)42 b Ft($N)p Fu(.)e(The)30 b(sp)s(ecial)h(parameter)g Ft(#)f -Fu(is)g(set)h(to)g(N.)630 1360 y(The)f(return)f(status)i(is)f(alw)m(a)m +Fu(is)g(set)h(to)g(N.)630 3000 y(The)f(return)f(status)i(is)f(alw)m(a)m (ys)i(zero)f(unless)f(an)g(in)m(v)-5 b(alid)31 b(option)g(is)f -(supplied.)150 1548 y Fk(4.3.2)63 b(The)41 b(Shopt)h(Builtin)150 -1695 y Fu(This)30 b(builtin)g(allo)m(ws)h(y)m(ou)g(to)g(c)m(hange)h +(supplied.)150 3198 y Fk(4.3.2)63 b(The)41 b(Shopt)h(Builtin)150 +3345 y Fu(This)30 b(builtin)g(allo)m(ws)h(y)m(ou)g(to)g(c)m(hange)h (additional)f(shell)f(optional)i(b)s(eha)m(vior.)150 -1842 y Ft(shopt)870 1970 y(shopt)46 b([-pqsu])g([-o])h([)p -Fj(optname)e Ft(...])630 2099 y Fu(T)-8 b(oggle)37 b(the)e(v)-5 +3503 y Ft(shopt)870 3636 y(shopt)46 b([-pqsu])g([-o])h([)p +Fj(optname)e Ft(...])630 3770 y Fu(T)-8 b(oggle)37 b(the)e(v)-5 b(alues)35 b(of)g(settings)h(con)m(trolling)g(optional)g(shell)f(b)s -(eha)m(vior.)55 b(The)34 b(settings)630 2208 y(can)24 +(eha)m(vior.)55 b(The)34 b(settings)630 3880 y(can)24 b(b)s(e)g(either)h(those)f(listed)h(b)s(elo)m(w,)h(or,)f(if)g(the)f Ft(-o)f Fu(option)i(is)f(used,)h(those)g(a)m(v)-5 b(ailable)26 -b(with)630 2318 y(the)k Ft(-o)f Fu(option)i(to)f(the)g +b(with)630 3989 y(the)k Ft(-o)f Fu(option)i(to)f(the)g Ft(set)f Fu(builtin)h(command)f(\(see)i(Section)g(4.3.1)g([The)f(Set)g -(Builtin],)630 2427 y(page)i(62\).)45 b(With)32 b(no)f(options,)h(or)g +(Builtin],)630 4099 y(page)i(62\).)45 b(With)32 b(no)f(options,)h(or)g (with)f(the)g Ft(-p)g Fu(option,)h(a)g(list)g(of)f(all)i(settable)g -(options)630 2537 y(is)g(displa)m(y)m(ed,)i(with)e(an)g(indication)h +(options)630 4209 y(is)g(displa)m(y)m(ed,)i(with)e(an)g(indication)h (of)g(whether)e(or)h(not)h(eac)m(h)g(is)g(set;)h(if)e -Fr(optnames)38 b Fu(are)630 2647 y(supplied,)25 b(the)g(output)g(is)g +Fr(optnames)38 b Fu(are)630 4318 y(supplied,)25 b(the)g(output)g(is)g (restricted)g(to)h(those)g(options.)39 b(The)24 b Ft(-p)h -Fu(option)g(causes)g(output)630 2756 y(to)30 b(b)s(e)f(displa)m(y)m(ed) +Fu(option)g(causes)g(output)630 4428 y(to)30 b(b)s(e)f(displa)m(y)m(ed) g(in)g(a)h(form)f(that)g(ma)m(y)h(b)s(e)f(reused)f(as)i(input.)39 -b(Other)29 b(options)g(ha)m(v)m(e)i(the)630 2866 y(follo)m(wing)h -(meanings:)630 3013 y Ft(-s)384 b Fu(Enable)30 b(\(set\))i(eac)m(h)f -Fr(optname)p Fu(.)630 3160 y Ft(-u)384 b Fu(Disable)31 -b(\(unset\))g(eac)m(h)h Fr(optname)p Fu(.)630 3307 y +b(Other)29 b(options)g(ha)m(v)m(e)i(the)630 4537 y(follo)m(wing)h +(meanings:)630 4695 y Ft(-s)384 b Fu(Enable)30 b(\(set\))i(eac)m(h)f +Fr(optname)p Fu(.)630 4853 y Ft(-u)384 b Fu(Disable)31 +b(\(unset\))g(eac)m(h)h Fr(optname)p Fu(.)630 5011 y Ft(-q)384 b Fu(Suppresses)28 b(normal)h(output;)h(the)g(return)e -(status)i(indicates)h(whether)e(the)1110 3417 y Fr(optname)37 +(status)i(indicates)h(whether)e(the)1110 5121 y Fr(optname)37 b Fu(is)31 b(set)h(or)f(unset.)43 b(If)31 b(m)m(ultiple)h Fr(optname)37 b Fu(argumen)m(ts)31 b(are)h(giv)m(en)1110 -3527 y(with)d Ft(-q)p Fu(,)g(the)g(return)f(status)h(is)g(zero)h(if)f -(all)h Fr(optnames)j Fu(are)d(enabled;)f(non-)1110 3636 -y(zero)i(otherwise.)630 3784 y Ft(-o)384 b Fu(Restricts)22 -b(the)f(v)-5 b(alues)22 b(of)f Fr(optname)27 b Fu(to)22 -b(b)s(e)e(those)i(de\014ned)e(for)h(the)g Ft(-o)f Fu(option)1110 -3893 y(to)31 b(the)g Ft(set)e Fu(builtin)h(\(see)h(Section)h(4.3.1)g -([The)e(Set)g(Builtin],)i(page)f(62\).)630 4040 y(If)e(either)i -Ft(-s)e Fu(or)h Ft(-u)f Fu(is)h(used)f(with)g(no)h Fr(optname)35 -b Fu(argumen)m(ts,)c Ft(shopt)d Fu(sho)m(ws)h(only)h(those)630 -4150 y(options)h(whic)m(h)f(are)h(set)f(or)h(unset,)f(resp)s(ectiv)m -(ely)-8 b(.)630 4278 y(Unless)30 b(otherwise)h(noted,)g(the)g -Ft(shopt)d Fu(options)j(are)g(disabled)f(\(o\013)7 b(\))32 -b(b)m(y)e(default.)630 4407 y(The)d(return)f(status)i(when)f(listing)h -(options)g(is)f(zero)i(if)e(all)i Fr(optnames)i Fu(are)d(enabled,)g -(non-)630 4516 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f -(unsetting)g(options,)i(the)e(return)f(status)h(is)g(zero)630 -4626 y(unless)30 b(an)g Fr(optname)36 b Fu(is)30 b(not)h(a)g(v)-5 -b(alid)30 b(shell)h(option.)630 4754 y(The)f(list)h(of)f -Ft(shopt)f Fu(options)i(is:)630 4902 y Ft(assoc_expand_once)1110 -5011 y Fu(If)h(set,)i(the)e(shell)h(suppresses)e(m)m(ultiple)i(ev)-5 -b(aluation)34 b(of)e(asso)s(ciativ)m(e)j(arra)m(y)1110 -5121 y(subscripts)24 b(during)h(arithmetic)h(expression)g(ev)-5 -b(aluation,)28 b(while)e(executing)1110 5230 y(builtins)c(that)i(can)f -(p)s(erform)f(v)-5 b(ariable)24 b(assignmen)m(ts,)h(and)e(while)g -(executing)1110 5340 y(builtins)30 b(that)h(p)s(erform)e(arra)m(y)i -(dereferencing.)p eop end +5230 y(with)d Ft(-q)p Fu(,)g(the)g(return)f(status)h(is)g(zero)h(if)f +(all)h Fr(optnames)j Fu(are)d(enabled;)f(non-)1110 5340 +y(zero)i(otherwise.)p eop end %%Page: 67 73 TeXDict begin 67 72 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Ft(autocd)192 -b Fu(If)27 b(set,)h(a)g(command)f(name)g(that)h(is)f(the)g(name)g(of)h -(a)f(directory)h(is)f(executed)1110 408 y(as)j(if)f(it)h(w)m(ere)f(the) -h(argumen)m(t)g(to)g(the)f Ft(cd)g Fu(command.)40 b(This)29 -b(option)g(is)h(only)1110 518 y(used)g(b)m(y)g(in)m(teractiv)m(e)j -(shells.)630 682 y Ft(cdable_vars)1110 792 y Fu(If)h(this)h(is)g(set,)i -(an)e(argumen)m(t)g(to)h(the)f Ft(cd)f Fu(builtin)h(command)f(that)i -(is)f(not)1110 902 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h +b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Ft(-o)384 +b Fu(Restricts)22 b(the)f(v)-5 b(alues)22 b(of)f Fr(optname)27 +b Fu(to)22 b(b)s(e)e(those)i(de\014ned)e(for)h(the)g +Ft(-o)f Fu(option)1110 408 y(to)31 b(the)g Ft(set)e Fu(builtin)h(\(see) +h(Section)h(4.3.1)g([The)e(Set)g(Builtin],)i(page)f(62\).)630 +570 y(If)e(either)i Ft(-s)e Fu(or)h Ft(-u)f Fu(is)h(used)f(with)g(no)h +Fr(optname)35 b Fu(argumen)m(ts,)c Ft(shopt)d Fu(sho)m(ws)h(only)h +(those)630 680 y(options)h(whic)m(h)f(are)h(set)f(or)h(unset,)f(resp)s +(ectiv)m(ely)-8 b(.)630 816 y(Unless)30 b(otherwise)h(noted,)g(the)g +Ft(shopt)d Fu(options)j(are)g(disabled)f(\(o\013)7 b(\))32 +b(b)m(y)e(default.)630 951 y(The)d(return)f(status)i(when)f(listing)h +(options)g(is)f(zero)i(if)e(all)i Fr(optnames)i Fu(are)d(enabled,)g +(non-)630 1061 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f +(unsetting)g(options,)i(the)e(return)f(status)h(is)g(zero)630 +1170 y(unless)30 b(an)g Fr(optname)36 b Fu(is)30 b(not)h(a)g(v)-5 +b(alid)30 b(shell)h(option.)630 1306 y(The)f(list)h(of)f +Ft(shopt)f Fu(options)i(is:)630 1468 y Ft(assoc_expand_once)1110 +1577 y Fu(If)h(set,)i(the)e(shell)h(suppresses)e(m)m(ultiple)i(ev)-5 +b(aluation)34 b(of)e(asso)s(ciativ)m(e)j(arra)m(y)1110 +1687 y(subscripts)24 b(during)h(arithmetic)h(expression)g(ev)-5 +b(aluation,)28 b(while)e(executing)1110 1797 y(builtins)c(that)i(can)f +(p)s(erform)f(v)-5 b(ariable)24 b(assignmen)m(ts,)h(and)e(while)g +(executing)1110 1906 y(builtins)30 b(that)h(p)s(erform)e(arra)m(y)i +(dereferencing.)630 2068 y Ft(autocd)192 b Fu(If)27 b(set,)h(a)g +(command)f(name)g(that)h(is)f(the)g(name)g(of)h(a)f(directory)h(is)f +(executed)1110 2178 y(as)j(if)f(it)h(w)m(ere)f(the)h(argumen)m(t)g(to)g +(the)f Ft(cd)g Fu(command.)40 b(This)29 b(option)g(is)h(only)1110 +2287 y(used)g(b)m(y)g(in)m(teractiv)m(e)j(shells.)630 +2449 y Ft(cdable_vars)1110 2559 y Fu(If)h(this)h(is)g(set,)i(an)e +(argumen)m(t)g(to)h(the)f Ft(cd)f Fu(builtin)h(command)f(that)i(is)f +(not)1110 2668 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h (name)f(of)h(a)g(v)-5 b(ariable)31 b(whose)g(v)-5 b(alue)31 -b(is)1110 1011 y(the)g(directory)f(to)i(c)m(hange)f(to.)630 -1176 y Ft(cdspell)144 b Fu(If)27 b(set,)h(minor)f(errors)f(in)h(the)g +b(is)1110 2778 y(the)g(directory)f(to)i(c)m(hange)f(to.)630 +2939 y Ft(cdspell)144 b Fu(If)27 b(set,)h(minor)f(errors)f(in)h(the)g (sp)s(elling)h(of)f(a)g(directory)h(comp)s(onen)m(t)f(in)g(a)h -Ft(cd)1110 1285 y Fu(command)i(will)h(b)s(e)f(corrected.)43 +Ft(cd)1110 3049 y Fu(command)i(will)h(b)s(e)f(corrected.)43 b(The)30 b(errors)g(c)m(hec)m(k)m(ed)j(for)d(are)h(transp)s(osed)1110 -1395 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47 +3159 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47 b(and)40 b(a)i(c)m(haracter)h(to)s(o)g(man)m(y)-8 b(.)74 -b(If)42 b(a)1110 1504 y(correction)25 b(is)e(found,)g(the)h(corrected)g -(path)f(is)g(prin)m(ted,)h(and)f(the)g(command)1110 1614 +b(If)42 b(a)1110 3268 y(correction)25 b(is)e(found,)g(the)h(corrected)g +(path)f(is)g(prin)m(ted,)h(and)f(the)g(command)1110 3378 y(pro)s(ceeds.)40 b(This)30 b(option)h(is)f(only)h(used)e(b)m(y)h(in)m -(teractiv)m(e)k(shells.)630 1778 y Ft(checkhash)1110 -1888 y Fu(If)29 b(this)h(is)g(set,)g(Bash)g(c)m(hec)m(ks)h(that)g(a)f -(command)f(found)g(in)g(the)h(hash)f(table)1110 1998 +(teractiv)m(e)k(shells.)630 3540 y Ft(checkhash)1110 +3649 y Fu(If)29 b(this)h(is)g(set,)g(Bash)g(c)m(hec)m(ks)h(that)g(a)f +(command)f(found)g(in)g(the)h(hash)f(table)1110 3759 y(exists)k(b)s(efore)f(trying)h(to)h(execute)g(it.)48 -b(If)32 b(a)h(hashed)e(command)i(no)f(longer)1110 2107 +b(If)32 b(a)h(hashed)e(command)i(no)f(longer)1110 3868 y(exists,)f(a)g(normal)f(path)g(searc)m(h)h(is)g(p)s(erformed.)630 -2271 y Ft(checkjobs)1110 2381 y Fu(If)d(set,)i(Bash)e(lists)h(the)g +4030 y Ft(checkjobs)1110 4140 y Fu(If)d(set,)i(Bash)e(lists)h(the)g (status)g(of)f(an)m(y)h(stopp)s(ed)f(and)g(running)e(jobs)i(b)s(efore) -1110 2491 y(exiting)42 b(an)f(in)m(teractiv)m(e)j(shell.)72 +1110 4249 y(exiting)42 b(an)f(in)m(teractiv)m(e)j(shell.)72 b(If)41 b(an)m(y)g(jobs)f(are)i(running,)g(this)f(causes)1110 -2600 y(the)30 b(exit)g(to)g(b)s(e)f(deferred)g(un)m(til)h(a)f(second)h -(exit)g(is)g(attempted)h(without)e(an)1110 2710 y(in)m(terv)m(ening)d +4359 y(the)30 b(exit)g(to)g(b)s(e)f(deferred)g(un)m(til)h(a)f(second)h +(exit)g(is)g(attempted)h(without)e(an)1110 4468 y(in)m(terv)m(ening)d (command)f(\(see)h(Chapter)e(7)h([Job)g(Con)m(trol],)i(page)f(105\).)40 -b(The)1110 2819 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h -(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 2984 y Ft(checkwinsize)1110 -3093 y Fu(If)23 b(set,)j(Bash)e(c)m(hec)m(ks)h(the)f(windo)m(w)f(size)h -(after)h(eac)m(h)f(external)h(\(non-builtin\))1110 3203 +b(The)1110 4578 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h +(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 4740 y Ft(checkwinsize)1110 +4849 y Fu(If)23 b(set,)j(Bash)e(c)m(hec)m(ks)h(the)f(windo)m(w)f(size)h +(after)h(eac)m(h)f(external)h(\(non-builtin\))1110 4959 y(command)55 b(and,)60 b(if)55 b(necessary)-8 b(,)62 b(up)s(dates)54 b(the)h(v)-5 b(alues)55 b(of)g Ft(LINES)f -Fu(and)1110 3313 y Ft(COLUMNS)p Fu(.)39 b(This)29 b(option)i(is)g -(enabled)f(b)m(y)g(default.)630 3477 y Ft(cmdhist)144 +Fu(and)1110 5069 y Ft(COLUMNS)p Fu(.)39 b(This)29 b(option)i(is)g +(enabled)f(b)m(y)g(default.)630 5230 y Ft(cmdhist)144 b Fu(If)33 b(set,)j(Bash)e(attempts)h(to)g(sa)m(v)m(e)g(all)g(lines)f -(of)g(a)h(m)m(ultiple-line)g(command)1110 3587 y(in)c(the)g(same)g +(of)g(a)h(m)m(ultiple-line)g(command)1110 5340 y(in)c(the)g(same)g (history)g(en)m(try)-8 b(.)42 b(This)30 b(allo)m(ws)i(easy)g -(re-editing)g(of)f(m)m(ulti-line)1110 3696 y(commands.)79 -b(This)43 b(option)g(is)h(enabled)f(b)m(y)g(default,)k(but)c(only)g -(has)g(an)1110 3806 y(e\013ect)30 b(if)e(command)g(history)g(is)h -(enabled)f(\(see)h(Section)g(9.1)h([Bash)e(History)1110 -3915 y(F)-8 b(acilities],)34 b(page)d(144\).)630 4080 -y Ft(compat31)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha) -m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)1110 -4189 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h -(command's)f(`)p Ft(=~)p Fu(')g(op)s(erator)1110 4299 -y(and)i(with)f(resp)s(ect)i(to)g(lo)s(cale-sp)s(eci\014c)h(string)e -(comparison)g(when)f(using)1110 4408 y(the)31 b Ft([[)e -Fu(conditional)j(command's)e(`)p Ft(<)p Fu(')h(and)f(`)p -Ft(>)p Fu(')g(op)s(erators.)41 b(Bash)31 b(v)m(ersions)1110 -4518 y(prior)g(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e -(strcmp\(3\);)i(bash-4.1)g(and)1110 4628 y(later)e(use)f(the)h(curren)m -(t)f(lo)s(cale's)i(collation)h(sequence)e(and)f(strcoll\(3\).)630 -4792 y Ft(compat32)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s -(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.2)h(with)e(resp)s(ect) -1110 4902 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g -(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 5011 -y(command's)21 b(`)p Ft(<)p Fu(')g(and)f(`)p Ft(>)p Fu(')h(op)s -(erators)g(\(see)h(previous)e(item\))i(and)e(the)h(e\013ect)i(of)1110 -5121 y(in)m(terrupting)h(a)h(command)e(list.)40 b(Bash)24 -b(v)m(ersions)h(3.2)g(and)f(earlier)h(con)m(tin)m(ue)1110 -5230 y(with)33 b(the)g(next)g(command)g(in)g(the)g(list)h(after)f(one)h -(terminates)g(due)e(to)i(an)1110 5340 y(in)m(terrupt.)p -eop end +(re-editing)g(of)f(m)m(ulti-line)p eop end %%Page: 68 74 TeXDict begin 68 73 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(68)630 299 y Ft(compat40)96 -b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha)m(vior)f(to)i -(that)f(of)f(v)m(ersion)h(4.0)h(with)e(resp)s(ect)1110 -408 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g(when)f -(using)h(the)g Ft([[)g Fu(conditional)1110 518 y(command's)28 -b(`)p Ft(<)p Fu(')h(and)f(`)p Ft(>)p Fu(')h(op)s(erators)f(\(see)i -(description)e(of)h Ft(compat31)p Fu(\))e(and)1110 628 -y(the)38 b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.)64 -b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 737 y(later)24 +b(Shell)30 b(Builtin)h(Commands)2069 b(68)1110 299 y(commands.)79 +b(This)43 b(option)g(is)h(enabled)f(b)m(y)g(default,)k(but)c(only)g +(has)g(an)1110 408 y(e\013ect)30 b(if)e(command)g(history)g(is)h +(enabled)f(\(see)h(Section)g(9.1)h([Bash)e(History)1110 +518 y(F)-8 b(acilities],)34 b(page)d(144\).)630 682 y +Ft(compat31)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha)m +(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)1110 +792 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h +(command's)f(`)p Ft(=~)p Fu(')g(op)s(erator)1110 902 +y(and)i(with)f(resp)s(ect)i(to)g(lo)s(cale-sp)s(eci\014c)h(string)e +(comparison)g(when)f(using)1110 1011 y(the)31 b Ft([[)e +Fu(conditional)j(command's)e(`)p Ft(<)p Fu(')h(and)f(`)p +Ft(>)p Fu(')g(op)s(erators.)41 b(Bash)31 b(v)m(ersions)1110 +1121 y(prior)g(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e +(strcmp\(3\);)i(bash-4.1)g(and)1110 1230 y(later)e(use)f(the)h(curren)m +(t)f(lo)s(cale's)i(collation)h(sequence)e(and)f(strcoll\(3\).)630 +1395 y Ft(compat32)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s +(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.2)h(with)e(resp)s(ect) +1110 1504 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g +(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 1614 +y(command's)21 b(`)p Ft(<)p Fu(')g(and)f(`)p Ft(>)p Fu(')h(op)s +(erators)g(\(see)h(previous)e(item\))i(and)e(the)h(e\013ect)i(of)1110 +1724 y(in)m(terrupting)h(a)h(command)e(list.)40 b(Bash)24 +b(v)m(ersions)h(3.2)g(and)f(earlier)h(con)m(tin)m(ue)1110 +1833 y(with)33 b(the)g(next)g(command)g(in)g(the)g(list)h(after)f(one)h +(terminates)g(due)e(to)i(an)1110 1943 y(in)m(terrupt.)630 +2107 y Ft(compat40)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s +(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(4.0)h(with)e(resp)s(ect) +1110 2217 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g +(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 2326 +y(command's)28 b(`)p Ft(<)p Fu(')h(and)f(`)p Ft(>)p Fu(')h(op)s +(erators)f(\(see)i(description)e(of)h Ft(compat31)p Fu(\))e(and)1110 +2436 y(the)38 b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.) +64 b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 2545 y(later)24 b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f(receiv)m(ed)i -(the)e(in)m(terrupt;)i(previous)1110 847 y(v)m(ersions)31 +(the)e(in)m(terrupt;)i(previous)1110 2655 y(v)m(ersions)31 b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g(the)g(list.)630 -1003 y Ft(compat41)96 b Fu(If)25 b(set,)j(Bash,)e(when)f(in)g +2819 y Ft(compat41)96 b Fu(If)25 b(set,)j(Bash,)e(when)f(in)g Fm(posix)g Fu(mo)s(de,)i(treats)f(a)g(single)h(quote)f(in)f(a)h -(double-)1110 1113 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h(sp)s -(ecial)f(c)m(haracter.)90 b(The)45 b(single)1110 1223 +(double-)1110 2929 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h(sp)s +(ecial)f(c)m(haracter.)90 b(The)45 b(single)1110 3039 y(quotes)34 b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h(n)m(um)m(b)s(er\))e -(and)g(the)h(c)m(haracters)h(b)s(et)m(w)m(een)1110 1332 +(and)g(the)h(c)m(haracters)h(b)s(et)m(w)m(een)1110 3148 y(the)40 b(single)g(quotes)g(are)g(considered)g(quoted.)69 -b(This)38 b(is)i(the)g(b)s(eha)m(vior)g(of)1110 1442 +b(This)38 b(is)i(the)g(b)s(eha)m(vior)g(of)1110 3258 y Fm(posix)f Fu(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69 b(The)39 b(default)g(Bash)h(b)s(eha)m(vior)g(re-)1110 -1551 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630 -1708 y Ft(compat42)96 b Fu(If)29 b(set,)i(Bash)f(do)s(es)f(not)h(pro)s +3367 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630 +3532 y Ft(compat42)96 b Fu(If)29 b(set,)i(Bash)f(do)s(es)f(not)h(pro)s (cess)g(the)g(replacemen)m(t)h(string)e(in)h(the)g(pattern)1110 -1817 y(substitution)g(w)m(ord)g(expansion)g(using)g(quote)h(remo)m(v)-5 -b(al.)630 1974 y Ft(compat43)96 b Fu(If)24 b(set,)j(Bash)e(do)s(es)g +3641 y(substitution)g(w)m(ord)g(expansion)g(using)g(quote)h(remo)m(v)-5 +b(al.)630 3806 y Ft(compat43)96 b Fu(If)24 b(set,)j(Bash)e(do)s(es)g (not)g(prin)m(t)g(a)g(w)m(arning)g(message)h(if)f(an)g(attempt)h(is)f -(made)1110 2084 y(to)43 b(use)g(a)g(quoted)f(comp)s(ound)f(arra)m(y)i -(assignmen)m(t)h(as)f(an)f(argumen)m(t)h(to)1110 2193 +(made)1110 3915 y(to)43 b(use)g(a)g(quoted)f(comp)s(ound)f(arra)m(y)i +(assignmen)m(t)h(as)f(an)f(argumen)m(t)h(to)1110 4025 y Ft(declare)p Fu(,)31 b(mak)m(es)i(w)m(ord)f(expansion)g(errors)g -(non-fatal)i(errors)d(that)i(cause)1110 2303 y(the)28 +(non-fatal)i(errors)d(that)i(cause)1110 4134 y(the)28 b(curren)m(t)h(command)f(to)h(fail)g(\(the)f(default)h(b)s(eha)m(vior)f -(is)h(to)g(mak)m(e)g(them)1110 2412 y(fatal)42 b(errors)e(that)i(cause) +(is)h(to)g(mak)m(e)g(them)1110 4244 y(fatal)42 b(errors)e(that)i(cause) f(the)h(shell)f(to)g(exit\),)k(and)c(do)s(es)f(not)h(reset)h(the)1110 -2522 y(lo)s(op)34 b(state)h(when)f(a)g(shell)g(function)g(is)g +4354 y(lo)s(op)34 b(state)h(when)f(a)g(shell)g(function)g(is)g (executed)h(\(this)f(allo)m(ws)h Ft(break)e Fu(or)1110 -2632 y Ft(continue)25 b Fu(in)j(a)g(shell)g(function)f(to)i(a\013ect)g -(lo)s(ops)f(in)f(the)h(caller's)h(con)m(text\).)630 2788 +4463 y Ft(continue)25 b Fu(in)j(a)g(shell)g(function)f(to)i(a\013ect)g +(lo)s(ops)f(in)f(the)h(caller's)h(con)m(text\).)630 4628 y Ft(compat44)96 b Fu(If)33 b(set,)i(Bash)f(sa)m(v)m(es)h(the)e(p)s -(ositional)i(parameters)f(to)g(BASH)p 3264 2788 28 4 -v 40 w(AR)m(GV)h(and)1110 2898 y(BASH)p 1367 2898 V 40 +(ositional)i(parameters)f(to)g(BASH)p 3264 4628 28 4 +v 40 w(AR)m(GV)h(and)1110 4737 y(BASH)p 1367 4737 V 40 w(AR)m(GC)k(b)s(efore)e(they)i(are)f(used,)i(regardless)e(of)g(whether) -g(or)g(not)1110 3007 y(extended)30 b(debugging)h(mo)s(de)f(is)g -(enabled.)630 3164 y Ft(complete_fullquote)1110 3273 +g(or)g(not)1110 4847 y(extended)30 b(debugging)h(mo)s(de)f(is)g +(enabled.)630 5011 y Ft(complete_fullquote)1110 5121 y Fu(If)h(set,)g(Bash)h(quotes)f(all)h(shell)f(metac)m(haracters)i(in)e -(\014lenames)g(and)g(direc-)1110 3383 y(tory)g(names)f(when)g(p)s +(\014lenames)g(and)g(direc-)1110 5230 y(tory)g(names)f(when)g(p)s (erforming)f(completion.)43 b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m -(es)1110 3493 y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g -(sign)g(from)f(the)h(set)g(of)f(c)m(haracters)1110 3602 -y(that)f(will)g(b)s(e)f(quoted)g(in)g(completed)i(\014lenames)e(when)f -(these)i(metac)m(har-)1110 3712 y(acters)29 b(app)s(ear)e(in)g(shell)h -(v)-5 b(ariable)28 b(references)g(in)f(w)m(ords)g(to)i(b)s(e)e -(completed.)1110 3821 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v) --5 b(ariable)33 b(names)g(that)f(expand)g(to)h(di-)1110 -3931 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,) -g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 4041 -y(\014lenames)j(will)h(not)f(b)s(e)g(quoted,)h(either.)41 -b(This)28 b(is)i(activ)m(e)h(only)e(when)g(bash)1110 -4150 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f -(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 4260 -y(is)41 b(set)g(b)m(y)g(default,)j(whic)m(h)c(is)h(the)g(default)g -(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 4369 y(through)30 -b(4.2.)630 4526 y Ft(direxpand)1110 4635 y Fu(If)k(set,)i(Bash)f -(replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g -(ex-)1110 4745 y(pansion)k(when)g(p)s(erforming)f(\014lename)i -(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 4855 -y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38 -b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 4964 -y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630 -5121 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s -(elling)g(correction)g(on)g(directory)g(names)f(during)1110 -5230 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g -(initially)h(supplied)e(do)s(es)h(not)1110 5340 y(exist.)p -eop end +(es)1110 5340 y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g +(sign)g(from)f(the)h(set)g(of)f(c)m(haracters)p eop end %%Page: 69 75 TeXDict begin 69 74 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(69)630 299 y Ft(dotglob)144 -b Fu(If)36 b(set,)i(Bash)e(includes)g(\014lenames)g(b)s(eginning)f -(with)h(a)g(`.')58 b(in)36 b(the)g(results)1110 408 y(of)f(\014lename)f -(expansion.)53 b(The)33 b(\014lenames)i(`)p Ft(.)p Fu(')f(and)g(`)p -Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 518 +b(Shell)30 b(Builtin)h(Commands)2069 b(69)1110 299 y(that)36 +b(will)g(b)s(e)f(quoted)g(in)g(completed)i(\014lenames)e(when)f(these)i +(metac)m(har-)1110 408 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5 +b(ariable)28 b(references)g(in)f(w)m(ords)g(to)i(b)s(e)e(completed.) +1110 518 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5 +b(ariable)33 b(names)g(that)f(expand)g(to)h(di-)1110 +628 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,)g +(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 737 +y(\014lenames)j(will)h(not)f(b)s(e)g(quoted,)h(either.)41 +b(This)28 b(is)i(activ)m(e)h(only)e(when)g(bash)1110 +847 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f +(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 956 +y(is)41 b(set)g(b)m(y)g(default,)j(whic)m(h)c(is)h(the)g(default)g +(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 1066 y(through)30 +b(4.2.)630 1244 y Ft(direxpand)1110 1354 y Fu(If)k(set,)i(Bash)f +(replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g +(ex-)1110 1463 y(pansion)k(when)g(p)s(erforming)f(\014lename)i +(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 1573 +y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38 +b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 1682 +y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630 +1861 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s +(elling)g(correction)g(on)g(directory)g(names)f(during)1110 +1970 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g +(initially)h(supplied)e(do)s(es)h(not)1110 2080 y(exist.)630 +2258 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g +(\014lenames)g(b)s(eginning)f(with)h(a)g(`.')58 b(in)36 +b(the)g(results)1110 2367 y(of)f(\014lename)f(expansion.)53 +b(The)33 b(\014lenames)i(`)p Ft(.)p Fu(')f(and)g(`)p +Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 2477 y(matc)m(hed)31 b(explicitly)-8 b(,)33 b(ev)m(en)e(if)f -Ft(dotglob)f Fu(is)h(set.)630 682 y Ft(execfail)96 b +Ft(dotglob)f Fu(is)h(set.)630 2655 y Ft(execfail)96 b Fu(If)24 b(this)h(is)f(set,)j(a)e(non-in)m(teractiv)m(e)i(shell)e(will) -f(not)h(exit)h(if)e(it)h(cannot)h(execute)1110 792 y(the)i(\014le)g(sp) -s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to)h(the)f Ft(exec)f -Fu(builtin)h(command.)39 b(An)1110 902 y(in)m(teractiv)m(e)33 -b(shell)e(do)s(es)f(not)g(exit)i(if)e Ft(exec)f Fu(fails.)630 -1066 y Ft(expand_aliases)1110 1176 y Fu(If)j(set,)h(aliases)g(are)g +f(not)h(exit)h(if)e(it)h(cannot)h(execute)1110 2765 y(the)i(\014le)g +(sp)s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to)h(the)f +Ft(exec)f Fu(builtin)h(command.)39 b(An)1110 2874 y(in)m(teractiv)m(e) +33 b(shell)e(do)s(es)f(not)g(exit)i(if)e Ft(exec)f Fu(fails.)630 +3052 y Ft(expand_aliases)1110 3162 y Fu(If)j(set,)h(aliases)g(are)g (expanded)e(as)h(describ)s(ed)f(b)s(elo)m(w)h(under)f(Aliases,)i(Sec-) -1110 1285 y(tion)38 b(6.6)h([Aliases],)j(page)d(94.)64 +1110 3271 y(tion)38 b(6.6)h([Aliases],)j(page)d(94.)64 b(This)37 b(option)h(is)g(enabled)g(b)m(y)g(default)g(for)1110 -1395 y(in)m(teractiv)m(e)33 b(shells.)630 1559 y Ft(extdebug)96 +3381 y(in)m(teractiv)m(e)33 b(shells.)630 3559 y Ft(extdebug)96 b Fu(If)35 b(set)i(at)f(shell)g(in)m(v)m(o)s(cation,)k(or)c(in)f(a)h (shell)h(startup)e(\014le,)i(arrange)g(to)f(ex-)1110 -1669 y(ecute)h(the)f(debugger)g(pro\014le)g(b)s(efore)g(the)g(shell)h -(starts,)h(iden)m(tical)g(to)f(the)1110 1778 y Ft(--debugger)32 +3669 y(ecute)h(the)f(debugger)g(pro\014le)g(b)s(efore)g(the)g(shell)h +(starts,)h(iden)m(tical)g(to)f(the)1110 3778 y Ft(--debugger)32 b Fu(option.)56 b(If)35 b(set)h(after)g(in)m(v)m(o)s(cation,)j(b)s(eha) -m(vior)c(in)m(tended)g(for)1110 1888 y(use)30 b(b)m(y)g(debuggers)g(is) -h(enabled:)1159 2025 y(1.)61 b(The)37 b Ft(-F)g Fu(option)h(to)g(the)g +m(vior)c(in)m(tended)g(for)1110 3888 y(use)30 b(b)m(y)g(debuggers)g(is) +h(enabled:)1159 4032 y(1.)61 b(The)37 b Ft(-F)g Fu(option)h(to)g(the)g Ft(declare)d Fu(builtin)i(\(see)i(Section)f(4.2)h([Bash)1290 -2134 y(Builtins],)29 b(page)g(51\))g(displa)m(ys)f(the)g(source)h -(\014le)f(name)g(and)f(line)h(n)m(um-)1290 2244 y(b)s(er)h(corresp)s +4141 y(Builtins],)29 b(page)g(51\))g(displa)m(ys)f(the)g(source)h +(\014le)f(name)g(and)f(line)h(n)m(um-)1290 4251 y(b)s(er)h(corresp)s (onding)g(to)i(eac)m(h)g(function)f(name)g(supplied)f(as)i(an)f(argu-) -1290 2354 y(men)m(t.)1159 2491 y(2.)61 b(If)20 b(the)h(command)g(run)e +1290 4361 y(men)m(t.)1159 4504 y(2.)61 b(If)20 b(the)h(command)g(run)e (b)m(y)i(the)f Ft(DEBUG)g Fu(trap)g(returns)g(a)h(non-zero)g(v)-5 -b(alue,)1290 2600 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g -(not)i(executed.)1159 2737 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m +b(alue,)1290 4614 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g +(not)i(executed.)1159 4758 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m (y)i(the)f Ft(DEBUG)f Fu(trap)h(returns)f(a)i(v)-5 b(alue)38 -b(of)f(2,)1290 2847 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h -(subroutine)e(\(a)i(shell)g(function)f(or)1290 2956 y(a)h(shell)g +b(of)f(2,)1290 4867 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h +(subroutine)e(\(a)i(shell)g(function)f(or)1290 4977 y(a)h(shell)g (script)f(executed)h(b)m(y)g(the)f Ft(.)h Fu(or)f Ft(source)f -Fu(builtins\),)i(the)g(shell)1290 3066 y(sim)m(ulates)d(a)g(call)h(to)f -Ft(return)p Fu(.)1159 3203 y(4.)61 b Ft(BASH_ARGC)34 +Fu(builtins\),)i(the)g(shell)1290 5087 y(sim)m(ulates)d(a)g(call)h(to)f +Ft(return)p Fu(.)1159 5230 y(4.)61 b Ft(BASH_ARGC)34 b Fu(and)i Ft(BASH_ARGV)e Fu(are)j(up)s(dated)e(as)h(describ)s(ed)g(in) -g(their)1290 3313 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g -(V)-8 b(ariables],)32 b(page)f(74\).)1159 3450 y(5.)61 -b(F)-8 b(unction)57 b(tracing)g(is)g(enabled:)93 b(command)56 -b(substitution,)63 b(shell)1290 3559 y(functions,)32 -b(and)e(subshells)h(in)m(v)m(ok)m(ed)i(with)e Ft(\()f -Fj(command)e Ft(\))j Fu(inherit)h(the)1290 3669 y Ft(DEBUG)d -Fu(and)h Ft(RETURN)e Fu(traps.)1159 3806 y(6.)61 b(Error)41 -b(tracing)i(is)f(enabled:)63 b(command)42 b(substitution,)i(shell)f -(func-)1290 3915 y(tions,)32 b(and)e(subshells)g(in)m(v)m(ok)m(ed)i -(with)e Ft(\()g Fj(command)f Ft(\))h Fu(inherit)h(the)g -Ft(ERR)1290 4025 y Fu(trap.)630 4189 y Ft(extglob)144 -b Fu(If)26 b(set,)i(the)f(extended)f(pattern)h(matc)m(hing)g(features)g -(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 4299 y(Section)j(3.5.8.1)i -([P)m(attern)f(Matc)m(hing],)g(page)f(33\))h(are)f(enabled.)630 -4463 y Ft(extquote)96 b Fu(If)51 b(set,)58 b Ft($')p -Fj(string)p Ft(')49 b Fu(and)i Ft($")p Fj(string)p Ft(")e -Fu(quoting)k(is)e(p)s(erformed)f(within)1110 4573 y Ft(${)p -Fj(parameter)p Ft(})31 b Fu(expansions)k(enclosed)g(in)g(double)f -(quotes.)55 b(This)33 b(option)1110 4682 y(is)d(enabled)h(b)m(y)f -(default.)630 4847 y Ft(failglob)96 b Fu(If)36 b(set,)j(patterns)d -(whic)m(h)g(fail)h(to)h(matc)m(h)f(\014lenames)f(during)g(\014lename)g -(ex-)1110 4956 y(pansion)30 b(result)g(in)g(an)g(expansion)h(error.)630 -5121 y Ft(force_fignore)1110 5230 y Fu(If)43 b(set,)k(the)d(su\016xes)f -(sp)s(eci\014ed)f(b)m(y)i(the)f Ft(FIGNORE)f Fu(shell)h(v)-5 -b(ariable)44 b(cause)1110 5340 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h -(when)f(p)s(erforming)f(w)m(ord)h(completion)i(ev)m(en)f(if)g(the)p -eop end +g(their)1290 5340 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g +(V)-8 b(ariables],)32 b(page)f(74\).)p eop end %%Page: 70 76 TeXDict begin 70 75 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(70)1110 299 y(ignored)37 -b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g(completions.)62 -b(See)37 b(Section)h(5.2)1110 408 y([Bash)24 b(V)-8 b(ariables],)27 -b(page)e(74,)h(for)d(a)h(description)g(of)g Ft(FIGNORE)p -Fu(.)37 b(This)22 b(option)1110 518 y(is)30 b(enabled)h(b)m(y)f -(default.)630 701 y Ft(globasciiranges)1110 810 y Fu(If)j(set,)h(range) -f(expressions)g(used)f(in)h(pattern)g(matc)m(hing)h(brac)m(k)m(et)h -(expres-)1110 920 y(sions)28 b(\(see)h(Section)h(3.5.8.1)g([P)m(attern) -g(Matc)m(hing],)h(page)e(33\))g(b)s(eha)m(v)m(e)g(as)g(if)1110 -1029 y(in)i(the)g(traditional)i(C)d(lo)s(cale)j(when)d(p)s(erforming)g -(comparisons.)44 b(That)31 b(is,)1110 1139 y(the)d(curren)m(t)g(lo)s -(cale's)i(collating)h(sequence)d(is)h(not)f(tak)m(en)h(in)m(to)g -(accoun)m(t,)i(so)1110 1249 y(`)p Ft(b)p Fu(')j(will)g(not)g(collate)i -(b)s(et)m(w)m(een)e(`)p Ft(A)p Fu(')g(and)f(`)p Ft(B)p -Fu(',)h(and)f(upp)s(er-case)g(and)g(lo)m(w)m(er-)1110 -1358 y(case)e(ASCI)s(I)e(c)m(haracters)j(will)f(collate)i(together.)630 -1541 y Ft(globstar)96 b Fu(If)38 b(set,)j(the)e(pattern)f(`)p -Ft(**)p Fu(')h(used)e(in)i(a)f(\014lename)h(expansion)f(con)m(text)j -(will)1110 1650 y(matc)m(h)36 b(all)g(\014les)f(and)f(zero)i(or)f(more) -g(directories)h(and)e(sub)s(directories.)54 b(If)1110 -1760 y(the)30 b(pattern)g(is)g(follo)m(w)m(ed)i(b)m(y)d(a)i(`)p +b(Shell)30 b(Builtin)h(Commands)2069 b(70)1159 299 y(5.)61 +b(F)-8 b(unction)57 b(tracing)g(is)g(enabled:)93 b(command)56 +b(substitution,)63 b(shell)1290 408 y(functions,)32 b(and)e(subshells)h +(in)m(v)m(ok)m(ed)i(with)e Ft(\()f Fj(command)e Ft(\))j +Fu(inherit)h(the)1290 518 y Ft(DEBUG)d Fu(and)h Ft(RETURN)e +Fu(traps.)1159 649 y(6.)61 b(Error)41 b(tracing)i(is)f(enabled:)63 +b(command)42 b(substitution,)i(shell)f(func-)1290 758 +y(tions,)32 b(and)e(subshells)g(in)m(v)m(ok)m(ed)i(with)e +Ft(\()g Fj(command)f Ft(\))h Fu(inherit)h(the)g Ft(ERR)1290 +868 y Fu(trap.)630 1019 y Ft(extglob)144 b Fu(If)26 b(set,)i(the)f +(extended)f(pattern)h(matc)m(hing)g(features)g(describ)s(ed)e(ab)s(o)m +(v)m(e)j(\(see)1110 1129 y(Section)j(3.5.8.1)i([P)m(attern)f(Matc)m +(hing],)g(page)f(33\))h(are)f(enabled.)630 1280 y Ft(extquote)96 +b Fu(If)51 b(set,)58 b Ft($')p Fj(string)p Ft(')49 b +Fu(and)i Ft($")p Fj(string)p Ft(")e Fu(quoting)k(is)e(p)s(erformed)f +(within)1110 1390 y Ft(${)p Fj(parameter)p Ft(})31 b +Fu(expansions)k(enclosed)g(in)g(double)f(quotes.)55 b(This)33 +b(option)1110 1499 y(is)d(enabled)h(b)m(y)f(default.)630 +1650 y Ft(failglob)96 b Fu(If)36 b(set,)j(patterns)d(whic)m(h)g(fail)h +(to)h(matc)m(h)f(\014lenames)f(during)g(\014lename)g(ex-)1110 +1760 y(pansion)30 b(result)g(in)g(an)g(expansion)h(error.)630 +1911 y Ft(force_fignore)1110 2021 y Fu(If)43 b(set,)k(the)d(su\016xes)f +(sp)s(eci\014ed)f(b)m(y)i(the)f Ft(FIGNORE)f Fu(shell)h(v)-5 +b(ariable)44 b(cause)1110 2131 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h +(when)f(p)s(erforming)f(w)m(ord)h(completion)i(ev)m(en)f(if)g(the)1110 +2240 y(ignored)37 b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g +(completions.)62 b(See)37 b(Section)h(5.2)1110 2350 y([Bash)24 +b(V)-8 b(ariables],)27 b(page)e(74,)h(for)d(a)h(description)g(of)g +Ft(FIGNORE)p Fu(.)37 b(This)22 b(option)1110 2459 y(is)30 +b(enabled)h(b)m(y)f(default.)630 2611 y Ft(globasciiranges)1110 +2720 y Fu(If)j(set,)h(range)f(expressions)g(used)f(in)h(pattern)g(matc) +m(hing)h(brac)m(k)m(et)h(expres-)1110 2830 y(sions)28 +b(\(see)h(Section)h(3.5.8.1)g([P)m(attern)g(Matc)m(hing],)h(page)e +(33\))g(b)s(eha)m(v)m(e)g(as)g(if)1110 2939 y(in)i(the)g(traditional)i +(C)d(lo)s(cale)j(when)d(p)s(erforming)g(comparisons.)44 +b(That)31 b(is,)1110 3049 y(the)d(curren)m(t)g(lo)s(cale's)i(collating) +h(sequence)d(is)h(not)f(tak)m(en)h(in)m(to)g(accoun)m(t,)i(so)1110 +3159 y(`)p Ft(b)p Fu(')j(will)g(not)g(collate)i(b)s(et)m(w)m(een)e(`)p +Ft(A)p Fu(')g(and)f(`)p Ft(B)p Fu(',)h(and)f(upp)s(er-case)g(and)g(lo)m +(w)m(er-)1110 3268 y(case)e(ASCI)s(I)e(c)m(haracters)j(will)f(collate)i +(together.)630 3420 y Ft(globstar)96 b Fu(If)38 b(set,)j(the)e(pattern) +f(`)p Ft(**)p Fu(')h(used)e(in)i(a)f(\014lename)h(expansion)f(con)m +(text)j(will)1110 3529 y(matc)m(h)36 b(all)g(\014les)f(and)f(zero)i(or) +f(more)g(directories)h(and)e(sub)s(directories.)54 b(If)1110 +3639 y(the)30 b(pattern)g(is)g(follo)m(w)m(ed)i(b)m(y)d(a)i(`)p Ft(/)p Fu(',)f(only)g(directories)h(and)f(sub)s(directories)1110 -1870 y(matc)m(h.)630 2052 y Ft(gnu_errfmt)1110 2162 y +3748 y(matc)m(h.)630 3900 y Ft(gnu_errfmt)1110 4009 y Fu(If)35 b(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)h(the)g -(standard)f Fm(gnu)g Fu(error)1110 2271 y(message)c(format.)630 -2454 y Ft(histappend)1110 2564 y Fu(If)c(set,)j(the)e(history)g(list)g +(standard)f Fm(gnu)g Fu(error)1110 4119 y(message)c(format.)630 +4270 y Ft(histappend)1110 4380 y Fu(If)c(set,)j(the)e(history)g(list)g (is)g(app)s(ended)e(to)j(the)f(\014le)g(named)f(b)m(y)h(the)g(v)-5 -b(alue)29 b(of)1110 2673 y(the)d Ft(HISTFILE)d Fu(v)-5 +b(alue)29 b(of)1110 4489 y(the)d Ft(HISTFILE)d Fu(v)-5 b(ariable)26 b(when)e(the)h(shell)h(exits,)h(rather)e(than)h(o)m(v)m -(erwriting)1110 2783 y(the)31 b(\014le.)630 2966 y Ft(histreedit)1110 -3075 y Fu(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g +(erwriting)1110 4599 y(the)31 b(\014le.)630 4750 y Ft(histreedit)1110 +4860 y Fu(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g (user)g(is)g(giv)m(en)h(the)g(opp)s(ortunit)m(y)1110 -3185 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630 -3367 y Ft(histverify)1110 3477 y Fu(If)35 b(set,)i(and)e(Readline)h(is) +4969 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630 +5121 y Ft(histverify)1110 5230 y Fu(If)35 b(set,)i(and)e(Readline)h(is) f(b)s(eing)g(used,)h(the)f(results)g(of)g(history)h(substitu-)1110 -3587 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g -(parser.)59 b(Instead,)38 b(the)1110 3696 y(resulting)i(line)f(is)h -(loaded)g(in)m(to)g(the)g(Readline)g(editing)g(bu\013er,)h(allo)m(wing) -1110 3806 y(further)29 b(mo)s(di\014cation.)630 3988 -y Ft(hostcomplete)1110 4098 y Fu(If)38 b(set,)j(and)c(Readline)i(is)f -(b)s(eing)g(used,)h(Bash)g(will)f(attempt)h(to)g(p)s(erform)1110 -4208 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f -(`)p Ft(@)p Fu(')g(is)g(b)s(eing)f(com-)1110 4317 y(pleted)g(\(see)h -(Section)f(8.4.6)i([Commands)d(F)-8 b(or)36 b(Completion],)g(page)g -(130\).)1110 4427 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.) -630 4609 y Ft(huponexit)1110 4719 y Fu(If)i(set,)i(Bash)f(will)h(send)d -Ft(SIGHUP)h Fu(to)h(all)h(jobs)e(when)g(an)g(in)m(teractiv)m(e)k(login) -1110 4829 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g -(page)f(41\).)630 5011 y Ft(inherit_errexit)1110 5121 -y Fu(If)e(set,)h(command)g(substitution)f(inherits)g(the)g(v)-5 -b(alue)30 b(of)g(the)f Ft(errexit)f Fu(op-)1110 5230 -y(tion,)33 b(instead)g(of)f(unsetting)g(it)h(in)f(the)g(subshell)f(en)m -(vironmen)m(t.)46 b(This)32 b(op-)1110 5340 y(tion)f(is)f(enabled)h -(when)e Fm(posix)h Fu(mo)s(de)g(is)g(enabled.)p eop end +5340 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g +(parser.)59 b(Instead,)38 b(the)p eop end %%Page: 71 77 TeXDict begin 71 76 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft -(interactive_comments)1110 408 y Fu(Allo)m(w)27 b(a)g(w)m(ord)e(b)s +b(Shell)30 b(Builtin)h(Commands)2069 b(71)1110 299 y(resulting)40 +b(line)f(is)h(loaded)g(in)m(to)g(the)g(Readline)g(editing)g(bu\013er,)h +(allo)m(wing)1110 408 y(further)29 b(mo)s(di\014cation.)630 +558 y Ft(hostcomplete)1110 667 y Fu(If)38 b(set,)j(and)c(Readline)i(is) +f(b)s(eing)g(used,)h(Bash)g(will)f(attempt)h(to)g(p)s(erform)1110 +777 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f +(`)p Ft(@)p Fu(')g(is)g(b)s(eing)f(com-)1110 887 y(pleted)g(\(see)h +(Section)f(8.4.6)i([Commands)d(F)-8 b(or)36 b(Completion],)g(page)g +(130\).)1110 996 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.) +630 1146 y Ft(huponexit)1110 1255 y Fu(If)i(set,)i(Bash)f(will)h(send)d +Ft(SIGHUP)h Fu(to)h(all)h(jobs)e(when)g(an)g(in)m(teractiv)m(e)k(login) +1110 1365 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g +(page)f(41\).)630 1514 y Ft(inherit_errexit)1110 1624 +y Fu(If)e(set,)h(command)g(substitution)f(inherits)g(the)g(v)-5 +b(alue)30 b(of)g(the)f Ft(errexit)f Fu(op-)1110 1733 +y(tion,)33 b(instead)g(of)f(unsetting)g(it)h(in)f(the)g(subshell)f(en)m +(vironmen)m(t.)46 b(This)32 b(op-)1110 1843 y(tion)f(is)f(enabled)h +(when)e Fm(posix)h Fu(mo)s(de)g(is)g(enabled.)630 1993 +y Ft(interactive_comments)1110 2102 y Fu(Allo)m(w)d(a)g(w)m(ord)e(b)s (eginning)g(with)h(`)p Ft(#)p Fu(')g(to)h(cause)f(that)h(w)m(ord)f(and) -f(all)i(remain-)1110 518 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g +f(all)i(remain-)1110 2212 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g (to)g(b)s(e)f(ignored)g(in)g(an)g(in)m(teractiv)m(e)j(shell.)1110 -628 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 -777 y Ft(lastpipe)96 b Fu(If)24 b(set,)i(and)e(job)g(con)m(trol)i(is)f +2321 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 +2471 y Ft(lastpipe)96 b Fu(If)24 b(set,)i(and)e(job)g(con)m(trol)i(is)f (not)f(activ)m(e,)k(the)d(shell)f(runs)f(the)i(last)g(command)1110 -887 y(of)37 b(a)h(pip)s(eline)e(not)h(executed)h(in)f(the)g(bac)m -(kground)g(in)g(the)g(curren)m(t)g(shell)1110 996 y(en)m(vironmen)m(t.) -630 1146 y Ft(lithist)144 b Fu(If)22 b(enabled,)i(and)d(the)h +2580 y(of)37 b(a)h(pip)s(eline)e(not)h(executed)h(in)f(the)g(bac)m +(kground)g(in)g(the)g(curren)m(t)g(shell)1110 2690 y(en)m(vironmen)m +(t.)630 2839 y Ft(lithist)144 b Fu(If)22 b(enabled,)i(and)d(the)h Ft(cmdhist)e Fu(option)j(is)f(enabled,)i(m)m(ulti-line)f(commands)1110 -1255 y(are)28 b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s -(edded)g(newlines)h(rather)g(than)f(using)1110 1365 y(semicolon)32 -b(separators)f(where)e(p)s(ossible.)630 1514 y Ft(localvar_inherit)1110 -1624 y Fu(If)j(set,)h(lo)s(cal)g(v)-5 b(ariables)33 b(inherit)f(the)g +2949 y(are)28 b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s +(edded)g(newlines)h(rather)g(than)f(using)1110 3059 y(semicolon)32 +b(separators)f(where)e(p)s(ossible.)630 3208 y Ft(localvar_inherit)1110 +3318 y Fu(If)j(set,)h(lo)s(cal)g(v)-5 b(ariables)33 b(inherit)f(the)g (v)-5 b(alue)32 b(and)g(attributes)h(of)f(a)g(v)-5 b(ariable)1110 -1733 y(of)36 b(the)g(same)g(name)g(that)h(exists)f(at)h(a)f(previous)g -(scop)s(e)g(b)s(efore)f(an)m(y)h(new)1110 1843 y(v)-5 +3427 y(of)36 b(the)g(same)g(name)g(that)h(exists)f(at)h(a)f(previous)g +(scop)s(e)g(b)s(efore)f(an)m(y)h(new)1110 3537 y(v)-5 b(alue)31 b(is)f(assigned.)41 b(The)30 b Fr(nameref)48 -b Fu(attribute)31 b(is)f(not)h(inherited.)630 1993 y -Ft(localvar_unset)1110 2102 y Fu(If)i(set,)i(calling)g +b Fu(attribute)31 b(is)f(not)h(inherited.)630 3686 y +Ft(localvar_unset)1110 3796 y Fu(If)i(set,)i(calling)g Ft(unset)d Fu(on)i(lo)s(cal)g(v)-5 b(ariables)35 b(in)e(previous)g -(function)g(scop)s(es)1110 2212 y(marks)26 b(them)g(so)g(subsequen)m(t) +(function)g(scop)s(es)1110 3905 y(marks)26 b(them)g(so)g(subsequen)m(t) g(lo)s(okups)f(\014nd)g(them)h(unset)f(un)m(til)i(that)g(func-)1110 -2321 y(tion)40 b(returns.)68 b(This)39 b(is)g(iden)m(tical)j(to)e(the)g -(b)s(eha)m(vior)g(of)g(unsetting)g(lo)s(cal)1110 2431 +4015 y(tion)40 b(returns.)68 b(This)39 b(is)g(iden)m(tical)j(to)e(the)g +(b)s(eha)m(vior)g(of)g(unsetting)g(lo)s(cal)1110 4125 y(v)-5 b(ariables)31 b(at)g(the)g(curren)m(t)f(function)g(scop)s(e.)630 -2580 y Ft(login_shell)1110 2690 y Fu(The)35 b(shell)h(sets)g(this)f +4274 y Ft(login_shell)1110 4384 y Fu(The)35 b(shell)h(sets)g(this)f (option)h(if)g(it)g(is)f(started)h(as)g(a)g(login)g(shell)g(\(see)g -(Sec-)1110 2800 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g +(Sec-)1110 4493 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g (86\).)41 b(The)28 b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m -(hanged.)630 2949 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h +(hanged.)630 4643 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h (\014le)g(that)g(Bash)f(is)h(c)m(hec)m(king)h(for)f(mail)g(has)f(b)s -(een)g(accessed)1110 3059 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as) +(een)g(accessed)1110 4752 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as) f(c)m(hec)m(k)m(ed,)k(the)c(message)h Ft("The)k(mail)h(in)f -Fj(mail-)1110 3168 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y) -m(ed.)630 3318 y Ft(no_empty_cmd_completion)1110 3427 +Fj(mail-)1110 4862 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y) +m(ed.)630 5011 y Ft(no_empty_cmd_completion)1110 5121 y Fu(If)g(set,)g(and)g(Readline)g(is)h(b)s(eing)e(used,)h(Bash)g(will)g -(not)g(attempt)i(to)e(searc)m(h)1110 3537 y(the)25 b +(not)g(attempt)i(to)e(searc)m(h)1110 5230 y(the)25 b Ft(PATH)f Fu(for)h(p)s(ossible)f(completions)j(when)d(completion)i(is)f -(attempted)h(on)1110 3646 y(an)k(empt)m(y)h(line.)630 -3796 y Ft(nocaseglob)1110 3905 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g -(\014lenames)g(in)f(a)h(case-insensitiv)m(e)j(fashion)c(when)1110 -4015 y(p)s(erforming)29 b(\014lename)i(expansion.)630 -4164 y Ft(nocasematch)1110 4274 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g -(patterns)g(in)f(a)h(case-insensitiv)m(e)i(fashion)d(when)1110 -4384 y(p)s(erforming)31 b(matc)m(hing)i(while)f(executing)i -Ft(case)d Fu(or)h Ft([[)g Fu(conditional)h(com-)1110 -4493 y(mands,)d(when)g(p)s(erforming)g(pattern)h(substitution)g(w)m -(ord)g(expansions,)g(or)1110 4603 y(when)g(\014ltering)i(p)s(ossible)f -(completions)h(as)g(part)f(of)h(programmable)f(com-)1110 -4712 y(pletion.)630 4862 y Ft(nullglob)96 b Fu(If)23 -b(set,)j(Bash)e(allo)m(ws)g(\014lename)g(patterns)g(whic)m(h)f(matc)m -(h)h(no)g(\014les)f(to)i(expand)1110 4971 y(to)31 b(a)g(n)m(ull)f -(string,)h(rather)f(than)g(themselv)m(es.)630 5121 y -Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g(completion)g -(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110 5230 -y(grammable)45 b(Completion],)k(page)c(135\))h(are)f(enabled.)82 -b(This)44 b(option)h(is)1110 5340 y(enabled)30 b(b)m(y)h(default.)p -eop end +(attempted)h(on)1110 5340 y(an)k(empt)m(y)h(line.)p eop +end %%Page: 72 78 TeXDict begin 72 77 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(72)630 299 y Ft(progcomp_alias) -1110 408 y Fu(If)23 b(set,)j(and)d(programmable)h(completion)h(is)f -(enabled,)h(Bash)f(treats)h(a)f(com-)1110 518 y(mand)34 -b(name)h(that)g(do)s(esn't)f(ha)m(v)m(e)i(an)m(y)g(completions)f(as)g -(a)g(p)s(ossible)g(alias)1110 628 y(and)40 b(attempts)i(alias)h -(expansion.)72 b(If)41 b(it)g(has)g(an)g(alias,)k(Bash)c(attempts)1110 -737 y(programmable)28 b(completion)h(using)e(the)h(command)f(w)m(ord)h -(resulting)f(from)1110 847 y(the)k(expanded)e(alias.)630 -996 y Ft(promptvars)1110 1106 y Fu(If)50 b(set,)56 b(prompt)49 -b(strings)h(undergo)g(parameter)h(expansion,)k(command)1110 -1215 y(substitution,)35 b(arithmetic)g(expansion,)g(and)e(quote)i(remo) -m(v)-5 b(al)35 b(after)f(b)s(eing)1110 1325 y(expanded)53 -b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section)f(6.9)h([Con)m -(trolling)g(the)1110 1434 y(Prompt],)30 b(page)h(98\).)42 -b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.)630 -1584 y Ft(restricted_shell)1110 1693 y Fu(The)40 b(shell)h(sets)g(this) -g(option)g(if)g(it)h(is)e(started)i(in)e(restricted)i(mo)s(de)e(\(see) -1110 1803 y(Section)32 b(6.10)h([The)d(Restricted)j(Shell],)e(page)h -(100\).)45 b(The)30 b(v)-5 b(alue)32 b(ma)m(y)g(not)1110 -1913 y(b)s(e)g(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f -(the)h(startup)g(\014les)f(are)i(executed,)1110 2022 -y(allo)m(wing)k(the)e(startup)f(\014les)h(to)g(disco)m(v)m(er)h -(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 2132 -y(stricted.)630 2281 y Ft(shift_verbose)1110 2391 y Fu(If)g(this)g(is)g -(set,)j(the)d Ft(shift)f Fu(builtin)h(prin)m(ts)f(an)h(error)g(message) -i(when)d(the)1110 2500 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m -(b)s(er)e(of)h(p)s(ositional)i(parameters.)630 2649 y -Ft(sourcepath)1110 2759 y Fu(If)22 b(set,)j(the)e Ft(source)e -Fu(builtin)h(uses)g(the)h(v)-5 b(alue)23 b(of)g Ft(PATH)e -Fu(to)j(\014nd)d(the)h(directory)1110 2869 y(con)m(taining)29 -b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m(t.)40 -b(This)27 b(option)h(is)f(enabled)1110 2978 y(b)m(y)j(default.)630 -3127 y Ft(xpg_echo)96 b Fu(If)31 b(set,)h(the)g Ft(echo)e +b(Shell)30 b(Builtin)h(Commands)2069 b(72)630 299 y Ft(nocaseglob)1110 +408 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h +(case-insensitiv)m(e)j(fashion)c(when)1110 518 y(p)s(erforming)29 +b(\014lename)i(expansion.)630 670 y Ft(nocasematch)1110 +779 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h +(case-insensitiv)m(e)i(fashion)d(when)1110 889 y(p)s(erforming)31 +b(matc)m(hing)i(while)f(executing)i Ft(case)d Fu(or)h +Ft([[)g Fu(conditional)h(com-)1110 998 y(mands,)d(when)g(p)s(erforming) +g(pattern)h(substitution)g(w)m(ord)g(expansions,)g(or)1110 +1108 y(when)g(\014ltering)i(p)s(ossible)f(completions)h(as)g(part)f(of) +h(programmable)f(com-)1110 1218 y(pletion.)630 1369 y +Ft(nullglob)96 b Fu(If)23 b(set,)j(Bash)e(allo)m(ws)g(\014lename)g +(patterns)g(whic)m(h)f(matc)m(h)h(no)g(\014les)f(to)i(expand)1110 +1479 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.) +630 1631 y Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g +(completion)g(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110 +1740 y(grammable)45 b(Completion],)k(page)c(135\))h(are)f(enabled.)82 +b(This)44 b(option)h(is)1110 1850 y(enabled)30 b(b)m(y)h(default.)630 +2001 y Ft(progcomp_alias)1110 2111 y Fu(If)23 b(set,)j(and)d +(programmable)h(completion)h(is)f(enabled,)h(Bash)f(treats)h(a)f(com-) +1110 2221 y(mand)34 b(name)h(that)g(do)s(esn't)f(ha)m(v)m(e)i(an)m(y)g +(completions)f(as)g(a)g(p)s(ossible)g(alias)1110 2330 +y(and)40 b(attempts)i(alias)h(expansion.)72 b(If)41 b(it)g(has)g(an)g +(alias,)k(Bash)c(attempts)1110 2440 y(programmable)28 +b(completion)h(using)e(the)h(command)f(w)m(ord)h(resulting)f(from)1110 +2549 y(the)k(expanded)e(alias.)630 2701 y Ft(promptvars)1110 +2811 y Fu(If)50 b(set,)56 b(prompt)49 b(strings)h(undergo)g(parameter)h +(expansion,)k(command)1110 2920 y(substitution,)35 b(arithmetic)g +(expansion,)g(and)e(quote)i(remo)m(v)-5 b(al)35 b(after)f(b)s(eing)1110 +3030 y(expanded)53 b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section) +f(6.9)h([Con)m(trolling)g(the)1110 3139 y(Prompt],)30 +b(page)h(98\).)42 b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.) +630 3291 y Ft(restricted_shell)1110 3401 y Fu(The)40 +b(shell)h(sets)g(this)g(option)g(if)g(it)h(is)e(started)i(in)e +(restricted)i(mo)s(de)e(\(see)1110 3510 y(Section)32 +b(6.10)h([The)d(Restricted)j(Shell],)e(page)h(100\).)45 +b(The)30 b(v)-5 b(alue)32 b(ma)m(y)g(not)1110 3620 y(b)s(e)g(c)m +(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f(the)h(startup)g +(\014les)f(are)i(executed,)1110 3729 y(allo)m(wing)k(the)e(startup)f +(\014les)h(to)g(disco)m(v)m(er)h(whether)f(or)f(not)i(a)f(shell)g(is)g +(re-)1110 3839 y(stricted.)630 3991 y Ft(shift_verbose)1110 +4100 y Fu(If)g(this)g(is)g(set,)j(the)d Ft(shift)f Fu(builtin)h(prin)m +(ts)f(an)h(error)g(message)i(when)d(the)1110 4210 y(shift)30 +b(coun)m(t)h(exceeds)g(the)g(n)m(um)m(b)s(er)e(of)h(p)s(ositional)i +(parameters.)630 4361 y Ft(sourcepath)1110 4471 y Fu(If)22 +b(set,)j(the)e Ft(source)e Fu(builtin)h(uses)g(the)h(v)-5 +b(alue)23 b(of)g Ft(PATH)e Fu(to)j(\014nd)d(the)h(directory)1110 +4581 y(con)m(taining)29 b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m +(t.)40 b(This)27 b(option)h(is)f(enabled)1110 4690 y(b)m(y)j(default.) +630 4842 y Ft(xpg_echo)96 b Fu(If)31 b(set,)h(the)g Ft(echo)e Fu(builtin)h(expands)f(bac)m(kslash-escap)s(e)j(sequences)f(b)m(y)f -(de-)1110 3237 y(fault.)630 3386 y(The)c(return)f(status)i(when)f +(de-)1110 4951 y(fault.)630 5103 y(The)c(return)f(status)i(when)f (listing)h(options)g(is)f(zero)i(if)e(all)i Fr(optnames)i -Fu(are)d(enabled,)g(non-)630 3496 y(zero)40 b(otherwise.)66 +Fu(are)d(enabled,)g(non-)630 5213 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f -(status)h(is)g(zero)630 3606 y(unless)30 b(an)g Fr(optname)36 -b Fu(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)150 -3836 y Fs(4.4)68 b(Sp)t(ecial)45 b(Builtins)150 3996 -y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e Fm(posix)g -Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e(commands)g -(as)h Fl(sp)-5 b(e-)150 4105 y(cial)p Fu(.)47 b(When)33 -b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g(sp)s -(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150 -4215 y(commands)e(in)g(three)h(resp)s(ects:)199 4344 -y(1.)61 b(Sp)s(ecial)31 b(builtins)e(are)i(found)e(b)s(efore)h(shell)h -(functions)f(during)f(command)h(lo)s(okup.)199 4474 y(2.)61 -b(If)30 b(a)h(sp)s(ecial)g(builtin)f(returns)f(an)h(error)g(status,)h -(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 4603 -y(3.)61 b(Assignmen)m(t)30 b(statemen)m(ts)h(preceding)f(the)f(command) -g(sta)m(y)i(in)e(e\013ect)i(in)e(the)h(shell)f(en)m(vironmen)m(t)330 -4713 y(after)i(the)f(command)h(completes.)275 4862 y(When)36 -b(Bash)g(is)h(not)f(executing)i(in)e Fm(posix)f Fu(mo)s(de,)j(these)f -(builtins)f(b)s(eha)m(v)m(e)h(no)f(di\013eren)m(tly)h(than)150 -4972 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41 -b(The)30 b(Bash)g Fm(posix)g Fu(mo)s(de)g(is)g(describ)s(ed)f(in)h -(Section)h(6.11)150 5081 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(100.)275 -5211 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390 -5340 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f -(readonly)f(return)h(set)p eop end +(status)h(is)g(zero)630 5322 y(unless)30 b(an)g Fr(optname)36 +b Fu(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)p +eop end %%Page: 73 79 TeXDict begin 73 78 bop 150 -116 a Fu(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(73)390 299 y Ft(shift)46 -b(trap)h(unset)p eop end +b(Shell)30 b(Builtin)h(Commands)2069 b(73)150 299 y Fs(4.4)68 +b(Sp)t(ecial)45 b(Builtins)150 458 y Fu(F)-8 b(or)35 +b(historical)h(reasons,)g(the)e Fm(posix)g Fu(standard)f(has)i +(classi\014ed)f(sev)m(eral)i(builtin)e(commands)g(as)h +Fl(sp)-5 b(e-)150 568 y(cial)p Fu(.)47 b(When)33 b(Bash)f(is)h +(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g(sp)s(ecial)g(builtins) +e(di\013er)i(from)f(other)g(builtin)150 677 y(commands)e(in)g(three)h +(resp)s(ects:)199 812 y(1.)61 b(Sp)s(ecial)31 b(builtins)e(are)i(found) +e(b)s(efore)h(shell)h(functions)f(during)f(command)h(lo)s(okup.)199 +946 y(2.)61 b(If)30 b(a)h(sp)s(ecial)g(builtin)f(returns)f(an)h(error)g +(status,)h(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 +1081 y(3.)61 b(Assignmen)m(t)30 b(statemen)m(ts)h(preceding)f(the)f +(command)g(sta)m(y)i(in)e(e\013ect)i(in)e(the)h(shell)f(en)m(vironmen)m +(t)330 1191 y(after)i(the)f(command)h(completes.)275 +1350 y(When)36 b(Bash)g(is)h(not)f(executing)i(in)e Fm(posix)f +Fu(mo)s(de,)j(these)f(builtins)f(b)s(eha)m(v)m(e)h(no)f(di\013eren)m +(tly)h(than)150 1460 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e +(commands.)41 b(The)30 b(Bash)g Fm(posix)g Fu(mo)s(de)g(is)g(describ)s +(ed)f(in)h(Section)h(6.11)150 1569 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g +(100.)275 1704 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h +(builtins:)390 1838 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h +(exit)g(export)f(readonly)f(return)h(set)390 1948 y(shift)g(trap)h +(unset)p eop end %%Page: 74 80 TeXDict begin 74 79 bop 3659 -116 a Fu(74)150 299 y Fp(5)80 b(Shell)53 b(V)-13 b(ariables)150 504 y Fu(This)21 b(c)m(hapter)i @@ -18398,10 +18389,10 @@ e Ft(vi)f Fu(if)h(neither)g(is)g(set.)66 b(When)39 b(editing)g(is)g (complete,)k(the)630 2086 y(edited)31 b(commands)f(are)g(ec)m(ho)s(ed)h (and)f(executed.)630 2212 y(In)k(the)g(second)g(form,)h Fr(command)j Fu(is)c(re-executed)i(after)f(eac)m(h)g(instance)g(of)f -Fr(pat)j Fu(in)d(the)630 2322 y(selected)e(command)e(is)h(replaced)g(b) -m(y)f Fr(rep)p Fu(.)41 b Fr(command)34 b Fu(is)c(in)m(tepreted)h(the)g -(same)g(as)g Fr(\014rst)630 2432 y Fu(ab)s(o)m(v)m(e.)630 -2558 y(A)g(useful)f(alias)i(to)g(use)e(with)h(the)g Ft(fc)f +Fr(pat)j Fu(in)d(the)630 2322 y(selected)29 b(command)e(is)h(replaced)f +(b)m(y)h Fr(rep)p Fu(.)39 b Fr(command)31 b Fu(is)c(in)m(terpreted)h +(the)f(same)h(as)g Fr(\014rst)630 2432 y Fu(ab)s(o)m(v)m(e.)630 +2558 y(A)j(useful)f(alias)i(to)g(use)e(with)h(the)g Ft(fc)f Fu(command)h(is)g Ft(r='fc)e(-s')p Fu(,)h(so)h(that)h(t)m(yping)f(`)p Ft(r)f(cc)p Fu(')630 2668 y(runs)35 b(the)h(last)h(command)f(b)s (eginning)g(with)g Ft(cc)f Fu(and)h(t)m(yping)g(`)p Ft(r)p @@ -20478,7 +20469,7 @@ g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g g(:)g(:)h(:)f(:)28 b Fb(56)2025 2760 y Fe(local)9 b Fc(:)14 b(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)g(:)23 b Fb(56)2025 2848 y Fe(logout)6 +g(:)g(:)g(:)h(:)f(:)g(:)23 b Fb(57)2025 2848 y Fe(logout)6 b Fc(:)14 b(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(57)2021 3110 y Fs(M)2025 @@ -20546,7 +20537,7 @@ g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h b Fb(60)146 1003 y Fs(U)150 1119 y Fe(ulimit)6 b Fc(:)15 b(:)e(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)20 b Fb(60)150 1206 y Fe(umask)9 +g(:)g(:)g(:)h(:)f(:)20 b Fb(61)150 1206 y Fe(umask)9 b Fc(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)23 b Fb(51)150 1293 y @@ -21671,7 +21662,7 @@ b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)21 b Fb(41)2025 1077 y(sp)r(ecial)27 b(builtin)16 b Fc(:)d(:)g(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)31 b Fb(4,)26 b(72)2025 +g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)31 b Fb(4,)26 b(73)2025 1170 y(startup)f(\014les)10 b Fc(:)k(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)25 b Fb(88)2025 1257 diff --git a/doc/bashref.toc b/doc/bashref.toc index 883c755d..27cbee83 100644 --- a/doc/bashref.toc +++ b/doc/bashref.toc @@ -62,7 +62,7 @@ @numsecentry{Modifying Shell Behavior}{4.3}{Modifying Shell Behavior}{62} @numsubsecentry{The Set Builtin}{4.3.1}{The Set Builtin}{62} @numsubsecentry{The Shopt Builtin}{4.3.2}{The Shopt Builtin}{66} -@numsecentry{Special Builtins}{4.4}{Special Builtins}{72} +@numsecentry{Special Builtins}{4.4}{Special Builtins}{73} @numchapentry{Shell Variables}{5}{Shell Variables}{74} @numsecentry{Bourne Shell Variables}{5.1}{Bourne Shell Variables}{74} @numsecentry{Bash Variables}{5.2}{Bash Variables}{74} diff --git a/doc/builtins.0 b/doc/builtins.0 index 67b5bbf8..c3d01fc6 100644 --- a/doc/builtins.0 +++ b/doc/builtins.0 @@ -1823,8 +1823,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS _n_a_m_e will be unset rather than the variable it references. --nn has no effect if the --ff option is supplied. If no options are supplied, each _n_a_m_e refers to a variable; if there is no vari- - able by that name, any function with that name is unset. Each - unset variable or function is removed from the environment + able by that name, a function with that name, if any, is unset. + Each unset variable or function is removed from the environment passed to subsequent commands. If any of BBAASSHH__AALLIIAASSEESS, BBAASSHH__AARRGGVV00, BBAASSHH__CCMMDDSS, BBAASSHH__CCOOMMMMAANNDD, BBAASSHH__SSUUBBSSHHEELLLL, BBAASSHHPPIIDD, CCOOMMPP__WWOORRDDBBRREEAAKKSS, DDIIRRSSTTAACCKK, EEPPOOCCHHRREEAALLTTIIMMEE, EEPPOOCCHHSSEECCOONNDDSS, FFUUNNCC-- diff --git a/doc/builtins.ps b/doc/builtins.ps index 9be699f1..9d0e0f8b 100644 --- a/doc/builtins.ps +++ b/doc/builtins.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Tue Nov 26 11:15:40 2019 +%%CreationDate: Mon Jan 6 08:53:35 2020 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -3085,38 +3085,37 @@ F0 .404(option is supplied, and)2.904 F F2(name)2.904 E F0 .404(is a v) (attrib)2.904 E(ute,)-.2 E F2(name)2.904 E F0 .403(will be unset)2.904 F .719(rather than the v)144 415.2 R .719(ariable it references.)-.25 F F1 5.719 E F0 .719(has no ef)3.219 F .719(fect if the)-.25 F F1 -3.22 E F0 .72(option is supplied.)3.22 F .72(If no options)5.72 F .19 -(are supplied, each)144 427.2 R F2(name)2.69 E F0 .19(refers to a v)2.69 -F .189(ariable; if there is no v)-.25 F .189(ariable by that name, an) --.25 F 2.689(yf)-.15 G .189(unction with)-2.689 F 1.115 -(that name is unset.)144 439.2 R 1.115(Each unset v)6.115 F 1.115 -(ariable or function is remo)-.25 F -.15(ve)-.15 G 3.616(df).15 G 1.116 -(rom the en)-3.616 F 1.116(vironment passed to)-.4 F 1.501 -(subsequent commands.)144 451.2 R 1.501(If an)6.501 F 4.001(yo)-.15 G(f) --4.001 E/F3 9/Times-Bold@0 SF -.27(BA)4.001 G(SH_ALIASES).27 E/F4 9 -/Times-Roman@0 SF(,)A F3 -.27(BA)3.751 G(SH_ARGV0).27 E F4(,)A F3 -.27 -(BA)3.75 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)3.75 G(SH_COM-).27 E(MAND)144 -463.2 Q F4(,)A F3 -.27(BA)2.845 G(SH_SUBSHELL).27 E F4(,)A F3 -.27(BA) -2.846 G(SHPID).27 E F4(,)A F3(COMP_W)2.846 E(ORDBREAKS)-.09 E F4(,)A F3 -(DIRST)2.846 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL)2.846 E -(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)144 475.2 Q F4(,)A F3(FUNCN)6.481 E -(AME)-.18 E F4(,)A F3(GR)6.481 E(OUPS)-.27 E F4(,)A F3(HISTCMD)6.481 E -F4(,)A F3(LINENO)6.481 E F4(,)A F3(RANDOM)6.48 E F4(,)A F3(SECONDS)6.48 -E F4(,)A F0(or)6.48 E F3(SRANDOM)144 487.2 Q F0 .831(are unset, the) -3.081 F 3.332(yl)-.15 G .832(ose their special properties, e)-3.332 F --.15(ve)-.25 G 3.332(ni).15 G 3.332(ft)-3.332 G(he)-3.332 E 3.332(ya) --.15 G .832(re subsequently reset.)-3.332 F(The)5.832 E -.15(ex)144 -499.2 S(it status is true unless a).15 E F2(name)2.86 E F0(is readonly) -2.68 E(.)-.65 E F1(wait)108 516 Q F0([)2.5 E F1(\255fn)A F0 2.5(][)C F1 --2.5 E F2(varname)2.5 E F0 2.5(][)C F2(id ...)-2.5 E F0(])A -.8 -(Wa)144 528 S .659(it for each speci\214ed child process and return its\ - termination status.).8 F(Each)5.659 E F2(id)3.169 E F0 .658 -(may be a process)3.928 F .008 -(ID or a job speci\214cation; if a job spec is gi)144 540 R -.15(ve)-.25 -G .009(n, all processes in that job').15 F 2.509(sp)-.55 G .009 -(ipeline are w)-2.509 F .009(aited for)-.1 F 5.009(.I)-.55 G(f)-5.009 E -F2(id)144.01 552 Q F0 .442(is not gi)3.712 F -.15(ve)-.25 G(n,).15 E F1 -(wait)2.942 E F0 -.1(wa)2.942 G .441 +3.22 E F0 .72(option is supplied.)3.22 F .72(If no options)5.72 F .737 +(are supplied, each)144 427.2 R F2(name)3.237 E F0 .737(refers to a v) +3.237 F .737(ariable; if there is no v)-.25 F .736 +(ariable by that name, a function with)-.25 F 1.761(that name, if an)144 +439.2 R 3.061 -.65(y, i)-.15 H 4.261(su).65 G 4.261(nset. Each)-4.261 F +1.761(unset v)4.261 F 1.761(ariable or function is remo)-.25 F -.15(ve) +-.15 G 4.262(df).15 G 1.762(rom the en)-4.262 F(vironment)-.4 E 3.172 +(passed to subsequent commands.)144 451.2 R 3.172(If an)8.172 F 5.672 +(yo)-.15 G(f)-5.672 E/F3 9/Times-Bold@0 SF -.27(BA)5.672 G(SH_ALIASES) +.27 E/F4 9/Times-Roman@0 SF(,)A F3 -.27(BA)5.421 G(SH_ARGV0).27 E F4(,)A +F3 -.27(BA)5.421 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)144 463.2 S +(SH_COMMAND).27 E F4(,)A F3 -.27(BA)11.481 G(SH_SUBSHELL).27 E F4(,)A F3 +-.27(BA)11.482 G(SHPID).27 E F4(,)A F3(COMP_W)11.482 E(ORDBREAKS)-.09 E +F4(,)A F3(DIRST)11.482 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL) +144 475.2 Q(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)2.67 E F4(,)A F3(FUNCN) +2.67 E(AME)-.18 E F4(,)A F3(GR)2.67 E(OUPS)-.27 E F4(,)A F3(HISTCMD)2.67 +E F4(,)A F3(LINENO)2.67 E F4(,)A F3(RANDOM)2.67 E F4(,)A F3(SECONDS)144 +487.2 Q F4(,)A F0(or)4.029 E F3(SRANDOM)4.279 E F0 1.779(are unset, the) +4.029 F 4.279(yl)-.15 G 1.779(ose their special properties, e)-4.279 F +-.15(ve)-.25 G 4.279(ni).15 G 4.28(ft)-4.279 G(he)-4.28 E 4.28(ya)-.15 G +1.78(re subse-)-4.28 F(quently reset.)144 499.2 Q(The e)5 E +(xit status is true unless a)-.15 E F2(name)2.86 E F0(is readonly)2.68 E +(.)-.65 E F1(wait)108 516 Q F0([)2.5 E F1(\255fn)A F0 2.5(][)C F1 +-2.5 E F2(varname)2.5 E F0 2.5(][)C F2(id ...)-2.5 E F0(])A -.8(Wa)144 +528 S .659(it for each speci\214ed child process and return its termina\ +tion status.).8 F(Each)5.659 E F2(id)3.169 E F0 .658(may be a process) +3.928 F .008(ID or a job speci\214cation; if a job spec is gi)144 540 R +-.15(ve)-.25 G .009(n, all processes in that job').15 F 2.509(sp)-.55 G +.009(ipeline are w)-2.509 F .009(aited for)-.1 F 5.009(.I)-.55 G(f) +-5.009 E F2(id)144.01 552 Q F0 .442(is not gi)3.712 F -.15(ve)-.25 G(n,) +.15 E F1(wait)2.942 E F0 -.1(wa)2.942 G .441 (its for all running background jobs and the last-e).1 F -.15(xe)-.15 G .441(cuted process substitu-).15 F .597 (tion, if its process id is the same as)144 564 R F1($!)3.098 E F0 3.098 diff --git a/doc/rbash.ps b/doc/rbash.ps index 6f0ce9ad..30507b81 100644 --- a/doc/rbash.ps +++ b/doc/rbash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Tue Nov 26 11:15:40 2019 +%%CreationDate: Mon Jan 6 08:53:35 2020 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%DocumentSuppliedResources: procset grops 1.22 4