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

commit bash-20180322 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2018-03-26 11:11:52 -04:00
parent f602026a0c
commit 12933b5bc7
25 changed files with 1846 additions and 2220 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bashref.ps
+105 -103
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 5.997 Copyright 2017 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Thu Mar 15 18:13:40 2018
%%CreationDate: Mon Mar 19 13:43:29 2018
%%Pages: 182
%%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 2018.03.15:1413
%DVIPSSource: TeX output 2018.03.19:0943
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -17485,183 +17485,185 @@ g(argumen)m(t)h(to)g(the)f Ft(-W)f Fu(option)i(is)f(considered.)60
b(The)37 b(string)150 4113 y(is)c(\014rst)e(split)i(using)f(the)h(c)m
(haracters)h(in)e(the)h Ft(IFS)e Fu(sp)s(ecial)j(v)-5
b(ariable)33 b(as)g(delimiters.)48 b(Shell)32 b(quoting)h(is)150
4222 y(honored.)56 b(Eac)m(h)37 b(w)m(ord)e(is)h(then)f(expanded)g
(using)h(brace)g(expansion,)h(tilde)f(expansion,)h(parameter)150
4332 y(and)44 b(v)-5 b(ariable)46 b(expansion,)j(command)44
b(substitution,)49 b(and)44 b(arithmetic)i(expansion,)j(as)c(describ)s
(ed)150 4441 y(ab)s(o)m(v)m(e)38 b(\(see)f(Section)h(3.5)g([Shell)e
(Expansions],)i(page)f(22\).)61 b(The)36 b(results)h(are)g(split)f
(using)h(the)f(rules)150 4551 y(describ)s(ed)29 b(ab)s(o)m(v)m(e)i
(\(see)f(Section)h(3.5.7)h([W)-8 b(ord)30 b(Splitting],)h(page)f(31\).)
42 b(The)30 b(results)f(of)h(the)g(expansion)150 4660
y(are)f(pre\014x-matc)m(hed)h(against)g(the)f(w)m(ord)g(b)s(eing)f
(completed,)j(and)d(the)i(matc)m(hing)g(w)m(ords)e(b)s(ecome)i(the)150
4770 y(p)s(ossible)g(completions.)275 4902 y(After)f(these)g(matc)m
(hes)i(ha)m(v)m(e)f(b)s(een)f(generated,)h(an)m(y)g(shell)f(function)g
(or)g(command)g(sp)s(eci\014ed)f(with)150 5011 y(the)36
b Ft(-F)f Fu(and)g Ft(-C)g Fu(options)h(is)g(in)m(v)m(ok)m(ed.)59
b(When)35 b(the)h(command)g(or)f(function)h(is)g(in)m(v)m(ok)m(ed,)i
(the)e Ft(COMP_)150 5121 y(LINE)p Fu(,)42 b Ft(COMP_POINT)p
4222 y(honored)f(within)h(the)g(string,)h(in)f(order)f(to)i(pro)m(vide)
f(a)h(mec)m(hanism)f(for)g(the)g(w)m(ords)g(to)g(con)m(tain)i(shell)150
4332 y(metac)m(haracters)e(or)e(c)m(haracters)i(in)e(the)g(v)-5
b(alue)31 b(of)g Ft(IFS)p Fu(.)42 b(Eac)m(h)32 b(w)m(ord)e(is)h(then)g
(expanded)f(using)h(brace)150 4441 y(expansion,)g(tilde)h(expansion,)f
(parameter)g(and)g(v)-5 b(ariable)32 b(expansion,)f(command)f
(substitution,)i(and)150 4551 y(arithmetic)c(expansion,)f(as)g(describ)
s(ed)e(ab)s(o)m(v)m(e)i(\(see)h(Section)f(3.5)g([Shell)g(Expansions],)g
(page)g(22\).)40 b(The)150 4660 y(results)23 b(are)h(split)g(using)f
(the)h(rules)f(describ)s(ed)f(ab)s(o)m(v)m(e)j(\(see)g(Section)f(3.5.7)
h([W)-8 b(ord)24 b(Splitting],)i(page)e(31\).)150 4770
y(The)j(results)h(of)f(the)h(expansion)g(are)g(pre\014x-matc)m(hed)g
(against)h(the)f(w)m(ord)f(b)s(eing)g(completed,)j(and)d(the)150
4880 y(matc)m(hing)k(w)m(ords)f(b)s(ecome)h(the)g(p)s(ossible)f
(completions.)275 5011 y(After)f(these)g(matc)m(hes)i(ha)m(v)m(e)f(b)s
(een)f(generated,)h(an)m(y)g(shell)f(function)g(or)g(command)g(sp)s
(eci\014ed)f(with)150 5121 y(the)36 b Ft(-F)f Fu(and)g
Ft(-C)g Fu(options)h(is)g(in)m(v)m(ok)m(ed.)59 b(When)35
b(the)h(command)g(or)f(function)h(is)g(in)m(v)m(ok)m(ed,)i(the)e
Ft(COMP_)150 5230 y(LINE)p Fu(,)42 b Ft(COMP_POINT)p
Fu(,)d Ft(COMP_KEY)p Fu(,)i(and)e Ft(COMP_TYPE)f Fu(v)-5
b(ariables)41 b(are)f(assigned)g(v)-5 b(alues)41 b(as)f(describ)s(ed)
150 5230 y(ab)s(o)m(v)m(e)34 b(\(see)g(Section)g(5.2)g([Bash)f(V)-8
150 5340 y(ab)s(o)m(v)m(e)34 b(\(see)g(Section)g(5.2)g([Bash)f(V)-8
b(ariables],)36 b(page)d(72\).)50 b(If)33 b(a)g(shell)g(function)g(is)g
(b)s(eing)f(in)m(v)m(ok)m(ed,)k(the)150 5340 y Ft(COMP_WORDS)j
Fu(and)i Ft(COMP_CWORD)d Fu(v)-5 b(ariables)42 b(are)g(also)h(set.)74
b(When)41 b(the)h(function)f(or)h(command)f(is)p eop
end
(b)s(eing)f(in)m(v)m(ok)m(ed,)k(the)p eop end
%%Page: 132 138
TeXDict begin 132 137 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(132)150 299 y(in)m(v)m(ok)m(ed,)37
b(the)e(\014rst)f(argumen)m(t)h(\($1\))h(is)e(the)h(name)g(of)f(the)h
(command)f(whose)h(argumen)m(ts)f(are)h(b)s(eing)150
408 y(completed,)30 b(the)f(second)f(argumen)m(t)h(\($2\))h(is)f(the)g
b(Command)29 b(Line)i(Editing)2062 b(132)150 299 y Ft(COMP_WORDS)39
b Fu(and)i Ft(COMP_CWORD)d Fu(v)-5 b(ariables)42 b(are)g(also)h(set.)74
b(When)41 b(the)h(function)f(or)h(command)f(is)150 408
y(in)m(v)m(ok)m(ed,)c(the)e(\014rst)f(argumen)m(t)h(\($1\))h(is)e(the)h
(name)g(of)f(the)h(command)f(whose)h(argumen)m(ts)f(are)h(b)s(eing)150
518 y(completed,)30 b(the)f(second)f(argumen)m(t)h(\($2\))h(is)f(the)g
(w)m(ord)f(b)s(eing)g(completed,)i(and)e(the)h(third)e(argumen)m(t)150
518 y(\($3\))40 b(is)f(the)f(w)m(ord)h(preceding)f(the)h(w)m(ord)f(b)s
628 y(\($3\))40 b(is)f(the)f(w)m(ord)h(preceding)f(the)h(w)m(ord)f(b)s
(eing)g(completed)i(on)e(the)h(curren)m(t)f(command)h(line.)65
b(No)150 628 y(\014ltering)33 b(of)h(the)f(generated)h(completions)g
b(No)150 737 y(\014ltering)33 b(of)h(the)f(generated)h(completions)g
(against)h(the)e(w)m(ord)g(b)s(eing)f(completed)i(is)g(p)s(erformed;)f
(the)150 737 y(function)d(or)g(command)h(has)f(complete)i(freedom)e(in)
g(generating)h(the)g(matc)m(hes.)275 871 y(An)m(y)j(function)h(sp)s
(the)150 847 y(function)d(or)g(command)h(has)f(complete)i(freedom)e(in)
g(generating)h(the)g(matc)m(hes.)275 981 y(An)m(y)j(function)h(sp)s
(eci\014ed)f(with)g Ft(-F)g Fu(is)h(in)m(v)m(ok)m(ed)h(\014rst.)53
b(The)35 b(function)f(ma)m(y)h(use)g(an)m(y)g(of)g(the)g(shell)150
981 y(facilities,)50 b(including)44 b(the)h Ft(compgen)d
1090 y(facilities,)50 b(including)44 b(the)h Ft(compgen)d
Fu(and)i Ft(compopt)e Fu(builtins)i(describ)s(ed)f(b)s(elo)m(w)h(\(see)
i(Section)f(8.7)150 1090 y([Programmable)31 b(Completion)h(Builtins],)f
i(Section)f(8.7)150 1200 y([Programmable)31 b(Completion)h(Builtins],)f
(page)h(133\),)g(to)g(generate)g(the)f(matc)m(hes.)42
b(It)31 b(m)m(ust)g(put)f(the)150 1200 y(p)s(ossible)g(completions)h
b(It)31 b(m)m(ust)g(put)f(the)150 1310 y(p)s(ossible)g(completions)h
(in)f(the)h Ft(COMPREPLY)d Fu(arra)m(y)j(v)-5 b(ariable,)31
b(one)g(p)s(er)e(arra)m(y)i(elemen)m(t.)275 1334 y(Next,)26
b(one)g(p)s(er)e(arra)m(y)i(elemen)m(t.)275 1443 y(Next,)26
b(an)m(y)f(command)f(sp)s(eci\014ed)g(with)g(the)h Ft(-C)f
Fu(option)h(is)f(in)m(v)m(ok)m(ed)i(in)e(an)g(en)m(vironmen)m(t)h
(equiv)-5 b(alen)m(t)150 1443 y(to)26 b(command)e(substitution.)39
(equiv)-5 b(alen)m(t)150 1553 y(to)26 b(command)e(substitution.)39
b(It)25 b(should)f(prin)m(t)h(a)g(list)h(of)f(completions,)i(one)e(p)s
(er)f(line,)j(to)f(the)f(standard)150 1553 y(output.)40
(er)f(line,)j(to)f(the)f(standard)150 1663 y(output.)40
b(Bac)m(kslash)32 b(ma)m(y)f(b)s(e)f(used)g(to)h(escap)s(e)g(a)f
(newline,)h(if)f(necessary)-8 b(.)275 1687 y(After)24
(newline,)h(if)f(necessary)-8 b(.)275 1797 y(After)24
b(all)i(of)f(the)f(p)s(ossible)g(completions)i(are)f(generated,)i(an)m
(y)e(\014lter)g(sp)s(eci\014ed)e(with)i(the)g Ft(-X)e
Fu(option)150 1797 y(is)34 b(applied)g(to)g(the)h(list.)52
Fu(option)150 1906 y(is)34 b(applied)g(to)g(the)h(list.)52
b(The)33 b(\014lter)h(is)g(a)h(pattern)f(as)g(used)f(for)h(pathname)g
(expansion;)i(a)e(`)p Ft(&)p Fu(')g(in)g(the)150 1906
(expansion;)i(a)e(`)p Ft(&)p Fu(')g(in)g(the)150 2016
y(pattern)28 b(is)f(replaced)h(with)g(the)f(text)i(of)f(the)f(w)m(ord)h
(b)s(eing)f(completed.)40 b(A)28 b(literal)h(`)p Ft(&)p
Fu(')f(ma)m(y)g(b)s(e)f(escap)s(ed)150 2016 y(with)38
Fu(')f(ma)m(y)g(b)s(e)f(escap)s(ed)150 2125 y(with)38
b(a)h(bac)m(kslash;)k(the)38 b(bac)m(kslash)h(is)g(remo)m(v)m(ed)g(b)s
(efore)f(attempting)h(a)g(matc)m(h.)65 b(An)m(y)39 b(completion)150
2125 y(that)32 b(matc)m(hes)g(the)g(pattern)g(will)f(b)s(e)g(remo)m(v)m
2235 y(that)32 b(matc)m(hes)g(the)g(pattern)g(will)f(b)s(e)g(remo)m(v)m
(ed)h(from)f(the)h(list.)44 b(A)32 b(leading)g(`)p Ft(!)p
Fu(')f(negates)i(the)f(pattern;)150 2235 y(in)d(this)g(case)h(an)m(y)g
Fu(')f(negates)i(the)f(pattern;)150 2345 y(in)d(this)g(case)h(an)m(y)g
(completion)h(not)e(matc)m(hing)h(the)g(pattern)f(will)h(b)s(e)e(remo)m
(v)m(ed.)42 b(If)29 b(the)g Ft(nocasematch)150 2345 y
(v)m(ed.)42 b(If)29 b(the)g Ft(nocasematch)150 2454 y
Fu(shell)k(option)f(\(see)i(the)e(description)g(of)h
Ft(shopt)e Fu(in)h(Section)h(4.3.2)h([The)e(Shopt)g(Builtin],)h(page)g
(65\))h(is)150 2454 y(enabled,)d(the)f(matc)m(h)h(is)g(p)s(erformed)e
(65\))h(is)150 2564 y(enabled,)d(the)f(matc)m(h)h(is)g(p)s(erformed)e
(without)h(regard)g(to)h(the)g(case)g(of)g(alphab)s(etic)g(c)m
(haracters.)275 2588 y(Finally)-8 b(,)42 b(an)m(y)c(pre\014x)g(and)f
(haracters.)275 2698 y(Finally)-8 b(,)42 b(an)m(y)c(pre\014x)g(and)f
(su\016x)h(sp)s(eci\014ed)f(with)i(the)f Ft(-P)g Fu(and)g
Ft(-S)f Fu(options)i(are)g(added)f(to)h(eac)m(h)150 2698
Ft(-S)f Fu(options)i(are)g(added)f(to)h(eac)m(h)150 2807
y(mem)m(b)s(er)31 b(of)g(the)h(completion)h(list,)f(and)f(the)h(result)
f(is)h(returned)e(to)i(the)g(Readline)g(completion)h(co)s(de)150
2807 y(as)e(the)f(list)h(of)g(p)s(ossible)f(completions.)275
2941 y(If)d(the)h(previously-applied)f(actions)i(do)f(not)g(generate)h
2917 y(as)e(the)f(list)h(of)g(p)s(ossible)f(completions.)275
3051 y(If)d(the)h(previously-applied)f(actions)i(do)f(not)g(generate)h
(an)m(y)f(matc)m(hes,)i(and)d(the)h Ft(-o)h(dirnames)d
Fu(op-)150 3051 y(tion)j(w)m(as)f(supplied)f(to)i Ft(complete)d
Fu(op-)150 3160 y(tion)j(w)m(as)f(supplied)f(to)i Ft(complete)d
Fu(when)h(the)h(compsp)s(ec)g(w)m(as)g(de\014ned,)g(directory)g(name)h
(completion)150 3160 y(is)h(attempted.)275 3294 y(If)35
(completion)150 3270 y(is)h(attempted.)275 3404 y(If)35
b(the)g Ft(-o)30 b(plusdirs)j Fu(option)j(w)m(as)g(supplied)e(to)i
Ft(complete)e Fu(when)g(the)i(compsp)s(ec)f(w)m(as)h(de\014ned,)150
3404 y(directory)g(name)f(completion)i(is)e(attempted)h(and)f(an)m(y)h
3513 y(directory)g(name)f(completion)i(is)e(attempted)h(and)f(an)m(y)h
(matc)m(hes)g(are)g(added)f(to)h(the)f(results)g(of)h(the)150
3513 y(other)31 b(actions.)275 3647 y(By)g(default,)i(if)e(a)h(compsp)s
3623 y(other)31 b(actions.)275 3757 y(By)g(default,)i(if)e(a)h(compsp)s
(ec)f(is)h(found,)f(whatev)m(er)h(it)g(generates)h(is)e(returned)g(to)h
(the)g(completion)150 3757 y(co)s(de)21 b(as)g(the)g(full)g(set)g(of)g
(the)g(completion)150 3867 y(co)s(de)21 b(as)g(the)g(full)g(set)g(of)g
(p)s(ossible)f(completions.)39 b(The)20 b(default)h(Bash)g(completions)
h(are)g(not)f(attempted,)150 3867 y(and)30 b(the)g(Readline)h(default)f
h(are)g(not)f(attempted,)150 3976 y(and)30 b(the)g(Readline)h(default)f
(of)g(\014lename)h(completion)g(is)f(disabled.)41 b(If)29
b(the)i Ft(-o)e(bashdefault)e Fu(option)150 3976 y(w)m(as)d(supplied)e
b(the)i Ft(-o)e(bashdefault)e Fu(option)150 4086 y(w)m(as)d(supplied)e
(to)j Ft(complete)c Fu(when)i(the)g(compsp)s(ec)h(w)m(as)g(de\014ned,)g
(the)f(default)h(Bash)g(completions)h(are)150 4086 y(attempted)j(if)f
(the)f(default)h(Bash)g(completions)h(are)150 4195 y(attempted)j(if)f
(the)h(compsp)s(ec)f(generates)h(no)f(matc)m(hes.)41
b(If)27 b(the)g Ft(-o)j(default)25 b Fu(option)j(w)m(as)f(supplied)f
(to)150 4195 y Ft(complete)f Fu(when)h(the)h(compsp)s(ec)f(w)m(as)i
(to)150 4305 y Ft(complete)f Fu(when)h(the)h(compsp)s(ec)f(w)m(as)i
(de\014ned,)e(Readline's)i(default)f(completion)h(will)f(b)s(e)f(p)s
(erformed)150 4305 y(if)k(the)h(compsp)s(ec)f(\(and,)g(if)h(attempted,)
(erformed)150 4415 y(if)k(the)h(compsp)s(ec)f(\(and,)g(if)h(attempted,)
g(the)g(default)f(Bash)h(completions\))h(generate)g(no)e(matc)m(hes.)
275 4439 y(When)20 b(a)i(compsp)s(ec)e(indicates)i(that)g(directory)g
275 4548 y(When)20 b(a)i(compsp)s(ec)e(indicates)i(that)g(directory)g
(name)f(completion)h(is)f(desired,)i(the)e(programmable)150
4548 y(completion)31 b(functions)e(force)i(Readline)f(to)h(app)s(end)d
4658 y(completion)31 b(functions)e(force)i(Readline)f(to)h(app)s(end)d
(a)i(slash)g(to)g(completed)h(names)e(whic)m(h)h(are)g(sym-)150
4658 y(b)s(olic)40 b(links)g(to)h(directories,)j(sub)5
4768 y(b)s(olic)40 b(links)g(to)h(directories,)j(sub)5
b(ject)40 b(to)h(the)f(v)-5 b(alue)41 b(of)f(the)g Fr(mark-directories)
45 b Fu(Readline)c(v)-5 b(ariable,)150 4768 y(regardless)31
45 b Fu(Readline)c(v)-5 b(ariable,)150 4877 y(regardless)31
b(of)f(the)h(setting)g(of)g(the)f Fr(mark-symlink)m(ed-directories)36
b Fu(Readline)31 b(v)-5 b(ariable.)275 4902 y(There)25
b Fu(Readline)31 b(v)-5 b(ariable.)275 5011 y(There)25
b(is)i(some)g(supp)s(ort)e(for)h(dynamically)h(mo)s(difying)f
(completions.)40 b(This)26 b(is)g(most)h(useful)f(when)150
5011 y(used)40 b(in)h(com)m(bination)i(with)e(a)g(default)h(completion)
5121 y(used)40 b(in)h(com)m(bination)i(with)e(a)g(default)h(completion)
g(sp)s(eci\014ed)f(with)g Ft(-D)p Fu(.)72 b(It's)42 b(p)s(ossible)f
(for)g(shell)150 5121 y(functions)28 b(executed)h(as)f(completion)i
(for)g(shell)150 5230 y(functions)28 b(executed)h(as)f(completion)i
(handlers)d(to)i(indicate)g(that)g(completion)g(should)e(b)s(e)h
(retried)g(b)m(y)150 5230 y(returning)j(an)i(exit)g(status)f(of)h(124.)
(retried)g(b)m(y)150 5340 y(returning)j(an)i(exit)g(status)f(of)h(124.)
48 b(If)31 b(a)i(shell)f(function)g(returns)f(124,)k(and)c(c)m(hanges)j
(the)e(compsp)s(ec)150 5340 y(asso)s(ciated)43 b(with)e(the)g(command)g
(on)g(whic)m(h)g(completion)i(is)e(b)s(eing)g(attempted)h(\(supplied)e
(as)i(the)p eop end
(the)e(compsp)s(ec)p eop end
%%Page: 133 139
TeXDict begin 133 138 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(133)150 299 y(\014rst)29
b(Command)29 b(Line)i(Editing)2062 b(133)150 299 y(asso)s(ciated)43
b(with)e(the)g(command)g(on)g(whic)m(h)g(completion)i(is)e(b)s(eing)g
(attempted)h(\(supplied)e(as)i(the)150 408 y(\014rst)29
b(argumen)m(t)h(when)e(the)i(function)f(is)g(executed\),)j
(programmable)d(completion)i(restarts)f(from)f(the)150
408 y(b)s(eginning,)e(with)g(an)h(attempt)g(to)g(\014nd)e(a)i(new)e
518 y(b)s(eginning,)e(with)g(an)h(attempt)g(to)g(\014nd)e(a)i(new)e
(compsp)s(ec)i(for)f(that)h(command.)39 b(This)27 b(allo)m(ws)h(a)g
(set)g(of)150 518 y(completions)33 b(to)f(b)s(e)g(built)f(dynamically)i
(set)g(of)150 628 y(completions)33 b(to)f(b)s(e)g(built)f(dynamically)i
(as)f(completion)h(is)f(attempted,)h(rather)f(than)f(b)s(eing)g(loaded)
150 628 y(all)g(at)g(once.)275 770 y(F)-8 b(or)38 b(instance,)h
150 737 y(all)g(at)g(once.)275 869 y(F)-8 b(or)38 b(instance,)h
(assuming)e(that)h(there)f(is)h(a)f(library)g(of)g(compsp)s(ecs,)i(eac)
m(h)g(k)m(ept)e(in)g(a)h(\014le)f(corre-)150 879 y(sp)s(onding)g(to)j
m(h)g(k)m(ept)e(in)g(a)h(\014le)f(corre-)150 978 y(sp)s(onding)g(to)j
(the)f(name)f(of)h(the)g(command,)i(the)e(follo)m(wing)h(default)f
(completion)h(function)e(w)m(ould)150 989 y(load)31 b(completions)g
(dynamically:)390 1131 y Ft(_completion_loader\(\))390
1241 y({)581 1350 y(.)47 b("/etc/bash_completion.d/$1)o(.sh)o(")42
b(>/dev/null)j(2>&1)i(&&)g(return)f(124)390 1460 y(})390
1569 y(complete)g(-D)h(-F)g(_completion_loader)c(-o)k(bashdefault)e(-o)
i(default)150 1821 y Fs(8.7)68 b(Programmable)47 b(Completion)f
(Builtins)150 1981 y Fu(Three)21 b(builtin)g(commands)f(are)i(a)m(v)-5
(completion)h(function)e(w)m(ould)150 1088 y(load)31
b(completions)g(dynamically:)390 1219 y Ft(_completion_loader\(\))390
1329 y({)581 1439 y(.)47 b("/etc/bash_completion.d/$1)o(.sh)o(")42
b(>/dev/null)j(2>&1)i(&&)g(return)f(124)390 1548 y(})390
1658 y(complete)g(-D)h(-F)g(_completion_loader)c(-o)k(bashdefault)e(-o)
i(default)150 1893 y Fs(8.7)68 b(Programmable)47 b(Completion)f
(Builtins)150 2052 y Fu(Three)21 b(builtin)g(commands)f(are)i(a)m(v)-5
b(ailable)24 b(to)e(manipulate)f(the)h(programmable)f(completion)h
(facilities:)150 2090 y(one)34 b(to)g(sp)s(ecify)f(ho)m(w)h(the)f
(facilities:)150 2162 y(one)34 b(to)g(sp)s(ecify)f(ho)m(w)h(the)f
(argumen)m(ts)h(to)g(a)g(particular)g(command)f(are)h(to)g(b)s(e)f
(completed,)j(and)d(t)m(w)m(o)150 2200 y(to)e(mo)s(dify)f(the)g
(completion)i(as)e(it)h(is)g(happ)s(ening.)150 2371 y
Ft(compgen)870 2509 y(compgen)46 b([)p Fj(option)p Ft(])f([)p
Fj(word)p Ft(])630 2647 y Fu(Generate)27 b(p)s(ossible)e(completion)i
(completed,)j(and)d(t)m(w)m(o)150 2271 y(to)e(mo)s(dify)f(the)g
(completion)i(as)e(it)h(is)g(happ)s(ening.)150 2425 y
Ft(compgen)870 2556 y(compgen)46 b([)p Fj(option)p Ft(])f([)p
Fj(word)p Ft(])630 2688 y Fu(Generate)27 b(p)s(ossible)e(completion)i
(matc)m(hes)g(for)e Fr(w)m(ord)k Fu(according)e(to)f(the)g
Fr(option)p Fu(s,)h(whic)m(h)630 2757 y(ma)m(y)32 b(b)s(e)f(an)m(y)h
Fr(option)p Fu(s,)h(whic)m(h)630 2797 y(ma)m(y)32 b(b)s(e)f(an)m(y)h
(option)g(accepted)g(b)m(y)g(the)f Ft(complete)f Fu(builtin)h(with)g
(the)g(exception)i(of)f Ft(-p)630 2866 y Fu(and)39 b
(the)g(exception)i(of)f Ft(-p)630 2907 y Fu(and)39 b
Ft(-r)p Fu(,)i(and)e(write)h(the)g(matc)m(hes)g(to)g(the)g(standard)f
(output.)68 b(When)39 b(using)g(the)h Ft(-F)630 2976
(output.)68 b(When)39 b(using)g(the)h Ft(-F)630 3017
y Fu(or)33 b Ft(-C)f Fu(options,)i(the)e(v)-5 b(arious)33
b(shell)g(v)-5 b(ariables)33 b(set)g(b)m(y)g(the)g(programmable)g
(completion)630 3086 y(facilities,)g(while)d(a)m(v)-5
(completion)630 3126 y(facilities,)g(while)d(a)m(v)-5
b(ailable,)33 b(will)e(not)g(ha)m(v)m(e)g(useful)f(v)-5
b(alues.)630 3224 y(The)34 b(matc)m(hes)h(will)g(b)s(e)f(generated)h
b(alues.)630 3258 y(The)34 b(matc)m(hes)h(will)g(b)s(e)f(generated)h
(in)f(the)h(same)g(w)m(a)m(y)g(as)g(if)f(the)h(programmable)f(com-)630
3334 y(pletion)d(co)s(de)g(had)f(generated)i(them)e(directly)i(from)e
(a)h(completion)h(sp)s(eci\014cation)f(with)630 3443
3367 y(pletion)d(co)s(de)g(had)f(generated)i(them)e(directly)i(from)e
(a)h(completion)h(sp)s(eci\014cation)f(with)630 3477
y(the)e(same)h(\015ags.)40 b(If)29 b Fr(w)m(ord)j Fu(is)d(sp)s
(eci\014ed,)g(only)g(those)h(completions)g(matc)m(hing)g
Fr(w)m(ord)j Fu(will)630 3553 y(b)s(e)d(displa)m(y)m(ed.)630
3691 y(The)24 b(return)g(v)-5 b(alue)25 b(is)g(true)f(unless)g(an)h(in)
Fr(w)m(ord)j Fu(will)630 3586 y(b)s(e)d(displa)m(y)m(ed.)630
3718 y(The)24 b(return)g(v)-5 b(alue)25 b(is)g(true)f(unless)g(an)h(in)
m(v)-5 b(alid)25 b(option)g(is)g(supplied,)f(or)h(no)g(matc)m(hes)g(w)m
(ere)630 3801 y(generated.)150 3968 y Ft(complete)870
4106 y(complete)46 b([-abcdefgjksuv])d([-o)k Fj(comp-option)p
Ft(])e([-DE])h([-A)h Fj(action)p Ft(])f([-)870 4215 y(G)h
Fj(globpat)p Ft(])f([-W)h Fj(wordlist)p Ft(])870 4325
(ere)630 3828 y(generated.)150 3981 y Ft(complete)870
4113 y(complete)46 b([-abcdefgjksuv])d([-o)k Fj(comp-option)p
Ft(])e([-DE])h([-A)h Fj(action)p Ft(])f([-)870 4222 y(G)h
Fj(globpat)p Ft(])f([-W)h Fj(wordlist)p Ft(])870 4332
y([-F)g Fj(function)p Ft(])e([-C)i Fj(command)p Ft(])f([-X)h
Fj(filterpat)p Ft(])870 4435 y([-P)g Fj(prefix)p Ft(])f([-S)h
Fj(filterpat)p Ft(])870 4441 y([-P)g Fj(prefix)p Ft(])f([-S)h
Fj(suffix)p Ft(])e Fj(name)i Ft([)p Fj(name)f Ft(...])870
4544 y(complete)g(-pr)g([-DE])h([)p Fj(name)f Ft(...)o(])630
4551 y(complete)g(-pr)g([-DE])h([)p Fj(name)f Ft(...)o(])630
4682 y Fu(Sp)s(ecify)37 b(ho)m(w)h(argumen)m(ts)f(to)i(eac)m(h)g
Fr(name)j Fu(should)37 b(b)s(e)g(completed.)63 b(If)38
b(the)f Ft(-p)g Fu(option)630 4792 y(is)30 b(supplied,)e(or)i(if)g(no)f