-5.208 G .208(here is)-2.708 F(no pre)108 501.6 Q(vious entry)-.25 E 2.5(,r)-.65 G(eturn a)-2.5 E F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(HIST_ENTR)108 525.6 Q 2.5(Y*)-.18 G F2(next_history)A F0(\()4.166 E F1(void)A F0(\))1.666 E(Mo)108 537.6 Q 1.047 -.15(ve t)-.15 H .747(he current history of).15 F .747(fset forw)-.25 F .746(ard to the ne)-.1 F .746(xt history entry)-.15 F 3.246(,a)-.65 G .746(nd return the a pointer to that entry)-3.246 F 5.746(.I)-.65 G(f)-5.746E(there is no ne)108 549.6 Q(xt entry)-.15 E 2.5(,r)-.65 G(eturn a)-2.5E F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F2(Sear)87 578.4 Q(ching the History List)-.18 E F0 .005(These functions allo)108 590.4 R2.505(ws)-.25 G .006(earching of the history list for entries containin\g a speci\214c string.)-2.505 F .006(Searching may be)5.006 F 1.452(performed both forw)108 602.4 R 1.452(ard and backw)-.1 F 1.451(ard from the current history position.)-.1 F 1.451(The search may be)6.451 F F1(anc)3.951 E(hor)-.15 E(ed)-.37 E F0(,)A(meaning that the string must match at the be)108 614.4 Q(ginning of the history entry)-.15 E(.)-.65 E F1(int)108 638.4 Q F2(history_sear)2.5 E(ch)-.18 E F0(\()4.166 E F1(const c)A(har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))1.666 E .155(Search the history for)108 650.4 R F1(string)2.655 E F0 2.656(,s)C .156(tarting at the current history of)-2.656 F 2.656(fset. If)-.25 F F1(dir)2.656 E(ection)-.37 E F0 .156(is less than 0, then the search)2.656F .802(is through pre)108 662.4 R .802(vious entries, otherwise through subsequent entries.)-.25 F(If)5.801 EF1(string)3.301 E F0 .801(is found, then the current his-)3.301 F .064(tory inde)108 674.4 R 2.564(xi)-.15 G 2.564(ss)-2.564 G .064(et to that history entry)-2.564 F 2.564(,a)-.65 G .064(nd the v)-2.564F .064(alue returned is the of)-.25 F .064(fset in the line of the entry where)-.25 F F1(string)2.565 E F0 -.1(wa)108 686.4 S 2.5(sf).1 G 2.5(ound. Otherwise,)-2.5 F(nothing is changed, and a -1 is returned.)2.5 E F1(int)108 710.4 Q F2(history_sear)2.5 E(ch_pr)-.18 E(e\214x)-.18 E F0(\()4.166 E F1(const c)A(har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))1.666 E .684(Search the history for)108 722.4 R F1(string)3.183 E F03.183(,s)C .683(tarting at the current history of)-3.183 F 3.183(fset. The)-.25 F .683(search is anchored: matching lines)3.183 F(GNU History 4.3)72 768 Q(2002 January 31)131.79 E(4)195.95 E EP%%Page: 5 5%%BeginPageSetupBP%%EndPageSetup/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F(OR)-.18 E(Y\(3\))-.65 E 1.063(must be)108 84 R 1.063(gin with)-.15 F/F110/Times-Italic@0 SF(string)3.563 E F0 6.063(.I)C(f)-6.063 E F1(dir)3.563 E(ection)-.37 E F0 1.064(is less than 0, then the search is through pre)3.563 F 1.064(vious entries, otherwise)-.25 F 1.115(through subsequent entries.)10896 R(If)6.115 E F1(string)3.615 E F0 1.115(is found, then the current history inde)3.615 F 3.614(xi)-.15 G 3.614(ss)-3.614 G 1.114(et to that entry)-3.614 F 3.614(,a)-.65 G 1.114(nd the)-3.614 F(return v)108 108 Q(alue is 0.)-.25 E(Otherwise, nothing is changed, and a -1 is returned.)5 E F1(int)108 132Q/F2 10/Times-Bold@0 SF(history_sear)2.5 E(ch_pos)-.18 E F0(\()4.166 EF1(const c)A(har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E -.834(ection, int)-.37 F(pos)2.5 E F0(\))3.332 E .603(Search for)108 144 R F1(string)3.103 E F0 .603(in the history list, starting at)3.103 F F1(pos)3.104 E F0 3.104(,a)C 3.104(na)-3.104 G .604(bsolute inde)-3.104 F 3.104(xi)-.15 G .604(nto the list.)-3.104 F(If)5.604 E F1(dir)3.104 E(ection)-.37 E F0 .604(is ne)3.104 F -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G(,).15 E .608(the search proceeds backw)108 156 R .608(ard from)-.1 F F1(pos)3.108 E F0 3.108(,o)C .608(therwise forw)-3.108 F 3.108(ard. Returns)-.1 F .608(the absolute inde)3.108 F 3.108(xo)-.15 G 3.108(ft)-3.108 G .608(he history ele-)-3.108 F(ment where)108 168 Q F1(string)2.5 E F0 -.1(wa)2.5 G 2.5(sf).1 G(ound, or -1 otherwise.)-2.5 EF2(Managing the History File)87 196.8 Q F0 .035(The History library can\ read the history from and write it to a \214le.)108 208.8 R .036(This section documents the functions for)5.035 F(managing a history \214le.)108 220.8 Q F1(int)108 244.8 Q F2 -.18(re)2.5 G(ad_history).18 E F0(\()4.166 E F1(const c)A(har *\214lename)-.15 EF0(\))1.666 E .151(Add the contents of)108 256.8 R F1(\214lename)2.651 EF0 .151(to the history list, a line at a time.)2.651 F(If)5.15 E F1(\214lename)2.65 E F0(is)2.65 E F2(NULL)2.65 E F0 2.65(,t)C .15(hen read from)-2.65 F F1(~/.his-)2.65 E(tory)108 268.8 Q F0 5(.R)C(eturns 0 if successful, or)-5 E F2(err)2.5 E(no)-.15 E F0(if not.)2.5 EF1(int)108 292.8 Q F2 -.18(re)2.5 G(ad_history_range).18 E F0(\()4.166 EF1(const c)A(har *\214lename)-.15 E 1.666(,i)-.1 G(nt fr)-1.666 E -.834(om, int)-.45 F(to)2.5 E F0(\))3.332 E .052(Read a range of lines from)108 304.8 R F1(\214lename)2.553 E F0 2.553(,a)C .053(dding them to the history list.)-2.553 F .053(Start reading at line)5.053 F F1(fr)2.553 E(om)-.45 E F0 .053(and end at)2.553 F F1(to)2.553 EF0(.)A(If)108 316.8 Q F1(fr)2.889 E(om)-.45 E F0 .389(is zero, start at the be)2.889 F 2.889(ginning. If)-.15 F F1(to)2.889 EF0 .389(is less than)2.889 F F1(fr)2.889 E(om)-.45 E F0 2.889(,t)C .388(hen read until the end of the \214le.)-2.889 F(If)5.388 E F1(\214lename)2.888 E F0(is)108 328.8 Q F2(NULL)2.5 E F0 2.5(,t)C(hen read from)-2.5 E F1(~/.history)2.5 E F0 5(.R)C(eturns 0 if successful, or)-5 E F2(err)2.5 E(no)-.15 E F0(if not.)2.5 EF1(int)108 352.8 Q F2(write_history)2.5 E F0(\()4.166 E F1(const c)A(har *\214lename)-.15 E F0(\))1.666 E .961(Write the current history to)108 364.8 R F1(\214lename)3.461 E F0 3.461(,o)C -.15(ve)-3.611 G(rwriting).15 E F1(\214lename)3.461 E F0 .961(if necessary)3.461 F 5.961(.I)-.65 G(f)-5.961 E F1(\214lename)3.462 E F0(is)3.462 E F2(NULL)3.462E F0 3.462(,t)C .962(hen write)-3.462 F(the history list to)108 376.8 QF1(~/.history)2.5 E F0 5(.R)C(eturns 0 on success, or)-5 E F2(err)2.5 E(no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F1(int)108 412.8 QF2(append_history)2.5 E F0(\()4.166 E F1(int nelements,)A(const c)1.666E(har *\214lename)-.15 E F0(\))1.666 E .839(Append the last)108 424.8 RF1(nelements)3.339 E F0 .839(of the history list to)3.339 F F1(\214lename)3.339 E F0 5.839(.I)C(f)-5.839 E F1(\214lename)3.339 E F0(is)3.339 E F2(NULL)3.339 E F0 3.339(,t)C .838(hen append to)-3.339 F F1(~/.history)3.338 E F0(.)A(Returns 0 on success, or)108 436.8 Q F2(err)2.5 E(no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F1(int)108460.8 Q F2(history_truncate_\214le)2.5 E F0(\()4.166 E F1(const c)A(har *\214lename)-.15 E 1.666(,i)-.1 G(nt nlines)-1.666 E F0(\))1.666 E-.35(Tr)108 472.8 S .38(uncate the history \214le).35 F F1(\214lename)2.88 E F0 2.88(,l)C(ea)-2.88 E .38(ving only the last)-.2 F F1(nlines)2.881 E F0 2.881(lines. If)2.881 F F1(\214lename)2.881 E F0(is)2.881 EF2(NULL)2.881 E F0 2.881(,t)C(hen)-2.881 E F1(~/.history)2.881 E F0(is)2.881 E 2.5(truncated. Returns)108 484.8 R 2.5(0o)2.5 G 2.5(ns)-2.5 G(uccess, or)-2.5 E F2(err)2.5 E(no)-.15 E F0(on f)2.5 E(ailure.)-.1 E F2(History Expansion)87 513.6 Q F0(These functions implement history e)108525.6 Q(xpansion.)-.15 E F1(int)108 549.6 Q F2(history_expand)2.5 E F0(\()4.166 E F1 -.15(ch)C(ar *string).15 E 1.666(,c)-.1 G(har **output)-1.816 E F0(\))1.666 E(Expand)108 561.6 Q F1(string)2.5 E F0 2.5(,p)C(lacing the result into)-2.5 E F1(output)2.5 E F0 2.5(,ap)C(ointer to a string.)-2.5 E(Returns:)5 E 31(0I)144 573.6 S 3.066(fn)-31G 3.066(oe)-3.066 G .566(xpansions took place \(or)-3.216 F 3.065(,i)-.4G 3.065(ft)-3.065 G .565(he only change in the te)-3.065 F .565(xt w)-.15 F .565(as the remo)-.1 F -.25(va)-.15 G 3.065(lo).25 G 3.065(fe)-3.065 G(scape)-3.065 E(characters preceding the history e)180 585.6 Q(xpansion character\);)-.15 E 31(1i)144 597.6 S 2.5(fe)-31 G(xpansions did tak)-2.65 E 2.5(ep)-.1 G(lace;)-2.5 E 25.17(-1 if)144609.6 R(there w)2.5 E(as an error in e)-.1 E(xpansion;)-.15 E 31(2i)144621.6 S 2.5(ft)-31 G(he returned line should be displayed, b)-2.5 E(ut not e)-.2 E -.15(xe)-.15 G(cuted, as with the).15 E F2(:p)2.5 E F0(modi\214er)2.5 E(.)-.55 E(If an error ocurred in e)108 633.6 Q(xpansion, then)-.15 E F1(output)2.5 E F0(contains a descripti)2.5 E .3-.15(ve e)-.25 H(rror message.).15 E F1 -.15(ch)108 657.6 S(ar *).15 EF2(get_history_e)2.5 E -.1(ve)-.15 G(nt).1 E F0(\()4.166 E F1(const c)A(har *string)-.15 E 1.666(,i)-.1 G(nt *cinde)-1.666 E -.834(x, int)-.2 F(qc)2.5 E(har)-.15 E F0(\))3.332 E .262(Returns the te)108 669.6 R .262(xt of the history e)-.15 F -.15(ve)-.25 G .262(nt be).15 F .263(ginning at)-.15 F F1(string)2.763 E F0(+)2.763 E F1(*cinde)2.763 E(x)-.2 E F0(.)A F1(*cinde)5.263 E(x)-.2 E F0 .263(is modi\214ed to point to after the)2.763 F -2.15 -.25(ev e)108 681.6 T.71(nt speci\214er).25 F 5.71(.A)-.55 G 3.21(tf)-5.71 G .71(unction entry)-3.21 F(,)-.65 E F1(cinde)3.21 E(x)-.2 E F0 .709(points to the inde)3.21 F 3.209(xi)-.15 G(nto)-3.209 E F1(string)3.209E F0 .709(where the history e)3.209 F -.15(ve)-.25 G .709(nt speci\214ca-).15 F .527(tion be)108 693.6 R(gins.)-.15 E F1(qc)5.527E(har)-.15 E F0 .527(is a character that is allo)3.027 F .527(wed to end the e)-.25 F -.15(ve)-.25 G .528(nt speci\214cation in addition to the `).15 F(`normal')-.74 E(')-.74 E(terminating characters.)108 705.6 Q F1 -.15(ch)108 729.6 S(ar **).15 EF2(history_tok)2.5 E(enize)-.1 E F0(\()4.166 E F1(const c)A(har *string)-.15 E F0(\))1.666 E(GNU History 4.3)72 768 Q(2002 January 31)131.79 E(5)195.95 E EP%%Page: 6 6%%BeginPageSetupBP%%EndPageSetup/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F(OR)-.18 E(Y\(3\))-.65 E .239(Return an array of tok)108 84 R .239(ens parsed out of)-.1 F/F1 10/Times-Italic@0 SF(string)2.739 E F0 2.739(,m)C .238(uch as the shell might.)-2.739 F .238(The tok)5.238 F .238(ens are split on the charac-)-.1 F(ters in the)108 96 Q/F2 10/Times-Bold@0 SF(history_w)2.5 E(ord_delimiters)-.1 E F0 -.25(va)2.5 G(riable, and shell quoting con).25 E -.15(ve)-.4 G(ntions are obe).15 E(yed.)-.15 E F1 -.15(ch)108 120 S(ar *).15 E F2(history_ar)2.5 E(g_extract)-.1 E F0(\()4.166 E F1(int \214r)A -.834(st, int)-.1 F -.834(last, const)2.5 F -.15(ch)2.5 G(ar *string).15 E F0(\))3.332 E .025(Extract a string se)108 132 R .025(gment consisting of the)-.15 F F1<8c72>2.526 E(st)-.1 E F0(through)2.526 E F1(last)2.526 E F0(ar)2.526 E.026(guments present in)-.18 F F1(string)2.526 E F0 5.026(.A)C -.18(rg)-5.026 G .026(uments are split).18 F(using)108 144 Q F2(history_tok)2.5E(enize\(\))-.1 E F0(.)A F2(History V)87 172.8 Q(ariables)-.92 E F0(This section describes the e)108 184.8 Q(xternally-visible v)-.15 E(ariables e)-.25 E(xported by the GNU History Library)-.15 E(.)-.65 E F1(int)108 208.8 Q F2(history_base)2.5 E F0(The logical of)108 220.8 Q(fset of the \214rst entry in the history list.)-.25 E F1(int)108 244.8Q F2(history_length)2.5 E F0(The number of entries currently stored in the history list.)108 256.8 QF1(int)108 280.8 Q F2(history_max_entries)2.5 E F0(The maximum number of history entries.)108 292.8 Q(This must be changed using)5 E F2(sti\215e_history\(\))2.5 E F0(.)A F1-.15(ch)108 316.8 S(ar).15 E F2(history_expansion_char)2.5 E F0(The character that introduces a history e)108 328.8 Q -.15(ve)-.25 G2.5(nt. The).15 F(def)2.5 E(ault is)-.1 E F2(!)2.5 E F0 5(.S)C(etting this to 0 inhibits history e)-5 E(xpansion.)-.15 E F1 -.15(ch)108 352.8 S(ar).15 E F2(history_subst_char)2.5 E F0(The character that in)108 364.8 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(sw).1 G(ord substitution if found at the start of a line.)-2.6 E(The def)5 E(ault is)-.1 E F2(^)2.5 E F0(.)A F1 -.15(ch)108 388.8 S(ar).15 E F2(history_comment_char)2.5 E F0 .117(During tok)108 400.8 R .117(enization, if this character is seen as the \214rst character of a w)-.1 F .117(ord, then it and all subsequent char)-.1 F(-)-.2 E .276(acters up to a ne)108 412.8 R .276(wline are ignored, suppressing history e)-.25 F .276(xpansion for the remainder of the line.)-.15 F .277(This is dis-)5.276F(abled by def)108 424.8 Q(ault.)-.1 E F1 -.15(ch)108 448.8 S(ar *).15 EF2(history_w)2.5 E(ord_delimiters)-.1 E F0(The characters that separate tok)108 460.8 Q(ens for)-.1 E F2(history_tok)2.5 E(enize\(\))-.1 E F0 5(.T)C(he def)-5 E(ault v)-.1 E(alue is)-.25 E F2 2.5("\\)2.5 G(t\\n\(\)<>;&|")-2.5 E F0(.)A F1 -.15(ch)108 484.8 S(ar *).15 E F2(history_no_expand_chars)2.5 E F0 2.054(The list of characters which inhibit history e)108 496.8 R 2.054(xpansion if found immediately follo)-.15 F(wing)-.25 E F2(history_expan-)4.554 E(sion_char)108 508.8 Q F0 5(.T)C(he def)-5 E(ault is space, tab, ne)-.1 E(wline,)-.25 E F2(\\r)2.5 E F0 2.5(,a)C(nd)-2.5 E F2(=)2.5 E F0(.)A F1 -.15(ch)108 532.8 S(ar *).15 E F2(history_sear)2.5 E(ch_delimiter_chars)-.18 E F0 .401(The list of addit\ional characters which can delimit a history search string, in addition\ to space, tab,)108 544.8 R F1(:)2.901 E F0(and)2.901 E F1(?)2.902 E F0(in the case of a substring search.)108 556.8 Q(The def)5 E(ault is empty)-.1 E(.)-.65 E F1(int)108 580.8 Q F2(history_quotes_inhibit_expansion)2.5 E F0 .625(If non-zero, single-quoted w)108 592.8 R .625(ords are not scanned for the history e)-.1 F .624(xpansion character)-.15 F 5.624(.T)-.55 G .624(he def)-5.624 F .624(ault v)-.1 F .624(alue is)-.25 F(0.)108 604.8 Q F1(rl_lineb)108 628.8 Q(uf_func_t *)-.2 EF2(history_inhibit_expansion_function)2.5 E F0 .347(This should be set to the address of a function that tak)108 640.8 R.348(es tw)-.1 F 2.848(oa)-.1 G -.18(rg)-2.848 G .348(uments: a).18 F F2.348(char *)2.848 F F0(\()2.848 E F1(string)A F0 2.848(\)a)C .348(nd an)-2.848 F F2(int)2.848 E F0(inde)2.848 E(x)-.15 E .228(into that string \()108 652.8 R F1(i)A F0 2.728(\). It)B .227(should return a non-zero v)2.727 F .227(alue if the history e)-.25 F.227(xpansion starting at)-.15 F F1(string[i])2.727 E F0 .227(should not)2.727 F .019(be performed; zero if the e)108 664.8 R .019(xpansion should be done.)-.15 F .019(It is intended for use by applications lik)5.019 F(e)-.1 E F2(bash)2.519 E F0 .019(that use)2.519 F(the history e)108 676.8 Q(xpansion character for additional purposes.)-.15 E(By def)5 E(ault, this v)-.1 E(ariable is set to)-.25 E F2(NULL)2.5 E F0(.)A/F310.95/Times-Bold@0 SF(FILES)72 693.6 Q F1(~/.history)109.666 705.6 Q F0(Def)144 717.6 Q(ault \214lename for reading and writing sa)-.1 E -.15(ve)-.2 G 2.5(dh).15 G(istory)-2.5 E(GNU History 4.3)72 768 Q(2002 January 31)131.79 E(6)195.95 E EP%%Page: 7 7%%BeginPageSetupBP%%EndPageSetup/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F(OR)-.18 E(Y\(3\))-.65 E/F1 10.95/Times-Bold@0 SF(SEE ALSO)72 84 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 96 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F2(The Gnu History Libr)108 108 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F2(bash)108 120 Q F0(\(1\))A F2 -.37(re)108 132 S(adline).37 EF0(\(3\))A F1 -.548(AU)72 148.8 S(THORS).548 E F0(Brian F)108 160.8 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108172.8 Q(g)-.18 E(Chet Rame)108 189.6 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E(chet@ins.CWR)108 201.6 Q(U.Edu)-.4 E F1 -.11(BU)72 218.4 S 2.738(GR).11G(EPOR)-2.738 E(TS)-.438 E F0 .16(If you \214nd a b)108 230.4 R .16(ug in the)-.2 F/F3 10/Times-Bold@0 SF(history)2.66 E F0(library)2.66 E2.66(,y)-.65 G .16(ou should report it.)-2.66 F .16(But \214rst, you should mak)5.16 F 2.66(es)-.1 G .16(ure that it really is)-2.66 F 2.5(ab)108 242.4 S(ug, and that it appears in the latest v)-2.7 E(ersion of the)-.15 E F3(history)2.5 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.).15 E .704(Once you ha)108 259.2 R 1.004 -.15(ve d)-.2 H .704(etermined that a b).15 F .704(ug actually e)-.2 F .704(xists, mail a b)-.15 F .705(ug report to)-.2 F F2 -.2(bu)3.205 G(g\255r).2 E(eadline)-.37 E F0(@)AF2(gnu.or)A(g)-.37 E F0 5.705(.I)C 3.205(fy)-5.705 G(ou)-3.205 E(ha)108271.2 Q 1.81 -.15(ve a \214)-.2 H 1.51(x, you are welcome to mail that as well!).15 F 1.509(Suggestions and `philosophical' b)6.509 F 1.509(ug reports may be)-.2 F(mailed to)108 283.2 Q F2 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F2(gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F3(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 300 Q(ug reports concerning this manual page should be directed to)-.2 E F2-.15(ch)2.5 G(et@ins.CWR).15 E -.25(U.)-.4 G(Edu).25 E F0(.).25 E(GNU History 4.3)72 768 Q(2002 January 31)131.79 E(7)195.95 E EP%%Trailerend%%EOF