pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-07-01 01:20:00 +02:00
Code Issues Packages Projects Releases Wiki Activity

documentation updates

Browse Source
This commit is contained in:
Chet Ramey
2022-09-20 10:16:23 -04:00
parent b7b9d7c306
commit e9c75143a2
33 changed files with 1400 additions and 1716 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bashref.ps
+244 -244
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 2021.1 Copyright 2021 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Fri Aug 12 15:28:49 2022
%%CreationDate: Mon Sep 19 16:02:49 2022
%%Pages: 196
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
@@ -12,7 +12,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600
%DVIPSSource: TeX output 2022.08.12:1128
%DVIPSSource: TeX output 2022.09.19:1202
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7614,23 +7614,24 @@ ifelse
TeXDict begin 1 0 bop 150 1318 a Fv(Bash)64 b(Reference)j(Man)-5
b(ual)p 150 1385 3600 34 v 2361 1481 a Fu(Reference)31
b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(5.2,)g(for)f
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.2.)3367 1697 y(July)f(2022)150
4927 y Fs(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
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.2.)3118 1697 y(Septem)m(b)s(er)f
(2022)150 4927 y Fs(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 end
%%Page: 2 2
TeXDict begin 2 1 bop 150 4279 a Fu(This)35 b(text)h(is)g(a)g(brief)f
(description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.2,)c(29)f(July)f
(2022\).)150 4523 y(This)35 b(is)h(Edition)g(5.2,)j(last)d(up)s(dated)f
(29)i(July)e(2022,)k(of)d Fr(The)g(GNU)g(Bash)g(Reference)h(Man)m(ual)p
Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
b(5.2.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
y Fq(\015)f Fu(1988{2022)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8
b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h
(to)g(cop)m(y)-8 b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s
(cumen)m(t)f(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.2,)c(19)f(Septem)m(b)s
(er)f(2022\).)150 4523 y(This)e(is)h(Edition)f(5.2,)j(last)e(up)s
(dated)f(19)h(Septem)m(b)s(er)f(2022,)j(of)e Fr(The)f(GNU)i(Bash)e
(Reference)i(Man)m(ual)p Fu(,)150 4633 y(for)g Ft(Bash)p
Fu(,)g(V)-8 b(ersion)31 b(5.2.)150 4767 y(Cop)m(yrigh)m(t)602
4764 y(c)577 4767 y Fq(\015)f Fu(1988{2022)35 b(F)-8
b(ree)31 b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)390
4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h(to)g(cop)m(y)-8
b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s(cumen)m(t)f
(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
b(ree)27 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)26
b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion)390 5121 y(published)43
b(b)m(y)h(the)h(F)-8 b(ree)46 b(Soft)m(w)m(are)g(F)-8
@@ -10811,7 +10812,7 @@ TeXDict begin 37 42 bop 150 -116 a Fu(Chapter)30 b(3:)41
b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(37)630 299
y(`)p Ft([a-dx-z])p Fu(')36 b(is)i(t)m(ypically)i(not)e(equiv)-5
b(alen)m(t)39 b(to)g(`)p Ft([abcdxyz])p Fu(';)g(it)g(migh)m(t)f(b)s(e)f
(equiv)-5 b(alen)m(t)630 408 y(to)34 b(`)p Ft([aBbCcDdxXyYz])p
(equiv)-5 b(alen)m(t)630 408 y(to)34 b(`)p Ft([aBbCcDdxYyZz])p
Fu(',)c(for)j(example.)49 b(T)-8 b(o)33 b(obtain)h(the)f(traditional)h
(in)m(terpretation)h(of)630 518 y(ranges)e(in)f(brac)m(k)m(et)i
(expressions,)g(y)m(ou)f(can)g(force)g(the)g(use)f(of)h(the)g(C)f(lo)s
@@ -11673,9 +11674,9 @@ b Fu(do)s(es)31 b(not)g(con)m(tain)i(a)e(slash,)h(the)g
Ft(PATH)e Fu(v)-5 b(ariable)32 b(is)f(used)f(to)i(\014nd)630
4244 y Fr(\014lename)p Fu(,)38 b(but)e Fr(\014lename)41
b Fu(do)s(es)36 b(not)h(need)f(to)h(b)s(e)e(executable.)60
b(When)36 b(Bash)g(is)h(not)f(in)630 4354 y Fm(posix)25
b Fu(mo)s(de,)i(the)f(curren)m(t)g(directory)g(is)g(searc)m(hed)h(if)e
Fr(\014lename)32 b Fu(is)26 b(not)g(found)e(in)i Ft($PATH)p
b(When)36 b(Bash)g(is)h(not)f(in)630 4354 y Fm(posix)26
b Fu(mo)s(de,)i(it)g(searc)m(hes)g(the)f(curren)m(t)g(directory)g(if)h
Fr(\014lename)k Fu(is)27 b(not)h(found)d(in)i Ft($PATH)p
Fu(.)630 4463 y(If)39 b(an)m(y)h Fr(argumen)m(ts)j Fu(are)d(supplied,)h
(they)e(b)s(ecome)h(the)g(p)s(ositional)g(parameters)g(when)630
4573 y Fr(\014lename)i Fu(is)36 b(executed.)60 b(Otherwise)36
@@ -13448,16 +13449,15 @@ b(4.2.)630 1244 y Ft(direxpand)1110 1354 y Fu(If)k(set,)i(Bash)f
(replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g
(ex-)1110 1463 y(pansion)k(when)g(p)s(erforming)f(\014lename)i
(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 1573
y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38
b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 1682
y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630
1861 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s
(elling)g(correction)g(on)g(directory)g(names)f(during)1110
1970 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g
(initially)h(supplied)e(do)s(es)h(not)1110 2080 y(exist.)630
2258 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g
(\014lenames)g(b)s(eginning)f(with)h(a)g(`.')58 b(in)36
b(the)g(results)1110 2367 y(of)f(\014lename)f(expansion.)53
y(con)m(ten)m(ts)c(of)e(the)h(Readline)f(editing)h(bu\013er.)52
b(If)33 b(not)i(set,)h(Bash)e(attempts)1110 1682 y(to)d(preserv)m(e)g
(what)f(the)g(user)g(t)m(yp)s(ed.)630 1861 y Ft(dirspell)96
b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s(elling)g(correction)g(on)g
(directory)g(names)f(during)1110 1970 y(w)m(ord)36 b(completion)h(if)f
(the)g(directory)g(name)g(initially)h(supplied)e(do)s(es)h(not)1110
2080 y(exist.)630 2258 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e
(includes)g(\014lenames)g(b)s(eginning)f(with)h(a)g(`.')58
b(in)36 b(the)g(results)1110 2367 y(of)f(\014lename)f(expansion.)53
b(The)33 b(\014lenames)i(`)p Ft(.)p Fu(')f(and)g(`)p
Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 2477
y(matc)m(hed)31 b(explicitly)-8 b(,)33 b(ev)m(en)e(if)f
@@ -14130,40 +14130,39 @@ b(in)f(the)h(en)m(vironmen)m(t)g(when)e(the)i(shell)f(starts)h(with)f
(v)-5 b(alue)630 2466 y(`)p Ft(t)p Fu(',)36 b(it)f(assumes)f(that)h
(the)g(shell)f(is)h(running)e(in)h(an)g(Emacs)h(shell)g(bu\013er)e(and)
h(disables)630 2576 y(line)d(editing.)150 2734 y Ft(ENV)336
b Fu(Expanded)30 b(and)h(executed)h(similarlt)m(y)g(to)g
Ft(BASH_ENV)d Fu(\(see)k(Section)f(6.2)g([Bash)g(Startup)630
2844 y(Files],)39 b(page)e(93\))h(when)d(an)h(in)m(teractiv)m(e)j
(shell)d(is)h(in)m(v)m(ok)m(ed)g(in)f Fm(posix)g Fu(Mo)s(de)g(\(see)h
(Sec-)630 2953 y(tion)31 b(6.11)h([Bash)f(POSIX)e(Mo)s(de],)i(page)g
(106\).)150 3112 y Ft(EPOCHREALTIME)630 3221 y Fu(Eac)m(h)38
b(time)f(this)g(parameter)h(is)f(referenced,)i(it)f(expands)e(to)i(the)
f(n)m(um)m(b)s(er)f(of)h(seconds)630 3331 y(since)f(the)g(Unix)f(Ep)s
(o)s(c)m(h)g(as)h(a)g(\015oating)h(p)s(oin)m(t)f(v)-5
b(alue)36 b(with)f(micro-second)i(gran)m(ularit)m(y)630
3440 y(\(see)k(the)g(do)s(cumen)m(tation)h(for)e(the)h(C)f(library)g
(function)g Ft(time)g Fu(for)g(the)h(de\014nition)f(of)630
3550 y(Ep)s(o)s(c)m(h\).)82 b(Assignmen)m(ts)44 b(to)h
Ft(EPOCHREALTIME)c Fu(are)j(ignored.)83 b(If)43 b Ft(EPOCHREALTIME)e
Fu(is)630 3660 y(unset,)30 b(it)h(loses)g(its)g(sp)s(ecial)g(prop)s
(erties,)f(ev)m(en)h(if)f(it)h(is)g(subsequen)m(tly)f(reset.)150
3818 y Ft(EPOCHSECONDS)630 3927 y Fu(Eac)m(h)38 b(time)f(this)g
b Fu(Expanded)33 b(and)h(executed)i(similarly)f(to)g
Ft(BASH_ENV)d Fu(\(see)k(Section)f(6.2)h([Bash)f(Startup)630
2844 y(Files],)k(page)e(93\))h(when)d(an)h(in)m(teractiv)m(e)j(shell)d
(is)h(in)m(v)m(ok)m(ed)g(in)f Fm(posix)g Fu(Mo)s(de)g(\(see)h(Sec-)630
2953 y(tion)31 b(6.11)h([Bash)f(POSIX)e(Mo)s(de],)i(page)g(106\).)150
3112 y Ft(EPOCHREALTIME)630 3221 y Fu(Eac)m(h)38 b(time)f(this)g
(parameter)h(is)f(referenced,)i(it)f(expands)e(to)i(the)f(n)m(um)m(b)s
(er)f(of)h(seconds)630 4037 y(since)d(the)g(Unix)g(Ep)s(o)s(c)m(h)f
(\(see)i(the)f(do)s(cumen)m(tation)h(for)e(the)i(C)e(library)h
(function)f Ft(time)630 4147 y Fu(for)41 b(the)g(de\014nition)g(of)h
(Ep)s(o)s(c)m(h\).)73 b(Assignmen)m(ts)41 b(to)h Ft(EPOCHSECONDS)c
Fu(are)k(ignored.)73 b(If)630 4256 y Ft(EPOCHSECONDS)27
b Fu(is)j(unset,)g(it)g(loses)h(its)g(sp)s(ecial)f(prop)s(erties,)g(ev)
m(en)h(if)f(it)g(is)g(subsequen)m(tly)630 4366 y(reset.)150
4524 y Ft(EUID)288 b Fu(The)30 b(n)m(umeric)g(e\013ectiv)m(e)j(user)d
(id)g(of)g(the)h(curren)m(t)f(user.)40 b(This)30 b(v)-5
b(ariable)31 b(is)f(readonly)-8 b(.)150 4682 y Ft(EXECIGNORE)630
4792 y Fu(A)29 b(colon-separated)h(list)f(of)g(shell)g(patterns)f
(\(see)i(Section)f(3.5.8.1)i([P)m(attern)f(Matc)m(hing],)630
4902 y(page)j(36\))g(de\014ning)e(the)h(list)g(of)g(\014lenames)g(to)g
(b)s(e)g(ignored)g(b)m(y)f(command)h(searc)m(h)g(using)630
5011 y Ft(PATH)p Fu(.)k(Files)22 b(whose)f(full)g(pathnames)g(matc)m(h)
h(one)f(of)g(these)h(patterns)e(are)i(not)f(considered)630
(er)f(of)h(seconds)630 3331 y(since)f(the)g(Unix)f(Ep)s(o)s(c)m(h)g(as)
h(a)g(\015oating)h(p)s(oin)m(t)f(v)-5 b(alue)36 b(with)f(micro-second)i
(gran)m(ularit)m(y)630 3440 y(\(see)k(the)g(do)s(cumen)m(tation)h(for)e
(the)h(C)f(library)g(function)g Ft(time)g Fu(for)g(the)h(de\014nition)f
(of)630 3550 y(Ep)s(o)s(c)m(h\).)82 b(Assignmen)m(ts)44
b(to)h Ft(EPOCHREALTIME)c Fu(are)j(ignored.)83 b(If)43
b Ft(EPOCHREALTIME)e Fu(is)630 3660 y(unset,)30 b(it)h(loses)g(its)g
(sp)s(ecial)g(prop)s(erties,)f(ev)m(en)h(if)f(it)h(is)g(subsequen)m
(tly)f(reset.)150 3818 y Ft(EPOCHSECONDS)630 3927 y Fu(Eac)m(h)38
b(time)f(this)g(parameter)h(is)f(referenced,)i(it)f(expands)e(to)i(the)
f(n)m(um)m(b)s(er)f(of)h(seconds)630 4037 y(since)d(the)g(Unix)g(Ep)s
(o)s(c)m(h)f(\(see)i(the)f(do)s(cumen)m(tation)h(for)e(the)i(C)e
(library)h(function)f Ft(time)630 4147 y Fu(for)41 b(the)g
(de\014nition)g(of)h(Ep)s(o)s(c)m(h\).)73 b(Assignmen)m(ts)41
b(to)h Ft(EPOCHSECONDS)c Fu(are)k(ignored.)73 b(If)630
4256 y Ft(EPOCHSECONDS)27 b Fu(is)j(unset,)g(it)g(loses)h(its)g(sp)s
(ecial)f(prop)s(erties,)g(ev)m(en)h(if)f(it)g(is)g(subsequen)m(tly)630
4366 y(reset.)150 4524 y Ft(EUID)288 b Fu(The)30 b(n)m(umeric)g
(e\013ectiv)m(e)j(user)d(id)g(of)g(the)h(curren)m(t)f(user.)40
b(This)30 b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150
4682 y Ft(EXECIGNORE)630 4792 y Fu(A)29 b(colon-separated)h(list)f(of)g
(shell)g(patterns)f(\(see)i(Section)f(3.5.8.1)i([P)m(attern)f(Matc)m
(hing],)630 4902 y(page)j(36\))g(de\014ning)e(the)h(list)g(of)g
(\014lenames)g(to)g(b)s(e)g(ignored)g(b)m(y)f(command)h(searc)m(h)g
(using)630 5011 y Ft(PATH)p Fu(.)k(Files)22 b(whose)f(full)g(pathnames)
g(matc)m(h)h(one)f(of)g(these)h(patterns)e(are)i(not)f(considered)630
5121 y(executable)j(\014les)e(for)g(the)h(purp)s(oses)d(of)j
(completion)h(and)d(command)i(execution)g(via)g Ft(PATH)630
5230 y Fu(lo)s(okup.)56 b(This)35 b(do)s(es)g(not)h(a\013ect)i(the)d(b)
@@ -16009,25 +16008,26 @@ b(Non-in)m(teractiv)m(e)34 b(shells)c(exit)h(if)g(a)f(parameter)h
b(v)-5 b(ariable)32 b(indirection)f(is)g(a)m(v)-5 b(ailable,)34
b(it)d(ma)m(y)h(not)f(b)s(e)g(applied)g(to)g(the)h(`)p
Ft(#)p Fu(')f(and)f(`)p Ft(?)p Fu(')h(sp)s(ecial)330
1979 y(parameters.)154 2113 y(33.)61 b(When)28 b(expanding)g(the)g(`)p
Ft(*)p Fu(')g(sp)s(ecial)h(parameter)f(in)g(a)h(pattern)f(con)m(text)i
(where)e(the)g(expansion)g(is)330 2223 y(double-quoted)i(do)s(es)g(not)
h(treat)h(the)e Ft($*)g Fu(as)h(if)f(it)h(w)m(ere)g(double-quoted.)154
2357 y(34.)61 b(Assignmen)m(t)23 b(statemen)m(ts)h(preceding)e
Fm(posix)f Fu(sp)s(ecial)i(builtins)f(p)s(ersist)g(in)f(the)i(shell)f
(en)m(vironmen)m(t)330 2466 y(after)31 b(the)f(builtin)g(completes.)154
2600 y(35.)61 b(The)31 b Ft(command)e Fu(builtin)i(do)s(es)g(not)h
(prev)m(en)m(t)f(builtins)g(that)h(tak)m(e)h(assignmen)m(t)f(statemen)m
(ts)h(as)f(ar-)330 2710 y(gumen)m(ts)40 b(from)e(expanding)h(them)g(as)
h(assignmen)m(t)g(statemen)m(ts;)46 b(when)38 b(not)i(in)f
Fm(posix)f Fu(mo)s(de,)330 2819 y(assignmen)m(t)k(builtins)e(lose)h
(their)g(assignmen)m(t)h(statemen)m(t)h(expansion)d(prop)s(erties)g
(when)g(pre-)330 2929 y(ceded)31 b(b)m(y)f Ft(command)p
Fu(.)154 3063 y(36.)61 b(The)27 b Ft(bg)g Fu(builtin)g(uses)g(the)h
(required)f(format)h(to)g(describ)s(e)f(eac)m(h)i(job)e(placed)h(in)f
(the)h(bac)m(kground,)330 3173 y(whic)m(h)h(do)s(es)g(not)g(include)g
(an)g(indication)h(of)f(whether)f(the)h(job)g(is)g(the)h(curren)m(t)e
(or)h(previous)g(job.)154 3306 y(37.)61 b(The)23 b(output)f(of)i(`)p
1979 y(parameters.)154 2113 y(33.)61 b(Expanding)21 b(the)h(`)p
Ft(*)p Fu(')g(sp)s(ecial)h(parameter)f(in)g(a)g(pattern)h(con)m(text)g
(where)f(the)g(expansion)g(is)g(double-)330 2223 y(quoted)31
b(do)s(es)f(not)g(treat)i(the)e Ft($*)g Fu(as)h(if)f(it)h(w)m(ere)g
(double-quoted.)154 2357 y(34.)61 b(Assignmen)m(t)23
b(statemen)m(ts)h(preceding)e Fm(posix)f Fu(sp)s(ecial)i(builtins)f(p)s
(ersist)g(in)f(the)i(shell)f(en)m(vironmen)m(t)330 2466
y(after)31 b(the)f(builtin)g(completes.)154 2600 y(35.)61
b(The)31 b Ft(command)e Fu(builtin)i(do)s(es)g(not)h(prev)m(en)m(t)f
(builtins)g(that)h(tak)m(e)h(assignmen)m(t)f(statemen)m(ts)h(as)f(ar-)
330 2710 y(gumen)m(ts)40 b(from)e(expanding)h(them)g(as)h(assignmen)m
(t)g(statemen)m(ts;)46 b(when)38 b(not)i(in)f Fm(posix)f
Fu(mo)s(de,)330 2819 y(assignmen)m(t)k(builtins)e(lose)h(their)g
(assignmen)m(t)h(statemen)m(t)h(expansion)d(prop)s(erties)g(when)g
(pre-)330 2929 y(ceded)31 b(b)m(y)f Ft(command)p Fu(.)154
3063 y(36.)61 b(The)27 b Ft(bg)g Fu(builtin)g(uses)g(the)h(required)f
(format)h(to)g(describ)s(e)f(eac)m(h)i(job)e(placed)h(in)f(the)h(bac)m
(kground,)330 3173 y(whic)m(h)h(do)s(es)g(not)g(include)g(an)g
(indication)h(of)f(whether)f(the)h(job)g(is)g(the)h(curren)m(t)e(or)h
(previous)g(job.)154 3306 y(37.)61 b(The)23 b(output)f(of)i(`)p
Ft(kill)29 b(-l)p Fu(')23 b(prin)m(ts)f(all)i(the)g(signal)f(names)g
(on)g(a)h(single)g(line,)h(separated)e(b)m(y)g(spaces,)330
3416 y(without)30 b(the)h(`)p Ft(SIG)p Fu(')f(pre\014x.)154
@@ -16284,14 +16284,14 @@ b(in)36 b(later)h(v)m(ersions,)h(single)f(quotes)g(are)g(not)f(sp)s
(ecial)810 3497 y(within)30 b(double-quoted)g(w)m(ord)g(expansions)150
3656 y Ft(compat43)705 3791 y Fq(\017)60 b Fu(the)31
b(shell)g(do)s(es)g(not)g(prin)m(t)f(a)h(w)m(arning)g(message)h(if)f
(an)g(attempt)h(is)f(made)f(to)i(use)f(a)810 3900 y(quoted)22
b(comp)s(ound)f(assignmen)m(t)i(as)f(an)g(argumen)m(t)h(to)g(declare)g
(\(declare)g(-a)g(fo)s(o='\(1)810 4010 y(2\)'\).)42 b(Later)31
b(v)m(ersions)g(w)m(arn)f(that)h(this)f(usage)h(is)f(deprecated)705
4144 y Fq(\017)60 b Fu(w)m(ord)21 b(expansion)g(errors)g(are)h
(considered)f(non-fatal)h(errors)f(that)h(cause)g(the)f(curren)m(t)810
4254 y(command)k(to)g(fail,)i(ev)m(en)e(in)g(p)s(osix)f(mo)s(de)h
(\(the)g(default)g(b)s(eha)m(vior)g(is)g(to)g(mak)m(e)h(them)810
(an)g(attempt)h(is)f(made)f(to)i(use)f(a)810 3900 y(quoted)36
b(comp)s(ound)e(assignmen)m(t)i(as)g(an)g(argumen)m(t)g(to)g(declare)h
(\(e.g.,)i(declare)d(-a)810 4010 y(fo)s(o='\(1)31 b(2\)'\).)42
b(Later)31 b(v)m(ersions)g(w)m(arn)f(that)h(this)f(usage)h(is)g
(deprecated)705 4144 y Fq(\017)60 b Fu(w)m(ord)21 b(expansion)g(errors)
g(are)h(considered)f(non-fatal)h(errors)f(that)h(cause)g(the)f(curren)m
(t)810 4254 y(command)k(to)g(fail,)i(ev)m(en)e(in)g(p)s(osix)f(mo)s(de)
h(\(the)g(default)g(b)s(eha)m(vior)g(is)g(to)g(mak)m(e)h(them)810
4364 y(fatal)32 b(errors)d(that)i(cause)g(the)g(shell)f(to)i(exit\))705
4498 y Fq(\017)60 b Fu(when)37 b(executing)i(a)g(shell)f(function,)i
(the)f(lo)s(op)f(state)h(\(while/un)m(til/etc.\))68 b(is)38
@@ -16833,33 +16833,33 @@ h(c)m(haracter.)150 2108 y Ft(DEL)e Fu(or)i Ft(Backspace)630
(cursor.)150 2826 y Fj(C-_)e Fu(or)i Fj(C-x)e(C-u)630
2936 y Fu(Undo)k(the)h(last)g(editing)g(command.)50 b(Y)-8
b(ou)34 b(can)f(undo)g(all)h(the)f(w)m(a)m(y)i(bac)m(k)f(to)g(an)g
(empt)m(y)630 3045 y(line.)150 3215 y(\(Dep)s(ending)29
b(on)h(y)m(our)f(con\014guration,)i(the)e Ft(Backspace)e
Fu(k)m(ey)k(b)s(e)d(set)j(to)f(delete)h(the)e(c)m(haracter)i(to)g(the)
150 3324 y(left)37 b(of)f(the)h(cursor)e(and)h(the)g
Ft(DEL)g Fu(k)m(ey)h(set)f(to)h(delete)h(the)e(c)m(haracter)i
(underneath)d(the)h(cursor,)i(lik)m(e)150 3434 y Fj(C-d)p
Fu(,)30 b(rather)g(than)g(the)h(c)m(haracter)h(to)f(the)f(left)h(of)g
(the)f(cursor.\))150 3640 y Fk(8.2.2)63 b(Readline)40
b(Mo)m(v)m(emen)m(t)h(Commands)150 3787 y Fu(The)27 b(ab)s(o)m(v)m(e)i
(table)g(describ)s(es)e(the)g(most)i(basic)f(k)m(eystrok)m(es)h(that)f
(y)m(ou)g(need)g(in)f(order)g(to)i(do)e(editing)i(of)150
3897 y(the)k(input)f(line.)49 b(F)-8 b(or)34 b(y)m(our)f(con)m(v)m
(enience,)j(man)m(y)d(other)g(commands)f(ha)m(v)m(e)j(b)s(een)d(added)g
(in)h(addition)150 4006 y(to)j Fj(C-b)p Fu(,)f Fj(C-f)p
Fu(,)g Fj(C-d)p Fu(,)h(and)e Ft(DEL)p Fu(.)54 b(Here)35
b(are)g(some)h(commands)e(for)h(mo)m(ving)h(more)f(rapidly)f(ab)s(out)h
(the)150 4116 y(line.)150 4286 y Fj(C-a)336 b Fu(Mo)m(v)m(e)32
b(to)g(the)e(start)h(of)g(the)f(line.)150 4452 y Fj(C-e)336
b Fu(Mo)m(v)m(e)32 b(to)g(the)e(end)g(of)g(the)h(line.)150
4618 y Fj(M-f)336 b Fu(Mo)m(v)m(e)32 b(forw)m(ard)e(a)h(w)m(ord,)f
(where)g(a)h(w)m(ord)f(is)g(comp)s(osed)g(of)h(letters)h(and)d(digits.)
150 4785 y Fj(M-b)336 b Fu(Mo)m(v)m(e)32 b(bac)m(kw)m(ard)f(a)g(w)m
(ord.)150 4951 y Fj(C-l)336 b Fu(Clear)31 b(the)f(screen,)h(reprin)m
(ting)f(the)h(curren)m(t)f(line)h(at)g(the)f(top.)275
5121 y(Notice)c(ho)m(w)f Fj(C-f)e Fu(mo)m(v)m(es)j(forw)m(ard)e(a)h(c)m
(haracter,)j(while)d Fj(M-f)e Fu(mo)m(v)m(es)j(forw)m(ard)e(a)h(w)m
(ord.)39 b(It)24 b(is)h(a)g(lo)s(ose)150 5230 y(con)m(v)m(en)m(tion)32
(empt)m(y)630 3045 y(line.)150 3215 y(\(Dep)s(ending)c(on)g(y)m(our)g
(con\014guration,)h(the)f Ft(Backspace)d Fu(k)m(ey)k(migh)m(t)g(b)s(e)e
(set)i(to)g(delete)g(the)f(c)m(haracter)150 3324 y(to)h(the)f(left)h
(of)f(the)g(cursor)f(and)h(the)g Ft(DEL)f Fu(k)m(ey)i(set)g(to)f
(delete)i(the)e(c)m(haracter)h(underneath)e(the)h(cursor,)150
3434 y(lik)m(e)i Fj(C-d)p Fu(,)d(rather)i(than)f(the)g(c)m(haracter)i
(to)f(the)g(left)g(of)g(the)f(cursor.\))150 3640 y Fk(8.2.2)63
b(Readline)40 b(Mo)m(v)m(emen)m(t)h(Commands)150 3787
y Fu(The)27 b(ab)s(o)m(v)m(e)i(table)g(describ)s(es)e(the)g(most)i
(basic)f(k)m(eystrok)m(es)h(that)f(y)m(ou)g(need)g(in)f(order)g(to)i
(do)e(editing)i(of)150 3897 y(the)k(input)f(line.)49
b(F)-8 b(or)34 b(y)m(our)f(con)m(v)m(enience,)j(man)m(y)d(other)g
(commands)f(ha)m(v)m(e)j(b)s(een)d(added)g(in)h(addition)150
4006 y(to)j Fj(C-b)p Fu(,)f Fj(C-f)p Fu(,)g Fj(C-d)p
Fu(,)h(and)e Ft(DEL)p Fu(.)54 b(Here)35 b(are)g(some)h(commands)e(for)h
(mo)m(ving)h(more)f(rapidly)f(ab)s(out)h(the)150 4116
y(line.)150 4286 y Fj(C-a)336 b Fu(Mo)m(v)m(e)32 b(to)g(the)e(start)h
(of)g(the)f(line.)150 4452 y Fj(C-e)336 b Fu(Mo)m(v)m(e)32
b(to)g(the)e(end)g(of)g(the)h(line.)150 4618 y Fj(M-f)336
b Fu(Mo)m(v)m(e)32 b(forw)m(ard)e(a)h(w)m(ord,)f(where)g(a)h(w)m(ord)f
(is)g(comp)s(osed)g(of)h(letters)h(and)d(digits.)150
4785 y Fj(M-b)336 b Fu(Mo)m(v)m(e)32 b(bac)m(kw)m(ard)f(a)g(w)m(ord.)
150 4951 y Fj(C-l)336 b Fu(Clear)31 b(the)f(screen,)h(reprin)m(ting)f
(the)h(curren)m(t)f(line)h(at)g(the)f(top.)275 5121 y(Notice)c(ho)m(w)f
Fj(C-f)e Fu(mo)m(v)m(es)j(forw)m(ard)e(a)h(c)m(haracter,)j(while)d
Fj(M-f)e Fu(mo)m(v)m(es)j(forw)m(ard)e(a)h(w)m(ord.)39
b(It)24 b(is)h(a)g(lo)s(ose)150 5230 y(con)m(v)m(en)m(tion)32
b(that)f(con)m(trol)g(k)m(eystrok)m(es)h(op)s(erate)e(on)g(c)m
(haracters)h(while)f(meta)h(k)m(eystrok)m(es)h(op)s(erate)e(on)150
5340 y(w)m(ords.)p eop end
@@ -16893,14 +16893,14 @@ y Fj(M-d)336 b Fu(Kill)27 b(from)f(the)g(cursor)g(to)h(the)f(end)g(of)h
(the)f(curren)m(t)g(w)m(ord,)h(or,)h(if)e(b)s(et)m(w)m(een)h(w)m(ords,)
g(to)g(the)630 1946 y(end)j(of)g(the)h(next)f(w)m(ord.)41
b(W)-8 b(ord)30 b(b)s(oundaries)f(are)i(the)g(same)f(as)h(those)g(used)
f(b)m(y)g Fj(M-f)p Fu(.)150 2107 y Fj(M-DEL)240 b Fu(Kill)31
b(from)f(the)h(cursor)f(the)g(start)h(of)g(the)g(curren)m(t)f(w)m(ord,)
h(or,)f(if)h(b)s(et)m(w)m(een)g(w)m(ords,)f(to)i(the)630
2217 y(start)39 b(of)f(the)h(previous)f(w)m(ord.)64 b(W)-8
b(ord)39 b(b)s(oundaries)e(are)i(the)f(same)h(as)g(those)f(used)g(b)m
(y)630 2326 y Fj(M-b)p Fu(.)150 2487 y Fj(C-w)336 b Fu(Kill)35
b(from)g(the)g(cursor)f(to)i(the)f(previous)g(whitespace.)55
b(This)34 b(is)h(di\013eren)m(t)h(than)e Fj(M-DEL)630
f(b)m(y)g Fj(M-f)p Fu(.)150 2107 y Fj(M-DEL)240 b Fu(Kill)34
b(from)f(the)g(cursor)g(to)h(the)g(start)g(of)g(the)f(curren)m(t)g(w)m
(ord,)h(or,)h(if)e(b)s(et)m(w)m(een)h(w)m(ords,)g(to)630
2217 y(the)28 b(start)g(of)g(the)g(previous)f(w)m(ord.)39
b(W)-8 b(ord)28 b(b)s(oundaries)e(are)i(the)g(same)g(as)g(those)g(used)
f(b)m(y)630 2326 y Fj(M-b)p Fu(.)150 2487 y Fj(C-w)336
b Fu(Kill)35 b(from)g(the)g(cursor)f(to)i(the)f(previous)g(whitespace.)
55 b(This)34 b(is)h(di\013eren)m(t)h(than)e Fj(M-DEL)630
2597 y Fu(b)s(ecause)c(the)h(w)m(ord)f(b)s(oundaries)f(di\013er.)275
2759 y(Here)42 b(is)f(ho)m(w)h(to)g Fr(y)m(ank)47 b Fu(the)42
b(text)g(bac)m(k)h(in)m(to)f(the)g(line.)74 b(Y)-8 b(anking)43
@@ -17205,9 +17205,9 @@ b(will)e(b)s(e)f(inserted)h(in)m(to)h(the)g(line)f(as)g(if)g(they)h
Fu(.)38 b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)630
2052 y Ft(echo-control-characters)1110 2162 y Fu(When)f(set)h(to)g(`)p
Ft(on)p Fu(',)f(on)g(op)s(erating)h(systems)f(that)h(indicate)g(they)g
(supp)s(ort)1110 2271 y(it,)i(readline)e(ec)m(ho)s(es)i(a)f(c)m
(haracter)h(corresp)s(onding)d(to)j(a)f(signal)g(generated)1110
2381 y(from)e(the)g(k)m(eyb)s(oard.)41 b(The)30 b(default)g(is)h(`)p
(supp)s(ort)1110 2271 y(it,)e(Readline)g(ec)m(ho)s(es)g(a)f(c)m
(haracter)i(corresp)s(onding)d(to)i(a)f(signal)h(generated)1110
2381 y(from)h(the)g(k)m(eyb)s(oard.)41 b(The)30 b(default)g(is)h(`)p
Ft(on)p Fu('.)630 2527 y Ft(editing-mode)1110 2637 y
Fu(The)d Ft(editing-mode)e Fu(v)-5 b(ariable)29 b(con)m(trols)h(whic)m
(h)e(default)h(set)h(of)e(k)m(ey)i(bind-)1110 2746 y(ings)25
@@ -17435,9 +17435,9 @@ Ft(off)p Fu('.)630 2833 y Ft(revert-all-at-newline)1110
3052 y(returning)f(when)f Ft(accept-line)f Fu(is)j(executed.)41
b(By)29 b(default,)g(history)g(lines)1110 3162 y(ma)m(y)42
b(b)s(e)g(mo)s(di\014ed)e(and)h(retain)i(individual)e(undo)g(lists)h
(across)g(calls)h(to)1110 3271 y Ft(readline)p Fu(.)38
b(The)30 b(default)h(is)f(`)p Ft(off)p Fu('.)630 3450
y Ft(show-all-if-ambiguous)1110 3559 y Fu(This)f(alters)i(the)f
(across)g(calls)h(to)1110 3271 y Ft(readline\(\))p Fu(.)38
b(The)30 b(default)g(is)h(`)p Ft(off)p Fu('.)630 3450
y Ft(show-all-if-ambiguous)1110 3559 y Fu(This)e(alters)i(the)f
(default)g(b)s(eha)m(vior)g(of)g(the)h(completion)g(functions.)40
b(If)29 b(set)1110 3669 y(to)f(`)p Ft(on)p Fu(',)g(w)m(ords)f(whic)m(h)
g(ha)m(v)m(e)i(more)f(than)f(one)h(p)s(ossible)f(completion)h(cause)
@@ -17470,8 +17470,8 @@ b(Command)29 b(Line)i(Editing)2062 b(127)630 299 y Ft
Ft(on)p Fu(',)h(this)f(alters)g(the)g(default)g(completion)h(b)s(eha)m
(vior)f(when)f(in-)1110 518 y(serting)d(a)h(single)g(matc)m(h)f(in)m
(to)h(the)g(line.)40 b(It's)30 b(only)f(activ)m(e)i(when)d(p)s(erform-)
1110 628 y(ing)35 b(completion)h(in)e(the)h(middle)f(of)h(a)f(w)m(ord.)
53 b(If)35 b(enabled,)g(readline)g(do)s(es)1110 737 y(not)41
1110 628 y(ing)k(completion)i(in)e(the)g(middle)g(of)g(a)h(w)m(ord.)46
b(If)32 b(enabled,)g(Readline)h(do)s(es)1110 737 y(not)41
b(insert)f(c)m(haracters)i(from)e(the)h(completion)h(that)f(matc)m(h)g
(c)m(haracters)1110 847 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f(b)
s(eing)g(completed,)k(so)d(p)s(ortions)f(of)h(the)g(w)m(ord)1110
@@ -17537,10 +17537,10 @@ b(can)g(b)s(e)g(no)g(space)g(b)s(et)m(w)m(een)h(the)f(k)m(ey)h(name)g
b(The)40 b(name)h(of)630 4989 y(the)35 b(k)m(ey)g(can)g(b)s(e)f
(expressed)f(in)i(di\013eren)m(t)g(w)m(a)m(ys,)h(dep)s(ending)d(on)h
(what)h(y)m(ou)g(\014nd)e(most)630 5099 y(comfortable.)630
5230 y(In)i(addition)h(to)h(command)f(names,)i(readline)e(allo)m(ws)h
(k)m(eys)g(to)g(b)s(e)e(b)s(ound)f(to)j(a)f(string)630
5340 y(that)31 b(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g
(\(a)h Fr(macro)5 b Fu(\).)p eop end
5230 y(In)g(addition)h(to)g(command)g(names,)g(Readline)g(allo)m(ws)h
(k)m(eys)g(to)f(b)s(e)f(b)s(ound)f(to)i(a)g(string)630
5340 y(that)d(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g(\(a)
h Fr(macro)5 b Fu(\).)p eop end
%%Page: 128 134
TeXDict begin 128 133 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(128)630 299 y(The)42
@@ -18312,9 +18312,9 @@ b(the)e(last)h(k)m(eyb)s(oard)f(macro)h(de\014ned,)f(b)m(y)h(making)f
(the)g(c)m(haracters)i(in)e(the)630 518 y(macro)c(app)s(ear)f(as)g(if)h
(t)m(yp)s(ed)f(at)h(the)f(k)m(eyb)s(oard.)150 671 y Ft
(print-last-kbd-macro)25 b(\(\))630 780 y Fu(Prin)m(t)30
b(the)h(last)g(k)m(eb)s(oard)f(macro)h(de\014ned)e(in)i(a)f(format)h
(suitable)g(for)f(the)h Fr(inputrc)k Fu(\014le.)150 973
y Fk(8.4.8)63 b(Some)41 b(Miscellaneous)i(Commands)150
b(the)g(last)h(k)m(eyb)s(oard)f(macro)h(de\014ned)e(in)h(a)g(format)h
(suitable)g(for)f(the)g Fr(inputrc)35 b Fu(\014le.)150
973 y Fk(8.4.8)63 b(Some)41 b(Miscellaneous)i(Commands)150
1141 y Ft(re-read-init-file)26 b(\(C-x)j(C-r\))630 1251
y Fu(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of)f(the)g
Fr(inputrc)27 b Fu(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h(bindings)d
@@ -18352,12 +18352,12 @@ g(the)g(mark.)43 b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)i(is)f
4377 y Ft(character-search)26 b(\(C-]\))630 4487 y Fu(A)f(c)m(haracter)
h(is)f(read)g(and)f(p)s(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)g(the)f(next)g
(o)s(ccurrence)g(of)g(that)g(c)m(haracter.)630 4596 y(A)30
b(negativ)m(e)j(coun)m(t)e(searc)m(hes)g(for)f(previous)g(o)s
b(negativ)m(e)j(argumen)m(t)e(searc)m(hes)g(for)f(previous)g(o)s
(ccurrences.)150 4749 y Ft(character-search-backwar)o(d)24
b(\(M-C-]\))630 4859 y Fu(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s
(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)f(the)g(previous)f(o)s(ccurrence)h(of)
g(that)630 4968 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(coun)m(t)f
(searc)m(hes)h(for)e(subsequen)m(t)f(o)s(ccurrences.)150
g(that)630 4968 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(argumen)m(t)f
(searc)m(hes)g(for)g(subsequen)m(t)e(o)s(ccurrences.)150
5121 y Ft(skip-csi-sequence)d(\(\))630 5230 y Fu(Read)i(enough)f(c)m
(haracters)h(to)g(consume)f(a)h(m)m(ulti-k)m(ey)h(sequence)f(suc)m(h)f
(as)g(those)h(de\014ned)630 5340 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g
@@ -18368,9 +18368,9 @@ TeXDict begin 142 147 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(142)630 299 y(Indicator)37
b(\(CSI\),)f(usually)h(ESC-[.)59 b(If)36 b(this)g(sequence)h(is)g(b)s
(ound)d(to)k Ft("\\)p Fu(e[)p Ft(")p Fu(,)g(k)m(eys)f(pro-)630
408 y(ducing)31 b(suc)m(h)h(sequences)g(will)h(ha)m(v)m(e)g(no)f
(e\013ect)h(unless)e(explicitly)j(b)s(ound)c(to)i(a)h(readline)630
518 y(command,)f(instead)g(of)g(inserting)g(stra)m(y)h(c)m(haracters)g
408 y(ducing)29 b(suc)m(h)g(sequences)g(will)h(ha)m(v)m(e)h(no)e
(e\013ect)i(unless)d(explicitly)j(b)s(ound)d(to)i(a)f(Readline)630
518 y(command,)j(instead)g(of)g(inserting)g(stra)m(y)h(c)m(haracters)g
(in)m(to)g(the)f(editing)h(bu\013er.)44 b(This)31 b(is)630
628 y(un)m(b)s(ound)d(b)m(y)i(default,)h(but)f(usually)g(b)s(ound)e(to)
j(ESC-[.)150 792 y Ft(insert-comment)26 b(\(M-#\))630
@@ -19059,9 +19059,9 @@ Fu(option)j(tells)g(Readline)g(to)h(not)e(app)s(end)f(a)i(space)g(c)m
(haracter)h(to)f(the)150 3771 y(directory)c(name,)h(in)f(case)h(w)m(e)f
(w)m(an)m(t)h(to)f(app)s(end)f(to)h(it.)41 b(The)27 b
Ft(-o)j(bashdefault)25 b Fu(option)j(brings)f(in)h(the)150
3880 y(rest)h(of)f(the)h Ft(")p Fu(Bash)f(default)p Ft(")h
Fu(completions)g({)g(p)s(ossible)f(completion)i(that)f(Bash)f(adds)g
(to)h(the)g(default)150 3990 y(Readline)f(set.)40 b(These)28
3880 y(rest)e(of)g(the)g Ft(")p Fu(Bash)g(default)p Ft(")g
Fu(completions)h({)f(p)s(ossible)f(completions)i(that)g(Bash)f(adds)f
(to)i(the)f(default)150 3990 y(Readline)i(set.)40 b(These)28
b(include)f(things)g(lik)m(e)i(command)e(name)h(completion,)h(v)-5
b(ariable)28 b(completion)h(for)150 4100 y(w)m(ords)e(b)s(eginning)h
(with)f(`)p Ft($)p Fu(')h(or)g(`)p Ft(${)p Fu(',)h(completions)g(con)m
@@ -19292,124 +19292,124 @@ Fr(arg)8 b Fu(s)31 b(and)f(displa)m(y)h(the)f(result)h(on)1110
(in)g(the)g(history)g(list.)630 2606 y Ft(-s)384 b Fu(The)30
b Fr(arg)8 b Fu(s)30 b(are)h(added)f(to)h(the)f(end)g(of)h(the)f
(history)h(list)g(as)f(a)h(single)g(en)m(try)-8 b(.)630
2764 y(When)26 b(an)m(y)h(of)f(the)g Ft(-w)p Fu(,)h Ft(-r)p
Fu(,)g Ft(-a)p Fu(,)g(or)f Ft(-n)f Fu(options)i(is)f(used,)h(if)f
Fr(\014lename)32 b Fu(is)26 b(giv)m(en,)i(then)e(it)h(is)630
2873 y(used)h(as)g(the)h(history)f(\014le.)40 b(If)28
b(not,)i(then)e(the)g(v)-5 b(alue)29 b(of)g(the)g Ft(HISTFILE)d
Fu(v)-5 b(ariable)29 b(is)f(used.)630 3007 y(The)34 b(return)g(v)-5
b(alue)35 b(is)g(0)g(unless)f(an)h(in)m(v)-5 b(alid)35
b(option)g(is)g(encoun)m(tered,)h(an)f(error)f(o)s(ccurs)630
3117 y(while)h(reading)g(or)g(writing)f(the)h(history)g(\014le,)h(an)f
2764 y(If)35 b(a)h Fr(\014lename)41 b Fu(argumen)m(t)c(is)e(supplied)g
(when)g(an)m(y)h(of)g(the)g Ft(-w)p Fu(,)g Ft(-r)p Fu(,)h
Ft(-a)p Fu(,)g(or)e Ft(-n)h Fu(options)630 2873 y(is)j(used,)i(Bash)e
(uses)f Fr(\014lename)44 b Fu(as)c(the)f(history)g(\014le.)66
b(If)39 b(not,)i(then)e(the)g(v)-5 b(alue)40 b(of)f(the)630
2983 y Ft(HISTFILE)28 b Fu(v)-5 b(ariable)31 b(is)g(used.)630
3117 y(The)j(return)g(v)-5 b(alue)35 b(is)g(0)g(unless)f(an)h(in)m(v)-5
b(alid)35 b(option)g(is)g(encoun)m(tered,)h(an)f(error)f(o)s(ccurs)630
3226 y(while)h(reading)g(or)g(writing)f(the)h(history)g(\014le,)h(an)f
(in)m(v)-5 b(alid)36 b Fr(o\013set)h Fu(or)e(range)g(is)g(supplied)630
3226 y(as)c(an)g(argumen)m(t)g(to)h Ft(-d)p Fu(,)e(or)h(the)g(history)g
3336 y(as)c(an)g(argumen)m(t)g(to)h Ft(-d)p Fu(,)e(or)h(the)g(history)g
(expansion)f(supplied)g(as)h(an)g(argumen)m(t)g(to)h
Ft(-p)630 3336 y Fu(fails.)150 3575 y Fs(9.3)68 b(History)46
b(Expansion)150 3734 y Fu(The)f(History)h(library)e(pro)m(vides)i(a)f
Ft(-p)630 3445 y Fu(fails.)150 3684 y Fs(9.3)68 b(History)46
b(Expansion)150 3844 y Fu(The)f(History)h(library)e(pro)m(vides)i(a)f
(history)g(expansion)g(feature)h(that)g(is)f(similar)h(to)g(the)f
(history)150 3844 y(expansion)g(pro)m(vided)f(b)m(y)h
(history)150 3953 y(expansion)g(pro)m(vided)f(b)m(y)h
Ft(csh)p Fu(.)83 b(This)44 b(section)i(describ)s(es)e(the)h(syn)m(tax)h
(used)e(to)i(manipulate)f(the)150 3953 y(history)30 b(information.)275
4087 y(History)h(expansions)f(in)m(tro)s(duce)g(w)m(ords)g(from)g(the)h
(used)e(to)i(manipulate)f(the)150 4063 y(history)30 b(information.)275
4196 y(History)h(expansions)f(in)m(tro)s(duce)g(w)m(ords)g(from)g(the)h
(history)f(list)h(in)m(to)g(the)g(input)f(stream,)h(making)150
4196 y(it)g(easy)g(to)g(rep)s(eat)g(commands,)f(insert)g(the)h(argumen)
4306 y(it)g(easy)g(to)g(rep)s(eat)g(commands,)f(insert)g(the)h(argumen)
m(ts)f(to)h(a)g(previous)f(command)g(in)m(to)i(the)e(curren)m(t)150
4306 y(input)f(line,)i(or)g(\014x)f(errors)f(in)h(previous)g(commands)g
(quic)m(kly)-8 b(.)275 4439 y(History)24 b(expansion)f(is)h(p)s
4415 y(input)f(line,)i(or)g(\014x)f(errors)f(in)h(previous)g(commands)g
(quic)m(kly)-8 b(.)275 4549 y(History)24 b(expansion)f(is)h(p)s
(erformed)e(immediately)j(after)f(a)g(complete)h(line)f(is)g(read,)h(b)
s(efore)e(the)h(shell)150 4549 y(breaks)32 b(it)i(in)m(to)f(w)m(ords,)g
s(efore)e(the)h(shell)150 4659 y(breaks)32 b(it)i(in)m(to)f(w)m(ords,)g
(and)f(is)h(p)s(erformed)e(on)h(eac)m(h)i(line)f(individually)-8
b(.)48 b(Bash)33 b(attempts)g(to)h(inform)150 4659 y(the)d(history)f
b(.)48 b(Bash)33 b(attempts)g(to)h(inform)150 4768 y(the)d(history)f
(expansion)g(functions)g(ab)s(out)g(quoting)h(still)g(in)f(e\013ect)i
(from)e(previous)g(lines.)275 4792 y(History)37 b(expansion)f(tak)m(es)
(from)e(previous)g(lines.)275 4902 y(History)37 b(expansion)f(tak)m(es)
i(place)g(in)e(t)m(w)m(o)i(parts.)59 b(The)36 b(\014rst)g(is)h(to)g
(determine)g(whic)m(h)f(line)h(from)150 4902 y(the)42
(determine)g(whic)m(h)f(line)h(from)150 5011 y(the)42
b(history)f(list)h(should)e(b)s(e)h(used)f(during)g(substitution.)74
b(The)40 b(second)i(is)f(to)h(select)h(p)s(ortions)e(of)150
5011 y(that)31 b(line)g(for)f(inclusion)h(in)m(to)g(the)g(curren)m(t)f
5121 y(that)31 b(line)g(for)f(inclusion)h(in)m(to)g(the)g(curren)m(t)f
(one.)42 b(The)30 b(line)h(selected)h(from)e(the)h(history)f(is)h
(called)h(the)150 5121 y Fr(ev)m(en)m(t)p Fu(,)e(and)c(the)i(p)s
(called)h(the)150 5230 y Fr(ev)m(en)m(t)p Fu(,)e(and)c(the)i(p)s
(ortions)e(of)i(that)f(line)h(that)g(are)f(acted)i(up)s(on)c(are)j
(called)g Fr(w)m(ords)p Fu(.)39 b(V)-8 b(arious)28 b
Fr(mo)s(di\014ers)150 5230 y Fu(are)33 b(a)m(v)-5 b(ailable)36
Fr(mo)s(di\014ers)150 5340 y Fu(are)33 b(a)m(v)-5 b(ailable)36
b(to)d(manipulate)h(the)f(selected)h(w)m(ords.)48 b(The)32
b(line)i(is)f(brok)m(en)f(in)m(to)i(w)m(ords)f(in)f(the)i(same)150
5340 y(fashion)23 b(that)g(Bash)g(do)s(es,)h(so)f(that)h(sev)m(eral)g
(w)m(ords)e(surrounded)e(b)m(y)j(quotes)g(are)g(considered)g(one)g(w)m
(ord.)p eop end
b(line)i(is)f(brok)m(en)f(in)m(to)i(w)m(ords)f(in)f(the)i(same)p
eop end
%%Page: 155 161
TeXDict begin 155 160 bop 150 -116 a Fu(Chapter)30 b(9:)41
b(Using)30 b(History)h(In)m(teractiv)m(ely)1925 b(155)150
299 y(History)37 b(expansions)g(are)g(in)m(tro)s(duced)f(b)m(y)h(the)g
(app)s(earance)g(of)g(the)g(history)f(expansion)h(c)m(haracter,)150
408 y(whic)m(h)30 b(is)h(`)p Ft(!)p Fu(')f(b)m(y)g(default.)275
554 y(History)c(expansion)g(implemen)m(ts)h(shell-lik)m(e)h(quoting)f
(con)m(v)m(en)m(tions:)40 b(a)27 b(bac)m(kslash)g(can)f(b)s(e)g(used)f
(to)150 664 y(remo)m(v)m(e)h(the)e(sp)s(ecial)g(handling)g(for)g(the)g
(next)g(c)m(haracter;)k(single)d(quotes)g(enclose)g(v)m(erbatim)g
(sequences)150 774 y(of)k(c)m(haracters,)i(and)e(can)g(b)s(e)g(used)f
(to)i(inhibit)f(history)g(expansion;)g(and)g(c)m(haracters)i(enclosed)e
(within)150 883 y(double)h(quotes)i(ma)m(y)f(b)s(e)f(sub)5
b(ject)31 b(to)h(history)f(expansion,)g(since)g(bac)m(kslash)g(can)h
(escap)s(e)f(the)g(history)150 993 y(expansion)e(c)m(haracter,)j(but)d
(single)h(quotes)g(ma)m(y)h(not,)f(since)g(they)g(are)g(not)f(treated)i
(sp)s(ecially)f(within)150 1102 y(double)g(quotes.)275
1248 y(When)41 b(using)g(the)h(shell,)i(only)e(`)p Ft(\\)p
Fu(')g(and)e(`)p Ft(')p Fu(')i(ma)m(y)g(b)s(e)f(used)g(to)h(escap)s(e)g
(the)g(history)f(expansion)150 1358 y(c)m(haracter,)e(but)34
b(the)i(history)g(expansion)f(c)m(haracter)i(is)f(also)g(treated)h(as)e
(quoted)h(if)g(it)g(immediately)150 1468 y(precedes)30
299 y(fashion)23 b(that)g(Bash)g(do)s(es,)h(so)f(that)h(sev)m(eral)g(w)
m(ords)e(surrounded)e(b)m(y)j(quotes)g(are)g(considered)g(one)g(w)m
(ord.)150 408 y(History)37 b(expansions)g(are)g(in)m(tro)s(duced)f(b)m
(y)h(the)g(app)s(earance)g(of)g(the)g(history)f(expansion)h(c)m
(haracter,)150 518 y(whic)m(h)30 b(is)h(`)p Ft(!)p Fu(')f(b)m(y)g
(default.)275 655 y(History)c(expansion)g(implemen)m(ts)h(shell-lik)m
(e)h(quoting)f(con)m(v)m(en)m(tions:)40 b(a)27 b(bac)m(kslash)g(can)f
(b)s(e)g(used)f(to)150 764 y(remo)m(v)m(e)h(the)e(sp)s(ecial)g
(handling)g(for)g(the)g(next)g(c)m(haracter;)k(single)d(quotes)g
(enclose)g(v)m(erbatim)g(sequences)150 874 y(of)k(c)m(haracters,)i(and)
e(can)g(b)s(e)g(used)f(to)i(inhibit)f(history)g(expansion;)g(and)g(c)m
(haracters)i(enclosed)e(within)150 983 y(double)h(quotes)i(ma)m(y)f(b)s
(e)f(sub)5 b(ject)31 b(to)h(history)f(expansion,)g(since)g(bac)m
(kslash)g(can)h(escap)s(e)f(the)g(history)150 1093 y(expansion)e(c)m
(haracter,)j(but)d(single)h(quotes)g(ma)m(y)h(not,)f(since)g(they)g
(are)g(not)f(treated)i(sp)s(ecially)f(within)150 1202
y(double)g(quotes.)275 1339 y(When)41 b(using)g(the)h(shell,)i(only)e
(`)p Ft(\\)p Fu(')g(and)e(`)p Ft(')p Fu(')i(ma)m(y)g(b)s(e)f(used)g(to)
h(escap)s(e)g(the)g(history)f(expansion)150 1448 y(c)m(haracter,)e(but)
34 b(the)i(history)g(expansion)f(c)m(haracter)i(is)f(also)g(treated)h
(as)e(quoted)h(if)g(it)g(immediately)150 1558 y(precedes)30
b(the)h(closing)g(double)f(quote)h(in)f(a)h(double-quoted)g(string.)275
1614 y(Sev)m(eral)48 b(shell)g(options)h(settable)g(with)e(the)h
1695 y(Sev)m(eral)48 b(shell)g(options)h(settable)g(with)e(the)h
Ft(shopt)f Fu(builtin)g(\(see)i(Section)f(4.3.2)i([The)e(Shopt)150
1723 y(Builtin],)24 b(page)e(71\))h(ma)m(y)e(b)s(e)g(used)g(to)h
1804 y(Builtin],)24 b(page)e(71\))h(ma)m(y)e(b)s(e)g(used)g(to)h
(tailor)g(the)g(b)s(eha)m(vior)f(of)h(history)f(expansion.)37
b(If)21 b(the)h Ft(histverify)150 1833 y Fu(shell)35
b(If)21 b(the)h Ft(histverify)150 1914 y Fu(shell)35
b(option)f(is)h(enabled,)g(and)f(Readline)h(is)f(b)s(eing)g(used,)h
(history)g(substitutions)e(are)i(not)g(immedi-)150 1942
(history)g(substitutions)e(are)i(not)g(immedi-)150 2023
y(ately)i(passed)d(to)i(the)g(shell)f(parser.)55 b(Instead,)37
b(the)e(expanded)g(line)g(is)h(reloaded)g(in)m(to)g(the)f(Readline)150
2052 y(editing)29 b(bu\013er)f(for)h(further)e(mo)s(di\014cation.)41
2133 y(editing)29 b(bu\013er)f(for)h(further)e(mo)s(di\014cation.)41
b(If)28 b(Readline)h(is)g(b)s(eing)f(used,)h(and)f(the)h
Ft(histreedit)d Fu(shell)150 2161 y(option)e(is)g(enabled,)h(a)g
Ft(histreedit)d Fu(shell)150 2242 y(option)e(is)g(enabled,)h(a)g
(failed)f(history)g(expansion)g(will)g(b)s(e)f(reloaded)h(in)m(to)h
(the)f(Readline)g(editing)h(bu\013er)150 2271 y(for)31
(the)f(Readline)g(editing)h(bu\013er)150 2352 y(for)31
b(correction.)43 b(The)30 b Ft(-p)g Fu(option)h(to)h(the)f
Ft(history)e Fu(builtin)h(command)h(ma)m(y)g(b)s(e)f(used)g(to)i(see)f
(what)g(a)150 2381 y(history)25 b(expansion)g(will)g(do)g(b)s(efore)g
(what)g(a)150 2462 y(history)25 b(expansion)g(will)g(do)g(b)s(efore)g
(using)f(it.)40 b(The)24 b Ft(-s)h Fu(option)g(to)h(the)f
Ft(history)e Fu(builtin)i(ma)m(y)g(b)s(e)g(used)150 2490
Ft(history)e Fu(builtin)i(ma)m(y)g(b)s(e)g(used)150 2571
y(to)36 b(add)f(commands)g(to)h(the)g(end)f(of)g(the)h(history)f(list)i
(without)e(actually)i(executing)g(them,)g(so)e(that)150
2600 y(they)c(are)f(a)m(v)-5 b(ailable)33 b(for)d(subsequen)m(t)g
2681 y(they)c(are)f(a)m(v)-5 b(ailable)33 b(for)d(subsequen)m(t)g
(recall.)42 b(This)29 b(is)i(most)g(useful)e(in)h(conjunction)h(with)f
(Readline.)275 2746 y(The)j(shell)h(allo)m(ws)h(con)m(trol)h(of)e(the)g
(Readline.)275 2817 y(The)j(shell)h(allo)m(ws)h(con)m(trol)h(of)e(the)g
(v)-5 b(arious)34 b(c)m(haracters)h(used)f(b)m(y)f(the)h(history)g
(expansion)g(mec)m(h-)150 2855 y(anism)h(with)g(the)g
(expansion)g(mec)m(h-)150 2927 y(anism)h(with)g(the)g
Ft(histchars)d Fu(v)-5 b(ariable,)38 b(as)d(explained)g(ab)s(o)m(v)m(e)
i(\(see)f(Section)f(5.2)i([Bash)e(V)-8 b(ariables],)150
2965 y(page)32 b(78\).)44 b(The)31 b(shell)g(uses)g(the)g(history)g
3036 y(page)32 b(78\).)44 b(The)31 b(shell)g(uses)g(the)g(history)g
(commen)m(t)i(c)m(haracter)f(to)g(mark)f(history)g(timestamps)h(when)
150 3075 y(writing)e(the)h(history)f(\014le.)150 3285
y Fk(9.3.1)63 b(Ev)m(en)m(t)39 b(Designators)150 3432
150 3146 y(writing)e(the)h(history)f(\014le.)150 3347
y Fk(9.3.1)63 b(Ev)m(en)m(t)39 b(Designators)150 3494
y Fu(An)32 b(ev)m(en)m(t)j(designator)e(is)g(a)g(reference)g(to)h(a)f
(command)f(line)h(en)m(try)g(in)g(the)g(history)g(list.)48
b(Unless)33 b(the)150 3542 y(reference)e(is)f(absolute,)i(ev)m(en)m(ts)
b(Unless)33 b(the)150 3604 y(reference)e(is)f(absolute,)i(ev)m(en)m(ts)
f(are)g(relativ)m(e)i(to)e(the)f(curren)m(t)g(p)s(osition)h(in)f(the)h
(history)f(list.)150 3718 y Ft(!)432 b Fu(Start)34 b(a)f(history)h
(history)f(list.)150 3766 y Ft(!)432 b Fu(Start)34 b(a)f(history)h
(substitution,)g(except)g(when)f(follo)m(w)m(ed)i(b)m(y)e(a)h(space,)h
(tab,)f(the)g(end)f(of)630 3828 y(the)i(line,)g(`)p Ft(=)p
(tab,)f(the)g(end)f(of)630 3876 y(the)i(line,)g(`)p Ft(=)p
Fu(')g(or)f(`)p Ft(\()p Fu(')h(\(when)e(the)i Ft(extglob)d
Fu(shell)j(option)f(is)h(enabled)f(using)g(the)g Ft(shopt)630
3938 y Fu(builtin\).)150 4109 y Ft(!)p Fj(n)384 b Fu(Refer)30
b(to)i(command)e(line)g Fr(n)p Fu(.)150 4279 y Ft(!-)p
3985 y Fu(builtin\).)150 4147 y Ft(!)p Fj(n)384 b Fu(Refer)30
b(to)i(command)e(line)g Fr(n)p Fu(.)150 4308 y Ft(!-)p
Fj(n)336 b Fu(Refer)30 b(to)i(the)e(command)g Fr(n)g
Fu(lines)h(bac)m(k.)150 4450 y Ft(!!)384 b Fu(Refer)30
Fu(lines)h(bac)m(k.)150 4469 y Ft(!!)384 b Fu(Refer)30
b(to)i(the)e(previous)g(command.)40 b(This)30 b(is)g(a)h(synon)m(ym)f
(for)g(`)p Ft(!-1)p Fu('.)150 4621 y Ft(!)p Fj(string)144
(for)g(`)p Ft(!-1)p Fu('.)150 4631 y Ft(!)p Fj(string)144
b Fu(Refer)25 b(to)h(the)f(most)h(recen)m(t)g(command)f(preceding)g
(the)g(curren)m(t)g(p)s(osition)g(in)g(the)g(history)630
4731 y(list)31 b(starting)g(with)f Fr(string)p Fu(.)150
4740 y(list)31 b(starting)g(with)f Fr(string)p Fu(.)150
4902 y Ft(!?)p Fj(string)p Ft([?])630 5011 y Fu(Refer)25
b(to)h(the)f(most)h(recen)m(t)g(command)f(preceding)g(the)g(curren)m(t)
g(p)s(osition)g(in)g(the)g(history)630 5121 y(list)32
@@ -19517,12 +19517,12 @@ Fu(.)k(A)31 b(single)g(bac)m(kslash)g(will)g(quote)g(the)g(`)p
Ft(&)p Fu('.)41 b(If)31 b Fr(old)j Fu(is)c(n)m(ull,)h(it)g(is)g(set)g
(to)g(the)g(last)g Fr(old)630 2022 y Fu(substituted,)j(or,)g(if)f(no)g
(previous)g(history)g(substitutions)g(to)s(ok)h(place,)h(the)e(last)h
Fr(string)630 2132 y Fu(in)j(a)g(!?)p Fr(string)8 b Ft([?])37
b Fu(searc)m(h.)61 b(If)37 b Fr(new)45 b Fu(is)37 b(is)g(n)m(ull,)i
(eac)m(h)f(matc)m(hing)h Fr(old)h Fu(is)e(deleted.)61
b(The)630 2242 y(\014nal)30 b(delimiter)h(is)g(optional)g(if)f(it)h(is)
g(the)f(last)i(c)m(haracter)f(on)g(the)f(input)g(line.)150
2401 y Ft(&)432 b Fu(Rep)s(eat)31 b(the)f(previous)g(substitution.)150
Fr(string)630 2132 y Fu(in)d(a)g(!?)p Fr(string)8 b Ft([?])30
b Fu(searc)m(h.)44 b(If)31 b Fr(new)38 b Fu(is)31 b(n)m(ull,)h(eac)m(h)
g(matc)m(hing)g Fr(old)j Fu(is)c(deleted.)44 b(The)30
b(\014nal)630 2242 y(delimiter)h(is)g(optional)g(if)f(it)h(is)g(the)f
(last)h(c)m(haracter)h(on)f(the)f(input)g(line.)150 2401
y Ft(&)432 b Fu(Rep)s(eat)31 b(the)f(previous)g(substitution.)150
2560 y Ft(g)150 2670 y(a)432 b Fu(Cause)38 b(c)m(hanges)i(to)f(b)s(e)f
(applied)h(o)m(v)m(er)h(the)f(en)m(tire)g(ev)m(en)m(t)h(line.)66
b(Used)39 b(in)f(conjunction)630 2780 y(with)30 b(`)p
@@ -19675,9 +19675,9 @@ Ft(configure)c Fu(where)i(the)h(source)g(\014les)g(are.)78
b Ft(configure)150 4145 y Fu(automatically)33 b(c)m(hec)m(ks)f(for)e
(the)h(source)f(co)s(de)h(in)f(the)h(directory)f(that)h
Ft(configure)d Fu(is)j(in)f(and)f(in)h(`..'.)275 4280
y(If)20 b(y)m(ou)h(ha)m(v)m(e)i(to)e(use)g(a)g Ft(make)f
Fu(that)i(do)s(es)e(not)i(supp)s(orts)d(the)i Ft(VPATH)e
Fu(v)-5 b(ariable,)24 b(y)m(ou)e(can)f(compile)h(Bash)150
y(If)22 b(y)m(ou)i(ha)m(v)m(e)g(to)g(use)f(a)g Ft(make)f
Fu(that)i(do)s(es)f(not)g(supp)s(ort)e(the)j Ft(VPATH)d
Fu(v)-5 b(ariable,)26 b(y)m(ou)d(can)h(compile)g(Bash)150
4389 y(for)33 b(one)h(arc)m(hitecture)h(at)f(a)g(time)g(in)f(the)h
(source)g(co)s(de)f(directory)-8 b(.)51 b(After)34 b(y)m(ou)g(ha)m(v)m
(e)h(installed)f(Bash)150 4499 y(for)c(one)h(arc)m(hitecture,)h(use)e
@@ -19756,9 +19756,9 @@ y(The)24 b(GNU)i(Mak)m(e\014le)h(standards)d(pro)m(vide)i(a)f(more)h
(complete)g(description)g(of)f(these)h(v)-5 b(ariables)26
b(and)150 3346 y(their)k(e\013ects.)150 3614 y Fs(10.5)68
b(Sp)t(ecifying)45 b(the)g(System)h(T)l(yp)t(e)150 3774
y Fu(There)f(ma)m(y)g(b)s(e)f(some)i(features)f Ft(configure)e
Fu(can)i(not)g(\014gure)g(out)g(automatically)-8 b(,)52
b(but)44 b(need)h(to)150 3883 y(determine)26 b(b)m(y)g(the)g(t)m(yp)s
y Fu(There)c(ma)m(y)h(b)s(e)e(some)i(features)g Ft(configure)c
Fu(can)k(not)g(\014gure)e(out)i(automatically)-8 b(,)49
b(but)41 b(needs)h(to)150 3883 y(determine)26 b(b)m(y)g(the)g(t)m(yp)s
(e)g(of)g(host)g(Bash)g(will)g(run)f(on.)39 b(Usually)26
b Ft(configure)d Fu(can)k(\014gure)e(that)h(out,)i(but)150
3993 y(if)g(it)g(prin)m(ts)f(a)h(message)g(sa)m(ying)h(it)f(can)g(not)f
@@ -20528,19 +20528,19 @@ b(The)39 b Ft(ERR)g Fu(trap)g(is)330 408 y(not)g(inherited)f(b)m(y)h
b Fu(option)i(to)g(the)g Ft(set)f Fu(builtin)g(is)330
518 y(enabled.)330 650 y(The)g Ft(trap)g Fu(builtin)h(\(see)g(Section)h
(4.1)g([Bourne)f(Shell)g(Builtins],)i(page)f(48\))g(allo)m(ws)g(a)g
Ft(RETURN)330 759 y Fu(pseudo-signal)35 b(sp)s(eci\014cation,)j
(similar)d(to)h Ft(EXIT)e Fu(and)g Ft(DEBUG)p Fu(.)54
b(Commands)34 b(sp)s(eci\014ed)g(with)h(an)330 869 y
Ft(RETURN)k Fu(trap)i(are)g(executed)h(b)s(efore)e(execution)i(resumes)
e(after)h(a)g(shell)g(function)g(or)g(a)g(shell)330 978
y(script)36 b(executed)g(with)g Ft(.)f Fu(or)h Ft(source)e
Fu(returns.)56 b(The)35 b Ft(RETURN)f Fu(trap)i(is)g(not)g(inherited)f
(b)m(y)h(shell)330 1088 y(functions)k(unless)h(the)g(function)f(has)h
(b)s(een)f(giv)m(en)i(the)f Ft(trace)e Fu(attribute)j(or)e(the)h
Ft(functrace)330 1198 y Fu(option)31 b(has)f(b)s(een)g(enabled)g(using)
g(the)g Ft(shopt)f Fu(builtin.)225 1329 y Fq(\017)60
b Fu(The)30 b(Bash)g Ft(type)f Fu(builtin)h(is)g(more)g(extensiv)m(e)i
(and)d(giv)m(es)j(more)e(information)h(ab)s(out)f(the)g(names)330
Ft(RETURN)330 759 y Fu(pseudo-signal)f(sp)s(eci\014cation,)k(similar)d
(to)g Ft(EXIT)e Fu(and)g Ft(DEBUG)p Fu(.)66 b(Commands)38
b(sp)s(eci\014ed)h(with)g(a)330 869 y Ft(RETURN)g Fu(trap)i(are)g
(executed)h(b)s(efore)e(execution)i(resumes)e(after)h(a)g(shell)g
(function)g(or)g(a)g(shell)330 978 y(script)36 b(executed)g(with)g
Ft(.)f Fu(or)h Ft(source)e Fu(returns.)56 b(The)35 b
Ft(RETURN)f Fu(trap)i(is)g(not)g(inherited)f(b)m(y)h(shell)330
1088 y(functions)k(unless)h(the)g(function)f(has)h(b)s(een)f(giv)m(en)i
(the)f Ft(trace)e Fu(attribute)j(or)e(the)h Ft(functrace)330
1198 y Fu(option)31 b(has)f(b)s(een)g(enabled)g(using)g(the)g
Ft(shopt)f Fu(builtin.)225 1329 y Fq(\017)60 b Fu(The)30
b(Bash)g Ft(type)f Fu(builtin)h(is)g(more)g(extensiv)m(e)i(and)d(giv)m
(es)j(more)e(information)h(ab)s(out)f(the)g(names)330
1439 y(it)h(\014nds)e(\(see)i(Section)g(4.2)h([Bash)e(Builtins],)i
(page)f(55\).)225 1570 y Fq(\017)60 b Fu(The)27 b(Bash)h
Ft(umask)e Fu(builtin)h(p)s(ermits)g(a)h Ft(-p)f Fu(option)h(to)h