From: Chet Ramey Date: Sat, 3 Dec 2011 17:53:59 +0000 (-0500) Subject: commit bash-20040128 snapshot X-Git-Tag: bash-3.0-beta~4 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=113d85a4ab22cc9210fb9b94f59f4c10664d1c99;p=thirdparty%2Fbash.git commit bash-20040128 snapshot --- diff --git a/CHANGES b/CHANGES index 986a30074..d8ad62c9a 100644 --- a/CHANGES +++ b/CHANGES @@ -130,6 +130,13 @@ c. New application variable, rl_completion_found_quote, set to a non-zero value if readline determines that the word to be completed is quoted. Set before readline calls any application completion function. +d. New function hook, rl_completion_word_break_hook, called when readline + needs to break a line into words when completion is attempted. Allows + the word break characters to vary based on position in the line. + +e. New bindable command: unix-filename-rubout. Does the same thing as + unix-word-rubout, but adds `/' to the set of word delimiters. + ------------------------------------------------------------------------------ This document details the changes between this version, bash-3.0-alpha, and the previous version, bash-2.05b-release. diff --git a/CWRU/CWRU.chlog b/CWRU/CWRU.chlog index a7e42b6d5..09843191e 100644 --- a/CWRU/CWRU.chlog +++ b/CWRU/CWRU.chlog @@ -9073,3 +9073,31 @@ shell.c subst.c - in string_list_internal, short-circuit right away to savestring() if the list only has a single element + + 1/28 + ---- +lib/readline/rltypedefs.h + - new set of typedefs for functions returning char * with various + arguments (standard set) + +lib/readline/complete.c + - new function pointer, rl_completion_word_break_hook, called by + _rl_find_completion_word, used to set word break characters at + completion time, allowing them to be position-based + +lib/readline/doc/rltech.texi + - documented rl_completion_word_break_hook + +lib/readline/kill.c + - added new rl_unix_filename_rubout, which deletes one filename + component in a Unix pathname backward (delimiters are whitespace + and `/') + +lib/readline/readline.h + - extern declaration for rl_unix_filename_rubout + +lib/readline/funmap.c + - new bindable readline command `unix-filename-rubout' + +lib/readline/doc/{readline.3,rluser.texi},doc/bash.1 + - documented `unix-filename-rubout' diff --git a/NEWS b/NEWS index f2c786191..37fff1a69 100644 --- a/NEWS +++ b/NEWS @@ -115,12 +115,18 @@ gg. New `set -o pipefail' option that causes a pipeline to return a failure status if any of the processes in the pipeline fail, not just the last one. -hh. printf builtin understands two new escape sequences: \" and \?. +hh. printf builtin understands two new escape sequences: \" and \?. -ii. `echo -e' understands two new escape sequences: \" and \?. +ii. `echo -e' understands two new escape sequences: \" and \?. -jj. The GNU `gettext' package and libintl have been integrated; the shell's - messages can be translated into different languages. +jj. The GNU `gettext' package and libintl have been integrated; the shell's + messages can be translated into different languages. + +kk. The `\W' prompt expansion now abbreviates $HOME as `~', like `\w'. + +ll. The error message printed when bash cannot open a shell script supplied + as argument 1 now includes the name of the shell, to better identify + the error as coming from bash. 2. New Features in Readline @@ -165,6 +171,13 @@ k. New application variable, rl_completion_found_quote, set to a non-zero value if readline determines that the word to be completed is quoted. Set before readline calls any application completion function. +l. New function hook, rl_completion_word_break_hook, called when readline + needs to break a line into words when completion is attempted. Allows + the word break characters to vary based on position in the line. + +m. New bindable command: unix-filename-rubout. Does the same thing as + unix-word-rubout, but adds `/' to the set of word delimiters. + ------------------------------------------------------------------------------- This is a terse description of the new features added to bash-2.05b since the release of bash-2.05a. As always, the manual page (doc/bash.1) is diff --git a/doc/Makefile b/doc/Makefile index 15c972610..cdc927f6b 120000 --- a/doc/Makefile +++ b/doc/Makefile @@ -1 +1 @@ -/usr/local/build/bash/bash-current/doc/Makefile \ No newline at end of file +/usr/local/build/chet/bash/bash-current/doc/Makefile \ No newline at end of file diff --git a/doc/bash.0 b/doc/bash.0 index 901d146fd..7dbe2b0d5 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -2823,6 +2823,10 @@ RREEAADDLLIINNEE uunniixx--wwoorrdd--rruubboouutt ((CC--ww)) Kill the word behind point, using white space as a word bound- ary. The killed text is saved on the kill-ring. + uunniixx--ffiilleennaammee--rruubboouutt + Kill the word behind point, using white space and the slash + character as the word boundaries. The killed text is saved on + the kill-ring. ddeelleettee--hhoorriizzoonnttaall--ssppaaccee ((MM--\\)) Delete all spaces and tabs around point. kkiillll--rreeggiioonn @@ -3269,8 +3273,8 @@ HHIISSTTOORRYY EEXXPPAANNSSIIOONN line. Any delimiter can be used in place of /. The final delimiter is optional if it is the last character of the event line. The delimiter may be quoted in _o_l_d and _n_e_w with a single - backslash. If & appears in _n_e_w, it is replaced by _o_l_d. A sin- - gle backslash will quote the &. If _o_l_d is null, it is set to + backslash. If & appears in _n_e_w, it is replaced by _o_l_d. A + single backslash will quote the &. If _o_l_d is null, it is set to the last _o_l_d substituted, or, if no previous history substitu- tions took place, the last _s_t_r_i_n_g in a !!??_s_t_r_i_n_g[[??]] search. && Repeat the previous substitution. @@ -4769,4 +4773,4 @@ BBUUGGSS -GNU Bash-3.0 2004 Jan 24 BASH(1) +GNU Bash-3.0 2004 Jan 28 BASH(1) diff --git a/doc/bash.1 b/doc/bash.1 index 6691167ce..041d27d42 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -6,12 +6,12 @@ .\" Case Western Reserve University .\" chet@po.CWRU.Edu .\" -.\" Last Change: Sat Jan 24 13:18:08 EST 2004 +.\" Last Change: Wed Jan 28 15:49:29 EST 2004 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2004 Jan 24" "GNU Bash-3.0" +.TH BASH 1 "2004 Jan 28" "GNU Bash-3.0" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -5003,6 +5003,11 @@ Word boundaries are the same as those used by \fBbackward\-word\fP. Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. .TP +.B unix\-filename\-rubout +Kill the word behind point, using white space and the slash character +as the word boundaries. +The killed text is saved on the kill-ring. +.TP .B delete\-horizontal\-space (M\-\e) Delete all spaces and tabs around point. .TP diff --git a/doc/bash.html b/doc/bash.html index e445be0cc..7f69c1bbf 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -2,7 +2,7 @@ BASH(1) Manual Page -
BASH(1)2003 Nov 13BASH(1) +BASH(1)2004 Jan 28BASH(1)

Index
@@ -40,7 +40,7 @@ bash - GNU Bourne-Again SHell

COPYRIGHT

-Bash is Copyright © 1989-2003 by the Free Software Foundation, Inc. +Bash is Copyright © 1989-2004 by the Free Software Foundation, Inc.  

DESCRIPTION

@@ -5404,11 +5404,12 @@ the release of bash, version + patchelvel (e.g., 2.00.0)
\w
-the current working directory +the current working directory, with $HOME abbreviated with a tilde
\W
-the basename of the current working directory +the basename of the current working directory, with $HOME +abbreviated with a tilde
\!
@@ -6514,6 +6515,12 @@ Word boundaries are the same as those used by backward-word.
Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. +
unix-filename-rubout + +
+Kill the word behind point, using white space and the slash character +as the word boundaries. +The killed text is saved on the kill-ring.
delete-horizontal-space (M-\)
@@ -11334,6 +11341,6 @@ Array variables may not (yet) be exported.
This document was created by man2html from bash.1.
-Time: 08 January 2004 10:37:11 EST +Time: 28 January 2004 15:50:27 EST diff --git a/doc/bash.ps b/doc/bash.ps index 10e7b0349..390683a0b 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.18.1 -%%CreationDate: Sun Jan 25 21:10:35 2004 +%%CreationDate: Wed Jan 28 15:50:15 2004 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -189,11 +189,11 @@ setpacking %%IncludeResource: font Palatino-Italic %%IncludeResource: font Palatino-Bold grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 -def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron -/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef +def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron +/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef -/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O @@ -321,7 +321,7 @@ E F2(po)2.5 E F0(\(portable object\) \214le format.)2.5 E F2 144 686.4 Q .3 -.15(ve \()-.25 H(see).15 E F4(INV)2.5 E(OCA)-.405 E (TION)-.855 E F0(belo)2.25 E(w\).)-.25 E F2(\255\255login)108 703.2 Q F0 (Equi)144 715.2 Q -.25(va)-.25 G(lent to).25 E F22.5 E F0(.)A -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(1)204.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(1)204.835 E 0 Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -444,7 +444,7 @@ F(ariable)-.25 E F3 -.27(BA)108 679.2 S(SH_ENV).27 E F0 1.01(in the en) 108 727.2 S 2.5(tt).2 G(he v)-2.5 E(alue of the)-.25 E F3 -.666(PA)2.5 G (TH)-.189 E F0 -.25(va)2.25 G (riable is not used to search for the \214le name.).25 E(GNU Bash-3.0)72 -768 Q(2004 Jan 24)149.845 E(2)204.835 E 0 Cg EP +768 Q(2004 Jan 28)149.845 E(2)204.835 E 0 Cg EP %%Page: 3 3 %%BeginPageSetup BP @@ -569,7 +569,7 @@ F1(Pipelines)87 679.2 Q F0(A)108 691.2 Q F2(pipeline)2.919 E F0 .419 F F1(|)2.92 E F0 5.42(.T)C .42(he format for a pipeline)-5.42 F(is:)108 703.2 Q([)144 720 Q F1(time)A F0([)2.5 E F1A F0(]] [ ! ])A F2 (command)2.5 E F0([)2.5 E F1(|)2.5 E F2(command2)2.5 E F0(... ])2.5 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(3)204.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(3)204.835 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -689,7 +689,7 @@ A({)108 573.6 Q F1(list)2.5 E F0 2.5(;})C F1(list)3.89 E F0 .402 F(SIONS)144 727.2 Q F5(.)A F0 -.8(Wo)5.633 G 1.133 (rd splitting and pathname e).8 F 1.133 (xpansion are not performed on the w)-.15 F 1.133(ords between the)-.1 F -F3([[)3.632 E F0(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(4)204.835 E +F3([[)3.632 E F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(4)204.835 E 0 Cg EP %%Page: 5 5 %%BeginPageSetup @@ -829,7 +829,7 @@ F F2(name)144 727.2 Q F0 .759(to be set to null.)3.439 F .759 (The line read is sa)5.759 F -.15(ve)-.2 G 3.26(di).15 G 3.26(nt)-3.26 G .76(he v)-3.26 F(ariable)-.25 E F1(REPL)3.26 E(Y)-.92 E F0 5.76(.T)C(he) -5.76 E F2(list)3.35 E F0 .76(is e)3.94 F -.15(xe)-.15 G .76 -(cuted after).15 F(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(5)204.835 +(cuted after).15 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(5)204.835 E 0 Cg EP %%Page: 6 6 %%BeginPageSetup @@ -965,7 +965,7 @@ E(xpansion.)-.15 E(There are three quoting mechanisms: the)108 708 Q F2 G(he)-2.974 E F2 .474(escape c)2.974 F(har)-.15 E(acter)-.15 E F0 5.474 (.I).73 G 2.974(tp)-5.474 G(reserv)-2.974 E .474(es the literal v)-.15 F .474(alue of the ne)-.25 F .474(xt character that)-.15 F(GNU Bash-3.0)72 -768 Q(2004 Jan 24)149.845 E(6)204.835 E 0 Cg EP +768 Q(2004 Jan 28)149.845 E(6)204.835 E 0 Cg EP %%Page: 7 7 %%BeginPageSetup BP @@ -1082,7 +1082,7 @@ d by one or more digits, other than the single digit 0.)3.935 F(Posi-) 5.706 E .445(tional parameters are assigned from the shell')108 729.6 R 2.944(sa)-.55 G -.18(rg)-2.944 G .444(uments when it is in).18 F -.2(vo) -.4 G -.1(ke).2 G .444(d, and may be reassigned using).1 F(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(7)204.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(7)204.835 E 0 Cg EP %%Page: 8 8 %%BeginPageSetup BP @@ -1200,7 +1200,7 @@ F F1 -.3(BA)144 619.2 S(SH_ARGV).3 E F0(.)A F1 -.3(BA)108 631.2 S F F1(${FUNCN)144 727.2 Q(AME[)-.2 E F3 8.951($i + 1)B F1(]})A F0 -.1(wa) 11.451 G 11.451(sc).1 G 11.451(alled. The)-11.451 F 8.951 (corresponding source \214le name is)11.451 F(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(8)204.835 E 0 Cg EP +(2004 Jan 28)149.845 E(8)204.835 E 0 Cg EP %%Page: 9 9 %%BeginPageSetup BP @@ -1301,7 +1301,7 @@ F(ariable)-.25 E .351(will not change the current directory)144 711.6 R 5.35(.I)-.65 G(f)-5.35 E F3(DIRST)2.85 E -.495(AC)-.81 G(K).495 E F0 .35 (is unset, it loses its special properties, e)2.6 F -.15(ve)-.25 G 2.85 (ni).15 G(f)-2.85 E(it is subsequently reset.)144 723.6 Q(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(9)204.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(9)204.835 E 0 Cg EP %%Page: 10 10 %%BeginPageSetup BP @@ -1390,7 +1390,7 @@ R .01(alue to)-.25 F F2(RANDOM)2.51 E/F4 9/Times-Roman@0 SF(.)A F0(If) 4.51 E F2(RANDOM)2.51 E F0(is)2.26 E (unset, it loses its special properties, e)144 720 Q -.15(ve)-.25 G 2.5 (ni).15 G 2.5(fi)-2.5 G 2.5(ti)-2.5 G 2.5(ss)-2.5 G(ubsequently reset.) --2.5 E(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(10)199.835 E 0 Cg EP +-2.5 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(10)199.835 E 0 Cg EP %%Page: 11 11 %%BeginPageSetup BP @@ -1499,7 +1499,7 @@ me e)-3.118 F(xpan-)-.15 E 3.131(sion. If)144 640.8 R 3.132<618c>3.131 G (all pre)144 724.8 R .698 (vious lines matching the current line to be remo)-.25 F -.15(ve)-.15 G 3.198(df).15 G .698(rom the history list before that line is)-3.198 F -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(11)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(11)199.835 E 0 Cg EP %%Page: 12 12 %%BeginPageSetup BP @@ -1612,7 +1612,7 @@ E F1(LANG)108 648 Q F0 1.24(Used to determine the locale cate)7.11 F (rrides the v).15 F .764(alue of)-.25 F F1(LANG)3.264 E F0 .764(and an) 3.264 F 3.264(yo)-.15 G(ther)-3.264 E F1(LC_)3.264 E F0 -.25(va)3.264 G .764(riable specifying a locale cate-).25 F(gory)144 696 Q(.)-.65 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(12)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(12)199.835 E 0 Cg EP %%Page: 13 13 %%BeginPageSetup BP @@ -1716,7 +1716,7 @@ F0 1.225(displays during an e)3.725 F -.15(xe)-.15 G 1.225 E F0 1.226(is replicated multiple)3.476 F(times, as necessary)144 696 Q 2.5(,t)-.65 G 2.5(oi)-2.5 G(ndicate multiple le)-2.5 E -.15(ve)-.25 G (ls of indirection.).15 E(The def)5 E(ault is `)-.1 E(`)-.74 E F1(+)A F0 --.74('')2.5 G(.).74 E(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(13) +-.74('')2.5 G(.).74 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(13) 199.835 E 0 Cg EP %%Page: 14 14 %%BeginPageSetup @@ -1835,7 +1835,7 @@ G .961(or an)-3.461 F 3.461(yr)-.15 G(equirement)-3.461 E 1.302(An array is created automatically if an)108 728.4 R 3.801(yv)-.15 G 1.301(ariable is assigned to using the syntax)-4.051 F F2(name)3.801 E F0([)A F2(subscript)A F0(]=)A F2(value)A F0(.)A(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(14)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(14)199.835 E 0 Cg EP %%Page: 15 15 %%BeginPageSetup BP @@ -1987,7 +1987,7 @@ F0(must be of the same type.)2.5 E .582(Brace e)108 705.6 R .582 (does not apply an)2.516 F 2.516(ys)-.15 G .016 (yntactic interpretation to the con-)-2.516 F(te)108 729.6 Q (xt of the e)-.15 E(xpansion or the te)-.15 E(xt between the braces.) --.15 E(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(15)199.835 E 0 Cg EP +-.15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(15)199.835 E 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP @@ -2115,7 +2115,7 @@ E .351(able is then e)108 700.8 R .351(xpanded and that v)-.15 F .352 F2(@)A F0 .762(]} described belo)B 4.563 -.65(w. T)-.25 H .763(he e).65 F .763(xclamation point must immediately follo)-.15 F 3.263(wt)-.25 G .763(he left brace in order to)-3.263 F(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(16)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(16)199.835 E 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP @@ -2238,7 +2238,7 @@ F1(par)145.25 664.8 Q(ameter)-.15 E F0 .607 3.151(,t)C .651(he pattern remo)-3.151 F -.25(va)-.15 G 3.151(lo).25 G .65(peration is applied to each member of the array in)-3.151 F (turn, and the e)144 712.8 Q(xpansion is the resultant list.)-.15 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(17)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(17)199.835 E 0 Cg EP %%Page: 18 18 %%BeginPageSetup BP @@ -2351,7 +2351,7 @@ F1 -.2(ex)2.666 G(pr).2 E(ession)-.37 E F0 .165 A F0(If)5.878 E F1 -.2(ex)108 705.6 S(pr).2 E(ession)-.37 E F0(is in) 2.74 E -.25(va)-.4 G(lid,).25 E F2(bash)2.5 E F0 (prints a message indicating f)2.5 E(ailure and no substitution occurs.) --.1 E(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(18)199.835 E 0 Cg EP +-.1 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(18)199.835 E 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP @@ -2488,7 +2488,7 @@ R 1.12(NUL character may not occur in a pattern.)3.62 F 3.62(Ab)6.12 G (The special pattern characters must be quoted if the)5.576 F 3.076(ya) -.15 G(re)-3.076 E(to be matched literally)108 691.2 Q(.)-.65 E (The special pattern characters ha)108 708 Q .3 -.15(ve t)-.2 H -(he follo).15 E(wing meanings:)-.25 E(GNU Bash-3.0)72 768 Q(2004 Jan 24) +(he follo).15 E(wing meanings:)-.25 E(GNU Bash-3.0)72 768 Q(2004 Jan 28) 149.845 E(19)199.835 E 0 Cg EP %%Page: 20 20 %%BeginPageSetup @@ -2599,7 +2599,7 @@ ted, and the \214rst character of the redirec-)-.25 F .365 E F0(dirlist 2)2.5 E F1(>&)A F0(1)A (directs both standard output and standard error to the \214le)108 728.4 Q F2(dirlist)2.5 E F0 2.5(,w).68 G(hile the command)-2.5 E(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(20)199.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(20)199.835 E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP @@ -2688,7 +2688,7 @@ Q F0(allo)3.141 E .642(ws both the standard output \(\214le descriptor \ E(There are tw)108 693.6 Q 2.5(of)-.1 G (ormats for redirecting standard output and standard error:)-2.5 E F1 (&>)144 710.4 Q F2(wor)A(d)-.37 E F0(and)108 722.4 Q(GNU Bash-3.0)72 768 -Q(2004 Jan 24)149.845 E(21)199.835 E 0 Cg EP +Q(2004 Jan 28)149.845 E(21)199.835 E 0 Cg EP %%Page: 22 22 %%BeginPageSetup BP @@ -2775,7 +2775,7 @@ E F0(is closed after being duplicated to)2.5 E F2(n)2.5 E F0(.)A .24 G 2.786(rt)-2.786 G .285 (he standard output \(\214le descriptor 1\) if)-2.786 F F2(n)2.785 E F0 .285(is not speci-)2.785 F(\214ed.)108 705.6 Q(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(22)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(22)199.835 E 0 Cg EP %%Page: 23 23 %%BeginPageSetup BP @@ -2915,7 +2915,7 @@ F F1 .616(\255o functrace)3.115 F F0 .616 (alues of the positional parameters and the spe-)-.25 F(cial parameter) 108 724.8 Q F1(#)2.5 E F0(are restored to the v)2.5 E(alues the)-.25 E 2.5(yh)-.15 G(ad prior to the function')-2.5 E 2.5(se)-.55 G -.15(xe) --2.65 G(cution.).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(23) +-2.65 G(cution.).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(23) 199.835 E 0 Cg EP %%Page: 24 24 %%BeginPageSetup @@ -3018,7 +3018,7 @@ H .343(ts inte).15 F .343(ger attrib)-.15 F .343(ute turned on)-.2 F (xpressions in parentheses are e)-.15 F -.25(va)-.25 G .234 (luated \214rst and may).25 F -.15(ove)108 724.8 S (rride the precedence rules abo).15 E -.15(ve)-.15 G(.).15 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(24)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(24)199.835 E 0 Cg EP %%Page: 25 25 %%BeginPageSetup BP @@ -3128,7 +3128,7 @@ qual to, greater than, or greater than or equal to)144 696 R F3(ar)144 -.65 E F3(Ar)6.01 E(g1)-.37 E F0(and)2.5 E F3(ar)2.83 E(g2)-.37 E F0 (may be positi)2.52 E .3 -.15(ve o)-.25 H 2.5(rn).15 G -2.25 -.15(eg a) -2.5 H(ti).15 E .3 -.15(ve i)-.25 H(nte).15 E(gers.)-.15 E(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(25)199.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(25)199.835 E 0 Cg EP %%Page: 26 26 %%BeginPageSetup BP @@ -3244,7 +3244,7 @@ e remainder of the \214rst line speci\214es an interpreter for the pro-) (COMMAND EXECUTION ENVIR)72 703.2 Q(ONMENT)-.329 E F0(The shell has an) 108 715.2 Q F5 -.2(ex)2.5 G(ecution en).2 E(vir)-.4 E(onment)-.45 E F0 2.5(,w)C(hich consists of the follo)-2.5 E(wing:)-.25 E(GNU Bash-3.0)72 -768 Q(2004 Jan 24)149.845 E(26)199.835 E 0 Cg EP +768 Q(2004 Jan 28)149.845 E(26)199.835 E 0 Cg EP %%Page: 27 27 %%BeginPageSetup BP @@ -3354,7 +3354,7 @@ t for)-.4 F F2 -.2(ex)2.643 G(port).2 E F0 .143(to child pro-)3.323 F .202(parameter assignments, as described abo)108 724.8 R .502 -.15(ve i) -.15 H(n).15 E/F4 9/Times-Bold@0 SF -.666(PA)2.702 G(RAMETERS).666 E/F5 9/Times-Roman@0 SF(.)A F0 .202(These assignment statements af)4.702 F -.203(fect only the)-.25 F(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E +.203(fect only the)-.25 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E (27)199.835 E 0 Cg EP %%Page: 28 28 %%BeginPageSetup @@ -3479,7 +3479,7 @@ iated)108 676.8 R .732(with this job is 25647.)108 688.8 R .733 .87(notion of a)108 729.6 R F2(curr)3.37 E .87(ent terminal pr)-.37 F .871(ocess gr)-.45 F .871(oup ID)-.45 F F0 5.871(.M)C .871 (embers of this process group \(processes whose process)-5.871 F -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(28)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(28)199.835 E 0 Cg EP %%Page: 29 29 %%BeginPageSetup BP @@ -3606,7 +3606,7 @@ ized by inserting a number of backslash-escaped special characters that\ (\\r)144 700.8 Q F0(carriage return)28.78 E F4(\\s)144 712.8 Q F0 (the name of the shell, the basename of)29.33 E F4($0)2.5 E F0 (\(the portion follo)2.5 E(wing the \214nal slash\))-.25 E(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(29)199.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(29)199.835 E 0 Cg EP %%Page: 30 30 %%BeginPageSetup BP @@ -3727,7 +3727,7 @@ nd the k)108 652.8 R 1.334 -.15(ey b)-.1 H 1.034(indings and).15 F -.25 -.15(ey)-.1 G .987(-bindings may be changed with an).15 F F2(inputr) 3.497 E(c)-.37 E F0 3.487(\214le. Other)3.797 F .987 (programs that use this library may)3.487 F(add their o)108 717.6 Q -(wn commands and bindings.)-.25 E(GNU Bash-3.0)72 768 Q(2004 Jan 24) +(wn commands and bindings.)-.25 E(GNU Bash-3.0)72 768 Q(2004 Jan 28) 149.845 E(30)199.835 E 0 Cg EP %%Page: 31 31 %%BeginPageSetup @@ -3810,7 +3810,7 @@ pes is a)108 612 Q -.25(va)-.2 G(ilable:).25 E F2(\\a)144 624 Q F0 648 Q F0(delete)27.66 E F2(\\f)144 660 Q F0(form feed)29.89 E F2(\\n)144 672 Q F0(ne)27.66 E(wline)-.25 E F2(\\r)144 684 Q F0(carriage return) 28.78 E F2(\\t)144 696 Q F0(horizontal tab)29.89 E F2(\\v)144 708 Q F0 --.15(ve)28.22 G(rtical tab).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 24) +-.15(ve)28.22 G(rtical tab).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28) 149.845 E(31)199.835 E 0 Cg EP %%Page: 32 32 %%BeginPageSetup @@ -3910,7 +3910,7 @@ F0 .448(When set to)144 688.8 R F1(On)2.948 E F0 2.948(,m)C(ak)-2.948 E .449(crolling the input horizontally on a)-2.948 F 1.194(single screen \ line when it becomes longer than the screen width rather than wrapping \ to a ne)144 700.8 R(w)-.25 E(line.)144 712.8 Q(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(32)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(32)199.835 E 0 Cg EP %%Page: 33 33 %%BeginPageSetup BP @@ -4009,7 +4009,7 @@ F0 .463(construct allo)2.963 F .462(ws bindings to be made based on the\ (xt of the test e)-.15 F .477 (xtends to the end of the line; no characters)-.15 F (are required to isolate it.)144 705.6 Q(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(33)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(33)199.835 E 0 Cg EP %%Page: 34 34 %%BeginPageSetup BP @@ -4117,7 +4117,7 @@ E F0 .911(refers to the current cursor position, and)3.411 F F2(mark) (db).15 G 3.41(yt)-3.41 G(he)-3.41 E F1(set\255mark)108 724.8 Q F0 2.5 (command. The)2.5 F(te)2.5 E (xt between the point and mark is referred to as the)-.15 E F2 -.37(re) -2.5 G(gion)-.03 E F0(.)A(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(34) +2.5 G(gion)-.03 E F0(.)A(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(34) 199.835 E 0 Cg EP %%Page: 35 35 %%BeginPageSetup @@ -4197,7 +4197,7 @@ etween the start of the current)-.1 F(line and the point.)144 688.8 Q (th an ar).4 F(gument)-.18 E/F3 10/Times-Italic@0 SF(n)3.294 E F0 3.294 (,i).24 G .794(nsert the)-3.294 F F3(n)3.294 E F0 .794(th w)B .794 (ord from the pre)-.1 F .794(vious command \(the w)-.25 F .795 -(ords in the)-.1 F(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(35) +(ords in the)-.1 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(35) 199.835 E 0 Cg EP %%Page: 36 36 %%BeginPageSetup @@ -4294,7 +4294,7 @@ G .779(nsert characters lik)-3.279 F(e)-.1 E F2(C\255q)3.278 E F0 3.278 -.1 F .023(ving point o)-.15 F -.15(ve)-.15 G 2.524(rt).15 G .024(hat w) -2.524 F .024(ord as well.)-.1 F .024(If point)5.024 F (is at the end of the line, this transposes the last tw)144 700.8 Q 2.5 -(ow)-.1 G(ords on the line.)-2.6 E(GNU Bash-3.0)72 768 Q(2004 Jan 24) +(ow)-.1 G(ords on the line.)-2.6 E(GNU Bash-3.0)72 768 Q(2004 Jan 28) 149.845 E(36)199.835 E 0 Cg EP %%Page: 37 37 %%BeginPageSetup @@ -4358,226 +4358,231 @@ Q(ard from point to the be)-.1 E(ginning of the line.)-.15 E (ord behind point, using white space as a w)-.1 F .365(ord boundary)-.1 F 5.365(.T)-.65 G .365(he killed te)-5.365 F .365(xt is sa)-.15 F -.15 (ve)-.2 G 2.865(do).15 G 2.865(nt)-2.865 G(he)-2.865 E(kill-ring.)144 -472.8 Q F1(delete\255horizontal\255space \(M\255\\\))108 484.8 Q F0 -(Delete all spaces and tabs around point.)144 496.8 Q F1(kill\255r)108 -508.8 Q(egion)-.18 E F0(Kill the te)144 520.8 Q(xt in the current re) --.15 E(gion.)-.15 E F1(copy\255r)108 532.8 Q(egion\255as\255kill)-.18 E -F0(Cop)144 544.8 Q 2.5(yt)-.1 G(he te)-2.5 E(xt in the re)-.15 E +472.8 Q F1(unix\255\214lename\255rubout)108 484.8 Q F0 .167(Kill the w) +144 496.8 R .166 +(ord behind point, using white space and the slash character as the w) +-.1 F .166(ord boundaries.)-.1 F(The)5.166 E(killed te)144 508.8 Q +(xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)-2.5 G(he kill-ring.) +-2.5 E F1(delete\255horizontal\255space \(M\255\\\))108 520.8 Q F0 +(Delete all spaces and tabs around point.)144 532.8 Q F1(kill\255r)108 +544.8 Q(egion)-.18 E F0(Kill the te)144 556.8 Q(xt in the current re) +-.15 E(gion.)-.15 E F1(copy\255r)108 568.8 Q(egion\255as\255kill)-.18 E +F0(Cop)144 580.8 Q 2.5(yt)-.1 G(he te)-2.5 E(xt in the re)-.15 E (gion to the kill b)-.15 E(uf)-.2 E(fer)-.25 E(.)-.55 E F1 -(copy\255backward\255w)108 556.8 Q(ord)-.1 E F0(Cop)144 568.8 Q 4.801 -(yt)-.1 G 2.301(he w)-4.801 F 2.301(ord before point to the kill b)-.1 F -(uf)-.2 E(fer)-.25 E 7.301(.T)-.55 G 2.301(he w)-7.301 F 2.3 -(ord boundaries are the same as)-.1 F F1(back-)4.8 E(ward\255w)144 580.8 -Q(ord)-.1 E F0(.)A F1(copy\255f)108 592.8 Q(orward\255w)-.25 E(ord)-.1 E -F0(Cop)144 604.8 Q 4.507(yt)-.1 G 2.007(he w)-4.507 F 2.007(ord follo) --.1 F 2.007(wing point to the kill b)-.25 F(uf)-.2 E(fer)-.25 E 7.008 -(.T)-.55 G 2.008(he w)-7.008 F 2.008(ord boundaries are the same as)-.1 -F F1 -.25(fo)4.508 G -.37(r-).25 G(ward\255w)144 616.8 Q(ord)-.1 E F0(.) -A F1(yank \(C\255y\))108 628.8 Q F0 -1(Ya)144 640.8 S -(nk the top of the kill ring into the b)1 E(uf)-.2 E(fer at point.)-.25 -E F1(yank\255pop \(M\255y\))108 652.8 Q F0 -(Rotate the kill ring, and yank the ne)144 664.8 Q 2.5(wt)-.25 G 2.5 +(copy\255backward\255w)108 592.8 Q(ord)-.1 E F0(Cop)144 604.8 Q 4.8(yt) +-.1 G 2.3(he w)-4.8 F 2.3(ord before point to the kill b)-.1 F(uf)-.2 E +(fer)-.25 E 7.301(.T)-.55 G 2.301(he w)-7.301 F 2.301 +(ord boundaries are the same as)-.1 F F1(back-)4.801 E(ward\255w)144 +616.8 Q(ord)-.1 E F0(.)A F1(copy\255f)108 628.8 Q(orward\255w)-.25 E +(ord)-.1 E F0(Cop)144 640.8 Q 4.508(yt)-.1 G 2.008(he w)-4.508 F 2.008 +(ord follo)-.1 F 2.008(wing point to the kill b)-.25 F(uf)-.2 E(fer)-.25 +E 7.007(.T)-.55 G 2.007(he w)-7.007 F 2.007 +(ord boundaries are the same as)-.1 F F1 -.25(fo)4.507 G -.37(r-).25 G +(ward\255w)144 652.8 Q(ord)-.1 E F0(.)A F1(yank \(C\255y\))108 664.8 Q +F0 -1(Ya)144 676.8 S(nk the top of the kill ring into the b)1 E(uf)-.2 E +(fer at point.)-.25 E F1(yank\255pop \(M\255y\))108 688.8 Q F0 +(Rotate the kill ring, and yank the ne)144 700.8 Q 2.5(wt)-.25 G 2.5 (op. Only)-2.5 F -.1(wo)2.5 G(rks follo).1 E(wing)-.25 E F1(yank)2.5 E -F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 681.6 Q -(guments)-.1 E(digit\255ar)108 693.6 Q -(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 .642 -(Add this digit to the ar)144 705.6 R .641 -(gument already accumulating, or start a ne)-.18 F 3.141(wa)-.25 G -.18 -(rg)-3.141 G 3.141(ument. M\255\255).18 F .641(starts a ne)3.141 F(g-) --.15 E(ati)144 717.6 Q .3 -.15(ve a)-.25 H -.18(rg).15 G(ument.).18 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(37)199.835 E 0 Cg EP +F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A(GNU Bash-3.0)72 768 Q +(2004 Jan 28)149.845 E(37)199.835 E 0 Cg EP %%Page: 38 38 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Times-Bold@0 SF(uni)108 84 Q -.1(ve)-.1 G(rsal\255ar).1 E -(gument)-.1 E F0 .778(This is another w)144 96 R .779 -(ay to specify an ar)-.1 F 3.279(gument. If)-.18 F .779 -(this command is follo)3.279 F .779(wed by one or more digits,)-.25 F -1.376 +-.35 E/F1 10/Times-Bold@0 SF(Numeric Ar)87 84 Q(guments)-.1 E +(digit\255ar)108 96 Q(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 +.641(Add this digit to the ar)144 108 R .641 +(gument already accumulating, or start a ne)-.18 F 3.141(wa)-.25 G -.18 +(rg)-3.141 G 3.142(ument. M\255\255).18 F .642(starts a ne)3.142 F(g-) +-.15 E(ati)144 120 Q .3 -.15(ve a)-.25 H -.18(rg).15 G(ument.).18 E F1 +(uni)108 132 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0 .779 +(This is another w)144 144 R .779(ay to specify an ar)-.1 F 3.279 +(gument. If)-.18 F .779(this command is follo)3.279 F .778 +(wed by one or more digits,)-.25 F 1.376 (optionally with a leading minus sign, those digits de\214ne the ar)144 -108 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144 -120 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni) +156 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144 +168 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni) 3.67 E -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0(ag)3.67 E 1.17 (ain ends the numeric ar)-.05 F 1.17(gument, b)-.18 F 1.17(ut is other) --.2 F(-)-.2 E .899(wise ignored.)144 132 R .898 -(As a special case, if this command is immediately follo)5.899 F .898 +-.2 F(-)-.2 E .898(wise ignored.)144 180 R .898 +(As a special case, if this command is immediately follo)5.898 F .898 (wed by a character that is)-.25 F .243 -(neither a digit or minus sign, the ar)144 144 R .243 +(neither a digit or minus sign, the ar)144 192 R .243 (gument count for the ne)-.18 F .243(xt command is multiplied by four) --.15 F 5.243(.T)-.55 G(he)-5.243 E(ar)144 156 Q .378 +-.15 F 5.242(.T)-.55 G(he)-5.242 E(ar)144 204 Q .378 (gument count is initially one, so e)-.18 F -.15(xe)-.15 G .378 (cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F -.378(gument count)-.18 F(four)144 168 Q 2.5(,as)-.4 G(econd time mak) +.378(gument count)-.18 F(four)144 216 Q 2.5(,as)-.4 G(econd time mak) -2.5 E(es the ar)-.1 E(gument count sixteen, and so on.)-.18 E F1 -(Completing)87 184.8 Q(complete \(T)108 196.8 Q(AB\))-.9 E F0 1.137 -(Attempt to perform completion on the te)144 208.8 R 1.137 +(Completing)87 232.8 Q(complete \(T)108 244.8 Q(AB\))-.9 E F0 1.137 +(Attempt to perform completion on the te)144 256.8 R 1.137 (xt before point.)-.15 F F1(Bash)6.137 E F0 1.137 -(attempts completion treating the)3.637 F(te)144 220.8 Q .533(xt as a v) --.15 F .533(ariable \(if the te)-.25 F .533(xt be)-.15 F .533(gins with) --.15 F F1($)3.033 E F0 .533(\), username \(if the te)B .532(xt be)-.15 F -.532(gins with)-.15 F F1(~)3.032 E F0 .532(\), hostname \(if the)B(te) -144 232.8 Q .701(xt be)-.15 F .701(gins with)-.15 F F1(@)3.201 E F0 .701 -(\), or command \(including aliases and functions\) in turn.)B .702 +(attempts completion treating the)3.637 F(te)144 268.8 Q .532(xt as a v) +-.15 F .532(ariable \(if the te)-.25 F .532(xt be)-.15 F .533(gins with) +-.15 F F1($)3.033 E F0 .533(\), username \(if the te)B .533(xt be)-.15 F +.533(gins with)-.15 F F1(~)3.033 E F0 .533(\), hostname \(if the)B(te) +144 280.8 Q .702(xt be)-.15 F .702(gins with)-.15 F F1(@)3.202 E F0 .701 +(\), or command \(including aliases and functions\) in turn.)B .701 (If none of these pro-)5.701 F -(duces a match, \214lename completion is attempted.)144 244.8 Q F1 -(possible\255completions \(M\255?\))108 256.8 Q F0 -(List the possible completions of the te)144 268.8 Q(xt before point.) --.15 E F1(insert\255completions \(M\255*\))108 280.8 Q F0 .783 -(Insert all completions of the te)144 292.8 R .783 +(duces a match, \214lename completion is attempted.)144 292.8 Q F1 +(possible\255completions \(M\255?\))108 304.8 Q F0 +(List the possible completions of the te)144 316.8 Q(xt before point.) +-.15 E F1(insert\255completions \(M\255*\))108 328.8 Q F0 .783 +(Insert all completions of the te)144 340.8 R .783 (xt before point that w)-.15 F .783(ould ha)-.1 F 1.083 -.15(ve b)-.2 H -.783(een generated by).15 F F1(possible\255com-)3.282 E(pletions)144 -304.8 Q F0(.)A F1(menu\255complete)108 316.8 Q F0 .928(Similar to)144 -328.8 R F1(complete)3.428 E F0 3.428(,b)C .929(ut replaces the w)-3.628 +.783(een generated by).15 F F1(possible\255com-)3.283 E(pletions)144 +352.8 Q F0(.)A F1(menu\255complete)108 364.8 Q F0 .929(Similar to)144 +376.8 R F1(complete)3.429 E F0 3.429(,b)C .929(ut replaces the w)-3.629 F .929(ord to be completed with a single match from the list of)-.1 F -1.194(possible completions.)144 340.8 R 1.194(Repeated e)6.194 F -.15 -(xe)-.15 G 1.194(cution of).15 F F1(menu\255complete)3.694 E F0 1.193 -(steps through the list of possible)3.694 F .828 -(completions, inserting each match in turn.)144 352.8 R .828 +1.193(possible completions.)144 388.8 R 1.193(Repeated e)6.193 F -.15 +(xe)-.15 G 1.193(cution of).15 F F1(menu\255complete)3.694 E F0 1.194 +(steps through the list of possible)3.694 F .829 +(completions, inserting each match in turn.)144 400.8 R .828 (At the end of the list of completions, the bell is rung)5.828 F .727 -(\(subject to the setting of)144 364.8 R F1(bell\255style)3.227 E F0 +(\(subject to the setting of)144 412.8 R F1(bell\255style)3.227 E F0 3.227(\)a)C .727(nd the original te)-3.227 F .727(xt is restored.)-.15 F .727(An ar)5.727 F .727(gument of)-.18 F/F2 10/Times-Italic@0 SF(n)3.227 -E F0(mo)3.227 E -.15(ve)-.15 G(s).15 E F2(n)3.227 E F0 1.73 -(positions forw)144 376.8 R 1.73(ard in the list of matches; a ne)-.1 F +E F0(mo)3.227 E -.15(ve)-.15 G(s).15 E F2(n)3.228 E F0 1.73 +(positions forw)144 424.8 R 1.73(ard in the list of matches; a ne)-.1 F -.05(ga)-.15 G(ti).05 E 2.03 -.15(ve a)-.25 H -.18(rg).15 G 1.73 (ument may be used to mo).18 F 2.03 -.15(ve b)-.15 H(ackw).15 E(ard)-.1 -E(through the list.)144 388.8 Q(This command is intended to be bound to) +E(through the list.)144 436.8 Q(This command is intended to be bound to) 5 E F1 -.9(TA)2.5 G(B).9 E F0 2.5(,b)C(ut is unbound by def)-2.7 E -(ault.)-.1 E F1(delete\255char\255or\255list)108 400.8 Q F0 .234 -(Deletes the character under the cursor if not at the be)144 412.8 R +(ault.)-.1 E F1(delete\255char\255or\255list)108 448.8 Q F0 .234 +(Deletes the character under the cursor if not at the be)144 460.8 R .234(ginning or end of the line \(lik)-.15 F(e)-.1 E F1(delete\255char) -2.734 E F0(\).)A .425(If at the end of the line, beha)144 424.8 R -.15 +2.735 E F0(\).)A .425(If at the end of the line, beha)144 472.8 R -.15 (ve)-.2 G 2.925(si).15 G .425(dentically to)-2.925 F F1 (possible\255completions)2.925 E F0 5.425(.T)C .425 -(his command is unbound)-5.425 F(by def)144 436.8 Q(ault.)-.1 E F1 -(complete\255\214lename \(M\255/\))108 448.8 Q F0 -(Attempt \214lename completion on the te)144 460.8 Q(xt before point.) --.15 E F1(possible\255\214lename\255completions \(C\255x /\))108 472.8 Q -F0(List the possible completions of the te)144 484.8 Q +(his command is unbound)-5.425 F(by def)144 484.8 Q(ault.)-.1 E F1 +(complete\255\214lename \(M\255/\))108 496.8 Q F0 +(Attempt \214lename completion on the te)144 508.8 Q(xt before point.) +-.15 E F1(possible\255\214lename\255completions \(C\255x /\))108 520.8 Q +F0(List the possible completions of the te)144 532.8 Q (xt before point, treating it as a \214lename.)-.15 E F1 -(complete\255user)108 496.8 Q(name \(M\255~\))-.15 E F0 -(Attempt completion on the te)144 508.8 Q +(complete\255user)108 544.8 Q(name \(M\255~\))-.15 E F0 +(Attempt completion on the te)144 556.8 Q (xt before point, treating it as a username.)-.15 E F1(possible\255user) -108 520.8 Q(name\255completions \(C\255x ~\))-.15 E F0 -(List the possible completions of the te)144 532.8 Q +108 568.8 Q(name\255completions \(C\255x ~\))-.15 E F0 +(List the possible completions of the te)144 580.8 Q (xt before point, treating it as a username.)-.15 E F1(complete\255v)108 -544.8 Q(ariable \(M\255$\))-.1 E F0(Attempt completion on the te)144 -556.8 Q(xt before point, treating it as a shell v)-.15 E(ariable.)-.25 E -F1(possible\255v)108 568.8 Q(ariable\255completions \(C\255x $\))-.1 E -F0(List the possible completions of the te)144 580.8 Q +592.8 Q(ariable \(M\255$\))-.1 E F0(Attempt completion on the te)144 +604.8 Q(xt before point, treating it as a shell v)-.15 E(ariable.)-.25 E +F1(possible\255v)108 616.8 Q(ariable\255completions \(C\255x $\))-.1 E +F0(List the possible completions of the te)144 628.8 Q (xt before point, treating it as a shell v)-.15 E(ariable.)-.25 E F1 -(complete\255hostname \(M\255@\))108 592.8 Q F0 -(Attempt completion on the te)144 604.8 Q +(complete\255hostname \(M\255@\))108 640.8 Q F0 +(Attempt completion on the te)144 652.8 Q (xt before point, treating it as a hostname.)-.15 E F1 -(possible\255hostname\255completions \(C\255x @\))108 616.8 Q F0 -(List the possible completions of the te)144 628.8 Q +(possible\255hostname\255completions \(C\255x @\))108 664.8 Q F0 +(List the possible completions of the te)144 676.8 Q (xt before point, treating it as a hostname.)-.15 E F1 -(complete\255command \(M\255!\))108 640.8 Q F0 .581 -(Attempt completion on the te)144 652.8 R .581 -(xt before point, treating it as a command name.)-.15 F .58 -(Command comple-)5.58 F .715(tion attempts to match the te)144 664.8 R +(complete\255command \(M\255!\))108 688.8 Q F0 .58 +(Attempt completion on the te)144 700.8 R .581 +(xt before point, treating it as a command name.)-.15 F .581 +(Command comple-)5.581 F .715(tion attempts to match the te)144 712.8 R .715(xt ag)-.15 F .715(ainst aliases, reserv)-.05 F .715(ed w)-.15 F .715(ords, shell functions, shell b)-.1 F .715(uiltins, and)-.2 F -(\214nally e)144 676.8 Q -.15(xe)-.15 G -(cutable \214lenames, in that order).15 E(.)-.55 E F1 -(possible\255command\255completions \(C\255x !\))108 688.8 Q F0 -(List the possible completions of the te)144 700.8 Q -(xt before point, treating it as a command name.)-.15 E(GNU Bash-3.0)72 -768 Q(2004 Jan 24)149.845 E(38)199.835 E 0 Cg EP +(\214nally e)144 724.8 Q -.15(xe)-.15 G +(cutable \214lenames, in that order).15 E(.)-.55 E(GNU Bash-3.0)72 768 Q +(2004 Jan 28)149.845 E(38)199.835 E 0 Cg EP %%Page: 39 39 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Times-Bold@0 SF(dynamic\255complete\255history \(M\255T)108 -84 Q(AB\))-.9 E F0 .425(Attempt completion on the te)144 96 R .425 -(xt before point, comparing the te)-.15 F .425(xt ag)-.15 F .424 +-.35 E/F1 10/Times-Bold@0 SF +(possible\255command\255completions \(C\255x !\))108 84 Q F0 +(List the possible completions of the te)144 96 Q +(xt before point, treating it as a command name.)-.15 E F1 +(dynamic\255complete\255history \(M\255T)108 108 Q(AB\))-.9 E F0 .424 +(Attempt completion on the te)144 120 R .425 +(xt before point, comparing the te)-.15 F .425(xt ag)-.15 F .425 (ainst lines from the history list)-.05 F -(for possible completion matches.)144 108 Q F1 -(complete\255into\255braces \(M\255{\))108 120 Q F0 .4(Perform \214lena\ +(for possible completion matches.)144 132 Q F1 +(complete\255into\255braces \(M\255{\))108 144 Q F0 .4(Perform \214lena\ me completion and insert the list of possible completions enclosed with\ -in braces so)144 132 R(the list is a)144 144 Q -.25(va)-.2 G +in braces so)144 156 R(the list is a)144 168 Q -.25(va)-.2 G (ilable to the shell \(see).25 E F1(Brace Expansion)2.5 E F0(abo)2.5 E --.15(ve)-.15 G(\).).15 E F1 -.25(Ke)87 160.8 S(yboard Macr).25 E(os)-.18 -E(start\255kbd\255macr)108 172.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)) -.833 E F0(Be)144 184.8 Q(gin sa)-.15 E +-.15(ve)-.15 G(\).).15 E F1 -.25(Ke)87 184.8 S(yboard Macr).25 E(os)-.18 +E(start\255kbd\255macr)108 196.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)) +.833 E F0(Be)144 208.8 Q(gin sa)-.15 E (ving the characters typed into the current k)-.2 E -.15(ey)-.1 G -(board macro.).15 E F1(end\255kbd\255macr)108 196.8 Q 2.5(o\()-.18 G -(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 208.8 Q +(board macro.).15 E F1(end\255kbd\255macr)108 220.8 Q 2.5(o\()-.18 G +(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 232.8 Q (ving the characters typed into the current k)-.2 E -.15(ey)-.1 G (board macro and store the de\214nition.).15 E F1 -(call\255last\255kbd\255macr)108 220.8 Q 2.5(o\()-.18 G(C\255x e\))-2.5 -E F0(Re-e)144 232.8 Q -.15(xe)-.15 G 1(cute the last k).15 F -.15(ey)-.1 -G .999(board macro de\214ned, by making the characters in the macro app\ -ear as if).15 F(typed at the k)144 244.8 Q -.15(ey)-.1 G(board.).15 E F1 -(Miscellaneous)87 261.6 Q -.18(re)108 273.6 S.18 E -(ead\255init\255\214le \(C\255x C\255r\))-.18 E F0 1.776 -(Read in the contents of the)144 285.6 R/F2 10/Times-Italic@0 SF(inputr) -4.276 E(c)-.37 E F0 1.777(\214le, and incorporate an)4.276 F 4.277(yb) --.15 G 1.777(indings or v)-4.277 F 1.777(ariable assignments)-.25 F -(found there.)144 297.6 Q F1(abort \(C\255g\))108 309.6 Q F0 3.249 -(Abort the current editing command and ring the terminal')144 321.6 R -5.748(sb)-.55 G 3.248(ell \(subject to the setting of)-5.748 F F1 -(bell\255style)144 333.6 Q F0(\).)A F1(do\255upper)108 345.6 Q +(call\255last\255kbd\255macr)108 244.8 Q 2.5(o\()-.18 G(C\255x e\))-2.5 +E F0(Re-e)144 256.8 Q -.15(xe)-.15 G .999(cute the last k).15 F -.15(ey) +-.1 G .999(board macro de\214ned, by making the characters in the macro\ + appear as if).15 F(typed at the k)144 268.8 Q -.15(ey)-.1 G(board.).15 +E F1(Miscellaneous)87 285.6 Q -.18(re)108 297.6 S.18 E +(ead\255init\255\214le \(C\255x C\255r\))-.18 E F0 1.777 +(Read in the contents of the)144 309.6 R/F2 10/Times-Italic@0 SF(inputr) +4.277 E(c)-.37 E F0 1.776(\214le, and incorporate an)4.276 F 4.276(yb) +-.15 G 1.776(indings or v)-4.276 F 1.776(ariable assignments)-.25 F +(found there.)144 321.6 Q F1(abort \(C\255g\))108 333.6 Q F0 3.248 +(Abort the current editing command and ring the terminal')144 345.6 R +5.749(sb)-.55 G 3.249(ell \(subject to the setting of)-5.749 F F1 +(bell\255style)144 357.6 Q F0(\).)A F1(do\255upper)108 369.6 Q (case\255v)-.18 E(ersion \(M\255a, M\255b, M\255)-.1 E F2(x)A F1 2.5(,.) -C(..\))-2.5 E F0 1.755(If the meta\214ed character)144 357.6 R F2(x) -4.255 E F0 1.755(is lo)4.255 F 1.756 +C(..\))-2.5 E F0 1.756(If the meta\214ed character)144 381.6 R F2(x) +4.256 E F0 1.755(is lo)4.256 F 1.755 (wercase, run the command that is bound to the corresponding)-.25 F -(uppercase character)144 369.6 Q(.)-.55 E F1(pr)108 381.6 Q -(e\214x\255meta \(ESC\))-.18 E F0(Metafy the ne)144 393.6 Q +(uppercase character)144 393.6 Q(.)-.55 E F1(pr)108 405.6 Q +(e\214x\255meta \(ESC\))-.18 E F0(Metafy the ne)144 417.6 Q (xt character typed.)-.15 E/F3 9/Times-Bold@0 SF(ESC)5 E F1(f)2.25 E F0 (is equi)2.5 E -.25(va)-.25 G(lent to).25 E F1(Meta\255f)2.5 E F0(.)A F1 -(undo \(C\255_, C\255x C\255u\))108 405.6 Q F0 -(Incremental undo, separately remembered for each line.)144 417.6 Q F1 --2.29 -.18(re v)108 429.6 T(ert\255line \(M\255r\)).08 E F0 1.095 -(Undo all changes made to this line.)144 441.6 R 1.095(This is lik)6.095 +(undo \(C\255_, C\255x C\255u\))108 429.6 Q F0 +(Incremental undo, separately remembered for each line.)144 441.6 Q F1 +-2.29 -.18(re v)108 453.6 T(ert\255line \(M\255r\)).08 E F0 1.095 +(Undo all changes made to this line.)144 465.6 R 1.095(This is lik)6.095 F 3.595(ee)-.1 G -.15(xe)-3.745 G 1.095(cuting the).15 F F1(undo)3.595 E F0 1.095(command enough times to)3.595 F -(return the line to its initial state.)144 453.6 Q F1 -(tilde\255expand \(M\255&\))108 465.6 Q F0(Perform tilde e)144 477.6 Q +(return the line to its initial state.)144 477.6 Q F1 +(tilde\255expand \(M\255&\))108 489.6 Q F0(Perform tilde e)144 501.6 Q (xpansion on the current w)-.15 E(ord.)-.1 E F1 -(set\255mark \(C\255@, M\255\))108 489.6 Q F0 -(Set the mark to the point.)144 501.6 Q(If a numeric ar)5 E +(set\255mark \(C\255@, M\255\))108 513.6 Q F0 +(Set the mark to the point.)144 525.6 Q(If a numeric ar)5 E (gument is supplied, the mark is set to that position.)-.18 E F1 -(exchange\255point\255and\255mark \(C\255x C\255x\))108 513.6 Q F0(Sw) -144 525.6 Q .282(ap the point with the mark.)-.1 F .283 +(exchange\255point\255and\255mark \(C\255x C\255x\))108 537.6 Q F0(Sw) +144 549.6 Q .283(ap the point with the mark.)-.1 F .283 (The current cursor position is set to the sa)5.283 F -.15(ve)-.2 G -2.783(dp).15 G .283(osition, and the old)-2.783 F(cursor position is sa) -144 537.6 Q -.15(ve)-.2 G 2.5(da).15 G 2.5(st)-2.5 G(he mark.)-2.5 E F1 -(character\255sear)108 549.6 Q(ch \(C\255]\))-.18 E F0 3.036(Ac)144 -561.6 S .536(haracter is read and point is mo)-3.036 F -.15(ve)-.15 G +2.782(dp).15 G .282(osition, and the old)-2.782 F(cursor position is sa) +144 561.6 Q -.15(ve)-.2 G 2.5(da).15 G 2.5(st)-2.5 G(he mark.)-2.5 E F1 +(character\255sear)108 573.6 Q(ch \(C\255]\))-.18 E F0 3.035(Ac)144 +585.6 S .535(haracter is read and point is mo)-3.035 F -.15(ve)-.15 G 3.035(dt).15 G 3.035(ot)-3.035 G .535(he ne)-3.035 F .535 -(xt occurrence of that character)-.15 F 5.535(.A)-.55 G(ne)-2.5 E -.05 -(ga)-.15 G(ti).05 E .835 -.15(ve c)-.25 H(ount).15 E(searches for pre) -144 573.6 Q(vious occurrences.)-.25 E F1(character\255sear)108 585.6 Q -(ch\255backward \(M\255C\255]\))-.18 E F0 3.543(Ac)144 597.6 S 1.043 -(haracter is read and point is mo)-3.543 F -.15(ve)-.15 G 3.544(dt).15 G +(xt occurrence of that character)-.15 F 5.536(.A)-.55 G(ne)-2.5 E -.05 +(ga)-.15 G(ti).05 E .836 -.15(ve c)-.25 H(ount).15 E(searches for pre) +144 597.6 Q(vious occurrences.)-.25 E F1(character\255sear)108 609.6 Q +(ch\255backward \(M\255C\255]\))-.18 E F0 3.544(Ac)144 621.6 S 1.044 +(haracter is read and point is mo)-3.544 F -.15(ve)-.15 G 3.544(dt).15 G 3.544(ot)-3.544 G 1.044(he pre)-3.544 F 1.044 -(vious occurrence of that character)-.25 F 6.044(.A)-.55 G(ne)-2.5 E +(vious occurrence of that character)-.25 F 6.043(.A)-.55 G(ne)-2.5 E -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G -(count searches for subsequent occurrences.)144 609.6 Q F1 -(insert\255comment \(M\255#\))108 621.6 Q F0 -.4(Wi)144 633.6 S .481 -(thout a numeric ar).4 F .481(gument, the v)-.18 F .481 +(count searches for subsequent occurrences.)144 633.6 Q F1 +(insert\255comment \(M\255#\))108 645.6 Q F0 -.4(Wi)144 657.6 S .48 +(thout a numeric ar).4 F .48(gument, the v)-.18 F .481 (alue of the readline)-.25 F F1(comment\255begin)2.981 E F0 -.25(va) -2.981 G .48(riable is inserted at the).25 F(be)144 645.6 Q .097 -(ginning of the current line.)-.15 F .098(If a numeric ar)5.097 F .098 -(gument is supplied, this command acts as a toggle:)-.18 F(if)5.098 E -.322(the characters at the be)144 657.6 R .321 +2.981 G .481(riable is inserted at the).25 F(be)144 669.6 Q .098 +(ginning of the current line.)-.15 F .098(If a numeric ar)5.098 F .097 +(gument is supplied, this command acts as a toggle:)-.18 F(if)5.097 E +.321(the characters at the be)144 681.6 R .321 (ginning of the line do not match the v)-.15 F .321(alue of)-.25 F F1 -(comment\255begin)2.821 E F0 2.821(,t)C .321(he v)-2.821 F .321(alue is) --.25 F 1.013(inserted, otherwise the characters in)144 669.6 R F1 -(comment-begin)3.514 E F0 1.014(are deleted from the be)3.514 F 1.014 -(ginning of the line.)-.15 F 1.469 -(In either case, the line is accepted as if a ne)144 681.6 R 1.468 -(wline had been typed.)-.25 F 1.468(The def)6.468 F 1.468(ault v)-.1 F -1.468(alue of)-.25 F F1(com-)3.968 E(ment\255begin)144 693.6 Q F0 .839 -(causes this command to mak)3.339 F 3.339(et)-.1 G .839 -(he current line a shell comment.)-3.339 F .84(If a numeric ar)5.84 F -(gu-)-.18 E(ment causes the comment character to be remo)144 705.6 Q +(comment\255begin)2.821 E F0 2.822(,t)C .322(he v)-2.822 F .322(alue is) +-.25 F 1.014(inserted, otherwise the characters in)144 693.6 R F1 +(comment-begin)3.514 E F0 1.014(are deleted from the be)3.514 F 1.013 +(ginning of the line.)-.15 F 1.468 +(In either case, the line is accepted as if a ne)144 705.6 R 1.468 +(wline had been typed.)-.25 F 1.469(The def)6.469 F 1.469(ault v)-.1 F +1.469(alue of)-.25 F F1(com-)3.969 E(ment\255begin)144 717.6 Q F0 .84 +(causes this command to mak)3.34 F 3.339(et)-.1 G .839 +(he current line a shell comment.)-3.339 F .839(If a numeric ar)5.839 F +(gu-)-.18 E(ment causes the comment character to be remo)144 729.6 Q -.15(ve)-.15 G(d, the line will be e).15 E -.15(xe)-.15 G -(cuted by the shell.).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E +(cuted by the shell.).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E (39)199.835 E 0 Cg EP %%Page: 40 40 %%BeginPageSetup @@ -4585,13 +4590,13 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Times-Bold@0 SF(glob\255complete\255w)108 84 Q -(ord \(M\255g\))-.1 E F0 .792(The w)144 96 R .791 -(ord before point is treated as a pattern for pathname e)-.1 F .791 +(ord \(M\255g\))-.1 E F0 .791(The w)144 96 R .791 +(ord before point is treated as a pattern for pathname e)-.1 F .792 (xpansion, with an asterisk implicitly)-.15 F 2.5(appended. This)144 108 R(pattern is used to generate a list of matching \214le names for possi\ ble completions.)2.5 E F1(glob\255expand\255w)108 120 Q -(ord \(C\255x *\))-.1 E F0 .371(The w)144 132 R .372 -(ord before point is treated as a pattern for pathname e)-.1 F .372 +(ord \(C\255x *\))-.1 E F0 .372(The w)144 132 R .372 +(ord before point is treated as a pattern for pathname e)-.1 F .371 (xpansion, and the list of matching \214le)-.15 F .516 (names is inserted, replacing the w)144 144 R 3.016(ord. If)-.1 F 3.016 (an)3.016 G .516(umeric ar)-3.016 F .516 @@ -4603,248 +4608,248 @@ ble completions.)2.5 E F1(glob\255expand\255w)108 120 Q .872(the line is redra)144 192 R 3.372(wn. If)-.15 F 3.372(an)3.372 G .872(umeric ar)-3.372 F .872 (gument is supplied, an asterisk is appended before pathname)-.18 F -.15 -(ex)144 204 S(pansion.).15 E F1(dump\255functions)108 216 Q F0 .626 -(Print all of the functions and their k)144 228 R .926 -.15(ey b)-.1 H -.627(indings to the readline output stream.).15 F .627(If a numeric ar) -5.627 F(gu-)-.18 E +(ex)144 204 S(pansion.).15 E F1(dump\255functions)108 216 Q F0 .627 +(Print all of the functions and their k)144 228 R .927 -.15(ey b)-.1 H +.626(indings to the readline output stream.).15 F .626(If a numeric ar) +5.626 F(gu-)-.18 E (ment is supplied, the output is formatted in such a w)144 240 Q (ay that it can be made part of an)-.1 E/F2 10/Times-Italic@0 SF(inputr) 2.5 E(c)-.37 E F0(\214le.)2.5 E F1(dump\255v)108 252 Q(ariables)-.1 E F0 -1.8(Print all of the settable readline v)144 264 R 1.799 -(ariables and their v)-.25 F 1.799(alues to the readline output stream.) --.25 F 1.799(If a)6.799 F .304(numeric ar)144 276 R .304 +1.799(Print all of the settable readline v)144 264 R 1.799 +(ariables and their v)-.25 F 1.8(alues to the readline output stream.) +-.25 F 1.8(If a)6.8 F .305(numeric ar)144 276 R .304 (gument is supplied, the output is formatted in such a w)-.18 F .304 (ay that it can be made part of an)-.1 F F2(inputr)144 288 Q(c)-.37 E F0 (\214le.)2.5 E F1(dump\255macr)108 300 Q(os)-.18 E F0 .756 (Print all of the readline k)144 312 R 1.056 -.15(ey s)-.1 H .756 (equences bound to macros and the strings the).15 F 3.256(yo)-.15 G -3.256(uput. If)-3.256 F 3.255(an)3.255 G(umeric)-3.255 E(ar)144 324 Q +3.256(uput. If)-3.256 F 3.256(an)3.256 G(umeric)-3.256 E(ar)144 324 Q .528(gument is supplied, the output is formatted in such a w)-.18 F .528 -(ay that it can be made part of an)-.1 F F2(inputr)3.028 E(c)-.37 E F0 +(ay that it can be made part of an)-.1 F F2(inputr)3.027 E(c)-.37 E F0 (\214le.)144 336 Q F1(display\255shell\255v)108 348 Q (ersion \(C\255x C\255v\))-.1 E F0(Display v)144 360 Q (ersion information about the current instance of)-.15 E F1(bash)2.5 E -F0(.)A F1(Pr)87 376.8 Q(ogrammable Completion)-.18 E F0 .147(When w)108 +F0(.)A F1(Pr)87 376.8 Q(ogrammable Completion)-.18 E F0 .146(When w)108 388.8 R .147(ord completion is attempted for an ar)-.1 F .147 (gument to a command for which a completion speci\214cation \(a)-.18 F -F2(compspec)108 400.8 Q F0 3.828(\)h)C 1.329 -(as been de\214ned using the)-3.828 F F1(complete)3.829 E F0 -.2(bu) +F2(compspec)108 400.8 Q F0 3.829(\)h)C 1.329 +(as been de\214ned using the)-3.829 F F1(complete)3.829 E F0 -.2(bu) 3.829 G 1.329(iltin \(see).2 F/F3 9/Times-Bold@0 SF 1.329(SHELL B)3.829 -F(UIL)-.09 E 1.329(TIN COMMANDS)-.828 F F0(belo)3.579 E 1.329(w\), the) +F(UIL)-.09 E 1.329(TIN COMMANDS)-.828 F F0(belo)3.579 E 1.328(w\), the) -.25 F(programmable completion f)108 412.8 Q(acilities are in)-.1 E -.2 -(vo)-.4 G -.1(ke).2 G(d.).1 E .334 -(First, the command name is identi\214ed.)108 429.6 R .333 +(vo)-.4 G -.1(ke).2 G(d.).1 E .333 +(First, the command name is identi\214ed.)108 429.6 R .334 (If a compspec has been de\214ned for that command, the compspec is) -5.334 F .587 +5.333 F .587 (used to generate the list of possible completions for the w)108 441.6 R -3.087(ord. If)-.1 F .587(the command w)3.087 F .587 -(ord is a full pathname, a)-.1 F 1.181 +3.087(ord. If)-.1 F .587(the command w)3.087 F .586 +(ord is a full pathname, a)-.1 F 1.18 (compspec for the full pathname is searched for \214rst.)108 453.6 R -1.18(If no compspec is found for the full pathname, an)6.181 F +1.181(If no compspec is found for the full pathname, an)6.181 F (attempt is made to \214nd a compspec for the portion follo)108 465.6 Q (wing the \214nal slash.)-.25 E .817(Once a compspec has been found, it\ is used to generate the list of matching w)108 482.4 R 3.317(ords. If) -.1 F 3.317(ac)3.317 G .817(ompspec is not)-3.317 F(found, the def)108 494.4 Q(ault)-.1 E F1(bash)2.5 E F0(completion as described abo)2.5 E .3 -.15(ve u)-.15 H(nder).15 E F1(Completing)2.5 E F0(is performed.)2.5 E -.464(First, the actions speci\214ed by the compspec are used.)108 511.2 -R .463(Only matches which are pre\214x)5.464 F .463(ed by the w)-.15 F -.463(ord being)-.1 F .595(completed are returned.)108 523.2 R .595 -(When the)5.595 F F13.095 E F0(or)3.095 E F13.095 E F0 .596 +.463(First, the actions speci\214ed by the compspec are used.)108 511.2 +R .464(Only matches which are pre\214x)5.464 F .464(ed by the w)-.15 F +.464(ord being)-.1 F .596(completed are returned.)108 523.2 R .596 +(When the)5.596 F F13.096 E F0(or)3.095 E F13.095 E F0 .595 (option is used for \214lename or directory name completion, the)3.095 F (shell v)108 535.2 Q(ariable)-.25 E F3(FIGNORE)2.5 E F0 (is used to \214lter the matches.)2.25 E(An)108 552 Q 2.585(yc)-.15 G .085(ompletions speci\214ed by a \214lename e)-2.585 F .085 (xpansion pattern to the)-.15 F F12.585 E F0 .085 (option are generated ne)2.585 F 2.585(xt. The)-.15 F -.1(wo)2.585 G -(rds).1 E .843(generated by the pattern need not match the w)108 564 R -.844(ord being completed.)-.1 F(The)5.844 E F3(GLOBIGNORE)3.344 E F0 -.844(shell v)3.094 F .844(ariable is)-.25 F +(rds).1 E .844(generated by the pattern need not match the w)108 564 R +.844(ord being completed.)-.1 F(The)5.844 E F3(GLOBIGNORE)3.343 E F0 +.843(shell v)3.093 F .843(ariable is)-.25 F (not used to \214lter the matches, b)108 576 Q(ut the)-.2 E F3(FIGNORE) -2.5 E F0 -.25(va)2.25 G(riable is used.).25 E(Ne)108 592.8 Q .321 -(xt, the string speci\214ed as the ar)-.15 F .321(gument to the)-.18 F -F12.821 E F0 .32(option is considered.)2.821 F .32 -(The string is \214rst split using the)5.32 F .412(characters in the)108 -604.8 R F3(IFS)2.912 E F0 .412(special v)2.662 F .412 +2.5 E F0 -.25(va)2.25 G(riable is used.).25 E(Ne)108 592.8 Q .32 +(xt, the string speci\214ed as the ar)-.15 F .32(gument to the)-.18 F F1 +2.82 E F0 .321(option is considered.)2.821 F .321 +(The string is \214rst split using the)5.321 F .413(characters in the) +108 604.8 R F3(IFS)2.913 E F0 .412(special v)2.663 F .412 (ariable as delimiters.)-.25 F .412(Shell quoting is honored.)5.412 F -.413(Each w)5.412 F .413(ord is then e)-.1 F(xpanded)-.15 E 1.64 +.412(Each w)5.412 F .412(ord is then e)-.1 F(xpanded)-.15 E 1.64 (using brace e)108 616.8 R 1.64(xpansion, tilde e)-.15 F 1.64 (xpansion, parameter and v)-.15 F 1.64(ariable e)-.25 F 1.64 -(xpansion, command substitution, arith-)-.15 F 1.344(metic e)108 628.8 R -1.344(xpansion, and pathname e)-.15 F 1.344(xpansion, as described abo) +(xpansion, command substitution, arith-)-.15 F 1.345(metic e)108 628.8 R +1.345(xpansion, and pathname e)-.15 F 1.344(xpansion, as described abo) -.15 F 1.644 -.15(ve u)-.15 H(nder).15 E F3(EXP)3.844 E(ANSION)-.666 E -/F4 9/Times-Roman@0 SF(.)A F0 1.345(The results are split)5.844 F 1.265 +/F4 9/Times-Roman@0 SF(.)A F0 1.344(The results are split)5.844 F 1.265 (using the rules described abo)108 640.8 R 1.565 -.15(ve u)-.15 H(nder) .15 E F1 -.75(Wo)3.765 G 1.265(rd Splitting).75 F F0 6.265(.T)C 1.265 (he results of the e)-6.265 F 1.265(xpansion are pre\214x-matched)-.15 F (ag)108 652.8 Q(ainst the w)-.05 E (ord being completed, and the matching w)-.1 E -(ords become the possible completions.)-.1 E 1.237 -(After these matches ha)108 669.6 R 1.537 -.15(ve b)-.2 H 1.237 -(een generated, an).15 F 3.737(ys)-.15 G 1.238 -(hell function or command speci\214ed with the)-3.737 F F13.738 E -F0(and)3.738 E F13.738 E F0 .513(options is in)108 681.6 R -.2(vo) +(ords become the possible completions.)-.1 E 1.238 +(After these matches ha)108 669.6 R 1.538 -.15(ve b)-.2 H 1.238 +(een generated, an).15 F 3.738(ys)-.15 G 1.237 +(hell function or command speci\214ed with the)-3.738 F F13.737 E +F0(and)3.737 E F13.737 E F0 .513(options is in)108 681.6 R -.2(vo) -.4 G -.1(ke).2 G 3.013(d. When).1 F .513(the command or function is in) 3.013 F -.2(vo)-.4 G -.1(ke).2 G .513(d, the).1 F F3(COMP_LINE)3.013 E -F0(and)2.763 E F3(COMP_POINT)3.013 E F0 -.25(va)2.763 G(ri-).25 E .872 -(ables are assigned v)108 693.6 R .872(alues as described abo)-.25 F -1.172 -.15(ve u)-.15 H(nder).15 E F1 .873(Shell V)3.372 F(ariables)-.92 -E F0 5.873(.I)C 3.373(fas)-5.873 G .873(hell function is being in)-3.373 -F -.2(vo)-.4 G -.1(ke).2 G(d,).1 E(the)108 705.6 Q F3(COMP_W)5.261 E -(ORDS)-.09 E F0(and)5.011 E F3(COMP_CW)5.26 E(ORD)-.09 E F0 -.25(va)5.01 +F0(and)2.763 E F3(COMP_POINT)3.013 E F0 -.25(va)2.763 G(ri-).25 E .873 +(ables are assigned v)108 693.6 R .873(alues as described abo)-.25 F +1.173 -.15(ve u)-.15 H(nder).15 E F1 .872(Shell V)3.373 F(ariables)-.92 +E F0 5.872(.I)C 3.372(fas)-5.872 G .872(hell function is being in)-3.372 +F -.2(vo)-.4 G -.1(ke).2 G(d,).1 E(the)108 705.6 Q F3(COMP_W)5.26 E +(ORDS)-.09 E F0(and)5.01 E F3(COMP_CW)5.26 E(ORD)-.09 E F0 -.25(va)5.01 G 2.76(riables are also set.).25 F 2.76(When the function or command is) -7.76 F(in)108 717.6 Q -.2(vo)-.4 G -.1(ke).2 G .403(d, the \214rst ar).1 -F .404(gument is the name of the command whose ar)-.18 F .404 -(guments are being completed, the second)-.18 F(ar)108 729.6 Q 1.994 +7.76 F(in)108 717.6 Q -.2(vo)-.4 G -.1(ke).2 G .404(d, the \214rst ar).1 +F .404(gument is the name of the command whose ar)-.18 F .403 +(guments are being completed, the second)-.18 F(ar)108 729.6 Q 1.993 (gument is the w)-.18 F 1.993(ord being completed, and the third ar)-.1 -F 1.993(gument is the w)-.18 F 1.993(ord preceding the w)-.1 F 1.993 -(ord being)-.1 F(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(40)199.835 +F 1.993(gument is the w)-.18 F 1.993(ord preceding the w)-.1 F 1.994 +(ord being)-.1 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(40)199.835 E 0 Cg EP %%Page: 41 41 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E .499(completed on the current command line.)108 84 R .499 -(No \214ltering of the generated completions ag)5.499 F .5(ainst the w) --.05 F .5(ord being)-.1 F(completed is performed; the function or comma\ -nd has complete freedom in generating the matches.)108 96 Q(An)108 112.8 -Q 2.938(yf)-.15 G .437(unction speci\214ed with)-2.938 F/F1 10 -/Times-Bold@0 SF2.937 E F0 .437(is in)2.937 F -.2(vo)-.4 G -.1(ke) -.2 G 2.937<648c>.1 G 2.937(rst. The)-2.937 F .437(function may use an) -2.937 F 2.937(yo)-.15 G 2.937(ft)-2.937 G .437(he shell f)-2.937 F .437 -(acilities, including)-.1 F(the)108 124.8 Q F1(compgen)2.956 E F0 -.2 -(bu)2.956 G .456(iltin described belo).2 F 1.756 -.65(w, t)-.25 H 2.956 -(og).65 G .456(enerate the matches.)-2.956 F .457 +-.35 E .5(completed on the current command line.)108 84 R .499 +(No \214ltering of the generated completions ag)5.499 F .499 +(ainst the w)-.05 F .499(ord being)-.1 F(completed is performed; the fu\ +nction or command has complete freedom in generating the matches.)108 96 +Q(An)108 112.8 Q 2.937(yf)-.15 G .437(unction speci\214ed with)-2.937 F +/F1 10/Times-Bold@0 SF2.937 E F0 .437(is in)2.937 F -.2(vo)-.4 G +-.1(ke).2 G 2.937<648c>.1 G 2.937(rst. The)-2.937 F .437 +(function may use an)2.937 F 2.937(yo)-.15 G 2.937(ft)-2.937 G .437 +(he shell f)-2.937 F .438(acilities, including)-.1 F(the)108 124.8 Q F1 +(compgen)2.957 E F0 -.2(bu)2.957 G .457(iltin described belo).2 F 1.756 +-.65(w, t)-.25 H 2.956(og).65 G .456(enerate the matches.)-2.956 F .456 (It must put the possible completions in the)5.456 F/F2 9/Times-Bold@0 SF(COMPREPL)108 136.8 Q(Y)-.828 E F0(array v)2.25 E(ariable.)-.25 E(Ne) -108 153.6 Q .081(xt, an)-.15 F 2.581(yc)-.15 G .081 -(ommand speci\214ed with the)-2.581 F F12.581 E F0 .081 -(option is in)2.581 F -.2(vo)-.4 G -.1(ke).2 G 2.581(di).1 G 2.58(na) --2.581 G 2.58(ne)-2.58 G -.4(nv)-2.58 G .08(ironment equi).4 F -.25(va) --.25 G .08(lent to command sub-).25 F 2.858(stitution. It)108 165.6 R -.359(should print a list of completions, one per line, to the standard \ -output.)2.858 F .359(Backslash may be used)5.359 F(to escape a ne)108 -177.6 Q(wline, if necessary)-.25 E(.)-.65 E .377 +108 153.6 Q .08(xt, an)-.15 F 2.58(yc)-.15 G .08 +(ommand speci\214ed with the)-2.58 F F12.58 E F0 .081 +(option is in)2.581 F -.2(vo)-.4 G -.1(ke).2 G 2.581(di).1 G 2.581(na) +-2.581 G 2.581(ne)-2.581 G -.4(nv)-2.581 G .081(ironment equi).4 F -.25 +(va)-.25 G .081(lent to command sub-).25 F 2.859(stitution. It)108 165.6 +R .359(should print a list of completions, one per line, to the standar\ +d output.)2.859 F .358(Backslash may be used)5.359 F(to escape a ne)108 +177.6 Q(wline, if necessary)-.25 E(.)-.65 E .376 (After all of the possible completions are generated, an)108 194.4 R -2.877<798c>-.15 G .377(lter speci\214ed with the)-2.877 F F12.876 -E F0 .376(option is applied to the)2.876 F 3.181(list. The)108 206.4 R -.681(\214lter is a pattern as used for pathname e)3.181 F .681 -(xpansion; a)-.15 F F1(&)3.181 E F0 .682 -(in the pattern is replaced with the te)3.182 F .682(xt of)-.15 F .523 -(the w)108 218.4 R .523(ord being completed.)-.1 F 3.023(Al)5.523 G -(iteral)-3.023 E F1(&)3.023 E F0 .522 +2.877<798c>-.15 G .377(lter speci\214ed with the)-2.877 F F12.877 +E F0 .377(option is applied to the)2.877 F 3.182(list. The)108 206.4 R +.682(\214lter is a pattern as used for pathname e)3.182 F .681 +(xpansion; a)-.15 F F1(&)3.181 E F0 .681 +(in the pattern is replaced with the te)3.181 F .681(xt of)-.15 F .522 +(the w)108 218.4 R .522(ord being completed.)-.1 F 3.022(Al)5.522 G +(iteral)-3.022 E F1(&)3.022 E F0 .523 (may be escaped with a backslash; the backslash is remo)3.022 F -.15(ve) --.15 G 3.022(db).15 G(efore)-3.022 E .849(attempting a match.)108 230.4 -R(An)5.849 E 3.349(yc)-.15 G .849 -(ompletion that matches the pattern will be remo)-3.349 F -.15(ve)-.15 G -3.35(df).15 G .85(rom the list.)-3.35 F 3.35(Al)5.85 G(eading)-3.35 E F1 -(!)3.35 E F0(ne)108 242.4 Q -.05(ga)-.15 G +-.15 G 3.023(db).15 G(efore)-3.023 E .85(attempting a match.)108 230.4 R +(An)5.85 E 3.35(yc)-.15 G .849 +(ompletion that matches the pattern will be remo)-3.35 F -.15(ve)-.15 G +3.349(df).15 G .849(rom the list.)-3.349 F 3.349(Al)5.849 G(eading) +-3.349 E F1(!)3.349 E F0(ne)108 242.4 Q -.05(ga)-.15 G (tes the pattern; in this case an).05 E 2.5(yc)-.15 G (ompletion not matching the pattern will be remo)-2.5 E -.15(ve)-.15 G -(d.).15 E(Finally)108 259.2 Q 3.087(,a)-.65 G .887 -.15(ny p)-3.087 H -.587(re\214x and suf).15 F .587(\214x speci\214ed with the)-.25 F F1 +(d.).15 E(Finally)108 259.2 Q 3.086(,a)-.65 G .886 -.15(ny p)-3.086 H +.586(re\214x and suf).15 F .587(\214x speci\214ed with the)-.25 F F1 3.087 E F0(and)3.087 E F13.087 E F0 .587 (options are added to each member of the com-)3.087 F(pletion list, and\ the result is returned to the readline completion code as the list of \ -possible completions.)108 271.2 Q .246(If the pre)108 288 R .247 +possible completions.)108 271.2 Q .247(If the pre)108 288 R .247 (viously-applied actions do not generate an)-.25 F 2.747(ym)-.15 G .247 (atches, and the)-2.747 F F1 .247(\255o dir)2.747 F(names)-.15 E F0 .247 -(option w)2.747 F .247(as supplied to)-.1 F F1(complete)108 300 Q F0 +(option w)2.747 F .246(as supplied to)-.1 F F1(complete)108 300 Q F0 (when the compspec w)2.5 E -(as de\214ned, directory name completion is attempted.)-.1 E .462 -(If the)108 316.8 R F1 .462(\255o plusdirs)2.962 F F0 .462(option w) +(as de\214ned, directory name completion is attempted.)-.1 E .461 +(If the)108 316.8 R F1 .462(\255o plusdirs)2.961 F F0 .462(option w) 2.962 F .462(as supplied to)-.1 F F1(complete)2.962 E F0 .462 (when the compspec w)2.962 F .462(as de\214ned, directory name com-)-.1 F(pletion is attempted and an)108 328.8 Q 2.5(ym)-.15 G -(atches are added to the results of the other actions.)-2.5 E .559 -(By def)108 345.6 R .559(ault, if a compspec is found, whate)-.1 F -.15 -(ve)-.25 G 3.059(ri).15 G 3.059(tg)-3.059 G .56 -(enerates is returned to the completion code as the full set)-3.059 F -.632(of possible completions.)108 357.6 R .632(The def)5.632 F(ault)-.1 -E F1(bash)3.132 E F0 .631 -(completions are not attempted, and the readline def)3.131 F .631 -(ault of \214le-)-.1 F .558(name completion is disabled.)108 369.6 R -.558(If the)5.558 F F1 .559(\255o bashdefault)3.059 F F0 .559(option w) -3.059 F .559(as supplied to)-.1 F F1(complete)3.059 E F0 .559 -(when the compspec)3.059 F -.1(wa)108 381.6 S 3.172(sd).1 G .672 -(e\214ned, the)-3.172 F F1(bash)3.172 E F0(def)3.172 E .671 +(atches are added to the results of the other actions.)-2.5 E .56 +(By def)108 345.6 R .56(ault, if a compspec is found, whate)-.1 F -.15 +(ve)-.25 G 3.06(ri).15 G 3.06(tg)-3.06 G .559 +(enerates is returned to the completion code as the full set)-3.06 F +.631(of possible completions.)108 357.6 R .631(The def)5.631 F(ault)-.1 +E F1(bash)3.131 E F0 .631 +(completions are not attempted, and the readline def)3.131 F .632 +(ault of \214le-)-.1 F .559(name completion is disabled.)108 369.6 R +.559(If the)5.559 F F1 .559(\255o bashdefault)3.059 F F0 .559(option w) +3.059 F .559(as supplied to)-.1 F F1(complete)3.058 E F0 .558 +(when the compspec)3.058 F -.1(wa)108 381.6 S 3.171(sd).1 G .671 +(e\214ned, the)-3.171 F F1(bash)3.171 E F0(def)3.171 E .671 (ault completions are attempted if the compspec generates no matches.) --.1 F .671(If the)5.671 F F13.171 E(default)108 393.6 Q F0 1.207 -(option w)3.706 F 1.207(as supplied to)-.1 F F1(complete)3.707 E F0 +-.1 F .672(If the)5.672 F F13.172 E(default)108 393.6 Q F0 1.207 +(option w)3.707 F 1.207(as supplied to)-.1 F F1(complete)3.707 E F0 1.207(when the compspec w)3.707 F 1.207(as de\214ned, readline')-.1 F -3.707(sd)-.55 G(ef)-3.707 E 1.207(ault completion)-.1 F +3.707(sd)-.55 G(ef)-3.707 E 1.206(ault completion)-.1 F (will be performed if the compspec \(and, if attempted, the def)108 405.6 Q(ault)-.1 E F1(bash)2.5 E F0(completions\) generate no matches.) 2.5 E .245(When a compspec indicates that directory name completion is \ -desired, the programmable completion func-)108 422.4 R .632(tions force\ +desired, the programmable completion func-)108 422.4 R .633(tions force\ readline to append a slash to completed names which are symbolic links\ - to directories, subject)108 434.4 R 2.762(to the v)108 446.4 R 2.762 -(alue of the)-.25 F F1(mark\255dir)5.262 E(ectories)-.18 E F0 2.761 -(readline v)5.262 F 2.761(ariable, re)-.25 F -.05(ga)-.15 G 2.761 -(rdless of the setting of the).05 F F1(mark-sym-)5.261 E(link)108 458.4 + to directories, subject)108 434.4 R 2.761(to the v)108 446.4 R 2.761 +(alue of the)-.25 F F1(mark\255dir)5.261 E(ectories)-.18 E F0 2.761 +(readline v)5.261 F 2.761(ariable, re)-.25 F -.05(ga)-.15 G 2.762 +(rdless of the setting of the).05 F F1(mark-sym-)5.262 E(link)108 458.4 Q(ed\255dir)-.1 E(ectories)-.18 E F0(readline v)2.5 E(ariable.)-.25 E/F3 -10.95/Times-Bold@0 SF(HIST)72 475.2 Q(OR)-.197 E(Y)-.383 E F0 .371 -(When the)108 487.2 R F1 .371(\255o history)2.871 F F0 .371 -(option to the)2.871 F F1(set)2.872 E F0 -.2(bu)2.872 G .372 -(iltin is enabled, the shell pro).2 F .372(vides access to the)-.15 F/F4 -10/Times-Italic@0 SF .372(command history)2.872 F F0(,)A .032 +10.95/Times-Bold@0 SF(HIST)72 475.2 Q(OR)-.197 E(Y)-.383 E F0 .372 +(When the)108 487.2 R F1 .372(\255o history)2.872 F F0 .372 +(option to the)2.872 F F1(set)2.872 E F0 -.2(bu)2.872 G .372 +(iltin is enabled, the shell pro).2 F .371(vides access to the)-.15 F/F4 +10/Times-Italic@0 SF .371(command history)2.871 F F0(,)A .031 (the list of commands pre)108 499.2 R .031(viously typed.)-.25 F .031 (The v)5.031 F .031(alue of the)-.25 F F1(HISTSIZE)2.531 E F0 -.25(va) -2.531 G .031(riable is used as the number of com-).25 F .429 -(mands to sa)108 511.2 R .729 -.15(ve i)-.2 H 2.929(nah).15 G .429 -(istory list.)-2.929 F .429(The te)5.429 F .429(xt of the last)-.15 F F2 -(HISTSIZE)2.93 E F0 .43(commands \(def)2.68 F .43(ault 500\) is sa)-.1 F --.15(ve)-.2 G 2.93(d. The).15 F(shell)2.93 E .287 +2.531 G .031(riable is used as the number of com-).25 F .43(mands to sa) +108 511.2 R .73 -.15(ve i)-.2 H 2.93(nah).15 G .43(istory list.)-2.93 F +.43(The te)5.43 F .429(xt of the last)-.15 F F2(HISTSIZE)2.929 E F0 .429 +(commands \(def)2.679 F .429(ault 500\) is sa)-.1 F -.15(ve)-.2 G 2.929 +(d. The).15 F(shell)2.929 E .287 (stores each command in the history list prior to parameter and v)108 523.2 R .287(ariable e)-.25 F .287(xpansion \(see)-.15 F F2(EXP)2.787 E (ANSION)-.666 E F0(abo)2.537 E -.15(ve)-.15 G(\)).15 E -.2(bu)108 535.2 -S 4.065(ta).2 G 1.565(fter history e)-4.065 F 1.565 +S 4.066(ta).2 G 1.565(fter history e)-4.066 F 1.565 (xpansion is performed, subject to the v)-.15 F 1.565 (alues of the shell v)-.25 F(ariables)-.25 E F2(HISTIGNORE)4.065 E F0 -(and)3.816 E F2(HISTCONTR)108 547.2 Q(OL)-.27 E/F5 9/Times-Roman@0 SF(.) +(and)3.815 E F2(HISTCONTR)108 547.2 Q(OL)-.27 E/F5 9/Times-Roman@0 SF(.) A F0 .082 (On startup, the history is initialized from the \214le named by the v) -108 564 R(ariable)-.25 E F2(HISTFILE)2.582 E F0(\(def)2.332 E(ault)-.1 E -F4(~/.bash_history)2.582 E F0(\).)A .315(The \214le named by the v)108 +108 564 R(ariable)-.25 E F2(HISTFILE)2.583 E F0(\(def)2.333 E(ault)-.1 E +F4(~/.bash_history)2.583 E F0(\).)A .315(The \214le named by the v)108 576 R .315(alue of)-.25 F F2(HISTFILE)2.815 E F0 .315 (is truncated, if necessary)2.565 F 2.815(,t)-.65 G 2.815(oc)-2.815 G -.315(ontain no more than the number of)-2.815 F .953 +.315(ontain no more than the number of)-2.815 F .952 (lines speci\214ed by the v)108 588 R .953(alue of)-.25 F F2 (HISTFILESIZE)3.453 E F5(.)A F0 .953(When an interacti)5.453 F 1.253 -.15(ve s)-.25 H .953(hell e).15 F .953(xits, the last)-.15 F F2 -($HISTSIZE)3.452 E F0(lines)3.202 E .649 +($HISTSIZE)3.453 E F0(lines)3.203 E .65 (are copied from the history list to)108 600 R F2($HISTFILE)3.15 E F5(.) -A F0 .65(If the)5.15 F F1(histappend)3.15 E F0 .65 +A F0 .65(If the)5.15 F F1(histappend)3.15 E F0 .649 (shell option is enabled \(see the descrip-)3.15 F .141(tion of)108 612 R F1(shopt)2.641 E F0(under)2.641 E F2 .141(SHELL B)2.641 F(UIL)-.09 E .141(TIN COMMANDS)-.828 F F0(belo)2.391 E .141 (w\), the lines are appended to the history \214le, other)-.25 F(-)-.2 E -.572(wise the history \214le is o)108 624 R -.15(ve)-.15 G 3.073 +.573(wise the history \214le is o)108 624 R -.15(ve)-.15 G 3.073 (rwritten. If).15 F F2(HISTFILE)3.073 E F0 .573 (is unset, or if the history \214le is unwritable, the history is)2.823 -F 1.142(not sa)108 636 R -.15(ve)-.2 G 3.642(d. After).15 F(sa)3.642 E -1.142(ving the history)-.2 F 3.642(,t)-.65 G 1.141 -(he history \214le is truncated to contain no more than)-3.642 F F2 -(HISTFILESIZE)3.641 E F0 2.5(lines. If)108 648 R F2(HISTFILESIZE)2.5 E -F0(is not set, no truncation is performed.)2.25 E 1.293(The b)108 664.8 -R 1.293(uiltin command)-.2 F F1(fc)3.793 E F0(\(see)3.793 E F2 1.293 -(SHELL B)3.793 F(UIL)-.09 E 1.293(TIN COMMANDS)-.828 F F0(belo)3.543 E -1.294(w\) may be used to list or edit and re-)-.25 F -.15(exe)108 676.8 -S .674(cute a portion of the history list.).15 F(The)5.673 E F1(history) +F 1.141(not sa)108 636 R -.15(ve)-.2 G 3.641(d. After).15 F(sa)3.641 E +1.141(ving the history)-.2 F 3.641(,t)-.65 G 1.142 +(he history \214le is truncated to contain no more than)-3.641 F F2 +(HISTFILESIZE)3.642 E F0 2.5(lines. If)108 648 R F2(HISTFILESIZE)2.5 E +F0(is not set, no truncation is performed.)2.25 E 1.294(The b)108 664.8 +R 1.294(uiltin command)-.2 F F1(fc)3.794 E F0(\(see)3.794 E F2 1.293 +(SHELL B)3.794 F(UIL)-.09 E 1.293(TIN COMMANDS)-.828 F F0(belo)3.543 E +1.293(w\) may be used to list or edit and re-)-.25 F -.15(exe)108 676.8 +S .673(cute a portion of the history list.).15 F(The)5.673 E F1(history) 3.173 E F0 -.2(bu)3.173 G .673 -(iltin may be used to display or modify the history list).2 F .279 +(iltin may be used to display or modify the history list).2 F .28 (and manipulate the history \214le.)108 688.8 R .279 (When using command-line editing, search commands are a)5.279 F -.25(va) --.2 G .28(ilable in each).25 F(editing mode that pro)108 700.8 Q -(vide access to the history list.)-.15 E 1.486(The shell allo)108 717.6 -R 1.486(ws control o)-.25 F -.15(ve)-.15 G 3.986(rw).15 G 1.486 +-.2 G .279(ilable in each).25 F(editing mode that pro)108 700.8 Q +(vide access to the history list.)-.15 E 1.485(The shell allo)108 717.6 +R 1.485(ws control o)-.25 F -.15(ve)-.15 G 3.986(rw).15 G 1.486 (hich commands are sa)-3.986 F -.15(ve)-.2 G 3.986(do).15 G 3.986(nt) --3.986 G 1.486(he history list.)-3.986 F(The)6.485 E F2(HISTCONTR)3.985 -E(OL)-.27 E F0(and)3.735 E F2(HISTIGNORE)108 729.6 Q F0 -.25(va)2.707 G -.457(riables may be set to cause the shell to sa).25 F .758 -.15(ve o) --.2 H .458(nly a subset of the commands entered.).15 F(The)5.458 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(41)199.835 E 0 Cg EP +-3.986 G 1.486(he history list.)-3.986 F(The)6.486 E F2(HISTCONTR)3.986 +E(OL)-.27 E F0(and)3.736 E F2(HISTIGNORE)108 729.6 Q F0 -.25(va)2.708 G +.458(riables may be set to cause the shell to sa).25 F .757 -.15(ve o) +-.2 H .457(nly a subset of the commands entered.).15 F(The)5.457 E +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(41)199.835 E 0 Cg EP %%Page: 42 42 %%BeginPageSetup BP @@ -4855,72 +4860,72 @@ BP -.15(ve e)-.2 H .75(ach line of a multi-line command in).15 F 1.077 (the same history entry)108 96 R 3.577(,a)-.65 G 1.077 (dding semicolons where necessary to preserv)-3.577 F 3.577(es)-.15 G -1.077(yntactic correctness.)-3.577 F(The)6.077 E F1(lithist)3.577 E F0 -.374(shell option causes the shell to sa)108 108 R .674 -.15(ve t)-.2 H -.374(he command with embedded ne).15 F .373 -(wlines instead of semicolons.)-.25 F .373(See the)5.373 F .318 -(description of the)108 120 R F1(shopt)2.818 E F0 -.2(bu)2.818 G .318 +1.077(yntactic correctness.)-3.577 F(The)6.077 E F1(lithist)3.576 E F0 +.373(shell option causes the shell to sa)108 108 R .674 -.15(ve t)-.2 H +.374(he command with embedded ne).15 F .374 +(wlines instead of semicolons.)-.25 F .374(See the)5.374 F .319 +(description of the)108 120 R F1(shopt)2.819 E F0 -.2(bu)2.819 G .318 (iltin belo).2 F 2.818(wu)-.25 G(nder)-2.818 E/F2 9/Times-Bold@0 SF .318 -(SHELL B)2.818 F(UIL)-.09 E .318(TIN COMMANDS)-.828 F F0 .319 +(SHELL B)2.818 F(UIL)-.09 E .318(TIN COMMANDS)-.828 F F0 .318 (for information on setting and)2.568 F(unsetting shell options.)108 132 Q/F3 10.95/Times-Bold@0 SF(HIST)72 148.8 Q(OR)-.197 E 2.738(YE)-.383 G -(XP)-2.738 E(ANSION)-.81 E F0 .611(The shell supports a history e)108 +(XP)-2.738 E(ANSION)-.81 E F0 .61(The shell supports a history e)108 160.8 R .611(xpansion feature that is similar to the history e)-.15 F -.61(xpansion in)-.15 F F1(csh.)3.11 E F0 .61(This section)5.61 F .87 -(describes what syntax features are a)108 172.8 R -.25(va)-.2 G 3.371 -(ilable. This).25 F .871(feature is enabled by def)3.371 F .871 -(ault for interacti)-.1 F 1.171 -.15(ve s)-.25 H .871(hells, and).15 F -2.014(can be disabled using the)108 184.8 R F1(+H)4.514 E F0 2.014 +.611(xpansion in)-.15 F F1(csh.)3.111 E F0 .611(This section)5.611 F +.871(describes what syntax features are a)108 172.8 R -.25(va)-.2 G +3.371(ilable. This).25 F .871(feature is enabled by def)3.371 F .87 +(ault for interacti)-.1 F 1.17 -.15(ve s)-.25 H .87(hells, and).15 F +2.013(can be disabled using the)108 184.8 R F1(+H)4.514 E F0 2.014 (option to the)4.514 F F1(set)4.514 E F0 -.2(bu)4.514 G 2.014 -(iltin command \(see).2 F F2 2.013(SHELL B)4.513 F(UIL)-.09 E 2.013 +(iltin command \(see).2 F F2 2.014(SHELL B)4.514 F(UIL)-.09 E 2.014 (TIN COMMANDS)-.828 F F0(belo)108 196.8 Q 2.5(w\). Non-interacti)-.25 F .3 -.15(ve s)-.25 H(hells do not perform history e).15 E -(xpansion by def)-.15 E(ault.)-.1 E 1.305(History e)108 213.6 R 1.305 +(xpansion by def)-.15 E(ault.)-.1 E 1.306(History e)108 213.6 R 1.306 (xpansions introduce w)-.15 F 1.306(ords from the history list into the\ - input stream, making it easy to repeat)-.1 F .21 -(commands, insert the ar)108 225.6 R .21(guments to a pre)-.18 F .209 + input stream, making it easy to repeat)-.1 F .209 +(commands, insert the ar)108 225.6 R .209(guments to a pre)-.18 F .21 (vious command into the current input line, or \214x errors in pre)-.25 -F(vious)-.25 E(commands quickly)108 237.6 Q(.)-.65 E 1.163(History e)108 +F(vious)-.25 E(commands quickly)108 237.6 Q(.)-.65 E 1.164(History e)108 254.4 R 1.163(xpansion is performed immediately after a complete line i\ s read, before the shell breaks it into)-.15 F -.1(wo)108 266.4 S 3.2 (rds. It).1 F(tak)3.2 E .7(es place in tw)-.1 F 3.2(op)-.1 G 3.2 (arts. The)-3.2 F .7 (\214rst is to determine which line from the history list to use during) -3.2 F 4.367(substitution. The)108 278.4 R 1.868(second is to select por\ -tions of that line for inclusion into the current one.)4.367 F 1.868 -(The line)6.868 F .663(selected from the history is the)108 290.4 R/F4 -10/Times-Italic@0 SF -.15(ev)3.163 G(ent).15 E F0 3.163(,a)C .663 -(nd the portions of that line that are acted upon are)-3.163 F F4(wor) -3.162 E(ds)-.37 E F0 5.662(.V)C(arious)-6.772 E F4(modi\214er)108 302.4 -Q(s)-.1 E F0 .226(are a)2.726 F -.25(va)-.2 G .226 -(ilable to manipulate the selected w).25 F 2.726(ords. The)-.1 F .227 -(line is brok)2.726 F .227(en into w)-.1 F .227(ords in the same f)-.1 F -(ashion)-.1 E .352(as when reading input, so that se)108 314.4 R -.15 -(ve)-.25 G(ral).15 E F4(metac)2.852 E(har)-.15 E(acter)-.15 E F0 .351 -(-separated w)B .351(ords surrounded by quotes are considered)-.1 F .624 -(one w)108 326.4 R 3.124(ord. History)-.1 F -.15(ex)3.124 G .624 -(pansions are introduced by the appearance of the history e).15 F .625 -(xpansion character)-.15 F 3.125(,w)-.4 G(hich)-3.125 E(is)108 338.4 Q +3.2 F 4.368(substitution. The)108 278.4 R 1.868(second is to select por\ +tions of that line for inclusion into the current one.)4.368 F 1.867 +(The line)6.867 F .662(selected from the history is the)108 290.4 R/F4 +10/Times-Italic@0 SF -.15(ev)3.162 G(ent).15 E F0 3.162(,a)C .663 +(nd the portions of that line that are acted upon are)-3.162 F F4(wor) +3.163 E(ds)-.37 E F0 5.663(.V)C(arious)-6.773 E F4(modi\214er)108 302.4 +Q(s)-.1 E F0 .227(are a)2.727 F -.25(va)-.2 G .227 +(ilable to manipulate the selected w).25 F 2.727(ords. The)-.1 F .226 +(line is brok)2.726 F .226(en into w)-.1 F .226(ords in the same f)-.1 F +(ashion)-.1 E .351(as when reading input, so that se)108 314.4 R -.15 +(ve)-.25 G(ral).15 E F4(metac)2.852 E(har)-.15 E(acter)-.15 E F0 .352 +(-separated w)B .352(ords surrounded by quotes are considered)-.1 F .625 +(one w)108 326.4 R 3.125(ord. History)-.1 F -.15(ex)3.125 G .624 +(pansions are introduced by the appearance of the history e).15 F .624 +(xpansion character)-.15 F 3.124(,w)-.4 G(hich)-3.124 E(is)108 338.4 Q F1(!)3.333 E F0(by def)3.333 E 2.5(ault. Only)-.1 F(backslash \()2.5 E F1(\\).833 E F0 2.5(\)a).833 G(nd single quotes can quote the history e) -2.5 E(xpansion character)-.15 E(.)-.55 E(Se)108 355.2 Q -.15(ve)-.25 G .03(ral characters inhibit history e).15 F .03 (xpansion if found immediately follo)-.15 F .03(wing the history e)-.25 F .03(xpansion character)-.15 F(,)-.4 E -2.15 -.25(ev e)108 367.2 T -3.162(ni).25 G 3.162(fi)-3.162 G 3.162(ti)-3.162 G 3.162(su)-3.162 G +3.163(ni).25 G 3.163(fi)-3.163 G 3.162(ti)-3.163 G 3.162(su)-3.162 G .662(nquoted: space, tab, ne)-3.162 F .662(wline, carriage return, and) -.25 F F1(=)3.162 E F0 5.662(.I)C 3.162(ft)-5.662 G(he)-3.162 E F1 -(extglob)3.162 E F0 .662(shell option is enabled,)3.162 F F1(\()3.163 E +(extglob)3.162 E F0 .662(shell option is enabled,)3.162 F F1(\()3.162 E F0(will also inhibit e)108 379.2 Q(xpansion.)-.15 E(Se)108 396 Q -.15 -(ve)-.25 G .11(ral shell options settable with the).15 F F1(shopt)2.61 E -F0 -.2(bu)2.61 G .109(iltin may be used to tailor the beha).2 F .109 -(vior of history e)-.2 F(xpansion.)-.15 E 1.258(If the)108 408 R F1 -(histv)3.758 E(erify)-.1 E F0 1.259 -(shell option is enabled \(see the description of the)3.758 F F1(shopt) -3.759 E F0 -.2(bu)3.759 G 1.259(iltin\), and).2 F F1 -.18(re)3.759 G -(adline).18 E F0 1.259(is being)3.759 F 1.498(used, history substitutio\ -ns are not immediately passed to the shell parser)108 420 R 6.497(.I) --.55 G 1.497(nstead, the e)-6.497 F 1.497(xpanded line is)-.15 F 2.228 +(ve)-.25 G .109(ral shell options settable with the).15 F F1(shopt)2.609 +E F0 -.2(bu)2.609 G .11(iltin may be used to tailor the beha).2 F .11 +(vior of history e)-.2 F(xpansion.)-.15 E 1.259(If the)108 408 R F1 +(histv)3.759 E(erify)-.1 E F0 1.259 +(shell option is enabled \(see the description of the)3.759 F F1(shopt) +3.759 E F0 -.2(bu)3.759 G 1.259(iltin\), and).2 F F1 -.18(re)3.758 G +(adline).18 E F0 1.258(is being)3.758 F 1.497(used, history substitutio\ +ns are not immediately passed to the shell parser)108 420 R 6.498(.I) +-.55 G 1.498(nstead, the e)-6.498 F 1.498(xpanded line is)-.15 F 2.228 (reloaded into the)108 432 R F1 -.18(re)4.728 G(adline).18 E F0 2.228 (editing b)4.728 F(uf)-.2 E 2.228(fer for further modi\214cation.)-.25 F (If)7.228 E F1 -.18(re)4.728 G(adline).18 E F0 2.228 @@ -4928,11 +4933,11 @@ ns are not immediately passed to the shell parser)108 420 R 6.497(.I) (shell option is enabled, a f)3.702 F 1.202 (ailed history substitution will be reloaded into the)-.1 F F1 -.18(re) 3.702 G(adline).18 E F0(editing)3.702 E -.2(bu)108 456 S -.25(ff).2 G -1.16(er for correction.).25 F(The)6.16 E F13.66 E F0 1.16 -(option to the)3.66 F F1(history)3.66 E F0 -.2(bu)3.661 G 1.161 +1.161(er for correction.).25 F(The)6.161 E F13.661 E F0 1.161 +(option to the)3.661 F F1(history)3.661 E F0 -.2(bu)3.661 G 1.16 (iltin command may be used to see what a history).2 F -.15(ex)108 468 S -.056(pansion will do before using it.).15 F(The)5.056 E F12.556 E -F0 .056(option to the)2.556 F F1(history)2.555 E F0 -.2(bu)2.555 G .055 +.055(pansion will do before using it.).15 F(The)5.055 E F12.555 E +F0 .055(option to the)2.555 F F1(history)2.556 E F0 -.2(bu)2.556 G .056 (iltin may be used to add commands to the).2 F (end of the history list without actually e)108 480 Q -.15(xe)-.15 G (cuting them, so that the).15 E 2.5(ya)-.15 G(re a)-2.5 E -.25(va)-.2 G @@ -4943,9 +4948,9 @@ Q F1(histchars)2.5 E F0(abo)2.5 E .3 -.15(ve u)-.15 H(nder).15 E F1 (Shell V)2.5 E(ariables)-.92 E F0(\).)A F1(Ev)87 525.6 Q (ent Designators)-.1 E F0(An e)108 537.6 Q -.15(ve)-.25 G(nt designator\ is a reference to a command line entry in the history list.).15 E F1(!) -108 554.4 Q F0 1.608(Start a history substitution, e)32.67 F 1.608 +108 554.4 Q F0 1.607(Start a history substitution, e)32.67 F 1.607 (xcept when follo)-.15 F 1.607(wed by a)-.25 F F1(blank)4.107 E F0 4.107 -(,n)C -.25(ew)-4.107 G 1.607(line, carriage return, = or \().25 F +(,n)C -.25(ew)-4.107 G 1.608(line, carriage return, = or \().25 F (\(when the)144 566.4 Q F1(extglob)2.5 E F0 (shell option is enabled using the)2.5 E F1(shopt)2.5 E F0 -.2(bu)2.5 G (iltin\).).2 E F1(!)108 578.4 Q F4(n)A F0(Refer to command line)27.67 E @@ -4957,36 +4962,36 @@ A F0(Refer to the most recent command starting with)9.33 E F4(string)2.5 E F0(.).22 E F1(!?)108 626.4 Q F4(string)A F1([?])A F0 1.022 (Refer to the most recent command containing)144 638.4 R F4(string)3.522 E F0 6.022(.T).22 G 1.022(he trailing)-6.022 F F1(?)3.522 E F0 1.022 -(may be omitted if)3.522 F F4(string)3.862 E F0(is)3.742 E(follo)144 +(may be omitted if)3.522 F F4(string)3.861 E F0(is)3.741 E(follo)144 650.4 Q(wed immediately by a ne)-.25 E(wline.)-.25 E/F5 12/Times-Bold@0 SF(^)108 667.4 Q F4(string1)-5 I F5(^)5 I F4(string2)-5 I F5(^)5 I F0 -2.63(Quick substitution.)144 674.4 R 2.629 +2.629(Quick substitution.)144 674.4 R 2.629 (Repeat the last command, replacing)7.629 F F4(string1)5.469 E F0(with) 5.129 E F4(string2)5.129 E F0 7.629(.E).02 G(qui)-7.629 E -.25(va)-.25 G -2.629(lent to).25 F -.74(``)144 686.4 S(!!:s/).74 E F4(string1)A F0(/)A +2.63(lent to).25 F -.74(``)144 686.4 S(!!:s/).74 E F4(string1)A F0(/)A F4(string2)A F0(/')A 2.5('\()-.74 G(see)-2.5 E F1(Modi\214ers)2.5 E F0 (belo)2.5 E(w\).)-.25 E F1(!#)108 698.4 Q F0 (The entire command line typed so f)27.67 E(ar)-.1 E(.)-.55 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(42)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(42)199.835 E 0 Cg EP %%Page: 43 43 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Times-Bold@0 SF -.75(Wo)87 84 S(rd Designators).75 E F0 -.8 -(Wo)108 96 S 1.313(rd designators are used to select desired w).8 F +(Wo)108 96 S 1.314(rd designators are used to select desired w).8 F 1.314(ords from the e)-.1 F -.15(ve)-.25 G 3.814(nt. A).15 F F1(:)3.814 -E F0 1.314(separates the e)3.814 F -.15(ve)-.25 G 1.314 -(nt speci\214cation).15 F .53(from the w)108 108 R .529(ord designator) +E F0 1.313(separates the e)3.813 F -.15(ve)-.25 G 1.313 +(nt speci\214cation).15 F .529(from the w)108 108 R .529(ord designator) -.1 F 5.529(.I)-.55 G 3.029(tm)-5.529 G .529(ay be omitted if the w) -3.029 F .529(ord designator be)-.1 F .529(gins with a)-.15 F F1(^)3.029 E F0(,)A F1($)3.029 E F0(,)A F1(*)3.029 E F0(,)A F13.029 E F0 3.029 -(,o)C(r)-3.029 E F1(%)3.029 E F0 5.529(.W)C(ords)-6.329 E 1.3 -(are numbered from the be)108 120 R 1.3 -(ginning of the line, with the \214rst w)-.15 F 1.301 -(ord being denoted by 0 \(zero\).)-.1 F -.8(Wo)6.301 G 1.301(rds are).8 -F(inserted into the current line separated by single spaces.)108 132 Q -F1 2.5(0\()108 148.8 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 160.8 Q +(,o)C(r)-3.029 E F1(%)3.029 E F0 5.53(.W)C(ords)-6.33 E 1.301 +(are numbered from the be)108 120 R 1.301 +(ginning of the line, with the \214rst w)-.15 F 1.3 +(ord being denoted by 0 \(zero\).)-.1 F -.8(Wo)6.3 G 1.3(rds are).8 F +(inserted into the current line separated by single spaces.)108 132 Q F1 +2.5(0\()108 148.8 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 160.8 Q 2.5(ord. F)-.1 F(or the shell, this is the command w)-.15 E(ord.)-.1 E /F2 10/Times-Italic@0 SF(n)108.36 172.8 Q F0(The)30.64 E F2(n)2.5 E F0 (th w)A(ord.)-.1 E F1(^)108 184.8 Q F0(The \214rst ar)32.67 E 2.5 @@ -4995,10 +5000,10 @@ F1 2.5(0\()108 148.8 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 160.8 Q (ord matched by the most recent `?)-.1 E F2(string)A F0(?' search.)A F2 (x)108.77 220.8 Q F1A F2(y)A F0 2.5(Ar)20.65 G(ange of w)-2.5 E (ords; `\255)-.1 E F2(y)A F0 2.5('a)C(bbre)-2.5 E(viates `0\255)-.25 E -F2(y)A F0('.)A F1(*)108 232.8 Q F0 .316(All of the w)31 F .316(ords b) --.1 F .316(ut the zeroth.)-.2 F .315(This is a synon)5.315 F .315 +F2(y)A F0('.)A F1(*)108 232.8 Q F0 .315(All of the w)31 F .315(ords b) +-.1 F .315(ut the zeroth.)-.2 F .315(This is a synon)5.315 F .315 (ym for `)-.15 F F2(1\255$)A F0 2.815('. It)B .315 -(is not an error to use)2.815 F F1(*)2.815 E F0 .315(if there is)2.815 F +(is not an error to use)2.815 F F1(*)2.816 E F0 .316(if there is)2.816 F (just one w)144 244.8 Q(ord in the e)-.1 E -.15(ve)-.25 G (nt; the empty string is returned in that case.).15 E F1(x*)108 256.8 Q F0(Abbre)26 E(viates)-.25 E F2(x\255$)2.5 E F0(.)A F1<78ad>108 268.8 Q @@ -5006,10 +5011,10 @@ F0(Abbre)25.3 E(viates)-.25 E F2(x\255$)2.5 E F0(lik)2.5 E(e)-.1 E F1 (x*)2.5 E F0 2.5(,b)C(ut omits the last w)-2.7 E(ord.)-.1 E(If a w)108 285.6 Q(ord designator is supplied without an e)-.1 E -.15(ve)-.25 G (nt speci\214cation, the pre).15 E(vious command is used as the e)-.25 E --.15(ve)-.25 G(nt.).15 E F1(Modi\214ers)87 302.4 Q F0 .183 -(After the optional w)108 314.4 R .183(ord designator)-.1 F 2.683(,t)-.4 -G .184(here may appear a sequence of one or more of the follo)-2.683 F -.184(wing modi\214ers,)-.25 F(each preceded by a `:'.)108 326.4 Q F1(h) +-.15(ve)-.25 G(nt.).15 E F1(Modi\214ers)87 302.4 Q F0 .184 +(After the optional w)108 314.4 R .184(ord designator)-.1 F 2.684(,t)-.4 +G .183(here may appear a sequence of one or more of the follo)-2.684 F +.183(wing modi\214ers,)-.25 F(each preceded by a `:'.)108 326.4 Q F1(h) 108 343.2 Q F0(Remo)30.44 E .3 -.15(ve a t)-.15 H (railing \214le name component, lea).15 E(ving only the head.)-.2 E F1 (t)108 355.2 Q F0(Remo)32.67 E .3 -.15(ve a)-.15 H @@ -5024,45 +5029,45 @@ E -.15(xe)-.15 G(cute it.).15 E F1(q)108 403.2 Q F0 -.1 E F1(x)108 415.2 Q F0(Quote the substituted w)31 E(ords as with)-.1 E F1(q)2.5 E F0 2.5(,b)C(ut break into w)-2.7 E(ords at)-.1 E F1(blanks) 2.5 E F0(and ne)2.5 E(wlines.)-.25 E F1(s/)108 427.2 Q F2(old)A F1(/)A -F2(ne)A(w)-.15 E F1(/)A F0(Substitute)144 439.2 Q F2(ne)3.082 E(w)-.15 E -F0 .221(for the \214rst occurrence of)3.032 F F2(old)2.951 E F0 .221 +F2(ne)A(w)-.15 E F1(/)A F0(Substitute)144 439.2 Q F2(ne)3.081 E(w)-.15 E +F0 .221(for the \214rst occurrence of)3.031 F F2(old)2.951 E F0 .221 (in the e)3.491 F -.15(ve)-.25 G .221(nt line.).15 F(An)5.221 E 2.721 -(yd)-.15 G .221(elimiter can be used in place)-2.721 F .616(of /.)144 +(yd)-.15 G .221(elimiter can be used in place)-2.721 F .617(of /.)144 451.2 R .617 (The \214nal delimiter is optional if it is the last character of the e) -5.616 F -.15(ve)-.25 G .617(nt line.).15 F .617(The delimiter may)5.617 +5.617 F -.15(ve)-.25 G .617(nt line.).15 F .616(The delimiter may)5.616 F .666(be quoted in)144 463.2 R F2(old)3.396 E F0(and)3.936 E F2(ne) 3.526 E(w)-.15 E F0 .666(with a single backslash.)3.476 F .666 (If & appears in)5.666 F F2(ne)3.166 E(w)-.15 E F0 3.166(,i).31 G 3.166 (ti)-3.166 G 3.166(sr)-3.166 G .666(eplaced by)-3.166 F F2(old)3.166 E -F0 5.666(.A).77 G .274(single backslash will quote the &.)144 475.2 R -(If)5.274 E F2(old)3.004 E F0 .274(is null, it is set to the last)3.544 -F F2(old)3.005 E F0 .275(substituted, or)3.545 F 2.775(,i)-.4 G 2.775 -(fn)-2.775 G 2.775(op)-2.775 G(re)-2.775 E(vi-)-.25 E +F0 5.666(.A).77 G .275(single backslash will quote the &.)144 475.2 R +(If)5.275 E F2(old)3.004 E F0 .274(is null, it is set to the last)3.544 +F F2(old)3.004 E F0 .274(substituted, or)3.544 F 2.774(,i)-.4 G 2.774 +(fn)-2.774 G 2.774(op)-2.774 G(re)-2.774 E(vi-)-.25 E (ous history substitutions took place, the last)144 487.2 Q F2(string) 2.84 E F0(in a)2.72 E F1(!?)2.5 E F2(string)A F1([?])A F0(search.)5 E F1 (&)108 499.2 Q F0(Repeat the pre)27.67 E(vious substitution.)-.25 E F1 -(g)108 511.2 Q F0 .398(Cause changes to be applied o)31 F -.15(ve)-.15 G -2.898(rt).15 G .398(he entire e)-2.898 F -.15(ve)-.25 G .398(nt line.) -.15 F .397(This is used in conjunction with `)5.398 F F1(:s)A F0 2.897 -('\()C(e.g.,)-2.897 E(`)144 523.2 Q F1(:gs/)A F2(old)A F1(/)A F2(ne)A(w) --.15 E F1(/)A F0 1.218('\) or `)B F1(:&)A F0 3.718('. If)B 1.218 -(used with `)3.718 F F1(:s)A F0 1.218(', an)B 3.718(yd)-.15 G 1.219 -(elimiter can be used in place of /, and the \214nal)-3.718 F .09 +(g)108 511.2 Q F0 .397(Cause changes to be applied o)31 F -.15(ve)-.15 G +2.897(rt).15 G .398(he entire e)-2.897 F -.15(ve)-.25 G .398(nt line.) +.15 F .398(This is used in conjunction with `)5.398 F F1(:s)A F0 2.898 +('\()C(e.g.,)-2.898 E(`)144 523.2 Q F1(:gs/)A F2(old)A F1(/)A F2(ne)A(w) +-.15 E F1(/)A F0 1.219('\) or `)B F1(:&)A F0 3.719('. If)B 1.219 +(used with `)3.719 F F1(:s)A F0 1.218(', an)B 3.718(yd)-.15 G 1.218 +(elimiter can be used in place of /, and the \214nal)-3.718 F .089 (delimiter is optional if it is the last character of the e)144 535.2 R --.15(ve)-.25 G .089(nt line.).15 F(An)5.089 E F1(a)2.589 E F0 .089 -(may be used as a synon)2.589 F .089(ym for)-.15 F F1(g)144 547.2 Q F0 -(.)A F1(G)108 559.2 Q F0(Apply the follo)28.22 E(wing `)-.25 E F1(s)A F0 -2.5('m)C(odi\214er once to each w)-2.5 E(ord in the e)-.1 E -.15(ve)-.25 -G(nt line.).15 E/F3 10.95/Times-Bold@0 SF(SHELL B)72 576 Q(UIL)-.11 E -(TIN COMMANDS)-1.007 E F0 .062(Unless otherwise noted, each b)108 588 R +-.15(ve)-.25 G .09(nt line.).15 F(An)5.09 E F1(a)2.59 E F0 .09 +(may be used as a synon)2.59 F .09(ym for)-.15 F F1(g)144 547.2 Q F0(.)A +F1(G)108 559.2 Q F0(Apply the follo)28.22 E(wing `)-.25 E F1(s)A F0 2.5 +('m)C(odi\214er once to each w)-2.5 E(ord in the e)-.1 E -.15(ve)-.25 G +(nt line.).15 E/F3 10.95/Times-Bold@0 SF(SHELL B)72 576 Q(UIL)-.11 E +(TIN COMMANDS)-1.007 E F0 .063(Unless otherwise noted, each b)108 588 R .062(uiltin command documented in this section as accepting options pre\ ceded by)-.2 F F1108 600 Q F0(accepts)2.5 E F12.5 E F0 (to signify the end of the options.)2.5 E F1(:)108 618 Q F0([)2.5 E F2 -(ar)A(guments)-.37 E F0(])A .452(No ef)144 630 R .452 +(ar)A(guments)-.37 E F0(])A .451(No ef)144 630 R .451 (fect; the command does nothing be)-.25 F .452(yond e)-.15 F(xpanding) --.15 E F2(ar)3.282 E(guments)-.37 E F0 .451(and performing an)3.221 F -2.951(ys)-.15 G(peci\214ed)-2.951 E 2.5(redirections. A)144 642 R +-.15 E F2(ar)3.282 E(guments)-.37 E F0 .452(and performing an)3.222 F +2.952(ys)-.15 G(peci\214ed)-2.952 E 2.5(redirections. A)144 642 R (zero e)2.5 E(xit code is returned.)-.15 E F1(.)110.5 658.8 Q F2 (\214lename)6.666 E F0([)2.5 E F2(ar)A(guments)-.37 E F0(])A F1(sour)108 670.8 Q(ce)-.18 E F2(\214lename)2.5 E F0([)2.5 E F2(ar)A(guments)-.37 E @@ -5075,36 +5080,36 @@ F0(])A 1.02(Read and e)144 682.8 R -.15(xe)-.15 G 1.02 (names in)144 706.8 R/F4 9/Times-Bold@0 SF -.666(PA)3.108 G(TH)-.189 E F0 .608(are used to \214nd the directory containing)2.858 F F2 (\214lename)3.108 E F0 5.608(.T).18 G .608(he \214le searched for in) --5.608 F F4 -.666(PA)3.108 G(TH)-.189 E F0 .833(need not be e)144 718.8 -R -.15(xe)-.15 G 3.333(cutable. When).15 F F1(bash)3.333 E F0 .832 -(is not in)3.333 F F2 .832(posix mode)3.332 F F0 3.332(,t)C .832 -(he current directory is searched if no)-3.332 F .981 +-5.608 F F4 -.666(PA)3.108 G(TH)-.189 E F0 .832(need not be e)144 718.8 +R -.15(xe)-.15 G 3.332(cutable. When).15 F F1(bash)3.332 E F0 .832 +(is not in)3.332 F F2 .832(posix mode)3.332 F F0 3.332(,t)C .833 +(he current directory is searched if no)-3.332 F .982 (\214le is found in)144 730.8 R F4 -.666(PA)3.481 G(TH)-.189 E/F5 9 /Times-Roman@0 SF(.)A F0 .981(If the)5.481 F F1(sour)3.481 E(cepath)-.18 E F0 .981(option to the)3.481 F F1(shopt)3.481 E F0 -.2(bu)3.481 G .981 -(iltin command is turned of).2 F .982(f, the)-.25 F(GNU Bash-3.0)72 768 -Q(2004 Jan 24)149.845 E(43)199.835 E 0 Cg EP +(iltin command is turned of).2 F .981(f, the)-.25 F(GNU Bash-3.0)72 768 +Q(2004 Jan 28)149.845 E(43)199.835 E 0 Cg EP %%Page: 44 44 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 9/Times-Bold@0 SF -.666(PA)144 84 S(TH)-.189 E F0 .112 -(is not searched.)2.363 F .112(If an)5.112 F(y)-.15 E/F2 10 +(is not searched.)2.362 F .112(If an)5.112 F(y)-.15 E/F2 10 /Times-Italic@0 SF(ar)2.612 E(guments)-.37 E F0 .112(are supplied, the) 2.612 F 2.612(yb)-.15 G .112(ecome the positional parameters when)-2.612 -F F2(\214lename)144 96 Q F0 .341(is e)2.841 F -.15(xe)-.15 G 2.841 -(cuted. Otherwise).15 F .341(the positional parameters are unchanged.) -2.841 F .342(The return status is the)5.342 F .716 +F F2(\214lename)144 96 Q F0 .342(is e)2.842 F -.15(xe)-.15 G 2.842 +(cuted. Otherwise).15 F .342(the positional parameters are unchanged.) +2.842 F .341(The return status is the)5.341 F .716 (status of the last command e)144 108 R .716 (xited within the script \(0 if no commands are e)-.15 F -.15(xe)-.15 G -.716(cuted\), and f).15 F .715(alse if)-.1 F F2(\214lename)145.91 120 Q +.716(cuted\), and f).15 F .716(alse if)-.1 F F2(\214lename)145.91 120 Q F0(is not found or cannot be read.)2.68 E/F3 10/Times-Bold@0 SF(alias) 108 136.8 Q F0([)2.5 E F3A F0 2.5(][)C F2(name)-2.5 E F0([=)A F2 -(value)A F0 2.5(].)C(..])-2.5 E F3(Alias)144 148.8 Q F0 2.724 -(with no ar)5.224 F 2.724(guments or with the)-.18 F F35.224 E F0 +(value)A F0 2.5(].)C(..])-2.5 E F3(Alias)144 148.8 Q F0 2.725 +(with no ar)5.225 F 2.724(guments or with the)-.18 F F35.224 E F0 2.724(option prints the list of aliases in the form)5.224 F F3(alias) -5.225 E F2(name)144 160.8 Q F0(=)A F2(value)A F0 .58 +5.224 E F2(name)144 160.8 Q F0(=)A F2(value)A F0 .58 (on standard output.)3.08 F .58(When ar)5.58 F .58 (guments are supplied, an alias is de\214ned for each)-.18 F F2(name) 3.08 E F0(whose)144 172.8 Q F2(value)2.895 E F0 .395(is gi)2.895 F -.15 @@ -5113,19 +5118,19 @@ F0(is not found or cannot be read.)2.68 E/F3 10/Times-Bold@0 SF(alias) (ord to be check)-.1 F .395(ed for alias sub-)-.1 F .054 (stitution when the alias is e)144 184.8 R 2.554(xpanded. F)-.15 F .054 (or each)-.15 F F2(name)2.554 E F0 .054(in the ar)2.554 F .054 -(gument list for which no)-.18 F F2(value)2.554 E F0 .053(is sup-)2.553 -F 1.313(plied, the name and v)144 196.8 R 1.314 +(gument list for which no)-.18 F F2(value)2.554 E F0 .054(is sup-)2.554 +F 1.314(plied, the name and v)144 196.8 R 1.314 (alue of the alias is printed.)-.25 F F3(Alias)6.314 E F0 1.314 -(returns true unless a)3.814 F F2(name)3.814 E F0 1.314(is gi)3.814 F --.15(ve)-.25 G 3.814(nf).15 G(or)-3.814 E +(returns true unless a)3.814 F F2(name)3.814 E F0 1.313(is gi)3.814 F +-.15(ve)-.25 G 3.813(nf).15 G(or)-3.813 E (which no alias has been de\214ned.)144 208.8 Q F3(bg)108 225.6 Q F0([) -2.5 E F2(jobspec)A F0(])A .357(Resume the suspended job)144 237.6 R F2 -(jobspec)2.857 E F0 .356 -(in the background, as if it had been started with)2.857 F F3(&)2.856 E -F0 5.356(.I)C(f)-5.356 E F2(jobspec)2.856 E F0 .472 +2.5 E F2(jobspec)A F0(])A .356(Resume the suspended job)144 237.6 R F2 +(jobspec)2.856 E F0 .357 +(in the background, as if it had been started with)2.856 F F3(&)2.857 E +F0 5.357(.I)C(f)-5.357 E F2(jobspec)2.857 E F0 .473 (is not present, the shell')144 249.6 R 2.973(sn)-.55 G .473 (otion of the)-2.973 F F2(curr)2.973 E .473(ent job)-.37 F F0 .473 -(is used.)2.973 F F3(bg)5.473 E F2(jobspec)4.713 E F0 .473 +(is used.)2.973 F F3(bg)5.473 E F2(jobspec)4.713 E F0 .472 (returns 0 unless run when)3.283 F .663(job control is disabled or)144 261.6 R 3.163(,w)-.4 G .663(hen run with job control enabled, if)-3.163 F F2(jobspec)3.163 E F0 -.1(wa)3.163 G 3.163(sn).1 G .663 @@ -5140,29 +5145,29 @@ F2 -.1(ke)2.5 G(ymap)-.2 E F0(])A F32.5 E F2(\214lename)2.5 E F3 F32.5 E F2 -.1(ke)2.5 G(yseq)-.2 E F0(:)A F2(shell\255command)A F3 (bind)108 338.4 Q F0([)2.5 E F3A F2 -.1(ke)2.5 G(ymap)-.2 E F0(])A F2 -.1(ke)2.5 G(yseq)-.2 E F0(:)A F2(function\255name)A F3(bind)108 -350.4 Q F2 -.37(re)2.5 G(adline\255command).37 E F0 .238 -(Display current)144 362.4 R F3 -.18(re)2.738 G(adline).18 E F0 -.1(ke) -2.738 G 2.738(ya)-.05 G .239(nd function bindings, bind a k)-2.738 F -.539 -.15(ey s)-.1 H .239(equence to a).15 F F3 -.18(re)2.739 G(adline) -.18 E F0 .239(function or)2.739 F .476(macro, or set a)144 374.4 R F3 --.18(re)2.976 G(adline).18 E F0 -.25(va)2.976 G 2.976(riable. Each).25 F -.476(non-option ar)2.976 F .475(gument is a command as it w)-.18 F .475 -(ould appear in)-.1 F F2(.inputr)144 386.4 Q(c)-.37 E F0 2.983(,b).31 G -.484(ut each binding or command must be passed as a separate ar)-3.183 F -.484(gument; e.g., '"\\C\255x\\C\255r":)-.18 F 2.5 +350.4 Q F2 -.37(re)2.5 G(adline\255command).37 E F0 .239 +(Display current)144 362.4 R F3 -.18(re)2.739 G(adline).18 E F0 -.1(ke) +2.739 G 2.739(ya)-.05 G .239(nd function bindings, bind a k)-2.739 F +.539 -.15(ey s)-.1 H .238(equence to a).15 F F3 -.18(re)2.738 G(adline) +.18 E F0 .238(function or)2.738 F .475(macro, or set a)144 374.4 R F3 +-.18(re)2.975 G(adline).18 E F0 -.25(va)2.975 G 2.975(riable. Each).25 F +.476(non-option ar)2.976 F .476(gument is a command as it w)-.18 F .476 +(ould appear in)-.1 F F2(.inputr)144 386.4 Q(c)-.37 E F0 2.984(,b).31 G +.484(ut each binding or command must be passed as a separate ar)-3.184 F +.483(gument; e.g., '"\\C\255x\\C\255r":)-.18 F 2.5 (re\255read\255init\255\214le'. Options,)144 398.4 R(if supplied, ha)2.5 E .3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:)-.25 E F3144 -410.4 Q F2 -.1(ke)2.5 G(ymap)-.2 E F0(Use)180 422.4 Q F2 -.1(ke)5.159 G -(ymap)-.2 E F0 2.659(as the k)5.349 F -.15(ey)-.1 G 2.658(map to be af) -.15 F 2.658(fected by the subsequent bindings.)-.25 F(Acceptable)7.658 E -F2 -.1(ke)180 434.4 S(ymap)-.2 E F0 3.192(names are)5.882 F F2 3.192 -(emacs, emacs\255standar)5.692 F 3.193 +410.4 Q F2 -.1(ke)2.5 G(ymap)-.2 E F0(Use)180 422.4 Q F2 -.1(ke)5.158 G +(ymap)-.2 E F0 2.658(as the k)5.348 F -.15(ey)-.1 G 2.658(map to be af) +.15 F 2.659(fected by the subsequent bindings.)-.25 F(Acceptable)7.659 E +F2 -.1(ke)180 434.4 S(ymap)-.2 E F0 3.193(names are)5.883 F F2 3.193 +(emacs, emacs\255standar)5.693 F 3.192 (d, emacs\255meta, emacs\255ctlx, vi, vi\255mo)-.37 F(ve)-.1 E(,)-.1 E -(vi\255command)180 446.4 Q F0 4.43(,a)C(nd)-4.43 E F2(vi\255insert)4.429 -E F0(.).68 E F2(vi)6.929 E F0 1.929(is equi)4.429 F -.25(va)-.25 G 1.929 -(lent to).25 F F2(vi\255command)4.429 E F0(;)A F2(emacs)4.429 E F0 1.929 -(is equi)4.429 F -.25(va)-.25 G 1.929(lent to).25 F F2(emacs\255standar) -180 458.4 Q(d)-.37 E F0(.)A F3144 470.4 Q F0 +(vi\255command)180 446.4 Q F0 4.429(,a)C(nd)-4.429 E F2(vi\255insert) +4.429 E F0(.).68 E F2(vi)6.929 E F0 1.929(is equi)4.429 F -.25(va)-.25 G +1.929(lent to).25 F F2(vi\255command)4.429 E F0(;)A F2(emacs)4.429 E F0 +1.929(is equi)4.429 F -.25(va)-.25 G 1.93(lent to).25 F F2 +(emacs\255standar)180 458.4 Q(d)-.37 E F0(.)A F3144 470.4 Q F0 (List the names of all)27.52 E F3 -.18(re)2.5 G(adline).18 E F0 (functions.)2.5 E F3144 482.4 Q F0(Display)24.74 E F3 -.18(re)2.5 G(adline).18 E F0(function names and bindings in such a w)2.5 E @@ -5195,30 +5200,30 @@ F2 -.1(ke)2.5 G(yseq)-.2 E F0(Remo)180 650.4 Q .3 -.15(ve a)-.15 H .3 F2 -.1(ke)2.5 G(yseq)-.2 E F0(is entered.)2.5 E(The return v)144 691.2 Q (alue is 0 unless an unrecognized option is gi)-.25 E -.15(ve)-.25 G 2.5 (no).15 G 2.5(ra)-2.5 G 2.5(ne)-2.5 G(rror occurred.)-2.5 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(44)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(44)199.835 E 0 Cg EP %%Page: 45 45 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Times-Bold@0 SF(br)108 84 Q(eak)-.18 E F0([)2.5 E/F2 10 -/Times-Italic@0 SF(n)A F0(])A .055(Exit from within a)144 96 R F1 -.25 -(fo)2.555 G(r).25 E F0(,)A F1(while)2.555 E F0(,)A F1(until)2.555 E F0 +/Times-Italic@0 SF(n)A F0(])A .054(Exit from within a)144 96 R F1 -.25 +(fo)2.554 G(r).25 E F0(,)A F1(while)2.554 E F0(,)A F1(until)2.555 E F0 2.555(,o)C(r)-2.555 E F1(select)2.555 E F0 2.555(loop. If)2.555 F F2(n) 2.555 E F0 .055(is speci\214ed, break)2.555 F F2(n)2.555 E F0(le)2.555 E --.15(ve)-.25 G(ls.).15 E F2(n)5.414 E F0 .054(must be)2.794 F/F3 10 -/Symbol SF2.554 E F0(1.)2.554 E(If)144 108 Q F2(n)3.074 E F0 .215(i\ +-.15(ve)-.25 G(ls.).15 E F2(n)5.415 E F0 .055(must be)2.795 F/F3 10 +/Symbol SF2.555 E F0(1.)2.555 E(If)144 108 Q F2(n)3.075 E F0 .215(i\ s greater than the number of enclosing loops, all enclosing loops are e) -2.954 F 2.715(xited. The)-.15 F .215(return v)2.715 F(alue)-.25 E +2.955 F 2.714(xited. The)-.15 F .214(return v)2.714 F(alue)-.25 E (is 0 unless the shell is not e)144 120 Q -.15(xe)-.15 G (cuting a loop when).15 E F1(br)2.5 E(eak)-.18 E F0(is e)2.5 E -.15(xe) -.15 G(cuted.).15 E F1 -.2(bu)108 136.8 S(iltin).2 E F2(shell\255b)2.5 E (uiltin)-.2 E F0([)2.5 E F2(ar)A(guments)-.37 E F0(])A(Ex)144 148.8 Q -.793(ecute the speci\214ed shell b)-.15 F .793(uiltin, passing it)-.2 F +.792(ecute the speci\214ed shell b)-.15 F .792(uiltin, passing it)-.2 F F2(ar)3.293 E(guments)-.37 E F0 3.293(,a).27 G .793(nd return its e) --3.293 F .792(xit status.)-.15 F .792(This is useful)5.792 F .615 +-3.293 F .793(xit status.)-.15 F .793(This is useful)5.793 F .616 (when de\214ning a function whose name is the same as a shell b)144 -160.8 R .616(uiltin, retaining the functionality of)-.2 F .57(the b)144 +160.8 R .615(uiltin, retaining the functionality of)-.2 F .57(the b)144 172.8 R .57(uiltin within the function.)-.2 F(The)5.57 E F1(cd)3.07 E F0 -.2(bu)3.07 G .57(iltin is commonly rede\214ned this w).2 F(ay)-.1 E 5.57(.T)-.65 G .57(he return status)-5.57 F(is f)144 184.8 Q(alse if)-.1 @@ -5228,88 +5233,88 @@ E F2(shell\255b)2.84 E(uiltin)-.2 E F0(is not a shell b)2.74 E R F2(dir)2.71 E F0 5.21(.T)C .21(he v)-5.21 F(ariable)-.25 E/F4 9 /Times-Bold@0 SF(HOME)2.71 E F0 .21(is the def)2.46 F(ault)-.1 E F2(dir) 2.71 E F0 5.21(.T).73 G .21(he v)-5.21 F(ariable)-.25 E F4(CDP)2.71 E --.855(AT)-.666 G(H).855 E F0 .777 +-.855(AT)-.666 G(H).855 E F0 .776 (de\214nes the search path for the directory containing)144 225.6 R F2 -(dir)3.276 E F0 5.776(.A).73 G(lternati)-5.776 E 1.076 -.15(ve d)-.25 H -.776(irectory names in).15 F F4(CDP)3.276 E -.855(AT)-.666 G(H).855 E F0 +(dir)3.276 E F0 5.777(.A).73 G(lternati)-5.777 E 1.077 -.15(ve d)-.25 H +.777(irectory names in).15 F F4(CDP)3.277 E -.855(AT)-.666 G(H).855 E F0 .764(are separated by a colon \(:\).)144 237.6 R 3.264(An)5.764 G .764 (ull directory name in)-3.264 F F4(CDP)3.264 E -.855(AT)-.666 G(H).855 E -F0 .764(is the same as the current direc-)3.014 F(tory)144 249.6 Q 2.974 -(,i)-.65 G .474(.e., `)-2.974 F(`)-.74 E F1(.)A F0 -.74('')C 5.474(.I) -.74 G(f)-5.474 E F2(dir)3.324 E F0(be)3.704 E .474 +F0 .764(is the same as the current direc-)3.014 F(tory)144 249.6 Q 2.973 +(,i)-.65 G .473(.e., `)-2.973 F(`)-.74 E F1(.)A F0 -.74('')C 5.473(.I) +.74 G(f)-5.473 E F2(dir)3.323 E F0(be)3.703 E .474 (gins with a slash \(/\), then)-.15 F F4(CDP)2.974 E -.855(AT)-.666 G(H) -.855 E F0 .473(is not used. The)2.724 F F12.973 E F0 .473 -(option says to use)2.973 F .579(the ph)144 261.6 R .579 +.855 E F0 .474(is not used. The)2.724 F F12.974 E F0 .474 +(option says to use)2.974 F .58(the ph)144 261.6 R .58 (ysical directory structure instead of follo)-.05 F .579 -(wing symbolic links \(see also the)-.25 F F13.08 E F0 .58 -(option to the)3.08 F F1(set)144 273.6 Q F0 -.2(bu)3.384 G .884 -(iltin command\); the).2 F F13.384 E F0 .884 +(wing symbolic links \(see also the)-.25 F F13.079 E F0 .579 +(option to the)3.079 F F1(set)144 273.6 Q F0 -.2(bu)3.383 G .883 +(iltin command\); the).2 F F13.383 E F0 .884 (option forces symbolic links to be follo)3.384 F 3.384(wed. An)-.25 F -(ar)3.383 E .883(gument of)-.18 F F13.383 E F0(is)3.383 E(equi)144 -285.6 Q -.25(va)-.25 G .062(lent to).25 F F4($OLDPWD)2.562 E/F5 9 -/Times-Roman@0 SF(.)A F0 .062(If a non-empty directory name from)4.562 F -F1(CDP)2.562 E -.95(AT)-.74 G(H).95 E F0 .063(is used, or if)2.562 F F1 -2.563 E F0 .063(is the \214rst)2.563 F(ar)144 297.6 Q .116(gument, \ +(ar)3.384 E .884(gument of)-.18 F F13.384 E F0(is)3.384 E(equi)144 +285.6 Q -.25(va)-.25 G .063(lent to).25 F F4($OLDPWD)2.563 E/F5 9 +/Times-Roman@0 SF(.)A F0 .063(If a non-empty directory name from)4.563 F +F1(CDP)2.562 E -.95(AT)-.74 G(H).95 E F0 .062(is used, or if)2.562 F F1 +2.562 E F0 .062(is the \214rst)2.562 F(ar)144 297.6 Q .116(gument, \ and the directory change is successful, the absolute pathname of the ne) --.18 F 2.615(ww)-.25 G .115(orking direc-)-2.715 F 1.164 +-.18 F 2.616(ww)-.25 G .116(orking direc-)-2.716 F 1.165 (tory is written to the standard output.)144 309.6 R 1.164(The return v) -6.164 F 1.165(alue is true if the directory w)-.25 F 1.165 +6.164 F 1.164(alue is true if the directory w)-.25 F 1.164 (as successfully)-.1 F(changed; f)144 321.6 Q(alse otherwise.)-.1 E F1 -(caller)108 338.4 Q F0([)2.5 E F2 -.2(ex)C(pr).2 E F0(])A .254 +(caller)108 338.4 Q F0([)2.5 E F2 -.2(ex)C(pr).2 E F0(])A .253 (Returns the conte)144 350.4 R .254(xt of an)-.15 F 2.754(ya)-.15 G(cti) -2.754 E .554 -.15(ve s)-.25 H .254 (ubroutine call \(a shell function or a script e).15 F -.15(xe)-.15 G -.254(cuted with the).15 F F1(.)2.753 E F0(or)2.753 E F1(sour)144 362.4 Q -(ce)-.18 E F0 -.2(bu)3.062 G 3.062(iltins. W).2 F(ithout)-.4 E F2 -.2 +.254(cuted with the).15 F F1(.)2.754 E F0(or)2.754 E F1(sour)144 362.4 Q +(ce)-.18 E F0 -.2(bu)3.063 G 3.063(iltins. W).2 F(ithout)-.4 E F2 -.2 (ex)3.062 G(pr).2 E F0(,)A F1(caller)3.062 E F0 .562 (displays the line number and source \214lename of the current)3.062 F -.254(subroutine call.)144 374.4 R .254(If a non-ne)5.254 F -.05(ga)-.15 -G(ti).05 E .554 -.15(ve i)-.25 H(nte).15 E .253(ger is supplied as)-.15 -F F2 -.2(ex)2.753 G(pr).2 E F0(,)A F1(caller)2.753 E F0 .253 -(displays the line number)2.753 F 2.753(,s)-.4 G(ub-)-2.753 E 1.327(rou\ +.253(subroutine call.)144 374.4 R .253(If a non-ne)5.253 F -.05(ga)-.15 +G(ti).05 E .553 -.15(ve i)-.25 H(nte).15 E .253(ger is supplied as)-.15 +F F2 -.2(ex)2.753 G(pr).2 E F0(,)A F1(caller)2.753 E F0 .254 +(displays the line number)2.754 F 2.754(,s)-.4 G(ub-)-2.754 E 1.327(rou\ tine name, and source \214le corresponding to that position in the curr\ -ent e)144 386.4 R -.15(xe)-.15 G 1.328(cution call stack.).15 F .001 -(This e)144 398.4 R .001(xtra information may be used, for e)-.15 F .001 -(xample, to print a stack trace.)-.15 F(The current frame is frame)5 E -3.019(0. The)144 410.4 R .519(return v)3.019 F .519 -(alue is 0 unless the shell is not e)-.25 F -.15(xe)-.15 G .52 -(cuting a subroutine call or).15 F F2 -.2(ex)3.02 G(pr).2 E F0 .52 -(does not corre-)3.02 F(spond to a v)144 422.4 Q +ent e)144 386.4 R -.15(xe)-.15 G 1.327(cution call stack.).15 F(This e) +144 398.4 Q(xtra information may be used, for e)-.15 E .001 +(xample, to print a stack trace.)-.15 F .001(The current frame is frame) +5.001 F 3.02(0. The)144 410.4 R .52(return v)3.02 F .52 +(alue is 0 unless the shell is not e)-.25 F -.15(xe)-.15 G .519 +(cuting a subroutine call or).15 F F2 -.2(ex)3.019 G(pr).2 E F0 .519 +(does not corre-)3.019 F(spond to a v)144 422.4 Q (alid position in the call stack.)-.25 E F1(command)108 439.2 Q F0([)2.5 E F1(\255pVv)A F0(])A F2(command)2.5 E F0([)2.5 E F2(ar)A(g)-.37 E F0 -(...])2.5 E(Run)144 451.2 Q F2(command)2.957 E F0(with)3.527 E F2(ar) +(...])2.5 E(Run)144 451.2 Q F2(command)2.956 E F0(with)3.527 E F2(ar) 3.087 E(gs)-.37 E F0 .257 (suppressing the normal shell function lookup. Only b)3.027 F .257 -(uiltin commands or)-.2 F .501(commands found in the)144 463.2 R F4 --.666(PA)3.001 G(TH)-.189 E F0 .502(are e)2.751 F -.15(xe)-.15 G 3.002 +(uiltin commands or)-.2 F .502(commands found in the)144 463.2 R F4 +-.666(PA)3.002 G(TH)-.189 E F0 .502(are e)2.752 F -.15(xe)-.15 G 3.002 (cuted. If).15 F(the)3.002 E F13.002 E F0 .502(option is gi)3.002 -F -.15(ve)-.25 G .502(n, the search for).15 F F2(command)3.202 E F0(is) -3.772 E .232(performed using a def)144 475.2 R .231(ault v)-.1 F .231 +F -.15(ve)-.25 G .501(n, the search for).15 F F2(command)3.201 E F0(is) +3.771 E .231(performed using a def)144 475.2 R .231(ault v)-.1 F .231 (alue for)-.25 F F1 -.74(PA)2.731 G(TH)-.21 E F0 .231 (that is guaranteed to \214nd all of the standard utilities.)2.731 F(If) -5.231 E .174(either the)144 487.2 R F12.674 E F0(or)2.674 E F1 -2.674 E F0 .175(option is supplied, a description of)2.674 F F2 -(command)2.875 E F0 .175(is printed.)3.445 F(The)5.175 E F12.675 E -F0 .175(option causes)2.675 F 3.11(as)144 499.2 S .61(ingle w)-3.11 F +5.232 E .175(either the)144 487.2 R F12.675 E F0(or)2.675 E F1 +2.675 E F0 .175(option is supplied, a description of)2.675 F F2 +(command)2.875 E F0 .174(is printed.)3.445 F(The)5.174 E F12.674 E +F0 .174(option causes)2.674 F 3.11(as)144 499.2 S .61(ingle w)-3.11 F .61(ord indicating the command or \214le name used to in)-.1 F -.2(vo) -.4 G -.1(ke).2 G F2(command)3.41 E F0 .61(to be displayed; the)3.88 F -F1144 511.2 Q F0 .249(option produces a more v)2.749 F .249 -(erbose description.)-.15 F .249(If the)5.249 F F12.749 E F0(or) -2.749 E F12.75 E F0 .25(option is supplied, the e)2.75 F .25 -(xit status)-.15 F 1.005(is 0 if)144 523.2 R F2(command)3.705 E F0 -.1 -(wa)4.275 G 3.505(sf).1 G 1.005(ound, and 1 if not.)-3.505 F 1.004 +F1144 511.2 Q F0 .25(option produces a more v)2.75 F .25 +(erbose description.)-.15 F .249(If the)5.25 F F12.749 E F0(or) +2.749 E F12.749 E F0 .249(option is supplied, the e)2.749 F .249 +(xit status)-.15 F 1.004(is 0 if)144 523.2 R F2(command)3.704 E F0 -.1 +(wa)4.274 G 3.504(sf).1 G 1.005(ound, and 1 if not.)-3.504 F 1.005 (If neither option is supplied and an error occurred or)6.005 F F2 -(command)144.2 535.2 Q F0 1.598(cannot be found, the e)4.868 F 1.599 -(xit status is 127.)-.15 F 1.599(Otherwise, the e)6.599 F 1.599 -(xit status of the)-.15 F F1(command)4.099 E F0 -.2(bu)144 547.2 S +(command)144.2 535.2 Q F0 1.599(cannot be found, the e)4.869 F 1.599 +(xit status is 127.)-.15 F 1.599(Otherwise, the e)6.599 F 1.598 +(xit status of the)-.15 F F1(command)4.098 E F0 -.2(bu)144 547.2 S (iltin is the e).2 E(xit status of)-.15 E F2(command)2.5 E F0(.).77 E F1 (compgen)108 564 Q F0([)2.5 E F2(option)A F0 2.5(][)C F2(wor)-2.5 E(d) --.37 E F0(])A .013(Generate possible completion matches for)144 576 R F2 +-.37 E F0(])A .012(Generate possible completion matches for)144 576 R F2 (wor)2.513 E(d)-.37 E F0 .013(according to the)2.513 F F2(option)2.513 E -F0 .013(s, which may be an)B 2.512(yo)-.15 G(ption)-2.512 E .981 -(accepted by the)144 588 R F1(complete)3.481 E F0 -.2(bu)3.481 G .981 +F0 .013(s, which may be an)B 2.513(yo)-.15 G(ption)-2.513 E .982 +(accepted by the)144 588 R F1(complete)3.482 E F0 -.2(bu)3.481 G .981 (iltin with the e).2 F .981(xception of)-.15 F F13.481 E F0(and) -3.481 E F13.481 E F0 3.481(,a)C .982(nd write the matches to the) +3.481 E F13.481 E F0 3.481(,a)C .981(nd write the matches to the) -3.481 F 1.415(standard output.)144 600 R 1.415(When using the)6.415 F F13.915 E F0(or)3.915 E F13.915 E F0 1.415(options, the v) 3.915 F 1.415(arious shell v)-.25 F 1.415(ariables set by the pro-)-.25 @@ -5323,15 +5328,15 @@ F(those completions matching)144 660 Q F2(wor)2.5 E(d)-.37 E F0 (will be displayed.)2.5 E(The return v)144 684 Q (alue is true unless an in)-.25 E -.25(va)-.4 G (lid option is supplied, or no matches were generated.).25 E F1 -(complete)108 700.8 Q F0([)2.786 E F1(\255abcdefgjksuv)A F0 2.786(][)C -F1-2.786 E F2(comp-option)2.786 E F0 2.786(][)C F1-2.786 E +(complete)108 700.8 Q F0([)2.787 E F1(\255abcdefgjksuv)A F0 2.787(][)C +F1-2.787 E F2(comp-option)2.786 E F0 2.786(][)C F1-2.786 E F2(action)2.786 E F0 2.786(][)C F1-2.786 E F2(globpat)2.786 E F0 2.786(][)C F1-2.786 E F2(wor)2.786 E(dlist)-.37 E F0 2.786(][)C F1 --2.786 E F2(pr)2.786 E(e\214x)-.37 E F0 2.787(][)C F1-2.787 -E F2(suf-)2.787 E<8c78>108 712.8 Q F0(])A([)144 724.8 Q F1A F2 +-2.786 E F2(pr)2.786 E(e\214x)-.37 E F0 2.786(][)C F1-2.786 +E F2(suf-)2.786 E<8c78>108 712.8 Q F0(])A([)144 724.8 Q F1A F2 (\214lterpat)2.5 E F0 2.5(][)C F1-2.5 E F2(function)2.5 E F0 2.5 (][)C F1-2.5 E F2(command)2.5 E F0(])A F2(name)2.5 E F0([)2.5 E F2 -(name ...)A F0(])A(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(45) +(name ...)A F0(])A(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(45) 199.835 E 0 Cg EP %%Page: 46 46 %%BeginPageSetup @@ -5339,43 +5344,43 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Times-Bold@0 SF(complete \255pr)108 84 Q F0([)2.5 E/F2 10 -/Times-Italic@0 SF(name)A F0(...])2.5 E .633(Specify ho)144 96 R 3.133 -(wa)-.25 G -.18(rg)-3.133 G .633(uments to each).18 F F2(name)3.133 E F0 -.633(should be completed.)3.133 F .634(If the)5.634 F F13.134 E F0 -.634(option is supplied, or if no)3.134 F .14(options are supplied, e) +/Times-Italic@0 SF(name)A F0(...])2.5 E .634(Specify ho)144 96 R 3.134 +(wa)-.25 G -.18(rg)-3.134 G .634(uments to each).18 F F2(name)3.134 E F0 +.634(should be completed.)3.134 F .633(If the)5.634 F F13.133 E F0 +.633(option is supplied, or if no)3.133 F .139(options are supplied, e) 144 108 R .139(xisting completion speci\214cations are printed in a w) --.15 F .139(ay that allo)-.1 F .139(ws them to be)-.25 F .31 +-.15 F .14(ay that allo)-.1 F .14(ws them to be)-.25 F .31 (reused as input.)144 120 R(The)5.31 E F12.81 E F0 .31 (option remo)2.81 F -.15(ve)-.15 G 2.81(sac).15 G .31 (ompletion speci\214cation for each)-2.81 F F2(name)2.81 E F0 2.81(,o)C 1.11 -.4(r, i)-2.81 H 2.81(fn).4 G(o)-2.81 E F2(name)2.81 E F0(s)A -(are supplied, all completion speci\214cations.)144 132 Q 1.438 +(are supplied, all completion speci\214cations.)144 132 Q 1.437 (The process of applying these completion speci\214cations when w)144 -156 R 1.437(ord completion is attempted is)-.1 F(described abo)144 168 Q +156 R 1.438(ord completion is attempted is)-.1 F(described abo)144 168 Q .3 -.15(ve u)-.15 H(nder).15 E F1(Pr)2.5 E(ogrammable Completion)-.18 E -F0(.)A .555(Other options, if speci\214ed, ha)144 192 R .855 -.15(ve t) +F0(.)A .556(Other options, if speci\214ed, ha)144 192 R .856 -.15(ve t) -.2 H .555(he follo).15 F .555(wing meanings.)-.25 F .555(The ar)5.555 F -.555(guments to the)-.18 F F13.056 E F0(,)A F13.056 E F0 -3.056(,a)C(nd)-3.056 E F13.056 E F0 .723 -(options \(and, if necessary)144 204 R 3.223(,t)-.65 G(he)-3.223 E F1 -3.223 E F0(and)3.223 E F13.223 E F0 .722 -(options\) should be quoted to protect them from e)3.223 F(xpan-)-.15 E +.555(guments to the)-.18 F F13.055 E F0(,)A F13.055 E F0 +3.055(,a)C(nd)-3.055 E F13.055 E F0 .722 +(options \(and, if necessary)144 204 R 3.222(,t)-.65 G(he)-3.222 E F1 +3.222 E F0(and)3.222 E F13.222 E F0 .723 +(options\) should be quoted to protect them from e)3.222 F(xpan-)-.15 E (sion before the)144 216 Q F1(complete)2.5 E F0 -.2(bu)2.5 G (iltin is in).2 E -.2(vo)-.4 G -.1(ke).2 G(d.).1 E F1144 228 Q F2 -(comp-option)2.5 E F0(The)184 240 Q F2(comp-option)2.79 E F0 .291 +(comp-option)2.5 E F0(The)184 240 Q F2(comp-option)2.791 E F0 .291 (controls se)2.791 F -.15(ve)-.25 G .291(ral aspects of the compspec') .15 F 2.791(sb)-.55 G(eha)-2.791 E .291(vior be)-.2 F .291 (yond the simple)-.15 F(generation of completions.)184 252 Q F2 (comp-option)5 E F0(may be one of:)2.5 E F1(bashdefault)184 264 Q F0 .281(Perform the rest of the def)224 276 R(ault)-.1 E F1(bash)2.781 E F0 .281(completions if the compspec generates no)2.781 F(matches.)224 288 Q -F1(default)184 300 Q F0 2.875(Use readline')10 F 5.375(sd)-.55 G(ef) --5.375 E 2.876(ault \214lename completion if the compspec generates no) +F1(default)184 300 Q F0 2.876(Use readline')10 F 5.376(sd)-.55 G(ef) +-5.376 E 2.875(ault \214lename completion if the compspec generates no) -.1 F(matches.)224 312 Q F1(dir)184 324 Q(names)-.15 E F0(Perform direc\ tory name completion if the compspec generates no matches.)224 336 Q F1 (\214lenames)184 348 Q F0 -.7(Te)224 360 S .137(ll readline that the co\ -mpspec generates \214lenames, so it can perform an).7 F 2.636<798c>-.15 -G(le-)-2.636 E .496(name\255speci\214c processing \(lik)224 372 R 2.996 +mpspec generates \214lenames, so it can perform an).7 F 2.637<798c>-.15 +G(le-)-2.637 E .496(name\255speci\214c processing \(lik)224 372 R 2.996 (ea)-.1 G .496(dding a slash to directory names or suppress-)-2.996 F (ing trailing spaces\).)224 384 Q (Intended to be used with shell functions.)5 E F1(nospace)184 396 Q F0 @@ -5407,7 +5412,7 @@ Q(en from the \214le speci\214ed by the)-.1 E/F3 9/Times-Bold@0 SF (HOSTFILE)2.5 E F0(shell v)2.25 E(ariable.)-.25 E F1(job)184 696 Q F0 (Job names, if job control is acti)26.11 E -.15(ve)-.25 G 5(.M).15 G (ay also be speci\214ed as)-5 E F12.5 E F0(.)A(GNU Bash-3.0)72 768 -Q(2004 Jan 24)149.845 E(46)199.835 E 0 Cg EP +Q(2004 Jan 28)149.845 E(46)199.835 E 0 Cg EP %%Page: 47 47 %%BeginPageSetup BP @@ -5429,150 +5434,150 @@ F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1 (May also be speci\214ed as)5 E F12.5 E F0(.)A F1 -.1(va)184 192 S (riable).1 E F0(Names of all shell v)5.1 E 2.5(ariables. May)-.25 F (also be speci\214ed as)2.5 E F12.5 E F0(.)A F1144 204 Q/F2 -10/Times-Italic@0 SF(globpat)2.5 E F0 1.41(The \214lename e)184 216 R +10/Times-Italic@0 SF(globpat)2.5 E F0 1.411(The \214lename e)184 216 R 1.411(xpansion pattern)-.15 F F2(globpat)3.911 E F0 1.411(is e)3.911 F 1.411(xpanded to generate the possible comple-)-.15 F(tions.)184 228 Q -F1144 240 Q F2(wor)2.5 E(dlist)-.37 E F0(The)184 252 Q F2(wor)3.64 -E(dlist)-.37 E F0 1.14(is split using the characters in the)3.64 F/F3 9 -/Times-Bold@0 SF(IFS)3.64 E F0 1.139(special v)3.39 F 1.139 -(ariable as delimiters, and)-.25 F 2.007(each resultant w)184 264 R -2.007(ord is e)-.1 F 4.507(xpanded. The)-.15 F 2.008 -(possible completions are the members of the)4.507 F +F1144 240 Q F2(wor)2.5 E(dlist)-.37 E F0(The)184 252 Q F2(wor) +3.639 E(dlist)-.37 E F0 1.14(is split using the characters in the)3.639 +F/F3 9/Times-Bold@0 SF(IFS)3.64 E F0 1.14(special v)3.39 F 1.14 +(ariable as delimiters, and)-.25 F 2.008(each resultant w)184 264 R +2.008(ord is e)-.1 F 4.508(xpanded. The)-.15 F 2.007 +(possible completions are the members of the)4.508 F (resultant list which match the w)184 276 Q(ord being completed.)-.1 E -F1144 288 Q F2(command)2.5 E(command)184 300 Q F0 1.056(is e)3.556 -F -.15(xe)-.15 G 1.056(cuted in a subshell en).15 F 1.056 +F1144 288 Q F2(command)2.5 E(command)184 300 Q F0 1.055(is e)3.555 +F -.15(xe)-.15 G 1.055(cuted in a subshell en).15 F 1.056 (vironment, and its output is used as the possible)-.4 F(completions.) -184 312 Q F1144 324 Q F2(function)2.5 E F0 1.18 -(The shell function)184 336 R F2(function)3.68 E F0 1.181(is e)3.681 F --.15(xe)-.15 G 1.181(cuted in the current shell en).15 F 3.681 -(vironment. When)-.4 F 1.181(it \214n-)3.681 F .932 +184 312 Q F1144 324 Q F2(function)2.5 E F0 1.181 +(The shell function)184 336 R F2(function)3.681 E F0 1.181(is e)3.681 F +-.15(xe)-.15 G 1.181(cuted in the current shell en).15 F 3.68 +(vironment. When)-.4 F 1.18(it \214n-)3.68 F .932 (ishes, the possible completions are retrie)184 348 R -.15(ve)-.25 G 3.432(df).15 G .932(rom the v)-3.432 F .932(alue of the)-.25 F F3 -(COMPREPL)3.431 E(Y)-.828 E F0(array)3.181 E -.25(va)184 360 S(riable.) +(COMPREPL)3.432 E(Y)-.828 E F0(array)3.182 E -.25(va)184 360 S(riable.) .25 E F1144 372 Q F2(\214lterpat)2.5 E(\214lterpat)184 384 Q F0 -.733(is a pattern as used for \214lename e)3.233 F 3.233(xpansion. It) +.733(is a pattern as used for \214lename e)3.234 F 3.233(xpansion. It) -.15 F .733(is applied to the list of possible)3.233 F 1.596 (completions generated by the preceding options and ar)184 396 R 1.596 (guments, and each completion)-.18 F(matching)184 408 Q F2(\214lterpat) -3.204 E F0 .704(is remo)3.204 F -.15(ve)-.15 G 3.204(df).15 G .704 -(rom the list.)-3.204 F 3.204(Al)5.704 G(eading)-3.204 E F1(!)3.204 E F0 -(in)3.204 E F2(\214lterpat)3.205 E F0(ne)3.205 E -.05(ga)-.15 G .705 +3.205 E F0 .705(is remo)3.205 F -.15(ve)-.15 G 3.205(df).15 G .704 +(rom the list.)-3.205 F 3.204(Al)5.704 G(eading)-3.204 E F1(!)3.204 E F0 +(in)3.204 E F2(\214lterpat)3.204 E F0(ne)3.204 E -.05(ga)-.15 G .704 (tes the pattern;).05 F(in this case, an)184 420 Q 2.5(yc)-.15 G (ompletion not matching)-2.5 E F2(\214lterpat)2.5 E F0(is remo)2.5 E -.15(ve)-.15 G(d.).15 E F1144 432 Q F2(pr)2.5 E(e\214x)-.37 E(pr) -184 444 Q(e\214x)-.37 E F0 .535(is added at the be)3.035 F .534 +184 444 Q(e\214x)-.37 E F0 .534(is added at the be)3.034 F .534 (ginning of each possible completion after all other options ha)-.15 F -.15(ve)-.2 G(been applied.)184 456 Q F1144 468 Q F2(suf)2.5 E 2.81(\214x suf)-.18 F<8c78>-.18 E F0 (is appended to each possible completion after all other options ha)2.5 -E .3 -.15(ve b)-.2 H(een applied.).15 E .466(The return v)144 484.8 R -.466(alue is true unless an in)-.25 F -.25(va)-.4 G .466 -(lid option is supplied, an option other than).25 F F12.967 E F0 -(or)2.967 E F12.967 E F0 .467(is sup-)2.967 F 1.362 -(plied without a)144 496.8 R F2(name)3.862 E F0(ar)3.862 E 1.361 -(gument, an attempt is made to remo)-.18 F 1.661 -.15(ve a c)-.15 H -1.361(ompletion speci\214cation for a).15 F F2(name)144 508.8 Q F0 +E .3 -.15(ve b)-.2 H(een applied.).15 E .467(The return v)144 484.8 R +.467(alue is true unless an in)-.25 F -.25(va)-.4 G .466 +(lid option is supplied, an option other than).25 F F12.966 E F0 +(or)2.966 E F12.966 E F0 .466(is sup-)2.966 F 1.361 +(plied without a)144 496.8 R F2(name)3.861 E F0(ar)3.861 E 1.361 +(gument, an attempt is made to remo)-.18 F 1.662 -.15(ve a c)-.15 H +1.362(ompletion speci\214cation for a).15 F F2(name)144 508.8 Q F0 (for which no speci\214cation e)2.5 E (xists, or an error occurs adding a completion speci\214cation.)-.15 E -F1(continue)108 525.6 Q F0([)2.5 E F2(n)A F0(])A 1.753(Resume the ne)144 -537.6 R 1.753(xt iteration of the enclosing)-.15 F F1 -.25(fo)4.254 G(r) +F1(continue)108 525.6 Q F0([)2.5 E F2(n)A F0(])A 1.754(Resume the ne)144 +537.6 R 1.754(xt iteration of the enclosing)-.15 F F1 -.25(fo)4.254 G(r) .25 E F0(,)A F1(while)4.254 E F0(,)A F1(until)4.254 E F0 4.254(,o)C(r) --4.254 E F1(select)4.254 E F0 4.254(loop. If)4.254 F F2(n)4.614 E F0 -1.754(is speci\214ed,)4.494 F 1.209(resume at the)144 549.6 R F2(n)3.709 +-4.254 E F1(select)4.254 E F0 4.253(loop. If)4.254 F F2(n)4.613 E F0 +1.753(is speci\214ed,)4.493 F 1.208(resume at the)144 549.6 R F2(n)3.709 E F0 1.209(th enclosing loop.)B F2(n)6.569 E F0 1.209(must be)3.949 F/F4 10/Symbol SF3.709 E F0 3.709(1. If)3.709 F F2(n)4.069 E F0 1.209 -(is greater than the number of enclosing)3.949 F .667 +(is greater than the number of enclosing)3.949 F .668 (loops, the last enclosing loop \(the `)144 561.6 R(`top-le)-.74 E -.15 -(ve)-.25 G(l').15 E 3.167('l)-.74 G .667(oop\) is resumed.)-3.167 F .668 -(The return v)5.668 F .668(alue is 0 unless the)-.25 F(shell is not e) +(ve)-.25 G(l').15 E 3.168('l)-.74 G .668(oop\) is resumed.)-3.168 F .667 +(The return v)5.667 F .667(alue is 0 unless the)-.25 F(shell is not e) 144 573.6 Q -.15(xe)-.15 G(cuting a loop when).15 E F1(continue)2.5 E F0 (is e)2.5 E -.15(xe)-.15 G(cuted.).15 E F1(declar)108 590.4 Q(e)-.18 E F0([)2.5 E F1(\255afFirtx)A F0 2.5(][)C F1-2.5 E F0 2.5(][)C F2 (name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E F1(typeset)108 602.4 Q F0([)2.5 E F1(\255afFirtx)A F0 2.5(][)C F1-2.5 E F0 2.5 -(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E 1.265 -(Declare v)144 614.4 R 1.265(ariables and/or gi)-.25 F 1.565 -.15(ve t) --.25 H 1.265(hem attrib).15 F 3.765(utes. If)-.2 F(no)3.765 E F2(name) -3.765 E F0 3.765(sa)C 1.265(re gi)-3.765 F -.15(ve)-.25 G 3.764(nt).15 G -1.264(hen display the v)-3.764 F 1.264(alues of)-.25 F -.25(va)144 626.4 -S 3.326(riables. The).25 F F13.326 E F0 .826 -(option will display the attrib)3.326 F .826(utes and v)-.2 F .826 -(alues of each)-.25 F F2(name)3.326 E F0 5.827(.W).18 G(hen)-5.827 E F1 -3.327 E F0 .827(is used,)3.327 F .22 +(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E 1.264 +(Declare v)144 614.4 R 1.264(ariables and/or gi)-.25 F 1.564 -.15(ve t) +-.25 H 1.264(hem attrib).15 F 3.765(utes. If)-.2 F(no)3.765 E F2(name) +3.765 E F0 3.765(sa)C 1.265(re gi)-3.765 F -.15(ve)-.25 G 3.765(nt).15 G +1.265(hen display the v)-3.765 F 1.265(alues of)-.25 F -.25(va)144 626.4 +S 3.327(riables. The).25 F F13.327 E F0 .826 +(option will display the attrib)3.327 F .826(utes and v)-.2 F .826 +(alues of each)-.25 F F2(name)3.326 E F0 5.826(.W).18 G(hen)-5.826 E F1 +3.326 E F0 .826(is used,)3.326 F .22 (additional options are ignored.)144 638.4 R(The)5.22 E F12.72 E F0 .22(option inhibits the display of function de\214nitions; only the) 2.72 F .466(function name and attrib)144 650.4 R .466(utes are printed.) -.2 F .466(If the)5.466 F F1(extdeb)2.966 E(ug)-.2 E F0 .466 (shell option is enabled using)2.966 F F1(shopt)2.966 E F0 2.966(,t)C (he)-2.966 E 1.308(source \214le name and line number where the functio\ -n is de\214ned are displayed as well.)144 662.4 R(The)6.308 E F1 -3.808 E F0 .19(option implies)144 674.4 R F12.69 E F0 5.19(.T)C -.19(he follo)-5.19 F .191 -(wing options can be used to restrict output to v)-.25 F .191 +n is de\214ned are displayed as well.)144 662.4 R(The)6.309 E F1 +3.809 E F0 .191(option implies)144 674.4 R F12.691 E F0 5.191(.T)C +.191(he follo)-5.191 F .191 +(wing options can be used to restrict output to v)-.25 F .19 (ariables with the speci-)-.25 F(\214ed attrib)144 686.4 Q(ute or to gi) -.2 E .3 -.15(ve v)-.25 H(ariables attrib)-.1 E(utes:)-.2 E F1144 698.4 Q F0(Each)25.3 E F2(name)2.5 E F0(is an array v)2.5 E (ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve)-.15 G(\).) .15 E F1144 710.4 Q F0(Use function names only)26.97 E(.)-.65 E -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(47)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(47)199.835 E 0 Cg EP %%Page: 48 48 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Times-Bold@0 SF144 84 Q F0 .558(The v)27.52 F .558 +-.35 E/F1 10/Times-Bold@0 SF144 84 Q F0 .557(The v)27.52 F .558 (ariable is treated as an inte)-.25 F .558(ger; arithmetic e)-.15 F -.25 -(va)-.25 G .558(luation \(see).25 F/F2 9/Times-Bold@0 SF .557 +(va)-.25 G .558(luation \(see).25 F/F2 9/Times-Bold@0 SF .558 (ARITHMETIC EV)3.058 F(ALU)-1.215 E(A-)-.54 E(TION \))180 96 Q F0 (is performed when the v)2.25 E(ariable is assigned a v)-.25 E(alue.) -.25 E F1144 108 Q F0(Mak)25.86 E(e)-.1 E/F3 10/Times-Italic@0 SF -(name)5.046 E F0 5.046(sr)C(eadonly)-5.046 E 7.546(.T)-.65 G 2.546 -(hese names cannot then be assigned v)-7.546 F 2.547 +(name)5.047 E F0 5.047(sr)C(eadonly)-5.047 E 7.547(.T)-.65 G 2.546 +(hese names cannot then be assigned v)-7.547 F 2.546 (alues by subsequent)-.25 F(assignment statements or unset.)180 120 Q F1 -144 132 Q F0(Gi)26.97 E 1.231 -.15(ve e)-.25 H(ach).15 E F3(name) -3.431 E F0(the)3.431 E F3(tr)3.431 E(ace)-.15 E F0(attrib)3.431 E 3.431 +144 132 Q F0(Gi)26.97 E 1.23 -.15(ve e)-.25 H(ach).15 E F3(name) +3.43 E F0(the)3.43 E F3(tr)3.431 E(ace)-.15 E F0(attrib)3.431 E 3.431 (ute. T)-.2 F .931(raced functions inherit the)-.35 F F1(DEB)3.431 E(UG) --.1 E F0 .93(trap from the)3.43 F(calling shell.)180 144 Q +-.1 E F0 .931(trap from the)3.431 F(calling shell.)180 144 Q (The trace attrib)5 E(ute has no special meaning for v)-.2 E(ariables.) -.25 E F1144 156 Q F0(Mark)25.3 E F3(name)2.5 E F0 2.5(sf)C(or e) -2.5 E(xport to subsequent commands via the en)-.15 E(vironment.)-.4 E -.336(Using `+' instead of `\255' turns of)144 172.8 R 2.837(ft)-.25 G -.337(he attrib)-2.837 F .337(ute instead, with the e)-.2 F .337 -(xception that)-.15 F F1(+a)2.837 E F0 .337(may not be used)2.837 F .793 +.337(Using `+' instead of `\255' turns of)144 172.8 R 2.837(ft)-.25 G +.337(he attrib)-2.837 F .337(ute instead, with the e)-.2 F .336 +(xception that)-.15 F F1(+a)2.836 E F0 .336(may not be used)2.836 F .792 (to destro)144 184.8 R 3.293(ya)-.1 G 3.293(na)-3.293 G .793(rray v) -3.293 F 3.293(ariable. When)-.25 F .793(used in a function, mak)3.293 F .793(es each)-.1 F F3(name)3.293 E F0 .793(local, as with the)3.293 F F1 -(local)3.292 E F0 2.842(command. If)144 196.8 R 2.842(av)2.842 G .342 -(ariable name is follo)-3.092 F .342(wed by =)-.25 F F3(value)A F0 2.842 -(,t)C .342(he v)-2.842 F .342(alue of the v)-.25 F .343 -(ariable is set to)-.25 F F3(value)2.843 E F0 5.343(.T)C(he)-5.343 E -.801(return v)144 208.8 R .801(alue is 0 unless an in)-.25 F -.25(va)-.4 -G .8 +(local)3.293 E F0 2.843(command. If)144 196.8 R 2.843(av)2.843 G .342 +(ariable name is follo)-3.093 F .342(wed by =)-.25 F F3(value)A F0 2.842 +(,t)C .342(he v)-2.842 F .342(alue of the v)-.25 F .342 +(ariable is set to)-.25 F F3(value)2.842 E F0 5.342(.T)C(he)-5.342 E .8 +(return v)144 208.8 R .8(alue is 0 unless an in)-.25 F -.25(va)-.4 G +.801 (lid option is encountered, an attempt is made to de\214ne a function) -.25 F(using)144 220.8 Q/F4 10/Courier@0 SF 1.038(\255f foo=bar)3.538 F -F0 3.538(,a)C 3.538(na)-3.538 G 1.038(ttempt is made to assign a v) --3.538 F 1.038(alue to a readonly v)-.25 F 1.039(ariable, an attempt is) +.25 F(using)144 220.8 Q/F4 10/Courier@0 SF 1.039(\255f foo=bar)3.539 F +F0 3.539(,a)C 3.539(na)-3.539 G 1.038(ttempt is made to assign a v) +-3.539 F 1.038(alue to a readonly v)-.25 F 1.038(ariable, an attempt is) -.25 F .974(made to assign a v)144 232.8 R .974(alue to an array v)-.25 F .974(ariable without using the compound assignment syntax \(see)-.25 F F1(Arrays)144 244.8 Q F0(abo)2.86 E -.15(ve)-.15 G .36(\), one of the) .15 F F3(names)2.86 E F0 .36(is not a v)2.86 F .36(alid shell v)-.25 F -.36(ariable name, an attempt is made to turn of)-.25 F(f)-.25 E .057 +.36(ariable name, an attempt is made to turn of)-.25 F(f)-.25 E .056 (readonly status for a readonly v)144 256.8 R .057 -(ariable, an attempt is made to turn of)-.25 F 2.556(fa)-.25 G .056 -(rray status for an array v)-2.556 F(ari-)-.25 E +(ariable, an attempt is made to turn of)-.25 F 2.557(fa)-.25 G .057 +(rray status for an array v)-2.557 F(ari-)-.25 E (able, or an attempt is made to display a non-e)144 268.8 Q (xistent function with)-.15 E F12.5 E F0(.)A F1 (dirs [\255clpv] [+)108 285.6 Q F3(n)A F1 2.5(][)C-2.5 E F3(n)A F1 -(])A F0 -.4(Wi)144 297.6 S .328 +(])A F0 -.4(Wi)144 297.6 S .329 (thout options, displays the list of currently remembered directories.) -.4 F .329(The def)5.329 F .329(ault display is on a)-.1 F 1.238 +.4 F .328(The def)5.328 F .328(ault display is on a)-.1 F 1.238 (single line with directory names separated by spaces.)144 309.6 R 1.238 (Directories are added to the list with the)6.238 F F1(pushd)144 321.6 Q F0(command; the)2.5 E F1(popd)2.5 E F0(command remo)2.5 E -.15(ve)-.15 G 2.5(se).15 G(ntries from the list.)-2.5 E F1(+)144 333.6 Q F3(n)A F0 -1.564(Displays the)25.3 F F3(n)4.064 E F0 1.565 -(th entry counting from the left of the list sho)B 1.565(wn by)-.25 F F1 -(dirs)4.065 E F0 1.565(when in)4.065 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E +1.565(Displays the)25.3 F F3(n)4.065 E F0 1.565 +(th entry counting from the left of the list sho)B 1.564(wn by)-.25 F F1 +(dirs)4.064 E F0 1.564(when in)4.064 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E (without options, starting with zero.)180 345.6 Q F1144 357.6 Q F3 (n)A F0 1.194(Displays the)25.3 F F3(n)3.694 E F0 1.194 (th entry counting from the right of the list sho)B 1.194(wn by)-.25 F @@ -5583,58 +5588,58 @@ F1(dirs)3.694 E F0 1.194(when in)3.694 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E .324(ault listing format uses a tilde to denote the home direc-)-.1 F (tory)180 405.6 Q(.)-.65 E F1144 417.6 Q F0 (Print the directory stack with one entry per line.)24.74 E F1144 -429.6 Q F0 .273(Print the directory stack with one entry per line, pre\ -\214xing each entry with its inde)25.3 F 2.772(xi)-.15 G 2.772(nt)-2.772 -G(he)-2.772 E(stack.)180 441.6 Q .257(The return v)144 458.4 R .258 +429.6 Q F0 .272(Print the directory stack with one entry per line, pre\ +\214xing each entry with its inde)25.3 F 2.773(xi)-.15 G 2.773(nt)-2.773 +G(he)-2.773 E(stack.)180 441.6 Q .258(The return v)144 458.4 R .258 (alue is 0 unless an in)-.25 F -.25(va)-.4 G .258 (lid option is supplied or).25 F F3(n)2.758 E F0(inde)2.758 E -.15(xe) -.15 G 2.758(sb).15 G -.15(ey)-2.758 G .258(ond the end of the direc-) .15 F(tory stack.)144 470.4 Q F1(diso)108 487.2 Q(wn)-.1 E F0([)2.5 E F1 (\255ar)A F0 2.5(][)C F1-2.5 E F0 2.5(][)C F3(jobspec)-2.5 E F0 -(...])2.5 E -.4(Wi)144 499.2 S .331(thout options, each).4 F F3(jobspec) -4.571 E F0 .331(is remo)3.141 F -.15(ve)-.15 G 2.831(df).15 G .331 -(rom the table of acti)-2.831 F .63 -.15(ve j)-.25 H 2.83(obs. If).15 F -(the)2.83 E F12.83 E F0 .33(option is gi)2.83 F -.15(ve)-.25 G(n,) -.15 E(each)144 511.2 Q F3(jobspec)4.52 E F0 .28(is not remo)3.09 F -.15 -(ve)-.15 G 2.78(df).15 G .28(rom the table, b)-2.78 F .28(ut is mark)-.2 -F .28(ed so that)-.1 F F2(SIGHUP)2.78 E F0 .281 -(is not sent to the job if)2.53 F .224(the shell recei)144 523.2 R -.15 +(...])2.5 E -.4(Wi)144 499.2 S .33(thout options, each).4 F F3(jobspec) +4.57 E F0 .33(is remo)3.14 F -.15(ve)-.15 G 2.83(df).15 G .331 +(rom the table of acti)-2.83 F .631 -.15(ve j)-.25 H 2.831(obs. If).15 F +(the)2.831 E F12.831 E F0 .331(option is gi)2.831 F -.15(ve)-.25 G +(n,).15 E(each)144 511.2 Q F3(jobspec)4.521 E F0 .281(is not remo)3.091 +F -.15(ve)-.15 G 2.78(df).15 G .28(rom the table, b)-2.78 F .28 +(ut is mark)-.2 F .28(ed so that)-.1 F F2(SIGHUP)2.78 E F0 .28 +(is not sent to the job if)2.53 F .223(the shell recei)144 523.2 R -.15 (ve)-.25 G 2.724(sa).15 G F2(SIGHUP)A/F5 9/Times-Roman@0 SF(.)A F0 .224 (If no)4.724 F F3(jobspec)4.464 E F0 .224(is present, and neither the) -3.034 F F12.724 E F0 .224(nor the)2.724 F F12.724 E F0 .223 -(option is sup-)2.724 F .651(plied, the)144 535.2 R F3(curr)3.151 E .651 -(ent job)-.37 F F0 .651(is used.)3.151 F .652(If no)5.651 F F3(jobspec) -4.892 E F0 .652(is supplied, the)3.462 F F13.152 E F0 .652 -(option means to remo)3.152 F .952 -.15(ve o)-.15 H 3.152(rm).15 G(ark) --3.152 E .435(all jobs; the)144 547.2 R F12.935 E F0 .435 -(option without a)2.935 F F3(jobspec)4.675 E F0(ar)3.245 E .434 -(gument restricts operation to running jobs.)-.18 F .434(The return) -5.434 F -.25(va)144 559.2 S(lue is 0 unless a).25 E F3(jobspec)4.24 E F0 +3.034 F F12.724 E F0 .224(nor the)2.724 F F12.724 E F0 .224 +(option is sup-)2.724 F .652(plied, the)144 535.2 R F3(curr)3.152 E .652 +(ent job)-.37 F F0 .652(is used.)3.152 F .652(If no)5.652 F F3(jobspec) +4.892 E F0 .652(is supplied, the)3.462 F F13.152 E F0 .651 +(option means to remo)3.151 F .951 -.15(ve o)-.15 H 3.151(rm).15 G(ark) +-3.151 E .434(all jobs; the)144 547.2 R F12.934 E F0 .434 +(option without a)2.934 F F3(jobspec)4.675 E F0(ar)3.245 E .435 +(gument restricts operation to running jobs.)-.18 F .435(The return) +5.435 F -.25(va)144 559.2 S(lue is 0 unless a).25 E F3(jobspec)4.24 E F0 (does not specify a v)2.81 E(alid job)-.25 E(.)-.4 E F1(echo)108 576 Q F0([)2.5 E F1(\255neE)A F0 2.5(][)C F3(ar)-2.5 E(g)-.37 E F0(...])2.5 E -.394(Output the)144 588 R F3(ar)2.894 E(g)-.37 E F0 .394 +.395(Output the)144 588 R F3(ar)2.895 E(g)-.37 E F0 .395 (s, separated by spaces, follo)B .395(wed by a ne)-.25 F 2.895 -(wline. The)-.25 F .395(return status is al)2.895 F -.1(wa)-.1 G .395 -(ys 0.).1 F(If)5.395 E F12.895 E F0 .549 +(wline. The)-.25 F .394(return status is al)2.895 F -.1(wa)-.1 G .394 +(ys 0.).1 F(If)5.394 E F12.894 E F0 .548 (is speci\214ed, the trailing ne)144 600 R .548(wline is suppressed.) -.25 F .548(If the)5.548 F F13.048 E F0 .548(option is gi)3.048 F -.15(ve)-.25 G .548(n, interpretation of the fol-).15 F(lo)144 612 Q -.052(wing backslash-escaped characters is enabled.)-.25 F(The)5.052 E F1 -2.552 E F0 .053(option disables the interpretation of these)2.553 -F 1.503(escape characters, e)144 624 R -.15(ve)-.25 G 4.003(no).15 G -4.003(ns)-4.003 G 1.502(ystems where the)-4.003 F 4.002(ya)-.15 G 1.502 -(re interpreted by def)-4.002 F 4.002(ault. The)-.1 F F1(xpg_echo)4.002 -E F0(shell)4.002 E .009 +.053(wing backslash-escaped characters is enabled.)-.25 F(The)5.053 E F1 +2.553 E F0 .052(option disables the interpretation of these)2.552 +F 1.502(escape characters, e)144 624 R -.15(ve)-.25 G 4.002(no).15 G +4.002(ns)-4.002 G 1.502(ystems where the)-4.002 F 4.002(ya)-.15 G 1.502 +(re interpreted by def)-4.002 F 4.003(ault. The)-.1 F F1(xpg_echo)4.003 +E F0(shell)4.003 E .009 (option may be used to dynamically determine whether or not)144 636 R F1 -(echo)2.509 E F0 -.15(ex)2.51 G .01(pands these escape characters).15 F -.66(by def)144 648 R(ault.)-.1 E F1(echo)5.66 E F0 .66 -(does not interpret)3.16 F F13.16 E F0 .659 -(to mean the end of options.)3.159 F F1(echo)5.659 E F0 .659 -(interprets the follo)3.159 F(wing)-.25 E(escape sequences:)144 660 Q F1 +(echo)2.509 E F0 -.15(ex)2.509 G .009(pands these escape characters).15 +F .659(by def)144 648 R(ault.)-.1 E F1(echo)5.659 E F0 .659 +(does not interpret)3.159 F F13.159 E F0 .659 +(to mean the end of options.)3.159 F F1(echo)5.66 E F0 .66 +(interprets the follo)3.16 F(wing)-.25 E(escape sequences:)144 660 Q F1 (\\a)144 672 Q F0(alert \(bell\))28.22 E F1(\\b)144 684 Q F0(backspace) 27.66 E F1(\\c)144 696 Q F0(suppress trailing ne)28.78 E(wline)-.25 E F1 (\\e)144 708 Q F0(an escape character)28.78 E(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(48)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(48)199.835 E 0 Cg EP %%Page: 49 49 %%BeginPageSetup BP @@ -5654,121 +5659,121 @@ BP (xadecimal v)-.15 E(alue)-.25 E F2(HH)2.5 E F0(\(one or tw)2.5 E 2.5(oh) -.1 G .3 -.15(ex d)-2.5 H(igits\)).15 E F1(enable)108 196.8 Q F0([)2.5 E F1(\255adnps)A F0 2.5(][)C F1-2.5 E F2(\214lename)2.5 E F0 2.5(][) -C F2(name)-2.5 E F0(...])2.5 E .277(Enable and disable b)144 208.8 R +C F2(name)-2.5 E F0(...])2.5 E .278(Enable and disable b)144 208.8 R .278(uiltin shell commands.)-.2 F .278(Disabling a b)5.278 F .278 -(uiltin allo)-.2 F .278(ws a disk command which has)-.25 F .834 +(uiltin allo)-.2 F .278(ws a disk command which has)-.25 F .833 (the same name as a shell b)144 220.8 R .834(uiltin to be e)-.2 F -.15 (xe)-.15 G .834(cuted without specifying a full pathname, e).15 F -.15 -(ve)-.25 G 3.333(nt).15 G(hough)-3.333 E .989 +(ve)-.25 G 3.334(nt).15 G(hough)-3.334 E .99 (the shell normally searches for b)144 232.8 R .989 -(uiltins before disk commands.)-.2 F(If)5.989 E F13.489 E F0 .99 -(is used, each)3.49 F F2(name)3.49 E F0 .99(is dis-)3.49 F 1.582 +(uiltins before disk commands.)-.2 F(If)5.989 E F13.489 E F0 .989 +(is used, each)3.489 F F2(name)3.489 E F0 .989(is dis-)3.489 F 1.581 (abled; otherwise,)144 244.8 R F2(names)4.082 E F0 1.582(are enabled.) 4.082 F -.15(Fo)6.582 G 4.082(re).15 G 1.582(xample, to use the)-4.232 F F1(test)4.082 E F0 1.582(binary found via the)4.082 F/F3 9/Times-Bold@0 -SF -.666(PA)4.081 G(TH)-.189 E F0 .08(instead of the shell b)144 256.8 R -.08(uiltin v)-.2 F .08(ersion, run)-.15 F/F4 10/Courier@0 SF .081 -(enable -n test)2.58 F F0 5.081(.T)C(he)-5.081 E F12.581 E F0 .081 -(option means to load the ne)2.581 F(w)-.25 E -.2(bu)144 268.8 S 1.525 -(iltin command).2 F F2(name)4.385 E F0 1.524(from shared object)4.204 F +SF -.666(PA)4.082 G(TH)-.189 E F0 .081(instead of the shell b)144 256.8 +R .081(uiltin v)-.2 F .081(ersion, run)-.15 F/F4 10/Courier@0 SF .081 +(enable -n test)2.581 F F0 5.081(.T)C(he)-5.081 E F12.58 E F0 .08 +(option means to load the ne)2.58 F(w)-.25 E -.2(bu)144 268.8 S 1.524 +(iltin command).2 F F2(name)4.384 E F0 1.524(from shared object)4.204 F F2(\214lename)4.024 E F0 4.024(,o).18 G 4.024(ns)-4.024 G 1.524 (ystems that support dynamic loading.)-4.024 F(The)144 280.8 Q F1 -2.866 E F0 .366(option will delete a b)2.866 F .366(uiltin pre)-.2 F -.366(viously loaded with)-.25 F F12.867 E F0 5.367(.I)C 2.867(fn) --5.367 G(o)-2.867 E F2(name)2.867 E F0(ar)2.867 E .367(guments are gi) --.18 F -.15(ve)-.25 G .367(n, or).15 F .399(if the)144 292.8 R F1 -2.899 E F0 .399(option is supplied, a list of shell b)2.899 F .399 +2.867 E F0 .367(option will delete a b)2.867 F .367(uiltin pre)-.2 F +.367(viously loaded with)-.25 F F12.866 E F0 5.366(.I)C 2.866(fn) +-5.366 G(o)-2.866 E F2(name)2.866 E F0(ar)2.866 E .366(guments are gi) +-.18 F -.15(ve)-.25 G .366(n, or).15 F .398(if the)144 292.8 R F1 +2.898 E F0 .399(option is supplied, a list of shell b)2.899 F .399 (uiltins is printed.)-.2 F -.4(Wi)5.399 G .399(th no other option ar).4 -F .398(guments, the)-.18 F .098(list consists of all enabled shell b)144 +F .399(guments, the)-.18 F .099(list consists of all enabled shell b)144 304.8 R 2.598(uiltins. If)-.2 F F12.598 E F0 .098 -(is supplied, only disabled b)2.598 F .099(uiltins are printed.)-.2 F -(If)5.099 E F12.599 E F0 1.917 +(is supplied, only disabled b)2.598 F .098(uiltins are printed.)-.2 F +(If)5.098 E F12.598 E F0 1.916 (is supplied, the list printed includes all b)144 316.8 R 1.916 -(uiltins, with an indication of whether or not each is)-.2 F 2.878 -(enabled. If)144 328.8 R F12.878 E F0 .379 -(is supplied, the output is restricted to the POSIX)2.878 F F2(special) -2.879 E F0 -.2(bu)2.879 G 2.879(iltins. The).2 F .379(return v)2.879 F -(alue)-.25 E .995(is 0 unless a)144 340.8 R F2(name)3.855 E F0 .994 -(is not a shell b)3.675 F .994(uiltin or there is an error loading a ne) --.2 F 3.494(wb)-.25 G .994(uiltin from a shared)-3.694 F(object.)144 +(uiltins, with an indication of whether or not each is)-.2 F 2.879 +(enabled. If)144 328.8 R F12.879 E F0 .379 +(is supplied, the output is restricted to the POSIX)2.879 F F2(special) +2.879 E F0 -.2(bu)2.878 G 2.878(iltins. The).2 F .378(return v)2.878 F +(alue)-.25 E .994(is 0 unless a)144 340.8 R F2(name)3.854 E F0 .994 +(is not a shell b)3.674 F .994(uiltin or there is an error loading a ne) +-.2 F 3.495(wb)-.25 G .995(uiltin from a shared)-3.695 F(object.)144 352.8 Q F1 -2.3 -.15(ev a)108 369.6 T(l).15 E F0([)2.5 E F2(ar)A(g)-.37 -E F0(...])2.5 E(The)144 381.6 Q F2(ar)3.17 E(g)-.37 E F0 3.17(sa)C .671 -(re read and concatenated together into a single command.)-3.17 F .671 -(This command is then read)5.671 F .495(and e)144 393.6 R -.15(xe)-.15 G -.495(cuted by the shell, and its e).15 F .495 +E F0(...])2.5 E(The)144 381.6 Q F2(ar)3.171 E(g)-.37 E F0 3.171(sa)C +.671(re read and concatenated together into a single command.)-3.171 F +.67(This command is then read)5.67 F .495(and e)144 393.6 R -.15(xe)-.15 +G .495(cuted by the shell, and its e).15 F .495 (xit status is returned as the v)-.15 F .495(alue of)-.25 F F1 -2.3 -.15 (ev a)2.995 H(l).15 E F0 5.495(.I)C 2.995(ft)-5.495 G .495(here are no) -2.995 F F2(ar)2.995 E(gs)-.37 E F0(,).27 E(or only null ar)144 405.6 Q (guments,)-.18 E F1 -2.3 -.15(ev a)2.5 H(l).15 E F0(returns 0.)2.5 E F1 (exec)108 422.4 Q F0([)2.5 E F1(\255cl)A F0 2.5(][)C F1-2.5 E F2 (name)2.5 E F0 2.5(][)C F2(command)-2.5 E F0([)2.5 E F2(ar)A(guments) --.37 E F0(]])A(If)144 434.4 Q F2(command)3.005 E F0 .305 -(is speci\214ed, it replaces the shell.)3.575 F .305(No ne)5.305 F 2.805 -(wp)-.25 G .306(rocess is created.)-2.805 F(The)5.306 E F2(ar)3.136 E -(guments)-.37 E F0(become)3.076 E .177(the ar)144 446.4 R .177 +-.37 E F0(]])A(If)144 434.4 Q F2(command)3.006 E F0 .306 +(is speci\214ed, it replaces the shell.)3.576 F .305(No ne)5.305 F 2.805 +(wp)-.25 G .305(rocess is created.)-2.805 F(The)5.305 E F2(ar)3.135 E +(guments)-.37 E F0(become)3.075 E .176(the ar)144 446.4 R .176 (guments to)-.18 F F2(command)2.676 E F0 5.176(.I)C 2.676(ft)-5.176 G (he)-2.676 E F12.676 E F0 .176 -(option is supplied, the shell places a dash at the be)2.676 F .176 -(ginning of)-.15 F .159(the zeroth ar)144 458.4 R 2.659(gp)-.18 G .159 -(assed to)-2.659 F F2(command)2.659 E F0 5.159(.T).77 G .159 -(his is what)-5.159 F F2(lo)2.659 E(gin)-.1 E F0 .159(\(1\) does.).24 F -(The)5.16 E F12.66 E F0 .16(option causes)2.66 F F2(command)2.86 E -F0(to)3.43 E 1.196(be e)144 470.4 R -.15(xe)-.15 G 1.196 -(cuted with an empty en).15 F 3.696(vironment. If)-.4 F F13.696 E -F0 1.196(is supplied, the shell passes)3.696 F F2(name)4.055 E F0 1.195 -(as the zeroth)3.875 F(ar)144 482.4 Q .02(gument to the e)-.18 F -.15 +(option is supplied, the shell places a dash at the be)2.676 F .177 +(ginning of)-.15 F .16(the zeroth ar)144 458.4 R 2.66(gp)-.18 G .16 +(assed to)-2.66 F F2(command)2.66 E F0 5.16(.T).77 G .159(his is what) +-5.16 F F2(lo)2.659 E(gin)-.1 E F0 .159(\(1\) does.).24 F(The)5.159 E F1 +2.659 E F0 .159(option causes)2.659 F F2(command)2.859 E F0(to) +3.429 E 1.195(be e)144 470.4 R -.15(xe)-.15 G 1.195 +(cuted with an empty en).15 F 3.695(vironment. If)-.4 F F13.696 E +F0 1.196(is supplied, the shell passes)3.696 F F2(name)4.056 E F0 1.196 +(as the zeroth)3.876 F(ar)144 482.4 Q .02(gument to the e)-.18 F -.15 (xe)-.15 G .02(cuted command.).15 F(If)5.02 E F2(command)2.72 E F0 .02 (cannot be e)3.29 F -.15(xe)-.15 G .02 -(cuted for some reason, a non-inter).15 F(-)-.2 E(acti)144 494.4 Q 1.067 --.15(ve s)-.25 H .767(hell e).15 F .767(xits, unless the shell option) +(cuted for some reason, a non-inter).15 F(-)-.2 E(acti)144 494.4 Q 1.066 +-.15(ve s)-.25 H .766(hell e).15 F .766(xits, unless the shell option) -.15 F F1(execfail)3.266 E F0 .766 -(is enabled, in which case it returns f)3.266 F 3.266(ailure. An)-.1 F -(interacti)144 506.4 Q 1.518 -.15(ve s)-.25 H 1.218(hell returns f).15 F +(is enabled, in which case it returns f)3.266 F 3.267(ailure. An)-.1 F +(interacti)144 506.4 Q 1.519 -.15(ve s)-.25 H 1.219(hell returns f).15 F 1.219(ailure if the \214le cannot be e)-.1 F -.15(xe)-.15 G 3.719 -(cuted. If).15 F F2(command)3.919 E F0 1.219(is not speci\214ed, an) -4.489 F(y)-.15 E .134(redirections tak)144 518.4 R 2.634(ee)-.1 G -.25 -(ff)-2.634 G .134(ect in the current shell, and the return status is 0.) +(cuted. If).15 F F2(command)3.918 E F0 1.218(is not speci\214ed, an) +4.488 F(y)-.15 E .133(redirections tak)144 518.4 R 2.633(ee)-.1 G -.25 +(ff)-2.633 G .134(ect in the current shell, and the return status is 0.) .25 F .134(If there is a redirection error)5.134 F(,)-.4 E (the return status is 1.)144 530.4 Q F1(exit)108 547.2 Q F0([)2.5 E F2 -(n)A F0 6.29(]C)C .095(ause the shell to e)-6.29 F .095 -(xit with a status of)-.15 F F2(n)2.595 E F0 5.095(.I)C(f)-5.095 E F2(n) -2.955 E F0 .096(is omitted, the e)2.835 F .096 +(n)A F0 6.29(]C)C .096(ause the shell to e)-6.29 F .096 +(xit with a status of)-.15 F F2(n)2.596 E F0 5.096(.I)C(f)-5.096 E F2(n) +2.955 E F0 .095(is omitted, the e)2.835 F .095 (xit status is that of the last command)-.15 F -.15(exe)144 559.2 S 2.5 (cuted. A).15 F(trap on)2.5 E F3(EXIT)2.5 E F0(is e)2.25 E -.15(xe)-.15 G(cuted before the shell terminates.).15 E F1(export)108 576 Q F0([)2.5 E F1(\255fn)A F0 2.5(][).833 G F2(name)-2.5 E F0([=)A F2(wor)A(d)-.37 E -F0(]] ...)A F1(export \255p)108 588 Q F0 .257(The supplied)144 600 R F2 +F0(]] ...)A F1(export \255p)108 588 Q F0 .256(The supplied)144 600 R F2 (names)3.117 E F0 .257(are mark)3.027 F .257(ed for automatic e)-.1 F .257(xport to the en)-.15 F .257(vironment of subsequently e)-.4 F -.15 -(xe)-.15 G(cuted).15 E 2.626(commands. If)144 612 R(the)2.626 E F1 -2.626 E F0 .127(option is gi)2.627 F -.15(ve)-.25 G .127(n, the).15 F F2 +(xe)-.15 G(cuted).15 E 2.627(commands. If)144 612 R(the)2.627 E F1 +2.627 E F0 .127(option is gi)2.627 F -.15(ve)-.25 G .127(n, the).15 F F2 (names)2.987 E F0 .127(refer to functions.)2.897 F .127(If no)5.127 F F2 -(names)2.987 E F0 .127(are gi)2.897 F -.15(ve)-.25 G .127(n, or if the) -.15 F F1144 624 Q F0 .66 -(option is supplied, a list of all names that are e)3.16 F .659 -(xported in this shell is printed.)-.15 F(The)5.659 E F13.159 E F0 -(option)3.159 E 1.586(causes the e)144 636 R 1.586 +(names)2.987 E F0 .127(are gi)2.897 F -.15(ve)-.25 G .126(n, or if the) +.15 F F1144 624 Q F0 .659 +(option is supplied, a list of all names that are e)3.159 F .66 +(xported in this shell is printed.)-.15 F(The)5.66 E F13.16 E F0 +(option)3.16 E 1.587(causes the e)144 636 R 1.587 (xport property to be remo)-.15 F -.15(ve)-.15 G 4.086(df).15 G 1.586 (rom each)-4.086 F F2(name)4.086 E F0 6.586(.I)C 4.086(fav)-6.586 G -1.587(ariable name is follo)-4.336 F 1.587(wed by)-.25 F(=)144 648 Q F2 -(wor)A(d)-.37 E F0 2.804(,t)C .304(he v)-2.804 F .304(alue of the v)-.25 +1.586(ariable name is follo)-4.336 F 1.586(wed by)-.25 F(=)144 648 Q F2 +(wor)A(d)-.37 E F0 2.803(,t)C .303(he v)-2.803 F .303(alue of the v)-.25 F .304(ariable is set to)-.25 F F2(wor)2.804 E(d)-.37 E F0(.)A F1 -(export)5.304 E F0 .304(returns an e)2.804 F .303 -(xit status of 0 unless an in)-.15 F -.25(va)-.4 G(lid).25 E .293 +(export)5.304 E F0 .304(returns an e)2.804 F .304 +(xit status of 0 unless an in)-.15 F -.25(va)-.4 G(lid).25 E .294 (option is encountered, one of the)144 660 R F2(names)2.793 E F0 .293 (is not a v)2.793 F .293(alid shell v)-.25 F .293(ariable name, or)-.25 -F F12.793 E F0 .294(is supplied with a)2.793 F F2(name)144.36 672 +F F12.793 E F0 .293(is supplied with a)2.793 F F2(name)144.36 672 Q F0(that is not a function.)2.68 E F1(fc)108 688.8 Q F0([)2.5 E F1 A F2(ename)2.5 E F0 2.5(][)C F1(\255nlr)-2.5 E F0 2.5(][)C F2 <8c72>-2.5 E(st)-.1 E F0 2.5(][)C F2(last)-2.5 E F0(])A F1(fc \255s)108 700.8 Q F0([)2.5 E F2(pat)A F0(=)A F2 -.37(re)C(p).37 E F0 2.5(][)C F2 -(cmd)-2.5 E F0(])A .478(Fix Command.)144 712.8 R .478 -(In the \214rst form, a range of commands from)5.478 F F2<8c72>4.888 E -(st)-.1 E F0(to)3.658 E F2(last)3.068 E F0 .477 -(is selected from the his-)3.658 F .881(tory list.)144 724.8 R F2 -.45 -(Fi)5.881 G -.1(rs).45 G(t).1 E F0(and)4.061 E F2(last)3.471 E F0 .882 +(cmd)-2.5 E F0(])A .477(Fix Command.)144 712.8 R .478 +(In the \214rst form, a range of commands from)5.477 F F2<8c72>4.888 E +(st)-.1 E F0(to)3.658 E F2(last)3.068 E F0 .478 +(is selected from the his-)3.658 F .882(tory list.)144 724.8 R F2 -.45 +(Fi)5.882 G -.1(rs).45 G(t).1 E F0(and)4.062 E F2(last)3.472 E F0 .882 (may be speci\214ed as a string \(to locate the last command be)4.062 F -.882(ginning with)-.15 F(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(49) +.881(ginning with)-.15 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(49) 199.835 E 0 Cg EP %%Page: 50 50 %%BeginPageSetup @@ -5777,14 +5782,14 @@ BP /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E .797(that string\) or as a number \(an inde)144 84 R 3.297(xi) -.15 G .797(nto the history list, where a ne)-3.297 F -.05(ga)-.15 G(ti) -.05 E 1.097 -.15(ve n)-.25 H .796(umber is used as an).15 F(of)144 96 Q -.276(fset from the current command number\).)-.25 F(If)5.276 E/F1 10 -/Times-Italic@0 SF(last)2.866 E F0 .277 -(is not speci\214ed it is set to the current command)3.456 F .093 +.05 E 1.097 -.15(ve n)-.25 H .797(umber is used as an).15 F(of)144 96 Q +.277(fset from the current command number\).)-.25 F(If)5.277 E/F1 10 +/Times-Italic@0 SF(last)2.867 E F0 .276 +(is not speci\214ed it is set to the current command)3.457 F .092 (for listing \(so that)144 108 R/F2 10/Courier@0 SF .092 (fc \255l \25510)2.592 F F0 .092(prints the last 10 commands\) and to) 2.592 F F1<8c72>4.502 E(st)-.1 E F0 2.592(otherwise. If)3.272 F F1<8c72> -4.502 E(st)-.1 E F0 .092(is not)3.272 F +4.502 E(st)-.1 E F0 .093(is not)3.273 F (speci\214ed it is set to the pre)144 120 Q (vious command for editing and \25516 for listing.)-.25 E(The)144 144 Q /F3 10/Times-Bold@0 SF2.522 E F0 .022 @@ -5793,162 +5798,162 @@ F32.522 E F0 .022(option re)2.522 F -.15(ve)-.25 G .022 (rses the order of).15 F .438(the commands.)144 156 R .438(If the)5.438 F F32.938 E F0 .438(option is gi)2.938 F -.15(ve)-.25 G .438 (n, the commands are listed on standard output.).15 F(Otherwise,)5.438 E -.334(the editor gi)144 168 R -.15(ve)-.25 G 2.834(nb).15 G(y)-2.834 E F1 -(ename)3.024 E F0 .335(is in)3.014 F -.2(vo)-.4 G -.1(ke).2 G 2.835(do) +.335(the editor gi)144 168 R -.15(ve)-.25 G 2.835(nb).15 G(y)-2.835 E F1 +(ename)3.025 E F0 .335(is in)3.015 F -.2(vo)-.4 G -.1(ke).2 G 2.835(do) .1 G 2.835(na\214)-2.835 G .335(le containing those commands.)-2.835 F -(If)5.335 E F1(ename)3.025 E F0 .335(is not gi)3.015 F -.15(ve)-.25 G -(n,).15 E .631(the v)144 180 R .631(alue of the)-.25 F/F4 9/Times-Bold@0 -SF(FCEDIT)3.131 E F0 -.25(va)2.881 G .631(riable is used, and the v).25 -F .631(alue of)-.25 F F4(EDIT)3.131 E(OR)-.162 E F0(if)2.881 E F4 -(FCEDIT)3.13 E F0 .63(is not set.)2.88 F .63(If nei-)5.63 F .95(ther v) -144 192 R .95(ariable is set,)-.25 F F1(vi)5.116 E F0 .95(is used.)5.116 -F .951(When editing is complete, the edited commands are echoed and)5.95 -F -.15(exe)144 204 S(cuted.).15 E .04(In the second form,)144 228 R F1 -(command)2.54 E F0 .04(is re-e)2.54 F -.15(xe)-.15 G .039 -(cuted after each instance of).15 F F1(pat)2.539 E F0 .039 -(is replaced by)2.539 F F1 -.37(re)2.539 G(p).37 E F0 5.039(.A)C(useful) --2.5 E .406(alias to use with this is)144 240 R F2 .406(r='fc \255s') -2.906 F F0 2.906(,s)C 2.906(ot)-2.906 G .406(hat typing)-2.906 F F2 -6.406(rc)2.906 G(c)-6.406 E F0 .406(runs the last command be)2.906 F -.407(ginning with)-.15 F F2(cc)144 252 Q F0(and typing)2.5 E F2(r)2.5 E -F0(re-e)2.5 E -.15(xe)-.15 G(cutes the last command.).15 E .142 +(If)5.334 E F1(ename)3.024 E F0 .334(is not gi)3.014 F -.15(ve)-.25 G +(n,).15 E .63(the v)144 180 R .63(alue of the)-.25 F/F4 9/Times-Bold@0 +SF(FCEDIT)3.13 E F0 -.25(va)2.88 G .631(riable is used, and the v).25 F +.631(alue of)-.25 F F4(EDIT)3.131 E(OR)-.162 E F0(if)2.881 E F4(FCEDIT) +3.131 E F0 .631(is not set.)2.881 F .631(If nei-)5.631 F .951(ther v)144 +192 R .951(ariable is set,)-.25 F F1(vi)5.117 E F0 .951(is used.)5.117 F +.95(When editing is complete, the edited commands are echoed and)5.951 F +-.15(exe)144 204 S(cuted.).15 E .039(In the second form,)144 228 R F1 +(command)2.539 E F0 .039(is re-e)2.539 F -.15(xe)-.15 G .039 +(cuted after each instance of).15 F F1(pat)2.54 E F0 .04(is replaced by) +2.54 F F1 -.37(re)2.54 G(p).37 E F0 5.04(.A)C(useful)-2.5 E .406 +(alias to use with this is)144 240 R F2 .406(r='fc \255s')2.906 F F0 +2.906(,s)C 2.906(ot)-2.906 G .406(hat typing)-2.906 F F2 6.406(rc)2.906 +G(c)-6.406 E F0 .406(runs the last command be)2.906 F .406(ginning with) +-.15 F F2(cc)144 252 Q F0(and typing)2.5 E F2(r)2.5 E F0(re-e)2.5 E -.15 +(xe)-.15 G(cutes the last command.).15 E .142 (If the \214rst form is used, the return v)144 276 R .142 (alue is 0 unless an in)-.25 F -.25(va)-.4 G .142 (lid option is encountered or).25 F F1<8c72>4.552 E(st)-.1 E F0(or)3.322 -E F1(last)2.732 E F0 .454(specify history lines out of range.)144 288 R +E F1(last)2.732 E F0 .455(specify history lines out of range.)144 288 R .454(If the)5.454 F F32.954 E F0 .454 -(option is supplied, the return v)2.954 F .455(alue is the v)-.25 F .455 -(alue of the)-.25 F .788(last command e)144 300 R -.15(xe)-.15 G .788 -(cuted or f).15 F .787 +(option is supplied, the return v)2.954 F .454(alue is the v)-.25 F .454 +(alue of the)-.25 F .787(last command e)144 300 R -.15(xe)-.15 G .787 +(cuted or f).15 F .788 (ailure if an error occurs with the temporary \214le of commands.)-.1 F -.787(If the)5.787 F 1.135 +.788(If the)5.788 F 1.136 (second form is used, the return status is that of the command re-e)144 -312 R -.15(xe)-.15 G 1.136(cuted, unless).15 F F1(cmd)3.836 E F0 1.136 -(does not)4.406 F(specify a v)144 324 Q +312 R -.15(xe)-.15 G 1.135(cuted, unless).15 F F1(cmd)3.835 E F0 1.135 +(does not)4.405 F(specify a v)144 324 Q (alid history line, in which case)-.25 E F3(fc)2.5 E F0(returns f)2.5 E (ailure.)-.1 E F3(fg)108 340.8 Q F0([)2.5 E F1(jobspec)A F0(])A(Resume) -144 352.8 Q F1(jobspec)5.654 E F0 1.413(in the fore)4.224 F 1.413 +144 352.8 Q F1(jobspec)5.653 E F0 1.413(in the fore)4.223 F 1.413 (ground, and mak)-.15 F 3.913(ei)-.1 G 3.913(tt)-3.913 G 1.413 (he current job)-3.913 F 6.413(.I)-.4 G(f)-6.413 E F1(jobspec)5.653 E F0 -1.413(is not present, the)4.223 F(shell')144 364.8 Q 3.116(sn)-.55 G -.616(otion of the)-3.116 F F1(curr)3.116 E .616(ent job)-.37 F F0 .617 -(is used.)3.116 F .617(The return v)5.617 F .617 +1.414(is not present, the)4.223 F(shell')144 364.8 Q 3.117(sn)-.55 G +.617(otion of the)-3.117 F F1(curr)3.117 E .617(ent job)-.37 F F0 .617 +(is used.)3.117 F .617(The return v)5.617 F .616 (alue is that of the command placed into the)-.25 F(fore)144 376.8 Q -.363(ground, or f)-.15 F .363 -(ailure if run when job control is disabled or)-.1 F 2.862(,w)-.4 G .362 +.362(ground, or f)-.15 F .362 +(ailure if run when job control is disabled or)-.1 F 2.862(,w)-.4 G .363 (hen run with job control enabled, if)-2.862 F F1(jobspec)145.74 388.8 Q -F0 .004(does not specify a v)2.814 F .004(alid job or)-.25 F F1(jobspec) +F0 .004(does not specify a v)2.815 F .004(alid job or)-.25 F F1(jobspec) 4.244 E F0 .004(speci\214es a job that w)2.814 F .004 (as started without job control.)-.1 F F3(getopts)108 405.6 Q F1 (optstring name)2.5 E F0([)2.5 E F1(ar)A(gs)-.37 E F0(])A F3(getopts)144 417.6 Q F0 .793 -(is used by shell procedures to parse positional parameters.)3.294 F F1 -(optstring)6.023 E F0 .793(contains the option)3.513 F .149 -(characters to be recognized; if a character is follo)144 429.6 R .15 -(wed by a colon, the option is e)-.25 F .15(xpected to ha)-.15 F .45 --.15(ve a)-.2 H(n).15 E(ar)144 441.6 Q .579 -(gument, which should be separated from it by white space.)-.18 F .578 +(is used by shell procedures to parse positional parameters.)3.293 F F1 +(optstring)6.023 E F0 .793(contains the option)3.513 F .15 +(characters to be recognized; if a character is follo)144 429.6 R .149 +(wed by a colon, the option is e)-.25 F .149(xpected to ha)-.15 F .449 +-.15(ve a)-.2 H(n).15 E(ar)144 441.6 Q .578 +(gument, which should be separated from it by white space.)-.18 F .579 (The colon and question mark char)5.579 F(-)-.2 E 1.665 (acters may not be used as option characters.)144 453.6 R 1.665 (Each time it is in)6.665 F -.2(vo)-.4 G -.1(ke).2 G(d,).1 E F3(getopts) -4.165 E F0 1.665(places the ne)4.165 F(xt)-.15 E .797 -(option in the shell v)144 465.6 R(ariable)-.25 E F1(name)3.297 E F0 -3.297(,i).18 G(nitializing)-3.297 E F1(name)3.657 E F0 .797 -(if it does not e)3.477 F .796(xist, and the inde)-.15 F 3.296(xo)-.15 G -3.296(ft)-3.296 G .796(he ne)-3.296 F(xt)-.15 E(ar)144 477.6 Q .085 +4.165 E F0 1.665(places the ne)4.165 F(xt)-.15 E .796 +(option in the shell v)144 465.6 R(ariable)-.25 E F1(name)3.296 E F0 +3.296(,i).18 G(nitializing)-3.296 E F1(name)3.657 E F0 .797 +(if it does not e)3.477 F .797(xist, and the inde)-.15 F 3.297(xo)-.15 G +3.297(ft)-3.297 G .797(he ne)-3.297 F(xt)-.15 E(ar)144 477.6 Q .085 (gument to be processed into the v)-.18 F(ariable)-.25 E F4(OPTIND)2.585 E/F5 9/Times-Roman@0 SF(.)A F4(OPTIND)4.585 E F0 .085 -(is initialized to 1 each time the shell)2.335 F .846 +(is initialized to 1 each time the shell)2.335 F .845 (or a shell script is in)144 489.6 R -.2(vo)-.4 G -.1(ke).2 G 3.345 (d. When).1 F .845(an option requires an ar)3.345 F(gument,)-.18 E F3 -(getopts)3.345 E F0 .845(places that ar)3.345 F(gument)-.18 E .803 -(into the v)144 501.6 R(ariable)-.25 E F4(OPT)3.303 E(ARG)-.81 E F5(.)A -F0 .803(The shell does not reset)5.303 F F4(OPTIND)3.303 E F0 .804 -(automatically; it must be manually)3.054 F .294 +(getopts)3.346 E F0 .846(places that ar)3.346 F(gument)-.18 E .804 +(into the v)144 501.6 R(ariable)-.25 E F4(OPT)3.304 E(ARG)-.81 E F5(.)A +F0 .803(The shell does not reset)5.304 F F4(OPTIND)3.303 E F0 .803 +(automatically; it must be manually)3.053 F .293 (reset between multiple calls to)144 513.6 R F3(getopts)2.793 E F0 .293 (within the same shell in)2.793 F -.2(vo)-.4 G .293(cation if a ne).2 F -2.793(ws)-.25 G .293(et of parameters)-2.793 F(is to be used.)144 525.6 -Q 2.043(When the end of options is encountered,)144 549.6 R F3(getopts) -4.543 E F0 -.15(ex)4.543 G 2.043(its with a return v).15 F 2.044 +2.793(ws)-.25 G .294(et of parameters)-2.793 F(is to be used.)144 525.6 +Q 2.044(When the end of options is encountered,)144 549.6 R F3(getopts) +4.543 E F0 -.15(ex)4.543 G 2.043(its with a return v).15 F 2.043 (alue greater than zero.)-.25 F F3(OPTIND)144 561.6 Q F0 (is set to the inde)2.5 E 2.5(xo)-.15 G 2.5(ft)-2.5 G (he \214rst non-option ar)-2.5 E(gument, and)-.18 E F3(name)2.5 E F0 -(is set to ?.)2.5 E F3(getopts)144 585.6 Q F0 2.393 -(normally parses the positional parameters, b)4.893 F 2.392 -(ut if more ar)-.2 F 2.392(guments are gi)-.18 F -.15(ve)-.25 G 4.892 -(ni).15 G(n)-4.892 E F1(ar)4.892 E(gs)-.37 E F0(,).27 E F3(getopts)144 -597.6 Q F0(parses those instead.)2.5 E F3(getopts)144 621.6 Q F0 1.165 -(can report errors in tw)3.665 F 3.665(ow)-.1 G 3.665(ays. If)-3.765 F -1.165(the \214rst character of)3.665 F F1(optstring)3.895 E F0 1.166 -(is a colon,)3.886 F F1(silent)4.006 E F0(error)4.346 E 1.264 +(is set to ?.)2.5 E F3(getopts)144 585.6 Q F0 2.392 +(normally parses the positional parameters, b)4.892 F 2.392 +(ut if more ar)-.2 F 2.393(guments are gi)-.18 F -.15(ve)-.25 G 4.893 +(ni).15 G(n)-4.893 E F1(ar)4.893 E(gs)-.37 E F0(,).27 E F3(getopts)144 +597.6 Q F0(parses those instead.)2.5 E F3(getopts)144 621.6 Q F0 1.166 +(can report errors in tw)3.666 F 3.665(ow)-.1 G 3.665(ays. If)-3.765 F +1.165(the \214rst character of)3.665 F F1(optstring)3.895 E F0 1.165 +(is a colon,)3.885 F F1(silent)4.005 E F0(error)4.345 E 1.263 (reporting is used.)144 633.6 R 1.263 (In normal operation diagnostic messages are printed when in)6.263 F --.25(va)-.4 G 1.263(lid options or).25 F .393(missing option ar)144 -645.6 R .393(guments are encountered.)-.18 F .394(If the v)5.394 F +-.25(va)-.4 G 1.263(lid options or).25 F .394(missing option ar)144 +645.6 R .394(guments are encountered.)-.18 F .394(If the v)5.394 F (ariable)-.25 E F4(OPTERR)2.894 E F0 .394 (is set to 0, no error messages)2.644 F(will be displayed, e)144 657.6 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he \214rst character of)-2.5 E -F1(optstring)2.73 E F0(is not a colon.)2.72 E .667(If an in)144 681.6 R --.25(va)-.4 G .667(lid option is seen,).25 F F3(getopts)3.167 E F0 .667 -(places ? into)3.167 F F1(name)3.527 E F0 .666 -(and, if not silent, prints an error message)3.347 F .399(and unsets)144 -693.6 R F4(OPT)2.899 E(ARG)-.81 E F5(.)A F0(If)4.899 E F3(getopts)2.899 -E F0 .399(is silent, the option character found is placed in)2.899 F F4 -(OPT)2.899 E(ARG)-.81 E F0 .4(and no)2.65 F -(diagnostic message is printed.)144 705.6 Q 1.242(If a required ar)144 -729.6 R 1.242(gument is not found, and)-.18 F F3(getopts)3.741 E F0 -1.241(is not silent, a question mark \()3.741 F F3(?).833 E F0 3.741 -(\)i).833 G 3.741(sp)-3.741 G 1.241(laced in)-3.741 F(GNU Bash-3.0)72 -768 Q(2004 Jan 24)149.845 E(50)199.835 E 0 Cg EP +F1(optstring)2.73 E F0(is not a colon.)2.72 E .666(If an in)144 681.6 R +-.25(va)-.4 G .666(lid option is seen,).25 F F3(getopts)3.166 E F0 .667 +(places ? into)3.167 F F1(name)3.527 E F0 .667 +(and, if not silent, prints an error message)3.347 F .4(and unsets)144 +693.6 R F4(OPT)2.9 E(ARG)-.81 E F5(.)A F0(If)4.899 E F3(getopts)2.899 E +F0 .399(is silent, the option character found is placed in)2.899 F F4 +(OPT)2.899 E(ARG)-.81 E F0 .399(and no)2.649 F +(diagnostic message is printed.)144 705.6 Q 1.241(If a required ar)144 +729.6 R 1.241(gument is not found, and)-.18 F F3(getopts)3.741 E F0 +1.241(is not silent, a question mark \()3.741 F F3(?).833 E F0 3.742 +(\)i).833 G 3.742(sp)-3.742 G 1.242(laced in)-3.742 F(GNU Bash-3.0)72 +768 Q(2004 Jan 28)149.845 E(50)199.835 E 0 Cg EP %%Page: 51 51 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Times-Italic@0 SF(name)144 84 Q F0(,).18 E/F2 9 -/Times-Bold@0 SF(OPT)2.734 E(ARG)-.81 E F0 .234 -(is unset, and a diagnostic message is printed.)2.484 F(If)5.234 E/F3 10 -/Times-Bold@0 SF(getopts)2.734 E F0 .235(is silent, then a colon \() +/Times-Bold@0 SF(OPT)2.735 E(ARG)-.81 E F0 .234 +(is unset, and a diagnostic message is printed.)2.485 F(If)5.234 E/F3 10 +/Times-Bold@0 SF(getopts)2.734 E F0 .234(is silent, then a colon \() 2.734 F F3(:).833 E F0(\)).833 E(is placed in)144 96 Q F1(name)2.86 E F0 (and)2.68 E F2(OPT)2.5 E(ARG)-.81 E F0 (is set to the option character found.)2.25 E F3(getopts)144 120 Q F0 .902(returns true if an option, speci\214ed or unspeci\214ed, is found.) -3.402 F .902(It returns f)5.902 F .901(alse if the end of)-.1 F +3.401 F .902(It returns f)5.902 F .902(alse if the end of)-.1 F (options is encountered or an error occurs.)144 132 Q F3(hash)108 148.8 Q F0([)2.5 E F3(\255lr)A F0 2.5(][)C F3-2.5 E F1(\214lename)2.5 E F0 2.5(][)C F3(\255dt)-2.5 E F0 2.5(][)C F1(name)-2.5 E F0(])A -.15(Fo) -144 160.8 S 3.554(re).15 G(ach)-3.554 E F1(name)3.554 E F0 3.554(,t).18 +144 160.8 S 3.555(re).15 G(ach)-3.555 E F1(name)3.555 E F0 3.555(,t).18 G 1.054(he full \214le name of the command is determined by searching t\ -he directories in)-3.554 F F3($P)144 172.8 Q -.95(AT)-.74 G(H).95 E F0 -.35(and remembered.)2.85 F .35(If the)5.35 F F32.85 E F0 .349 +he directories in)-3.555 F F3($P)144 172.8 Q -.95(AT)-.74 G(H).95 E F0 +.349(and remembered.)2.849 F .349(If the)5.349 F F32.849 E F0 .349 (option is supplied, no path search is performed, and)2.849 F F1 -(\214lename)4.759 E F0 .452 +(\214lename)4.76 E F0 .452 (is used as the full \214le name of the command.)144 184.8 R(The)5.452 E -F32.952 E F0 .452(option causes the shell to for)2.952 F .453 -(get all remem-)-.18 F .593(bered locations.)144 196.8 R(The)5.593 E F3 -3.093 E F0 .593(option causes the shell to for)3.093 F .592 -(get the remembered location of each)-.18 F F1(name)3.092 E F0(.)A .02 -(If the)144 208.8 R F32.52 E F0 .02 -(option is supplied, the full pathname to which each)2.52 F F1(name) -2.521 E F0 .021(corresponds is printed.)2.521 F .021(If multi-)5.021 F -(ple)144 220.8 Q F1(name)3.704 E F0(ar)3.704 E 1.204 +F32.952 E F0 .452(option causes the shell to for)2.952 F .452 +(get all remem-)-.18 F .592(bered locations.)144 196.8 R(The)5.592 E F3 +3.092 E F0 .593(option causes the shell to for)3.092 F .593 +(get the remembered location of each)-.18 F F1(name)3.093 E F0(.)A .021 +(If the)144 208.8 R F32.521 E F0 .021 +(option is supplied, the full pathname to which each)2.521 F F1(name) +2.52 E F0 .02(corresponds is printed.)2.52 F .02(If multi-)5.02 F(ple) +144 220.8 Q F1(name)3.703 E F0(ar)3.703 E 1.203 (guments are supplied with)-.18 F F33.703 E F0 3.703(,t)C(he) --3.703 E F1(name)3.703 E F0 1.203 +-3.703 E F1(name)3.703 E F0 1.204 (is printed before the hashed full pathname.)3.703 F(The)144 232.8 Q F3 -3.215 E F0 .715(option causes output to be displayed in a format \ -that may be reused as input.)3.215 F .716(If no ar)5.716 F(gu-)-.18 E -1.184(ments are gi)144 244.8 R -.15(ve)-.25 G 1.184(n, or if only).15 F -F33.684 E F0 1.183 +3.216 E F0 .715(option causes output to be displayed in a format \ +that may be reused as input.)3.216 F .715(If no ar)5.715 F(gu-)-.18 E +1.183(ments are gi)144 244.8 R -.15(ve)-.25 G 1.183(n, or if only).15 F +F33.683 E F0 1.184 (is supplied, information about remembered commands is printed.)3.684 F (The return status is true unless a)144 256.8 Q F1(name)2.86 E F0 (is not found or an in)2.68 E -.25(va)-.4 G(lid option is supplied.).25 E F3(help)108 273.6 Q F0([)2.5 E F3A F0 2.5(][)C F1(pattern)-2.5 E -F0(])A .866(Display helpful information about b)144 285.6 R .867 -(uiltin commands.)-.2 F(If)5.867 E F1(pattern)4.617 E F0 .867 -(is speci\214ed,)3.607 F F3(help)3.367 E F0(gi)3.367 E -.15(ve)-.25 G -3.367(sd).15 G(etailed)-3.367 E .307(help on all commands matching)144 -297.6 R F1(pattern)2.807 E F0 2.807(;o).24 G .307 -(therwise help for all the b)-2.807 F .306 +F0(])A .867(Display helpful information about b)144 285.6 R .867 +(uiltin commands.)-.2 F(If)5.867 E F1(pattern)4.617 E F0 .866 +(is speci\214ed,)3.607 F F3(help)3.366 E F0(gi)3.366 E -.15(ve)-.25 G +3.366(sd).15 G(etailed)-3.366 E .306(help on all commands matching)144 +297.6 R F1(pattern)2.806 E F0 2.807(;o).24 G .307 +(therwise help for all the b)-2.807 F .307 (uiltins and shell control struc-)-.2 F .596(tures is printed.)144 309.6 R(The)5.596 E F33.096 E F0 .596 (option restricts the information displayed to a short usage synopsis.) @@ -5961,16 +5966,16 @@ F0(])A F3(history \255p)108 386.4 Q F1(ar)2.5 E(g)-.37 E F0([)2.5 E F1 2.5 E(g)-.37 E F0([)2.5 E F1(ar)A 2.5(g.)-.37 G(..)-2.5 E F0(])A -.4(Wi) 144 410.4 S .752 (th no options, display the command history list with line numbers.).4 F -.752(Lines listed with a)5.752 F F3(*)3.251 E F0(ha)3.251 E -.15(ve)-.2 -G 1.23(been modi\214ed.)144 422.4 R 1.23(An ar)6.23 F 1.23(gument of) --.18 F F1(n)4.09 E F0 1.231(lists only the last)3.97 F F1(n)4.091 E F0 -3.731(lines. If)3.971 F 1.231(the shell v)3.731 F(ariable)-.25 E F3 -(HISTTIME-)3.731 E(FORMA)144 434.4 Q(T)-.95 E F0 .25 -(is set and not null, it is used as a format string for)2.75 F F1 -(strftime)2.749 E F0 .249(\(3\) to display the time stamp)B .378 -(associated with each displayed history entry)144 446.4 R 5.378(.N)-.65 -G 2.878(oi)-5.378 G(nterv)-2.878 E .379 -(ening blank is printed between the format-)-.15 F .815 +.752(Lines listed with a)5.752 F F3(*)3.252 E F0(ha)3.252 E -.15(ve)-.2 +G 1.231(been modi\214ed.)144 422.4 R 1.231(An ar)6.231 F 1.231 +(gument of)-.18 F F1(n)4.091 E F0 1.231(lists only the last)3.971 F F1 +(n)4.091 E F0 3.73(lines. If)3.97 F 1.23(the shell v)3.73 F(ariable)-.25 +E F3(HISTTIME-)3.73 E(FORMA)144 434.4 Q(T)-.95 E F0 .249 +(is set and not null, it is used as a format string for)2.749 F F1 +(strftime)2.75 E F0 .25(\(3\) to display the time stamp)B .379 +(associated with each displayed history entry)144 446.4 R 5.379(.N)-.65 +G 2.878(oi)-5.379 G(nterv)-2.878 E .378 +(ening blank is printed between the format-)-.15 F .814 (ted time stamp and the history line.)144 458.4 R(If)5.814 E F1 (\214lename)3.314 E F0 .814 (is supplied, it is used as the name of the history)3.314 F @@ -5979,28 +5984,28 @@ G 2.878(oi)-5.378 G(nterv)-2.878 E .379 (he follo).15 E(wing meanings:)-.25 E F3144 482.4 Q F0 (Clear the history list by deleting all the entries.)25.86 E F3144 494.4 Q F1(of)2.5 E(fset)-.18 E F0(Delete the history entry at position) -180 506.4 Q F1(of)2.5 E(fset)-.18 E F0(.)A F3144 518.4 Q F0 .598 -(Append the `)25.3 F(`ne)-.74 E(w')-.25 E 3.098('h)-.74 G .598 -(istory lines \(history lines entered since the be)-3.098 F .599 +180 506.4 Q F1(of)2.5 E(fset)-.18 E F0(.)A F3144 518.4 Q F0 .599 +(Append the `)25.3 F(`ne)-.74 E(w')-.25 E 3.099('h)-.74 G .598 +(istory lines \(history lines entered since the be)-3.099 F .598 (ginning of the current)-.15 F F3(bash)180 530.4 Q F0 (session\) to the history \214le.)2.5 E F3144 542.4 Q F0 .854(Rea\ d the history lines not already read from the history \214le into the c\ -urrent history list.)24.74 F .772 +urrent history list.)24.74 F .773 (These are lines appended to the history \214le since the be)180 554.4 R -.773(ginning of the current)-.15 F F3(bash)3.273 E F0(ses-)3.273 E +.772(ginning of the current)-.15 F F3(bash)3.272 E F0(ses-)3.272 E (sion.)180 566.4 Q F3144 578.4 Q F0(Read the contents of the hist\ ory \214le and use them as the current history)25.86 E(.)-.65 E F3 144 590.4 Q F0(Write the current history to the history \214le, o)23.08 E -.15(ve)-.15 G(rwriting the history \214le').15 E 2.5(sc)-.55 G -(ontents.)-2.5 E F3144 602.4 Q F0 .626 +(ontents.)-2.5 E F3144 602.4 Q F0 .625 (Perform history substitution on the follo)24.74 F(wing)-.25 E F1(ar) -3.125 E(gs)-.37 E F0 .625(and display the result on the standard)3.125 F +3.125 E(gs)-.37 E F0 .626(and display the result on the standard)3.125 F 2.975(output. Does)180 614.4 R .475 (not store the results in the history list.)2.975 F(Each)5.475 E F1(ar) 2.975 E(g)-.37 E F0 .475(must be quoted to disable)2.975 F (normal history e)180 626.4 Q(xpansion.)-.15 E F3144 638.4 Q F0 -.363(Store the)26.41 F F1(ar)3.193 E(gs)-.37 E F0 .363 -(in the history list as a single entry)3.133 F 5.363(.T)-.65 G .362 +.362(Store the)26.41 F F1(ar)3.192 E(gs)-.37 E F0 .363 +(in the history list as a single entry)3.132 F 5.363(.T)-.65 G .363 (he last command in the history list is)-5.363 F(remo)180 650.4 Q -.15 (ve)-.15 G 2.5(db).15 G(efore the)-2.5 E F1(ar)2.83 E(gs)-.37 E F0 (are added.)2.77 E .28(If the)144 667.2 R F3(HISTTIMEFORMA)2.78 E(T)-.95 @@ -6011,10 +6016,10 @@ E F0 .28 .216(lid option is encountered, an error).25 F .422 (occurs while reading or writing the history \214le, an in)144 691.2 R -.25(va)-.4 G(lid).25 E F1(of)2.922 E(fset)-.18 E F0 .422 -(is supplied as an ar)2.922 F .422(gument to)-.18 F F32.922 E F0 +(is supplied as an ar)2.922 F .421(gument to)-.18 F F32.921 E F0 (,)A(or the history e)144 703.2 Q(xpansion supplied as an ar)-.15 E (gument to)-.18 E F32.5 E F0 -.1(fa)2.5 G(ils.).1 E(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(51)199.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(51)199.835 E 0 Cg EP %%Page: 52 52 %%BeginPageSetup BP @@ -6028,20 +6033,20 @@ E(The \214rst form lists the acti)144 108 Q .3 -.15(ve j)-.25 H 2.5 (wing meanings:)-.25 E F1144 120 Q F0 (List process IDs in addition to the normal information.)27.52 E F1 144 132 Q F0(List only the process ID of the job')24.74 E 2.5(sp) --.55 G(rocess group leader)-2.5 E(.)-.55 E F1144 144 Q F0 .194 +-.55 G(rocess group leader)-2.5 E(.)-.55 E F1144 144 Q F0 .193 (Display information only about jobs that ha)24.74 F .494 -.15(ve c)-.2 -H .193(hanged status since the user w).15 F .193(as last noti-)-.1 F +H .194(hanged status since the user w).15 F .194(as last noti-)-.1 F (\214ed of their status.)180 156 Q F1144 168 Q F0 (Restrict output to running jobs.)25.86 E F1144 180 Q F0 (Restrict output to stopped jobs.)26.41 E(If)144 196.8 Q F2(jobspec) -4.553 E F0 .313(is gi)3.123 F -.15(ve)-.25 G .313 -(n, output is restricted to information about that job).15 F 5.314(.T) --.4 G .314(he return status is 0 unless)-5.314 F(an in)144 208.8 Q -.25 +4.554 E F0 .314(is gi)3.124 F -.15(ve)-.25 G .314 +(n, output is restricted to information about that job).15 F 5.313(.T) +-.4 G .313(he return status is 0 unless)-5.313 F(an in)144 208.8 Q -.25 (va)-.4 G(lid option is encountered or an in).25 E -.25(va)-.4 G(lid).25 -E F2(jobspec)4.24 E F0(is supplied.)2.81 E .395(If the)144 225.6 R F1 -2.895 E F0 .394(option is supplied,)2.894 F F1(jobs)2.894 E F0 +E F2(jobspec)4.24 E F0(is supplied.)2.81 E .394(If the)144 225.6 R F1 +2.894 E F0 .394(option is supplied,)2.894 F F1(jobs)2.894 E F0 .394(replaces an)2.894 F(y)-.15 E F2(jobspec)4.634 E F0 .394(found in) -3.204 F F2(command)3.094 E F0(or)3.664 E F2(ar)3.224 E(gs)-.37 E F0 .394 +3.204 F F2(command)3.094 E F0(or)3.664 E F2(ar)3.224 E(gs)-.37 E F0 .395 (with the corre-)3.164 F(sponding process group ID, and e)144 237.6 Q -.15(xe)-.15 G(cutes).15 E F2(command)2.7 E F0(passing it)3.27 E F2(ar) 2.5 E(gs)-.37 E F0 2.5(,r).27 G(eturning its e)-2.5 E(xit status.)-.15 E @@ -6049,66 +6054,66 @@ F1(kill)108 254.4 Q F0([)2.5 E F1A F2(sigspec)2.5 E F0(|)2.5 E F1 2.5 E F2(signum)2.5 E F0(|)2.5 E F12.5 E F2(sigspec)A F0 2.5 (][)C F2(pid)-2.5 E F0(|)2.5 E F2(jobspec)2.5 E F0 2.5(].)C(..)-2.5 E F1 (kill \255l)108 266.4 Q F0([)2.5 E F2(sigspec)A F0(|)2.5 E F2 -.2(ex)2.5 -G(it_status).2 E F0(])A .119(Send the signal named by)144 278.4 R F2 -(sigspec)2.959 E F0(or)2.929 E F2(signum)2.959 E F0 .119 -(to the processes named by)2.939 F F2(pid)3.87 E F0(or)3.39 E F2 -(jobspec)2.62 E F0(.).31 E F2(sigspec)5.46 E F0(is)2.93 E .048 +G(it_status).2 E F0(])A .12(Send the signal named by)144 278.4 R F2 +(sigspec)2.96 E F0(or)2.93 E F2(signum)2.96 E F0 .119 +(to the processes named by)2.939 F F2(pid)3.869 E F0(or)3.389 E F2 +(jobspec)2.619 E F0(.).31 E F2(sigspec)5.459 E F0(is)2.929 E .047 (either a signal name such as)144 290.4 R/F3 9/Times-Bold@0 SF(SIGKILL) -2.548 E F0 .047(or a signal number;)2.298 F F2(signum)2.887 E F0 .047 -(is a signal number)2.867 F 5.047(.I)-.55 G(f)-5.047 E F2(sigspec)2.887 -E F0(is)2.857 E 3.394(as)144 302.4 S .894 -(ignal name, the name may be gi)-3.394 F -.15(ve)-.25 G 3.394(nw).15 G +2.547 E F0 .047(or a signal number;)2.297 F F2(signum)2.888 E F0 .048 +(is a signal number)2.868 F 5.048(.I)-.55 G(f)-5.048 E F2(sigspec)2.888 +E F0(is)2.858 E 3.395(as)144 302.4 S .894 +(ignal name, the name may be gi)-3.395 F -.15(ve)-.25 G 3.394(nw).15 G .894(ith or without the)-3.394 F F3(SIG)3.394 E F0 3.394(pre\214x. If) 3.144 F F2(sigspec)3.734 E F0 .894(is not present,)3.704 F(then)144 -314.4 Q F3(SIGTERM)3.073 E F0 .572(is assumed.)2.822 F .572(An ar)5.572 +314.4 Q F3(SIGTERM)3.072 E F0 .572(is assumed.)2.822 F .572(An ar)5.572 F .572(gument of)-.18 F F13.072 E F0 .572(lists the signal names.) 3.072 F .572(If an)5.572 F 3.072(ya)-.15 G -.18(rg)-3.072 G .572 -(uments are sup-).18 F .267(plied when)144 326.4 R F12.767 E F0 +(uments are sup-).18 F .268(plied when)144 326.4 R F12.767 E F0 .267(is gi)2.767 F -.15(ve)-.25 G .267 (n, the names of the signals corresponding to the ar).15 F .267 -(guments are listed, and the)-.18 F .288(return status is 0.)144 338.4 R -(The)5.288 E F2 -.2(ex)2.788 G(it_status).2 E F0(ar)2.788 E .288 -(gument to)-.18 F F12.788 E F0 .287 -(is a number specifying either a signal number or)2.788 F .551(the e)144 +(guments are listed, and the)-.18 F .287(return status is 0.)144 338.4 R +(The)5.287 E F2 -.2(ex)2.787 G(it_status).2 E F0(ar)2.787 E .288 +(gument to)-.18 F F12.788 E F0 .288 +(is a number specifying either a signal number or)2.788 F .552(the e)144 350.4 R .551(xit status of a process terminated by a signal.)-.15 F F1 -(kill)5.551 E F0 .551(returns true if at least one signal w)3.051 F .552 +(kill)5.551 E F0 .551(returns true if at least one signal w)3.051 F .551 (as suc-)-.1 F(cessfully sent, or f)144 362.4 Q (alse if an error occurs or an in)-.1 E -.25(va)-.4 G (lid option is encountered.).25 E F1(let)108 379.2 Q F2(ar)2.5 E(g)-.37 -E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(Each)144 391.2 Q F2(ar)3.965 -E(g)-.37 E F0 1.135(is an arithmetic e)3.855 F 1.134(xpression to be e) --.15 F -.25(va)-.25 G 1.134(luated \(see).25 F F3 1.134(ARITHMETIC EV) -3.634 F(ALU)-1.215 E -.855(AT)-.54 G(ION).855 E/F4 9/Times-Roman@0 SF -(\).)A F0 1.134(If the)5.634 F(last)144 403.2 Q F2(ar)2.83 E(g)-.37 E F0 +E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(Each)144 391.2 Q F2(ar)3.964 +E(g)-.37 E F0 1.134(is an arithmetic e)3.854 F 1.134(xpression to be e) +-.15 F -.25(va)-.25 G 1.135(luated \(see).25 F F3 1.135(ARITHMETIC EV) +3.635 F(ALU)-1.215 E -.855(AT)-.54 G(ION).855 E/F4 9/Times-Roman@0 SF +(\).)A F0 1.135(If the)5.635 F(last)144 403.2 Q F2(ar)2.83 E(g)-.37 E F0 -.25(eva)2.72 G(luates to 0,).25 E F1(let)2.5 E F0 (returns 1; 0 is returned otherwise.)2.5 E F1(local)108 420 Q F0([)2.5 E F2(option)A F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C (..])-2.5 E -.15(Fo)144 432 S 2.56(re).15 G .06(ach ar)-2.56 F .06 (gument, a local v)-.18 F .06(ariable named)-.25 F F2(name)2.92 E F0 .06 (is created, and assigned)2.74 F F2(value)2.56 E F0 5.06(.T).18 G(he) --5.06 E F2(option)2.56 E F0 .06(can be)2.56 F(an)144 444 Q 3.153(yo)-.15 -G 3.153(ft)-3.153 G .653(he options accepted by)-3.153 F F1(declar)3.153 -E(e)-.18 E F0 5.652(.W)C(hen)-5.652 E F1(local)3.152 E F0 .652 +-5.06 E F2(option)2.56 E F0 .06(can be)2.56 F(an)144 444 Q 3.152(yo)-.15 +G 3.152(ft)-3.152 G .652(he options accepted by)-3.152 F F1(declar)3.152 +E(e)-.18 E F0 5.652(.W)C(hen)-5.652 E F1(local)3.152 E F0 .653 (is used within a function, it causes the v)3.152 F(ari-)-.25 E(able)144 -456 Q F2(name)3.72 E F0 .86(to ha)3.54 F 1.16 -.15(ve a v)-.2 H .861 +456 Q F2(name)3.721 E F0 .861(to ha)3.541 F 1.161 -.15(ve a v)-.2 H .861 (isible scope restricted to that function and its children.).15 F -.4 -(Wi)5.861 G .861(th no operands,).4 F F1(local)144 468 Q F0 1.165 -(writes a list of local v)3.665 F 1.165 +(Wi)5.86 G .86(th no operands,).4 F F1(local)144 468 Q F0 1.164 +(writes a list of local v)3.664 F 1.165 (ariables to the standard output.)-.25 F 1.165(It is an error to use) -6.165 F F1(local)3.664 E F0 1.164(when not)3.664 F .232 -(within a function.)144 480 R .233(The return status is 0 unless)5.232 F +6.165 F F1(local)3.665 E F0 1.165(when not)3.665 F .233 +(within a function.)144 480 R .233(The return status is 0 unless)5.233 F F1(local)2.733 E F0 .233(is used outside a function, an in)2.733 F -.25 -(va)-.4 G(lid).25 E F2(name)3.093 E F0(is)2.913 E(supplied, or)144 492 Q +(va)-.4 G(lid).25 E F2(name)3.092 E F0(is)2.912 E(supplied, or)144 492 Q F2(name)2.5 E F0(is a readonly v)2.5 E(ariable.)-.25 E F1(logout)108 508.8 Q F0(Exit a login shell.)9.33 E F1(popd)108 525.6 Q F0<5bad>2.5 E F1(n)A F0 2.5(][)C(+)-2.5 E F2(n)A F0 2.5(][)C-2.5 E F2(n)A F0(])A -(Remo)144 537.6 Q -.15(ve)-.15 G 2.8(se).15 G .3 -(ntries from the directory stack.)-2.8 F -.4(Wi)5.299 G .299(th no ar).4 -F .299(guments, remo)-.18 F -.15(ve)-.15 G 2.799(st).15 G .299 -(he top directory from the)-2.799 F 1.478(stack, and performs a)144 -549.6 R F1(cd)3.978 E F0 1.479(to the ne)3.978 F 3.979(wt)-.25 G 1.479 -(op directory)-3.979 F 6.479(.A)-.65 G -.18(rg)-6.479 G 1.479 -(uments, if supplied, ha).18 F 1.779 -.15(ve t)-.2 H 1.479(he follo).15 +(Remo)144 537.6 Q -.15(ve)-.15 G 2.799(se).15 G .299 +(ntries from the directory stack.)-2.799 F -.4(Wi)5.299 G .299(th no ar) +.4 F .299(guments, remo)-.18 F -.15(ve)-.15 G 2.799(st).15 G .3 +(he top directory from the)-2.799 F 1.479(stack, and performs a)144 +549.6 R F1(cd)3.979 E F0 1.479(to the ne)3.979 F 3.979(wt)-.25 G 1.479 +(op directory)-3.979 F 6.479(.A)-.65 G -.18(rg)-6.479 G 1.478 +(uments, if supplied, ha).18 F 1.778 -.15(ve t)-.2 H 1.478(he follo).15 F(wing)-.25 E(meanings:)144 561.6 Q F1(+)144 573.6 Q F2(n)A F0(Remo)25.3 E -.15(ve)-.15 G 2.64(st).15 G(he)-2.64 E F2(n)2.64 E F0 .14 (th entry counting from the left of the list sho)B .14(wn by)-.25 F F1 @@ -6116,21 +6121,21 @@ E -.15(ve)-.15 G 2.64(st).15 G(he)-2.64 E F2(n)2.64 E F0 .14 585.6 S 2.5(re).15 G(xample:)-2.65 E/F5 10/Courier@0 SF(popd +0)2.5 E F0 (remo)2.5 E -.15(ve)-.15 G 2.5(st).15 G(he \214rst directory)-2.5 E(,) -.65 E F5(popd +1)2.5 E F0(the second.)2.5 E F1144 597.6 Q F2(n)A F0 -(Remo)25.3 E -.15(ve)-.15 G 3.759(st).15 G(he)-3.759 E F2(n)3.759 E F0 -1.259(th entry counting from the right of the list sho)B 1.26(wn by)-.25 -F F1(dirs)3.76 E F0 3.76(,s)C 1.26(tarting with)-3.76 F 2.5(zero. F)180 -609.6 R(or e)-.15 E(xample:)-.15 E F5(popd -0)2.5 E F0(remo)2.5 E -.15 -(ve)-.15 G 2.5(st).15 G(he last directory)-2.5 E(,)-.65 E F5(popd -1)2.5 -E F0(the ne)2.5 E(xt to last.)-.15 E F1144 621.6 Q F0 .551 -(Suppresses the normal change of directory when remo)24.74 F .551 -(ving directories from the stack, so)-.15 F -(that only the stack is manipulated.)180 633.6 Q .643(If the)144 650.4 R -F1(popd)3.143 E F0 .643(command is successful, a)3.143 F F1(dirs)3.143 E -F0 .644(is performed as well, and the return status is 0.)3.143 F F1 -(popd)5.644 E F0 .416(returns f)144 662.4 R .416(alse if an in)-.1 F +(Remo)25.3 E -.15(ve)-.15 G 3.76(st).15 G(he)-3.76 E F2(n)3.76 E F0 +1.259(th entry counting from the right of the list sho)B 1.259(wn by) +-.25 F F1(dirs)3.759 E F0 3.759(,s)C 1.259(tarting with)-3.759 F 2.5 +(zero. F)180 609.6 R(or e)-.15 E(xample:)-.15 E F5(popd -0)2.5 E F0 +(remo)2.5 E -.15(ve)-.15 G 2.5(st).15 G(he last directory)-2.5 E(,)-.65 +E F5(popd -1)2.5 E F0(the ne)2.5 E(xt to last.)-.15 E F1144 621.6 +Q F0 .551(Suppresses the normal change of directory when remo)24.74 F +.551(ving directories from the stack, so)-.15 F +(that only the stack is manipulated.)180 633.6 Q .644(If the)144 650.4 R +F1(popd)3.144 E F0 .644(command is successful, a)3.144 F F1(dirs)3.143 E +F0 .643(is performed as well, and the return status is 0.)3.143 F F1 +(popd)5.643 E F0 .415(returns f)144 662.4 R .415(alse if an in)-.1 F -.25(va)-.4 G .415 -(lid option is encountered, the directory stack is empty).25 F 2.915 -(,an)-.65 G(on-e)-2.915 E .415(xistent direc-)-.15 F +(lid option is encountered, the directory stack is empty).25 F 2.916 +(,an)-.65 G(on-e)-2.916 E .416(xistent direc-)-.15 F (tory stack entry is speci\214ed, or the directory change f)144 674.4 Q (ails.)-.1 E F1(printf)108 691.2 Q F2(format)2.5 E F0([)2.5 E F2(ar)A (guments)-.37 E F0(])A .372(Write the formatted)144 703.2 R F2(ar)2.872 @@ -6138,54 +6143,54 @@ E(guments)-.37 E F0 .372 (to the standard output under the control of the)2.872 F F2(format)2.872 E F0 5.372(.T)C(he)-5.372 E F2(format)2.872 E F0 1.804(is a character s\ tring which contains three types of objects: plain characters, which ar\ -e simply)144 715.2 R 1.858 +e simply)144 715.2 R 1.859 (copied to standard output, character escape sequences, which are con) -144 727.2 R -.15(ve)-.4 G 1.859(rted and copied to the).15 F -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(52)199.835 E 0 Cg EP +144 727.2 R -.15(ve)-.4 G 1.858(rted and copied to the).15 F +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(52)199.835 E 0 Cg EP %%Page: 53 53 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E 1.172(standard output, and format speci\214cations, each of whic\ -h causes printing of the ne)144 84 R 1.171(xt successi)-.15 F -.15(ve) --.25 G/F1 10/Times-Italic@0 SF(ar)144 96 Q(gument)-.37 E F0 6.273(.I)C -3.773(na)-6.273 G 1.274(ddition to the standard)-3.773 F F1(printf)3.774 +-.35 E 1.171(standard output, and format speci\214cations, each of whic\ +h causes printing of the ne)144 84 R 1.172(xt successi)-.15 F -.15(ve) +-.25 G/F1 10/Times-Italic@0 SF(ar)144 96 Q(gument)-.37 E F0 6.274(.I)C +3.774(na)-6.274 G 1.274(ddition to the standard)-3.774 F F1(printf)3.774 E F0 1.274(\(1\) formats,)B/F2 10/Times-Bold@0 SF(%b)3.774 E F0(causes) -3.774 E F2(printf)3.774 E F0 1.274(to e)3.774 F 1.274(xpand backslash) --.15 F .62(escape sequences in the corresponding)144 108 R F1(ar)3.119 E -(gument)-.37 E F0(\(e)3.119 E .619(xcept that)-.15 F F2(\\c)3.119 E F0 -.619(terminates output, backslashes in)3.119 F F2(\\')144 120 Q F0(,)A -F2(\\")2.953 E F0 2.953(,a)C(nd)-2.953 E F2(\\?)2.954 E F0 .454 +3.774 E F2(printf)3.774 E F0 1.273(to e)3.774 F 1.273(xpand backslash) +-.15 F .619(escape sequences in the corresponding)144 108 R F1(ar)3.119 +E(gument)-.37 E F0(\(e)3.119 E .619(xcept that)-.15 F F2(\\c)3.119 E F0 +.62(terminates output, backslashes in)3.119 F F2(\\')144 120 Q F0(,)A F2 +(\\")2.954 E F0 2.954(,a)C(nd)-2.954 E F2(\\?)2.954 E F0 .454 (are not remo)2.954 F -.15(ve)-.15 G .454(d, and octal escapes be).15 F .454(ginning with)-.15 F F2(\\0)2.954 E F0 .454 -(may contain up to four digits\),)2.954 F(and)144 132 Q F2(%q)2.568 E F0 -(causes)2.568 E F2(printf)2.568 E F0 .068(to output the corresponding) -2.568 F F1(ar)2.568 E(gument)-.37 E F0 .067 +(may contain up to four digits\),)2.954 F(and)144 132 Q F2(%q)2.567 E F0 +(causes)2.567 E F2(printf)2.567 E F0 .067(to output the corresponding) +2.567 F F1(ar)2.568 E(gument)-.37 E F0 .068 (in a format that can be reused as shell)2.568 F(input.)144 144 Q(The) -144 168 Q F1(format)3.423 E F0 .923 -(is reused as necessary to consume all of the)3.423 F F1(ar)3.423 E +144 168 Q F1(format)3.424 E F0 .923 +(is reused as necessary to consume all of the)3.424 F F1(ar)3.423 E (guments)-.37 E F0 5.923(.I)C 3.423(ft)-5.923 G(he)-3.423 E F1(format) -3.423 E F0 .924(requires more)3.424 F F1(ar)144 180 Q(guments)-.37 E F0 -.033(than are supplied, the e)2.534 F .033 +3.423 E F0 .923(requires more)3.423 F F1(ar)144 180 Q(guments)-.37 E F0 +.033(than are supplied, the e)2.533 F .033 (xtra format speci\214cations beha)-.15 F .333 -.15(ve a)-.2 H 2.533(si) -.15 G 2.533(faz)-2.533 G .033(ero v)-2.533 F .033(alue or null string,) +.15 G 2.533(faz)-2.533 G .033(ero v)-2.533 F .034(alue or null string,) -.25 F(as appropriate, had been supplied.)144 192 Q(The return v)5 E (alue is zero on success, non-zero on f)-.25 E(ailure.)-.1 E F2(pushd) 108 208.8 Q F0([)2.5 E F2A F0 2.5(][)C F1(dir)-2.5 E F0(])A F2 (pushd)108 220.8 Q F0([)2.5 E F2A F0 2.5(][)C(+)-2.5 E F1(n)A F0 -2.5(][)C-2.5 E F1(n)A F0(])A .639(Adds a directory to the top of th\ -e directory stack, or rotates the stack, making the ne)144 232.8 R 3.14 -(wt)-.25 G .64(op of the)-3.14 F 1.316(stack the current w)144 244.8 R -1.316(orking directory)-.1 F 6.316(.W)-.65 G 1.315(ith no ar)-6.716 F -1.315(guments, e)-.18 F 1.315(xchanges the top tw)-.15 F 3.815(od)-.1 G -1.315(irectories and)-3.815 F .871 +2.5(][)C-2.5 E F1(n)A F0(])A .64(Adds a directory to the top of the\ + directory stack, or rotates the stack, making the ne)144 232.8 R 3.139 +(wt)-.25 G .639(op of the)-3.139 F 1.315(stack the current w)144 244.8 R +1.315(orking directory)-.1 F 6.315(.W)-.65 G 1.315(ith no ar)-6.715 F +1.315(guments, e)-.18 F 1.316(xchanges the top tw)-.15 F 3.816(od)-.1 G +1.316(irectories and)-3.816 F .872 (returns 0, unless the directory stack is empty)144 256.8 R 5.871(.A) --.65 G -.18(rg)-5.871 G .872(uments, if supplied, ha).18 F 1.172 -.15 -(ve t)-.2 H .872(he follo).15 F .872(wing mean-)-.25 F(ings:)144 268.8 Q -F2(+)144 280.8 Q F1(n)A F0 1.268(Rotates the stack so that the)25.3 F F1 -(n)3.768 E F0 1.267 -(th directory \(counting from the left of the list sho)B 1.267(wn by) +-.65 G -.18(rg)-5.871 G .871(uments, if supplied, ha).18 F 1.171 -.15 +(ve t)-.2 H .871(he follo).15 F .871(wing mean-)-.25 F(ings:)144 268.8 Q +F2(+)144 280.8 Q F1(n)A F0 1.267(Rotates the stack so that the)25.3 F F1 +(n)3.767 E F0 1.268 +(th directory \(counting from the left of the list sho)B 1.268(wn by) -.25 F F2(dirs)180 292.8 Q F0 2.5(,s)C (tarting with zero\) is at the top.)-2.5 E F2144 304.8 Q F1(n)A F0 .92(Rotates the stack so that the)25.3 F F1(n)3.42 E F0 .92 @@ -6196,26 +6201,26 @@ ctory when adding directories to the stack, so that)24.74 F (only the stack is manipulated.)180 340.8 Q F1(dir)144.35 352.8 Q F0 (Adds)23.98 E F1(dir)2.85 E F0 (to the directory stack at the top, making it the ne)3.23 E 2.5(wc)-.25 -G(urrent w)-2.5 E(orking directory)-.1 E(.)-.65 E .488(If the)144 369.6 -R F2(pushd)2.988 E F0 .488(command is successful, a)2.988 F F2(dirs) -2.988 E F0 .488(is performed as well.)2.988 F .489 -(If the \214rst form is used,)5.488 F F2(pushd)2.989 E F0 1.04 -(returns 0 unless the cd to)144 381.6 R F1(dir)3.89 E F0 -.1(fa)4.27 G -3.539(ils. W).1 F 1.039(ith the second form,)-.4 F F2(pushd)3.539 E F0 -1.039(returns 0 unless the directory)3.539 F .846(stack is empty)144 -393.6 R 3.346(,an)-.65 G(on-e)-3.346 E .847(xistent directory stack ele\ -ment is speci\214ed, or the directory change to the)-.15 F -(speci\214ed ne)144 405.6 Q 2.5(wc)-.25 G(urrent directory f)-2.5 E -(ails.)-.1 E F2(pwd)108 422.4 Q F0([)2.5 E F2(\255LP)A F0(])A .845 +G(urrent w)-2.5 E(orking directory)-.1 E(.)-.65 E .489(If the)144 369.6 +R F2(pushd)2.989 E F0 .489(command is successful, a)2.989 F F2(dirs) +2.988 E F0 .488(is performed as well.)2.988 F .488 +(If the \214rst form is used,)5.488 F F2(pushd)2.988 E F0 1.039 +(returns 0 unless the cd to)144 381.6 R F1(dir)3.889 E F0 -.1(fa)4.269 G +3.539(ils. W).1 F 1.039(ith the second form,)-.4 F F2(pushd)3.54 E F0 +1.04(returns 0 unless the directory)3.54 F .847(stack is empty)144 393.6 +R 3.347(,an)-.65 G(on-e)-3.347 E .847(xistent directory stack element i\ +s speci\214ed, or the directory change to the)-.15 F(speci\214ed ne)144 +405.6 Q 2.5(wc)-.25 G(urrent directory f)-2.5 E(ails.)-.1 E F2(pwd)108 +422.4 Q F0([)2.5 E F2(\255LP)A F0(])A .844 (Print the absolute pathname of the current w)144 434.4 R .845 -(orking directory)-.1 F 5.844(.T)-.65 G .844 -(he pathname printed contains no)-5.844 F .181(symbolic links if the)144 +(orking directory)-.1 F 5.845(.T)-.65 G .845 +(he pathname printed contains no)-5.845 F .182(symbolic links if the)144 446.4 R F22.681 E F0 .181(option is supplied or the)2.681 F F2 .181(\255o ph)2.681 F(ysical)-.15 E F0 .181(option to the)2.681 F F2 -(set)2.681 E F0 -.2(bu)2.681 G .182(iltin command is).2 F 3.264 -(enabled. If)144 458.4 R(the)3.264 E F23.264 E F0 .763 -(option is used, the pathname printed may contain symbolic links.)3.264 -F .763(The return)5.763 F 1.36(status is 0 unless an error occurs while\ +(set)2.681 E F0 -.2(bu)2.681 G .181(iltin command is).2 F 3.263 +(enabled. If)144 458.4 R(the)3.263 E F23.263 E F0 .763 +(option is used, the pathname printed may contain symbolic links.)3.263 +F .764(The return)5.764 F 1.36(status is 0 unless an error occurs while\ reading the name of the current directory or an in)144 470.4 R -.25(va) -.4 G(lid).25 E(option is supplied.)144 482.4 Q F2 -.18(re)108 499.2 S (ad).18 E F0([)2.5 E F2(\255ers)A F0 2.5(][)C F2-2.5 E F1(fd)2.5 E @@ -6224,42 +6229,42 @@ F1(aname)2.5 E F0 2.5(][)C F2-2.5 E F1(pr)2.5 E(ompt)-.45 E F0 2.5 (][)C F2-2.5 E F1(nc)2.5 E(har)-.15 E(s)-.1 E F0 2.5(][)C F2 -2.5 E F1(delim)2.5 E F0 2.5(][)C F1(name)-2.5 E F0(...])2.5 E .516(One\ line is read from the standard input, or from the \214le descriptor)144 -511.2 R F1(fd)3.016 E F0 .516(supplied as an ar)3.016 F .516(gument to) --.18 F(the)144 523.2 Q F22.538 E F0 .038 -(option, and the \214rst w)2.538 F .038(ord is assigned to the \214rst) --.1 F F1(name)2.539 E F0 2.539(,t).18 G .039(he second w)-2.539 F .039 -(ord to the second)-.1 F F1(name)2.539 E F0(,).18 E .42 +511.2 R F1(fd)3.016 E F0 .516(supplied as an ar)3.016 F .517(gument to) +-.18 F(the)144 523.2 Q F22.539 E F0 .039 +(option, and the \214rst w)2.539 F .038(ord is assigned to the \214rst) +-.1 F F1(name)2.538 E F0 2.538(,t).18 G .038(he second w)-2.538 F .038 +(ord to the second)-.1 F F1(name)2.538 E F0(,).18 E .42 (and so on, with lefto)144 535.2 R -.15(ve)-.15 G 2.92(rw).15 G .42 (ords and their interv)-3.02 F .42 (ening separators assigned to the last)-.15 F F1(name)2.92 E F0 5.42(.I) -.18 G 2.92(ft)-5.42 G(here)-2.92 E .54(are fe)144 547.2 R .54(wer w)-.25 -F .541(ords read from the input stream than names, the remaining names \ -are assigned empty)-.1 F -.25(va)144 559.2 S 2.511(lues. The).25 F .011 -(characters in)2.511 F/F3 9/Times-Bold@0 SF(IFS)2.511 E F0 .011 +.18 G 2.92(ft)-5.42 G(here)-2.92 E .541(are fe)144 547.2 R .541(wer w) +-.25 F .541(ords read from the input stream than names, the remaining n\ +ames are assigned empty)-.1 F -.25(va)144 559.2 S 2.51(lues. The).25 F +.011(characters in)2.511 F/F3 9/Times-Bold@0 SF(IFS)2.511 E F0 .011 (are used to split the line into w)2.261 F 2.511(ords. The)-.1 F .011 -(backslash character \()2.511 F F2(\\)A F0 2.51(\)m)C(ay)-2.51 E 1.89 -(be used to remo)144 571.2 R 2.19 -.15(ve a)-.15 H 2.19 -.15(ny s).15 H -1.891(pecial meaning for the ne).15 F 1.891 +(backslash character \()2.511 F F2(\\)A F0 2.511(\)m)C(ay)-2.511 E 1.891 +(be used to remo)144 571.2 R 2.191 -.15(ve a)-.15 H 2.191 -.15(ny s).15 +H 1.891(pecial meaning for the ne).15 F 1.89 (xt character read and for line continuation.)-.15 F (Options, if supplied, ha)144 583.2 Q .3 -.15(ve t)-.2 H(he follo).15 E -(wing meanings:)-.25 E F2144 595.2 Q F1(aname)2.5 E F0 1.05(The w) -180 607.2 R 1.049 +(wing meanings:)-.25 E F2144 595.2 Q F1(aname)2.5 E F0 1.049 +(The w)180 607.2 R 1.049 (ords are assigned to sequential indices of the array v)-.1 F(ariable) --.25 E F1(aname)3.549 E F0 3.549(,s).18 G 1.049(tarting at 0.)-3.549 F -F1(aname)180.33 619.2 Q F0(is unset before an)2.68 E 2.5(yn)-.15 G .5 --.25(ew va)-2.5 H(lues are assigned.).25 E(Other)5 E F1(name)2.5 E F0 -(ar)2.5 E(guments are ignored.)-.18 E F2144 631.2 Q F1(delim)2.5 E -F0(The \214rst character of)180 643.2 Q F1(delim)2.5 E F0 +-.25 E F1(aname)3.55 E F0 3.55(,s).18 G 1.05(tarting at 0.)-3.55 F F1 +(aname)180.33 619.2 Q F0(is unset before an)2.68 E 2.5(yn)-.15 G .5 -.25 +(ew va)-2.5 H(lues are assigned.).25 E(Other)5 E F1(name)2.5 E F0(ar)2.5 +E(guments are ignored.)-.18 E F2144 631.2 Q F1(delim)2.5 E F0 +(The \214rst character of)180 643.2 Q F1(delim)2.5 E F0 (is used to terminate the input line, rather than ne)2.5 E(wline.)-.25 E -F2144 655.2 Q F0 .372 +F2144 655.2 Q F0 .373 (If the standard input is coming from a terminal,)25.86 F F2 -.18(re) -2.873 G(adline).18 E F0(\(see)2.873 E F3(READLINE)2.873 E F0(abo)2.623 E --.15(ve)-.15 G 2.873(\)i).15 G 2.873(su)-2.873 G(sed)-2.873 E +2.873 G(adline).18 E F0(\(see)2.873 E F3(READLINE)2.872 E F0(abo)2.622 E +-.15(ve)-.15 G 2.872(\)i).15 G 2.872(su)-2.872 G(sed)-2.872 E (to obtain the line.)180 667.2 Q F2144 679.2 Q F1(nc)2.5 E(har) --.15 E(s)-.1 E F2 -.18(re)180 691.2 S(ad).18 E F0 1.395 -(returns after reading)3.895 F F1(nc)3.895 E(har)-.15 E(s)-.1 E F0 1.395 -(characters rather than w)3.895 F 1.394(aiting for a complete line of) --.1 F(input.)180 703.2 Q(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(53) +-.15 E(s)-.1 E F2 -.18(re)180 691.2 S(ad).18 E F0 1.394 +(returns after reading)3.894 F F1(nc)3.894 E(har)-.15 E(s)-.1 E F0 1.395 +(characters rather than w)3.894 F 1.395(aiting for a complete line of) +-.1 F(input.)180 703.2 Q(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(53) 199.835 E 0 Cg EP %%Page: 54 54 %%BeginPageSetup @@ -6267,86 +6272,86 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Times-Bold@0 SF144 84 Q/F2 10/Times-Italic@0 SF(pr) -2.5 E(ompt)-.45 E F0(Display)180 96 Q F2(pr)3.66 E(ompt)-.45 E F0 1.161 -(on standard error)3.66 F 3.661(,w)-.4 G 1.161(ithout a trailing ne) +2.5 E(ompt)-.45 E F0(Display)180 96 Q F2(pr)3.661 E(ompt)-.45 E F0 1.161 +(on standard error)3.661 F 3.661(,w)-.4 G 1.161(ithout a trailing ne) -3.661 F 1.161(wline, before attempting to read)-.25 F(an)180 108 Q 2.5 (yi)-.15 G 2.5(nput. The)-2.5 F (prompt is displayed only if input is coming from a terminal.)2.5 E F1 -144 120 Q F0 .544(Backslash does not act as an escape character) -25.86 F 5.543(.T)-.55 G .543(he backslash is considered to be part of) +144 120 Q F0 .543(Backslash does not act as an escape character) +25.86 F 5.543(.T)-.55 G .544(he backslash is considered to be part of) -5.543 F(the line.)180 132 Q(In particular)5 E 2.5(,ab)-.4 G (ackslash-ne)-2.5 E(wline pair may not be used as a line continuation.) -.25 E F1144 144 Q F0(Silent mode.)26.41 E (If input is coming from a terminal, characters are not echoed.)5 E F1 -144 156 Q F2(timeout)2.5 E F0(Cause)180 168 Q F1 -.18(re)3.548 G -(ad).18 E F0 1.048(to time out and return f)3.548 F 1.048 +144 156 Q F2(timeout)2.5 E F0(Cause)180 168 Q F1 -.18(re)3.549 G +(ad).18 E F0 1.048(to time out and return f)3.549 F 1.048 (ailure if a complete line of input is not read within)-.1 F F2(timeout) 180 180 Q F0 2.92(seconds. This)2.92 F .42(option has no ef)2.92 F .42 (fect if)-.25 F F1 -.18(re)2.92 G(ad).18 E F0 .42 (is not reading input from the terminal)2.92 F(or a pipe.)180 192 Q F1 144 204 Q F2(fd)2.5 E/F3 10/Palatino-Roman@0 SF(Read input fr) 14.46 E(om \214le descriptor)-.18 E/F4 10/Palatino-Italic@0 SF(fd)2.5 E -F3(.)A .335(If no)144 220.8 R F4(names)3.095 E F3(ar)2.895 E 2.835(es) --.18 G .335(upplied, the line r)-2.835 F .336 +F3(.)A .336(If no)144 220.8 R F4(names)3.096 E F3(ar)2.896 E 2.836(es) +-.18 G .336(upplied, the line r)-2.836 F .336 (ead is assigned to the variable)-.18 F/F5 9/Palatino-Bold@0 SF(REPL) -2.836 E(Y)-.828 E/F6 9/Palatino-Roman@0 SF(.)A F3 .336(The r)4.836 F -.336(eturn code)-.18 F 1.058(is zer)144 232.8 R 1.058 +2.835 E(Y)-.828 E/F6 9/Palatino-Roman@0 SF(.)A F3 .335(The r)4.835 F +.335(eturn code)-.18 F 1.057(is zer)144 232.8 R 1.058 (o, unless end-of-\214le is encounter)-.18 F(ed,)-.18 E/F7 10 /Palatino-Bold@0 SF(read)3.558 E F3 1.058 (times out, or an invalid \214le descriptor is)3.558 F (supplied as the ar)144 244.8 Q(gument to)-.18 E F72.5 E F3(.)A F7 (readonly)108 261.6 Q F3([)2.5 E F7(\255apf)A F3 2.5(][)C F4(name)-2.5 E -F3([=)A F4(word)A F3 2.5(].)C(..])-2.5 E .587(The given)144 273.6 R F4 -(names)3.087 E F3(ar)3.087 E 3.087(em)-.18 G .587(arked r)-3.087 F .587 -(eadonly; the values of these)-.18 F F4(names)3.347 E F3 .588 -(may not be changed by)3.148 F .833(subsequent assignment.)144 285.6 R -.833(If the)5.833 F F73.333 E F3 .832 -(option is supplied, the functions corr)3.333 F .832(esponding to the) --.18 F F4(names)144 297.6 Q F3(ar)3.809 E 3.809(es)-.18 G 3.809(om) --3.809 G 3.809(arked. The)-3.809 F F73.809 E F3 1.309(option r) -3.809 F 1.309(estricts the variables to arrays.)-.18 F 1.31(If no)6.31 F -F4(name)4.07 E F3(ar)4.16 E(gu-)-.18 E 1.058(ments ar)144 309.6 R 3.557 -(eg)-.18 G 1.057(iven, or if the)-3.557 F F73.557 E F3 1.057 +F3([=)A F4(word)A F3 2.5(].)C(..])-2.5 E .588(The given)144 273.6 R F4 +(names)3.088 E F3(ar)3.088 E 3.088(em)-.18 G .588(arked r)-3.088 F .587 +(eadonly; the values of these)-.18 F F4(names)3.347 E F3 .587 +(may not be changed by)3.147 F .832(subsequent assignment.)144 285.6 R +.832(If the)5.832 F F73.332 E F3 .833 +(option is supplied, the functions corr)3.332 F .833(esponding to the) +-.18 F F4(names)144 297.6 Q F3(ar)3.81 E 3.81(es)-.18 G 3.81(om)-3.81 G +3.81(arked. The)-3.81 F F73.81 E F3 1.309(option r)3.809 F 1.309 +(estricts the variables to arrays.)-.18 F 1.309(If no)6.309 F F4(name) +4.069 E F3(ar)4.159 E(gu-)-.18 E 1.057(ments ar)144 309.6 R 3.557(eg) +-.18 G 1.057(iven, or if the)-3.557 F F73.557 E F3 1.057 (option is supplied, a list of all r)3.557 F 1.057 -(eadonly names is printed.)-.18 F(The)144 321.6 Q F72.577 E F3 +(eadonly names is printed.)-.18 F(The)144 321.6 Q F72.578 E F3 .077(option causes output to be displayed in a format that may be r) -2.577 F .078(eused as input.)-.18 F .078(If a)5.078 F .903 -(variable name is followed by =)144 333.6 R F4(word)A F3 3.403(,t)C .902 -(he value of the variable is set to)-3.403 F F4(word)3.402 E F3 5.902 -(.T)C .902(he r)-5.902 F(eturn)-.18 E .997 +2.578 F .077(eused as input.)-.18 F .077(If a)5.077 F .902 +(variable name is followed by =)144 333.6 R F4(word)A F3 3.402(,t)C .903 +(he value of the variable is set to)-3.402 F F4(word)3.403 E F3 5.903 +(.T)C .903(he r)-5.903 F(eturn)-.18 E .998 (status is 0 unless an invalid option is encounter)144 345.6 R .998 -(ed, one of the)-.18 F F4(names)3.758 E F3 .998(is not a valid shell) -3.558 F(variable name, or)144 357.6 Q F72.5 E F3 +(ed, one of the)-.18 F F4(names)3.757 E F3 .997(is not a valid shell) +3.557 F(variable name, or)144 357.6 Q F72.5 E F3 (is supplied with a)2.5 E F4(name)2.76 E F3(that is not a function.)2.85 E F7(return)108 374.4 Q F3([)2.5 E F4(n)A F3(])A .563 (Causes a function to exit with the r)144 386.4 R .563 (eturn value speci\214ed by)-.18 F F4(n)3.063 E F3 5.563(.I).08 G(f) -5.563 E F4(n)3.323 E F3 .563(is omitted, the r)3.143 F(eturn)-.18 E -.544(status is that of the last command executed in the function body) -144 398.4 R 5.545(.I)-1.11 G 3.045(fu)-5.545 G .545(sed outside a func-) --3.045 F 1.148(tion, but during execution of a script by the)144 410.4 R +.545(status is that of the last command executed in the function body) +144 398.4 R 5.544(.I)-1.11 G 3.044(fu)-5.544 G .544(sed outside a func-) +-3.044 F 1.148(tion, but during execution of a script by the)144 410.4 R F7(.)3.648 E F3(\()6.148 E F7(source)A F3 3.648(\)c)C 1.148 -(ommand, it causes the shell to)-3.648 F .63 -(stop executing that script and r)144 422.4 R .63(eturn either)-.18 F F4 -(n)3.391 E F3 .631(or the exit status of the last command exe-)3.211 F -.541(cuted within the script as the exit status of the script.)144 434.4 -R .54(If used outside a function and not)5.54 F .037 +(ommand, it causes the shell to)-3.648 F .631 +(stop executing that script and r)144 422.4 R .631(eturn either)-.18 F +F4(n)3.391 E F3 .63(or the exit status of the last command exe-)3.211 F +.54(cuted within the script as the exit status of the script.)144 434.4 +R .541(If used outside a function and not)5.541 F .038 (during execution of a script by)144 446.4 R F7(.)2.538 E F3 2.538(,t) -.833 G .038(he r)-2.538 F .038(eturn status is false.)-.18 F .038 +.833 G .038(he r)-2.538 F .038(eturn status is false.)-.18 F .037 (Any command associated with)5.038 F(the)144 458.4 Q F7(RETURN)2.5 E F3 (trap is executed befor)2.5 E 2.5(ee)-.18 G(xecution r)-2.5 E (esumes after the function or script.)-.18 E F7(set)108 475.2 Q F3([)2.5 E F7(\255\255abefhkmnptuvxBCHP)A F3 2.5(][)C F7-2.5 E F4(option) 2.5 E F3 2.5(][)C F4(ar)-2.5 E(g)-.18 E F3(...])2.5 E -.55(Wi)144 487.2 -S .246(thout options, the name and value of each shell variable ar).55 F -2.745(ed)-.18 G .245(isplayed in a format that)-2.745 F 2.183(can be r) -144 499.2 R 2.183(eused as input.)-.18 F 2.184 -(The output is sorted accor)7.183 F 2.184(ding to the curr)-.18 F 2.184 -(ent locale.)-.18 F(When)7.184 E 1.006(options ar)144 511.2 R 3.506(es) --.18 G 1.006(peci\214ed, they set or unset shell attributes.)-3.506 F -1.006(Any ar)6.006 F 1.005(guments r)-.18 F 1.005(emaining after)-.18 F -1.981(the options ar)144 523.2 R 4.481(ep)-.18 G -.18(ro)-4.481 G 1.981 -(cessed ar).18 F 4.481(et)-.18 G -.18(re)-4.481 G 1.982 +S .245(thout options, the name and value of each shell variable ar).55 F +2.746(ed)-.18 G .246(isplayed in a format that)-2.746 F 2.184(can be r) +144 499.2 R 2.184(eused as input.)-.18 F 2.184 +(The output is sorted accor)7.184 F 2.183(ding to the curr)-.18 F 2.183 +(ent locale.)-.18 F(When)7.183 E 1.005(options ar)144 511.2 R 3.505(es) +-.18 G 1.006(peci\214ed, they set or unset shell attributes.)-3.505 F +1.006(Any ar)6.006 F 1.006(guments r)-.18 F 1.006(emaining after)-.18 F +1.982(the options ar)144 523.2 R 4.482(ep)-.18 G -.18(ro)-4.482 G 1.982 +(cessed ar).18 F 4.482(et)-.18 G -.18(re)-4.482 G 1.981 (ated as values for the positional parameters and ar).18 F(e)-.18 E (assigned, in or)144 535.2 Q(der)-.18 E 2.5(,t)-.74 G(o)-2.5 E F7($1)2.5 E F3(,)A F7($2)2.5 E F3(,)A F7 2.5(... $)2.5 F F4(n)A F3 5(.O)C @@ -6359,38 +6364,38 @@ E F3(,)A F7($2)2.5 E F3(,)A F7 2.5(... $)2.5 F F4(n)A F3 5(.O)C (ound jobs immediately)-.18 F 2.596(,r)-1.11 G .096(ather than befor) -2.596 F(e)-.18 E(the next primary pr)184 583.2 Q 2.5(ompt. This)-.18 F (is ef)2.5 E(fective only when job contr)-.18 E(ol is enabled.)-.18 E F7 -144 595.2 Q F3 .179(Exit immediately if a)28.94 F F4 .178 -(simple command)2.679 F F3(\(see)2.678 E F5 .178(SHELL GRAMMAR)2.678 F -F3 .178(above\) exits with a)2.428 F(non-zer)184 607.2 Q 3.232(os)-.18 G -3.232(tatus. The)-3.232 F .733 -(shell does not exit if the command that fails is part of the)3.232 F -.696(command list immediately following a)184 619.2 R F7(while)3.196 E +144 595.2 Q F3 .178(Exit immediately if a)28.94 F F4 .178 +(simple command)2.678 F F3(\(see)2.678 E F5 .178(SHELL GRAMMAR)2.678 F +F3 .179(above\) exits with a)2.429 F(non-zer)184 607.2 Q 3.233(os)-.18 G +3.233(tatus. The)-3.233 F .733 +(shell does not exit if the command that fails is part of the)3.233 F +.695(command list immediately following a)184 619.2 R F7(while)3.196 E F3(or)3.196 E F7(until)3.196 E F3(keywor)3.196 E .696 -(d, part of the test)-.18 F .98(in an)184 631.2 R F4(if)3.64 E F3 .98 -(statement, part of a)5.33 F F7(&&)3.48 E F3(or)3.481 E/F8 10/Symbol SF -3.481 E F3 .981(list, or if the command's r)3.481 F .981 +(d, part of the test)-.18 F .981(in an)184 631.2 R F4(if)3.641 E F3 .981 +(statement, part of a)5.331 F F7(&&)3.481 E F3(or)3.481 E/F8 10/Symbol +SF3.481 E F3 .98(list, or if the command's r)3.481 F .98 (eturn value is)-.18 F(being inverted via)184 643.2 Q F7(!)2.5 E F3 5 (.A)C(trap on)-2.5 E F7(ERR)2.5 E F3 2.5(,i)C 2.5(fs)-2.5 G (et, is executed befor)-2.5 E 2.5(et)-.18 G(he shell exits.)-2.5 E F7 144 655.2 Q F3(Disable pathname expansion.)30.05 E F7144 -667.2 Q F3 .592(Remember the location of commands as they ar)27.83 F -3.092(el)-.18 G .591(ooked up for execution.)-3.092 F(This)5.591 E -(is enabled by default.)184 679.2 Q F7144 691.2 Q F3 .934(All ar) +667.2 Q F3 .591(Remember the location of commands as they ar)27.83 F +3.092(el)-.18 G .592(ooked up for execution.)-3.092 F(This)5.592 E +(is enabled by default.)184 679.2 Q F7144 691.2 Q F3 .935(All ar) 27.83 F .934(guments in the form of assignment statements ar)-.18 F -3.434(ep)-.18 G .935(laced in the envir)-3.434 F(on-)-.18 E +3.434(ep)-.18 G .934(laced in the envir)-3.434 F(on-)-.18 E (ment for a command, not just those that pr)184 703.2 Q -(ecede the command name.)-.18 E F7144 715.2 Q F3 .711 -(Monitor mode.)25.05 F .711(Job contr)5.711 F .711(ol is enabled.)-.18 F -.711(This option is on by default for interac-)5.711 F 1.164 -(tive shells on systems that support it \(see)184 727.2 R F5 1.165 -(JOB CONTROL)3.665 F F3 3.665(above\). Backgr)3.415 F(ound)-.18 E F0 -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(54)199.835 E 0 Cg EP +(ecede the command name.)-.18 E F7144 715.2 Q F3 .71 +(Monitor mode.)25.05 F .71(Job contr)5.71 F .711(ol is enabled.)-.18 F +.711(This option is on by default for interac-)5.711 F 1.165 +(tive shells on systems that support it \(see)184 727.2 R F5 1.164 +(JOB CONTROL)3.664 F F3 3.664(above\). Backgr)3.414 F(ound)-.18 E F0 +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(54)199.835 E 0 Cg EP %%Page: 55 55 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Palatino-Roman@0 SF(pr)184 84 Q .54(ocesses r)-.18 F .54 +-.35 E/F1 10/Palatino-Roman@0 SF(pr)184 84 Q .539(ocesses r)-.18 F .539 (un in a separate pr)-.08 F .539(ocess gr)-.18 F .539 (oup and a line containing their exit status)-.18 F (is printed upon their completion.)184 96 Q/F2 10/Palatino-Bold@0 SF @@ -6410,13 +6415,13 @@ F1(The)184 144 Q F3(option\255name)2.5 E F1 F1(.)A F2(errexit)184 276 Q F1(Same as)10.56 E F22.5 E F1(.)A F2 (hashall)184 288 Q F1(Same as)6.68 E F22.5 E F1(.)A F2(histexpand) 184 300 Q F1(Same as)224 312 Q F22.5 E F1(.)A F2(history)184 324 Q -F1 2.271(Enable command history)7.78 F 4.771(,a)-1.11 G 4.771(sd)-4.771 -G 2.271(escribed above under)-4.771 F/F4 9/Palatino-Bold@0 SF(HISTOR) -4.771 E(Y)-.495 E/F5 9/Palatino-Roman@0 SF(.)A F1(This)6.77 E +F1 2.27(Enable command history)7.78 F 4.771(,a)-1.11 G 4.771(sd)-4.771 G +2.271(escribed above under)-4.771 F/F4 9/Palatino-Bold@0 SF(HISTOR)4.771 +E(Y)-.495 E/F5 9/Palatino-Roman@0 SF(.)A F1(This)6.771 E (option is on by default in interactive shells.)224 336 Q F2(ignoreeof) -184 348 Q F1 1.673(The ef)224 360 R 1.673 +184 348 Q F1 1.674(The ef)224 360 R 1.674 (fect is as if the shell command)-.18 F/F6 10/Courier@0 SF(IGNOREEOF=10) -4.174 E F1 1.674(had been exe-)4.174 F(cuted \(see)224 372 Q F2(Shell V) +4.173 E F1 1.673(had been exe-)4.173 F(cuted \(see)224 372 Q F2(Shell V) 2.5 E(ariables)-1.11 E F1(above\).)2.5 E F2(keyword)184 384 Q F1 (Same as)224 396 Q F22.5 E F1(.)A F2(monitor)184 408 Q F1(Same as) 224 420 Q F22.5 E F1(.)A F2(noclobber)184 432 Q F1(Same as)224 444 @@ -6426,11 +6431,11 @@ E F1(.)A F2(noglob)184 468 Q F1(Same as)7.77 E F22.5 E F1(.)A F2 Q F1(Same as)12.22 E F22.5 E F1(.)A F2(nounset)184 492 Q F1 (Same as)224 504 Q F22.5 E F1(.)A F2(onecmd)184 516 Q F1(Same as) 224 528 Q F22.5 E F1(.)A F2(physical)184 540 Q F1(Same as)224 552 -Q F22.5 E F1(.)A F2(pipefail)184 564 Q F1 .735(If set, the r)224 +Q F22.5 E F1(.)A F2(pipefail)184 564 Q F1 .734(If set, the r)224 576 R .734 (eturn value of a pipeline is the value of the last \(rightmost\))-.18 F -.31(command to exit with a non-zer)224 588 R 2.811(os)-.18 G .311 -(tatus, or zer)-2.811 F 2.811(oi)-.18 G 2.811(fa)-2.811 G .311 +.311(command to exit with a non-zer)224 588 R 2.811(os)-.18 G .311 +(tatus, or zer)-2.811 F 2.811(oi)-.18 G 2.811(fa)-2.811 G .31 (ll commands in the)-2.811 F(pipeline exit successfully)224 600 Q 5(.T) -1.11 G(his option is disabled by default.)-5 E F2(posix)184 612 Q F1 .815(Change the behavior of)15.56 F F2(bash)3.315 E F1(wher)3.315 E @@ -6441,12 +6446,12 @@ F2(privileged)184 636 Q F1(Same as)224 648 Q F22.5 E F1(.)A F2 (verbose)184 660 Q F1(Same as)224 672 Q F22.5 E F1(.)A F2(vi)184 684 Q F1(Use a vi-style command line editing interface.)31.11 E F2 (xtrace)184 696 Q F1(Same as)13.34 E F22.5 E F1(.)A(If)184 714 Q -F24.63 E F1 2.131(is supplied with no)4.63 F F3(option\255name) -4.631 E F1 4.631(,t)C 2.131(he values of the curr)-4.631 F 2.131 -(ent options ar)-.18 F(e)-.18 E 4.412(printed. If)184 726 R F2(+o)4.412 -E F1 1.912(is supplied with no)4.412 F F3(option\255name)4.412 E F1 -4.411(,as)C 1.911(eries of)-4.411 F F2(set)4.411 E F1 1.911(commands to) -4.411 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(55)199.835 E 0 Cg +F24.631 E F1 2.131(is supplied with no)4.631 F F3(option\255name) +4.631 E F1 4.631(,t)C 2.131(he values of the curr)-4.631 F 2.13 +(ent options ar)-.18 F(e)-.18 E 4.411(printed. If)184 726 R F2(+o)4.411 +E F1 1.911(is supplied with no)4.411 F F3(option\255name)4.412 E F1 +4.412(,as)C 1.912(eries of)-4.412 F F2(set)4.412 E F1 1.912(commands to) +4.412 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(55)199.835 E 0 Cg EP %%Page: 56 56 %%BeginPageSetup @@ -6456,106 +6461,106 @@ BP -.35 E/F1 10/Palatino-Roman@0 SF -.18(re)184 84 S(cr).18 E (eate the curr)-.18 E(ent option settings is displayed on the standar) -.18 E 2.5(do)-.18 G(utput.)-2.5 E/F2 10/Palatino-Bold@0 SF144 96 -Q F1 -.9(Tu)27.83 G .853(rn on).9 F/F3 10/Palatino-Italic@0 SF -(privileged)3.923 E F1 3.353(mode. In)3.683 F .853(this mode, the)3.353 -F/F4 9/Palatino-Bold@0 SF($ENV)3.353 E F1(and)3.103 E F4($BASH_ENV)3.354 -E F1 .854(\214les ar)3.104 F 3.354(en)-.18 G(ot)-3.354 E(pr)184 108 Q +Q F1 -.9(Tu)27.83 G .854(rn on).9 F/F3 10/Palatino-Italic@0 SF +(privileged)3.924 E F1 3.354(mode. In)3.684 F .853(this mode, the)3.353 +F/F4 9/Palatino-Bold@0 SF($ENV)3.353 E F1(and)3.103 E F4($BASH_ENV)3.353 +E F1 .853(\214les ar)3.103 F 3.353(en)-.18 G(ot)-3.353 E(pr)184 108 Q 2.873(ocessed, shell functions ar)-.18 F 5.373(en)-.18 G 2.873 (ot inherited fr)-5.373 F 2.873(om the envir)-.18 F 2.873 -(onment, and the)-.18 F F4(SHELLOPTS)184 120 Q F1 .548 -(variable, if it appears in the envir)2.798 F .548(onment, is ignor)-.18 -F 3.049(ed. If)-.18 F .549(the shell is)3.049 F 1.115 +(onment, and the)-.18 F F4(SHELLOPTS)184 120 Q F1 .549 +(variable, if it appears in the envir)2.799 F .548(onment, is ignor)-.18 +F 3.048(ed. If)-.18 F .548(the shell is)3.048 F 1.115 (started with the ef)184 132 R 1.115(fective user \(gr)-.18 F 1.115 (oup\) id not equal to the r)-.18 F 1.115(eal user \(gr)-.18 F 1.115 -(oup\) id,)-.18 F .497(and the)184 144 R F22.997 E F1 .498 +(oup\) id,)-.18 F .498(and the)184 144 R F22.998 E F1 .498 (option is not supplied, these actions ar)2.998 F 2.998(et)-.18 G .498 -(aken and the ef)-2.998 F .498(fective user)-.18 F .685 +(aken and the ef)-2.998 F .497(fective user)-.18 F .684 (id is set to the r)184 156 R .685(eal user id.)-.18 F .685(If the)5.685 -F F23.185 E F1 .684(option is supplied at startup, the ef)3.185 F -(fective)-.18 E .752(user id is not r)184 168 R 3.252(eset. T)-.18 F +F F23.185 E F1 .685(option is supplied at startup, the ef)3.185 F +(fective)-.18 E .753(user id is not r)184 168 R 3.252(eset. T)-.18 F .752(urning this option of)-.9 F 3.252(fc)-.18 G .752(auses the ef) --3.252 F .753(fective user and gr)-.18 F(oup)-.18 E +-3.252 F .752(fective user and gr)-.18 F(oup)-.18 E (ids to be set to the r)184 180 Q(eal user and gr)-.18 E(oup ids.)-.18 E F2144 192 Q F1(Exit after r)30.61 E (eading and executing one command.)-.18 E F2144 204 Q F1 -.88 -.9 (Tr e)27.83 H 2.498(at unset variables as an err).9 F 2.498 (or when performing parameter expansion.)-.18 F(If)7.498 E .869 (expansion is attempted on an unset variable, the shell prints an err) -184 216 R .87(or message,)-.18 F +184 216 R .869(or message,)-.18 F (and, if not interactive, exits with a non-zer)184 228 Q 2.5(os)-.18 G (tatus.)-2.5 E F2144 240 Q F1(Print shell input lines as they ar) -28.38 E 2.5(er)-.18 G(ead.)-2.68 E F2144 252 Q F1 2.637 -(After expanding each)28.94 F F3 2.637(simple command)5.137 F F1(,)A F2 -(for)5.137 E F1(command,)5.137 E F2(case)5.136 E F1(command,)5.136 E F2 -(select)5.136 E F1 .954(command, or arithmetic)184 264 R F2(for)3.454 E -F1 .955(command, display the expanded value of)3.455 F F4(PS4)3.455 E/F5 -9/Palatino-Roman@0 SF(,)A F1(fol-)3.205 E +28.38 E 2.5(er)-.18 G(ead.)-2.68 E F2144 252 Q F1 2.636 +(After expanding each)28.94 F F3 2.637(simple command)5.136 F F1(,)A F2 +(for)5.137 E F1(command,)5.137 E F2(case)5.137 E F1(command,)5.137 E F2 +(select)5.137 E F1 .955(command, or arithmetic)184 264 R F2(for)3.455 E +F1 .955(command, display the expanded value of)3.455 F F4(PS4)3.454 E/F5 +9/Palatino-Roman@0 SF(,)A F1(fol-)3.204 E (lowed by the command and its expanded ar)184 276 Q (guments or associated wor)-.18 E 2.5(dl)-.18 G(ist.)-2.5 E F2144 288 Q F1 .484(The shell performs brace expansion \(see)27.27 F F2 .484 -(Brace Expansion)2.984 F F1 2.984(above\). This)2.984 F .484(is on by) -2.984 F(default.)184 300 Q F2144 312 Q F1 .077(If set,)26.72 F F2 -(bash)2.577 E F1 .077(does not overwrite an existing \214le with the) -2.577 F F2(>)2.578 E F1(,)A F2(>&)2.578 E F1 2.578(,a)C(nd)-2.578 E F2 -(<>)2.578 E F1 -.18(re)2.578 G(dir).18 E(ection)-.18 E 2.645 +(Brace Expansion)2.984 F F1 2.984(above\). This)2.984 F .485(is on by) +2.984 F(default.)184 300 Q F2144 312 Q F1 .078(If set,)26.72 F F2 +(bash)2.578 E F1 .077(does not overwrite an existing \214le with the) +2.578 F F2(>)2.577 E F1(,)A F2(>&)2.577 E F1 2.577(,a)C(nd)-2.577 E F2 +(<>)2.577 E F1 -.18(re)2.577 G(dir).18 E(ection)-.18 E 2.645 (operators. This)184 324 R .145(may be overridden when cr)2.645 F .145 (eating output \214les by using the r)-.18 F(edi-)-.18 E -.18(re)184 336 S(ction operator).18 E F2(>|)2.5 E F1(instead of)2.5 E F2(>)2.5 E F1(.)A -F2144 348 Q F1 .901(If set, any trap on)27.83 F F2(ERR)3.402 E F1 -.902(is inherited by shell functions, command substitutions,)3.402 F .75 +F2144 348 Q F1 .902(If set, any trap on)27.83 F F2(ERR)3.402 E F1 +.901(is inherited by shell functions, command substitutions,)3.402 F .75 (and commands executed in a subshell envir)184 360 R 3.25(onment. The) -.18 F F2(ERR)3.25 E F1 .75(trap is normally)3.25 F (not inherited in such cases.)184 372 Q F2144 384 Q F1(Enable) -25.61 E F2(!)2.515 E F1 .015(style history substitution.)5.015 F .016 +25.61 E F2(!)2.516 E F1 .016(style history substitution.)5.016 F .016 (This option is on by default when the shell is)5.016 F(interactive.)184 -396 Q F2144 408 Q F1 .693(If set, the shell does not follow symbo\ -lic links when executing commands such)27.83 F(as)184 420 Q F2(cd)3.569 -E F1 1.069(that change the curr)3.569 F 1.069(ent working dir)-.18 F -(ectory)-.18 E 6.069(.I)-1.11 G 3.569(tu)-6.069 G 1.07 +396 Q F2144 408 Q F1 .692(If set, the shell does not follow symbo\ +lic links when executing commands such)27.83 F(as)184 420 Q F2(cd)3.57 E +F1 1.069(that change the curr)3.57 F 1.069(ent working dir)-.18 F +(ectory)-.18 E 6.069(.I)-1.11 G 3.569(tu)-6.069 G 1.069 (ses the physical dir)-3.569 F(ectory)-.18 E(str)184 432 Q(uctur)-.08 E -2.912(ei)-.18 G 2.912(nstead. By)-2.912 F(default,)2.912 E F2(bash)2.912 -E F1 .412(follows the logical chain of dir)2.912 F .411(ectories when) +2.911(ei)-.18 G 2.911(nstead. By)-2.911 F(default,)2.912 E F2(bash)2.912 +E F1 .412(follows the logical chain of dir)2.912 F .412(ectories when) -.18 F(performing commands which change the curr)184 444 Q(ent dir)-.18 -E(ectory)-.18 E(.)-1.11 E F2144 456 Q F1 1.25(If set, any trap on) -27.27 F F2(DEBUG)3.751 E F1 1.251 +E(ectory)-.18 E(.)-1.11 E F2144 456 Q F1 1.251 +(If set, any trap on)27.27 F F2(DEBUG)3.751 E F1 1.251 (is inherited by shell functions, command substitu-)3.751 F .712 (tions, and commands executed in a subshell envir)184 468 R 3.212 -(onment. The)-.18 F F2(DEBUG)3.212 E F1 .711(trap is)3.211 F +(onment. The)-.18 F F2(DEBUG)3.212 E F1 .712(trap is)3.212 F (normally not inherited in such cases.)184 480 Q F2144 492 Q F1 -1.781(If no ar)27.88 F 1.782 +1.782(If no ar)27.88 F 1.782 (guments follow this option, then the positional parameters ar)-.18 F -4.282(eu)-.18 G(nset.)-4.282 E 1.303 +4.281(eu)-.18 G(nset.)-4.281 E 1.303 (Otherwise, the positional parameters ar)184 504 R 3.803(es)-.18 G 1.303 (et to the)-3.803 F F3(ar)3.803 E(g)-.18 E F1 1.303 (s, even if some of them)B(begin with a)184 516 Q F22.5 E F1(.)A F2 -144 528 Q F1 1.295(Signal the end of options, cause all r)33.94 F +144 528 Q F1 1.296(Signal the end of options, cause all r)33.94 F (emaining)-.18 E F3(ar)3.796 E(g)-.18 E F1 3.796(st)C 3.796(ob)-3.796 G -3.796(ea)-3.796 G 1.296(ssigned to the posi-)-3.796 F .042 -(tional parameters.)184 540 R(The)5.042 E F22.542 E F1(and)2.542 E -F22.542 E F1 .041(options ar)2.541 F 2.541(et)-.18 G .041 -(urned of)-2.541 F 2.541(f. If)-.18 F(ther)2.541 E 2.541(ea)-.18 G .401 --.18(re n)-2.541 H(o).18 E F3(ar)2.541 E(g)-.18 E F1 .041(s, the)B -(positional parameters r)184 552 Q(emain unchanged.)-.18 E .12 -(The options ar)144 568.8 R 2.62(eo)-.18 G .48 -.18(ff b)-2.62 H 2.62 -(yd).18 G .121(efault unless otherwise noted.)-2.62 F .121 -(Using + rather than \255 causes these)5.121 F .278 -(options to be turned of)144 580.8 R 2.778(f. The)-.18 F .277 -(options can also be speci\214ed as ar)2.777 F .277 -(guments to an invocation)-.18 F .722(of the shell.)144 592.8 R .723 +3.795(ea)-3.796 G 1.295(ssigned to the posi-)-3.795 F .041 +(tional parameters.)184 540 R(The)5.041 E F22.541 E F1(and)2.541 E +F22.541 E F1 .041(options ar)2.541 F 2.541(et)-.18 G .041 +(urned of)-2.541 F 2.541(f. If)-.18 F(ther)2.542 E 2.542(ea)-.18 G .402 +-.18(re n)-2.542 H(o).18 E F3(ar)2.542 E(g)-.18 E F1 .042(s, the)B +(positional parameters r)184 552 Q(emain unchanged.)-.18 E .121 +(The options ar)144 568.8 R 2.621(eo)-.18 G .481 -.18(ff b)-2.621 H +2.621(yd).18 G .121(efault unless otherwise noted.)-2.621 F .12 +(Using + rather than \255 causes these)5.121 F .277 +(options to be turned of)144 580.8 R 2.777(f. The)-.18 F .277 +(options can also be speci\214ed as ar)2.777 F .278 +(guments to an invocation)-.18 F .723(of the shell.)144 592.8 R .723 (The curr)5.723 F .723(ent set of options may be found in)-.18 F F2 <24ad>3.223 E F1 5.723(.T)C .723(he r)-5.723 F .723 (eturn status is always)-.18 F(tr)144 604.8 Q (ue unless an invalid option is encounter)-.08 E(ed.)-.18 E F2(shift)108 -621.6 Q F1([)2.5 E F3(n)A F1(])A .807(The positional parameters fr)144 +621.6 Q F1([)2.5 E F3(n)A F1(])A .806(The positional parameters fr)144 633.6 R(om)-.18 E F3(n)3.306 E F1 .806(+1 ... ar)B 3.306(er)-.18 G .806 -(enamed to)-3.486 F F2 .806($1 ....)3.306 F F1 .806(Parameters r)5.806 F -(epr)-.18 E .806(esented by)-.18 F .055(the numbers)144 645.6 R F2($#) +(enamed to)-3.486 F F2 .806($1 ....)3.306 F F1 .807(Parameters r)5.806 F +(epr)-.18 E .807(esented by)-.18 F .055(the numbers)144 645.6 R F2($#) 2.555 E F1 .055(down to)2.555 F F2($#)2.555 E F1A F3(n)A F1 .055 (+1 ar)B 2.555(eu)-.18 G(nset.)-2.555 E F3(n)5.315 E F1 .055 -(must be a non-negative number less than or)2.635 F .495(equal to)144 -657.6 R F2($#)2.995 E F1 5.495(.I)C(f)-5.495 E F3(n)3.255 E F1 .494 -(is 0, no parameters ar)3.075 F 2.994(ec)-.18 G 2.994(hanged. If)-2.994 -F F3(n)3.254 E F1 .494(is not given, it is assumed to be 1.)3.074 F(If) +(must be a non-negative number less than or)2.635 F .494(equal to)144 +657.6 R F2($#)2.994 E F1 5.494(.I)C(f)-5.494 E F3(n)3.254 E F1 .494 +(is 0, no parameters ar)3.074 F 2.994(ec)-.18 G 2.994(hanged. If)-2.994 +F F3(n)3.254 E F1 .495(is not given, it is assumed to be 1.)3.074 F(If) 144 669.6 Q F3(n)4.052 E F1 1.292(is gr)3.872 F 1.292(eater than)-.18 F F2($#)3.792 E F1 3.792(,t)C 1.292(he positional parameters ar)-3.792 F 3.792(en)-.18 G 1.292(ot changed.)-3.792 F 1.292(The r)6.292 F 1.292 @@ -6563,19 +6568,19 @@ F2($#)3.792 E F1 3.792(,t)C 1.292(he positional parameters ar)-3.792 F G(f)-2.5 E F3(n)2.76 E F1(is gr)2.58 E(eater than)-.18 E F2($#)2.5 E F1 (or less than zer)2.5 E(o; otherwise 0.)-.18 E F2(shopt)108 698.4 Q F1 ([)2.5 E F2(\255pqsu)A F1 2.5(][)C F2-2.5 E F1 2.5(][)C F3 -(optname)-2.5 E F1(...])2.5 E -.92(To)144 710.4 S 1.523 -(ggle the values of variables contr).92 F 1.522 -(olling optional shell behavior)-.18 F 6.522(.W)-.74 G 1.522 -(ith no options, or)-7.072 F 2.531(with the)144 722.4 R F25.031 E +(optname)-2.5 E F1(...])2.5 E -.92(To)144 710.4 S 1.522 +(ggle the values of variables contr).92 F 1.523 +(olling optional shell behavior)-.18 F 6.523(.W)-.74 G 1.523 +(ith no options, or)-7.073 F 2.532(with the)144 722.4 R F25.032 E F1 2.531(option, a list of all settable options is displayed, with an i\ -ndication of)5.031 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(56) +ndication of)5.032 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(56) 199.835 E 0 Cg EP %%Page: 57 57 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Palatino-Roman@0 SF .962(whether or not each is set.)144 84 +-.35 E/F1 10/Palatino-Roman@0 SF .961(whether or not each is set.)144 84 R(The)5.962 E/F2 10/Palatino-Bold@0 SF3.462 E F1 .962 (option causes output to be displayed in a form that)3.462 F(may be r) 144 96 Q(eused as input.)-.18 E @@ -6584,10 +6589,10 @@ R(The)5.962 E/F2 10/Palatino-Bold@0 SF3.462 E F1 .962 (.)A F2144 120 Q F1(Disable \(unset\) each)23.83 E F3(optname)2.5 E F1(.)A F2144 132 Q F1(Suppr)23.83 E .903 (esses normal output \(quiet mode\); the r)-.18 F .903 -(eturn status indicates whether the)-.18 F F3(optname)180 144 Q F1 1.679 -(is set or unset.)4.179 F 1.679(If multiple)6.679 F F3(optname)4.178 E -F1(ar)4.178 E 1.678(guments ar)-.18 F 4.178(eg)-.18 G 1.678(iven with) --4.178 F F24.178 E F1 4.178(,t)C(he)-4.178 E -.18(re)180 156 S +(eturn status indicates whether the)-.18 F F3(optname)180 144 Q F1 1.678 +(is set or unset.)4.178 F 1.678(If multiple)6.678 F F3(optname)4.178 E +F1(ar)4.179 E 1.679(guments ar)-.18 F 4.179(eg)-.18 G 1.679(iven with) +-4.179 F F24.179 E F1 4.179(,t)C(he)-4.179 E -.18(re)180 156 S (turn status is zer).18 E 2.5(oi)-.18 G 2.5(fa)-2.5 G(ll)-2.5 E F3 (optnames)2.5 E F1(ar)2.5 E 2.5(ee)-.18 G(nabled; non-zer)-2.5 E 2.5(oo) -.18 G(therwise.)-2.5 E F2144 168 Q F1 1.348 @@ -6596,51 +6601,51 @@ F1(ar)4.178 E 1.678(guments ar)-.18 F 4.178(eg)-.18 G 1.678(iven with) (option to the)3.848 F F2(set)3.848 E F1(builtin.)180 180 Q 1.86 (If either)144 196.8 R F24.36 E F1(or)4.36 E F24.36 E F1 1.86(is used with no)4.36 F F3(optname)4.36 E F1(ar)4.36 E 1.86 -(guments, the display is limited to those)-.18 F 1.061(options which ar) -144 208.8 R 3.561(es)-.18 G 1.062(et or unset, r)-3.561 F(espectively) --.18 E 6.062(.U)-1.11 G 1.062(nless otherwise noted, the)-6.062 F F2 -(shopt)3.562 E F1(options)3.562 E(ar)144 220.8 Q 2.5(ed)-.18 G -(isabled \(unset\) by default.)-2.5 E .473(The r)144 237.6 R .473 +(guments, the display is limited to those)-.18 F 1.062(options which ar) +144 208.8 R 3.562(es)-.18 G 1.062(et or unset, r)-3.562 F(espectively) +-.18 E 6.062(.U)-1.11 G 1.061(nless otherwise noted, the)-6.062 F F2 +(shopt)3.561 E F1(options)3.561 E(ar)144 220.8 Q 2.5(ed)-.18 G +(isabled \(unset\) by default.)-2.5 E .472(The r)144 237.6 R .473 (eturn status when listing options is zer)-.18 F 2.973(oi)-.18 G 2.973 (fa)-2.973 G(ll)-2.973 E F3(optnames)2.973 E F1(ar)2.973 E 2.973(ee)-.18 -G .472(nabled, non-zer)-2.973 F 2.972(oo)-.18 G(ther)-2.972 E(-)-.18 E -2.601(wise. When)144 249.6 R .101(setting or unsetting options, the r) -2.601 F .101(eturn status is zer)-.18 F 2.602(ou)-.18 G .102(nless an) --2.602 F F3(optname)2.602 E F1 .102(is not)2.602 F 2.5(av)144 261.6 S +G .473(nabled, non-zer)-2.973 F 2.973(oo)-.18 G(ther)-2.973 E(-)-.18 E +2.602(wise. When)144 249.6 R .102(setting or unsetting options, the r) +2.602 F .101(eturn status is zer)-.18 F 2.601(ou)-.18 G .101(nless an) +-2.601 F F3(optname)2.601 E F1 .101(is not)2.601 F 2.5(av)144 261.6 S (alid shell option.)-2.5 E(The list of)144 278.4 Q F2(shopt)2.5 E F1 (options is:)2.5 E F2(cdable_vars)144 296.4 Q F1 .364(If set, an ar)184 308.4 R .364(gument to the)-.18 F F2(cd)2.864 E F1 .364 (builtin command that is not a dir)2.864 F .364(ectory is assumed)-.18 F (to be the name of a variable whose value is the dir)184 320.4 Q -(ectory to change to.)-.18 E F2(cdspell)144 332.4 Q F1 1.137 +(ectory to change to.)-.18 E F2(cdspell)144 332.4 Q F1 1.138 (If set, minor err)7.24 F 1.138(ors in the spelling of a dir)-.18 F -1.138(ectory component in a)-.18 F F2(cd)3.638 E F1(command)3.638 E -1.289(will be corr)184 344.4 R 3.788(ected. The)-.18 F(err)3.788 E 1.288 -(ors checked for ar)-.18 F 3.788(et)-.18 G 1.288 -(ransposed characters, a missing)-3.788 F(character)184 356.4 Q 2.74(,a) --.74 G .24(nd one character too many)-2.74 F 5.241(.I)-1.11 G 2.741(fac) --5.241 G(orr)-2.741 E .241(ection is found, the corr)-.18 F .241 -(ected \214le)-.18 F .431(name is printed, and the command pr)184 368.4 -R 2.931(oceeds. This)-.18 F .43(option is only used by inter)2.931 F(-) --.18 E(active shells.)184 380.4 Q F2(checkhash)144 392.4 Q F1 .762 -(If set,)184 404.4 R F2(bash)3.262 E F1 .763 +1.138(ectory component in a)-.18 F F2(cd)3.637 E F1(command)3.637 E +1.288(will be corr)184 344.4 R 3.788(ected. The)-.18 F(err)3.788 E 1.288 +(ors checked for ar)-.18 F 3.788(et)-.18 G 1.289 +(ransposed characters, a missing)-3.788 F(character)184 356.4 Q 2.741 +(,a)-.74 G .241(nd one character too many)-2.741 F 5.241(.I)-1.11 G +2.741(fac)-5.241 G(orr)-2.741 E .241(ection is found, the corr)-.18 F +.24(ected \214le)-.18 F .43(name is printed, and the command pr)184 +368.4 R 2.931(oceeds. This)-.18 F .431(option is only used by inter) +2.931 F(-)-.18 E(active shells.)184 380.4 Q F2(checkhash)144 392.4 Q F1 +.763(If set,)184 404.4 R F2(bash)3.263 E F1 .763 (checks that a command found in the hash table exists befor)3.263 F -3.263(et)-.18 G(rying)-3.263 E .023(to execute it.)184 416.4 R .023 -(If a hashed command no longer exists, a normal path sear)5.023 F .022 +3.262(et)-.18 G(rying)-3.262 E .022(to execute it.)184 416.4 R .023 +(If a hashed command no longer exists, a normal path sear)5.022 F .023 (ch is per)-.18 F(-)-.18 E(formed.)184 428.4 Q F2(checkwinsize)144 440.4 -Q F1 2.584(If set,)184 452.4 R F2(bash)5.084 E F1 2.584 +Q F1 2.585(If set,)184 452.4 R F2(bash)5.085 E F1 2.584 (checks the window size after each command and, if necessary)5.084 F(,) -1.11 E(updates the values of)184 464.4 Q/F4 9/Palatino-Bold@0 SF(LINES) 2.5 E F1(and)2.25 E F4(COLUMNS)2.5 E/F5 9/Palatino-Roman@0 SF(.)A F2 -(cmdhist)144 476.4 Q F1 1.298(If set,)184 488.4 R F2(bash)3.798 E F1 +(cmdhist)144 476.4 Q F1 1.297(If set,)184 488.4 R F2(bash)3.797 E F1 1.297(attempts to save all lines of a multiple-line command in the same) 3.797 F(history entry)184 500.4 Q 5(.T)-1.11 G(his allows easy r)-5 E (e-editing of multi-line commands.)-.18 E F2(dotglob)144 512.4 Q F1 -1.338(If set,)184 524.4 R F2(bash)3.838 E F1 1.338 -(includes \214lenames beginning with a `.' in the r)3.838 F 1.339 +1.339(If set,)184 524.4 R F2(bash)3.839 E F1 1.338 +(includes \214lenames beginning with a `.' in the r)3.839 F 1.338 (esults of pathname)-.18 F(expansion.)184 536.4 Q F2(execfail)144 548.4 Q F1 .315(If set, a non-interactive shell will not exit if it cannot ex\ -ecute the \214le speci\214ed as)5.01 F .783(an ar)184 560.4 R .783 +ecute the \214le speci\214ed as)5.01 F .784(an ar)184 560.4 R .783 (gument to the)-.18 F F2(exec)3.283 E F1 .783(builtin command.)3.283 F .783(An interactive shell does not exit if)5.783 F F2(exec)184 572.4 Q F1(fails.)2.5 E F2(expand_aliases)144 584.4 Q F1 1.159 @@ -6649,21 +6654,21 @@ F1(fails.)2.5 E F2(expand_aliases)144 584.4 Q F1 1.159 1.159(This option is)5.659 F(enabled by default for interactive shells.) 184 608.4 Q F2(extdebug)144 620.4 Q F1 (If set, behavior intended for use by debuggers is enabled:)184 632.4 Q -F2(1.)184 644.4 Q F1(The)28.5 E F23.607 E F1 1.107(option to the) -3.607 F F2(declare)3.607 E F1 1.108(builtin displays the sour)3.607 F -1.108(ce \214le name and)-.18 F .624(line number corr)220 656.4 R .624 +F2(1.)184 644.4 Q F1(The)28.5 E F23.608 E F1 1.108(option to the) +3.608 F F2(declare)3.608 E F1 1.107(builtin displays the sour)3.608 F +1.107(ce \214le name and)-.18 F .624(line number corr)220 656.4 R .624 (esponding to each function name supplied as an ar)-.18 F(gu-)-.18 E (ment.)220 668.4 Q F2(2.)184 680.4 Q F1 .98(If the command r)28.5 F .98 (un by the)-.08 F F2(DEBUG)3.48 E F1 .98(trap r)3.48 F .98 (eturns a non-zer)-.18 F 3.48(ov)-.18 G .98(alue, the)-3.48 F (next command is skipped and not executed.)220 692.4 Q F2(3.)184 704.4 Q -F1 1.107(If the command r)28.5 F 1.107(un by the)-.08 F F2(DEBUG)3.607 E -F1 1.106(trap r)3.606 F 1.106(eturns a value of 2, and the)-.18 F .87 +F1 1.106(If the command r)28.5 F 1.106(un by the)-.08 F F2(DEBUG)3.606 E +F1 1.106(trap r)3.606 F 1.107(eturns a value of 2, and the)-.18 F .871 (shell is executing in a subr)220 716.4 R .871 (outine \(a shell function or a shell script exe-)-.18 F(cuted by the) 220 728.4 Q F2(.)2.5 E F1(or)2.5 E F2(source)2.5 E F1 (builtins\), a call to)2.5 E F2(return)2.5 E F1(is simulated.)2.5 E F0 -(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(57)199.835 E 0 Cg EP +(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(57)199.835 E 0 Cg EP %%Page: 58 58 %%BeginPageSetup BP @@ -6680,36 +6685,37 @@ F2(ar)2.5 E 2.5(ee)-.18 G(nabled.)-2.5 E F1(extquote)144 108 Q F2 .143 132 Q(This option is enabled by default.)5 E F1(failglob)144 144 Q F2 .507(If set, patterns which fail to match \214lenames during pathname e\ xpansion r)184 156 R(esult)-.18 E(in an expansion err)184 168 Q(or)-.18 -E(.)-.74 E F1(force_\214gnore)144 180 Q F2 1.118(If set, the suf)184 192 -R 1.118(\214xes speci\214ed by the)-.18 F F1(FIGNORE)3.618 E F2 1.119 -(shell variable cause wor)3.619 F 1.119(ds to be)-.18 F(ignor)184 204 Q +E(.)-.74 E F1(force_\214gnore)144 180 Q F2 1.119(If set, the suf)184 192 +R 1.119(\214xes speci\214ed by the)-.18 F F1(FIGNORE)3.618 E F2 1.118 +(shell variable cause wor)3.618 F 1.118(ds to be)-.18 F(ignor)184 204 Q 1.291(ed when performing wor)-.18 F 3.791(dc)-.18 G 1.291 (ompletion even if the ignor)-3.791 F 1.291(ed wor)-.18 F 1.291(ds ar) --.18 F 3.79(et)-.18 G(he)-3.79 E 1.7(only possible completions.)184 216 -R(See)6.7 E/F4 9/Palatino-Bold@0 SF 1.7(SHELL V)4.2 F(ARIABLES)-1.161 E -F2 1.701(above for a description of)3.95 F F1(FIGNORE)184 228 Q F2 5(.T) -C(his option is enabled by default.)-5 E F1(gnu_errfmt)144 240 Q F2 .843 -(If set, shell err)184 252 R .843(or messages ar)-.18 F 3.342(ew)-.18 G -.842(ritten in the standar)-3.342 F 3.342(dG)-.18 G .842(NU err)-3.342 F -.842(or message for)-.18 F(-)-.18 E(mat.)184 264 Q F1(histappend)144 276 -Q F2 1.127(If set, the history list is appended to the \214le named by \ -the value of the)184 288 R F1(HIST)3.627 E(-)-.92 E(FILE)184 300 Q F2 +-.18 F 3.791(et)-.18 G(he)-3.791 E 1.701(only possible completions.)184 +216 R(See)6.701 E/F4 9/Palatino-Bold@0 SF 1.7(SHELL V)4.2 F(ARIABLES) +-1.161 E F2 1.7(above for a description of)3.95 F F1(FIGNORE)184 228 Q +F2 5(.T)C(his option is enabled by default.)-5 E F1(gnu_errfmt)144 240 Q +F2 .842(If set, shell err)184 252 R .842(or messages ar)-.18 F 3.342(ew) +-.18 G .842(ritten in the standar)-3.342 F 3.343(dG)-.18 G .843(NU err) +-3.343 F .843(or message for)-.18 F(-)-.18 E(mat.)184 264 Q F1 +(histappend)144 276 Q F2 1.127(If set, the history list is appended to \ +the \214le named by the value of the)184 288 R F1(HIST)3.626 E(-)-.92 E +(FILE)184 300 Q F2 (variable when the shell exits, rather than overwriting the \214le.)2.5 -E F1(histreedit)144 312 Q F2 1.381(If set, and)184 324 R F1(readline) -3.881 E F2 1.381(is being used, a user is given the opportunity to r) -3.881 F 1.38(e-edit a)-.18 F(failed history substitution.)184 336 Q F1 -(histverify)144 348 Q F2 2.133(If set, and)184 360 R F1(readline)4.633 E +E F1(histreedit)144 312 Q F2 1.38(If set, and)184 324 R F1(readline)3.88 +E F2 1.381(is being used, a user is given the opportunity to r)3.88 F +1.381(e-edit a)-.18 F(failed history substitution.)184 336 Q F1 +(histverify)144 348 Q F2 2.134(If set, and)184 360 R F1(readline)4.633 E F2 2.133(is being used, the r)4.633 F 2.133 -(esults of history substitution ar)-.18 F 4.634(en)-.18 G(ot)-4.634 E -.383(immediately passed to the shell parser)184 372 R 5.383(.I)-.74 G -.382(nstead, the r)-5.383 F .382(esulting line is loaded into)-.18 F +(esults of history substitution ar)-.18 F 4.633(en)-.18 G(ot)-4.633 E +.382(immediately passed to the shell parser)184 372 R 5.382(.I)-.74 G +.383(nstead, the r)-5.382 F .383(esulting line is loaded into)-.18 F (the)184 384 Q F1(readline)2.5 E F2(editing buf)2.5 E(fer)-.18 E 2.5(,a) -.74 G(llowing further modi\214cation.)-2.5 E F1(hostcomplete)144 396 Q -F2 .647(If set, and)184 408 R F1(readline)3.147 E F2 .648 -(is being used,)3.147 F F1(bash)3.148 E F2 .648 -(will attempt to perform hostname com-)3.148 F .44(pletion when a wor) +F2 .648(If set, and)184 408 R F1(readline)3.148 E F2 .648 +(is being used,)3.148 F F1(bash)3.148 E F2 .647 +(will attempt to perform hostname com-)3.148 F .439(pletion when a wor) 184 420 R 2.939(dc)-.18 G .439(ontaining a)-2.939 F F1(@)2.939 E F2 .439 -(is being completed \(see)2.939 F F1(Completing)2.939 E F2(under)2.939 E +(is being completed \(see)2.939 F F1(Completing)2.94 E F2(under)2.94 E F4(READLINE)184 432 Q F2 2.5(above\). This)2.25 F (is enabled by default.)2.5 E F1(huponexit)144 444 Q F2(If set,)184 456 Q F1(bash)2.5 E F2(will send)2.5 E F4(SIGHUP)2.5 E F2 @@ -6719,20 +6725,20 @@ Q F1(bash)2.5 E F2(will send)2.5 E F4(SIGHUP)2.5 E F2 (to cause that wor)2.76 F 2.76(da)-.18 G .26(nd all r)-2.76 F .26 (emaining char)-.18 F(-)-.18 E .512(acters on that line to be ignor)184 492 R .512(ed in an interactive shell \(see)-.18 F F4(COMMENTS)3.012 E -F2(above\).)2.762 E(This option is enabled by default.)184 504 Q F1 +F2(above\).)2.763 E(This option is enabled by default.)184 504 Q F1 (lithist)144 516 Q F2 .513(If set, and the)12.8 F F1(cmdhist)3.013 E F2 .513(option is enabled, multi-line commands ar)3.013 F 3.013(es)-.18 G .513(aved to the)-3.013 F .643(history with embedded newlines rather th\ an using semicolon separators wher)184 528 R(e)-.18 E(possible.)184 540 Q F1(login_shell)144 552 Q F2 2.454 (The shell sets this option if it is started as a login shell \(see)184 -564 R F4(INVOCA)4.954 E(TION)-.828 E F2 2.5(above\). The)184 576 R -(value may not be changed.)2.5 E F1(mailwarn)144 588 Q F2 .965 -(If set, and a \214le that)184 600 R F1(bash)3.465 E F2 .964 +564 R F4(INVOCA)4.953 E(TION)-.828 E F2 2.5(above\). The)184 576 R +(value may not be changed.)2.5 E F1(mailwarn)144 588 Q F2 .964 +(If set, and a \214le that)184 600 R F1(bash)3.464 E F2 .965 (is checking for mail has been accessed since the last)3.464 F 1.647 (time it was checked, the message `)184 612 R 1.647(`The mail in)-.37 F -F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.148('i) --.37 G 4.148(sd)-4.148 G(is-)-4.148 E(played.)184 624 Q F1 +F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.147('i) +-.37 G 4.147(sd)-4.147 G(is-)-4.147 E(played.)184 624 Q F1 (no_empty_cmd_completion)144 636 Q F2 .572(If set, and)184 648 R F1 (readline)3.072 E F2 .572(is being used,)3.072 F F1(bash)3.072 E F2 .572 (will not attempt to sear)3.072 F .572(ch the)-.18 F F1 -.74(PA)3.072 G @@ -6742,7 +6748,7 @@ F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.148('i) F2 1.548 (matches \214lenames in a case\255insensitive fashion when performing) 4.048 F(pathname expansion \(see)184 696 Q F1(Pathname Expansion)2.5 E -F2(above\).)2.5 E F0(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(58) +F2(above\).)2.5 E F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(58) 199.835 E 0 Cg EP %%Page: 59 59 %%BeginPageSetup @@ -6754,31 +6760,31 @@ SF 2.34(If set,)184 96 R F1(bash)4.84 E F2 2.34 (allows patterns which match no \214les \(see)4.84 F F1 2.34 (Pathname Expansion)4.84 F F2 (above\) to expand to a null string, rather than themselves.)184 108 Q -F1(progcomp)144 120 Q F2 1.198(If set, the pr)184 132 R 1.199 -(ogrammable completion facilities \(see)-.18 F F1 1.199 -(Programmable Completion)3.699 F F2(above\) ar)184 144 Q 2.5(ee)-.18 G +F1(progcomp)144 120 Q F2 1.199(If set, the pr)184 132 R 1.199 +(ogrammable completion facilities \(see)-.18 F F1 1.198 +(Programmable Completion)3.698 F F2(above\) ar)184 144 Q 2.5(ee)-.18 G 2.5(nabled. This)-2.5 F(option is enabled by default.)2.5 E F1 -(promptvars)144 156 Q F2 2.553(If set, pr)184 168 R 2.553 -(ompt strings under)-.18 F 2.552 +(promptvars)144 156 Q F2 2.552(If set, pr)184 168 R 2.552 +(ompt strings under)-.18 F 2.553 (go parameter expansion, command substitution,)-.18 F 1.007 (arithmetic expansion, and quote r)184 180 R 1.007 (emoval after being expanded as described in)-.18 F/F3 9/Palatino-Bold@0 SF(PROMPTING)184 192 Q F2 2.5(above. This)2.25 F (option is enabled by default.)2.5 E F1(restricted_shell)144 204 Q F2 -1.743(The shell sets this option if it is started in r)184 216 R 1.742 -(estricted mode \(see)-.18 F F3(RESTRICTED)4.242 E(SHELL)184 228 Q F2 -4.862(below\). The)4.612 F 2.362(value may not be changed.)4.862 F 2.362 -(This is not r)7.362 F 2.362(eset when the)-.18 F .294 +1.743(The shell sets this option if it is started in r)184 216 R 1.743 +(estricted mode \(see)-.18 F F3(RESTRICTED)4.243 E(SHELL)184 228 Q F2 +4.862(below\). The)4.613 F 2.362(value may not be changed.)4.862 F 2.362 +(This is not r)7.362 F 2.362(eset when the)-.18 F .293 (startup \214les ar)184 240 R 2.794(ee)-.18 G .294 (xecuted, allowing the startup \214les to discover whether or not a) -2.794 F(shell is r)184 252 Q(estricted.)-.18 E F1(shift_verbose)144 264 -Q F2 .527(If set, the)184 276 R F1(shift)3.028 E F2 .528 +Q F2 .528(If set, the)184 276 R F1(shift)3.028 E F2 .528 (builtin prints an err)3.028 F .528 (or message when the shift count exceeds the)-.18 F (number of positional parameters.)184 288 Q F1(sourcepath)144 300 Q F2 -.515(If set, the)184 312 R F1(source)3.015 E F2(\()3.014 E F1(.)A F2 +.514(If set, the)184 312 R F1(source)3.014 E F2(\()3.014 E F1(.)A F2 3.014(\)b)C .514(uiltin uses the value of)-3.014 F F3 -.666(PA)3.014 G -(TH)-.162 E F2 .514(to \214nd the dir)2.764 F .514(ectory contain-)-.18 +(TH)-.162 E F2 .515(to \214nd the dir)2.764 F .515(ectory contain-)-.18 F(ing the \214le supplied as an ar)184 324 Q 2.5(gument. This)-.18 F (option is enabled by default.)2.5 E F1(xpg_echo)144 336 Q F2 (If set, the)184 348 Q F1(echo)2.5 E F2 @@ -6786,7 +6792,7 @@ F(ing the \214le supplied as an ar)184 324 Q 2.5(gument. This)-.18 F (suspend)108 360 Q F2([)2.5 E F1A F2(])A .048 (Suspend the execution of this shell until it r)144 372 R .048 (eceives a)-.18 F F3(SIGCONT)2.548 E F2 2.548(signal. The)2.298 F F1 -2.548 E F2 .048(option says)2.548 F .327 +2.548 E F2 .047(option says)2.547 F .327 (not to complain if this is a login shell; just suspend anyway)144 384 R 5.327(.T)-1.11 G .327(he r)-5.327 F .327(eturn status is 0 unless)-.18 F (the shell is a login shell and)144 396 Q F12.5 E F2 @@ -6794,13 +6800,13 @@ F(ing the \214le supplied as an ar)184 324 Q 2.5(gument. This)-.18 F (test)108 408 Q/F4 10/Palatino-Italic@0 SF(expr)2.5 E F1([)108 420 Q F4 (expr)2.5 E F1(])2.5 E F2 .544(Return a status of 0 or 1 depending on t\ he evaluation of the conditional expr)6.56 F(ession)-.18 E F4(expr)3.044 -E F2(.).45 E .789(Each operator and operand must be a separate ar)144 -432 R 3.288(gument. Expr)-.18 F .788(essions ar)-.18 F 3.288(ec)-.18 G -.788(omposed of)-3.288 F(the primaries described above under)144 444 Q +E F2(.).45 E .788(Each operator and operand must be a separate ar)144 +432 R 3.289(gument. Expr)-.18 F .789(essions ar)-.18 F 3.289(ec)-.18 G +.789(omposed of)-3.289 F(the primaries described above under)144 444 Q F3(CONDITIONAL EXPRESSIONS)2.5 E/F5 9/Palatino-Roman@0 SF(.)A F2(Expr) 144 462 Q .054 (essions may be combined using the following operators, listed in decr) --.18 F .055(easing or)-.18 F .055(der of)-.18 F(pr)144 474 Q(ecedence.) +-.18 F .054(easing or)-.18 F .054(der of)-.18 F(pr)144 474 Q(ecedence.) -.18 E F1(!)144 486 Q F4(expr)2.5 E F2 -.78 -.9(Tr u)12.94 H 2.5(ei).9 G (f)-2.5 E F4(expr)2.85 E F2(is false.)2.95 E F1(\()144 498 Q F4(expr)2.5 E F1(\))2.5 E F2 .847(Returns the value of)6.56 F F4(expr)3.347 E F2 @@ -6818,159 +6824,159 @@ G(oth)-2.5 E F4(expr1)2.85 E F2(and)2.5 E F4(expr2)2.85 E F2(ar)2.5 E (ession is false.)-.18 E 2.5(1a)144 628.8 S -.18(rg)-2.5 G(ument).18 E (The expr)180 640.8 Q(ession is tr)-.18 E(ue if and only if the ar)-.08 E(gument is not null.)-.18 E 2.5(2a)144 652.8 S -.18(rg)-2.5 G(uments) -.18 E .209(If the \214rst ar)180 664.8 R .208(gument is)-.18 F F1(!) +.18 E .208(If the \214rst ar)180 664.8 R .208(gument is)-.18 F F1(!) 2.708 E F2 2.708(,t)C .208(he expr)-2.708 F .208(ession is tr)-.18 F -.208(ue if and only if the second ar)-.08 F(gument)-.18 E 2.143 -(is null.)180 676.8 R 2.144(If the \214rst ar)7.143 F 2.144 -(gument is one of the unary conditional operators listed)-.18 F 1.402 +.208(ue if and only if the second ar)-.08 F(gument)-.18 E 2.144 +(is null.)180 676.8 R 2.144(If the \214rst ar)7.144 F 2.144 +(gument is one of the unary conditional operators listed)-.18 F 1.401 (above under)180 688.8 R F3 1.401(CONDITIONAL EXPRESSIONS)3.901 F F5(,)A F2 1.401(the expr)3.651 F 1.401(ession is tr)-.18 F 1.401 -(ue if the unary)-.08 F 1.355(test is tr)180 700.8 R 3.855(ue. If)-.08 F -1.356(the \214rst ar)3.855 F 1.356 -(gument is not a valid unary conditional operator)-.18 F 3.856(,t)-.74 G -(he)-3.856 E(expr)180 712.8 Q(ession is false.)-.18 E F0(GNU Bash-3.0)72 -768 Q(2004 Jan 24)149.845 E(59)199.835 E 0 Cg EP +(ue if the unary)-.08 F 1.356(test is tr)180 700.8 R 3.856(ue. If)-.08 F +1.356(the \214rst ar)3.856 F 1.356 +(gument is not a valid unary conditional operator)-.18 F 3.855(,t)-.74 G +(he)-3.855 E(expr)180 712.8 Q(ession is false.)-.18 E F0(GNU Bash-3.0)72 +768 Q(2004 Jan 28)149.845 E(59)199.835 E 0 Cg EP %%Page: 60 60 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Palatino-Roman@0 SF 2.5(3a)144 84 S -.18(rg)-2.5 G(uments) -.18 E 1.5(If the second ar)180 96 R 1.499 +.18 E 1.499(If the second ar)180 96 R 1.499 (gument is one of the binary conditional operators listed above)-.18 F (under)180 108 Q/F2 9/Palatino-Bold@0 SF .64(CONDITIONAL EXPRESSIONS) -3.14 F/F3 9/Palatino-Roman@0 SF(,)A F1 .64(the r)2.89 F .64 -(esult of the expr)-.18 F .64(ession is the r)-.18 F .641(esult of)-.18 -F .529(the binary test using the \214rst and thir)180 120 R 3.029(da) --.18 G -.18(rg)-3.029 G .528(uments as operands.).18 F .528 -(If the \214rst ar)5.528 F(gu-)-.18 E .106(ment is)180 132 R/F4 10 -/Palatino-Bold@0 SF(!)2.606 E F1 2.606(,t)C .107 -(he value is the negation of the two-ar)-2.606 F .107 -(gument test using the second and)-.18 F(thir)180 144 Q 4.633(da)-.18 G --.18(rg)-4.633 G 4.633(uments. If).18 F 2.133(the \214rst ar)4.633 F -2.132(gument is exactly)-.18 F F4(\()4.632 E F1 2.132(and the thir)4.632 -F 4.632(da)-.18 G -.18(rg)-4.632 G 2.132(ument is).18 F(exactly)180 156 -Q F4(\))2.925 E F1 2.925(,t)C .426(he r)-2.925 F .426 +3.141 F/F3 9/Palatino-Roman@0 SF(,)A F1 .64(the r)2.89 F .64 +(esult of the expr)-.18 F .64(ession is the r)-.18 F .64(esult of)-.18 F +.528(the binary test using the \214rst and thir)180 120 R 3.029(da)-.18 +G -.18(rg)-3.029 G .529(uments as operands.).18 F .529 +(If the \214rst ar)5.529 F(gu-)-.18 E .107(ment is)180 132 R/F4 10 +/Palatino-Bold@0 SF(!)2.607 E F1 2.607(,t)C .107 +(he value is the negation of the two-ar)-2.607 F .106 +(gument test using the second and)-.18 F(thir)180 144 Q 4.632(da)-.18 G +-.18(rg)-4.632 G 4.632(uments. If).18 F 2.132(the \214rst ar)4.632 F +2.132(gument is exactly)-.18 F F4(\()4.632 E F1 2.133(and the thir)4.632 +F 4.633(da)-.18 G -.18(rg)-4.633 G 2.133(ument is).18 F(exactly)180 156 +Q F4(\))2.926 E F1 2.926(,t)C .426(he r)-2.926 F .426 (esult is the one-ar)-.18 F .426(gument test of the second ar)-.18 F -2.926(gument. Otherwise,)-.18 F .43(the expr)180 168 R .43 +2.925(gument. Otherwise,)-.18 F .43(the expr)180 168 R .43 (ession is false.)-.18 F(The)5.43 E F42.93 E F1(and)2.93 E F4 2.93 E F1 .43(operators ar)2.93 F 2.93(ec)-.18 G(onsider)-2.93 E .43(ed binary operators)-.18 F(in this case.)180 180 Q 2.5(4a)144 192 S --.18(rg)-2.5 G(uments).18 E .668(If the \214rst ar)180 204 R .668 -(gument is)-.18 F F4(!)3.168 E F1 3.168(,t)C .669(he r)-3.168 F .669 -(esult is the negation of the thr)-.18 F(ee-ar)-.18 E .669(gument expr) +-.18(rg)-2.5 G(uments).18 E .669(If the \214rst ar)180 204 R .669 +(gument is)-.18 F F4(!)3.169 E F1 3.169(,t)C .669(he r)-3.169 F .668 +(esult is the negation of the thr)-.18 F(ee-ar)-.18 E .668(gument expr) -.18 F(es-)-.18 E .409(sion composed of the r)180 216 R .409 (emaining ar)-.18 F 2.909(guments. Otherwise,)-.18 F .409(the expr)2.909 F .409(ession is parsed)-.18 F(and evaluated accor)180 228 Q(ding to pr) -.18 E(ecedence using the r)-.18 E(ules listed above.)-.08 E 2.5(5o)144 240 S 2.5(rm)-2.5 G(or)-2.5 E 2.5(ea)-.18 G -.18(rg)-2.5 G(uments).18 E -.781(The expr)180 252 R .782(ession is parsed and evaluated accor)-.18 F -.782(ding to pr)-.18 F .782(ecedence using the r)-.18 F(ules)-.08 E +.782(The expr)180 252 R .782(ession is parsed and evaluated accor)-.18 F +.782(ding to pr)-.18 F .781(ecedence using the r)-.18 F(ules)-.08 E (listed above.)180 264 Q F4(times)108 280.8 Q F1 .334 (Print the accumulated user and system times for the shell and for pr) 11.01 F .334(ocesses r)-.18 F .334(un fr)-.08 F .334(om the)-.18 F 2.5 (shell. The)144 292.8 R -.18(re)2.5 G(turn status is 0.).18 E F4(trap) 108 309.6 Q F1([)2.5 E F4(\255lp)A F1 2.5(][)C/F5 10/Palatino-Italic@0 -SF(ar)-2.5 E(g)-.18 E F1 2.5(][)C F5(sigspec)-2.5 E F1(...])2.5 E .563 -(The command)144 321.6 R F5(ar)3.523 E(g)-.18 E F1 .563(is to be r)3.543 -F .563(ead and executed when the shell r)-.18 F .564 -(eceives signal\(s\))-.18 F F5(sigspec)3.064 E F1 5.564(.I).32 G(f) --5.564 E F5(ar)144.46 333.6 Q(g)-.18 E F1 .942(is absent or)3.922 F F4 -3.442 E F1 3.441(,a)C .941(ll speci\214ed signals ar)-3.441 F 3.441 -(er)-.18 G .941(eset to their original values \(the values they)-3.621 F -1.892(had upon entrance to the shell\).)144 345.6 R(If)6.892 E F5(ar) -4.852 E(g)-.18 E F1 1.893 -(is the null string the signal speci\214ed by each)4.872 F F5(sigspec) -144.41 357.6 Q F1 .515(is ignor)3.335 F .514 +SF(ar)-2.5 E(g)-.18 E F1 2.5(][)C F5(sigspec)-2.5 E F1(...])2.5 E .564 +(The command)144 321.6 R F5(ar)3.524 E(g)-.18 E F1 .564(is to be r)3.544 +F .563(ead and executed when the shell r)-.18 F .563 +(eceives signal\(s\))-.18 F F5(sigspec)3.063 E F1 5.563(.I).32 G(f) +-5.563 E F5(ar)144.46 333.6 Q(g)-.18 E F1 .941(is absent or)3.921 F F4 +3.441 E F1 3.441(,a)C .941(ll speci\214ed signals ar)-3.441 F 3.441 +(er)-.18 G .942(eset to their original values \(the values they)-3.621 F +1.893(had upon entrance to the shell\).)144 345.6 R(If)6.893 E F5(ar) +4.853 E(g)-.18 E F1 1.892 +(is the null string the signal speci\214ed by each)4.873 F F5(sigspec) +144.41 357.6 Q F1 .514(is ignor)3.334 F .514 (ed by the shell and by the commands it invokes.)-.18 F(If)5.514 E F5 -(ar)3.474 E(g)-.18 E F1 .514(is not pr)3.494 F .514(esent and)-.18 F F4 +(ar)3.474 E(g)-.18 E F1 .514(is not pr)3.494 F .515(esent and)-.18 F F4 144 369.6 Q F1 2.161 -(has been supplied, then the trap commands associated with each)4.66 F -F5(sigspec)5.071 E F1(ar)4.981 E 4.661(ed)-.18 G(is-)-4.661 E 3.428 +(has been supplied, then the trap commands associated with each)4.661 F +F5(sigspec)5.07 E F1(ar)4.98 E 4.66(ed)-.18 G(is-)-4.66 E 3.427 (played. If)144 381.6 R .927(no ar)3.427 F .927(guments ar)-.18 F 3.427 (es)-.18 G .927(upplied or if only)-3.427 F F43.427 E F1 .927 (is given,)3.427 F F4(trap)3.427 E F1 .927(prints the list of com-)3.427 -F .646(mands associated with each signal number)144 393.6 R 5.647(.T) --.74 G(he)-5.647 E F43.147 E F1 .647 -(option causes the shell to print a list)3.147 F 1.095 +F .647(mands associated with each signal number)144 393.6 R 5.647(.T) +-.74 G(he)-5.647 E F43.147 E F1 .646 +(option causes the shell to print a list)3.147 F 1.094 (of signal names and their corr)144 405.6 R 1.095(esponding numbers.) --.18 F(Each)6.095 E F5(sigspec)4.005 E F1 1.094(is either a signal name) -3.914 F .369(de\214ned in <)144 417.6 R F5(signal.h)A F1 .369 +-.18 F(Each)6.095 E F5(sigspec)4.005 E F1 1.095(is either a signal name) +3.915 F .37(de\214ned in <)144 417.6 R F5(signal.h)A F1 .37 (>, or a signal number)B 5.37(.I)-.74 G 2.87(fa)-5.37 G F5(sigspec).41 E -F1(is)3.19 E F2(EXIT)2.87 E F1 .37(\(0\) the command)2.62 F F5(ar)3.33 E -(g)-.18 E F1 .37(is exe-)3.35 F .801(cuted on exit fr)144 429.6 R .8 -(om the shell.)-.18 F .8(If a)5.8 F F5(sigspec)3.71 E F1(is)3.62 E F2 -(DEBUG)3.3 E F3(,)A F1 .8(the command)3.05 F F5(ar)3.76 E(g)-.18 E F1 .8 -(is executed befor)3.78 F(e)-.18 E(every)144 441.6 Q F5 .439 -(simple command)2.939 F F1(,)A F5(for)2.939 E F1(command,)2.939 E F5 +F1(is)3.19 E F2(EXIT)2.87 E F1 .369(\(0\) the command)2.619 F F5(ar) +3.329 E(g)-.18 E F1 .369(is exe-)3.349 F .8(cuted on exit fr)144 429.6 R +.8(om the shell.)-.18 F .8(If a)5.8 F F5(sigspec)3.71 E F1(is)3.62 E F2 +(DEBUG)3.3 E F3(,)A F1 .8(the command)3.05 F F5(ar)3.76 E(g)-.18 E F1 +.801(is executed befor)3.78 F(e)-.18 E(every)144 441.6 Q F5 .439 +(simple command)2.94 F F1(,)A F5(for)2.939 E F1(command,)2.939 E F5 (case)2.939 E F1(command,)2.939 E F5(select)2.939 E F1 .439 -(command, every arithmetic)2.939 F F5(for)2.94 E F1 .592 -(command, and befor)144 453.6 R 3.092(et)-.18 G .592 -(he \214rst command executes in a shell function \(see)-3.092 F F2 .591 -(SHELL GRAM-)3.091 F(MAR)144 465.6 Q F1 2.534(above\). Refer)2.284 F -.034(to the description of the)2.534 F F4(extglob)2.535 E F1 .035 -(option to the)2.535 F F4(shopt)2.535 E F1 .035(builtin for details) -2.535 F .547(of its ef)144 477.6 R .547(fect on the)-.18 F F4(DEBUG) +(command, every arithmetic)2.939 F F5(for)2.939 E F1 .591 +(command, and befor)144 453.6 R 3.091(et)-.18 G .592 +(he \214rst command executes in a shell function \(see)-3.091 F F2 .592 +(SHELL GRAM-)3.092 F(MAR)144 465.6 Q F1 2.535(above\). Refer)2.285 F +.035(to the description of the)2.535 F F4(extglob)2.535 E F1 .035 +(option to the)2.535 F F4(shopt)2.534 E F1 .034(builtin for details) +2.534 F .546(of its ef)144 477.6 R .546(fect on the)-.18 F F4(DEBUG) 3.046 E F1 3.046(trap. If)3.046 F(a)3.046 E F5(sigspec)3.456 E F1(is) 3.366 E F2(ERR)3.046 E F3(,)A F1 .546(the command)2.796 F F5(ar)3.506 E -(g)-.18 E F1 .546(is executed when-)3.526 F 1.03 +(g)-.18 E F1 .547(is executed when-)3.527 F 1.031 (ever a simple command has a non\255zer)144 489.6 R 3.531(oe)-.18 G 1.031(xit status, subject to the following conditions.)-3.531 F(The)144 -501.6 Q F2(ERR)3.034 E F1 .533(trap is not executed if the failed comma\ -nd is part of the command list immedi-)2.784 F .222(ately following a) -144 513.6 R F4(while)2.722 E F1(or)2.722 E F4(until)2.722 E F1(keywor) -2.722 E .222(d, part of the test in an)-.18 F F5(if)2.882 E F1 .223 -(statement, part of a)4.572 F F4(&&)2.723 E F1(or)144 525.6 Q/F6 10 -/Symbol SF3.613 E F1 1.113(list, or if the command's r)3.613 F +501.6 Q F2(ERR)3.033 E F1 .533(trap is not executed if the failed comma\ +nd is part of the command list immedi-)2.783 F .223(ately following a) +144 513.6 R F4(while)2.723 E F1(or)2.723 E F4(until)2.722 E F1(keywor) +2.722 E .222(d, part of the test in an)-.18 F F5(if)2.882 E F1 .222 +(statement, part of a)4.572 F F4(&&)2.722 E F1(or)144 525.6 Q/F6 10 +/Symbol SF3.612 E F1 1.113(list, or if the command's r)3.613 F 1.113(eturn value is being inverted via)-.18 F F4(!)3.613 E F1 6.113(.T) -C 1.113(hese ar)-6.113 F 3.613(et)-.18 G 1.112(he same)-3.613 F .316 +C 1.113(hese ar)-6.113 F 3.613(et)-.18 G 1.113(he same)-3.613 F .317 (conditions obeyed by the)144 537.6 R F4(errexit)2.816 E F1 2.816 (option. If)2.816 F(a)2.816 E F5(sigspec)3.226 E F1(is)3.136 E F2 -(RETURN)2.816 E F3(,)A F1 .316(the command)2.566 F F5(ar)3.277 E(g)-.18 -E F1 .317(is exe-)3.297 F .448 +(RETURN)2.816 E F3(,)A F1 .316(the command)2.566 F F5(ar)3.276 E(g)-.18 +E F1 .316(is exe-)3.296 F .448 (cuted each time a shell function or a script executed with the)144 -549.6 R F4(.)2.948 E F1(or)2.948 E F4(source)2.948 E F1 .448 -(builtins \214nishes)2.948 F 3.427(executing. Signals)144 561.6 R(ignor) -3.427 E .928(ed upon entry to the shell cannot be trapped or r)-.18 F -3.428(eset. T)-.18 F(rapped)-.9 E .615(signals ar)144 573.6 R 3.115(er) +549.6 R F4(.)2.948 E F1(or)2.948 E F4(source)2.948 E F1 .449 +(builtins \214nishes)2.949 F 3.428(executing. Signals)144 561.6 R(ignor) +3.428 E .928(ed upon entry to the shell cannot be trapped or r)-.18 F +3.427(eset. T)-.18 F(rapped)-.9 E .615(signals ar)144 573.6 R 3.115(er) -.18 G .615(eset to their original values in a child pr)-3.295 F .615 (ocess when it is cr)-.18 F 3.115(eated. The)-.18 F -.18(re)3.115 G (turn).18 E(status is false if any)144 585.6 Q F5(sigspec)2.91 E F1 (is invalid; otherwise)2.82 E F4(trap)2.5 E F1 -.18(re)2.5 G(turns tr) .18 E(ue.)-.08 E F4(type)108 602.4 Q F1([)2.5 E F4(\255aftpP)A F1(])A F5 -(name)2.5 E F1([)2.5 E F5(name)A F1(...])2.5 E -.55(Wi)144 614.4 S 1.475 +(name)2.5 E F1([)2.5 E F5(name)A F1(...])2.5 E -.55(Wi)144 614.4 S 1.476 (th no options, indicate how each).55 F F5(name)4.236 E F1 1.476 -(would be interpr)4.326 F 1.476(eted if used as a command)-.18 F 2.726 -(name. If)144 626.4 R(the)2.726 E F42.726 E F1 .226 -(option is used,)2.726 F F4(type)2.725 E F1 .225 -(prints a string which is one of)2.725 F F5(alias)2.725 E F1(,).06 E F5 -(keyword)2.725 E F1(,).33 E F5(function)2.725 E F1(,).08 E F5(builtin) -144 638.4 Q F1 2.555(,o).08 G(r)-2.555 E F5(\214le)4.675 E F1(if)2.905 E -F5(name)2.815 E F1 .056(is an alias, shell r)2.905 F .056(eserved wor) --.18 F .056(d, function, builtin, or disk \214le, r)-.18 F(espec-)-.18 E -(tively)144 650.4 Q 6.635(.I)-1.11 G 4.135(ft)-6.635 G(he)-4.135 E F5 -(name)4.395 E F1 1.635 +(would be interpr)4.326 F 1.475(eted if used as a command)-.18 F 2.725 +(name. If)144 626.4 R(the)2.725 E F42.725 E F1 .225 +(option is used,)2.725 F F4(type)2.725 E F1 .225 +(prints a string which is one of)2.725 F F5(alias)2.726 E F1(,).06 E F5 +(keyword)2.726 E F1(,).33 E F5(function)2.726 E F1(,).08 E F5(builtin) +144 638.4 Q F1 2.556(,o).08 G(r)-2.556 E F5(\214le)4.676 E F1(if)2.906 E +F5(name)2.816 E F1 .056(is an alias, shell r)2.906 F .056(eserved wor) +-.18 F .055(d, function, builtin, or disk \214le, r)-.18 F(espec-)-.18 E +(tively)144 650.4 Q 6.634(.I)-1.11 G 4.134(ft)-6.634 G(he)-4.134 E F5 +(name)4.394 E F1 1.635 (is not found, then nothing is printed, and an exit status of false is) -4.485 F -.18(re)144 662.4 S 2.522(turned. If).18 F(the)2.523 E F4 +4.484 F -.18(re)144 662.4 S 2.523(turned. If).18 F(the)2.523 E F4 2.523 E F1 .023(option is used,)2.523 F F4(type)2.523 E F1 .023 (either r)2.523 F .023(eturns the name of the disk \214le that would) -.18 F 1.086(be executed if)144 674.4 R F5(name)3.846 E F1(wer)3.936 E 3.586(es)-.18 G 1.086(peci\214ed as a command name, or nothing if)-3.586 -F/F7 10/Courier@0 SF 1.086(type -t name)3.586 F F1 .015(would not r)144 -686.4 R(eturn)-.18 E F5(\214le)2.515 E F1 5.015(.T).35 G(he)-5.015 E F4 -2.515 E F1 .015(option for)2.515 F .015(ces a)-.18 F F2 -.666(PA) -2.515 G(TH)-.162 E F1(sear)2.266 E .016(ch for each)-.18 F F5(name)2.516 -E F1 2.516(,e)C .016(ven if)-2.516 F F7 .016(type -t)2.516 F(name)144 +F/F7 10/Courier@0 SF 1.086(type -t name)3.586 F F1 .016(would not r)144 +686.4 R(eturn)-.18 E F5(\214le)2.516 E F1 5.016(.T).35 G(he)-5.016 E F4 +2.516 E F1 .016(option for)2.516 F .016(ces a)-.18 F F2 -.666(PA) +2.515 G(TH)-.162 E F1(sear)2.265 E .015(ch for each)-.18 F F5(name)2.515 +E F1 2.515(,e)C .015(ven if)-2.515 F F7 .015(type -t)2.515 F(name)144 698.4 Q F1 .645(would not r)3.145 F(eturn)-.18 E F5(\214le)3.145 E F1 5.645(.I).35 G 3.145(fac)-5.645 G .645(ommand is hashed,)-3.145 F F4 3.145 E F1(and)3.145 E F43.145 E F1 .645 -(print the hashed value,)3.145 F .41 +(print the hashed value,)3.145 F .411 (not necessarily the \214le that appears \214rst in)144 710.4 R F2 -.666 (PA)2.911 G(TH)-.162 E F3(.)A F1 .411(If the)4.911 F F42.911 E F1 -.411(option is used,)2.911 F F4(type)2.911 E F1 .411(prints all)2.911 F +.411(option is used,)2.911 F F4(type)2.91 E F1 .41(prints all)2.91 F .164(of the places that contain an executable named)144 722.4 R F5(name) 2.664 E F1 5.164(.T).35 G .164(his includes aliases and functions,) --5.164 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(60)199.835 E 0 +-5.164 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(60)199.835 E 0 Cg EP %%Page: 61 61 %%BeginPageSetup @@ -6979,48 +6985,48 @@ BP /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Palatino-Roman@0 SF .73(if and only if the)144 84 R/F2 10 /Palatino-Bold@0 SF3.23 E F1 .73(option is not also used.)3.23 F -.73(The table of hashed commands is not con-)5.73 F .498 +.73(The table of hashed commands is not con-)5.73 F .497 (sulted when using)144 96 R F22.998 E F1 5.498(.T)C(he)-5.498 E F2 2.998 E F1 .498(option suppr)2.998 F .498 -(esses shell function lookup, as with the)-.18 F F2(com-)2.997 E(mand) -144 108 Q F1(builtin.)4.557 E F2(type)7.057 E F1 -.18(re)4.557 G 2.057 +(esses shell function lookup, as with the)-.18 F F2(com-)2.998 E(mand) +144 108 Q F1(builtin.)4.558 E F2(type)7.058 E F1 -.18(re)4.558 G 2.058 (turns tr).18 F 2.057(ue if any of the ar)-.08 F 2.057(guments ar)-.18 F -4.558(ef)-.18 G 2.058(ound, false if none ar)-4.558 F(e)-.18 E(found.) +4.557(ef)-.18 G 2.057(ound, false if none ar)-4.557 F(e)-.18 E(found.) 144 120 Q F2(ulimit)108 136.8 Q F1([)2.5 E F2(\255SHacd\215mnpstuv)A F1 -([)2.5 E/F3 10/Palatino-Italic@0 SF(limit)A F1(]])A(Pr)144 148.8 Q .062 -(ovides contr)-.18 F .062(ol over the r)-.18 F(esour)-.18 E .061 -(ces available to the shell and to pr)-.18 F .061 -(ocesses started by it, on)-.18 F 1.496(systems that allow such contr) -144 160.8 R 3.996(ol. The)-.18 F F23.997 E F1(and)3.997 E F2 -3.997 E F1 1.497(options specify that the har)3.997 F 3.997(do)-.18 G -3.997(rs)-3.997 G(oft)-3.997 E .884(limit is set for the given r)144 +([)2.5 E/F3 10/Palatino-Italic@0 SF(limit)A F1(]])A(Pr)144 148.8 Q .061 +(ovides contr)-.18 F .061(ol over the r)-.18 F(esour)-.18 E .061 +(ces available to the shell and to pr)-.18 F .062 +(ocesses started by it, on)-.18 F 1.497(systems that allow such contr) +144 160.8 R 3.997(ol. The)-.18 F F23.997 E F1(and)3.997 E F2 +3.997 E F1 1.496(options specify that the har)3.997 F 3.996(do)-.18 G +3.996(rs)-3.996 G(oft)-3.996 E .884(limit is set for the given r)144 172.8 R(esour)-.18 E 3.384(ce. A)-.18 F(har)3.384 E 3.384(dl)-.18 G .884 (imit cannot be incr)-3.384 F .884(eased once it is set; a soft)-.18 F -.088(limit may be incr)144 184.8 R .088 +.089(limit may be incr)144 184.8 R .088 (eased up to the value of the har)-.18 F 2.588(dl)-.18 G 2.588(imit. If) --2.588 F(neither)2.589 E F22.589 E F1(nor)2.589 E F22.589 E -F1 .089(is speci\214ed,)2.589 F .163(both the soft and har)144 196.8 R -2.663(dl)-.18 G .163(imits ar)-2.663 F 2.663(es)-.18 G 2.663(et. The) --2.663 F .163(value of)2.663 F F3(limit)2.803 E F1 .162 -(can be a number in the unit speci-)2.933 F .175(\214ed for the r)144 -208.8 R(esour)-.18 E .175(ce or one of the special values)-.18 F F2 -(hard)2.676 E F1(,)A F2(soft)2.676 E F1 2.676(,o)C(r)-2.676 E F2 -(unlimited)2.676 E F1 2.676(,w)C .176(hich stand for)-2.676 F .243 -(the curr)144 220.8 R .243(ent har)-.18 F 2.743(dl)-.18 G .243 -(imit, the curr)-2.743 F .243(ent soft limit, and no limit, r)-.18 F -(espectively)-.18 E 5.242(.I)-1.11 G(f)-5.242 E F3(limit)2.882 E F1 .242 -(is omitted,)3.012 F .081(the curr)144 232.8 R .081 +-2.588 F(neither)2.588 E F22.588 E F1(nor)2.588 E F22.588 E +F1 .088(is speci\214ed,)2.588 F .162(both the soft and har)144 196.8 R +2.662(dl)-.18 G .162(imits ar)-2.662 F 2.662(es)-.18 G 2.663(et. The) +-2.662 F .163(value of)2.663 F F3(limit)2.803 E F1 .163 +(can be a number in the unit speci-)2.933 F .176(\214ed for the r)144 +208.8 R(esour)-.18 E .176(ce or one of the special values)-.18 F F2 +(hard)2.676 E F1(,)A F2(soft)2.675 E F1 2.675(,o)C(r)-2.675 E F2 +(unlimited)2.675 E F1 2.675(,w)C .175(hich stand for)-2.675 F .242 +(the curr)144 220.8 R .242(ent har)-.18 F 2.742(dl)-.18 G .242 +(imit, the curr)-2.742 F .243(ent soft limit, and no limit, r)-.18 F +(espectively)-.18 E 5.243(.I)-1.11 G(f)-5.243 E F3(limit)2.883 E F1 .243 +(is omitted,)3.013 F .082(the curr)144 232.8 R .081 (ent value of the soft limit of the r)-.18 F(esour)-.18 E .081 -(ce is printed, unless the)-.18 F F22.581 E F1 .082 -(option is given.)2.582 F .33(When mor)144 244.8 R 2.83(et)-.18 G .33 -(han one r)-2.83 F(esour)-.18 E .329 -(ce is speci\214ed, the limit name and unit ar)-.18 F 2.829(ep)-.18 G -.329(rinted befor)-2.829 F 2.829(et)-.18 G(he)-2.829 E 2.5(value. Other) -144 256.8 R(options ar)2.5 E 2.5(ei)-.18 G(nterpr)-2.5 E -(eted as follows:)-.18 E F2144 268.8 Q F1(All curr)24.94 E -(ent limits ar)-.18 E 2.5(er)-.18 G(eported)-2.68 E F2144 280.8 Q -F1(The maximum size of cor)25.5 E 2.5<658c>-.18 G(les cr)-2.5 E(eated) --.18 E F2144 292.8 Q F1(The maximum size of a pr)23.83 E +(ce is printed, unless the)-.18 F F22.581 E F1 .081 +(option is given.)2.581 F .329(When mor)144 244.8 R 2.829(et)-.18 G .329 +(han one r)-2.829 F(esour)-.18 E .329 +(ce is speci\214ed, the limit name and unit ar)-.18 F 2.83(ep)-.18 G .33 +(rinted befor)-2.83 F 2.83(et)-.18 G(he)-2.83 E 2.5(value. Other)144 +256.8 R(options ar)2.5 E 2.5(ei)-.18 G(nterpr)-2.5 E(eted as follows:) +-.18 E F2144 268.8 Q F1(All curr)24.94 E(ent limits ar)-.18 E 2.5 +(er)-.18 G(eported)-2.68 E F2144 280.8 Q F1 +(The maximum size of cor)25.5 E 2.5<658c>-.18 G(les cr)-2.5 E(eated)-.18 +E F2144 292.8 Q F1(The maximum size of a pr)23.83 E (ocess's data segment)-.18 E F2144 304.8 Q F1 (The maximum size of \214les cr)26.05 E(eated by the shell)-.18 E F2 144 316.8 Q F1(The maximum size that may be locked into memory) @@ -7034,97 +7040,97 @@ F1(The maximum amount of cpu time in seconds)26.61 E F2144 400.8 Q F1(The maximum number of pr)23.83 E(ocesses available to a single user) -.18 E F2144 412.8 Q F1 (The maximum amount of virtual memory available to the shell)24.38 E(If) -144 429.6 Q F3(limit)4.151 E F1 1.511 -(is given, it is the new value of the speci\214ed r)4.281 F(esour)-.18 E -1.51(ce \(the)-.18 F F24.01 E F1 1.51(option is display)4.01 F +144 429.6 Q F3(limit)4.15 E F1 1.51 +(is given, it is the new value of the speci\214ed r)4.28 F(esour)-.18 E +1.511(ce \(the)-.18 F F24.011 E F1 1.511(option is display)4.011 F 4.315(only\). If)144 441.6 R 1.815(no option is given, then)4.315 F F2 4.315 E F1 1.815(is assumed.)4.315 F -.92(Va)6.815 G 1.815 (lues ar).92 F 4.315(ei)-.18 G 4.315(n1)-4.315 G 1.815(024-byte incr) --4.315 F(ements,)-.18 E .973(except for)144 453.6 R F23.473 E F1 +-4.315 F(ements,)-.18 E .972(except for)144 453.6 R F23.473 E F1 3.473(,w)C .973(hich is in seconds,)-3.473 F F23.473 E F1 3.473 (,w)C .973(hich is in units of 512-byte blocks, and)-3.473 F F2 -3.473 E F1(and)3.472 E F2144 465.6 Q F1 3.517(,w)C 1.017(hich ar) --3.517 F 3.517(eu)-.18 G 1.017(nscaled values.)-3.517 F 1.017(The r) -6.017 F 1.018(eturn status is 0 unless an invalid option or ar)-.18 F +3.473 E F1(and)3.473 E F2144 465.6 Q F1 3.518(,w)C 1.018(hich ar) +-3.518 F 3.518(eu)-.18 G 1.018(nscaled values.)-3.518 F 1.017(The r) +6.018 F 1.017(eturn status is 0 unless an invalid option or ar)-.18 F (gu-)-.18 E(ment is supplied, or an err)144 477.6 Q (or occurs while setting a new limit.)-.18 E F2(umask)108 494.4 Q F1([) 2.5 E F2A F1 2.5(][)C F2-2.5 E F1 2.5(][)C F3(mode)-2.5 E F1 -(])A .536(The user \214le-cr)144 506.4 R .536(eation mask is set to)-.18 -F F3(mode)3.035 E F1 5.535(.I).35 G(f)-5.535 E F3(mode)3.295 E F1 .535 -(begins with a digit, it is interpr)3.385 F .535(eted as)-.18 F 1.826 -(an octal number; otherwise it is interpr)144 518.4 R 1.827 -(eted as a symbolic mode mask similar to that)-.18 F .951(accepted by) -144 530.4 R F3(chmod)3.451 E F1 3.451(\(1\). If).33 F F3(mode)3.711 E F1 -.951(is omitted, the curr)3.801 F .95(ent value of the mask is printed.) --.18 F(The)5.95 E F2144 542.4 Q F1 .607(option causes the mask to\ - be printed in symbolic form; the default output is an octal)3.106 F -(number)144 554.4 Q 6.02(.I)-.74 G 3.52(ft)-6.02 G(he)-3.52 E F2 -3.52 E F1 1.02(option is supplied, and)3.52 F F3(mode)3.78 E F1 1.02 -(is omitted, the output is in a form that)3.87 F .236(may be r)144 566.4 -R .236(eused as input.)-.18 F .236(The r)5.236 F .237 +(])A .535(The user \214le-cr)144 506.4 R .535(eation mask is set to)-.18 +F F3(mode)3.035 E F1 5.535(.I).35 G(f)-5.535 E F3(mode)3.295 E F1 .536 +(begins with a digit, it is interpr)3.385 F .536(eted as)-.18 F 1.827 +(an octal number; otherwise it is interpr)144 518.4 R 1.826 +(eted as a symbolic mode mask similar to that)-.18 F .95(accepted by)144 +530.4 R F3(chmod)3.45 E F1 3.45(\(1\). If).33 F F3(mode)3.71 E F1 .951 +(is omitted, the curr)3.8 F .951(ent value of the mask is printed.)-.18 +F(The)5.951 E F2144 542.4 Q F1 .607(option causes the mask to be \ +printed in symbolic form; the default output is an octal)3.107 F(number) +144 554.4 Q 6.02(.I)-.74 G 3.52(ft)-6.02 G(he)-3.52 E F23.52 E F1 +1.02(option is supplied, and)3.52 F F3(mode)3.78 E F1 1.02 +(is omitted, the output is in a form that)3.87 F .237(may be r)144 566.4 +R .237(eused as input.)-.18 F .237(The r)5.237 F .236 (eturn status is 0 if the mode was successfully changed or if)-.18 F(no) 144 578.4 Q F3(mode)2.5 E F1(ar)2.5 E (gument was supplied, and false otherwise.)-.18 E F2(unalias)108 595.2 Q -F1<5bad>2.5 E F2(a)A F1 2.5(][)C F3(name)-2.5 E F1(...])2.5 E .719 -(Remove each)144 607.2 R F3(name)3.219 E F1(fr)3.219 E .719 +F1<5bad>2.5 E F2(a)A F1 2.5(][)C F3(name)-2.5 E F1(...])2.5 E .718 +(Remove each)144 607.2 R F3(name)3.218 E F1(fr)3.218 E .719 (om the list of de\214ned aliases.)-.18 F(If)5.719 E F23.219 E F1 -.718(is supplied, all alias de\214nitions)3.218 F(ar)144 619.2 Q 2.5(er) +.719(is supplied, all alias de\214nitions)3.219 F(ar)144 619.2 Q 2.5(er) -.18 G 2.5(emoved. The)-2.68 F -.18(re)2.5 G(turn value is tr).18 E (ue unless a supplied)-.08 E F3(name)2.76 E F1 (is not a de\214ned alias.)2.85 E F2(unset)108 636 Q F1<5bad>2.5 E F2 (fv)A F1 2.5(][)C F3(name)-2.5 E F1(...])2.5 E 1.61(For each)144 648 R F3(name)4.11 E F1 4.11(,r).35 G 1.61(emove the corr)-4.29 F 1.61 (esponding variable or function.)-.18 F 1.61(If no options ar)6.61 F -4.11(es)-.18 G(up-)-4.11 E .474(plied, or the)144 660 R F22.974 E -F1 .473(option is given, each)2.974 F F3(name)3.233 E F1 -.18(re)3.323 G -.473(fers to a shell variable.).18 F .473(Read-only variables)5.473 F +4.11(es)-.18 G(up-)-4.11 E .473(plied, or the)144 660 R F22.973 E +F1 .473(option is given, each)2.973 F F3(name)3.233 E F1 -.18(re)3.323 G +.474(fers to a shell variable.).18 F .474(Read-only variables)5.474 F .48(may not be unset.)144 672 R(If)5.48 E F22.98 E F1 .48 (is specifed, each)2.98 F F3(name)3.24 E F1 -.18(re)3.33 G .48 (fers to a shell function, and the function).18 F .405 (de\214nition is r)144 684 R 2.905(emoved. Each)-.18 F .405 (unset variable or function is r)2.905 F .405(emoved fr)-.18 F .405 -(om the envir)-.18 F(onment)-.18 E 1.474(passed to subsequent commands.) +(om the envir)-.18 F(onment)-.18 E 1.475(passed to subsequent commands.) 144 696 R 1.475(If any of)6.475 F/F4 9/Palatino-Bold@0 SF(RANDOM)3.975 E -/F5 9/Palatino-Roman@0 SF(,)A F4(SECONDS)3.725 E F5(,)A F4(LINENO)3.725 -E F5(,)A F4(HISTCMD)3.725 E F5(,)A F4(FUNCNAME)144 708 Q F5(,)A F4 -(GROUPS)2.804 E F5(,)A F1(or)2.803 E F4(DIRST)3.053 E(ACK)-.828 E F1(ar) +/F5 9/Palatino-Roman@0 SF(,)A F4(SECONDS)3.725 E F5(,)A F4(LINENO)3.724 +E F5(,)A F4(HISTCMD)3.724 E F5(,)A F4(FUNCNAME)144 708 Q F5(,)A F4 +(GROUPS)2.803 E F5(,)A F1(or)2.803 E F4(DIRST)3.053 E(ACK)-.828 E F1(ar) 2.803 E 3.053(eu)-.18 G .553(nset, they lose their special pr)-3.053 F .553(operties, even if)-.18 F(they ar)144 720 Q 2.5(es)-.18 G (ubsequently r)-2.5 E 2.5(eset. The)-.18 F(exit status is tr)2.5 E (ue unless a)-.08 E F3(name)2.76 E F1(is r)2.85 E(eadonly)-.18 E(.)-1.11 -E F0(GNU Bash-3.0)72 768 Q(2004 Jan 24)149.845 E(61)199.835 E 0 Cg EP +E F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(61)199.835 E 0 Cg EP %%Page: 62 62 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) -.35 E/F1 10/Palatino-Bold@0 SF(wait)108 84 Q/F2 10/Palatino-Roman@0 SF -([)2.5 E/F3 10/Palatino-Italic@0 SF(n)A F2(])A -.92(Wa)144 96 S .298 +([)2.5 E/F3 10/Palatino-Italic@0 SF(n)A F2(])A -.92(Wa)144 96 S .299 (it for the speci\214ed pr).92 F .298(ocess and r)-.18 F .298 (eturn its termination status.)-.18 F F3(n)5.558 E F2 .298(may be a pr) -2.878 F .299(ocess ID or)-.18 F 2.799(aj)144 108 S .298 -(ob speci\214cation; if a job spec is given, all pr)-2.799 F .298 -(ocesses in that job's pipeline ar)-.18 F 2.798(ew)-.18 G .298 -(aited for)-2.798 F(.)-.74 E(If)144 120 Q F3(n)2.78 E F2 .02 +2.878 F .298(ocess ID or)-.18 F 2.798(aj)144 108 S .298 +(ob speci\214cation; if a job spec is given, all pr)-2.798 F .298 +(ocesses in that job's pipeline ar)-.18 F 2.799(ew)-.18 G .299 +(aited for)-2.799 F(.)-.74 E(If)144 120 Q F3(n)2.78 E F2 .02 (is not given, all curr)2.6 F .02(ently active child pr)-.18 F .02 (ocesses ar)-.18 F 2.52(ew)-.18 G .02(aited for)-2.52 F 2.52(,a)-.74 G -.02(nd the r)-2.52 F .02(eturn status is)-.18 F(zer)144 132 Q 3.138 -(o. If)-.18 F F3(n)3.398 E F2 .638(speci\214es a non-existent pr)3.218 F -.637(ocess or job, the r)-.18 F .637(eturn status is 127.)-.18 F .637 -(Otherwise, the)5.637 F -.18(re)144 144 S +.02(nd the r)-2.52 F .02(eturn status is)-.18 F(zer)144 132 Q 3.137 +(o. If)-.18 F F3(n)3.397 E F2 .637(speci\214es a non-existent pr)3.217 F +.637(ocess or job, the r)-.18 F .638(eturn status is 127.)-.18 F .638 +(Otherwise, the)5.638 F -.18(re)144 144 S (turn status is the exit status of the last pr).18 E (ocess or job waited for)-.18 E(.)-.74 E/F4 10.95/Palatino-Bold@0 SF -(RESTRICTED SHELL)72 160.8 Q F2(If)108 172.8 Q F1(bash)4.638 E F2 2.138 -(is started with the name)4.638 F F1(rbash)4.638 E F2 4.638(,o)C 4.638 -(rt)-4.638 G(he)-4.638 E F14.638 E F2 2.139 +(RESTRICTED SHELL)72 160.8 Q F2(If)108 172.8 Q F1(bash)4.639 E F2 2.139 +(is started with the name)4.639 F F1(rbash)4.638 E F2 4.638(,o)C 4.638 +(rt)-4.638 G(he)-4.638 E F14.638 E F2 2.138 (option is supplied at invocation, the shell)4.638 F .618(becomes r)108 184.8 R 3.118(estricted. A)-.18 F -.18(re)3.118 G .618 (stricted shell is used to set up an envir).18 F .618(onment mor)-.18 F 3.118(ec)-.18 G(ontr)-3.118 E .618(olled than the)-.18 F(standar)108 -196.8 Q 4.197(ds)-.18 G 4.197(hell. It)-4.197 F 1.697 +196.8 Q 4.198(ds)-.18 G 4.198(hell. It)-4.198 F 1.697 (behaves identically to)4.197 F F1(bash)4.197 E F2 1.697 -(with the exception that the following ar)4.197 F 4.198(ed)-.18 G(isal-) --4.198 E(lowed or not performed:)108 208.8 Q 29.94<8363>108 225.6 S +(with the exception that the following ar)4.197 F 4.197(ed)-.18 G(isal-) +-4.197 E(lowed or not performed:)108 208.8 Q 29.94<8363>108 225.6 S (hanging dir)-29.94 E(ectories with)-.18 E F1(cd)2.5 E F2 29.94<8373>108 242.4 S(etting or unsetting the values of)-29.94 E F1(SHELL)2.5 E F2(,)A F1 -.74(PA)2.5 G(TH)-.18 E F2(,)A F1(ENV)2.5 E F2 2.5(,o)C(r)-2.5 E F1 @@ -7132,10 +7138,10 @@ F1 -.74(PA)2.5 G(TH)-.18 E F2(,)A F1(ENV)2.5 E F2 2.5(,o)C(r)-2.5 E F1 (pecifying command names containing)-29.94 E F1(/)2.5 E F2 29.94<8373> 108 276 S(pecifying a \214le name containing a)-29.94 E F1(/)2.5 E F2 (as an ar)2.5 E(gument to the)-.18 E F1(.)2.5 E F2(builtin command)5 E -29.94<8353>108 292.8 S 1.565 +29.94<8353>108 292.8 S 1.564 (pecifying a \214lename containing a slash as an ar)-29.94 F 1.565 -(gument to the)-.18 F F14.064 E F2 1.564(option to the)4.064 F F1 -(hash)4.064 E F2(builtin command)144 304.8 Q 29.94<8369>108 321.6 S +(gument to the)-.18 F F14.065 E F2 1.565(option to the)4.065 F F1 +(hash)4.065 E F2(builtin command)144 304.8 Q 29.94<8369>108 321.6 S (mporting function de\214nitions fr)-29.94 E(om the shell envir)-.18 E (onment at startup)-.18 E 29.94<8370>108 338.4 S(arsing the value of) -29.94 E F1(SHELLOPTS)2.5 E F2(fr)2.5 E(om the shell envir)-.18 E @@ -7146,7 +7152,7 @@ F1 -.74(PA)2.5 G(TH)-.18 E F2(,)A F1(ENV)2.5 E F2 2.5(,o)C(r)-2.5 E F1 (eplace the shell with another command)-.18 E 29.94<8361>108 388.8 S 1.208(dding or deleting builtin commands with the)-29.94 F F13.708 E F2(and)3.708 E F13.708 E F2 1.208(options to the)3.708 F F1 -(enable)3.708 E F2(builtin)3.708 E(command)144 400.8 Q 29.94<8355>108 +(enable)3.707 E F2(builtin)3.707 E(command)144 400.8 Q 29.94<8355>108 417.6 S(sing the)-29.94 E F1(enable)2.5 E F2 (builtin command to enable disabled shell builtins)2.5 E 29.94<8373>108 434.4 S(pecifying the)-29.94 E F12.5 E F2(option to the)2.5 E F1 @@ -7176,7 +7182,7 @@ F2 2.5(,B)C(rian Fox and Chet Ramey)-2.5 E F3(Portable Operating System\ (The personal initialization \214le, executed for login shells)144 686.4 Q F3(~/.bashr)109.666 698.4 Q(c)-.18 E F2(The individual per)144 710.4 Q (-interactive-shell startup \214le)-.18 E F0(GNU Bash-3.0)72 768 Q -(2004 Jan 24)149.845 E(62)199.835 E 0 Cg EP +(2004 Jan 28)149.845 E(62)199.835 E 0 Cg EP %%Page: 63 63 %%BeginPageSetup BP @@ -7200,11 +7206,11 @@ E F2 .481(you should r)2.981 F .481(eport it.)-.18 F .481 -5.459 F(om)-.18 E F1(ftp://ftp.gnu.or)108 242.4 Q(g/pub/bash/)-.18 E F2 (.)A .558(Once you have determined that a bug actually exists, use the) 108 259.2 R F1(bashbug)3.188 E F2 .558(command to submit a bug)3.538 F --.18(re)108 271.2 S 3.162(port. If).18 F .662(you have a \214x, you ar) -3.162 F 3.162(ee)-.18 G .662(ncouraged to mail that as well!)-3.162 F -.661(Suggestions and `philosophi-)5.662 F 3.73(cal' bug r)108 283.2 R +-.18(re)108 271.2 S 3.161(port. If).18 F .662(you have a \214x, you ar) +3.161 F 3.162(ee)-.18 G .662(ncouraged to mail that as well!)-3.162 F +.662(Suggestions and `philosophi-)5.662 F 3.731(cal' bug r)108 283.2 R 3.731(eports may be mailed to)-.18 F F1(bug-bash@gnu.or)6.231 E(g)-.18 E -F2 3.731(or posted to the Usenet newsgr)6.231 F(oup)-.18 E F4 +F2 3.73(or posted to the Usenet newsgr)6.231 F(oup)-.18 E F4 (gnu.bash.bug)108 295.2 Q F2(.)A(ALL bug r)108 312 Q (eports should include:)-.18 E(The version number of)108 328.8 Q F4 (bash)2.5 E F2(The har)108 340.8 Q(dwar)-.18 E 2.5(ea)-.18 G @@ -7213,33 +7219,33 @@ F2 3.731(or posted to the Usenet newsgr)6.231 F(oup)-.18 E F4 S(hort script or `r)-2.5 E(ecipe' which exer)-.18 E(cises the bug)-.18 E F1(bashbug)108.13 393.6 Q F2 1.316(inserts the \214rst thr)4.296 F 1.316 (ee items automatically into the template it pr)-.18 F 1.316 -(ovides for \214ling a bug)-.18 F -.18(re)108 405.6 S(port.).18 E 7.697 +(ovides for \214ling a bug)-.18 F -.18(re)108 405.6 S(port.).18 E 7.698 (Comments and bug r)108 422.4 R 7.697 -(eports concerning this manual page should be dir)-.18 F 7.698(ected to) +(eports concerning this manual page should be dir)-.18 F 7.697(ected to) -.18 F F1(chet@po.CWRU.Edu)108 434.4 Q F2(.).06 E F3(BUGS)72 451.2 Q F2 -(It's too big and too slow)108 463.2 Q(.)-.92 E(Ther)108 480 Q 2.833(ea) --.18 G .693 -.18(re s)-2.833 H .332(ome subtle dif).18 F(fer)-.18 E .332 +(It's too big and too slow)108 463.2 Q(.)-.92 E(Ther)108 480 Q 2.832(ea) +-.18 G .692 -.18(re s)-2.832 H .332(ome subtle dif).18 F(fer)-.18 E .332 (ences between)-.18 F F4(bash)2.832 E F2 .332 -(and traditional versions of)2.832 F F4(sh)2.832 E F2 2.832(,m)C .332 +(and traditional versions of)2.832 F F4(sh)2.832 E F2 2.832(,m)C .333 (ostly because of)-2.832 F(the)108 492 Q/F5 9/Palatino-Bold@0 SF(POSIX) 2.5 E F2(speci\214cation.)2.25 E(Aliases ar)108 508.8 Q 2.5(ec)-.18 G (onfusing in some uses.)-2.5 E(Shell builtin commands and functions ar) -108 525.6 Q 2.5(en)-.18 G(ot stoppable/r)-2.5 E(estartable.)-.18 E .462 +108 525.6 Q 2.5(en)-.18 G(ot stoppable/r)-2.5 E(estartable.)-.18 E .463 (Compound commands and command sequences of the form `a ; b ; c' ar)108 -542.4 R 2.963(en)-.18 G .463(ot handled gracefully)-2.963 F 1.257 +542.4 R 2.962(en)-.18 G .462(ot handled gracefully)-2.962 F 1.256 (when pr)108 554.4 R 1.257(ocess suspension is attempted.)-.18 F 1.257 (When a pr)6.257 F 1.257(ocess is stopped, the shell immediately exe-) --.18 F .373(cutes the next command in the sequence.)108 566.4 R .373 -(It suf)5.373 F .374(\214ces to place the sequence of commands between) +-.18 F .374(cutes the next command in the sequence.)108 566.4 R .373 +(It suf)5.373 F .373(\214ces to place the sequence of commands between) -.18 F(par)108 578.4 Q(entheses to for)-.18 E -(ce it into a subshell, which may be stopped as a unit.)-.18 E .951 +(ce it into a subshell, which may be stopped as a unit.)-.18 E .95 (Commands inside of)108 595.2 R F4($\()3.451 E F2(...)A F4(\))A F2 .951 (command substitution ar)3.451 F 3.451(en)-.18 G .951 (ot parsed until substitution is attempted.)-3.451 F (This will delay err)108 607.2 Q(or r)-.18 E (eporting until some time after the command is enter)-.18 E(ed.)-.18 E (Array variables may not \(yet\) be exported.)108 624 Q F0(GNU Bash-3.0) -72 768 Q(2004 Jan 24)149.845 E(63)199.835 E 0 Cg EP +72 768 Q(2004 Jan 28)149.845 E(63)199.835 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/bashref.dvi b/doc/bashref.dvi index 552e467ef..081341a93 100644 Binary files a/doc/bashref.dvi and b/doc/bashref.dvi differ diff --git a/doc/bashref.fn b/doc/bashref.fn index 4216e4b16..64d15e488 100644 --- a/doc/bashref.fn +++ b/doc/bashref.fn @@ -37,21 +37,22 @@ \entry{kill-word (M-d)}{98}{\code {kill-word (M-d)}} \entry{backward-kill-word (M-DEL)}{98}{\code {backward-kill-word (M-\key {DEL})}} \entry{unix-word-rubout (C-w)}{98}{\code {unix-word-rubout (C-w)}} +\entry{unix-filename-rubout ()}{98}{\code {unix-filename-rubout ()}} \entry{delete-horizontal-space ()}{98}{\code {delete-horizontal-space ()}} \entry{kill-region ()}{98}{\code {kill-region ()}} \entry{copy-region-as-kill ()}{98}{\code {copy-region-as-kill ()}} \entry{copy-backward-word ()}{98}{\code {copy-backward-word ()}} \entry{copy-forward-word ()}{98}{\code {copy-forward-word ()}} -\entry{yank (C-y)}{98}{\code {yank (C-y)}} -\entry{yank-pop (M-y)}{98}{\code {yank-pop (M-y)}} +\entry{yank (C-y)}{99}{\code {yank (C-y)}} +\entry{yank-pop (M-y)}{99}{\code {yank-pop (M-y)}} \entry{digit-argument (M-0, M-1, ...{} M--)}{99}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}} \entry{universal-argument ()}{99}{\code {universal-argument ()}} \entry{complete (TAB)}{99}{\code {complete (\key {TAB})}} \entry{possible-completions (M-?)}{99}{\code {possible-completions (M-?)}} \entry{insert-completions (M-*)}{99}{\code {insert-completions (M-*)}} \entry{menu-complete ()}{99}{\code {menu-complete ()}} -\entry{delete-char-or-list ()}{99}{\code {delete-char-or-list ()}} -\entry{complete-filename (M-/)}{99}{\code {complete-filename (M-/)}} +\entry{delete-char-or-list ()}{100}{\code {delete-char-or-list ()}} +\entry{complete-filename (M-/)}{100}{\code {complete-filename (M-/)}} \entry{possible-filename-completions (C-x /)}{100}{\code {possible-filename-completions (C-x /)}} \entry{complete-username (M-~)}{100}{\code {complete-username (M-~)}} \entry{possible-username-completions (C-x ~)}{100}{\code {possible-username-completions (C-x ~)}} @@ -64,7 +65,7 @@ \entry{dynamic-complete-history (M-TAB)}{100}{\code {dynamic-complete-history (M-\key {TAB})}} \entry{complete-into-braces (M-{\tt \char 123})}{100}{\code {complete-into-braces (M-{\tt \char 123})}} \entry{start-kbd-macro (C-x ()}{100}{\code {start-kbd-macro (C-x ()}} -\entry{end-kbd-macro (C-x ))}{100}{\code {end-kbd-macro (C-x ))}} +\entry{end-kbd-macro (C-x ))}{101}{\code {end-kbd-macro (C-x ))}} \entry{call-last-kbd-macro (C-x e)}{101}{\code {call-last-kbd-macro (C-x e)}} \entry{re-read-init-file (C-x C-r)}{101}{\code {re-read-init-file (C-x C-r)}} \entry{abort (C-g)}{101}{\code {abort (C-g)}} @@ -77,7 +78,7 @@ \entry{exchange-point-and-mark (C-x C-x)}{101}{\code {exchange-point-and-mark (C-x C-x)}} \entry{character-search (C-])}{101}{\code {character-search (C-])}} \entry{character-search-backward (M-C-])}{101}{\code {character-search-backward (M-C-])}} -\entry{insert-comment (M-#)}{101}{\code {insert-comment (M-#)}} +\entry{insert-comment (M-#)}{102}{\code {insert-comment (M-#)}} \entry{dump-functions ()}{102}{\code {dump-functions ()}} \entry{dump-variables ()}{102}{\code {dump-variables ()}} \entry{dump-macros ()}{102}{\code {dump-macros ()}} @@ -87,8 +88,8 @@ \entry{display-shell-version (C-x C-v)}{102}{\code {display-shell-version (C-x C-v)}} \entry{shell-expand-line (M-C-e)}{102}{\code {shell-expand-line (M-C-e)}} \entry{history-expand-line (M-^)}{102}{\code {history-expand-line (M-^)}} -\entry{magic-space ()}{102}{\code {magic-space ()}} -\entry{alias-expand-line ()}{102}{\code {alias-expand-line ()}} +\entry{magic-space ()}{103}{\code {magic-space ()}} +\entry{alias-expand-line ()}{103}{\code {alias-expand-line ()}} \entry{history-and-alias-expand-line ()}{103}{\code {history-and-alias-expand-line ()}} \entry{insert-last-argument (M-. or M-_)}{103}{\code {insert-last-argument (M-. or M-_)}} \entry{operate-and-get-next (C-o)}{103}{\code {operate-and-get-next (C-o)}} diff --git a/doc/bashref.fns b/doc/bashref.fns index 3fb6cb68f..105b9a94b 100644 --- a/doc/bashref.fns +++ b/doc/bashref.fns @@ -1,4 +1,116 @@ \initial {A} \entry {\code {abort (C-g)}}{101} \entry {\code {accept-line (Newline or Return)}}{95} -\entry {\code {alias-expand-line ()}}{102 \ No newline at end of file +\entry {\code {alias-expand-line ()}}{103} +\initial {B} +\entry {\code {backward-char (C-b)}}{95} +\entry {\code {backward-delete-char (Rubout)}}{97} +\entry {\code {backward-kill-line (C-x Rubout)}}{98} +\entry {\code {backward-kill-word (M-\key {DEL})}}{98} +\entry {\code {backward-word (M-b)}}{95} +\entry {\code {beginning-of-history (M-<)}}{96} +\entry {\code {beginning-of-line (C-a)}}{95} +\initial {C} +\entry {\code {call-last-kbd-macro (C-x e)}}{101} +\entry {\code {capitalize-word (M-c)}}{97} +\entry {\code {character-search (C-])}}{101} +\entry {\code {character-search-backward (M-C-])}}{101} +\entry {\code {clear-screen (C-l)}}{95} +\entry {\code {complete (\key {TAB})}}{99} +\entry {\code {complete-command (M-!)}}{100} +\entry {\code {complete-filename (M-/)}}{100} +\entry {\code {complete-hostname (M-@)}}{100} +\entry {\code {complete-into-braces (M-{\tt \char 123})}}{100} +\entry {\code {complete-username (M-~)}}{100} +\entry {\code {complete-variable (M-$)}}{100} +\entry {\code {copy-backward-word ()}}{98} +\entry {\code {copy-forward-word ()}}{98} +\entry {\code {copy-region-as-kill ()}}{98} +\initial {D} +\entry {\code {delete-char (C-d)}}{97} +\entry {\code {delete-char-or-list ()}}{100} +\entry {\code {delete-horizontal-space ()}}{98} +\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{99} +\entry {\code {display-shell-version (C-x C-v)}}{102} +\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{101} +\entry {\code {downcase-word (M-l)}}{97} +\entry {\code {dump-functions ()}}{102} +\entry {\code {dump-macros ()}}{102} +\entry {\code {dump-variables ()}}{102} +\entry {\code {dynamic-complete-history (M-\key {TAB})}}{100} +\initial {E} +\entry {\code {edit-and-execute-command (C-xC-e)}}{103} +\entry {\code {end-kbd-macro (C-x ))}}{101} +\entry {\code {end-of-history (M->)}}{96} +\entry {\code {end-of-line (C-e)}}{95} +\entry {\code {exchange-point-and-mark (C-x C-x)}}{101} +\initial {F} +\entry {\code {forward-backward-delete-char ()}}{97} +\entry {\code {forward-char (C-f)}}{95} +\entry {\code {forward-search-history (C-s)}}{96} +\entry {\code {forward-word (M-f)}}{95} +\initial {G} +\entry {\code {glob-complete-word (M-g)}}{102} +\entry {\code {glob-expand-word (C-x *)}}{102} +\entry {\code {glob-list-expansions (C-x g)}}{102} +\initial {H} +\entry {\code {history-and-alias-expand-line ()}}{103} +\entry {\code {history-expand-line (M-^)}}{102} +\entry {\code {history-search-backward ()}}{96} +\entry {\code {history-search-forward ()}}{96} +\initial {I} +\entry {\code {insert-comment (M-#)}}{102} +\entry {\code {insert-completions (M-*)}}{99} +\entry {\code {insert-last-argument (M-. or M-_)}}{103} +\initial {K} +\entry {\code {kill-line (C-k)}}{98} +\entry {\code {kill-region ()}}{98} +\entry {\code {kill-whole-line ()}}{98} +\entry {\code {kill-word (M-d)}}{98} +\initial {M} +\entry {\code {magic-space ()}}{103} +\entry {\code {menu-complete ()}}{99} +\initial {N} +\entry {\code {next-history (C-n)}}{96} +\entry {\code {non-incremental-forward-search-history (M-n)}}{96} +\entry {\code {non-incremental-reverse-search-history (M-p)}}{96} +\initial {O} +\entry {\code {operate-and-get-next (C-o)}}{103} +\entry {\code {overwrite-mode ()}}{97} +\initial {P} +\entry {\code {possible-command-completions (C-x !)}}{100} +\entry {\code {possible-completions (M-?)}}{99} +\entry {\code {possible-filename-completions (C-x /)}}{100} +\entry {\code {possible-hostname-completions (C-x @)}}{100} +\entry {\code {possible-username-completions (C-x ~)}}{100} +\entry {\code {possible-variable-completions (C-x $)}}{100} +\entry {\code {prefix-meta (\key {ESC})}}{101} +\entry {\code {previous-history (C-p)}}{96} +\initial {Q} +\entry {\code {quoted-insert (C-q or C-v)}}{97} +\initial {R} +\entry {\code {re-read-init-file (C-x C-r)}}{101} +\entry {\code {redraw-current-line ()}}{95} +\entry {\code {reverse-search-history (C-r)}}{96} +\entry {\code {revert-line (M-r)}}{101} +\initial {S} +\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{97} +\entry {\code {set-mark (C-@)}}{101} +\entry {\code {shell-expand-line (M-C-e)}}{102} +\entry {\code {start-kbd-macro (C-x ()}}{100} +\initial {T} +\entry {\code {tilde-expand (M-&)}}{101} +\entry {\code {transpose-chars (C-t)}}{97} +\entry {\code {transpose-words (M-t)}}{97} +\initial {U} +\entry {\code {undo (C-_ or C-x C-u)}}{101} +\entry {\code {universal-argument ()}}{99} +\entry {\code {unix-filename-rubout ()}}{98} +\entry {\code {unix-line-discard (C-u)}}{98} +\entry {\code {unix-word-rubout (C-w)}}{98} +\entry {\code {upcase-word (M-u)}}{97} +\initial {Y} +\entry {\code {yank (C-y)}}{99} +\entry {\code {yank-last-arg (M-. or M-_)}}{96} +\entry {\code {yank-nth-arg (M-C-y)}}{96} +\entry {\code {yank-pop (M-y)}}{99} diff --git a/doc/bashref.html b/doc/bashref.html index 4a8696147..8c12747df 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -1,6 +1,6 @@ - +
- +
digit-argument (M-0, M-1, ... M--) -
+
Add this digit to the argument already accumulating, or start a new argument. M-- starts a negative argument.

- +

universal-argument () -
+
This is another way to specify an argument. If this command is followed by one or more digits, optionally with a leading minus sign, those digits define the argument. @@ -9971,9 +9979,9 @@ By default, this is not bound to a key.

- +
complete (TAB) -
+
Attempt to perform completion on the text before point. The actual completion performed is application-specific. Bash attempts completion treating the text as a variable (if the @@ -9983,22 +9991,22 @@ command (including aliases and functions) in turn. If none of these produces a match, filename completion is attempted.

- +

possible-completions (M-?) -
+
List the possible completions of the text before point.

- +

insert-completions (M-*) -
+
Insert all completions of the text before point that would have been generated by possible-completions.

- +

menu-complete () -
+
Similar to complete, but replaces the word to be completed with a single match from the list of possible completions. Repeated execution of menu-complete steps through the list @@ -10013,9 +10021,9 @@ This command is intended to be bound to TAB, but is unbound by default.

- +

delete-char-or-list () -
+
Deletes the character under the cursor if not at the beginning or end of the line (like delete-char). If at the end of the line, behaves identically to @@ -10023,64 +10031,64 @@ If at the end of the line, behaves identically to This command is unbound by default.

- +

complete-filename (M-/) -
+
Attempt filename completion on the text before point.

- +

possible-filename-completions (C-x /) -
+
List the possible completions of the text before point, treating it as a filename.

- +

complete-username (M-~) -
+
Attempt completion on the text before point, treating it as a username.

- +

possible-username-completions (C-x ~) -
+
List the possible completions of the text before point, treating it as a username.

- +

complete-variable (M-$) -
+
Attempt completion on the text before point, treating it as a shell variable.

- +

possible-variable-completions (C-x $) -
+
List the possible completions of the text before point, treating it as a shell variable.

- +

complete-hostname (M-@) -
+
Attempt completion on the text before point, treating it as a hostname.

- +

possible-hostname-completions (C-x @) -
+
List the possible completions of the text before point, treating it as a hostname.

- +

complete-command (M-!) -
+
Attempt completion on the text before point, treating it as a command name. Command completion attempts to match the text against aliases, reserved words, shell @@ -10088,24 +10096,24 @@ functions, shell builtins, and finally executable filenames, in that order.

- +

possible-command-completions (C-x !) -
+
List the possible completions of the text before point, treating it as a command name.

- +

dynamic-complete-history (M-TAB) -
+
Attempt completion on the text before point, comparing the text against lines from the history list for possible completion matches.

- +

complete-into-braces (M-{) -
+
Perform filename completion and insert the list of possible completions enclosed within braces so the list is available to the shell (see section 3.5.1 Brace Expansion). @@ -10132,22 +10140,22 @@ enclosed within braces so the list is available to the shell
- +
start-kbd-macro (C-x () -
+
Begin saving the characters typed into the current keyboard macro.

- +

end-kbd-macro (C-x )) -
+
Stop saving the characters typed into the current keyboard macro and save the definition.

- +

call-last-kbd-macro (C-x e) -
+
Re-execute the last keyboard macro defined, by making the characters in the macro appear as if typed at the keyboard.

@@ -10173,87 +10181,87 @@ in the macro appear as if typed at the keyboard.

- +
re-read-init-file (C-x C-r) -
+
Read in the contents of the inputrc file, and incorporate any bindings or variable assignments found there.

- +

abort (C-g) -
+
Abort the current editing command and ring the terminal's bell (subject to the setting of bell-style).

- +

do-uppercase-version (M-a, M-b, M-x, ...) -
+
If the metafied character x is lowercase, run the command that is bound to the corresponding uppercase character.

- +

prefix-meta (ESC) -
+
Metafy the next character typed. This is for keyboards without a meta key. Typing `ESC f' is equivalent to typing M-f.

- +

undo (C-_ or C-x C-u) -
+
Incremental undo, separately remembered for each line.

- +

revert-line (M-r) -
+
Undo all changes made to this line. This is like executing the undo command enough times to get back to the beginning.

- +

tilde-expand (M-&) -
+
Perform tilde expansion on the current word.

- +

set-mark (C-@) -
+
Set the mark to the point. If a numeric argument is supplied, the mark is set to that position.

- +

exchange-point-and-mark (C-x C-x) -
+
Swap the point with the mark. The current cursor position is set to the saved position, and the old cursor position is saved as the mark.

- +

character-search (C-]) -
+
A character is read and point is moved to the next occurrence of that character. A negative count searches for previous occurrences.

- +

character-search-backward (M-C-]) -
+
A character is read and point is moved to the previous occurrence of that character. A negative count searches for subsequent occurrences.

- +

insert-comment (M-#) -
+
Without a numeric argument, the value of the comment-begin variable is inserted at the beginning of the current line. If a numeric argument is supplied, this command acts as a toggle: if @@ -10268,115 +10276,115 @@ If a numeric argument causes the comment character to be removed, the line will be executed by the shell.

- +

dump-functions () -
+
Print all of the functions and their key bindings to the Readline output stream. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an inputrc file. This command is unbound by default.

- +

dump-variables () -
+
Print all of the settable variables and their values to the Readline output stream. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an inputrc file. This command is unbound by default.

- +

dump-macros () -
+
Print all of the Readline key sequences bound to macros and the strings they output. If a numeric argument is supplied, the output is formatted in such a way that it can be made part of an inputrc file. This command is unbound by default.

- +

glob-complete-word (M-g) -
+
The word before point is treated as a pattern for pathname expansion, with an asterisk implicitly appended. This pattern is used to generate a list of matching file names for possible completions.

- +

glob-expand-word (C-x *) -
+
The word before point is treated as a pattern for pathname expansion, and the list of matching file names is inserted, replacing the word. If a numeric argument is supplied, a `*' is appended before pathname expansion.

- +

glob-list-expansions (C-x g) -
+
The list of expansions that would have been generated by glob-expand-word is displayed, and the line is redrawn. If a numeric argument is supplied, a `*' is appended before pathname expansion.

- +

display-shell-version (C-x C-v) -
+
Display version information about the current instance of Bash.

- +

shell-expand-line (M-C-e) -
+
Expand the line as the shell does. This performs alias and history expansion as well as all of the shell word expansions (see section 3.5 Shell Expansions).

- +

history-expand-line (M-^) -
+
Perform history expansion on the current line.

- +

magic-space () -
+
Perform history expansion on the current line and insert a space (see section 9.3 History Expansion).

- +

alias-expand-line () -
+
Perform alias expansion on the current line (see section 6.6 Aliases).

- +

history-and-alias-expand-line () -
+
Perform history and alias expansion on the current line.

- +

insert-last-argument (M-. or M-_) -
+
A synonym for yank-last-arg.

- +

operate-and-get-next (C-o) -
+
Accept the current line for execution and fetch the next line relative to the current line from the history for editing. Any argument is ignored.

- +

edit-and-execute-command (C-xC-e) -
+
Invoke an editor on the current command line, and execute the result as shell commands. Bash attempts to invoke @@ -10597,7 +10605,7 @@ facilities.
compgen -
+
 
compgen [option] [word]
 

@@ -10623,7 +10631,7 @@ matches were generated.

complete -
+
 
complete [-abcdefgjksuv] [-o comp-option] [-A action] [-G globpat] [-W wordlist]
 [-P prefix] [-S suffix] [-X filterpat] [-F function]
 [-C command] name [name ...]
@@ -10845,7 +10853,7 @@ an error occurs adding a completion specification.
 

- +

@@ -10986,7 +10994,7 @@ history list and history file.

fc -
+
 
fc [-e ename] [-nlr] [first] [last]
 fc -s [pat=rep] [command]
 

@@ -11020,7 +11028,7 @@ and typing `r' re-executes the last command (see section +

- - + + @@ -13371,7 +13379,7 @@ to permit their use in free software. - + @@ -13380,7 +13388,7 @@ to permit their use in free software. - + @@ -14053,12 +14061,12 @@ to permit their use in free software. - - + + - - + + @@ -14077,72 +14085,72 @@ to permit their use in free software. - - + + - - - - + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - + + + + + + + + - - - - + + + + - - + + @@ -14155,46 +14163,46 @@ to permit their use in free software. - - - - - - + + + + + + - - - - + + + + - - - - - - + + + + + + - - + + - - - - + + + + @@ -14205,26 +14213,26 @@ to permit their use in free software. - - + + - - - - - - - - - - - - - - + + + + + + + + + + + + + + @@ -14233,38 +14241,40 @@ to permit their use in free software. - - + + - - + + - - - - - - + + + + + + - - + + - - - - + + + + + + @@ -14273,14 +14283,14 @@ to permit their use in free software. - - + + - - + +
 
history [n]
 history -c
 history -d offset
@@ -11190,7 +11198,7 @@ history expansion mechanism with the histchars variable.
 
 An event designator is a reference to a command line entry in the
 history list.
-
+
 

@@ -12750,7 +12758,7 @@ The SVR4.2 shell behaves differently when invoked as jsh

- +

Version 1.2, November 2002
@@ -13353,8 +13361,8 @@ to permit their use in free software.
caller4.2 Bash Builtin Commands
cd4.1 Bourne Shell Builtins
command4.2 Bash Builtin Commands
compgen8.7 Programmable Completion Builtins
complete8.7 Programmable Completion Builtins
compgen8.7 Programmable Completion Builtins
complete8.7 Programmable Completion Builtins
continue4.1 Bourne Shell Builtins

D
export4.1 Bourne Shell Builtins

F
fc9.2 Bash History Builtins
fc9.2 Bash History Builtins
fg7.2 Job Control Builtins

G
H
hash4.1 Bourne Shell Builtins
help4.2 Bash Builtin Commands
history9.2 Bash History Builtins
history9.2 Bash History Builtins

J
jobs7.2 Job Control Builtins
Index Entry Section

A
abort (C-g)8.4.8 Some Miscellaneous Commands
abort (C-g)8.4.8 Some Miscellaneous Commands
abort (C-g)8.4.8 Some Miscellaneous Commands
abort (C-g)8.4.8 Some Miscellaneous Commands
accept-line (Newline or Return)8.4.2 Commands For Manipulating The History
accept-line (Newline or Return)8.4.2 Commands For Manipulating The History
alias-expand-line ()8.4.8 Some Miscellaneous Commands
alias-expand-line ()8.4.8 Some Miscellaneous Commands
alias-expand-line ()8.4.8 Some Miscellaneous Commands
alias-expand-line ()8.4.8 Some Miscellaneous Commands

B
backward-char (C-b)8.4.1 Commands For Moving
beginning-of-line (C-a)8.4.1 Commands For Moving

C
call-last-kbd-macro (C-x e)8.4.7 Keyboard Macros
call-last-kbd-macro (C-x e)8.4.7 Keyboard Macros
call-last-kbd-macro (C-x e)8.4.7 Keyboard Macros
call-last-kbd-macro (C-x e)8.4.7 Keyboard Macros
capitalize-word (M-c)8.4.3 Commands For Changing Text
capitalize-word (M-c)8.4.3 Commands For Changing Text
character-search (C-])8.4.8 Some Miscellaneous Commands
character-search (C-])8.4.8 Some Miscellaneous Commands
character-search-backward (M-C-])8.4.8 Some Miscellaneous Commands
character-search-backward (M-C-])8.4.8 Some Miscellaneous Commands
character-search (C-])8.4.8 Some Miscellaneous Commands
character-search (C-])8.4.8 Some Miscellaneous Commands
character-search-backward (M-C-])8.4.8 Some Miscellaneous Commands
character-search-backward (M-C-])8.4.8 Some Miscellaneous Commands
clear-screen (C-l)8.4.1 Commands For Moving
clear-screen (C-l)8.4.1 Commands For Moving
complete (TAB)8.4.6 Letting Readline Type For You
complete (TAB)8.4.6 Letting Readline Type For You
complete-command (M-!)8.4.6 Letting Readline Type For You
complete-command (M-!)8.4.6 Letting Readline Type For You
complete-filename (M-/)8.4.6 Letting Readline Type For You
complete-filename (M-/)8.4.6 Letting Readline Type For You
complete-hostname (M-@)8.4.6 Letting Readline Type For You
complete-hostname (M-@)8.4.6 Letting Readline Type For You
complete-into-braces (M-{)8.4.6 Letting Readline Type For You
complete-into-braces (M-{)8.4.6 Letting Readline Type For You
complete-username (M-~)8.4.6 Letting Readline Type For You
complete-username (M-~)8.4.6 Letting Readline Type For You
complete-variable (M-$)8.4.6 Letting Readline Type For You
complete-variable (M-$)8.4.6 Letting Readline Type For You
copy-backward-word ()8.4.4 Killing And Yanking
copy-backward-word ()8.4.4 Killing And Yanking
copy-forward-word ()8.4.4 Killing And Yanking
copy-forward-word ()8.4.4 Killing And Yanking
copy-region-as-kill ()8.4.4 Killing And Yanking
copy-region-as-kill ()8.4.4 Killing And Yanking
complete (TAB)8.4.6 Letting Readline Type For You
complete (TAB)8.4.6 Letting Readline Type For You
complete-command (M-!)8.4.6 Letting Readline Type For You
complete-command (M-!)8.4.6 Letting Readline Type For You
complete-filename (M-/)8.4.6 Letting Readline Type For You
complete-filename (M-/)8.4.6 Letting Readline Type For You
complete-hostname (M-@)8.4.6 Letting Readline Type For You
complete-hostname (M-@)8.4.6 Letting Readline Type For You
complete-into-braces (M-{)8.4.6 Letting Readline Type For You
complete-into-braces (M-{)8.4.6 Letting Readline Type For You
complete-username (M-~)8.4.6 Letting Readline Type For You
complete-username (M-~)8.4.6 Letting Readline Type For You
complete-variable (M-$)8.4.6 Letting Readline Type For You
complete-variable (M-$)8.4.6 Letting Readline Type For You
copy-backward-word ()8.4.4 Killing And Yanking
copy-backward-word ()8.4.4 Killing And Yanking
copy-forward-word ()8.4.4 Killing And Yanking
copy-forward-word ()8.4.4 Killing And Yanking
copy-region-as-kill ()8.4.4 Killing And Yanking
copy-region-as-kill ()8.4.4 Killing And Yanking

D
delete-char (C-d)8.4.3 Commands For Changing Text
delete-char (C-d)8.4.3 Commands For Changing Text
delete-char-or-list ()8.4.6 Letting Readline Type For You
delete-char-or-list ()8.4.6 Letting Readline Type For You
delete-horizontal-space ()8.4.4 Killing And Yanking
delete-horizontal-space ()8.4.4 Killing And Yanking
digit-argument (M-0, M-1, <small>...</small> M--)8.4.5 Specifying Numeric Arguments
digit-argument (M-0, M-1, <small>...</small> M--)8.4.5 Specifying Numeric Arguments
display-shell-version (C-x C-v)8.4.8 Some Miscellaneous Commands
display-shell-version (C-x C-v)8.4.8 Some Miscellaneous Commands
do-uppercase-version (M-a, M-b, M-x, <small>...</small>)8.4.8 Some Miscellaneous Commands
do-uppercase-version (M-a, M-b, M-x, <small>...</small>)8.4.8 Some Miscellaneous Commands
delete-char-or-list ()8.4.6 Letting Readline Type For You
delete-char-or-list ()8.4.6 Letting Readline Type For You
delete-horizontal-space ()8.4.4 Killing And Yanking
delete-horizontal-space ()8.4.4 Killing And Yanking
digit-argument (M-0, M-1, <small>...</small> M--)8.4.5 Specifying Numeric Arguments
digit-argument (M-0, M-1, <small>...</small> M--)8.4.5 Specifying Numeric Arguments
display-shell-version (C-x C-v)8.4.8 Some Miscellaneous Commands
display-shell-version (C-x C-v)8.4.8 Some Miscellaneous Commands
do-uppercase-version (M-a, M-b, M-x, <small>...</small>)8.4.8 Some Miscellaneous Commands
do-uppercase-version (M-a, M-b, M-x, <small>...</small>)8.4.8 Some Miscellaneous Commands
downcase-word (M-l)8.4.3 Commands For Changing Text
downcase-word (M-l)8.4.3 Commands For Changing Text
dump-functions ()8.4.8 Some Miscellaneous Commands
dump-functions ()8.4.8 Some Miscellaneous Commands
dump-macros ()8.4.8 Some Miscellaneous Commands
dump-macros ()8.4.8 Some Miscellaneous Commands
dump-variables ()8.4.8 Some Miscellaneous Commands
dump-variables ()8.4.8 Some Miscellaneous Commands
dynamic-complete-history (M-TAB)8.4.6 Letting Readline Type For You
dynamic-complete-history (M-TAB)8.4.6 Letting Readline Type For You
dump-functions ()8.4.8 Some Miscellaneous Commands
dump-functions ()8.4.8 Some Miscellaneous Commands
dump-macros ()8.4.8 Some Miscellaneous Commands
dump-macros ()8.4.8 Some Miscellaneous Commands
dump-variables ()8.4.8 Some Miscellaneous Commands
dump-variables ()8.4.8 Some Miscellaneous Commands
dynamic-complete-history (M-TAB)8.4.6 Letting Readline Type For You
dynamic-complete-history (M-TAB)8.4.6 Letting Readline Type For You

E
edit-and-execute-command (C-xC-e)8.4.8 Some Miscellaneous Commands
edit-and-execute-command (C-xC-e)8.4.8 Some Miscellaneous Commands
end-kbd-macro (C-x ))8.4.7 Keyboard Macros
end-kbd-macro (C-x ))8.4.7 Keyboard Macros
edit-and-execute-command (C-xC-e)8.4.8 Some Miscellaneous Commands
edit-and-execute-command (C-xC-e)8.4.8 Some Miscellaneous Commands
end-kbd-macro (C-x ))8.4.7 Keyboard Macros
end-kbd-macro (C-x ))8.4.7 Keyboard Macros
end-of-history (M-&#62;)8.4.2 Commands For Manipulating The History
end-of-history (M-&#62;)8.4.2 Commands For Manipulating The History
end-of-line (C-e)8.4.1 Commands For Moving
end-of-line (C-e)8.4.1 Commands For Moving
exchange-point-and-mark (C-x C-x)8.4.8 Some Miscellaneous Commands
exchange-point-and-mark (C-x C-x)8.4.8 Some Miscellaneous Commands
exchange-point-and-mark (C-x C-x)8.4.8 Some Miscellaneous Commands
exchange-point-and-mark (C-x C-x)8.4.8 Some Miscellaneous Commands

F
forward-backward-delete-char ()8.4.3 Commands For Changing Text
forward-word (M-f)8.4.1 Commands For Moving

G
glob-complete-word (M-g)8.4.8 Some Miscellaneous Commands
glob-complete-word (M-g)8.4.8 Some Miscellaneous Commands
glob-expand-word (C-x *)8.4.8 Some Miscellaneous Commands
glob-expand-word (C-x *)8.4.8 Some Miscellaneous Commands
glob-list-expansions (C-x g)8.4.8 Some Miscellaneous Commands
glob-list-expansions (C-x g)8.4.8 Some Miscellaneous Commands
glob-complete-word (M-g)8.4.8 Some Miscellaneous Commands
glob-complete-word (M-g)8.4.8 Some Miscellaneous Commands
glob-expand-word (C-x *)8.4.8 Some Miscellaneous Commands
glob-expand-word (C-x *)8.4.8 Some Miscellaneous Commands
glob-list-expansions (C-x g)8.4.8 Some Miscellaneous Commands
glob-list-expansions (C-x g)8.4.8 Some Miscellaneous Commands

H
history-and-alias-expand-line ()8.4.8 Some Miscellaneous Commands
history-and-alias-expand-line ()8.4.8 Some Miscellaneous Commands
history-expand-line (M-^)8.4.8 Some Miscellaneous Commands
history-expand-line (M-^)8.4.8 Some Miscellaneous Commands
history-and-alias-expand-line ()8.4.8 Some Miscellaneous Commands
history-and-alias-expand-line ()8.4.8 Some Miscellaneous Commands
history-expand-line (M-^)8.4.8 Some Miscellaneous Commands
history-expand-line (M-^)8.4.8 Some Miscellaneous Commands
history-search-backward ()8.4.2 Commands For Manipulating The History
history-search-backward ()8.4.2 Commands For Manipulating The History
history-search-forward ()8.4.2 Commands For Manipulating The History
history-search-forward ()8.4.2 Commands For Manipulating The History

I
insert-comment (M-#)8.4.8 Some Miscellaneous Commands
insert-comment (M-#)8.4.8 Some Miscellaneous Commands
insert-completions (M-*)8.4.6 Letting Readline Type For You
insert-completions (M-*)8.4.6 Letting Readline Type For You
insert-last-argument (M-. or M-_)8.4.8 Some Miscellaneous Commands
insert-last-argument (M-. or M-_)8.4.8 Some Miscellaneous Commands
insert-comment (M-#)8.4.8 Some Miscellaneous Commands
insert-comment (M-#)8.4.8 Some Miscellaneous Commands
insert-completions (M-*)8.4.6 Letting Readline Type For You
insert-completions (M-*)8.4.6 Letting Readline Type For You
insert-last-argument (M-. or M-_)8.4.8 Some Miscellaneous Commands
insert-last-argument (M-. or M-_)8.4.8 Some Miscellaneous Commands

K
kill-line (C-k)8.4.4 Killing And Yanking
kill-line (C-k)8.4.4 Killing And Yanking
kill-region ()8.4.4 Killing And Yanking
kill-region ()8.4.4 Killing And Yanking
kill-region ()8.4.4 Killing And Yanking
kill-region ()8.4.4 Killing And Yanking
kill-whole-line ()8.4.4 Killing And Yanking
kill-whole-line ()8.4.4 Killing And Yanking
kill-word (M-d)8.4.4 Killing And Yanking
kill-word (M-d)8.4.4 Killing And Yanking

M
magic-space ()8.4.8 Some Miscellaneous Commands
magic-space ()8.4.8 Some Miscellaneous Commands
menu-complete ()8.4.6 Letting Readline Type For You
menu-complete ()8.4.6 Letting Readline Type For You
magic-space ()8.4.8 Some Miscellaneous Commands
magic-space ()8.4.8 Some Miscellaneous Commands
menu-complete ()8.4.6 Letting Readline Type For You
menu-complete ()8.4.6 Letting Readline Type For You

N
next-history (C-n)8.4.2 Commands For Manipulating The History
non-incremental-reverse-search-history (M-p)8.4.2 Commands For Manipulating The History

O
operate-and-get-next (C-o)8.4.8 Some Miscellaneous Commands
operate-and-get-next (C-o)8.4.8 Some Miscellaneous Commands
operate-and-get-next (C-o)8.4.8 Some Miscellaneous Commands
operate-and-get-next (C-o)8.4.8 Some Miscellaneous Commands
overwrite-mode ()8.4.3 Commands For Changing Text
overwrite-mode ()8.4.3 Commands For Changing Text

P
possible-command-completions (C-x !)8.4.6 Letting Readline Type For You
possible-command-completions (C-x !)8.4.6 Letting Readline Type For You
possible-completions (M-?)8.4.6 Letting Readline Type For You
possible-completions (M-?)8.4.6 Letting Readline Type For You
possible-filename-completions (C-x /)8.4.6 Letting Readline Type For You
possible-filename-completions (C-x /)8.4.6 Letting Readline Type For You
possible-hostname-completions (C-x @)8.4.6 Letting Readline Type For You
possible-hostname-completions (C-x @)8.4.6 Letting Readline Type For You
possible-username-completions (C-x ~)8.4.6 Letting Readline Type For You
possible-username-completions (C-x ~)8.4.6 Letting Readline Type For You
possible-variable-completions (C-x $)8.4.6 Letting Readline Type For You
possible-variable-completions (C-x $)8.4.6 Letting Readline Type For You
prefix-meta (ESC)8.4.8 Some Miscellaneous Commands
prefix-meta (ESC)8.4.8 Some Miscellaneous Commands
possible-command-completions (C-x !)8.4.6 Letting Readline Type For You
possible-command-completions (C-x !)8.4.6 Letting Readline Type For You
possible-completions (M-?)8.4.6 Letting Readline Type For You
possible-completions (M-?)8.4.6 Letting Readline Type For You
possible-filename-completions (C-x /)8.4.6 Letting Readline Type For You
possible-filename-completions (C-x /)8.4.6 Letting Readline Type For You
possible-hostname-completions (C-x @)8.4.6 Letting Readline Type For You
possible-hostname-completions (C-x @)8.4.6 Letting Readline Type For You
possible-username-completions (C-x ~)8.4.6 Letting Readline Type For You
possible-username-completions (C-x ~)8.4.6 Letting Readline Type For You
possible-variable-completions (C-x $)8.4.6 Letting Readline Type For You
possible-variable-completions (C-x $)8.4.6 Letting Readline Type For You
prefix-meta (ESC)8.4.8 Some Miscellaneous Commands
prefix-meta (ESC)8.4.8 Some Miscellaneous Commands
previous-history (C-p)8.4.2 Commands For Manipulating The History
previous-history (C-p)8.4.2 Commands For Manipulating The History

quoted-insert (C-q or C-v)8.4.3 Commands For Changing Text

R
re-read-init-file (C-x C-r)8.4.8 Some Miscellaneous Commands
re-read-init-file (C-x C-r)8.4.8 Some Miscellaneous Commands
re-read-init-file (C-x C-r)8.4.8 Some Miscellaneous Commands
re-read-init-file (C-x C-r)8.4.8 Some Miscellaneous Commands
redraw-current-line ()8.4.1 Commands For Moving
redraw-current-line ()8.4.1 Commands For Moving
reverse-search-history (C-r)8.4.2 Commands For Manipulating The History
reverse-search-history (C-r)8.4.2 Commands For Manipulating The History
revert-line (M-r)8.4.8 Some Miscellaneous Commands
revert-line (M-r)8.4.8 Some Miscellaneous Commands
revert-line (M-r)8.4.8 Some Miscellaneous Commands
revert-line (M-r)8.4.8 Some Miscellaneous Commands

S
self-insert (a, b, A, 1, !, <small>...</small>)8.4.3 Commands For Changing Text
self-insert (a, b, A, 1, !, <small>...</small>)8.4.3 Commands For Changing Text
set-mark (C-@)8.4.8 Some Miscellaneous Commands
set-mark (C-@)8.4.8 Some Miscellaneous Commands
shell-expand-line (M-C-e)8.4.8 Some Miscellaneous Commands
shell-expand-line (M-C-e)8.4.8 Some Miscellaneous Commands
start-kbd-macro (C-x ()8.4.7 Keyboard Macros
start-kbd-macro (C-x ()8.4.7 Keyboard Macros
set-mark (C-@)8.4.8 Some Miscellaneous Commands
set-mark (C-@)8.4.8 Some Miscellaneous Commands
shell-expand-line (M-C-e)8.4.8 Some Miscellaneous Commands
shell-expand-line (M-C-e)8.4.8 Some Miscellaneous Commands
start-kbd-macro (C-x ()8.4.7 Keyboard Macros
start-kbd-macro (C-x ()8.4.7 Keyboard Macros

T
tilde-expand (M-&#38;)8.4.8 Some Miscellaneous Commands
tilde-expand (M-&#38;)8.4.8 Some Miscellaneous Commands
tilde-expand (M-&#38;)8.4.8 Some Miscellaneous Commands
tilde-expand (M-&#38;)8.4.8 Some Miscellaneous Commands
transpose-chars (C-t)8.4.3 Commands For Changing Text
transpose-chars (C-t)8.4.3 Commands For Changing Text
transpose-words (M-t)8.4.3 Commands For Changing Text
transpose-words (M-t)8.4.3 Commands For Changing Text

U
undo (C-_ or C-x C-u)8.4.8 Some Miscellaneous Commands
undo (C-_ or C-x C-u)8.4.8 Some Miscellaneous Commands
universal-argument ()8.4.5 Specifying Numeric Arguments
universal-argument ()8.4.5 Specifying Numeric Arguments
undo (C-_ or C-x C-u)8.4.8 Some Miscellaneous Commands
undo (C-_ or C-x C-u)8.4.8 Some Miscellaneous Commands
universal-argument ()8.4.5 Specifying Numeric Arguments
universal-argument ()8.4.5 Specifying Numeric Arguments
unix-filename-rubout ()8.4.4 Killing And Yanking
unix-filename-rubout ()8.4.4 Killing And Yanking
unix-line-discard (C-u)8.4.4 Killing And Yanking
unix-line-discard (C-u)8.4.4 Killing And Yanking
unix-word-rubout (C-w)8.4.4 Killing And Yanking
upcase-word (M-u)8.4.3 Commands For Changing Text

Y
yank (C-y)8.4.4 Killing And Yanking
yank (C-y)8.4.4 Killing And Yanking
yank (C-y)8.4.4 Killing And Yanking
yank (C-y)8.4.4 Killing And Yanking
yank-last-arg (M-. or M-_)8.4.2 Commands For Manipulating The History
yank-last-arg (M-. or M-_)8.4.2 Commands For Manipulating The History
yank-nth-arg (M-C-y)8.4.2 Commands For Manipulating The History
yank-nth-arg (M-C-y)8.4.2 Commands For Manipulating The History
yank-pop (M-y)8.4.4 Killing And Yanking
yank-pop (M-y)8.4.4 Killing And Yanking
yank-pop (M-y)8.4.4 Killing And Yanking
yank-pop (M-y)8.4.4 Killing And Yanking

- + @@ -14455,10 +14465,10 @@ to permit their use in free software. - + - + @@ -14986,7 +14996,7 @@ to permit their use in free software.
Jump to:   A   @@ -14446,7 +14456,7 @@ to permit their use in free software.
expressions, conditional6.4 Bash Conditional Expressions

F
FDL, GNU Free Documentation LicenseC.1 GNU Free Documentation License
FDL, GNU Free Documentation LicenseC.1 GNU Free Documentation License
field2. Definitions
filename2. Definitions
filename expansion3.5.8 Filename Expansion

H
history builtins9.2 Bash History Builtins
history events9.3.1 Event Designators
history events9.3.1 Event Designators
history expansion9.3 History Expansion
history list9.1 Bash History Facilities
History, how to use8.7 Programmable Completion Builtins
History, how to use8.7 Programmable Completion Builtins

I
identifier2. Definitions
[ ? ]

About this document

-This document was generated by Chet Ramey on December, 31 2003 +This document was generated by Chet Ramey on January, 28 2004 using texi2html

@@ -15148,7 +15158,7 @@ the following structure:
This document was generated -by Chet Ramey on December, 31 2003 +by Chet Ramey on January, 28 2004 using texi2html diff --git a/doc/bashref.info b/doc/bashref.info index 4a96a6105..b0b5d0130 100644 --- a/doc/bashref.info +++ b/doc/bashref.info @@ -1,10 +1,10 @@ -This is bashref.info, produced by makeinfo version 4.2 from -/usr/src/local/bash/bash-20040121/doc/bashref.texi. +This is bashref.info, produced by makeinfo version 4.5 from +/usr/homes/chet/src/bash/src/doc/bashref.texi. This text is a brief description of the features that are present in -the Bash shell (version 3.0-beta1, 24 January 2004). +the Bash shell (version 3.0-beta1, 28 January 2004). - This is Edition 3.0, last updated 24 January 2004, of `The GNU Bash + This is Edition 3.0, last updated 28 January 2004, of `The GNU Bash Reference Manual', for `Bash', Version 3.0-beta1. Copyright (C) 1988-2003 Free Software Foundation, Inc. @@ -37,9 +37,9 @@ Bash Features ************* This text is a brief description of the features that are present in -the Bash shell (version 3.0-beta1, 24 January 2004).. +the Bash shell (version 3.0-beta1, 28 January 2004).. - This is Edition 3.0, last updated 24 January 2004, of `The GNU Bash + This is Edition 3.0, last updated 28 January 2004, of `The GNU Bash Reference Manual', for `Bash', Version 3.0-beta1. Bash contains features that appear in other popular shells, and some @@ -731,6 +731,7 @@ syntax, it may be replaced with one or more newlines. command in LIST that is executed, or false if any of the expressions is invalid. + The `break' and `continue' builtins (*note Bourne Shell Builtins::) may be used to control loop execution. @@ -895,6 +896,7 @@ Conditional Constructs value of EXPRESSION1 is sufficient to determine the return value of the entire conditional expression. +  File: bashref.info, Node: Command Grouping, Prev: Conditional Constructs, Up: Compound Commands @@ -1299,6 +1301,7 @@ the expanded value. `~-N' The string that would be displayed by `dirs -N' +  File: bashref.info, Node: Shell Parameter Expansion, Next: Command Substitution, Prev: Tilde Expansion, Up: Shell Expansions @@ -1445,6 +1448,7 @@ if the colon is omitted, the operator tests only for existence. member of the array in turn, and the expansion is the resultant list. +  File: bashref.info, Node: Command Substitution, Next: Arithmetic Expansion, Prev: Shell Parameter Expansion, Up: Shell Expansions @@ -1752,6 +1756,7 @@ redirections, as described in the following table: integer port number or service name, Bash attempts to open a UDP connection to the corresponding socket. + A failure to open or create a file causes the redirection to fail. Redirecting Input @@ -2710,6 +2715,7 @@ POSIX 1003.2 standard. `-x KEYSEQ:SHELL-COMMAND' Cause SHELL-COMMAND to be executed whenever KEYSEQ is entered. + The return status is zero unless an invalid option is supplied or an error occurs. @@ -3005,6 +3011,7 @@ POSIX 1003.2 standard. `-u FD' Read input from file descriptor FD. + `shopt' shopt [-pqsu] [-o] [OPTNAME ...] Toggle the values of variables controlling optional shell behavior. @@ -3214,6 +3221,7 @@ POSIX 1003.2 standard. If set, the `echo' builtin expands backslash-escape sequences by default. + The return status when listing options is zero if all OPTNAMES are enabled, non-zero otherwise. When setting or unsetting options, the return status is zero unless an OPTNAME is not a valid shell @@ -3307,6 +3315,7 @@ POSIX 1003.2 standard. `-v' The maximum amount of virtual memory available to the process. + If LIMIT is given, it is the new value of the specified resource; the special LIMIT values `hard', `soft', and `unlimited' stand for the current hard limit, the current soft limit, and no limit, @@ -3327,6 +3336,7 @@ POSIX 1003.2 standard. Remove each NAME from the list of aliases. If `-a' is supplied, all aliases are removed. Aliases are described in *Note Aliases::. +  File: bashref.info, Node: The Set Builtin, Next: Special Builtins, Prev: Bash Builtins, Up: Shell Builtin Commands @@ -3673,6 +3683,7 @@ shell. In some cases, Bash assigns a default value to the variable. `PS2' The secondary prompt string. The default value is `> '. +  File: bashref.info, Node: Bash Variables, Prev: Bourne Shell Variables, Up: Shell Variables @@ -3765,6 +3776,7 @@ Variables::). `BASH_VERSINFO[5]' The value of `MACHTYPE'. + `BASH_VERSION' The version number of the current instance of Bash. @@ -4145,6 +4157,7 @@ Variables::). The numeric real user id of the current user. This variable is readonly. +  File: bashref.info, Node: Bash Features, Next: Job Control, Prev: Shell Variables, Up: Top @@ -4242,6 +4255,7 @@ the single-character options to be recognized. Show version information for this instance of Bash on the standard output and exit successfully. + There are several single-character options that may be supplied at invocation which are not available with the `set' builtin. @@ -4293,6 +4307,7 @@ invocation which are not available with the `set' builtin. processing. Any arguments after the `--' are treated as filenames and arguments. + A _login_ shell is one whose first character of argument zero is `-', or one invoked with the `--login' option. @@ -4684,6 +4699,7 @@ checked. If the FILE argument to one of the primaries is one of greater than or equal to ARG2, respectively. ARG1 and ARG2 may be positive or negative integers. +  File: bashref.info, Node: Shell Arithmetic, Next: Aliases, Prev: Bash Conditional Expressions, Up: Bash Features @@ -5000,6 +5016,7 @@ Directory Stack Builtins Makes the current working directory be the top of the stack, and then executes the equivalent of ``cd' DIR'. `cd's to DIR. +  File: bashref.info, Node: Printing a Prompt, Next: The Restricted Shell, Prev: The Directory Stack, Up: Bash Features @@ -5516,6 +5533,7 @@ Job Control Builtins signal. The `-f' option means to suspend even if the shell is a login shell. + When job control is not active, the `kill' and `wait' builtins do not accept JOBSPEC arguments. They must be supplied process IDs. @@ -5542,6 +5560,7 @@ Job Control Variables a prefix of a stopped job's name; this provides functionality analogous to the `%' job ID. +  File: bashref.info, Node: Command Line Editing, Next: Installing Bash, Prev: Using History Interactively, Up: Top @@ -5748,6 +5767,7 @@ available to be yanked back later, when you are typing another line. Kill from the cursor to the previous whitespace. This is different than `M-' because the word boundaries differ. + Here is how to "yank" the text back into the line. Yanking means to copy the most-recently-killed text from the kill buffer. @@ -6025,6 +6045,7 @@ Variable Settings appended to the filename when listing possible completions. The default is `off'. + Key Bindings The syntax for controlling key bindings in the init file is simple. First you need to find the name of the command that you @@ -6079,6 +6100,7 @@ Key Bindings ` <[> <1> <1> <~>' is bound to insert the text `Function Key 1'. + The following GNU Emacs style escape sequences are available when specifying key sequences: @@ -6144,6 +6166,7 @@ Key Bindings the line: "\C-x\\": "\\" +  File: bashref.info, Node: Conditional Init Constructs, Next: Sample Init File, Prev: Readline Init File Syntax, Up: Readline Init File @@ -6375,6 +6398,7 @@ Commands For Moving `redraw-current-line ()' Refresh the current line. By default, this is unbound. +  File: bashref.info, Node: Commands For History, Next: Commands For Text, Prev: Commands For Moving, Up: Bindable Readline Commands @@ -6445,6 +6469,7 @@ Commands For Manipulating The History through the history list, inserting the last argument of each line in turn. +  File: bashref.info, Node: Commands For Text, Next: Commands For Killing, Prev: Commands For History, Up: Bindable Readline Commands @@ -6509,6 +6534,7 @@ Commands For Changing Text By default, this command is unbound. +  File: bashref.info, Node: Commands For Killing, Next: Numeric Arguments, Prev: Commands For Text, Up: Bindable Readline Commands @@ -6541,6 +6567,11 @@ Killing And Yanking Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. +`unix-filename-rubout ()' + Kill the word behind point, using white space and the slash + character as the word boundaries. The killed text is saved on the + kill-ring. + `delete-horizontal-space ()' Delete all spaces and tabs around point. By default, this is unbound. @@ -6684,6 +6715,7 @@ Letting Readline Type For You completions enclosed within braces so the list is available to the shell (*note Brace Expansion::). +  File: bashref.info, Node: Keyboard Macros, Next: Miscellaneous Commands, Prev: Commands For Completion, Up: Bindable Readline Commands @@ -6701,6 +6733,7 @@ Keyboard Macros Re-execute the last keyboard macro defined, by making the characters in the macro appear as if typed at the keyboard. +  File: bashref.info, Node: Miscellaneous Commands, Prev: Keyboard Macros, Up: Bindable Readline Commands @@ -6835,6 +6868,7 @@ Some Miscellaneous Commands result as shell commands. Bash attempts to invoke `$FCEDIT', `$EDITOR', and `emacs' as the editor, in that order. +  File: bashref.info, Node: Readline vi Mode, Next: Programmable Completion, Prev: Bindable Readline Commands, Up: Command Line Editing @@ -7167,6 +7201,7 @@ completion facilities. for a NAME for which no specification exists, or an error occurs adding a completion specification. +  File: bashref.info, Node: Using History Interactively, Next: Command Line Editing, Prev: Job Control, Up: Top @@ -7325,10 +7360,12 @@ and history file. The ARGs are added to the end of the history list as a single entry. + When any of the `-w', `-r', `-a', or `-n' options is used, if FILENAME is given, then it is used as the history file. If not, then the value of the `HISTFILE' variable is used. +  File: bashref.info, Node: History Interaction, Prev: Bash History Builtins, Up: Using History Interactively @@ -7418,6 +7455,7 @@ history list. `!#' The entire command line typed so far. +  File: bashref.info, Node: Word Designators, Next: Modifiers, Prev: Event Designators, Up: History Interaction @@ -7476,6 +7514,7 @@ line separated by single spaces. `X-' Abbreviates `X-$' like `X*', but omits the last word. + If a word designator is supplied without an event specification, the previous command is used as the event. @@ -7530,6 +7569,7 @@ more of the following modifiers, each preceded by a `:'. `G' Apply the following `s' modifier once to each word in the event. +  File: bashref.info, Node: Installing Bash, Next: Reporting Bugs, Prev: Command Line Editing, Up: Top @@ -7963,6 +8003,7 @@ does not provide the necessary support. Specification, version 2. *Note Bash Builtins::, for a description of the escape sequences that `echo' recognizes. + The file `config-top.h' contains C Preprocessor `#define' statements for options which are not settable from `configure'. Some of these are not meant to be changed; beware of the consequences if you do. Read @@ -9076,6 +9117,7 @@ Function Index * transpose-words (M-t): Commands For Text. * undo (C-_ or C-x C-u): Miscellaneous Commands. * universal-argument (): Numeric Arguments. +* unix-filename-rubout (): Commands For Killing. * unix-line-discard (C-u): Commands For Killing. * unix-word-rubout (C-w): Commands For Killing. * upcase-word (M-u): Commands For Text. @@ -9214,45 +9256,45 @@ Concept Index  Tag Table: -Node: Top1376 -Node: Introduction3533 -Node: What is Bash?3758 -Node: What is a shell?4846 -Node: Definitions7382 -Node: Basic Shell Features10122 -Node: Shell Syntax11340 -Node: Shell Operation12364 -Node: Quoting13649 -Node: Escape Character14911 -Node: Single Quotes15383 -Node: Double Quotes15718 -Node: ANSI-C Quoting16731 -Node: Locale Translation17674 -Node: Comments18557 -Node: Shell Commands19162 -Node: Simple Commands19923 -Node: Pipelines20544 -Node: Lists22410 -Node: Compound Commands24032 -Node: Looping Constructs24804 -Node: Conditional Constructs27237 -Node: Command Grouping34289 -Node: Shell Functions35725 -Node: Shell Parameters39990 -Node: Positional Parameters41561 -Node: Special Parameters42452 -Node: Shell Expansions45110 -Node: Brace Expansion47030 -Node: Tilde Expansion49346 -Node: Shell Parameter Expansion51677 -Node: Command Substitution58930 -Node: Arithmetic Expansion60252 -Node: Process Substitution61093 -Node: Word Splitting62130 -Node: Filename Expansion63582 -Node: Pattern Matching65706 -Node: Quote Removal69027 -Node: Redirections69313 +Node: Top1371 +Node: Introduction3528 +Node: What is Bash?3753 +Node: What is a shell?4841 +Node: Definitions7377 +Node: Basic Shell Features10117 +Node: Shell Syntax11335 +Node: Shell Operation12359 +Node: Quoting13644 +Node: Escape Character14906 +Node: Single Quotes15378 +Node: Double Quotes15713 +Node: ANSI-C Quoting16726 +Node: Locale Translation17669 +Node: Comments18552 +Node: Shell Commands19157 +Node: Simple Commands19918 +Node: Pipelines20539 +Node: Lists22405 +Node: Compound Commands24027 +Node: Looping Constructs24799 +Node: Conditional Constructs27233 +Node: Command Grouping34286 +Node: Shell Functions35722 +Node: Shell Parameters39987 +Node: Positional Parameters41558 +Node: Special Parameters42449 +Node: Shell Expansions45107 +Node: Brace Expansion47027 +Node: Tilde Expansion49343 +Node: Shell Parameter Expansion51675 +Node: Command Substitution58929 +Node: Arithmetic Expansion60251 +Node: Process Substitution61092 +Node: Word Splitting62129 +Node: Filename Expansion63581 +Node: Pattern Matching65705 +Node: Quote Removal69026 +Node: Redirections69312 Node: Executing Commands76787 Node: Simple Command Expansion77454 Node: Command Search and Execution79375 @@ -9264,79 +9306,79 @@ Node: Shell Scripts88935 Node: Shell Builtin Commands91446 Node: Bourne Shell Builtins92876 Node: Bash Builtins109759 -Node: The Set Builtin137876 -Node: Special Builtins146094 -Node: Shell Variables147066 -Node: Bourne Shell Variables147502 -Node: Bash Variables149478 -Node: Bash Features168981 -Node: Invoking Bash169863 -Node: Bash Startup Files175672 -Node: Interactive Shells180542 -Node: What is an Interactive Shell?180944 -Node: Is this Shell Interactive?181579 -Node: Interactive Shell Behavior182385 -Node: Bash Conditional Expressions185652 -Node: Shell Arithmetic189071 -Node: Aliases191811 -Node: Arrays194314 -Node: The Directory Stack197334 -Node: Directory Stack Builtins198040 -Node: Printing a Prompt200918 -Node: The Restricted Shell203627 -Node: Bash POSIX Mode205452 -Node: Job Control212098 -Node: Job Control Basics212564 -Node: Job Control Builtins216844 -Node: Job Control Variables221139 -Node: Command Line Editing222288 -Node: Introduction and Notation223286 -Node: Readline Interaction224903 -Node: Readline Bare Essentials226089 -Node: Readline Movement Commands227869 -Node: Readline Killing Commands228825 -Node: Readline Arguments230733 -Node: Searching231768 -Node: Readline Init File233945 -Node: Readline Init File Syntax234999 -Node: Conditional Init Constructs246640 -Node: Sample Init File249164 -Node: Bindable Readline Commands252347 -Node: Commands For Moving253546 -Node: Commands For History254394 -Node: Commands For Text257282 -Node: Commands For Killing259942 -Node: Numeric Arguments261892 -Node: Commands For Completion263019 -Node: Keyboard Macros266599 -Node: Miscellaneous Commands267157 -Node: Readline vi Mode272455 -Node: Programmable Completion273364 -Node: Programmable Completion Builtins279171 -Node: Using History Interactively286532 -Node: Bash History Facilities287211 -Node: Bash History Builtins289901 -Node: History Interaction293751 -Node: Event Designators296302 -Node: Word Designators297305 -Node: Modifiers298934 -Node: Installing Bash300330 -Node: Basic Installation301464 -Node: Compilers and Options304149 -Node: Compiling For Multiple Architectures304883 -Node: Installation Names306540 -Node: Specifying the System Type307351 -Node: Sharing Defaults308060 -Node: Operation Controls308725 -Node: Optional Features309676 -Node: Reporting Bugs317947 -Node: Major Differences From The Bourne Shell319122 -Node: Copying This Manual334870 -Node: GNU Free Documentation License335124 -Node: Builtin Index357517 -Node: Reserved Word Index361144 -Node: Variable Index362620 -Node: Function Index369613 -Node: Concept Index374163 +Node: The Set Builtin137881 +Node: Special Builtins146099 +Node: Shell Variables147071 +Node: Bourne Shell Variables147507 +Node: Bash Variables149484 +Node: Bash Features168989 +Node: Invoking Bash169871 +Node: Bash Startup Files175682 +Node: Interactive Shells180552 +Node: What is an Interactive Shell?180954 +Node: Is this Shell Interactive?181589 +Node: Interactive Shell Behavior182395 +Node: Bash Conditional Expressions185662 +Node: Shell Arithmetic189082 +Node: Aliases191822 +Node: Arrays194325 +Node: The Directory Stack197345 +Node: Directory Stack Builtins198051 +Node: Printing a Prompt200930 +Node: The Restricted Shell203639 +Node: Bash POSIX Mode205464 +Node: Job Control212110 +Node: Job Control Basics212576 +Node: Job Control Builtins216856 +Node: Job Control Variables221152 +Node: Command Line Editing222302 +Node: Introduction and Notation223300 +Node: Readline Interaction224917 +Node: Readline Bare Essentials226103 +Node: Readline Movement Commands227883 +Node: Readline Killing Commands228839 +Node: Readline Arguments230748 +Node: Searching231783 +Node: Readline Init File233960 +Node: Readline Init File Syntax235014 +Node: Conditional Init Constructs246658 +Node: Sample Init File249182 +Node: Bindable Readline Commands252365 +Node: Commands For Moving253564 +Node: Commands For History254413 +Node: Commands For Text257302 +Node: Commands For Killing259963 +Node: Numeric Arguments262093 +Node: Commands For Completion263220 +Node: Keyboard Macros266801 +Node: Miscellaneous Commands267360 +Node: Readline vi Mode272659 +Node: Programmable Completion273568 +Node: Programmable Completion Builtins279375 +Node: Using History Interactively286737 +Node: Bash History Facilities287416 +Node: Bash History Builtins290106 +Node: History Interaction293958 +Node: Event Designators296509 +Node: Word Designators297513 +Node: Modifiers299143 +Node: Installing Bash300540 +Node: Basic Installation301674 +Node: Compilers and Options304359 +Node: Compiling For Multiple Architectures305093 +Node: Installation Names306750 +Node: Specifying the System Type307561 +Node: Sharing Defaults308270 +Node: Operation Controls308935 +Node: Optional Features309886 +Node: Reporting Bugs318158 +Node: Major Differences From The Bourne Shell319333 +Node: Copying This Manual335081 +Node: GNU Free Documentation License335335 +Node: Builtin Index357728 +Node: Reserved Word Index361355 +Node: Variable Index362831 +Node: Function Index369824 +Node: Concept Index374437  End Tag Table diff --git a/doc/bashref.log b/doc/bashref.log index 896f09577..812f40e7a 100644 --- a/doc/bashref.log +++ b/doc/bashref.log @@ -1,4 +1,4 @@ -This is TeX, Version 3.14159 (Web2C 7.3.1) (format=tex 2001.2.12) 31 DEC 2003 12:47 +This is TeX, Version 3.14159 (Web2C 7.3.1) (format=tex 2001.2.12) 28 JAN 2004 15:50 **/usr/homes/chet/src/bash/src/doc/bashref.texi (/usr/homes/chet/src/bash/src/doc/bashref.texi (texinfo.tex Loading texinfo [version 2003-02-03.16]: Basics, @@ -292,7 +292,7 @@ gnored[] .etc. [93] [94] [95] [96] [97] [98] [99] [100] [101] [102] [103] [104] -Overfull \hbox (17.80585pt too wide) in paragraph at lines 1641--1641 +Overfull \hbox (17.80585pt too wide) in paragraph at lines 1646--1646 []@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-A @tex tttsl ac-tion@texttt ] [-G @textttsl glob- @@ -305,7 +305,7 @@ tttsl ac-tion@texttt ] [-G @textttsl glob- .etc. [105] [106] -Underfull \hbox (badness 2753) in paragraph at lines 1737--1740 +Underfull \hbox (badness 2753) in paragraph at lines 1742--1745 @texttt hostname[]@textrm Hostnames, as taken from the file spec-i-fied by @hbox(7.60416+2.12917)x433.62, glue set 3.02202 @@ -357,10 +357,10 @@ Overfull \vbox (42.26959pt too high) has occurred while \output is active Here is how much of TeX's memory you used: 1713 strings out of 13013 23227 string characters out of 97233 - 52395 words of memory out of 263001 + 52393 words of memory out of 263001 2577 multiletter control sequences out of 10000+0 31953 words of font info for 111 fonts, out of 400000 for 1000 19 hyphenation exceptions out of 1000 15i,8n,11p,273b,465s stack positions out of 300i,100n,500p,50000b,4000s -Output written on bashref.dvi (154 pages, 578740 bytes). +Output written on bashref.dvi (154 pages, 579212 bytes). diff --git a/doc/bashref.ps b/doc/bashref.ps index 38f3b6f06..f89fe30d9 100644 --- a/doc/bashref.ps +++ b/doc/bashref.ps @@ -8,7 +8,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi %DVIPSParameters: dpi=600, compressed -%DVIPSSource: TeX output 2003.12.31:1247 +%DVIPSSource: TeX output 2004.01.28:1550 %%BeginProcSet: texc.pro %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -2539,43 +2539,43 @@ letter %%Page: 1 1 1 0 bop 150 1318 a Fu(Bash)64 b(Reference)j(Man)-5 b(ual)p 150 1385 3600 34 v 2361 1481 a Ft(Reference)31 b(Do)s(cumen)m(tation)h -(for)e(Bash)2181 1589 y(Edition)e(3.0,)k(for)e Fs(Bash)f -Ft(V)-8 b(ersion)30 b(3.0-alpha.)3139 1697 y(No)m(v)m(em)m(b)s(er)h -(2003)150 4935 y Fr(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 -b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 -y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11 +(for)e(Bash)2178 1589 y(Edition)f(3.0,)i(for)f Fs(Bash)g +Ft(V)-8 b(ersion)30 b(3.0-b)s(eta1.)3218 1697 y(Jan)m(uary)g(2004)150 +4935 y Fr(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46 +b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11 +b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11 b(oundation)p 150 5141 3600 17 v eop %%Page: 2 2 2 1 bop 150 2889 a Ft(This)34 b(text)i(is)f(a)h(brief)e(description)g (of)h(the)h(features)g(that)g(are)g(presen)m(t)g(in)e(the)i(Bash)f -(shell)f(\(v)m(ersion)150 2999 y(3.0-alpha,)d(13)g(No)m(v)m(em)m(b)s -(er)h(2003\).)150 3133 y(This)c(is)i(Edition)e(3.0,)j(last)f(up)s -(dated)f(13)i(No)m(v)m(em)m(b)s(er)h(2003,)g(of)e Fq(The)g(GNU)h(Bash)f -(Reference)h(Man)m(ual)p Ft(,)150 3243 y(for)f Fs(Bash)p -Ft(,)g(V)-8 b(ersion)30 b(3.0-alpha.)150 3377 y(Cop)m(yrigh)m(t)602 -3374 y(c)577 3377 y Fp(\015)g Ft(1988-2003)k(F)-8 b(ree)32 -b(Soft)m(w)m(are)f(F)-8 b(oundation,)31 b(Inc.)150 3512 -y(P)m(ermission)f(is)i(gran)m(ted)h(to)f(mak)m(e)i(and)d(distribute)f -(v)m(erbatim)i(copies)g(of)g(this)f(man)m(ual)h(pro)m(vided)f(the)150 -3621 y(cop)m(yrigh)m(t)g(notice)f(and)g(this)f(p)s(ermission)f(notice)i -(are)h(preserv)m(ed)f(on)h(all)e(copies.)390 3756 y(P)m(ermission)k(is) -i(gran)m(ted)g(to)h(cop)m(y)-8 b(,)38 b(distribute)33 -b(and/or)i(mo)s(dify)e(this)h(do)s(cumen)m(t)h(under)390 -3866 y(the)j(terms)g(of)g(the)g(GNU)h(F)-8 b(ree)39 b(Do)s(cumen)m -(tation)g(License,)g(V)-8 b(ersion)38 b(1.1)h(or)f(an)m(y)g(later)390 -3975 y(v)m(ersion)27 b(published)c(b)m(y)28 b(the)f(F)-8 -b(ree)29 b(Soft)m(w)m(are)f(F)-8 b(oundation;)29 b(with)d(no)h(In)m(v) --5 b(arian)m(t)27 b(Sections,)390 4085 y(with)i(the)i(F)-8 -b(ron)m(t-Co)m(v)m(er)33 b(texts)e(b)s(eing)f(\\A)h(GNU)g(Man)m(ual,")g -(and)f(with)f(the)i(Bac)m(k-Co)m(v)m(er)390 4194 y(T)-8 -b(exts)33 b(as)g(in)e(\(a\))i(b)s(elo)m(w.)46 b(A)33 -b(cop)m(y)g(of)f(the)h(license)e(is)h(included)d(in)i(the)i(section)f -(en)m(titled)390 4304 y(\\GNU)f(F)-8 b(ree)32 b(Do)s(cumen)m(tation)f -(License.")390 4438 y(\(a\))39 b(The)f(FSF's)g(Bac)m(k-Co)m(v)m(er)j(T) --8 b(ext)39 b(is:)55 b(\\Y)-8 b(ou)39 b(ha)m(v)m(e)g(freedom)f(to)h -(cop)m(y)f(and)g(mo)s(dify)390 4548 y(this)31 b(GNU)j(Man)m(ual,)f(lik) -m(e)f(GNU)h(soft)m(w)m(are.)49 b(Copies)31 b(published)e(b)m(y)j(the)h -(F)-8 b(ree)34 b(Soft)m(w)m(are)390 4658 y(F)-8 b(oundation)30 +(shell)f(\(v)m(ersion)150 2999 y(3.0-b)s(eta1,)f(28)e(Jan)m(uary)f +(2004\).)150 3133 y(This)i(is)g(Edition)f(3.0,)36 b(last)d(up)s(dated)f +(28)i(Jan)m(uary)f(2004,)j(of)d Fq(The)g(GNU)h(Bash)g(Reference)g(Man)m +(ual)p Ft(,)150 3243 y(for)c Fs(Bash)p Ft(,)g(V)-8 b(ersion)30 +b(3.0-b)s(eta1.)150 3377 y(Cop)m(yrigh)m(t)602 3374 y(c)577 +3377 y Fp(\015)g Ft(1988-2003)k(F)-8 b(ree)32 b(Soft)m(w)m(are)f(F)-8 +b(oundation,)31 b(Inc.)150 3512 y(P)m(ermission)f(is)i(gran)m(ted)h(to) +f(mak)m(e)i(and)d(distribute)f(v)m(erbatim)i(copies)g(of)g(this)f(man)m +(ual)h(pro)m(vided)f(the)150 3621 y(cop)m(yrigh)m(t)g(notice)f(and)g +(this)f(p)s(ermission)f(notice)i(are)h(preserv)m(ed)f(on)h(all)e +(copies.)390 3756 y(P)m(ermission)k(is)i(gran)m(ted)g(to)h(cop)m(y)-8 +b(,)38 b(distribute)33 b(and/or)i(mo)s(dify)e(this)h(do)s(cumen)m(t)h +(under)390 3866 y(the)j(terms)g(of)g(the)g(GNU)h(F)-8 +b(ree)39 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)38 +b(1.1)h(or)f(an)m(y)g(later)390 3975 y(v)m(ersion)27 +b(published)c(b)m(y)28 b(the)f(F)-8 b(ree)29 b(Soft)m(w)m(are)f(F)-8 +b(oundation;)29 b(with)d(no)h(In)m(v)-5 b(arian)m(t)27 +b(Sections,)390 4085 y(with)i(the)i(F)-8 b(ron)m(t-Co)m(v)m(er)33 +b(texts)e(b)s(eing)f(\\A)h(GNU)g(Man)m(ual,")g(and)f(with)f(the)i(Bac)m +(k-Co)m(v)m(er)390 4194 y(T)-8 b(exts)33 b(as)g(in)e(\(a\))i(b)s(elo)m +(w.)46 b(A)33 b(cop)m(y)g(of)f(the)h(license)e(is)h(included)d(in)i +(the)i(section)f(en)m(titled)390 4304 y(\\GNU)f(F)-8 +b(ree)32 b(Do)s(cumen)m(tation)f(License.")390 4438 y(\(a\))39 +b(The)f(FSF's)g(Bac)m(k-Co)m(v)m(er)j(T)-8 b(ext)39 b(is:)55 +b(\\Y)-8 b(ou)39 b(ha)m(v)m(e)g(freedom)f(to)h(cop)m(y)f(and)g(mo)s +(dify)390 4548 y(this)31 b(GNU)j(Man)m(ual,)f(lik)m(e)f(GNU)h(soft)m(w) +m(are.)49 b(Copies)31 b(published)e(b)m(y)j(the)h(F)-8 +b(ree)34 b(Soft)m(w)m(are)390 4658 y(F)-8 b(oundation)30 b(raise)g(funds)e(for)j(GNU)g(dev)m(elopmen)m(t.")150 4902 y(Published)c(b)m(y)j(the)h(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8 b(oundation)150 5011 y(59)31 b(T)-8 b(emple)30 b(Place,)h(Suite)e(330,) @@ -2878,7 +2878,7 @@ b(And)i(Y)-8 b(anking)17 b Fm(.)e(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)46 b Ft(98)748 2572 y(8.4.5)93 b(Sp)s(ecifying)27 b(Numeric)j(Argumen)m (ts)25 b Fm(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)54 b Ft(98)748 2682 y(8.4.6)93 b(Letting)30 +(.)g(.)g(.)54 b Ft(99)748 2682 y(8.4.6)93 b(Letting)30 b(Readline)f(T)m(yp)s(e)h(F)-8 b(or)31 b(Y)-8 b(ou)19 b Fm(.)d(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) 49 b Ft(99)748 2791 y(8.4.7)93 b(Keyb)s(oard)29 b(Macros)10 @@ -8147,15 +8147,17 @@ b(v)m(ersion)g(of)g(Bash)h(\(e.g.,)h(2.00\))150 4219 y Fs(\\V)384 b Ft(The)30 b(release)h(of)f(Bash,)h(v)m(ersion)f Fs(+)g Ft(patc)m(hlev)m(el)g(\(e.g.,)j(2.00.0\))150 4379 y Fs(\\w)384 b Ft(The)30 b(curren)m(t)g(w)m(orking)g(directory)-8 -b(.)150 4539 y Fs(\\W)384 b Ft(The)30 b(basename)h(of)f -Fs($PWD)p Ft(.)150 4699 y Fs(\\!)384 b Ft(The)30 b(history)f(n)m(um)m -(b)s(er)g(of)i(this)e(command.)150 4860 y Fs(\\#)384 -b Ft(The)30 b(command)g(n)m(um)m(b)s(er)f(of)i(this)e(command.)150 -5020 y Fs(\\$)384 b Ft(If)30 b(the)g(e\013ectiv)m(e)i(uid)d(is)g(0,)i -Fs(#)p Ft(,)g(otherwise)f Fs($)p Ft(.)150 5180 y Fs(\\)p -Fj(nnn)288 b Ft(The)30 b(c)m(haracter)i(whose)e(ASCI)s(I)f(co)s(de)h -(is)g(the)g(o)s(ctal)h(v)-5 b(alue)30 b Fq(nnn)p Ft(.)150 -5340 y Fs(\\\\)384 b Ft(A)30 b(bac)m(kslash.)p eop +b(,)30 b(with)f Fs($HOME)g Ft(abbreviated)h(with)f(a)i(tilde.)150 +4539 y Fs(\\W)384 b Ft(The)30 b(basename)h(of)f Fs($PWD)p +Ft(,)g(with)f Fs($HOME)g Ft(abbreviated)g(with)g(a)i(tilde.)150 +4699 y Fs(\\!)384 b Ft(The)30 b(history)f(n)m(um)m(b)s(er)g(of)i(this)e +(command.)150 4860 y Fs(\\#)384 b Ft(The)30 b(command)g(n)m(um)m(b)s +(er)f(of)i(this)e(command.)150 5020 y Fs(\\$)384 b Ft(If)30 +b(the)g(e\013ectiv)m(e)i(uid)d(is)g(0,)i Fs(#)p Ft(,)g(otherwise)f +Fs($)p Ft(.)150 5180 y Fs(\\)p Fj(nnn)288 b Ft(The)30 +b(c)m(haracter)i(whose)e(ASCI)s(I)f(co)s(de)h(is)g(the)g(o)s(ctal)h(v) +-5 b(alue)30 b Fq(nnn)p Ft(.)150 5340 y Fs(\\\\)384 b +Ft(A)30 b(bac)m(kslash.)p eop %%Page: 76 82 76 81 bop 150 -116 a Ft(76)2572 b(Bash)31 b(Reference)g(Man)m(ual)150 299 y Fs(\\[)384 b Ft(Begin)37 b(a)g(sequence)g(of)g(non-prin)m(ting)e @@ -9617,693 +9619,698 @@ Fs(self-insert)c Ft(replace)j(the)h(text)g(at)g(p)s(oin)m(t)630 408 y(rather)41 b(than)h(pushing)d(the)j(text)g(to)g(the)g(righ)m(t.)74 b(Characters)42 b(b)s(ound)d(to)j Fs(backward-)630 518 y(delete-char)27 b Ft(replace)k(the)f(c)m(haracter)i(b)s(efore)e(p)s -(oin)m(t)g(with)f(a)h(space.)630 647 y(By)h(default,)e(this)h(command)g -(is)f(un)m(b)s(ound.)150 854 y Fk(8.4.4)63 b(Killing)42 -b(And)e(Y)-10 b(anking)150 1093 y Fs(kill-line)28 b(\(C-k\))630 -1202 y Ft(Kill)g(the)i(text)i(from)e(p)s(oin)m(t)f(to)i(the)g(end)e(of) -i(the)f(line.)150 1350 y Fs(backward-kill-line)25 b(\(C-x)30 -b(Rubout\))630 1460 y Ft(Kill)e(bac)m(kw)m(ard)j(to)g(the)f(b)s -(eginning)e(of)i(the)h(line.)150 1608 y Fs(unix-line-discard)26 -b(\(C-u\))630 1718 y Ft(Kill)i(bac)m(kw)m(ard)j(from)e(the)i(cursor)f +(oin)m(t)g(with)f(a)h(space.)630 656 y(By)h(default,)e(this)h(command)g +(is)f(un)m(b)s(ound.)150 896 y Fk(8.4.4)63 b(Killing)42 +b(And)e(Y)-10 b(anking)150 1144 y Fs(kill-line)28 b(\(C-k\))630 +1253 y Ft(Kill)g(the)i(text)i(from)e(p)s(oin)m(t)f(to)i(the)g(end)e(of) +i(the)f(line.)150 1420 y Fs(backward-kill-line)25 b(\(C-x)30 +b(Rubout\))630 1530 y Ft(Kill)e(bac)m(kw)m(ard)j(to)g(the)f(b)s +(eginning)e(of)i(the)h(line.)150 1697 y Fs(unix-line-discard)26 +b(\(C-u\))630 1807 y Ft(Kill)i(bac)m(kw)m(ard)j(from)e(the)i(cursor)f (to)h(the)f(b)s(eginning)e(of)j(the)f(curren)m(t)g(line.)150 -1866 y Fs(kill-whole-line)c(\(\))630 1975 y Ft(Kill)34 +1974 y Fs(kill-whole-line)c(\(\))630 2083 y Ft(Kill)34 b(all)h(c)m(haracters)j(on)f(the)f(curren)m(t)h(line,)f(no)h(matter)g (where)f(p)s(oin)m(t)g(is.)58 b(By)36 b(default,)630 -2085 y(this)29 b(is)h(un)m(b)s(ound.)150 2233 y Fs(kill-word)e(\(M-d\)) -630 2343 y Ft(Kill)f(from)i(p)s(oin)m(t)f(to)i(the)g(end)e(of)i(the)f +2193 y(this)29 b(is)h(un)m(b)s(ound.)150 2360 y Fs(kill-word)e(\(M-d\)) +630 2469 y Ft(Kill)f(from)i(p)s(oin)m(t)f(to)i(the)g(end)e(of)i(the)f (curren)m(t)h(w)m(ord,)f(or)g(if)g(b)s(et)m(w)m(een)h(w)m(ords,)f(to)h -(the)g(end)630 2452 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 +(the)g(end)630 2579 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 b(ord)31 b(b)s(oundaries)d(are)i(the)h(same)g(as)f Fs(forward-word)p -Ft(.)150 2600 y Fs(backward-kill-word)25 b(\(M-)1183 -2597 y Fg(h)p 1207 2544 146 4 v 1207 2600 a Ff(DEL)p -1207 2616 V 1348 2597 a Fg(i)1378 2600 y Fs(\))630 2710 +Ft(.)150 2746 y Fs(backward-kill-word)25 b(\(M-)1183 +2743 y Fg(h)p 1207 2690 146 4 v 1207 2746 a Ff(DEL)p +1207 2761 V 1348 2743 a Fg(i)1378 2746 y Fs(\))630 2856 y Ft(Kill)h(the)j(w)m(ord)g(b)s(ehind)d(p)s(oin)m(t.)39 b(W)-8 b(ord)29 b(b)s(oundaries)e(are)i(the)g(same)g(as)g -Fs(backward-word)p Ft(.)150 2858 y Fs(unix-word-rubout)d(\(C-w\))630 -2968 y Ft(Kill)j(the)j(w)m(ord)f(b)s(ehind)e(p)s(oin)m(t,)i(using)f +Fs(backward-word)p Ft(.)150 3023 y Fs(unix-word-rubout)d(\(C-w\))630 +3132 y Ft(Kill)j(the)j(w)m(ord)f(b)s(ehind)e(p)s(oin)m(t,)i(using)f (white)h(space)h(as)g(a)g(w)m(ord)f(b)s(oundary)-8 b(.)43 -b(The)31 b(killed)630 3077 y(text)g(is)f(sa)m(v)m(ed)h(on)g(the)f -(kill-ring.)150 3225 y Fs(delete-horizontal-space)24 -b(\(\))630 3335 y Ft(Delete)32 b(all)d(spaces)i(and)e(tabs)i(around)e -(p)s(oin)m(t.)40 b(By)31 b(default,)e(this)h(is)f(un)m(b)s(ound.)150 -3483 y Fs(kill-region)e(\(\))630 3593 y Ft(Kill)h(the)i(text)i(in)d -(the)h(curren)m(t)h(region.)40 b(By)31 b(default,)e(this)h(command)g -(is)f(un)m(b)s(ound.)150 3741 y Fs(copy-region-as-kill)c(\(\))630 -3851 y Ft(Cop)m(y)34 b(the)g(text)h(in)e(the)h(region)f(to)i(the)f +b(The)31 b(killed)630 3242 y(text)g(is)f(sa)m(v)m(ed)h(on)g(the)f +(kill-ring.)150 3409 y Fs(unix-filename-rubout)25 b(\(\))630 +3518 y Ft(Kill)34 b(the)i(w)m(ord)g(b)s(ehind)e(p)s(oin)m(t,)j(using)e +(white)g(space)i(and)f(the)g(slash)f(c)m(haracter)j(as)f(the)630 +3628 y(w)m(ord)30 b(b)s(oundaries.)38 b(The)30 b(killed)e(text)j(is)f +(sa)m(v)m(ed)h(on)g(the)f(kill-ring.)150 3795 y Fs +(delete-horizontal-space)24 b(\(\))630 3905 y Ft(Delete)32 +b(all)d(spaces)i(and)e(tabs)i(around)e(p)s(oin)m(t.)40 +b(By)31 b(default,)e(this)h(is)f(un)m(b)s(ound.)150 4072 +y Fs(kill-region)e(\(\))630 4181 y Ft(Kill)h(the)i(text)i(in)d(the)h +(curren)m(t)h(region.)40 b(By)31 b(default,)e(this)h(command)g(is)f(un) +m(b)s(ound.)150 4348 y Fs(copy-region-as-kill)c(\(\))630 +4458 y Ft(Cop)m(y)34 b(the)g(text)h(in)e(the)h(region)f(to)i(the)f (kill)e(bu\013er,)i(so)g(it)g(can)g(b)s(e)f(y)m(ank)m(ed)i(righ)m(t)e -(a)m(w)m(a)m(y)-8 b(.)630 3960 y(By)31 b(default,)e(this)h(command)g -(is)f(un)m(b)s(ound.)150 4108 y Fs(copy-backward-word)c(\(\))630 -4218 y Ft(Cop)m(y)38 b(the)h(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)f(to)j +(a)m(w)m(a)m(y)-8 b(.)630 4568 y(By)31 b(default,)e(this)h(command)g +(is)f(un)m(b)s(ound.)150 4735 y Fs(copy-backward-word)c(\(\))630 +4844 y Ft(Cop)m(y)38 b(the)h(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)f(to)j (the)e(kill)e(bu\013er.)64 b(The)38 b(w)m(ord)g(b)s(oundaries)e(are)j -(the)630 4327 y(same)31 b(as)f Fs(backward-word)p Ft(.)38 +(the)630 4954 y(same)31 b(as)f Fs(backward-word)p Ft(.)38 b(By)30 b(default,)g(this)f(command)h(is)g(un)m(b)s(ound.)150 -4476 y Fs(copy-forward-word)c(\(\))630 4585 y Ft(Cop)m(y)31 +5121 y Fs(copy-forward-word)c(\(\))630 5230 y Ft(Cop)m(y)31 b(the)g(w)m(ord)g(follo)m(wing)e(p)s(oin)m(t)h(to)i(the)f(kill)e (bu\013er.)42 b(The)30 b(w)m(ord)h(b)s(oundaries)d(are)k(the)630 -4695 y(same)f(as)f Fs(forward-word)p Ft(.)38 b(By)30 -b(default,)g(this)g(command)g(is)f(un)m(b)s(ound.)150 -4843 y Fs(yank)g(\(C-y\))630 4952 y Ft(Y)-8 b(ank)31 -b(the)f(top)h(of)g(the)f(kill)e(ring)h(in)m(to)i(the)f(bu\013er)g(at)h -(p)s(oin)m(t.)150 5101 y Fs(yank-pop)d(\(M-y\))630 5210 -y Ft(Rotate)36 b(the)f(kill-ring,)e(and)h(y)m(ank)h(the)f(new)g(top.)54 -b(Y)-8 b(ou)35 b(can)g(only)e(do)i(this)e(if)h(the)h(prior)630 -5320 y(command)30 b(is)g Fs(yank)f Ft(or)h Fs(yank-pop)p -Ft(.)p eop +5340 y(same)f(as)f Fs(forward-word)p Ft(.)38 b(By)30 +b(default,)g(this)g(command)g(is)f(un)m(b)s(ound.)p eop %%Page: 99 105 99 104 bop 150 -116 a Ft(Chapter)30 b(8:)41 b(Command)29 -b(Line)h(Editing)2105 b(99)150 299 y Fk(8.4.5)63 b(Sp)s(ecifying)41 -b(Numeric)f(Argumen)m(ts)150 548 y Fs(digit-argument)26 -b(\()p Fj(M-0)p Fs(,)j Fj(M-1)p Fs(,)h(...)f Fj(M--)p -Fs(\))630 658 y Ft(Add)d(this)g(digit)f(to)j(the)f(argumen)m(t)g -(already)g(accum)m(ulating,)g(or)g(start)h(a)f(new)f(argumen)m(t.)630 -767 y Fj(M--)j Ft(starts)i(a)g(negativ)m(e)h(argumen)m(t.)150 -937 y Fs(universal-argument)25 b(\(\))630 1047 y Ft(This)f(is)g -(another)i(w)m(a)m(y)g(to)h(sp)s(ecify)d(an)h(argumen)m(t.)40 -b(If)25 b(this)f(command)i(is)e(follo)m(w)m(ed)h(b)m(y)h(one)630 -1156 y(or)k(more)f(digits,)g(optionally)f(with)g(a)i(leading)f(min)m -(us)f(sign,)h(those)h(digits)e(de\014ne)h(the)h(ar-)630 -1266 y(gumen)m(t.)41 b(If)28 b(the)i(command)f(is)f(follo)m(w)m(ed)g(b) +b(Line)h(Editing)2105 b(99)150 299 y Fs(yank)29 b(\(C-y\))630 +408 y Ft(Y)-8 b(ank)31 b(the)f(top)h(of)g(the)f(kill)e(ring)h(in)m(to)i +(the)f(bu\013er)g(at)h(p)s(oin)m(t.)150 558 y Fs(yank-pop)d(\(M-y\))630 +667 y Ft(Rotate)36 b(the)f(kill-ring,)e(and)h(y)m(ank)h(the)f(new)g +(top.)54 b(Y)-8 b(ou)35 b(can)g(only)e(do)i(this)e(if)h(the)h(prior)630 +777 y(command)30 b(is)g Fs(yank)f Ft(or)h Fs(yank-pop)p +Ft(.)150 986 y Fk(8.4.5)63 b(Sp)s(ecifying)41 b(Numeric)f(Argumen)m(ts) +150 1225 y Fs(digit-argument)26 b(\()p Fj(M-0)p Fs(,)j +Fj(M-1)p Fs(,)h(...)f Fj(M--)p Fs(\))630 1335 y Ft(Add)d(this)g(digit)f +(to)j(the)f(argumen)m(t)g(already)g(accum)m(ulating,)g(or)g(start)h(a)f +(new)f(argumen)m(t.)630 1445 y Fj(M--)j Ft(starts)i(a)g(negativ)m(e)h +(argumen)m(t.)150 1594 y Fs(universal-argument)25 b(\(\))630 +1704 y Ft(This)f(is)g(another)i(w)m(a)m(y)g(to)h(sp)s(ecify)d(an)h +(argumen)m(t.)40 b(If)25 b(this)f(command)i(is)e(follo)m(w)m(ed)h(b)m +(y)h(one)630 1813 y(or)k(more)f(digits,)g(optionally)f(with)g(a)i +(leading)f(min)m(us)f(sign,)h(those)h(digits)e(de\014ne)h(the)h(ar-)630 +1923 y(gumen)m(t.)41 b(If)28 b(the)i(command)f(is)f(follo)m(w)m(ed)g(b) m(y)h(digits,)g(executing)g Fs(universal-argument)630 -1376 y Ft(again)j(ends)f(the)h(n)m(umeric)e(argumen)m(t,)j(but)e(is)g +2032 y Ft(again)j(ends)f(the)h(n)m(umeric)e(argumen)m(t,)j(but)e(is)g (otherwise)g(ignored.)44 b(As)32 b(a)g(sp)s(ecial)f(case,)630 -1485 y(if)h(this)g(command)g(is)g(immediately)f(follo)m(w)m(ed)i(b)m(y) +2142 y(if)h(this)g(command)g(is)g(immediately)f(follo)m(w)m(ed)i(b)m(y) f(a)h(c)m(haracter)i(that)e(is)f(neither)g(a)h(digit)630 -1595 y(or)28 b(min)m(us)e(sign,)i(the)g(argumen)m(t)g(coun)m(t)h(for)e +2252 y(or)28 b(min)m(us)e(sign,)i(the)g(argumen)m(t)g(coun)m(t)h(for)e (the)i(next)f(command)f(is)g(m)m(ultiplied)e(b)m(y)i(four.)630 -1704 y(The)37 b(argumen)m(t)h(coun)m(t)f(is)g(initially)d(one,)39 +2361 y(The)37 b(argumen)m(t)h(coun)m(t)f(is)g(initially)d(one,)39 b(so)f(executing)f(this)f(function)g(the)i(\014rst)e(time)630 -1814 y(mak)m(es)d(the)e(argumen)m(t)i(coun)m(t)f(four,)f(a)i(second)e +2471 y(mak)m(es)d(the)e(argumen)m(t)i(coun)m(t)f(four,)f(a)i(second)e (time)h(mak)m(es)g(the)g(argumen)m(t)g(coun)m(t)h(six-)630 -1924 y(teen,)e(and)f(so)h(on.)40 b(By)31 b(default,)f(this)f(is)g(not)i -(b)s(ound)d(to)j(a)g(k)m(ey)-8 b(.)150 2169 y Fk(8.4.6)63 +2580 y(teen,)e(and)f(so)h(on.)40 b(By)31 b(default,)f(this)f(is)g(not)i +(b)s(ound)d(to)j(a)g(k)m(ey)-8 b(.)150 2790 y Fk(8.4.6)63 b(Letting)40 b(Readline)h(T)m(yp)s(e)g(F)-10 b(or)42 -b(Y)-10 b(ou)150 2418 y Fs(complete)28 b(\()610 2415 -y Fg(h)p 634 2362 148 4 v 634 2418 a Ff(T)-6 b(AB)p 634 -2434 V 778 2415 a Fg(i)808 2418 y Fs(\))630 2528 y Ft(A)m(ttempt)24 +b(Y)-10 b(ou)150 3029 y Fs(complete)28 b(\()610 3026 +y Fg(h)p 634 2973 148 4 v 634 3029 a Ff(T)-6 b(AB)p 634 +3044 V 778 3026 a Fg(i)808 3029 y Fs(\))630 3138 y Ft(A)m(ttempt)24 b(to)f(p)s(erform)e(completion)h(on)h(the)g(text)g(b)s(efore)f(p)s(oin) -m(t.)38 b(The)22 b(actual)h(completion)630 2637 y(p)s(erformed)33 +m(t.)38 b(The)22 b(actual)h(completion)630 3248 y(p)s(erformed)33 b(is)g(application-sp)s(eci\014c.)49 b(Bash)35 b(attempts)g(completion) -e(treating)i(the)f(text)630 2747 y(as)39 b(a)h(v)-5 b(ariable)37 +e(treating)i(the)f(text)630 3357 y(as)39 b(a)h(v)-5 b(ariable)37 b(\(if)i(the)g(text)h(b)s(egins)d(with)h(`)p Fs($)p Ft('\),)k(username) -c(\(if)h(the)g(text)h(b)s(egins)d(with)630 2857 y(`)p +c(\(if)h(the)g(text)h(b)s(egins)d(with)630 3467 y(`)p Fs(~)p Ft('\),)31 b(hostname)f(\(if)f(the)h(text)h(b)s(egins)d(with)h (`)p Fs(@)p Ft('\),)i(or)f(command)f(\(including)e(aliases)j(and)630 -2966 y(functions\))k(in)f(turn.)53 b(If)34 b(none)g(of)h(these)h(pro)s +3577 y(functions\))k(in)f(turn.)53 b(If)34 b(none)g(of)h(these)h(pro)s (duces)d(a)i(matc)m(h,)i(\014lename)d(completion)g(is)630 -3076 y(attempted.)150 3246 y Fs(possible-completions)25 -b(\(M-?\))630 3355 y Ft(List)30 b(the)g(p)s(ossible)e(completions)i(of) -g(the)h(text)g(b)s(efore)f(p)s(oin)m(t.)150 3525 y Fs -(insert-completions)25 b(\(M-*\))630 3635 y Ft(Insert)30 +3686 y(attempted.)150 3836 y Fs(possible-completions)25 +b(\(M-?\))630 3945 y Ft(List)30 b(the)g(p)s(ossible)e(completions)i(of) +g(the)h(text)g(b)s(efore)f(p)s(oin)m(t.)150 4095 y Fs +(insert-completions)25 b(\(M-*\))630 4204 y Ft(Insert)30 b(all)f(completions)h(of)h(the)g(text)g(b)s(efore)f(p)s(oin)m(t)g(that) -h(w)m(ould)e(ha)m(v)m(e)j(b)s(een)e(generated)630 3744 -y(b)m(y)g Fs(possible-completions)p Ft(.)150 3914 y Fs(menu-complete)d -(\(\))630 4024 y Ft(Similar)21 b(to)j Fs(complete)p Ft(,)f(but)h +h(w)m(ould)e(ha)m(v)m(e)j(b)s(een)e(generated)630 4314 +y(b)m(y)g Fs(possible-completions)p Ft(.)150 4463 y Fs(menu-complete)d +(\(\))630 4573 y Ft(Similar)21 b(to)j Fs(complete)p Ft(,)f(but)h (replaces)f(the)h(w)m(ord)g(to)g(b)s(e)f(completed)h(with)e(a)j(single) -d(matc)m(h)630 4133 y(from)37 b(the)h(list)f(of)h(p)s(ossible)d +d(matc)m(h)630 4682 y(from)37 b(the)h(list)f(of)h(p)s(ossible)d (completions.)62 b(Rep)s(eated)39 b(execution)f(of)g -Fs(menu-complete)630 4243 y Ft(steps)i(through)g(the)g(list)f(of)h(p)s +Fs(menu-complete)630 4792 y Ft(steps)i(through)g(the)g(list)f(of)h(p)s (ossible)e(completions,)k(inserting)c(eac)m(h)k(matc)m(h)f(in)e(turn.) -630 4353 y(A)m(t)f(the)f(end)f(of)h(the)g(list)e(of)i(completions,)g +630 4902 y(A)m(t)f(the)f(end)f(of)h(the)g(list)e(of)i(completions,)g (the)g(b)s(ell)e(is)h(rung)g(\(sub)5 b(ject)36 b(to)i(the)f(setting)630 -4462 y(of)f Fs(bell-style)p Ft(\))e(and)h(the)h(original)f(text)i(is)e +5011 y(of)f Fs(bell-style)p Ft(\))e(and)h(the)h(original)f(text)i(is)e (restored.)57 b(An)36 b(argumen)m(t)h(of)f Fq(n)f Ft(mo)m(v)m(es)i -Fq(n)630 4572 y Ft(p)s(ositions)c(forw)m(ard)h(in)f(the)i(list)f(of)g +Fq(n)630 5121 y Ft(p)s(ositions)c(forw)m(ard)h(in)f(the)i(list)f(of)g (matc)m(hes;)39 b(a)c(negativ)m(e)h(argumen)m(t)f(ma)m(y)g(b)s(e)f -(used)g(to)630 4681 y(mo)m(v)m(e)40 b(bac)m(kw)m(ard)e(through)g(the)g +(used)g(to)630 5230 y(mo)m(v)m(e)40 b(bac)m(kw)m(ard)e(through)g(the)g (list.)63 b(This)37 b(command)h(is)f(in)m(tended)g(to)i(b)s(e)f(b)s -(ound)e(to)630 4788 y Fg(h)p 654 4735 V 654 4791 a Ff(T)-6 -b(AB)p 654 4806 V 798 4788 a Fg(i)828 4791 y Ft(,)30 -b(but)g(is)f(un)m(b)s(ound)f(b)m(y)i(default.)150 4961 -y Fs(delete-char-or-list)25 b(\(\))630 5070 y Ft(Deletes)j(the)f(c)m -(haracter)h(under)e(the)h(cursor)f(if)g(not)h(at)g(the)g(b)s(eginning)e -(or)h(end)h(of)g(the)g(line)630 5180 y(\(lik)m(e)i Fs(delete-char)p -Ft(\).)37 b(If)29 b(at)h(the)f(end)f(of)i(the)f(line,)f(b)s(eha)m(v)m -(es)i(iden)m(tically)d(to)i Fs(possible-)630 5290 y(completions)p -Ft(.)38 b(This)28 b(command)i(is)g(un)m(b)s(ound)e(b)m(y)i(default.)p -eop +(ound)e(to)630 5337 y Fg(h)p 654 5284 V 654 5340 a Ff(T)-6 +b(AB)p 654 5355 V 798 5337 a Fg(i)828 5340 y Ft(,)30 +b(but)g(is)f(un)m(b)s(ound)f(b)m(y)i(default.)p eop %%Page: 100 106 100 105 bop 150 -116 a Ft(100)2527 b(Bash)31 b(Reference)g(Man)m(ual) -150 299 y Fs(complete-filename)26 b(\(M-/\))630 408 y -Ft(A)m(ttempt)32 b(\014lename)d(completion)h(on)g(the)h(text)g(b)s -(efore)f(p)s(oin)m(t.)150 577 y Fs(possible-filename-comple)o(tion)o(s) -24 b(\(C-x)30 b(/\))630 687 y Ft(List)e(the)h(p)s(ossible)d -(completions)h(of)i(the)g(text)g(b)s(efore)g(p)s(oin)m(t,)f(treating)h -(it)f(as)h(a)f(\014lename.)150 856 y Fs(complete-username)e(\(M-~\))630 -966 y Ft(A)m(ttempt)32 b(completion)d(on)i(the)f(text)i(b)s(efore)e(p)s -(oin)m(t,)f(treating)i(it)f(as)g(a)h(username.)150 1135 +150 299 y Fs(delete-char-or-list)25 b(\(\))630 408 y +Ft(Deletes)j(the)f(c)m(haracter)h(under)e(the)h(cursor)f(if)g(not)h(at) +g(the)g(b)s(eginning)e(or)h(end)h(of)g(the)g(line)630 +518 y(\(lik)m(e)i Fs(delete-char)p Ft(\).)37 b(If)29 +b(at)h(the)f(end)f(of)i(the)f(line,)f(b)s(eha)m(v)m(es)i(iden)m +(tically)d(to)i Fs(possible-)630 628 y(completions)p +Ft(.)38 b(This)28 b(command)i(is)g(un)m(b)s(ound)e(b)m(y)i(default.)150 +789 y Fs(complete-filename)c(\(M-/\))630 899 y Ft(A)m(ttempt)32 +b(\014lename)d(completion)h(on)g(the)h(text)g(b)s(efore)f(p)s(oin)m(t.) +150 1060 y Fs(possible-filename-comple)o(tion)o(s)24 +b(\(C-x)30 b(/\))630 1170 y Ft(List)e(the)h(p)s(ossible)d(completions)h +(of)i(the)g(text)g(b)s(efore)g(p)s(oin)m(t,)f(treating)h(it)f(as)h(a)f +(\014lename.)150 1331 y Fs(complete-username)e(\(M-~\))630 +1441 y Ft(A)m(ttempt)32 b(completion)d(on)i(the)f(text)i(b)s(efore)e(p) +s(oin)m(t,)f(treating)i(it)f(as)g(a)h(username.)150 1602 y Fs(possible-username-comple)o(tion)o(s)24 b(\(C-x)30 -b(~\))630 1244 y Ft(List)24 b(the)h(p)s(ossible)e(completions)h(of)h +b(~\))630 1712 y Ft(List)24 b(the)h(p)s(ossible)e(completions)h(of)h (the)g(text)h(b)s(efore)f(p)s(oin)m(t,)g(treating)g(it)g(as)g(a)g -(username.)150 1413 y Fs(complete-variable)h(\(M-$\))630 -1523 y Ft(A)m(ttempt)32 b(completion)d(on)i(the)f(text)i(b)s(efore)e(p) +(username.)150 1873 y Fs(complete-variable)h(\(M-$\))630 +1983 y Ft(A)m(ttempt)32 b(completion)d(on)i(the)f(text)i(b)s(efore)e(p) s(oin)m(t,)f(treating)i(it)f(as)g(a)h(shell)e(v)-5 b(ariable.)150 -1692 y Fs(possible-variable-comple)o(tion)o(s)24 b(\(C-x)30 -b($\))630 1802 y Ft(List)41 b(the)h(p)s(ossible)e(completions)h(of)h +2144 y Fs(possible-variable-comple)o(tion)o(s)24 b(\(C-x)30 +b($\))630 2254 y Ft(List)41 b(the)h(p)s(ossible)e(completions)h(of)h (the)g(text)h(b)s(efore)e(p)s(oin)m(t,)k(treating)d(it)f(as)h(a)h -(shell)630 1911 y(v)-5 b(ariable.)150 2080 y Fs(complete-hostname)26 -b(\(M-@\))630 2190 y Ft(A)m(ttempt)32 b(completion)d(on)i(the)f(text)i +(shell)630 2364 y(v)-5 b(ariable.)150 2525 y Fs(complete-hostname)26 +b(\(M-@\))630 2635 y Ft(A)m(ttempt)32 b(completion)d(on)i(the)f(text)i (b)s(efore)e(p)s(oin)m(t,)f(treating)i(it)f(as)g(a)h(hostname.)150 -2359 y Fs(possible-hostname-comple)o(tion)o(s)24 b(\(C-x)30 -b(@\))630 2468 y Ft(List)24 b(the)h(p)s(ossible)d(completions)h(of)i +2796 y Fs(possible-hostname-comple)o(tion)o(s)24 b(\(C-x)30 +b(@\))630 2906 y Ft(List)24 b(the)h(p)s(ossible)d(completions)h(of)i (the)g(text)g(b)s(efore)g(p)s(oin)m(t,)g(treating)g(it)f(as)g(a)h -(hostname.)150 2637 y Fs(complete-command)h(\(M-!\))630 -2747 y Ft(A)m(ttempt)32 b(completion)e(on)h(the)g(text)h(b)s(efore)e(p) +(hostname.)150 3067 y Fs(complete-command)h(\(M-!\))630 +3177 y Ft(A)m(ttempt)32 b(completion)e(on)h(the)g(text)h(b)s(efore)e(p) s(oin)m(t,)g(treating)h(it)g(as)g(a)g(command)g(name.)630 -2857 y(Command)46 b(completion)g(attempts)i(to)f(matc)m(h)h(the)f(text) -h(against)f(aliases,)k(reserv)m(ed)630 2966 y(w)m(ords,)36 +3286 y(Command)46 b(completion)g(attempts)i(to)f(matc)m(h)h(the)f(text) +h(against)f(aliases,)k(reserv)m(ed)630 3396 y(w)m(ords,)36 b(shell)e(functions,)i(shell)d(builtins,)h(and)h(\014nally)e -(executable)j(\014lenames,)g(in)e(that)630 3076 y(order.)150 -3245 y Fs(possible-command-complet)o(ions)24 b(\(C-x)29 -b(!\))630 3354 y Ft(List)c(the)i(p)s(ossible)d(completions)h(of)h(the)h +(executable)j(\014lenames,)g(in)e(that)630 3505 y(order.)150 +3667 y Fs(possible-command-complet)o(ions)24 b(\(C-x)29 +b(!\))630 3777 y Ft(List)c(the)i(p)s(ossible)d(completions)h(of)h(the)h (text)g(b)s(efore)f(p)s(oin)m(t,)g(treating)g(it)g(as)h(a)f(command)630 -3464 y(name.)150 3633 y Fs(dynamic-complete-history)e(\(M-)1470 -3630 y Fg(h)p 1493 3577 148 4 v 1493 3633 a Ff(T)-6 b(AB)p -1493 3648 V 1637 3630 a Fg(i)1667 3633 y Fs(\))630 3743 +3886 y(name.)150 4048 y Fs(dynamic-complete-history)e(\(M-)1470 +4045 y Fg(h)p 1493 3992 148 4 v 1493 4048 a Ff(T)-6 b(AB)p +1493 4063 V 1637 4045 a Fg(i)1667 4048 y Fs(\))630 4157 y Ft(A)m(ttempt)31 b(completion)f(on)g(the)g(text)h(b)s(efore)f(p)s (oin)m(t,)f(comparing)h(the)g(text)h(against)g(lines)630 -3852 y(from)f(the)g(history)g(list)f(for)h(p)s(ossible)e(completion)i -(matc)m(hes.)150 4021 y Fs(complete-into-braces)25 b(\(M-{\))630 -4131 y Ft(P)m(erform)f(\014lename)e(completion)h(and)h(insert)e(the)i +4267 y(from)f(the)g(history)g(list)f(for)h(p)s(ossible)e(completion)i +(matc)m(hes.)150 4428 y Fs(complete-into-braces)25 b(\(M-{\))630 +4538 y Ft(P)m(erform)f(\014lename)e(completion)h(and)h(insert)e(the)i (list)e(of)i(p)s(ossible)d(completions)i(enclosed)630 -4240 y(within)32 b(braces)j(so)f(the)h(list)e(is)h(a)m(v)-5 +4647 y(within)32 b(braces)j(so)f(the)h(list)e(is)h(a)m(v)-5 b(ailable)34 b(to)h(the)g(shell)e(\(see)i(Section)g(3.5.1)h([Brace)g -(Ex-)630 4350 y(pansion],)29 b(page)i(17\).)150 4593 -y Fk(8.4.7)63 b(Keyb)s(oard)41 b(Macros)150 4842 y Fs(start-kbd-macro) -26 b(\(C-x)j(\(\))630 4952 y Ft(Begin)h(sa)m(ving)h(the)f(c)m +(Ex-)630 4757 y(pansion],)29 b(page)i(17\).)150 4985 +y Fk(8.4.7)63 b(Keyb)s(oard)41 b(Macros)150 5230 y Fs(start-kbd-macro) +26 b(\(C-x)j(\(\))630 5340 y Ft(Begin)h(sa)m(ving)h(the)f(c)m (haracters)i(t)m(yp)s(ed)e(in)m(to)g(the)h(curren)m(t)f(k)m(eyb)s(oard) -g(macro.)150 5121 y Fs(end-kbd-macro)d(\(C-x)i(\)\))630 -5230 y Ft(Stop)e(sa)m(ving)g(the)h(c)m(haracters)g(t)m(yp)s(ed)f(in)m -(to)h(the)f(curren)m(t)g(k)m(eyb)s(oard)g(macro)h(and)f(sa)m(v)m(e)i -(the)630 5340 y(de\014nition.)p eop +g(macro.)p eop %%Page: 101 107 101 106 bop 150 -116 a Ft(Chapter)30 b(8:)41 b(Command)29 -b(Line)h(Editing)2060 b(101)150 299 y Fs(call-last-kbd-macro)25 -b(\(C-x)k(e\))630 408 y Ft(Re-execute)37 b(the)e(last)g(k)m(eyb)s(oard) -g(macro)h(de\014ned,)f(b)m(y)h(making)e(the)h(c)m(haracters)i(in)d(the) -630 518 y(macro)d(app)s(ear)f(as)g(if)g(t)m(yp)s(ed)g(at)h(the)f(k)m -(eyb)s(oard.)150 739 y Fk(8.4.8)63 b(Some)40 b(Miscellaneous)j -(Commands)150 982 y Fs(re-read-init-file)26 b(\(C-x)j(C-r\))630 -1091 y Ft(Read)22 b(in)f(the)h(con)m(ten)m(ts)h(of)f(the)g +b(Line)h(Editing)2060 b(101)150 299 y Fs(end-kbd-macro)27 +b(\(C-x)i(\)\))630 408 y Ft(Stop)e(sa)m(ving)g(the)h(c)m(haracters)g(t) +m(yp)s(ed)f(in)m(to)h(the)f(curren)m(t)g(k)m(eyb)s(oard)g(macro)h(and)f +(sa)m(v)m(e)i(the)630 518 y(de\014nition.)150 691 y Fs +(call-last-kbd-macro)c(\(C-x)k(e\))630 801 y Ft(Re-execute)37 +b(the)e(last)g(k)m(eyb)s(oard)g(macro)h(de\014ned,)f(b)m(y)h(making)e +(the)h(c)m(haracters)i(in)d(the)630 911 y(macro)d(app)s(ear)f(as)g(if)g +(t)m(yp)s(ed)g(at)h(the)f(k)m(eyb)s(oard.)150 1163 y +Fk(8.4.8)63 b(Some)40 b(Miscellaneous)j(Commands)150 +1414 y Fs(re-read-init-file)26 b(\(C-x)j(C-r\))630 1524 +y Ft(Read)22 b(in)f(the)h(con)m(ten)m(ts)h(of)f(the)g Fq(inputrc)k Ft(\014le,)d(and)e(incorp)s(orate)g(an)m(y)i(bindings)18 -b(or)k(v)-5 b(ariable)630 1201 y(assignmen)m(ts)30 b(found)f(there.)150 -1358 y Fs(abort)g(\(C-g\))630 1468 y Ft(Ab)s(ort)d(the)h(curren)m(t)f +b(or)k(v)-5 b(ariable)630 1633 y(assignmen)m(ts)30 b(found)f(there.)150 +1807 y Fs(abort)g(\(C-g\))630 1916 y Ft(Ab)s(ort)d(the)h(curren)m(t)f (editing)f(command)h(and)g(ring)g(the)g(terminal's)f(b)s(ell)g(\(sub)5 -b(ject)26 b(to)i(the)630 1577 y(setting)i(of)h Fs(bell-style)p -Ft(\).)150 1734 y Fs(do-uppercase-version)25 b(\(M-a,)k(M-b,)g(M-)p -Fj(x)p Fs(,)g(...)o(\))630 1844 y Ft(If)e(the)h(meta\014ed)g(c)m +b(ject)26 b(to)i(the)630 2026 y(setting)i(of)h Fs(bell-style)p +Ft(\).)150 2199 y Fs(do-uppercase-version)25 b(\(M-a,)k(M-b,)g(M-)p +Fj(x)p Fs(,)g(...)o(\))630 2309 y Ft(If)e(the)h(meta\014ed)g(c)m (haracter)h Fq(x)34 b Ft(is)27 b(lo)m(w)m(ercase,)i(run)e(the)g -(command)h(that)g(is)f(b)s(ound)e(to)k(the)630 1953 y(corresp)s(onding) -f(upp)s(ercase)i(c)m(haracter.)150 2111 y Fs(prefix-meta)d(\()753 -2108 y Fg(h)p 777 2055 139 4 v 777 2111 a Ff(ESC)p 777 -2126 V 911 2108 a Fg(i)941 2111 y Fs(\))630 2220 y Ft(Metafy)39 +(command)h(that)g(is)f(b)s(ound)e(to)k(the)630 2418 y(corresp)s(onding) +f(upp)s(ercase)i(c)m(haracter.)150 2592 y Fs(prefix-meta)d(\()753 +2589 y Fg(h)p 777 2536 139 4 v 777 2592 a Ff(ESC)p 777 +2607 V 911 2589 a Fg(i)941 2592 y Fs(\))630 2701 y Ft(Metafy)39 b(the)e(next)h(c)m(haracter)h(t)m(yp)s(ed.)62 b(This)36 b(is)g(for)i(k)m(eyb)s(oards)f(without)f(a)i(meta)g(k)m(ey)-8 -b(.)630 2330 y(T)m(yping)29 b(`)968 2327 y Fg(h)p 993 -2274 V 993 2330 a Ff(ESC)p 993 2345 V 1127 2327 a Fg(i)1187 -2330 y Fs(f)p Ft(')h(is)f(equiv)-5 b(alen)m(t)30 b(to)h(t)m(yping)f -Fj(M-f)p Ft(.)150 2487 y Fs(undo)f(\(C-_)g(or)h(C-x)g(C-u\))630 -2596 y Ft(Incremen)m(tal)g(undo,)g(separately)g(remem)m(b)s(ered)g(for) -g(eac)m(h)i(line.)150 2754 y Fs(revert-line)27 b(\(M-r\))630 -2863 y Ft(Undo)33 b(all)f(c)m(hanges)i(made)f(to)h(this)e(line.)47 +b(.)630 2811 y(T)m(yping)29 b(`)968 2808 y Fg(h)p 993 +2755 V 993 2811 a Ff(ESC)p 993 2826 V 1127 2808 a Fg(i)1187 +2811 y Fs(f)p Ft(')h(is)f(equiv)-5 b(alen)m(t)30 b(to)h(t)m(yping)f +Fj(M-f)p Ft(.)150 2984 y Fs(undo)f(\(C-_)g(or)h(C-x)g(C-u\))630 +3094 y Ft(Incremen)m(tal)g(undo,)g(separately)g(remem)m(b)s(ered)g(for) +g(eac)m(h)i(line.)150 3267 y Fs(revert-line)27 b(\(M-r\))630 +3377 y Ft(Undo)33 b(all)f(c)m(hanges)i(made)f(to)h(this)e(line.)47 b(This)31 b(is)h(lik)m(e)h(executing)g(the)g Fs(undo)f -Ft(command)630 2973 y(enough)e(times)g(to)h(get)h(bac)m(k)f(to)g(the)f -(b)s(eginning.)150 3130 y Fs(tilde-expand)d(\(M-&\))630 -3239 y Ft(P)m(erform)j(tilde)f(expansion)h(on)g(the)g(curren)m(t)h(w)m -(ord.)150 3396 y Fs(set-mark)d(\(C-@\))630 3506 y Ft(Set)33 +Ft(command)630 3487 y(enough)e(times)g(to)h(get)h(bac)m(k)f(to)g(the)f +(b)s(eginning.)150 3660 y Fs(tilde-expand)d(\(M-&\))630 +3770 y Ft(P)m(erform)j(tilde)f(expansion)h(on)g(the)g(curren)m(t)h(w)m +(ord.)150 3943 y Fs(set-mark)d(\(C-@\))630 4053 y Ft(Set)33 b(the)g(mark)f(to)i(the)f(p)s(oin)m(t.)47 b(If)32 b(a)h(n)m(umeric)f (argumen)m(t)h(is)f(supplied,)e(the)j(mark)g(is)e(set)630 -3616 y(to)g(that)g(p)s(osition.)150 3773 y Fs(exchange-point-and-mark) -24 b(\(C-x)29 b(C-x\))630 3882 y Ft(Sw)m(ap)i(the)g(p)s(oin)m(t)f(with) +4162 y(to)g(that)g(p)s(osition.)150 4336 y Fs(exchange-point-and-mark) +24 b(\(C-x)29 b(C-x\))630 4445 y Ft(Sw)m(ap)i(the)g(p)s(oin)m(t)f(with) g(the)h(mark.)43 b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)g(is)g -(set)i(to)f(the)h(sa)m(v)m(ed)630 3992 y(p)s(osition,)d(and)g(the)i +(set)i(to)f(the)h(sa)m(v)m(ed)630 4555 y(p)s(osition,)d(and)g(the)i (old)f(cursor)f(p)s(osition)g(is)g(sa)m(v)m(ed)j(as)e(the)h(mark.)150 -4149 y Fs(character-search)26 b(\(C-]\))630 4259 y Ft(A)f(c)m(haracter) +4728 y Fs(character-search)26 b(\(C-]\))630 4838 y Ft(A)f(c)m(haracter) h(is)e(read)h(and)f(p)s(oin)m(t)g(is)g(mo)m(v)m(ed)i(to)g(the)f(next)g -(o)s(ccurrence)g(of)g(that)g(c)m(haracter.)630 4368 y(A)30 +(o)s(ccurrence)g(of)g(that)g(c)m(haracter.)630 4947 y(A)30 b(negativ)m(e)i(coun)m(t)f(searc)m(hes)g(for)f(previous)f(o)s -(ccurrences.)150 4525 y Fs(character-search-backwar)o(d)24 -b(\(M-C-]\))630 4635 y Ft(A)45 b(c)m(haracter)h(is)e(read)h(and)f(p)s +(ccurrences.)150 5121 y Fs(character-search-backwar)o(d)24 +b(\(M-C-]\))630 5230 y Ft(A)45 b(c)m(haracter)h(is)e(read)h(and)f(p)s (oin)m(t)g(is)g(mo)m(v)m(ed)i(to)f(the)g(previous)e(o)s(ccurrence)i(of) -g(that)630 4745 y(c)m(haracter.)d(A)31 b(negativ)m(e)g(coun)m(t)g -(searc)m(hes)h(for)e(subsequen)m(t)f(o)s(ccurrences.)150 -4902 y Fs(insert-comment)d(\(M-#\))630 5011 y Ft(Without)35 +g(that)630 5340 y(c)m(haracter.)d(A)31 b(negativ)m(e)g(coun)m(t)g +(searc)m(hes)h(for)e(subsequen)m(t)f(o)s(ccurrences.)p +eop +%%Page: 102 108 +102 107 bop 150 -116 a Ft(102)2527 b(Bash)31 b(Reference)g(Man)m(ual) +150 299 y Fs(insert-comment)26 b(\(M-#\))630 408 y Ft(Without)35 b(a)h(n)m(umeric)f(argumen)m(t,)i(the)f(v)-5 b(alue)35 b(of)h(the)g Fs(comment-begin)c Ft(v)-5 b(ariable)34 -b(is)h(in-)630 5121 y(serted)d(at)g(the)g(b)s(eginning)d(of)j(the)f +b(is)h(in-)630 518 y(serted)d(at)g(the)g(b)s(eginning)d(of)j(the)f (curren)m(t)h(line.)43 b(If)31 b(a)h(n)m(umeric)e(argumen)m(t)i(is)f -(supplied,)630 5230 y(this)k(command)i(acts)g(as)g(a)g(toggle:)54 +(supplied,)630 628 y(this)k(command)i(acts)g(as)g(a)g(toggle:)54 b(if)36 b(the)g(c)m(haracters)i(at)g(the)e(b)s(eginning)e(of)j(the)g -(line)630 5340 y(do)30 b(not)h(matc)m(h)h(the)f(v)-5 -b(alue)30 b(of)g Fs(comment-begin)p Ft(,)e(the)i(v)-5 -b(alue)30 b(is)g(inserted,)g(otherwise)g(the)p eop -%%Page: 102 108 -102 107 bop 150 -116 a Ft(102)2527 b(Bash)31 b(Reference)g(Man)m(ual) -630 299 y(c)m(haracters)42 b(in)c Fs(comment-begin)f -Ft(are)j(deleted)g(from)g(the)g(b)s(eginning)e(of)i(the)g(line.)69 -b(In)630 408 y(either)36 b(case,)k(the)e(line)d(is)h(accepted)j(as)e -(if)f(a)h(newline)e(had)i(b)s(een)f(t)m(yp)s(ed.)60 b(The)37 -b(default)630 518 y(v)-5 b(alue)31 b(of)h Fs(comment-begin)c -Ft(causes)k(this)e(command)i(to)g(mak)m(e)h(the)e(curren)m(t)h(line)e -(a)i(shell)630 628 y(commen)m(t.)40 b(If)26 b(a)h(n)m(umeric)e(argumen) -m(t)i(causes)g(the)f(commen)m(t)i(c)m(haracter)g(to)f(b)s(e)f(remo)m(v) -m(ed,)630 737 y(the)31 b(line)d(will)g(b)s(e)i(executed)h(b)m(y)f(the)h -(shell.)150 887 y Fs(dump-functions)26 b(\(\))630 996 -y Ft(Prin)m(t)f(all)h(of)g(the)h(functions)e(and)h(their)f(k)m(ey)i -(bindings)c(to)28 b(the)e(Readline)f(output)h(stream.)630 -1106 y(If)31 b(a)h(n)m(umeric)f(argumen)m(t)h(is)f(supplied,)e(the)j -(output)f(is)g(formatted)h(in)e(suc)m(h)i(a)g(w)m(a)m(y)g(that)630 -1215 y(it)e(can)h(b)s(e)e(made)i(part)f(of)g(an)h Fq(inputrc)j +(line)630 737 y(do)30 b(not)h(matc)m(h)h(the)f(v)-5 b(alue)30 +b(of)g Fs(comment-begin)p Ft(,)e(the)i(v)-5 b(alue)30 +b(is)g(inserted,)g(otherwise)g(the)630 847 y(c)m(haracters)42 +b(in)c Fs(comment-begin)f Ft(are)j(deleted)g(from)g(the)g(b)s(eginning) +e(of)i(the)g(line.)69 b(In)630 956 y(either)36 b(case,)k(the)e(line)d +(is)h(accepted)j(as)e(if)f(a)h(newline)e(had)i(b)s(een)f(t)m(yp)s(ed.) +60 b(The)37 b(default)630 1066 y(v)-5 b(alue)31 b(of)h +Fs(comment-begin)c Ft(causes)k(this)e(command)i(to)g(mak)m(e)h(the)e +(curren)m(t)h(line)e(a)i(shell)630 1176 y(commen)m(t.)40 +b(If)26 b(a)h(n)m(umeric)e(argumen)m(t)i(causes)g(the)f(commen)m(t)i(c) +m(haracter)g(to)f(b)s(e)f(remo)m(v)m(ed,)630 1285 y(the)31 +b(line)d(will)g(b)s(e)i(executed)h(b)m(y)f(the)h(shell.)150 +1443 y Fs(dump-functions)26 b(\(\))630 1553 y Ft(Prin)m(t)f(all)h(of)g +(the)h(functions)e(and)h(their)f(k)m(ey)i(bindings)c(to)28 +b(the)e(Readline)f(output)h(stream.)630 1663 y(If)31 +b(a)h(n)m(umeric)f(argumen)m(t)h(is)f(supplied,)e(the)j(output)f(is)g +(formatted)h(in)e(suc)m(h)i(a)g(w)m(a)m(y)g(that)630 +1772 y(it)e(can)h(b)s(e)e(made)i(part)f(of)g(an)h Fq(inputrc)j Ft(\014le.)40 b(This)28 b(command)i(is)g(un)m(b)s(ound)d(b)m(y)k -(default.)150 1365 y Fs(dump-variables)26 b(\(\))630 -1474 y Ft(Prin)m(t)20 b(all)g(of)i(the)f(settable)h(v)-5 +(default.)150 1931 y Fs(dump-variables)26 b(\(\))630 +2040 y Ft(Prin)m(t)20 b(all)g(of)i(the)f(settable)h(v)-5 b(ariables)20 b(and)h(their)f(v)-5 b(alues)21 b(to)h(the)f(Readline)f -(output)h(stream.)630 1584 y(If)31 b(a)h(n)m(umeric)f(argumen)m(t)h(is) +(output)h(stream.)630 2150 y(If)31 b(a)h(n)m(umeric)f(argumen)m(t)h(is) f(supplied,)e(the)j(output)f(is)g(formatted)h(in)e(suc)m(h)i(a)g(w)m(a) -m(y)g(that)630 1694 y(it)e(can)h(b)s(e)e(made)i(part)f(of)g(an)h +m(y)g(that)630 2259 y(it)e(can)h(b)s(e)e(made)i(part)f(of)g(an)h Fq(inputrc)j Ft(\014le.)40 b(This)28 b(command)i(is)g(un)m(b)s(ound)d -(b)m(y)k(default.)150 1843 y Fs(dump-macros)c(\(\))630 -1953 y Ft(Prin)m(t)33 b(all)f(of)i(the)g(Readline)e(k)m(ey)j(sequences) +(b)m(y)k(default.)150 2418 y Fs(dump-macros)c(\(\))630 +2527 y Ft(Prin)m(t)33 b(all)f(of)i(the)g(Readline)e(k)m(ey)j(sequences) f(b)s(ound)e(to)i(macros)g(and)f(the)h(strings)f(they)630 -2062 y(output.)53 b(If)35 b(a)g(n)m(umeric)e(argumen)m(t)j(is)d +2637 y(output.)53 b(If)35 b(a)g(n)m(umeric)e(argumen)m(t)j(is)d (supplied,)g(the)i(output)g(is)e(formatted)j(in)d(suc)m(h)i(a)630 -2172 y(w)m(a)m(y)c(that)g(it)e(can)h(b)s(e)g(made)g(part)f(of)i(an)e +2746 y(w)m(a)m(y)c(that)g(it)e(can)h(b)s(e)g(made)g(part)f(of)i(an)e Fq(inputrc)34 b Ft(\014le.)40 b(This)28 b(command)i(is)f(un)m(b)s(ound) -e(b)m(y)630 2281 y(default.)150 2431 y Fs(glob-complete-word)e(\(M-g\)) -630 2540 y Ft(The)i(w)m(ord)h(b)s(efore)f(p)s(oin)m(t)g(is)g(treated)i +e(b)m(y)630 2856 y(default.)150 3014 y Fs(glob-complete-word)e(\(M-g\)) +630 3124 y Ft(The)i(w)m(ord)h(b)s(efore)f(p)s(oin)m(t)g(is)g(treated)i (as)f(a)h(pattern)f(for)f(pathname)h(expansion,)f(with)g(an)630 -2650 y(asterisk)d(implicitly)d(app)s(ended.)37 b(This)22 +3233 y(asterisk)d(implicitly)d(app)s(ended.)37 b(This)22 b(pattern)j(is)e(used)h(to)h(generate)h(a)e(list)f(of)i(matc)m(hing)630 -2760 y(\014le)k(names)i(for)f(p)s(ossible)e(completions.)150 -2909 y Fs(glob-expand-word)e(\(C-x)j(*\))630 3019 y Ft(The)40 +3343 y(\014le)k(names)i(for)f(p)s(ossible)e(completions.)150 +3501 y Fs(glob-expand-word)e(\(C-x)j(*\))630 3611 y Ft(The)40 b(w)m(ord)g(b)s(efore)g(p)s(oin)m(t)g(is)g(treated)h(as)g(a)g(pattern)g -(for)f(pathname)g(expansion,)j(and)630 3128 y(the)d(list)e(of)h(matc)m +(for)f(pathname)g(expansion,)j(and)630 3720 y(the)d(list)e(of)h(matc)m (hing)h(\014le)e(names)h(is)g(inserted,)h(replacing)f(the)g(w)m(ord.)67 -b(If)39 b(a)h(n)m(umeric)630 3238 y(argumen)m(t)31 b(is)e(supplied,)f +b(If)39 b(a)h(n)m(umeric)630 3830 y(argumen)m(t)31 b(is)e(supplied,)f (a)i(`)p Fs(*)p Ft(')h(is)e(app)s(ended)g(b)s(efore)h(pathname)g -(expansion.)150 3387 y Fs(glob-list-expansions)25 b(\(C-x)k(g\))630 -3497 y Ft(The)k(list)f(of)h(expansions)f(that)i(w)m(ould)e(ha)m(v)m(e)i +(expansion.)150 3988 y Fs(glob-list-expansions)25 b(\(C-x)k(g\))630 +4098 y Ft(The)k(list)f(of)h(expansions)f(that)i(w)m(ould)e(ha)m(v)m(e)i (b)s(een)f(generated)h(b)m(y)f Fs(glob-expand-word)630 -3606 y Ft(is)g(displa)m(y)m(ed,)g(and)g(the)h(line)e(is)g(redra)m(wn.) +4208 y Ft(is)g(displa)m(y)m(ed,)g(and)g(the)h(line)e(is)g(redra)m(wn.) 50 b(If)33 b(a)h(n)m(umeric)f(argumen)m(t)h(is)e(supplied,)g(a)i(`)p -Fs(*)p Ft(')630 3716 y(is)29 b(app)s(ended)g(b)s(efore)h(pathname)g -(expansion.)150 3866 y Fs(display-shell-version)25 b(\(C-x)k(C-v\))630 -3975 y Ft(Displa)m(y)h(v)m(ersion)f(information)g(ab)s(out)h(the)h -(curren)m(t)f(instance)g(of)g(Bash.)150 4125 y Fs(shell-expand-line)c -(\(M-C-e\))630 4234 y Ft(Expand)34 b(the)h(line)f(as)i(the)f(shell)f +Fs(*)p Ft(')630 4317 y(is)29 b(app)s(ended)g(b)s(efore)h(pathname)g +(expansion.)150 4475 y Fs(display-shell-version)25 b(\(C-x)k(C-v\))630 +4585 y Ft(Displa)m(y)h(v)m(ersion)f(information)g(ab)s(out)h(the)h +(curren)m(t)f(instance)g(of)g(Bash.)150 4743 y Fs(shell-expand-line)c +(\(M-C-e\))630 4853 y Ft(Expand)34 b(the)h(line)f(as)i(the)f(shell)f (do)s(es.)55 b(This)33 b(p)s(erforms)h(alias)g(and)h(history)f -(expansion)630 4344 y(as)g(w)m(ell)e(as)i(all)f(of)g(the)h(shell)e(w)m +(expansion)630 4963 y(as)g(w)m(ell)e(as)i(all)f(of)g(the)h(shell)e(w)m (ord)h(expansions)f(\(see)j(Section)e(3.5)i([Shell)c(Expansions],)630 -4453 y(page)g(16\).)150 4603 y Fs(history-expand-line)25 -b(\(M-^\))630 4712 y Ft(P)m(erform)30 b(history)g(expansion)f(on)h(the) -h(curren)m(t)f(line.)150 4862 y Fs(magic-space)d(\(\))630 -4971 y Ft(P)m(erform)c(history)f(expansion)g(on)h(the)g(curren)m(t)g -(line)e(and)i(insert)f(a)h(space)h(\(see)g(Section)f(9.3)630 -5081 y([History)30 b(In)m(teraction],)i(page)f(111\).)150 -5230 y Fs(alias-expand-line)26 b(\(\))630 5340 y Ft(P)m(erform)i(alias) -g(expansion)f(on)h(the)h(curren)m(t)f(line)f(\(see)i(Section)f(6.6)i -([Aliases],)e(page)h(71\).)p eop +5072 y(page)g(16\).)150 5230 y Fs(history-expand-line)25 +b(\(M-^\))630 5340 y Ft(P)m(erform)30 b(history)g(expansion)f(on)h(the) +h(curren)m(t)f(line.)p eop %%Page: 103 109 103 108 bop 150 -116 a Ft(Chapter)30 b(8:)41 b(Command)29 -b(Line)h(Editing)2060 b(103)150 299 y Fs(history-and-alias-expand)o -(-lin)o(e)24 b(\(\))630 408 y Ft(P)m(erform)30 b(history)g(and)f(alias) -h(expansion)f(on)h(the)h(curren)m(t)f(line.)150 570 y -Fs(insert-last-argument)25 b(\(M-.)k(or)h(M-_\))630 680 -y Ft(A)g(synon)m(ym)g(for)g Fs(yank-last-arg)p Ft(.)150 -842 y Fs(operate-and-get-next)25 b(\(C-o\))630 952 y -Ft(Accept)42 b(the)e(curren)m(t)h(line)d(for)j(execution)f(and)g(fetc)m -(h)i(the)e(next)h(line)e(relativ)m(e)i(to)g(the)630 1061 -y(curren)m(t)30 b(line)f(from)h(the)g(history)g(for)g(editing.)39 -b(An)m(y)31 b(argumen)m(t)f(is)g(ignored.)150 1223 y -Fs(edit-and-execute-command)24 b(\(C-xC-e\))630 1333 +b(Line)h(Editing)2060 b(103)150 299 y Fs(magic-space)27 +b(\(\))630 408 y Ft(P)m(erform)c(history)f(expansion)g(on)h(the)g +(curren)m(t)g(line)e(and)i(insert)f(a)h(space)h(\(see)g(Section)f(9.3) +630 518 y([History)30 b(In)m(teraction],)i(page)f(111\).)150 +664 y Fs(alias-expand-line)26 b(\(\))630 774 y Ft(P)m(erform)i(alias)g +(expansion)f(on)h(the)h(curren)m(t)f(line)f(\(see)i(Section)f(6.6)i +([Aliases],)e(page)h(71\).)150 920 y Fs(history-and-alias-expand)o +(-lin)o(e)24 b(\(\))630 1029 y Ft(P)m(erform)30 b(history)g(and)f +(alias)h(expansion)f(on)h(the)h(curren)m(t)f(line.)150 +1176 y Fs(insert-last-argument)25 b(\(M-.)k(or)h(M-_\))630 +1285 y Ft(A)g(synon)m(ym)g(for)g Fs(yank-last-arg)p Ft(.)150 +1431 y Fs(operate-and-get-next)25 b(\(C-o\))630 1541 +y Ft(Accept)42 b(the)e(curren)m(t)h(line)d(for)j(execution)f(and)g +(fetc)m(h)i(the)e(next)h(line)e(relativ)m(e)i(to)g(the)630 +1650 y(curren)m(t)30 b(line)f(from)h(the)g(history)g(for)g(editing.)39 +b(An)m(y)31 b(argumen)m(t)f(is)g(ignored.)150 1797 y +Fs(edit-and-execute-command)24 b(\(C-xC-e\))630 1906 y Ft(In)m(v)m(ok)m(e)34 b(an)f(editor)f(on)h(the)g(curren)m(t)f (command)h(line,)f(and)g(execute)i(the)f(result)f(as)h(shell)630 -1442 y(commands.)81 b(Bash)44 b(attempts)h(to)g(in)m(v)m(ok)m(e)g +2016 y(commands.)81 b(Bash)44 b(attempts)h(to)g(in)m(v)m(ok)m(e)g Fs($FCEDIT)p Ft(,)g Fs($EDITOR)p Ft(,)h(and)d Fs(emacs)g -Ft(as)h(the)630 1552 y(editor,)30 b(in)f(that)i(order.)150 -1816 y Fr(8.5)68 b(Readline)47 b(vi)e(Mo)t(de)275 2062 +Ft(as)h(the)630 2125 y(editor,)30 b(in)f(that)i(order.)150 +2363 y Fr(8.5)68 b(Readline)47 b(vi)e(Mo)t(de)275 2600 y Ft(While)22 b(the)i(Readline)e(library)f(do)s(es)j(not)g(ha)m(v)m(e)g (a)h(full)c(set)j(of)g Fs(vi)f Ft(editing)f(functions,)i(it)f(do)s(es)h -(con)m(tain)150 2172 y(enough)34 b(to)h(allo)m(w)e(simple)f(editing)h +(con)m(tain)150 2710 y(enough)34 b(to)h(allo)m(w)e(simple)f(editing)h (of)h(the)g(line.)50 b(The)34 b(Readline)e Fs(vi)i Ft(mo)s(de)f(b)s -(eha)m(v)m(es)i(as)f(sp)s(eci\014ed)e(in)150 2281 y(the)f -Fl(posix)e Ft(1003.2)k(standard.)275 2418 y(In)i(order)g(to)i(switc)m +(eha)m(v)m(es)i(as)f(sp)s(eci\014ed)e(in)150 2819 y(the)f +Fl(posix)e Ft(1003.2)k(standard.)275 2947 y(In)i(order)g(to)i(switc)m (h)e(in)m(teractiv)m(ely)h(b)s(et)m(w)m(een)g Fs(emacs)f Ft(and)g Fs(vi)g Ft(editing)f(mo)s(des,)j(use)f(the)g(`)p -Fs(set)30 b(-o)150 2528 y(emacs)p Ft(')21 b(and)g(`)p +Fs(set)30 b(-o)150 3057 y(emacs)p Ft(')21 b(and)g(`)p Fs(set)29 b(-o)h(vi)p Ft(')21 b(commands)h(\(see)g(Section)g(4.3)h ([The)e(Set)h(Builtin],)g(page)g(50\).)39 b(The)21 b(Readline)150 -2638 y(default)30 b(is)f Fs(emacs)g Ft(mo)s(de.)275 2775 +3166 y(default)30 b(is)f Fs(emacs)g Ft(mo)s(de.)275 3294 y(When)g(y)m(ou)i(en)m(ter)f(a)h(line)d(in)h Fs(vi)g Ft(mo)s(de,)h(y)m(ou)h(are)f(already)g(placed)f(in)g(`insertion')f(mo)s -(de,)i(as)h(if)e(y)m(ou)150 2884 y(had)d(t)m(yp)s(ed)g(an)g(`)p -Fs(i)p Ft('.)39 b(Pressing)1215 2881 y Fg(h)p 1239 2828 -139 4 v 1239 2884 a Ff(ESC)p 1239 2900 V 1373 2881 a -Fg(i)1429 2884 y Ft(switc)m(hes)26 b(y)m(ou)h(in)m(to)f(`command')g(mo) -s(de,)h(where)f(y)m(ou)h(can)f(edit)g(the)150 2994 y(text)35 +(de,)i(as)h(if)e(y)m(ou)150 3404 y(had)d(t)m(yp)s(ed)g(an)g(`)p +Fs(i)p Ft('.)39 b(Pressing)1215 3401 y Fg(h)p 1239 3348 +139 4 v 1239 3404 a Ff(ESC)p 1239 3419 V 1373 3401 a +Fg(i)1429 3404 y Ft(switc)m(hes)26 b(y)m(ou)h(in)m(to)f(`command')g(mo) +s(de,)h(where)f(y)m(ou)h(can)f(edit)g(the)150 3513 y(text)35 b(of)f(the)g(line)e(with)g(the)i(standard)f Fs(vi)g Ft(mo)m(v)m(emen)m (t)j(k)m(eys,)g(mo)m(v)m(e)f(to)f(previous)f(history)f(lines)g(with)150 -3103 y(`)p Fs(k)p Ft(')f(and)e(subsequen)m(t)h(lines)f(with)g(`)p -Fs(j)p Ft(',)h(and)g(so)h(forth.)150 3367 y Fr(8.6)68 -b(Programmable)47 b(Completion)275 3614 y Ft(When)25 +3623 y(`)p Fs(k)p Ft(')f(and)e(subsequen)m(t)h(lines)f(with)g(`)p +Fs(j)p Ft(',)h(and)g(so)h(forth.)150 3861 y Fr(8.6)68 +b(Programmable)47 b(Completion)275 4098 y Ft(When)25 b(w)m(ord)g(completion)g(is)g(attempted)h(for)g(an)f(argumen)m(t)h(to)h -(a)f(command)f(for)h(whic)m(h)e(a)i(comple-)150 3723 +(a)f(command)f(for)h(whic)m(h)e(a)i(comple-)150 4208 y(tion)e(sp)s(eci\014cation)f(\(a)j Fq(compsp)s(ec)6 b Ft(\))24 b(has)g(b)s(een)g(de\014ned)g(using)f(the)h Fs(complete)f Ft(builtin)e(\(see)k(Section)g(8.7)150 -3833 y([Programmable)e(Completion)f(Builtins],)g(page)i(105\),)j(the)c -(programmable)g(completion)f(facilities)g(are)150 3943 -y(in)m(v)m(ok)m(ed.)275 4080 y(First,)g(the)f(command)g(name)g(is)g +4317 y([Programmable)e(Completion)f(Builtins],)g(page)i(105\),)j(the)c +(programmable)g(completion)f(facilities)g(are)150 4427 +y(in)m(v)m(ok)m(ed.)275 4555 y(First,)g(the)f(command)g(name)g(is)g (iden)m(ti\014ed.)35 b(If)21 b(a)g(compsp)s(ec)g(has)g(b)s(een)f -(de\014ned)g(for)h(that)h(command,)150 4189 y(the)44 +(de\014ned)g(for)h(that)h(command,)150 4664 y(the)44 b(compsp)s(ec)g(is)f(used)g(to)h(generate)i(the)e(list)e(of)i(p)s (ossible)e(completions)h(for)g(the)h(w)m(ord.)81 b(If)44 -b(the)150 4299 y(command)33 b(w)m(ord)f(is)g(a)h(full)e(pathname,)j(a)f +b(the)150 4774 y(command)33 b(w)m(ord)f(is)g(a)h(full)e(pathname,)j(a)f (compsp)s(ec)f(for)h(the)g(full)e(pathname)h(is)g(searc)m(hed)i(for)e -(\014rst.)150 4408 y(If)f(no)h(compsp)s(ec)f(is)g(found)f(for)h(the)h +(\014rst.)150 4883 y(If)f(no)h(compsp)s(ec)f(is)g(found)f(for)h(the)h (full)e(pathname,)i(an)f(attempt)i(is)e(made)g(to)i(\014nd)d(a)i -(compsp)s(ec)f(for)150 4518 y(the)g(p)s(ortion)e(follo)m(wing)f(the)j -(\014nal)e(slash.)275 4655 y(Once)34 b(a)g(compsp)s(ec)g(has)g(b)s(een) +(compsp)s(ec)f(for)150 4993 y(the)g(p)s(ortion)e(follo)m(wing)f(the)j +(\014nal)e(slash.)275 5121 y(Once)34 b(a)g(compsp)s(ec)g(has)g(b)s(een) f(found,)h(it)g(is)f(used)g(to)i(generate)h(the)e(list)f(of)h(matc)m -(hing)g(w)m(ords.)51 b(If)150 4765 y(a)37 b(compsp)s(ec)f(is)f(not)i +(hing)g(w)m(ords.)51 b(If)150 5230 y(a)37 b(compsp)s(ec)f(is)f(not)i (found,)f(the)h(default)e(Bash)i(completion)e(describ)s(ed)f(ab)s(o)m -(v)m(e)k(\(see)f(Section)f(8.4.6)150 4874 y([Commands)30 -b(F)-8 b(or)31 b(Completion],)e(page)i(99\))h(is)d(p)s(erformed.)275 -5011 y(First,)h(the)h(actions)f(sp)s(eci\014ed)f(b)m(y)i(the)f(compsp)s -(ec)h(are)g(used.)40 b(Only)29 b(matc)m(hes)j(whic)m(h)d(are)i -(pre\014xed)150 5121 y(b)m(y)25 b(the)h(w)m(ord)f(b)s(eing)e(completed) -j(are)f(returned.)38 b(When)25 b(the)h(`)p Fs(-f)p Ft(')f(or)g(`)p +(v)m(e)k(\(see)f(Section)f(8.4.6)150 5340 y([Commands)30 +b(F)-8 b(or)31 b(Completion],)e(page)i(99\))h(is)d(p)s(erformed.)p +eop +%%Page: 104 110 +104 109 bop 150 -116 a Ft(104)2527 b(Bash)31 b(Reference)g(Man)m(ual) +275 299 y(First,)f(the)h(actions)f(sp)s(eci\014ed)f(b)m(y)i(the)f +(compsp)s(ec)h(are)g(used.)40 b(Only)29 b(matc)m(hes)j(whic)m(h)d(are)i +(pre\014xed)150 408 y(b)m(y)25 b(the)h(w)m(ord)f(b)s(eing)e(completed)j +(are)f(returned.)38 b(When)25 b(the)h(`)p Fs(-f)p Ft(')f(or)g(`)p Fs(-d)p Ft(')g(option)g(is)f(used)h(for)g(\014lename)150 -5230 y(or)30 b(directory)g(name)g(completion,)g(the)g(shell)f(v)-5 +518 y(or)30 b(directory)g(name)g(completion,)g(the)g(shell)f(v)-5 b(ariable)29 b Fs(FIGNORE)f Ft(is)h(used)g(to)i(\014lter)f(the)g(matc)m -(hes.)42 b(See)150 5340 y(Section)30 b(5.2)i([Bash)e(V)-8 +(hes.)42 b(See)150 628 y(Section)30 b(5.2)i([Bash)e(V)-8 b(ariables],)31 b(page)g(55,)g(for)f(a)h(description)e(of)h -Fs(FIGNORE)p Ft(.)p eop -%%Page: 104 110 -104 109 bop 150 -116 a Ft(104)2527 b(Bash)31 b(Reference)g(Man)m(ual) -275 299 y(An)m(y)e(completions)f(sp)s(eci\014ed)g(b)m(y)h(a)h -(\014lename)e(expansion)h(pattern)g(to)h(the)g(`)p Fs(-G)p -Ft(')f(option)g(are)g(gener-)150 408 y(ated)h(next.)40 +Fs(FIGNORE)p Ft(.)275 765 y(An)m(y)f(completions)f(sp)s(eci\014ed)g(b)m +(y)h(a)h(\014lename)e(expansion)h(pattern)g(to)h(the)g(`)p +Fs(-G)p Ft(')f(option)g(are)g(gener-)150 874 y(ated)h(next.)40 b(The)29 b(w)m(ords)g(generated)h(b)m(y)f(the)h(pattern)f(need)g(not)g (matc)m(h)i(the)e(w)m(ord)g(b)s(eing)f(completed.)150 -518 y(The)42 b Fs(GLOBIGNORE)d Ft(shell)i(v)-5 b(ariable)41 +984 y(The)42 b Fs(GLOBIGNORE)d Ft(shell)i(v)-5 b(ariable)41 b(is)g(not)i(used)e(to)i(\014lter)e(the)i(matc)m(hes,)j(but)c(the)g -Fs(FIGNORE)f Ft(shell)150 628 y(v)-5 b(ariable)29 b(is)h(used.)275 -778 y(Next,)35 b(the)g(string)d(sp)s(eci\014ed)h(as)h(the)g(argumen)m +Fs(FIGNORE)f Ft(shell)150 1093 y(v)-5 b(ariable)29 b(is)h(used.)275 +1230 y(Next,)35 b(the)g(string)d(sp)s(eci\014ed)h(as)h(the)g(argumen)m (t)g(to)h(the)f(`)p Fs(-W)p Ft(')g(option)f(is)g(considered.)51 -b(The)33 b(string)150 888 y(is)f(\014rst)f(split)g(using)g(the)i(c)m +b(The)33 b(string)150 1340 y(is)f(\014rst)f(split)g(using)g(the)i(c)m (haracters)h(in)d(the)i Fs(IFS)e Ft(sp)s(ecial)h(v)-5 b(ariable)31 b(as)i(delimiters.)45 b(Shell)30 b(quoting)i(is)150 -998 y(honored.)37 b(Eac)m(h)21 b(w)m(ord)g(is)f(then)g(expanded)g +1450 y(honored.)37 b(Eac)m(h)21 b(w)m(ord)g(is)f(then)g(expanded)g (using)g(brace)h(expansion,)h(tilde)d(expansion,)j(parameter)g(and)150 -1107 y(v)-5 b(ariable)24 b(expansion,)h(command)g(substitution,)f +1559 y(v)-5 b(ariable)24 b(expansion,)h(command)g(substitution,)f (arithmetic)g(expansion,)h(and)g(pathname)g(expansion,)150 -1217 y(as)j(describ)s(ed)d(ab)s(o)m(v)m(e)k(\(see)f(Section)g(3.5)g +1669 y(as)j(describ)s(ed)d(ab)s(o)m(v)m(e)k(\(see)f(Section)g(3.5)g ([Shell)e(Expansions],)g(page)j(16\).)41 b(The)27 b(results)f(are)i -(split)d(using)150 1326 y(the)33 b(rules)f(describ)s(ed)e(ab)s(o)m(v)m +(split)d(using)150 1778 y(the)33 b(rules)f(describ)s(ed)e(ab)s(o)m(v)m (e)k(\(see)g(Section)f(3.5.7)i([W)-8 b(ord)33 b(Splitting],)f(page)h -(22\).)50 b(The)32 b(results)g(of)h(the)150 1436 y(expansion)g(are)i +(22\).)50 b(The)32 b(results)g(of)h(the)150 1888 y(expansion)g(are)i (pre\014x-matc)m(hed)f(against)h(the)f(w)m(ord)g(b)s(eing)f(completed,) -j(and)e(the)g(matc)m(hing)g(w)m(ords)150 1545 y(b)s(ecome)d(the)f(p)s -(ossible)e(completions.)275 1696 y(After)h(these)g(matc)m(hes)i(ha)m(v) +j(and)e(the)g(matc)m(hing)g(w)m(ords)150 1998 y(b)s(ecome)d(the)f(p)s +(ossible)e(completions.)275 2134 y(After)h(these)g(matc)m(hes)i(ha)m(v) m(e)f(b)s(een)f(generated,)h(an)m(y)g(shell)d(function)h(or)h(command)g -(sp)s(eci\014ed)e(with)150 1806 y(the)j(`)p Fs(-F)p Ft(')g(and)f(`)p +(sp)s(eci\014ed)e(with)150 2244 y(the)j(`)p Fs(-F)p Ft(')g(and)f(`)p Fs(-C)p Ft(')h(options)f(is)g(in)m(v)m(ok)m(ed.)40 b(When)30 b(the)g(command)g(or)f(function)g(is)g(in)m(v)m(ok)m(ed,)h(the)g -Fs(COMP_)150 1915 y(LINE)21 b Ft(and)h Fs(COMP_POINT)d +Fs(COMP_)150 2354 y(LINE)21 b Ft(and)h Fs(COMP_POINT)d Ft(v)-5 b(ariables)21 b(are)i(assigned)f(v)-5 b(alues)21 b(as)i(describ)s(ed)d(ab)s(o)m(v)m(e)k(\(see)f(Section)f(5.2)i([Bash) -150 2025 y(V)-8 b(ariables],)31 b(page)h(55\).)44 b(If)30 +150 2463 y(V)-8 b(ariables],)31 b(page)h(55\).)44 b(If)30 b(a)i(shell)d(function)g(is)h(b)s(eing)g(in)m(v)m(ok)m(ed,)i(the)f -Fs(COMP_WORDS)d Ft(and)j Fs(COMP_CWORD)150 2134 y Ft(v)-5 +Fs(COMP_WORDS)d Ft(and)j Fs(COMP_CWORD)150 2573 y Ft(v)-5 b(ariables)38 b(are)i(also)g(set.)68 b(When)40 b(the)f(function)g(or)g (command)g(is)g(in)m(v)m(ok)m(ed,)j(the)e(\014rst)f(argumen)m(t)h(is) -150 2244 y(the)34 b(name)f(of)h(the)g(command)f(whose)g(argumen)m(ts)h +150 2682 y(the)34 b(name)f(of)h(the)g(command)f(whose)g(argumen)m(ts)h (are)g(b)s(eing)e(completed,)j(the)e(second)h(argumen)m(t)g(is)150 -2354 y(the)h(w)m(ord)g(b)s(eing)f(completed,)i(and)f(the)g(third)e +2792 y(the)h(w)m(ord)g(b)s(eing)f(completed,)i(and)f(the)g(third)e (argumen)m(t)j(is)e(the)h(w)m(ord)g(preceding)f(the)i(w)m(ord)e(b)s -(eing)150 2463 y(completed)d(on)f(the)h(curren)m(t)g(command)f(line.)40 +(eing)150 2902 y(completed)d(on)f(the)h(curren)m(t)g(command)f(line.)40 b(No)31 b(\014ltering)e(of)i(the)g(generated)h(completions)e(against) -150 2573 y(the)f(w)m(ord)g(b)s(eing)e(completed)i(is)f(p)s(erformed;)g +150 3011 y(the)f(w)m(ord)g(b)s(eing)e(completed)i(is)f(p)s(erformed;)g (the)h(function)f(or)h(command)f(has)h(complete)g(freedom)g(in)150 -2682 y(generating)i(the)f(matc)m(hes.)275 2833 y(An)m(y)h(function)g +3121 y(generating)i(the)f(matc)m(hes.)275 3258 y(An)m(y)h(function)g (sp)s(eci\014ed)f(with)g(`)p Fs(-F)p Ft(')i(is)f(in)m(v)m(ok)m(ed)h (\014rst.)44 b(The)31 b(function)g(ma)m(y)h(use)g(an)m(y)g(of)g(the)g -(shell)150 2943 y(facilities,)40 b(including)d(the)j +(shell)150 3367 y(facilities,)40 b(including)d(the)j Fs(compgen)d Ft(builtin)g(describ)s(ed)g(b)s(elo)m(w)i(\(see)i(Section) -e(8.7)i([Programmable)150 3052 y(Completion)26 b(Builtins],)f(page)j +e(8.7)i([Programmable)150 3477 y(Completion)26 b(Builtins],)f(page)j (105\),)i(to)e(generate)h(the)e(matc)m(hes.)41 b(It)27 -b(m)m(ust)g(put)g(the)g(p)s(ossible)e(comple-)150 3162 +b(m)m(ust)g(put)g(the)g(p)s(ossible)e(comple-)150 3587 y(tions)30 b(in)f(the)h Fs(COMPREPLY)e Ft(arra)m(y)j(v)-5 -b(ariable.)275 3313 y(Next,)23 b(an)m(y)e(command)f(sp)s(eci\014ed)f +b(ariable.)275 3724 y(Next,)23 b(an)m(y)e(command)f(sp)s(eci\014ed)f (with)g(the)i(`)p Fs(-C)p Ft(')f(option)g(is)g(in)m(v)m(ok)m(ed)h(in)e -(an)h(en)m(vironmen)m(t)g(equiv)-5 b(alen)m(t)150 3422 +(an)h(en)m(vironmen)m(t)g(equiv)-5 b(alen)m(t)150 3833 y(to)26 b(command)e(substitution.)37 b(It)25 b(should)e(prin)m(t)h(a)h (list)f(of)h(completions,)g(one)g(p)s(er)f(line,)h(to)h(the)f(standard) -150 3532 y(output.)40 b(Bac)m(kslash)31 b(ma)m(y)g(b)s(e)f(used)g(to)h +150 3943 y(output.)40 b(Bac)m(kslash)31 b(ma)m(y)g(b)s(e)f(used)g(to)h (escap)s(e)g(a)f(newline,)f(if)g(necessary)-8 b(.)275 -3682 y(After)42 b(all)e(of)i(the)g(p)s(ossible)e(completions)h(are)h +4080 y(After)42 b(all)e(of)i(the)g(p)s(ossible)e(completions)h(are)h (generated,)k(an)m(y)c(\014lter)f(sp)s(eci\014ed)f(with)h(the)h(`)p -Fs(-X)p Ft(')150 3792 y(option)33 b(is)f(applied)f(to)j(the)f(list.)47 +Fs(-X)p Ft(')150 4189 y(option)33 b(is)f(applied)f(to)j(the)f(list.)47 b(The)33 b(\014lter)f(is)g(a)i(pattern)f(as)g(used)g(for)g(pathname)g -(expansion;)g(a)h(`)p Fs(&)p Ft(')150 3902 y(in)k(the)h(pattern)g(is)f +(expansion;)g(a)h(`)p Fs(&)p Ft(')150 4299 y(in)k(the)h(pattern)g(is)f (replaced)g(with)g(the)h(text)h(of)f(the)g(w)m(ord)g(b)s(eing)e (completed.)67 b(A)39 b(literal)e(`)p Fs(&)p Ft(')i(ma)m(y)150 -4011 y(b)s(e)e(escap)s(ed)h(with)f(a)i(bac)m(kslash;)j(the)c(bac)m +4408 y(b)s(e)e(escap)s(ed)h(with)f(a)i(bac)m(kslash;)j(the)c(bac)m (kslash)g(is)f(remo)m(v)m(ed)i(b)s(efore)e(attempting)i(a)f(matc)m(h.) -65 b(An)m(y)150 4121 y(completion)33 b(that)i(matc)m(hes)g(the)f +65 b(An)m(y)150 4518 y(completion)33 b(that)i(matc)m(hes)g(the)f (pattern)g(will)d(b)s(e)j(remo)m(v)m(ed)h(from)e(the)h(list.)51 -b(A)34 b(leading)e(`)p Fs(!)p Ft(')j(negates)150 4230 +b(A)34 b(leading)e(`)p Fs(!)p Ft(')j(negates)150 4628 y(the)c(pattern;)f(in)f(this)h(case)h(an)m(y)g(completion)e(not)i(matc) m(hing)g(the)f(pattern)h(will)c(b)s(e)j(remo)m(v)m(ed.)275 -4381 y(Finally)-8 b(,)30 b(an)m(y)i(pre\014x)f(and)g(su\016x)g(sp)s +4765 y(Finally)-8 b(,)30 b(an)m(y)i(pre\014x)f(and)g(su\016x)g(sp)s (eci\014ed)f(with)h(the)h(`)p Fs(-P)p Ft(')f(and)g(`)p Fs(-S)p Ft(')h(options)f(are)h(added)f(to)i(eac)m(h)150 -4491 y(mem)m(b)s(er)e(of)g(the)h(completion)f(list,)f(and)h(the)h +4874 y(mem)m(b)s(er)e(of)g(the)h(completion)f(list,)f(and)h(the)h (result)e(is)h(returned)f(to)i(the)g(Readline)e(completion)h(co)s(de) -150 4600 y(as)g(the)f(list)f(of)i(p)s(ossible)d(completions.)275 -4751 y(If)22 b(the)i(previously-applied)19 b(actions)24 +150 4984 y(as)g(the)f(list)f(of)i(p)s(ossible)d(completions.)275 +5121 y(If)22 b(the)i(previously-applied)19 b(actions)24 b(do)f(not)h(generate)h(an)m(y)f(matc)m(hes,)i(and)d(the)g(`)p -Fs(-o)30 b(dirnames)p Ft(')22 b(op-)150 4861 y(tion)28 +Fs(-o)30 b(dirnames)p Ft(')22 b(op-)150 5230 y(tion)28 b(w)m(as)g(supplied)d(to)k Fs(complete)d Ft(when)h(the)h(compsp)s(ec)g (w)m(as)g(de\014ned,)g(directory)f(name)i(completion)150 -4970 y(is)g(attempted.)275 5121 y(If)h(the)i(`)p Fs(-o)e(plusdirs)p -Ft(')f(option)i(w)m(as)g(supplied)d(to)k Fs(complete)e -Ft(when)g(the)h(compsp)s(ec)g(w)m(as)h(de\014ned,)150 -5230 y(directory)j(name)g(completion)g(is)f(attempted)i(and)f(an)m(y)h -(matc)m(hes)g(are)g(added)f(to)h(the)f(results)f(of)i(the)150 -5340 y(other)31 b(actions.)p eop +5340 y(is)g(attempted.)p eop %%Page: 105 111 105 110 bop 150 -116 a Ft(Chapter)30 b(8:)41 b(Command)29 -b(Line)h(Editing)2060 b(105)275 299 y(By)31 b(default,)h(if)e(a)i -(compsp)s(ec)f(is)g(found,)g(whatev)m(er)h(it)f(generates)i(is)d -(returned)h(to)h(the)g(completion)150 408 y(co)s(de)21 -b(as)g(the)g(full)e(set)i(of)g(p)s(ossible)d(completions.)37 -b(The)20 b(default)g(Bash)h(completions)f(are)i(not)f(attempted,)150 -518 y(and)k(the)h(Readline)e(default)h(of)h(\014lename)f(completion)g -(is)g(disabled.)36 b(If)26 b(the)g(`)p Fs(-o)k(bashdefault)p -Ft(')22 b(option)150 628 y(w)m(as)i(supplied)c(to)25 -b Fs(complete)c Ft(when)i(the)g(compsp)s(ec)h(w)m(as)g(de\014ned,)g -(the)f(default)g(Bash)h(completions)f(are)150 737 y(attempted)h(if)e -(the)h(compsp)s(ec)g(generates)i(no)e(matc)m(hes.)39 -b(If)23 b(the)g(`)p Fs(-o)30 b(default)p Ft(')21 b(option)i(w)m(as)g -(supplied)d(to)150 847 y Fs(complete)25 b Ft(when)h(the)h(compsp)s(ec)f -(w)m(as)i(de\014ned,)e(Readline's)g(default)g(completion)g(will)e(b)s -(e)i(p)s(erformed)150 956 y(if)j(the)i(compsp)s(ec)f(\(and,)g(if)g -(attempted,)h(the)g(default)e(Bash)i(completions\))f(generate)i(no)e -(matc)m(hes.)275 1098 y(When)20 b(a)i(compsp)s(ec)e(indicates)g(that)i -(directory)f(name)g(completion)f(is)g(desired,)i(the)f(programmable)150 -1208 y(completion)29 b(functions)f(force)j(Readline)d(to)j(app)s(end)d +b(Line)h(Editing)2060 b(105)275 299 y(If)30 b(the)i(`)p +Fs(-o)e(plusdirs)p Ft(')f(option)i(w)m(as)g(supplied)d(to)k +Fs(complete)e Ft(when)g(the)h(compsp)s(ec)g(w)m(as)h(de\014ned,)150 +408 y(directory)j(name)g(completion)g(is)f(attempted)i(and)f(an)m(y)h +(matc)m(hes)g(are)g(added)f(to)h(the)f(results)f(of)i(the)150 +518 y(other)31 b(actions.)275 659 y(By)g(default,)h(if)e(a)i(compsp)s +(ec)f(is)g(found,)g(whatev)m(er)h(it)f(generates)i(is)d(returned)h(to)h +(the)g(completion)150 769 y(co)s(de)21 b(as)g(the)g(full)e(set)i(of)g +(p)s(ossible)d(completions.)37 b(The)20 b(default)g(Bash)h(completions) +f(are)i(not)f(attempted,)150 879 y(and)k(the)h(Readline)e(default)h(of) +h(\014lename)f(completion)g(is)g(disabled.)36 b(If)26 +b(the)g(`)p Fs(-o)k(bashdefault)p Ft(')22 b(option)150 +988 y(w)m(as)i(supplied)c(to)25 b Fs(complete)c Ft(when)i(the)g(compsp) +s(ec)h(w)m(as)g(de\014ned,)g(the)f(default)g(Bash)h(completions)f(are) +150 1098 y(attempted)h(if)e(the)h(compsp)s(ec)g(generates)i(no)e(matc)m +(hes.)39 b(If)23 b(the)g(`)p Fs(-o)30 b(default)p Ft(')21 +b(option)i(w)m(as)g(supplied)d(to)150 1207 y Fs(complete)25 +b Ft(when)h(the)h(compsp)s(ec)f(w)m(as)i(de\014ned,)e(Readline's)g +(default)g(completion)g(will)e(b)s(e)i(p)s(erformed)150 +1317 y(if)j(the)i(compsp)s(ec)f(\(and,)g(if)g(attempted,)h(the)g +(default)e(Bash)i(completions\))f(generate)i(no)e(matc)m(hes.)275 +1458 y(When)20 b(a)i(compsp)s(ec)e(indicates)g(that)i(directory)f(name) +g(completion)f(is)g(desired,)i(the)f(programmable)150 +1568 y(completion)29 b(functions)f(force)j(Readline)d(to)j(app)s(end)d (a)i(slash)f(to)h(completed)g(names)f(whic)m(h)g(are)h(sym-)150 -1317 y(b)s(olic)38 b(links)g(to)j(directories,)h(sub)5 +1678 y(b)s(olic)38 b(links)g(to)j(directories,)h(sub)5 b(ject)40 b(to)h(the)f(v)-5 b(alue)40 b(of)g(the)g Fq(mark-directories) -j Ft(Readline)c(v)-5 b(ariable,)150 1427 y(regardless)30 +j Ft(Readline)c(v)-5 b(ariable,)150 1787 y(regardless)30 b(of)g(the)h(setting)f(of)h(the)f Fq(mark-symlink)m(ed-directories)i -Ft(Readline)d(v)-5 b(ariable.)150 1703 y Fr(8.7)68 b(Programmable)47 -b(Completion)f(Builtins)275 1954 y Ft(Tw)m(o)30 b(builtin)d(commands)j +Ft(Readline)d(v)-5 b(ariable.)150 2062 y Fr(8.7)68 b(Programmable)47 +b(Completion)f(Builtins)275 2313 y Ft(Tw)m(o)30 b(builtin)d(commands)j (are)h(a)m(v)-5 b(ailable)29 b(to)i(manipulate)e(the)i(programmable)e -(completion)h(facil-)150 2063 y(ities.)150 2234 y Fs(compgen)870 -2372 y(compgen)46 b([)p Fj(option)11 b Fs(])45 b([)p -Fj(word)11 b Fs(])630 2510 y Ft(Generate)27 b(p)s(ossible)c(completion) +(completion)h(facil-)150 2423 y(ities.)150 2592 y Fs(compgen)870 +2730 y(compgen)46 b([)p Fj(option)11 b Fs(])45 b([)p +Fj(word)11 b Fs(])630 2868 y Ft(Generate)27 b(p)s(ossible)c(completion) i(matc)m(hes)i(for)e Fq(w)m(ord)k Ft(according)d(to)g(the)g -Fq(option)p Ft(s,)g(whic)m(h)630 2620 y(ma)m(y)i(b)s(e)f(an)m(y)h +Fq(option)p Ft(s,)g(whic)m(h)630 2978 y(ma)m(y)i(b)s(e)f(an)m(y)h (option)f(accepted)i(b)m(y)e(the)h Fs(complete)d Ft(builtin)g(with)h -(the)i(exception)f(of)h(`)p Fs(-p)p Ft(')630 2729 y(and)k(`)p +(the)i(exception)f(of)h(`)p Fs(-p)p Ft(')630 3088 y(and)k(`)p Fs(-r)p Ft(',)i(and)e(write)g(the)h(matc)m(hes)h(to)g(the)f(standard)f (output.)48 b(When)33 b(using)e(the)i(`)p Fs(-F)p Ft(')630 -2839 y(or)28 b(`)p Fs(-C)p Ft(')g(options,)g(the)g(v)-5 +3197 y(or)28 b(`)p Fs(-C)p Ft(')g(options,)g(the)g(v)-5 b(arious)28 b(shell)e(v)-5 b(ariables)27 b(set)h(b)m(y)g(the)g -(programmable)g(completion)630 2948 y(facilities,)h(while)f(a)m(v)-5 +(programmable)g(completion)630 3307 y(facilities,)h(while)f(a)m(v)-5 b(ailable,)30 b(will)e(not)j(ha)m(v)m(e)g(useful)e(v)-5 -b(alues.)630 3087 y(The)34 b(matc)m(hes)h(will)d(b)s(e)i(generated)h +b(alues.)630 3445 y(The)34 b(matc)m(hes)h(will)d(b)s(e)i(generated)h (in)e(the)i(same)g(w)m(a)m(y)g(as)g(if)e(the)i(programmable)e(com-)630 -3196 y(pletion)c(co)s(de)i(had)f(generated)i(them)e(directly)g(from)g -(a)h(completion)f(sp)s(eci\014cation)f(with)630 3306 +3554 y(pletion)c(co)s(de)i(had)f(generated)i(them)e(directly)g(from)g +(a)h(completion)f(sp)s(eci\014cation)f(with)630 3664 y(the)g(same)h(\015ags.)40 b(If)29 b Fq(w)m(ord)j Ft(is)c(sp)s (eci\014ed,)g(only)g(those)i(completions)e(matc)m(hing)h -Fq(w)m(ord)k Ft(will)630 3415 y(b)s(e)d(displa)m(y)m(ed.)630 -3553 y(The)24 b(return)g(v)-5 b(alue)24 b(is)g(true)g(unless)f(an)i(in) +Fq(w)m(ord)k Ft(will)630 3773 y(b)s(e)d(displa)m(y)m(ed.)630 +3911 y(The)24 b(return)g(v)-5 b(alue)24 b(is)g(true)g(unless)f(an)i(in) m(v)-5 b(alid)22 b(option)i(is)g(supplied,)e(or)j(no)g(matc)m(hes)g(w)m -(ere)630 3663 y(generated.)150 3830 y Fs(complete)870 -3968 y(complete)46 b([-abcdefgjksuv])d([-o)k Fj(comp-option)11 +(ere)630 4021 y(generated.)150 4187 y Fs(complete)870 +4325 y(complete)46 b([-abcdefgjksuv])d([-o)k Fj(comp-option)11 b Fs(])44 b([-A)j Fj(action)11 b Fs(])45 b([-G)i Fj(glob-)870 -4077 y(pat)11 b Fs(])46 b([-W)h Fj(wordlist)11 b Fs(])870 -4187 y([-P)47 b Fj(prefix)11 b Fs(])45 b([-S)i Fj(suffix)11 +4435 y(pat)11 b Fs(])46 b([-W)h Fj(wordlist)11 b Fs(])870 +4544 y([-P)47 b Fj(prefix)11 b Fs(])45 b([-S)i Fj(suffix)11 b Fs(])45 b([-X)i Fj(filterpat)11 b Fs(])45 b([-F)i Fj(function)11 -b Fs(])870 4297 y([-C)47 b Fj(command)11 b Fs(])45 b -Fj(name)57 b Fs([)p Fj(name)g Fs(...)o(])870 4406 y(complete)46 -b(-pr)g([)p Fj(name)57 b Fs(...])630 4544 y Ft(Sp)s(ecify)32 +b Fs(])870 4654 y([-C)47 b Fj(command)11 b Fs(])45 b +Fj(name)57 b Fs([)p Fj(name)g Fs(...)o(])870 4764 y(complete)46 +b(-pr)g([)p Fj(name)57 b Fs(...])630 4902 y Ft(Sp)s(ecify)32 b(ho)m(w)i(argumen)m(ts)h(to)f(eac)m(h)i Fq(name)j Ft(should)32 b(b)s(e)h(completed.)52 b(If)33 b(the)i(`)p Fs(-p)p Ft(')e(option)630 -4654 y(is)c(supplied,)d(or)k(if)f(no)g(options)g(are)h(supplied,)d +5011 y(is)c(supplied,)d(or)k(if)f(no)g(options)g(are)h(supplied,)d (existing)h(completion)h(sp)s(eci\014cations)g(are)630 -4763 y(prin)m(ted)42 b(in)h(a)h(w)m(a)m(y)h(that)f(allo)m(ws)f(them)h +5121 y(prin)m(ted)42 b(in)h(a)h(w)m(a)m(y)h(that)f(allo)m(ws)f(them)h (to)g(b)s(e)g(reused)f(as)h(input.)79 b(The)43 b(`)p -Fs(-r)p Ft(')g(option)630 4873 y(remo)m(v)m(es)29 b(a)f(completion)f +Fs(-r)p Ft(')g(option)630 5230 y(remo)m(v)m(es)29 b(a)f(completion)f (sp)s(eci\014cation)f(for)i(eac)m(h)g Fq(name)p Ft(,)h(or,)f(if)f(no)g -Fq(name)5 b Ft(s)28 b(are)g(supplied,)630 4983 y(all)h(completion)h(sp) -s(eci\014cations.)630 5121 y(The)f(pro)s(cess)g(of)h(applying)e(these)i -(completion)e(sp)s(eci\014cations)h(when)f(w)m(ord)i(completion)630 -5230 y(is)k(attempted)i(is)e(describ)s(ed)f(ab)s(o)m(v)m(e)k(\(see)f -(Section)f(8.6)h([Programmable)f(Completion],)630 5340 -y(page)c(103\).)p eop +Fq(name)5 b Ft(s)28 b(are)g(supplied,)630 5340 y(all)h(completion)h(sp) +s(eci\014cations.)p eop %%Page: 106 112 106 111 bop 150 -116 a Ft(106)2527 b(Bash)31 b(Reference)g(Man)m(ual) -630 299 y(Other)41 b(options,)k(if)40 b(sp)s(eci\014ed,)j(ha)m(v)m(e)g -(the)f(follo)m(wing)f(meanings.)74 b(The)41 b(argumen)m(ts)h(to)630 -408 y(the)e(`)p Fs(-G)p Ft(',)j(`)p Fs(-W)p Ft(',)g(and)d(`)p -Fs(-X)p Ft(')g(options)f(\(and,)k(if)c(necessary)-8 b(,)44 -b(the)c(`)p Fs(-P)p Ft(')h(and)e(`)p Fs(-S)p Ft(')h(options\))630 -518 y(should)29 b(b)s(e)i(quoted)g(to)h(protect)g(them)f(from)g -(expansion)f(b)s(efore)h(the)g Fs(complete)e Ft(builtin)630 -628 y(is)g(in)m(v)m(ok)m(ed.)630 782 y Fs(-o)h Fj(comp-option)1110 -892 y Ft(The)c Fq(comp-option)h Ft(con)m(trols)g(sev)m(eral)h(asp)s -(ects)f(of)g(the)g(compsp)s(ec's)g(b)s(eha)m(v-)1110 -1002 y(ior)f(b)s(ey)m(ond)g(the)g(simple)f(generation)i(of)f -(completions.)39 b Fq(comp-option)26 b Ft(ma)m(y)1110 -1111 y(b)s(e)k(one)g(of:)1110 1266 y Fs(bashdefault)1590 -1375 y Ft(P)m(erform)d(the)h(rest)f(of)h(the)g(default)e(Bash)i -(completions)e(if)h(the)1590 1485 y(compsp)s(ec)j(generates)i(no)e -(matc)m(hes.)1110 1640 y Fs(default)144 b Ft(Use)22 b(Readline's)e -(default)h(\014lename)g(completion)f(if)h(the)h(comp-)1590 -1749 y(sp)s(ec)30 b(generates)i(no)e(matc)m(hes.)1110 -1904 y Fs(dirnames)96 b Ft(P)m(erform)46 b(directory)f(name)i -(completion)e(if)g(the)h(compsp)s(ec)1590 2014 y(generates)32 -b(no)e(matc)m(hes.)1110 2168 y Fs(filenames)1590 2278 +630 299 y(The)e(pro)s(cess)g(of)h(applying)e(these)i(completion)e(sp)s +(eci\014cations)h(when)f(w)m(ord)i(completion)630 408 +y(is)k(attempted)i(is)e(describ)s(ed)f(ab)s(o)m(v)m(e)k(\(see)f +(Section)f(8.6)h([Programmable)f(Completion],)630 518 +y(page)c(103\).)630 652 y(Other)41 b(options,)k(if)40 +b(sp)s(eci\014ed,)j(ha)m(v)m(e)g(the)f(follo)m(wing)f(meanings.)74 +b(The)41 b(argumen)m(ts)h(to)630 762 y(the)e(`)p Fs(-G)p +Ft(',)j(`)p Fs(-W)p Ft(',)g(and)d(`)p Fs(-X)p Ft(')g(options)f(\(and,)k +(if)c(necessary)-8 b(,)44 b(the)c(`)p Fs(-P)p Ft(')h(and)e(`)p +Fs(-S)p Ft(')h(options\))630 872 y(should)29 b(b)s(e)i(quoted)g(to)h +(protect)g(them)f(from)g(expansion)f(b)s(efore)h(the)g +Fs(complete)e Ft(builtin)630 981 y(is)g(in)m(v)m(ok)m(ed.)630 +1140 y Fs(-o)h Fj(comp-option)1110 1250 y Ft(The)c Fq(comp-option)h +Ft(con)m(trols)g(sev)m(eral)h(asp)s(ects)f(of)g(the)g(compsp)s(ec's)g +(b)s(eha)m(v-)1110 1359 y(ior)f(b)s(ey)m(ond)g(the)g(simple)f +(generation)i(of)f(completions.)39 b Fq(comp-option)26 +b Ft(ma)m(y)1110 1469 y(b)s(e)k(one)g(of:)1110 1628 y +Fs(bashdefault)1590 1738 y Ft(P)m(erform)d(the)h(rest)f(of)h(the)g +(default)e(Bash)i(completions)e(if)h(the)1590 1847 y(compsp)s(ec)j +(generates)i(no)e(matc)m(hes.)1110 2006 y Fs(default)144 +b Ft(Use)22 b(Readline's)e(default)h(\014lename)g(completion)f(if)h +(the)h(comp-)1590 2116 y(sp)s(ec)30 b(generates)i(no)e(matc)m(hes.)1110 +2275 y Fs(dirnames)96 b Ft(P)m(erform)46 b(directory)f(name)i +(completion)e(if)g(the)h(compsp)s(ec)1590 2385 y(generates)32 +b(no)e(matc)m(hes.)1110 2544 y Fs(filenames)1590 2653 y Ft(T)-8 b(ell)38 b(Readline)f(that)j(the)f(compsp)s(ec)f(generates)j -(\014lenames,)1590 2388 y(so)29 b(it)g(can)g(p)s(erform)f(an)m(y)h +(\014lenames,)1590 2763 y(so)29 b(it)g(can)g(p)s(erform)f(an)m(y)h (\014lename-sp)s(eci\014c)f(pro)s(cessing)f(\(lik)m(e)1590 -2497 y(adding)h(a)i(slash)e(to)i(directory)f(names)g(or)g(suppressing)e -(trail-)1590 2607 y(ing)37 b(spaces\).)66 b(This)36 b(option)i(is)f(in) -m(tended)g(to)i(b)s(e)f(used)f(with)1590 2716 y(shell)29 +2872 y(adding)h(a)i(slash)e(to)i(directory)f(names)g(or)g(suppressing)e +(trail-)1590 2982 y(ing)37 b(spaces\).)66 b(This)36 b(option)i(is)f(in) +m(tended)g(to)i(b)s(e)f(used)f(with)1590 3092 y(shell)29 b(functions)g(sp)s(eci\014ed)f(with)h(`)p Fs(-F)p Ft('.)1110 -2871 y Fs(nospace)144 b Ft(T)-8 b(ell)38 b(Readline)g(not)i(to)g(app)s -(end)d(a)j(space)g(\(the)f(default\))g(to)1590 2981 y(w)m(ords)30 -b(completed)g(at)h(the)g(end)f(of)g(the)h(line.)630 3135 -y Fs(-A)f Fj(action)1110 3245 y Ft(The)25 b Fq(action)g +3251 y Fs(nospace)144 b Ft(T)-8 b(ell)38 b(Readline)g(not)i(to)g(app)s +(end)d(a)j(space)g(\(the)f(default\))g(to)1590 3360 y(w)m(ords)30 +b(completed)g(at)h(the)g(end)f(of)g(the)h(line.)630 3519 +y Fs(-A)f Fj(action)1110 3629 y Ft(The)25 b Fq(action)g Ft(ma)m(y)h(b)s(e)e(one)h(of)h(the)f(follo)m(wing)f(to)h(generate)i(a)e -(list)f(of)h(p)s(ossible)1110 3354 y(completions:)1110 -3509 y Fs(alias)240 b Ft(Alias)29 b(names.)41 b(Ma)m(y)31 +(list)f(of)h(p)s(ossible)1110 3739 y(completions:)1110 +3898 y Fs(alias)240 b Ft(Alias)29 b(names.)41 b(Ma)m(y)31 b(also)g(b)s(e)f(sp)s(eci\014ed)e(as)j(`)p Fs(-a)p Ft('.)1110 -3664 y Fs(arrayvar)96 b Ft(Arra)m(y)31 b(v)-5 b(ariable)29 -b(names.)1110 3819 y Fs(binding)144 b Ft(Readline)28 +4057 y Fs(arrayvar)96 b Ft(Arra)m(y)31 b(v)-5 b(ariable)29 +b(names.)1110 4216 y Fs(binding)144 b Ft(Readline)28 b(k)m(ey)h(binding)d(names)j(\(see)h(Section)e(8.4)i([Bindable)1590 -3928 y(Readline)f(Commands],)h(page)h(95\).)1110 4083 +4325 y(Readline)f(Commands],)h(page)h(95\).)1110 4484 y Fs(builtin)144 b Ft(Names)21 b(of)g(shell)d(builtin)g(commands.)37 -b(Ma)m(y)21 b(also)g(b)s(e)f(sp)s(eci\014ed)1590 4193 -y(as)31 b(`)p Fs(-b)p Ft('.)1110 4347 y Fs(command)144 +b(Ma)m(y)21 b(also)g(b)s(e)f(sp)s(eci\014ed)1590 4594 +y(as)31 b(`)p Fs(-b)p Ft('.)1110 4753 y Fs(command)144 b Ft(Command)29 b(names.)41 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s -(eci\014ed)e(as)j(`)p Fs(-c)p Ft('.)1110 4502 y Fs(directory)1590 -4612 y Ft(Directory)g(names.)40 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s -(eci\014ed)f(as)h(`)p Fs(-d)p Ft('.)1110 4766 y Fs(disabled)96 +(eci\014ed)e(as)j(`)p Fs(-c)p Ft('.)1110 4912 y Fs(directory)1590 +5022 y Ft(Directory)g(names.)40 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s +(eci\014ed)f(as)h(`)p Fs(-d)p Ft('.)1110 5181 y Fs(disabled)96 b Ft(Names)31 b(of)g(disabled)d(shell)g(builtins.)1110 -4921 y Fs(enabled)144 b Ft(Names)31 b(of)g(enabled)e(shell)f(builtins.) -1110 5076 y Fs(export)192 b Ft(Names)34 b(of)f(exp)s(orted)f(shell)f(v) --5 b(ariables.)47 b(Ma)m(y)35 b(also)d(b)s(e)h(sp)s(eci-)1590 -5185 y(\014ed)d(as)g(`)p Fs(-e)p Ft('.)1110 5340 y Fs(file)288 -b Ft(File)30 b(names.)40 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s(eci\014ed)e -(as)j(`)p Fs(-f)p Ft('.)p eop +5340 y Fs(enabled)144 b Ft(Names)31 b(of)g(enabled)e(shell)f(builtins.) +p eop %%Page: 107 113 107 112 bop 150 -116 a Ft(Chapter)30 b(8:)41 b(Command)29 -b(Line)h(Editing)2060 b(107)1110 299 y Fs(function)96 -b Ft(Names)31 b(of)g(shell)d(functions.)1110 451 y Fs(group)240 -b Ft(Group)30 b(names.)40 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s(eci\014ed)f -(as)h(`)p Fs(-g)p Ft('.)1110 603 y Fs(helptopic)1590 -713 y Ft(Help)36 b(topics)g(as)h(accepted)h(b)m(y)e(the)h -Fs(help)f Ft(builtin)d(\(see)k(Sec-)1590 822 y(tion)30 -b(4.2)h([Bash)g(Builtins],)d(page)j(39\).)1110 975 y -Fs(hostname)96 b Ft(Hostnames,)89 b(as)76 b(tak)m(en)h(from)f(the)g -(\014le)g(sp)s(eci\014ed)e(b)m(y)1590 1084 y(the)55 b -Fs(HOSTFILE)e Ft(shell)h(v)-5 b(ariable)54 b(\(see)i(Section)f(5.2)i -([Bash)1590 1194 y(V)-8 b(ariables],)30 b(page)h(55\).)1110 -1346 y Fs(job)336 b Ft(Job)31 b(names,)h(if)f(job)g(con)m(trol)h(is)f -(activ)m(e.)45 b(Ma)m(y)33 b(also)f(b)s(e)f(sp)s(eci-)1590 -1456 y(\014ed)f(as)g(`)p Fs(-j)p Ft('.)1110 1608 y Fs(keyword)144 -b Ft(Shell)28 b(reserv)m(ed)j(w)m(ords.)40 b(Ma)m(y)32 -b(also)e(b)s(e)g(sp)s(eci\014ed)e(as)j(`)p Fs(-k)p Ft('.)1110 -1760 y Fs(running)144 b Ft(Names)31 b(of)g(running)c(jobs,)j(if)g(job)g -(con)m(trol)g(is)g(activ)m(e.)1110 1912 y Fs(service)144 -b Ft(Service)30 b(names.)41 b(Ma)m(y)31 b(also)f(b)s(e)g(sp)s -(eci\014ed)f(as)h(`)p Fs(-s)p Ft('.)1110 2064 y Fs(setopt)192 -b Ft(V)-8 b(alid)32 b(argumen)m(ts)h(for)f(the)h(`)p -Fs(-o)p Ft(')g(option)f(to)i(the)f Fs(set)e Ft(builtin)1590 -2174 y(\(see)g(Section)g(4.3)g([The)f(Set)h(Builtin],)d(page)j(50\).) -1110 2326 y Fs(shopt)240 b Ft(Shell)38 b(option)h(names)h(as)g +b(Line)h(Editing)2060 b(107)1110 299 y Fs(export)192 +b Ft(Names)34 b(of)f(exp)s(orted)f(shell)f(v)-5 b(ariables.)47 +b(Ma)m(y)35 b(also)d(b)s(e)h(sp)s(eci-)1590 408 y(\014ed)d(as)g(`)p +Fs(-e)p Ft('.)1110 558 y Fs(file)288 b Ft(File)30 b(names.)40 +b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s(eci\014ed)e(as)j(`)p +Fs(-f)p Ft('.)1110 708 y Fs(function)96 b Ft(Names)31 +b(of)g(shell)d(functions.)1110 858 y Fs(group)240 b Ft(Group)30 +b(names.)40 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s(eci\014ed)f(as)h(`)p +Fs(-g)p Ft('.)1110 1008 y Fs(helptopic)1590 1118 y Ft(Help)36 +b(topics)g(as)h(accepted)h(b)m(y)e(the)h Fs(help)f Ft(builtin)d(\(see)k +(Sec-)1590 1228 y(tion)30 b(4.2)h([Bash)g(Builtins],)d(page)j(39\).) +1110 1377 y Fs(hostname)96 b Ft(Hostnames,)89 b(as)76 +b(tak)m(en)h(from)f(the)g(\014le)g(sp)s(eci\014ed)e(b)m(y)1590 +1487 y(the)55 b Fs(HOSTFILE)e Ft(shell)h(v)-5 b(ariable)54 +b(\(see)i(Section)f(5.2)i([Bash)1590 1597 y(V)-8 b(ariables],)30 +b(page)h(55\).)1110 1747 y Fs(job)336 b Ft(Job)31 b(names,)h(if)f(job)g +(con)m(trol)h(is)f(activ)m(e.)45 b(Ma)m(y)33 b(also)f(b)s(e)f(sp)s +(eci-)1590 1856 y(\014ed)f(as)g(`)p Fs(-j)p Ft('.)1110 +2006 y Fs(keyword)144 b Ft(Shell)28 b(reserv)m(ed)j(w)m(ords.)40 +b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s(eci\014ed)e(as)j(`)p +Fs(-k)p Ft('.)1110 2156 y Fs(running)144 b Ft(Names)31 +b(of)g(running)c(jobs,)j(if)g(job)g(con)m(trol)g(is)g(activ)m(e.)1110 +2306 y Fs(service)144 b Ft(Service)30 b(names.)41 b(Ma)m(y)31 +b(also)f(b)s(e)g(sp)s(eci\014ed)f(as)h(`)p Fs(-s)p Ft('.)1110 +2456 y Fs(setopt)192 b Ft(V)-8 b(alid)32 b(argumen)m(ts)h(for)f(the)h +(`)p Fs(-o)p Ft(')g(option)f(to)i(the)f Fs(set)e Ft(builtin)1590 +2566 y(\(see)g(Section)g(4.3)g([The)f(Set)h(Builtin],)d(page)j(50\).) +1110 2716 y Fs(shopt)240 b Ft(Shell)38 b(option)h(names)h(as)g (accepted)i(b)m(y)e(the)g Fs(shopt)e Ft(builtin)1590 -2436 y(\(see)31 b(Section)g(4.2)g([Bash)g(Builtins],)d(page)j(39\).) -1110 2588 y Fs(signal)192 b Ft(Signal)29 b(names.)1110 -2740 y Fs(stopped)144 b Ft(Names)31 b(of)g(stopp)s(ed)e(jobs,)h(if)f -(job)h(con)m(trol)h(is)f(activ)m(e.)1110 2892 y Fs(user)288 +2825 y(\(see)31 b(Section)g(4.2)g([Bash)g(Builtins],)d(page)j(39\).) +1110 2975 y Fs(signal)192 b Ft(Signal)29 b(names.)1110 +3125 y Fs(stopped)144 b Ft(Names)31 b(of)g(stopp)s(ed)e(jobs,)h(if)f +(job)h(con)m(trol)h(is)f(activ)m(e.)1110 3275 y Fs(user)288 b Ft(User)30 b(names.)41 b(Ma)m(y)32 b(also)e(b)s(e)g(sp)s(eci\014ed)e -(as)j(`)p Fs(-u)p Ft('.)1110 3045 y Fs(variable)96 b +(as)j(`)p Fs(-u)p Ft('.)1110 3425 y Fs(variable)96 b Ft(Names)36 b(of)g(all)e(shell)g(v)-5 b(ariables.)54 b(Ma)m(y)37 b(also)e(b)s(e)g(sp)s(eci\014ed)f(as)1590 -3154 y(`)p Fs(-v)p Ft('.)630 3306 y Fs(-G)c Fj(globpat)1110 -3416 y Ft(The)39 b(\014lename)g(expansion)g(pattern)h -Fq(globpat)i Ft(is)d(expanded)g(to)h(generate)1110 3526 -y(the)31 b(p)s(ossible)c(completions.)630 3678 y Fs(-W)j -Fj(wordlist)1110 3787 y Ft(The)24 b Fq(w)m(ordlist)i +3535 y(`)p Fs(-v)p Ft('.)630 3685 y Fs(-G)c Fj(globpat)1110 +3794 y Ft(The)39 b(\014lename)g(expansion)g(pattern)h +Fq(globpat)i Ft(is)d(expanded)g(to)h(generate)1110 3904 +y(the)31 b(p)s(ossible)c(completions.)630 4054 y Fs(-W)j +Fj(wordlist)1110 4163 y Ft(The)24 b Fq(w)m(ordlist)i Ft(is)e(split)f(using)g(the)i(c)m(haracters)i(in)c(the)j -Fs(IFS)e Ft(sp)s(ecial)f(v)-5 b(ariable)1110 3897 y(as)36 +Fs(IFS)e Ft(sp)s(ecial)f(v)-5 b(ariable)1110 4273 y(as)36 b(delimiters,)f(and)h(eac)m(h)h(resultan)m(t)f(w)m(ord)f(is)g -(expanded.)57 b(The)35 b(p)s(ossible)1110 4007 y(completions)29 +(expanded.)57 b(The)35 b(p)s(ossible)1110 4383 y(completions)29 b(are)g(the)h(mem)m(b)s(ers)f(of)g(the)h(resultan)m(t)f(list)f(whic)m -(h)g(matc)m(h)j(the)1110 4116 y(w)m(ord)f(b)s(eing)f(completed.)630 -4268 y Fs(-C)h Fj(command)1110 4378 y Fq(command)35 b +(h)g(matc)m(h)j(the)1110 4492 y(w)m(ord)f(b)s(eing)f(completed.)630 +4642 y Fs(-C)h Fj(command)1110 4752 y Fq(command)35 b Ft(is)d(executed)h(in)d(a)j(subshell)c(en)m(vironmen)m(t,)j(and)g(its)f -(output)h(is)1110 4488 y(used)e(as)g(the)h(p)s(ossible)d(completions.) -630 4640 y Fs(-F)i Fj(function)1110 4749 y Ft(The)25 +(output)h(is)1110 4861 y(used)e(as)g(the)h(p)s(ossible)d(completions.) +630 5011 y Fs(-F)i Fj(function)1110 5121 y Ft(The)25 b(shell)g(function)f Fq(function)h Ft(is)g(executed)i(in)d(the)j -(curren)m(t)e(shell)g(en)m(viron-)1110 4859 y(men)m(t.)40 +(curren)m(t)e(shell)g(en)m(viron-)1110 5230 y(men)m(t.)40 b(When)25 b(it)g(\014nishes,)f(the)i(p)s(ossible)d(completions)h(are)i -(retriev)m(ed)f(from)1110 4969 y(the)31 b(v)-5 b(alue)29 -b(of)i(the)g Fs(COMPREPLY)c Ft(arra)m(y)k(v)-5 b(ariable.)630 -5121 y Fs(-X)30 b Fj(filterpat)1110 5230 y Fq(\014lterpat)c -Ft(is)e(a)h(pattern)g(as)f(used)g(for)h(\014lename)f(expansion.)37 -b(It)25 b(is)f(applied)e(to)1110 5340 y(the)30 b(list)d(of)j(p)s -(ossible)d(completions)h(generated)j(b)m(y)e(the)g(preceding)g(options) -p eop +(retriev)m(ed)f(from)1110 5340 y(the)31 b(v)-5 b(alue)29 +b(of)i(the)g Fs(COMPREPLY)c Ft(arra)m(y)k(v)-5 b(ariable.)p +eop %%Page: 108 114 108 113 bop 150 -116 a Ft(108)2527 b(Bash)31 b(Reference)g(Man)m(ual) -1110 299 y(and)c(argumen)m(ts,)i(and)e(eac)m(h)i(completion)e(matc)m -(hing)h Fq(\014lterpat)h Ft(is)e(remo)m(v)m(ed)1110 408 +630 299 y Fs(-X)f Fj(filterpat)1110 408 y Fq(\014lterpat)c +Ft(is)e(a)h(pattern)g(as)f(used)g(for)h(\014lename)f(expansion.)37 +b(It)25 b(is)f(applied)e(to)1110 518 y(the)30 b(list)d(of)j(p)s +(ossible)d(completions)h(generated)j(b)m(y)e(the)g(preceding)g(options) +1110 628 y(and)e(argumen)m(ts,)i(and)e(eac)m(h)i(completion)e(matc)m +(hing)h Fq(\014lterpat)h Ft(is)e(remo)m(v)m(ed)1110 737 y(from)j(the)h(list.)40 b(A)30 b(leading)g(`)p Fs(!)p Ft(')g(in)f Fq(\014lterpat)j Ft(negates)g(the)f(pattern;)g(in)e(this) -1110 518 y(case,)j(an)m(y)e(completion)g(not)h(matc)m(hing)f -Fq(\014lterpat)i Ft(is)d(remo)m(v)m(ed.)630 677 y Fs(-P)h -Fj(prefix)1110 787 y Fq(pre\014x)39 b Ft(is)33 b(added)g(at)i(the)f(b)s -(eginning)d(of)k(eac)m(h)g(p)s(ossible)c(completion)i(after)1110 -897 y(all)c(other)i(options)f(ha)m(v)m(e)h(b)s(een)f(applied.)630 -1056 y Fs(-S)g Fj(suffix)1110 1166 y Fq(su\016x)c Ft(is)19 +1110 847 y(case,)j(an)m(y)e(completion)g(not)h(matc)m(hing)f +Fq(\014lterpat)i Ft(is)d(remo)m(v)m(ed.)630 1006 y Fs(-P)h +Fj(prefix)1110 1116 y Fq(pre\014x)39 b Ft(is)33 b(added)g(at)i(the)f(b) +s(eginning)d(of)k(eac)m(h)g(p)s(ossible)c(completion)i(after)1110 +1225 y(all)c(other)i(options)f(ha)m(v)m(e)h(b)s(een)f(applied.)630 +1385 y Fs(-S)g Fj(suffix)1110 1494 y Fq(su\016x)c Ft(is)19 b(app)s(ended)g(to)i(eac)m(h)h(p)s(ossible)c(completion)i(after)h(all)e -(other)i(options)1110 1275 y(ha)m(v)m(e)32 b(b)s(een)d(applied.)630 -1435 y(The)35 b(return)g(v)-5 b(alue)36 b(is)f(true)g(unless)g(an)g(in) +(other)i(options)1110 1604 y(ha)m(v)m(e)32 b(b)s(een)d(applied.)630 +1763 y(The)35 b(return)g(v)-5 b(alue)36 b(is)f(true)g(unless)g(an)g(in) m(v)-5 b(alid)34 b(option)h(is)g(supplied,)f(an)i(option)g(other)630 -1544 y(than)31 b(`)p Fs(-p)p Ft(')g(or)g(`)p Fs(-r)p +1873 y(than)31 b(`)p Fs(-p)p Ft(')g(or)g(`)p Fs(-r)p Ft(')g(is)f(supplied)e(without)i(a)h Fq(name)37 b Ft(argumen)m(t,)32 -b(an)f(attempt)h(is)e(made)h(to)630 1654 y(remo)m(v)m(e)h(a)e +b(an)f(attempt)h(is)e(made)h(to)630 1983 y(remo)m(v)m(e)h(a)e (completion)g(sp)s(eci\014cation)f(for)h(a)h Fq(name)k Ft(for)30 b(whic)m(h)f(no)h(sp)s(eci\014cation)f(exists,)630 -1763 y(or)h(an)h(error)f(o)s(ccurs)g(adding)f(a)h(completion)g(sp)s +2092 y(or)h(an)h(error)f(o)s(ccurs)g(adding)f(a)h(completion)g(sp)s (eci\014cation.)p eop %%Page: 109 115 109 114 bop 150 -116 a Ft(Chapter)30 b(9:)41 b(Using)29 @@ -12744,7 +12751,7 @@ y Fe(accept-line)28 b(\(Newline)g(or)e(Return\))12 b Fc(.)h(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)37 b Fb(95)150 946 y Fe(alias-expand-line)29 b(\(\))13 b Fc(.)g(.)g(.)f(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) -39 b Fb(102)150 1257 y Fr(B)150 1397 y Fe(backward-char)29 +39 b Fb(103)150 1257 y Fr(B)150 1397 y Fe(backward-char)29 b(\(C-b\))16 b Fc(.)d(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h (.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)41 b Fb(95)150 1495 y Fe(backward-delete-char)30 b(\(Rubout\))21 b Fc(.)13 @@ -12780,8 +12787,8 @@ b Fb(95)150 2931 y Fe(complete)27 b(\()528 2928 y Fg(h)p f(.)g(.)45 b Fb(99)150 3029 y Fe(complete-command)29 b(\(M-!\))10 b Fc(.)k(.)e(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)36 b Fb(100)150 3128 y Fe(complete-filename) -29 b(\(M-/\))10 b Fc(.)k(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) -h(.)f(.)g(.)h(.)f(.)g(.)h(.)35 b Fb(99)150 3226 y Fe(complete-hostname) +29 b(\(M-/\))9 b Fc(.)14 b(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)35 b Fb(100)150 3226 y Fe(complete-hostname) 29 b(\(M-@\))9 b Fc(.)14 b(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)35 b Fb(100)150 3325 y Fe (complete-into-braces)30 b(\(M-{\))24 b Fc(.)12 b(.)h(.)f(.)g(.)h(.)f @@ -12800,9 +12807,9 @@ b Fc(.)i(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) g(.)h(.)f(.)g(.)37 b Fb(98)150 4128 y Fr(D)150 4268 y Fe(delete-char)28 b(\(C-d\))20 b Fc(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) -44 b Fb(97)150 4366 y Fe(delete-char-or-list)30 b(\(\))11 -b Fc(.)i(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) -g(.)h(.)f(.)g(.)37 b Fb(99)150 4465 y Fe(delete-horizontal-space)31 +44 b Fb(97)150 4366 y Fe(delete-char-or-list)30 b(\(\))10 +b Fc(.)j(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)36 b Fb(100)150 4465 y Fe(delete-horizontal-space)31 b(\(\))24 b Fc(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)g(.)h(.)49 b Fb(98)150 4563 y Fe(digit-argument)29 b(\()p Fd(M-0)p Fe(,)e Fd(M-1)p Fe(,)f(...)g Fd(M--)p @@ -12830,7 +12837,7 @@ y Fg(h)p 1259 5284 V 1259 5340 a Ff(T)-6 b(AB)p 1259 (edit-and-execute-command)31 b(\(C-xC-e\))12 b Fc(.)i(.)f(.)f(.)g(.)h (.)f(.)g(.)39 b Fb(103)2025 819 y Fe(end-kbd-macro)28 b(\(C-x)f(\)\))19 b Fc(.)12 b(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g -(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 b Fb(100)2025 +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 b Fb(101)2025 909 y Fe(end-of-history)29 b(\(M->\))14 b Fc(.)f(.)g(.)f(.)g(.)h(.)f(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)40 b Fb(96)2025 998 y Fe(end-of-line)28 b(\(C-e\))20 b Fc(.)12 @@ -12864,7 +12871,7 @@ b(\(\))7 b Fc(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) g(.)h(.)f(.)g(.)33 b Fb(96)2025 3197 y Fr(I)2025 3317 y Fe(insert-comment)c(\(M-#\))13 b Fc(.)g(.)g(.)f(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)39 -b Fb(101)2025 3406 y Fe(insert-completions)29 b(\(M-*\))8 +b Fb(102)2025 3406 y Fe(insert-completions)29 b(\(M-*\))8 b Fc(.)14 b(.)f(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)h(.)f(.)34 b Fb(99)2025 3495 y Fe(insert-last-argument)c(\(M-.)c(or) g(M-_\))8 b Fc(.)14 b(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)34 @@ -12881,7 +12888,7 @@ b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)47 b Fb(98)2025 4396 y Fr(M)2025 4516 y Fe(magic-space)28 b(\(\))22 b Fc(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g -(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)48 b Fb(102)2025 +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)48 b Fb(103)2025 4605 y Fe(menu-complete)28 b(\(\))21 b Fc(.)12 b(.)g(.)h(.)f(.)g(.)h(.) f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h (.)f(.)g(.)46 b Fb(99)2025 4867 y Fr(N)2025 4987 y Fe(next-history)28 @@ -12898,78 +12905,80 @@ f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)40 b Fb(96)p eop %%Page: 146 152 146 151 bop 150 -116 a Ft(146)2527 b(Bash)31 b(Reference)g(Man)m(ual) -150 299 y Fr(O)150 422 y Fe(operate-and-get-next)f(\(C-o\))24 +150 299 y Fr(O)150 425 y Fe(operate-and-get-next)f(\(C-o\))24 b Fc(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)49 -b Fb(103)150 513 y Fe(overwrite-mode)29 b(\(\))19 b Fc(.)12 +b Fb(103)150 518 y Fe(overwrite-mode)29 b(\(\))19 b Fc(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h -(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)44 b Fb(97)150 772 y Fr(P)150 -895 y Fe(possible-command-completions)32 b(\(C-x)26 b(!\))15 -b Fc(.)e(.)g(.)f(.)g(.)41 b Fb(100)150 985 y Fe(possible-completions)30 -b(\(M-?\))25 b Fc(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) -g(.)g(.)h(.)49 b Fb(99)150 1076 y Fe(possible-filename-completions)32 -b(\(C-x)27 b(/\))14 b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 -1167 y Fe(possible-hostname-completions)32 b(\(C-x)27 -b(@\))14 b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 1257 y Fe +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)44 b Fb(97)150 786 y Fr(P)150 +913 y Fe(possible-command-completions)32 b(\(C-x)26 b(!\))15 +b Fc(.)e(.)g(.)f(.)g(.)41 b Fb(100)150 1005 y Fe(possible-completions) +30 b(\(M-?\))25 b Fc(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)49 b Fb(99)150 1097 y Fe(possible-filename-completions) +32 b(\(C-x)27 b(/\))14 b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 +1190 y Fe(possible-hostname-completions)32 b(\(C-x)27 +b(@\))14 b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 1282 y Fe (possible-username-completions)32 b(\(C-x)27 b(~\))14 -b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 1348 y Fe +b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 1374 y Fe (possible-variable-completions)32 b(\(C-x)27 b($\))14 -b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 1438 y Fe(prefix-meta)28 -b(\()646 1435 y Fg(h)p 671 1382 139 4 v 671 1438 a Ff(ESC)p -671 1454 V 804 1435 a Fg(i)834 1438 y Fe(\))19 b Fc(.)13 +b Fc(.)e(.)g(.)h(.)39 b Fb(100)150 1467 y Fe(prefix-meta)28 +b(\()646 1464 y Fg(h)p 671 1411 139 4 v 671 1467 a Ff(ESC)p +671 1482 V 804 1464 a Fg(i)834 1467 y Fe(\))19 b Fc(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f -(.)g(.)h(.)f(.)g(.)45 b Fb(101)150 1529 y Fe(previous-history)29 +(.)g(.)h(.)f(.)g(.)45 b Fb(101)150 1559 y Fe(previous-history)29 b(\(C-p\))11 b Fc(.)j(.)e(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f -(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)37 b Fb(96)150 1799 y -Fr(Q)150 1922 y Fe(quoted-insert)29 b(\(C-q)d(or)g(C-v\))20 +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)37 b Fb(96)150 1838 y +Fr(Q)150 1964 y Fe(quoted-insert)29 b(\(C-q)d(or)g(C-v\))20 b Fc(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g -(.)45 b Fb(97)150 2191 y Fr(R)150 2314 y Fe(re-read-init-file)29 +(.)45 b Fb(97)150 2243 y Fr(R)150 2369 y Fe(re-read-init-file)29 b(\(C-x)e(C-r\))10 b Fc(.)j(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h -(.)f(.)g(.)36 b Fb(101)150 2405 y Fe(redraw-current-line)30 +(.)f(.)g(.)36 b Fb(101)150 2462 y Fe(redraw-current-line)30 b(\(\))11 b Fc(.)i(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g -(.)h(.)f(.)g(.)h(.)f(.)g(.)37 b Fb(95)150 2496 y Fe +(.)h(.)f(.)g(.)h(.)f(.)g(.)37 b Fb(95)150 2554 y Fe (reverse-search-history)31 b(\(C-r\))22 b Fc(.)12 b(.)g(.)h(.)f(.)g(.)g -(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)46 b Fb(96)150 2586 y +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)46 b Fb(96)150 2646 y Fe(revert-line)28 b(\(M-r\))18 b Fc(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)43 -b Fb(101)2025 299 y Fr(S)2025 417 y Fe(self-insert)28 +b Fb(101)2025 299 y Fr(S)2025 415 y Fe(self-insert)28 b(\(a,)e(b,)g(A,)g(1,)g(!,)g(...)q(\))13 b Fc(.)f(.)h(.)f(.)g(.)h(.)f -(.)g(.)h(.)f(.)g(.)h(.)38 b Fb(97)2025 505 y Fe(set-mark)27 +(.)g(.)h(.)f(.)g(.)h(.)38 b Fb(97)2025 503 y Fe(set-mark)27 b(\(C-@\))c Fc(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)48 -b Fb(101)2025 593 y Fe(shell-expand-line)29 b(\(M-C-e\))d +b Fb(101)2025 590 y Fe(shell-expand-line)29 b(\(M-C-e\))d Fc(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)50 -b Fb(102)2025 681 y Fe(start-kbd-macro)29 b(\(C-x)d(\(\))16 +b Fb(102)2025 677 y Fe(start-kbd-macro)29 b(\(C-x)d(\(\))16 b Fc(.)d(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) -f(.)g(.)42 b Fb(100)2025 927 y Fr(T)2025 1045 y Fe(tilde-expand)28 +f(.)g(.)42 b Fb(100)2025 919 y Fr(T)2025 1036 y Fe(tilde-expand)28 b(\(M-&\))16 b Fc(.)e(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h (.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)42 b Fb(101)2025 -1133 y Fe(transpose-chars)29 b(\(C-t\))13 b Fc(.)g(.)f(.)h(.)f(.)g(.)h +1123 y Fe(transpose-chars)29 b(\(C-t\))13 b Fc(.)g(.)f(.)h(.)f(.)g(.)h (.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)39 -b Fb(97)2025 1221 y Fe(transpose-words)29 b(\(M-t\))13 +b Fb(97)2025 1210 y Fe(transpose-words)29 b(\(M-t\))13 b Fc(.)g(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) -g(.)h(.)f(.)g(.)g(.)39 b Fb(97)2025 1477 y Fr(U)2025 -1595 y Fe(undo)26 b(\(C-_)h(or)f(C-x)g(C-u\))14 b Fc(.)f(.)g(.)f(.)g(.) +g(.)h(.)f(.)g(.)g(.)39 b Fb(97)2025 1463 y Fr(U)2025 +1579 y Fe(undo)26 b(\(C-_)h(or)f(C-x)g(C-u\))14 b Fc(.)f(.)g(.)f(.)g(.) h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)40 -b Fb(101)2025 1683 y Fe(universal-argument)29 b(\(\))13 +b Fb(101)2025 1666 y Fe(universal-argument)29 b(\(\))13 b Fc(.)g(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) -g(.)h(.)f(.)g(.)g(.)39 b Fb(99)2025 1771 y Fe(unix-line-discard)29 +g(.)h(.)f(.)g(.)g(.)39 b Fb(99)2025 1754 y Fe(unix-filename-rubout)30 +b(\(\))10 b Fc(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)36 b Fb(98)2025 1841 y Fe(unix-line-discard)29 b(\(C-u\))10 b Fc(.)k(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g -(.)h(.)f(.)g(.)h(.)f(.)g(.)36 b Fb(98)2025 1860 y Fe(unix-word-rubout) +(.)h(.)f(.)g(.)h(.)f(.)g(.)36 b Fb(98)2025 1928 y Fe(unix-word-rubout) 29 b(\(C-w\))11 b Fc(.)j(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) -h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)37 b Fb(98)2025 1948 +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)37 b Fb(98)2025 2016 y Fe(upcase-word)28 b(\(M-u\))20 b Fc(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h -(.)44 b Fb(97)2025 2204 y Fr(Y)2025 2322 y Fe(yank)26 +(.)44 b Fb(97)2025 2268 y Fr(Y)2025 2384 y Fe(yank)26 b(\(C-y\))11 b Fc(.)i(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) -f(.)g(.)h(.)36 b Fb(98)2025 2410 y Fe(yank-last-arg)28 +f(.)g(.)h(.)36 b Fb(99)2025 2472 y Fe(yank-last-arg)28 b(\(M-.)f(or)f(M-_\))20 b Fc(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g -(.)h(.)f(.)g(.)g(.)h(.)f(.)45 b Fb(96)2025 2498 y Fe(yank-nth-arg)28 +(.)h(.)f(.)g(.)g(.)h(.)f(.)45 b Fb(96)2025 2559 y Fe(yank-nth-arg)28 b(\(M-C-y\))14 b Fc(.)g(.)f(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)40 b Fb(96)2025 -2586 y Fe(yank-pop)27 b(\(M-y\))d Fc(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f +2646 y Fe(yank-pop)27 b(\(M-y\))d Fc(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) -h(.)f(.)g(.)49 b Fb(98)p eop +h(.)f(.)g(.)49 b Fb(99)p eop %%Page: 147 153 147 152 bop 150 -116 a Ft(Concept)31 b(Index)2882 b(147)150 299 y Fo(Concept)52 b(Index)150 638 y Fr(A)150 754 y diff --git a/doc/bashref.toc b/doc/bashref.toc index f9ef9886d..958df9211 100644 --- a/doc/bashref.toc +++ b/doc/bashref.toc @@ -98,7 +98,7 @@ \subsecentry{Commands For Manipulating The History}{8}{4}{2}{95} \subsecentry{Commands For Changing Text}{8}{4}{3}{96} \subsecentry{Killing And Yanking}{8}{4}{4}{98} -\subsecentry{Specifying Numeric Arguments}{8}{4}{5}{98} +\subsecentry{Specifying Numeric Arguments}{8}{4}{5}{99} \subsecentry{Letting Readline Type For You}{8}{4}{6}{99} \subsecentry{Keyboard Macros}{8}{4}{7}{100} \subsecentry{Some Miscellaneous Commands}{8}{4}{8}{101} diff --git a/doc/builtins.ps b/doc/builtins.ps index 16c03581f..ee402cd16 100644 --- a/doc/builtins.ps +++ b/doc/builtins.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.18.1 -%%CreationDate: Sun Jan 25 21:10:35 2004 +%%CreationDate: Wed Jan 28 15:50:16 2004 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -189,11 +189,11 @@ setpacking %%IncludeResource: font Palatino-Italic %%IncludeResource: font Palatino-Bold grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 -def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron -/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef +def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron +/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef -/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O diff --git a/doc/rbash.ps b/doc/rbash.ps index 1610e591c..9f1067900 100644 --- a/doc/rbash.ps +++ b/doc/rbash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.18.1 -%%CreationDate: Sun Jan 25 21:10:36 2004 +%%CreationDate: Wed Jan 28 15:50:16 2004 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%DocumentSuppliedResources: procset grops 1.18 1 @@ -177,11 +177,11 @@ setpacking %%IncludeResource: font Times-Roman %%IncludeResource: font Times-Bold grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 -def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron -/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef +def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron +/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef -/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O diff --git a/doc/version.texi b/doc/version.texi index 9bdd14cd2..278de3dc1 100644 --- a/doc/version.texi +++ b/doc/version.texi @@ -4,7 +4,7 @@ Copyright (C) 1988-2004 Free Software Foundation, Inc. @set EDITION 3.0 @set VERSION 3.0-beta1 -@set UPDATED 24 January 2004 +@set UPDATED 28 January 2004 @set UPDATED-MONTH January 2004 -@set LASTCHANGE Sat Jan 24 13:17:53 EST 2004 +@set LASTCHANGE Wed Jan 28 15:50:08 EST 2004 diff --git a/lib/readline/complete.c b/lib/readline/complete.c index 8e41d8b88..d824c39e8 100644 --- a/lib/readline/complete.c +++ b/lib/readline/complete.c @@ -222,6 +222,11 @@ const char *rl_basic_quote_characters = "\"'"; rl_basic_word_break_characters. */ /*const*/ char *rl_completer_word_break_characters = (/*const*/ char *)NULL; +/* Hook function to allow an application to set the completion word + break characters before readline breaks up the line. Allows + position-dependent word break characters. */ +rl_cpvfunc_t *rl_completion_word_break_hook = (rl_cpvfunc_t *)NULL; + /* List of characters which can be used to quote a substring of the line. Completion occurs on the entire substring, and within the substring rl_completer_word_break_characters are treated as any other character, @@ -762,12 +767,18 @@ _rl_find_completion_word (fp, dp) int *fp, *dp; { int scan, end, found_quote, delimiter, pass_next, isbrk; - char quote_char; + char quote_char, *brkchars; end = rl_point; found_quote = delimiter = 0; quote_char = '\0'; + brkchars = 0; + if (rl_completion_word_break_hook) + brkchars = (*rl_completion_word_break_hook) (); + if (brkchars == 0) + brkchars = rl_completer_word_break_characters; + if (rl_completer_quote_characters) { /* We have a list of characters which can be used in pairs to @@ -839,7 +850,7 @@ _rl_find_completion_word (fp, dp) { scan = rl_line_buffer[rl_point]; - if (strchr (rl_completer_word_break_characters, scan) == 0) + if (strchr (brkchars, scan) == 0) continue; /* Call the application-specific function to tell us whether @@ -867,9 +878,9 @@ _rl_find_completion_word (fp, dp) if (rl_char_is_quoted_p) isbrk = (found_quote == 0 || (*rl_char_is_quoted_p) (rl_line_buffer, rl_point) == 0) && - strchr (rl_completer_word_break_characters, scan) != 0; + strchr (brkchars, scan) != 0; else - isbrk = strchr (rl_completer_word_break_characters, scan) != 0; + isbrk = strchr (brkchars, scan) != 0; if (isbrk) { diff --git a/lib/readline/doc/readline.3 b/lib/readline/doc/readline.3 index 6f0847a6e..560bbe72b 100644 --- a/lib/readline/doc/readline.3 +++ b/lib/readline/doc/readline.3 @@ -6,9 +6,9 @@ .\" Case Western Reserve University .\" chet@ins.CWRU.Edu .\" -.\" Last Change: Mon Jun 9 17:37:22 EDT 2003 +.\" Last Change: Wed Jan 28 15:43:53 EST 2004 .\" -.TH READLINE 3 "2003 December 9" "GNU Readline 5.0" +.TH READLINE 3 "2004 January 28" "GNU Readline 5.0" .\" .\" File Name macro. This used to be `.PN', for Path Name, .\" but Sun doesn't seem to like that very much. @@ -34,8 +34,8 @@ readline \- get a line from a user with editing \fBreadline\fP (\fIconst char *prompt\fP); .fi .SH COPYRIGHT -.if n Readline is Copyright (C) 1989\-2002 by the Free Software Foundation, Inc. -.if t Readline is Copyright \(co 1989\-2002 by the Free Software Foundation, Inc. +.if n Readline is Copyright (C) 1989\-2004 by the Free Software Foundation, Inc. +.if t Readline is Copyright \(co 1989\-2004 by the Free Software Foundation, Inc. .SH DESCRIPTION .LP .B readline @@ -797,6 +797,11 @@ Word boundaries are the same as those used by \fBbackward\-word\fP. Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. .TP +.B unix\-filename\-rubout +Kill the word behind point, using white space and the slash character +as the word boundaries. +The killed text is saved on the kill-ring. +.TP .B delete\-horizontal\-space (M\-\e) Delete all spaces and tabs around point. .TP diff --git a/lib/readline/doc/rltech.texi b/lib/readline/doc/rltech.texi index 510b1246d..af9bc530a 100644 --- a/lib/readline/doc/rltech.texi +++ b/lib/readline/doc/rltech.texi @@ -8,7 +8,7 @@ This document describes the GNU Readline Library, a utility for aiding in the consitency of user interface across discrete programs that need to provide a command line interface. -Copyright (C) 1988-2002 Free Software Foundation, Inc. +Copyright (C) 1988-2004 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -1676,6 +1676,15 @@ The list of characters that signal a break between words for @code{rl_basic_word_break_characters}. @end deftypevar +@deftypevar {rl_cpvfunc_t *} rl_completion_word_break_hook +If non-zero, this is the address of a function to call when Readline is +deciding where to separate words for word completion. It should return +a character string like @code{rl_completer_word_break_characters} to be +used to perform the current completion. The function may choose to set +@code{rl_completer_word_break_characters} itself. If the function +returns @code{NULL}, @code{rl_completer_word_break_characters} is used. +@end deftypevar + @deftypevar {const char *} rl_completer_quote_characters A list of characters which can be used to quote a substring of the line. Completion occurs on the entire substring, and within the substring diff --git a/lib/readline/doc/rluser.texi b/lib/readline/doc/rluser.texi index ead09e46c..ad2866f00 100644 --- a/lib/readline/doc/rluser.texi +++ b/lib/readline/doc/rluser.texi @@ -10,7 +10,7 @@ use these features. There is a document entitled "readline.texinfo" which contains both end-user and programmer documentation for the GNU Readline Library. -Copyright (C) 1988-2002 Free Software Foundation, Inc. +Copyright (C) 1988-2004 Free Software Foundation, Inc. Authored by Brian Fox and Chet Ramey. @@ -1126,6 +1126,11 @@ Word boundaries are the same as @code{backward-word}. Kill the word behind point, using white space as a word boundary. The killed text is saved on the kill-ring. +@item unix-filename-rubout () +Kill the word behind point, using white space and the slash character +as the word boundaries. +The killed text is saved on the kill-ring. + @item delete-horizontal-space () Delete all spaces and tabs around point. By default, this is unbound. diff --git a/lib/readline/doc/version.texi b/lib/readline/doc/version.texi index cc78d84a4..e8792cca1 100644 --- a/lib/readline/doc/version.texi +++ b/lib/readline/doc/version.texi @@ -4,7 +4,7 @@ Copyright (C) 1988-2004 Free Software Foundation, Inc. @set EDITION 5.0 @set VERSION 5.0 -@set UPDATED 15 January 2004 +@set UPDATED 28 January 2004 @set UPDATED-MONTH January 2003 -@set LASTCHANGE Thu Jan 15 09:05:10 EST 2004 +@set LASTCHANGE Wed Jan 28 15:46:54 EST 2004 diff --git a/lib/readline/funmap.c b/lib/readline/funmap.c index fe9a1da43..28c8cc67c 100644 --- a/lib/readline/funmap.c +++ b/lib/readline/funmap.c @@ -131,6 +131,7 @@ static FUNMAP default_funmap[] = { { "tty-status", rl_tty_status }, { "undo", rl_undo_command }, { "universal-argument", rl_universal_argument }, + { "unix-filename-rubout", rl_unix_filename_rubout }, { "unix-line-discard", rl_unix_line_discard }, { "unix-word-rubout", rl_unix_word_rubout }, { "upcase-word", rl_upcase_word }, diff --git a/lib/readline/kill.c b/lib/readline/kill.c index a616b920d..1d3254c32 100644 --- a/lib/readline/kill.c +++ b/lib/readline/kill.c @@ -339,6 +339,47 @@ rl_unix_word_rubout (count, key) if (rl_editing_mode == emacs_mode) rl_mark = rl_point; } + + return 0; +} + +/* This deletes one filename component in a Unix pathname. That is, it + deletes backward to directory separator (`/') or whitespace. */ +int +rl_unix_filename_rubout (count, key) + int count, key; +{ + int orig_point, c; + + if (rl_point == 0) + rl_ding (); + else + { + orig_point = rl_point; + if (count <= 0) + count = 1; + + while (count--) + { + c = rl_line_buffer[rl_point - 1]; + while (rl_point && (whitespace (c) || c == '/')) + { + rl_point--; + c = rl_line_buffer[rl_point - 1]; + } + + while (rl_point && (whitespace (c) == 0) && c != '/') + { + rl_point--; + c = rl_line_buffer[rl_point - 1]; + } + } + + rl_kill_text (orig_point, rl_point); + if (rl_editing_mode == emacs_mode) + rl_mark = rl_point; + } + return 0; } diff --git a/lib/readline/readline.h b/lib/readline/readline.h index f7994edbb..199ff3cb6 100644 --- a/lib/readline/readline.h +++ b/lib/readline/readline.h @@ -160,6 +160,7 @@ extern int rl_kill_line PARAMS((int, int)); extern int rl_backward_kill_line PARAMS((int, int)); extern int rl_kill_full_line PARAMS((int, int)); extern int rl_unix_word_rubout PARAMS((int, int)); +extern int rl_unix_filename_rubout PARAMS((int, int)); extern int rl_unix_line_discard PARAMS((int, int)); extern int rl_copy_region_to_kill PARAMS((int, int)); extern int rl_kill_region PARAMS((int, int)); @@ -614,6 +615,11 @@ extern const char *rl_basic_word_break_characters; rl_basic_word_break_characters. */ extern /*const*/ char *rl_completer_word_break_characters; +/* Hook function to allow an application to set the completion word + break characters before readline breaks up the line. Allows + position-dependent word break characters. */ +extern rl_cpvfunc_t *rl_completion_word_break_hook; + /* List of characters which can be used to quote a substring of the line. Completion occurs on the entire substring, and within the substring rl_completer_word_break_characters are treated as any other character, diff --git a/lib/readline/rltypedefs.h b/lib/readline/rltypedefs.h index f3280e9fc..862bdb8e4 100644 --- a/lib/readline/rltypedefs.h +++ b/lib/readline/rltypedefs.h @@ -1,6 +1,6 @@ /* rltypedefs.h -- Type declarations for readline functions. */ -/* Copyright (C) 2000 Free Software Foundation, Inc. +/* Copyright (C) 2000-2004 Free Software Foundation, Inc. This file is part of the GNU Readline Library, a library for reading lines of text with interactive input and history editing. @@ -79,6 +79,12 @@ typedef void rl_voidfunc_t PARAMS((void)); typedef void rl_vintfunc_t PARAMS((int)); typedef void rl_vcpfunc_t PARAMS((char *)); typedef void rl_vcppfunc_t PARAMS((char **)); + +typedef char *rl_cpvfunc_t PARAMS((void)); +typedef char *rl_cpifunc_t PARAMS((int)); +typedef char *rl_cpcpfunc_t PARAMS((char *)); +typedef char *rl_cpcppfunc_t PARAMS((char **)); + #endif /* _RL_FUNCTION_TYPEDEF */ #ifdef __cplusplus diff --git a/tests/RUN-ONE-TEST b/tests/RUN-ONE-TEST index 72ec06a2c..3efcf32d6 100755 --- a/tests/RUN-ONE-TEST +++ b/tests/RUN-ONE-TEST @@ -1,4 +1,4 @@ -BUILD_DIR=/usr/local/build/bash/bash-current +BUILD_DIR=/usr/local/build/chet/bash/bash-current THIS_SH=$BUILD_DIR/bash PATH=$PATH:$BUILD_DIR diff --git a/tests/run-execscript b/tests/run-execscript index 042880c8d..f97ab21b1 100644 --- a/tests/run-execscript +++ b/tests/run-execscript @@ -3,5 +3,7 @@ echo "warning: produce diff output." >&2 echo "warning: if the text of the error messages concerning \`notthere' or" >&2 echo "warning: \`/tmp/bash-notthere' not being found or \`/' being a directory" >&2 echo "warning: produce diff output, please do not consider this a test failure" >&2 +echo "warning: if diff output differing only in the location of the bash" >&2 +echo "warning: binary appears, please do not consider this a test failure" >&2 ${THIS_SH} ./execscript > /tmp/xx 2>&1 diff /tmp/xx exec.right && rm -f /tmp/xx