diff options
Diffstat (limited to 'doc/history_3.ps')
-rw-r--r-- | doc/history_3.ps | 395 |
1 files changed, 199 insertions, 196 deletions
diff --git a/doc/history_3.ps b/doc/history_3.ps index c7a87fd..d7ba161 100644 --- a/doc/history_3.ps +++ b/doc/history_3.ps @@ -1,13 +1,13 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.19.2 -%%CreationDate: Tue Feb 8 11:13:01 2011 +%%CreationDate: Tue Feb 11 16:57:26 2014 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic %%DocumentSuppliedResources: procset grops 1.19 2 %%Pages: 7 %%PageOrder: Ascend -%%DocumentMedia: Default 595 842 0 () () +%%DocumentMedia: Default 612 792 0 () () %%Orientation: Portrait %%EndComments %%BeginDefaults @@ -189,17 +189,17 @@ setpacking %%EndProlog %%BeginSetup %%BeginFeature: *PageSize Default -<< /PageSize [ 595 842 ] /ImagingBBox null >> setpagedevice +<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice %%EndFeature %%IncludeResource: font Times-Roman %%IncludeResource: font Times-Bold %%IncludeResource: font Times-Italic 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 @@ -291,9 +291,9 @@ G(nts are relati).15 E .3 -.15(ve t)-.25 H 2.5(ot).15 G (This is a synon)5 E(ym for `!\2551'.)-.15 E F2(!)108 482.4 Q F3(string) A F0 .865(Refer to the most recent command preceding the current positi\ on in the history list starting with)9.33 F F3(string)144 494.4 Q F0(.) -.22 E F2(!?)108 506.4 Q F3(string)A F2([?])A F0 1.304(Refer to the most\ - recent command preceding the current postition in the history list con\ -taining)144 518.4 R F3(string)144 530.4 Q F0 5(.T).22 G(he trailing)-5 E +.22 E F2(!?)108 506.4 Q F3(string)A F2([?])A F0 1.503(Refer to the most\ + recent command preceding the current position in the history list cont\ +aining)144 518.4 R F3(string)144 530.4 Q F0 5(.T).22 G(he trailing)-5 E F2(?)2.5 E F0(may be omitted if)2.5 E F3(string)2.84 E F0(is follo)2.72 E(wed immediately by a ne)-.25 E(wline.)-.25 E/F4 12/Times-Bold@0 SF(^) 108 547.4 Q F3(string1)-5 I F4(^)5 I F3(string2)-5 I F4(^)5 I F0 2.63 @@ -321,8 +321,11 @@ F2 2.5(0\()108 660 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 672 Q 2.5 (ord. F)-.1 F(or the shell, this is the command w)-.15 E(ord.)-.1 E F3 (n)108.36 684 Q F0(The)30.64 E F3(n)2.5 E F0(th w)A(ord.)-.1 E F2(^)108 696 Q F0(The \214rst ar)32.67 E 2.5(gument. That)-.18 F(is, w)2.5 E -(ord 1.)-.1 E F2($)108 708 Q F0(The last ar)31 E(gument.)-.18 E -(GNU History 6.2)72 768 Q(2010 August 12)132.895 E(1)197.055 E 0 Cg EP +(ord 1.)-.1 E F2($)108 708 Q F0 .064(The last w)31 F 2.564(ord. This)-.1 +F .064(is usually the last ar)2.564 F .064(gument, b)-.18 F .064 +(ut will e)-.2 F .064(xpand to the zeroth w)-.15 F .063 +(ord if there is only)-.1 F(one w)144 720 Q(ord in the line.)-.1 E +(GNU History 6.3)72 768 Q(2013 June 27)138.175 E(1)202.335 E 0 Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -332,21 +335,21 @@ BP (ord matched by the most recent `?)-.1 E/F2 10/Times-Italic@0 SF(string) A F0(?' search.)A F2(x)108.77 96 Q F1<ad>A 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 108 Q F0 .316 -(All of the w)31 F .316(ords b)-.1 F .316(ut the zeroth.)-.2 F .315 +(viates `0\255)-.25 E F2(y)A F0('.)A F1(*)108 108 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(just one w)144 120 Q(ord in the e)-.1 E -.15(ve) +('. It)B .315(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 120 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 132 Q F0(Abbre)26 E(viates)-.25 E F2(x\255$)2.5 E F0(.)A F1<78ad>108 144 Q 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 160.8 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 177.6 Q F0 .183 -(After the optional w)108 189.6 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 201.6 Q F1(h) +-.15(ve)-.25 G(nt.).15 E F1(Modi\214ers)87 177.6 Q F0 .184 +(After the optional w)108 189.6 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 201.6 Q F1(h) 108 218.4 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 230.4 Q F0(Remo)32.67 E .3 -.15(ve a)-.15 H @@ -361,77 +364,77 @@ E -.15(xe)-.15 G(cute it.).15 E F1(q)108 278.4 Q F0 -.1 E F1(x)108 290.4 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 302.4 Q F2(old)A F1(/)A -F2(ne)A(w)-.15 E F1(/)A F0(Substitute)144 314.4 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 314.4 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 326.4 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 338.4 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 350.4 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 350.4 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 362.4 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 374.4 Q F0(Repeat the pre)27.67 E(vious substitution.)-.25 E F1 -(g)108 386.4 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 398.4 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 386.4 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 398.4 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 410.4 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 422.4 Q F0 -(.)A F1(G)108 434.4 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(PR)72 451.2 Q +-.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 422.4 Q F0(.)A +F1(G)108 434.4 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(PR)72 451.2 Q (OGRAMMING WITH HIST)-.329 E(OR)-.197 E 2.738(YF)-.383 G(UNCTIONS)-2.738 E F0(This section describes ho)108 463.2 Q 2.5(wt)-.25 G 2.5(ou)-2.5 G (se the History library in other programs.)-2.5 E F1(Intr)87 480 Q -(oduction to History)-.18 E F0 .796 +(oduction to History)-.18 E F0 .797 (The programmer using the History library has a)108 492 R -.25(va)-.2 G -.797(ilable functions for remembering lines on a history list,).25 F -.308(associating arbitrary data with a line, remo)108 504 R .308 +.796(ilable functions for remembering lines on a history list,).25 F +.307(associating arbitrary data with a line, remo)108 504 R .308 (ving lines from the list, searching through the list for a line con-) -.15 F .303(taining an arbitrary te)108 516 R .303 (xt string, and referencing an)-.15 F 2.803(yl)-.15 G .303 (ine in the list directly)-2.803 F 5.303(.I)-.65 G 2.803(na)-5.303 G -.303(ddition, a history)-2.803 F F2 -.2(ex)2.803 G(pansion).2 E F0 +.303(ddition, a history)-2.803 F F2 -.2(ex)2.802 G(pansion).2 E F0 (function is a)108 528 Q -.25(va)-.2 G(ilable which pro).25 E (vides for a consistent user interf)-.15 E(ace across dif)-.1 E (ferent programs.)-.25 E .059(The user using programs written with the \ History library has the bene\214t of a consistent user interf)108 544.8 -R .058(ace with a)-.1 F .917(set of well-kno)108 556.8 R .917 +R .059(ace with a)-.1 F .918(set of well-kno)108 556.8 R .917 (wn commands for manipulating the te)-.25 F .917(xt of pre)-.15 F .917 -(vious lines and using that te)-.25 F .917(xt in ne)-.15 F 3.418(wc)-.25 -G(om-)-3.418 E 4.184(mands. The)108 568.8 R 1.684(basic history manipul\ -ation commands are identical to the history substitution pro)4.184 F -1.683(vided by)-.15 F F1(bash)108 580.8 Q F0(.)A .903 +(vious lines and using that te)-.25 F .917(xt in ne)-.15 F 3.417(wc)-.25 +G(om-)-3.417 E 4.183(mands. The)108 568.8 R 1.684(basic history manipul\ +ation commands are identical to the history substitution pro)4.183 F +1.684(vided by)-.15 F F1(bash)108 580.8 Q F0(.)A .904 (If the programmer desires, he can use the Readline library)108 597.6 R -3.403(,w)-.65 G .904(hich includes some history manipulation by)-3.403 F +3.403(,w)-.65 G .903(hich includes some history manipulation by)-3.403 F (def)108 609.6 Q(ault, and has the added adv)-.1 E (antage of command line editing.)-.25 E .39(Before declaring an)108 626.4 R 2.89(yf)-.15 G .39(unctions using an)-2.89 F 2.89(yf)-.15 G .39 (unctionality the History library pro)-2.89 F .39 -(vides in other code, an appli-)-.15 F .066 -(cation writer should include the \214le)108 638.4 R F2(<r)4.232 E -(eadline/history)-.37 E(.h>)-.55 E F0 .067(in an)4.232 F 2.567<798c>-.15 -G .067(le that uses the History library')-2.567 F 2.567(sf)-.55 G -(eatures.)-2.567 E .539(It supplies e)108 650.4 R .538 +(vides in other code, an appli-)-.15 F .067 +(cation writer should include the \214le)108 638.4 R F2(<r)4.233 E +(eadline/history)-.37 E(.h>)-.55 E F0 .067(in an)4.233 F 2.566<798c>-.15 +G .066(le that uses the History library')-2.566 F 2.566(sf)-.55 G +(eatures.)-2.566 E .538(It supplies e)108 650.4 R .538 (xtern declarations for all of the library')-.15 F 3.038(sp)-.55 G .538 -(ublic functions and v)-3.038 F .538(ariables, and declares all of the) +(ublic functions and v)-3.038 F .539(ariables, and declares all of the) -.25 F(public data structures.)108 662.4 Q F1(History Storage)87 691.2 Q F0(The history list is an array of history entries.)108 703.2 Q 2.5(Ah)5 G(istory entry is declared as follo)-2.5 E(ws:)-.25 E F2(typedef void *) -108 720 Q F1(histdata_t;)2.5 E F0(GNU History 6.2)72 768 Q -(2010 August 12)132.895 E(2)197.055 E 0 Cg EP +108 720 Q F1(histdata_t;)2.5 E F0(GNU History 6.3)72 768 Q(2013 June 27) +138.175 E(2)202.335 E 0 Cg EP %%Page: 3 3 %%BeginPageSetup BP @@ -486,18 +489,18 @@ F1(const c)A(har *string)-.15 E F0(\))1.666 E (Change the time stamp associated with the most recent history entry to) 108 614.4 Q F1(string)2.5 E F0(.)A F1(HIST_ENTR)108 638.4 Q 2.5(Y*)-.18 G F2 -.18(re)C(mo).18 E -.1(ve)-.1 G(_history).1 E F0(\()4.166 E F1 -(int whic)A(h)-.15 E F0(\))1.666 E(Remo)108 650.4 Q .353 -.15(ve h)-.15 -H .053(istory entry at of).15 F(fset)-.25 E F1(whic)2.553 E(h)-.15 E F0 +(int whic)A(h)-.15 E F0(\))1.666 E(Remo)108 650.4 Q .352 -.15(ve h)-.15 +H .052(istory entry at of).15 F(fset)-.25 E F1(whic)2.553 E(h)-.15 E F0 .053(from the history)2.553 F 5.053(.T)-.65 G .053(he remo)-5.053 F -.15 -(ve)-.15 G 2.553(de).15 G .052(lement is returned so you can free the) +(ve)-.15 G 2.553(de).15 G .053(lement is returned so you can free the) -2.553 F(line, data, and containing structure.)108 662.4 Q F1 (histdata_t)108 686.4 Q F2(fr)2.5 E(ee_history_entry)-.18 E F0(\()4.166 -E F1(HIST_ENTR)A 2.5(Y*)-.18 G(histent)-2.5 E F0(\))1.666 E .933 +E F1(HIST_ENTR)A 2.5(Y*)-.18 G(histent)-2.5 E F0(\))1.666 E .934 (Free the history entry)108 698.4 R F1(histent)3.433 E F0 .933(and an) 3.433 F 3.433(yh)-.15 G .933(istory library pri)-3.433 F -.25(va)-.25 G -.933(te data associated with it.).25 F .934(Returns the applica-)5.933 F +.933(te data associated with it.).25 F .933(Returns the applica-)5.933 F (tion-speci\214c data so the caller can dispose of it.)108 710.4 Q -(GNU History 6.2)72 768 Q(2010 August 12)132.895 E(3)197.055 E 0 Cg EP +(GNU History 6.3)72 768 Q(2013 June 27)138.175 E(3)202.335 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -507,10 +510,10 @@ BP (Y*)-.18 G/F2 10/Times-Bold@0 SF -.18(re)C(place_history_entry).18 E F0 (\()4.166 E F1(int whic)A -.834(h, const)-.15 F -.15(ch)2.5 G(ar *line) .15 E 1.666(,h)-.1 G(istdata_t data)-1.666 E F0(\))3.332 E(Mak)108 96 Q -3.063(et)-.1 G .563(he history entry at of)-3.063 F(fset)-.25 E F1(whic) -3.063 E(h)-.15 E F0(ha)3.063 E -.15(ve)-.2 G F1(line)3.213 E F0(and) -3.063 E F1(data)3.063 E F0 5.562(.T)C .562 -(his returns the old entry so the caller can dis-)-5.562 F(pose of an) +3.062(et)-.1 G .562(he history entry at of)-3.062 F(fset)-.25 E F1(whic) +3.062 E(h)-.15 E F0(ha)3.062 E -.15(ve)-.2 G F1(line)3.212 E F0(and) +3.062 E F1(data)3.062 E F0 5.563(.T)C .563 +(his returns the old entry so the caller can dis-)-5.563 F(pose of an) 108 108 Q 2.5(ya)-.15 G(pplication-speci\214c data.)-2.5 E (In the case of an in)5 E -.25(va)-.4 G(lid).25 E F1(whic)2.5 E(h)-.15 E F0 2.5(,a)C F2(NULL)A F0(pointer is returned.)2.5 E F1(void)108 132 Q F2 @@ -534,10 +537,10 @@ G 2.5(ss).1 G 2.5(ti\215ed. The)-2.5 F -.25(va)2.5 G(lue is positi).25 E functions return information about the entire history list or indi)108 304.8 Q(vidual list entries.)-.25 E F1(HIST_ENTR)108 328.8 Q 2.5(Y*)-.18 G(*)-2.5 E F2(history_list)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E -.708(Return a)108 340.8 R F2(NULL)3.208 E F0 .708(terminated array of) -3.208 F F1(HIST_ENTR)3.208 E 3.208(Y*)-.18 G F0 .708 -(which is the current input history)B 5.707(.E)-.65 G .707 -(lement 0 of this)-5.707 F(list is the be)108 352.8 Q(ginning of time.) +.707(Return a)108 340.8 R F2(NULL)3.207 E F0 .707(terminated array of) +3.207 F F1(HIST_ENTR)3.207 E 3.208(Y*)-.18 G F0 .708 +(which is the current input history)B 5.708(.E)-.65 G .708 +(lement 0 of this)-5.708 F(list is the be)108 352.8 Q(ginning of time.) -.15 E(If there is no history)5 E 2.5(,r)-.65 G(eturn)-2.5 E F2(NULL)2.5 E F0(.)A F1(int)108 376.8 Q F2(wher)2.5 E(e_history)-.18 E F0(\()4.166 E F1(void)A F0(\))1.666 E(Returns the of)108 388.8 Q @@ -546,21 +549,21 @@ F1(void)A F0(\))1.666 E(Returns the of)108 388.8 Q (\))1.666 E 1.373 (Return the history entry at the current position, as determined by)108 424.8 R F2(wher)3.873 E(e_history\(\))-.18 E F0 6.373(.I)C 3.873(ft) --6.373 G 1.374(here is no entry)-3.873 F(there, return a)108 436.8 Q F2 +-6.373 G 1.373(here is no entry)-3.873 F(there, return a)108 436.8 Q F2 (NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(HIST_ENTR)108 460.8 Q 2.5(Y*) -.18 G F2(history_get)A F0(\()4.166 E F1(int of)A(fset)-.18 E F0(\)) -1.666 E .288(Return the history entry at position)108 472.8 R F1(of) +1.666 E .287(Return the history entry at position)108 472.8 R F1(of) 2.787 E(fset)-.18 E F0 2.787(,s)C .287(tarting from)-2.787 F F2 (history_base)2.787 E F0 5.287(.I)C 2.787(ft)-5.287 G .287 -(here is no entry there, or if)-2.787 F F1(of)2.787 E(fset)-.18 E F0 +(here is no entry there, or if)-2.787 F F1(of)2.788 E(fset)-.18 E F0 (is greater than the history length, return a)108 484.8 Q F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(time_t)108 508.8 Q F2(history_get_time)2.5 E F0(\()4.166 E F1(HIST_ENTR)A 2.5(Y*)-.18 G F0(\))-.834 E(Return the t\ ime stamp associated with the history entry passed as the ar)108 520.8 Q (gument.)-.18 E F1(int)108 544.8 Q F2(history_total_bytes)2.5 E F0(\() -4.166 E F1(void)A F0(\))1.666 E .391 +4.166 E F1(void)A F0(\))1.666 E .392 (Return the number of bytes that the primary history entries are using.) -108 556.8 R .392(This function returns the sum of the)5.392 F +108 556.8 R .391(This function returns the sum of the)5.392 F (lengths of all the lines in the history)108 568.8 Q(.)-.65 E F2(Mo)87 597.6 Q(ving Ar)-.1 E(ound the History List)-.18 E F0 (These functions allo)108 609.6 Q 2.5(wt)-.25 G(he current inde)-2.5 E @@ -572,121 +575,121 @@ ime stamp associated with the history entry passed as the ar)108 520.8 Q F F1(pos)3.29 E F0 .79(is less)3.29 F (than zero or greater than the number of history entries.)108 657.6 Q F1 (HIST_ENTR)108 681.6 Q 2.5(Y*)-.18 G F2(pr)A -.15(ev)-.18 G -(ious_history).15 E F0(\()4.166 E F1(void)A F0(\))1.666 E .207 -(Back up the current history of)108 693.6 R .207(fset to the pre)-.25 F -.207(vious history entry)-.25 F 2.708(,a)-.65 G .208 -(nd return a pointer to that entry)-2.708 F 5.208(.I)-.65 G 2.708(ft) --5.208 G .208(here is)-2.708 F(no pre)108 705.6 Q(vious entry)-.25 E 2.5 +(ious_history).15 E F0(\()4.166 E F1(void)A F0(\))1.666 E .208 +(Back up the current history of)108 693.6 R .208(fset to the pre)-.25 F +.208(vious history entry)-.25 F 2.707(,a)-.65 G .207 +(nd return a pointer to that entry)-2.707 F 5.207(.I)-.65 G 2.707(ft) +-5.207 G .207(here is)-2.707 F(no pre)108 705.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 729.6 Q 2.5(Y*)-.18 G F2(next_history)A F0(\()4.166 E F1 -(void)A F0(\))1.666 E(GNU History 6.2)72 768 Q(2010 August 12)132.895 E -(4)197.055 E 0 Cg EP +(void)A F0(\))1.666 E(GNU History 6.3)72 768 Q(2013 June 27)138.175 E(4) +202.335 E 0 Cg EP %%Page: 5 5 %%BeginPageSetup BP %%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(Mo)108 84 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.746 +(OR)-.18 E(Y\(3\))-.65 E(Mo)108 84 Q 1.046 -.15(ve t)-.15 H .746 +(he current history of).15 F .746(fset forw)-.25 F .746(ard to the ne) +-.1 F .746(xt history entry)-.15 F 3.246(,a)-.65 G .747 +(nd return the a pointer to that entry)-3.246 F 5.747(.I)-.65 G(f)-5.747 E(there is no ne)108 96 Q(xt entry)-.15 E 2.5(,r)-.65 G(eturn a)-2.5 E /F1 10/Times-Bold@0 SF(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(Sear)87 -124.8 Q(ching the History List)-.18 E F0 .005(These functions allo)108 -136.8 R 2.505(ws)-.25 G .006(earching of the history list for entries c\ -ontaining a speci\214c string.)-2.505 F .006(Searching may be)5.006 F -1.452(performed both forw)108 148.8 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/F2 10/Times-Italic@0 SF(anc)3.951 E(hor)-.15 E(ed)-.37 E F0(,)A +124.8 Q(ching the History List)-.18 E F0 .006(These functions allo)108 +136.8 R 2.506(ws)-.25 G .006(earching of the history list for entries c\ +ontaining a speci\214c string.)-2.506 F .005(Searching may be)5.005 F +1.451(performed both forw)108 148.8 R 1.451(ard and backw)-.1 F 1.451 +(ard from the current history position.)-.1 F 1.452(The search may be) +6.452 F/F2 10/Times-Italic@0 SF(anc)3.952 E(hor)-.15 E(ed)-.37 E F0(,)A (meaning that the string must match at the be)108 160.8 Q (ginning of the history entry)-.15 E(.)-.65 E F2(int)108 184.8 Q F1 (history_sear)2.5 E(ch)-.18 E F0(\()4.166 E F2(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 196.8 R F2(string)2.655 E F0 2.656(,s)C .156 +-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))1.666 E .156 +(Search the history for)108 196.8 R F2(string)2.656 E F0 2.656(,s)C .156 (tarting at the current history of)-2.656 F 2.656(fset. If)-.25 F F2 -(dir)2.656 E(ection)-.37 E F0 .156(is less than 0, then the search)2.656 -F .802(is through pre)108 208.8 R .802 +(dir)2.656 E(ection)-.37 E F0 .155(is less than 0, then the search)2.656 +F .801(is through pre)108 208.8 R .801 (vious entries, otherwise through subsequent entries.)-.25 F(If)5.801 E -F2(string)3.301 E F0 .801(is found, then the current his-)3.301 F .064 -(tory inde)108 220.8 R 2.564(xi)-.15 G 2.564(ss)-2.564 G .064 +F2(string)3.301 E F0 .802(is found, then the current his-)3.301 F .065 +(tory inde)108 220.8 R 2.565(xi)-.15 G 2.564(ss)-2.565 G .064 (et to that history entry)-2.564 F 2.564(,a)-.65 G .064(nd the v)-2.564 F .064(alue returned is the of)-.25 F .064 -(fset in the line of the entry where)-.25 F F2(string)2.565 E F0 -.1(wa) +(fset in the line of the entry where)-.25 F F2(string)2.564 E F0 -.1(wa) 108 232.8 S 2.5(sf).1 G 2.5(ound. Otherwise,)-2.5 F (nothing is changed, and a -1 is returned.)2.5 E F2(int)108 256.8 Q F1 (history_sear)2.5 E(ch_pr)-.18 E(e\214x)-.18 E F0(\()4.166 E F2(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 268.8 R F2(string)3.183 E F0 +1.666 E .683(Search the history for)108 268.8 R F2(string)3.183 E F0 3.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 1.063 -(must be)108 280.8 R 1.063(gin with)-.15 F F2(string)3.563 E F0 6.063 -(.I)C(f)-6.063 E F2(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.)108 -292.8 R(If)6.115 E F2(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 304.8 Q(alue is 0.)-.25 E +(fset. The)-.25 F .683(search is anchored: matching lines)3.183 F 1.064 +(must be)108 280.8 R 1.064(gin with)-.15 F F2(string)3.564 E F0 6.064 +(.I)C(f)-6.064 E F2(dir)3.564 E(ection)-.37 E F0 1.063 +(is less than 0, then the search is through pre)3.564 F 1.063 +(vious entries, otherwise)-.25 F 1.114(through subsequent entries.)108 +292.8 R(If)6.114 E F2(string)3.614 E F0 1.114 +(is found, then the current history inde)3.614 F 3.615(xi)-.15 G 3.615 +(ss)-3.615 G 1.115(et to that entry)-3.615 F 3.615(,a)-.65 G 1.115 +(nd the)-3.615 F(return v)108 304.8 Q(alue is 0.)-.25 E (Otherwise, nothing is changed, and a -1 is returned.)5 E F2(int)108 328.8 Q F1(history_sear)2.5 E(ch_pos)-.18 E F0(\()4.166 E F2(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 340.8 R F2(string) -3.103 E F0 .603(in the history list, starting at)3.103 F F2(pos)3.104 E +-.37 F(pos)2.5 E F0(\))3.332 E .604(Search for)108 340.8 R F2(string) +3.104 E F0 .604(in the history list, starting at)3.104 F F2(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 F2(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 +G .603(nto the list.)-3.104 F(If)5.603 E F2(dir)3.103 E(ection)-.37 E F0 +.603(is ne)3.103 F -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G(,).15 E .608 (the search proceeds backw)108 352.8 R .608(ard from)-.1 F F2(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 364.8 Q F2(string)2.5 E F0 -.1 (wa)2.5 G 2.5(sf).1 G(ound, or -1 otherwise.)-2.5 E F1 (Managing the History File)87 393.6 Q F0 .035(The History library can r\ -ead the history from and write it to a \214le.)108 405.6 R .036 +ead the history from and write it to a \214le.)108 405.6 R .035 (This section documents the functions for)5.035 F (managing a history \214le.)108 417.6 Q F2(int)108 441.6 Q F1 -.18(re) 2.5 G(ad_history).18 E F0(\()4.166 E F2(const c)A(har *\214lename)-.15 E -F0(\))1.666 E .151(Add the contents of)108 453.6 R F2(\214lename)2.651 E -F0 .151(to the history list, a line at a time.)2.651 F(If)5.15 E F2 -(\214lename)2.65 E F0(is)2.65 E F1(NULL)2.65 E F0 2.65(,t)C .15 -(hen read from)-2.65 F F2(~/.his-)2.65 E(tory)108 465.6 Q F0 5(.R)C +F0(\))1.666 E .15(Add the contents of)108 453.6 R F2(\214lename)2.65 E +F0 .15(to the history list, a line at a time.)2.65 F(If)5.151 E F2 +(\214lename)2.651 E F0(is)2.651 E F1(NULL)2.651 E F0 2.651(,t)C .151 +(hen read from)-2.651 F F2(~/.his-)2.651 E(tory)108 465.6 Q F0 5(.R)C (eturns 0 if successful, or)-5 E F1(err)2.5 E(no)-.15 E F0(if not.)2.5 E F2(int)108 489.6 Q F1 -.18(re)2.5 G(ad_history_range).18 E F0(\()4.166 E F2(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) +(om, int)-.45 F(to)2.5 E F0(\))3.332 E .053(Read a range of lines from) 108 501.6 R F2(\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 F2(fr)2.553 E(om)-.45 E F0 .053(and end at)2.553 F F2(to)2.553 E -F0(.)A(If)108 513.6 Q F2(fr)2.889 E(om)-.45 E F0 .389 -(is zero, start at the be)2.889 F 2.889(ginning. If)-.15 F F2(to)2.889 E -F0 .389(is less than)2.889 F F2(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 F2 -(\214lename)2.888 E F0(is)108 525.6 Q F1(NULL)2.5 E F0 2.5(,t)C +5.053 F F2(fr)2.553 E(om)-.45 E F0 .052(and end at)2.553 F F2(to)2.552 E +F0(.)A(If)108 513.6 Q F2(fr)2.888 E(om)-.45 E F0 .388 +(is zero, start at the be)2.888 F 2.889(ginning. If)-.15 F F2(to)2.889 E +F0 .389(is less than)2.889 F F2(fr)2.889 E(om)-.45 E F0 2.889(,t)C .389 +(hen read until the end of the \214le.)-2.889 F(If)5.389 E F2 +(\214lename)2.889 E F0(is)108 525.6 Q F1(NULL)2.5 E F0 2.5(,t)C (hen read from)-2.5 E F2(~/.history)2.5 E F0 5(.R)C (eturns 0 if successful, or)-5 E F1(err)2.5 E(no)-.15 E F0(if not.)2.5 E F2(int)108 549.6 Q F1(write_history)2.5 E F0(\()4.166 E F2(const c)A -(har *\214lename)-.15 E F0(\))1.666 E .961(Write the current history to) -108 561.6 R F2(\214lename)3.461 E F0 3.461(,o)C -.15(ve)-3.611 G +(har *\214lename)-.15 E F0(\))1.666 E .962(Write the current history to) +108 561.6 R F2(\214lename)3.462 E F0 3.461(,o)C -.15(ve)-3.611 G (rwriting).15 E F2(\214lename)3.461 E F0 .961(if necessary)3.461 F 5.961 -(.I)-.65 G(f)-5.961 E F2(\214lename)3.462 E F0(is)3.462 E F1(NULL)3.462 -E F0 3.462(,t)C .962(hen write)-3.462 F(the history list to)108 573.6 Q +(.I)-.65 G(f)-5.961 E F2(\214lename)3.461 E F0(is)3.461 E F1(NULL)3.461 +E F0 3.461(,t)C .961(hen write)-3.461 F(the history list to)108 573.6 Q F2(~/.history)2.5 E F0 5(.R)C(eturns 0 on success, or)-5 E F1(err)2.5 E (no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F2(int)108 609.6 Q F1(append_history)2.5 E F0(\()4.166 E F2(int nelements,)A(const c)1.666 -E(har *\214lename)-.15 E F0(\))1.666 E .839(Append the last)108 621.6 R -F2(nelements)3.339 E F0 .839(of the history list to)3.339 F F2 +E(har *\214lename)-.15 E F0(\))1.666 E .838(Append the last)108 621.6 R +F2(nelements)3.338 E F0 .839(of the history list to)3.339 F F2 (\214lename)3.339 E F0 5.839(.I)C(f)-5.839 E F2(\214lename)3.339 E F0 -(is)3.339 E F1(NULL)3.339 E F0 3.339(,t)C .838(hen append to)-3.339 F F2 -(~/.history)3.338 E F0(.)A(Returns 0 on success, or)108 633.6 Q F1(err) +(is)3.339 E F1(NULL)3.339 E F0 3.339(,t)C .839(hen append to)-3.339 F F2 +(~/.history)3.339 E F0(.)A(Returns 0 on success, or)108 633.6 Q F1(err) 2.5 E(no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F2(int)108 657.6 Q F1(history_truncate_\214le)2.5 E F0(\()4.166 E F2(const c)A (har *\214lename)-.15 E 1.666(,i)-.1 G(nt nlines)-1.666 E F0(\))1.666 E --.35(Tr)108 669.6 S .38(uncate the history \214le).35 F F2(\214lename) -2.88 E F0 2.88(,l)C(ea)-2.88 E .38(ving only the last)-.2 F F2(nlines) -2.881 E F0 2.881(lines. If)2.881 F F2(\214lename)2.881 E F0(is)2.881 E -F1(NULL)2.881 E F0 2.881(,t)C(hen)-2.881 E F2(~/.history)2.881 E F0(is) -2.881 E 2.5(truncated. Returns)108 681.6 R 2.5(0o)2.5 G 2.5(ns)-2.5 G +-.35(Tr)108 669.6 S .381(uncate the history \214le).35 F F2(\214lename) +2.881 E F0 2.881(,l)C(ea)-2.881 E .381(ving only the last)-.2 F F2 +(nlines)2.881 E F0 2.88(lines. If)2.881 F F2(\214lename)2.88 E F0(is) +2.88 E F1(NULL)2.88 E F0 2.88(,t)C(hen)-2.88 E F2(~/.history)2.88 E F0 +(is)2.88 E 2.5(truncated. Returns)108 681.6 R 2.5(0o)2.5 G 2.5(ns)-2.5 G (uccess, or)-2.5 E F1(err)2.5 E(no)-.15 E F0(on f)2.5 E(ailure.)-.1 E -(GNU History 6.2)72 768 Q(2010 August 12)132.895 E(5)197.055 E 0 Cg EP +(GNU History 6.3)72 768 Q(2013 June 27)138.175 E(5)202.335 E 0 Cg EP %%Page: 6 6 %%BeginPageSetup BP @@ -698,11 +701,11 @@ F0(These functions implement history e)108 96 Q(xpansion.)-.15 E/F2 10 F2 -.15(ch)C(ar *string).15 E 1.666(,c)-.1 G(har **output)-1.816 E F0 (\))1.666 E(Expand)108 132 Q F2(string)2.5 E F0 2.5(,p)C (lacing the result into)-2.5 E F2(output)2.5 E F0 2.5(,ap)C -(ointer to a string.)-2.5 E(Returns:)5 E 31(0I)144 144 S 3.066(fn)-31 G -3.066(oe)-3.066 G .566(xpansions took place \(or)-3.216 F 3.065(,i)-.4 G -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 156 Q +(ointer to a string.)-2.5 E(Returns:)5 E 31(0I)144 144 S 3.065(fn)-31 G +3.065(oe)-3.065 G .565(xpansions took place \(or)-3.215 F 3.065(,i)-.4 G +3.065(ft)-3.065 G .565(he only change in the te)-3.065 F .566(xt w)-.15 +F .566(as the remo)-.1 F -.25(va)-.15 G 3.066(lo).25 G 3.066(fe)-3.066 G +(scape)-3.066 E(characters preceding the history e)180 156 Q (xpansion character\);)-.15 E 31(1i)144 168 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)144 180 R(there w)2.5 E(as an error in e)-.1 E(xpansion;)-.15 E 31(2i)144 192 S @@ -713,33 +716,33 @@ E(.)-.55 E(If an error ocurred in e)108 204 Q(xpansion, then)-.15 E F2 (rror message.).15 E F2 -.15(ch)108 228 S(ar *).15 E F1(get_history_e) 2.5 E -.1(ve)-.15 G(nt).1 E F0(\()4.166 E F2(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 240 R .262(xt of the history e) --.15 F -.15(ve)-.25 G .262(nt be).15 F .263(ginning at)-.15 F F2(string) +E F0(\))3.332 E .263(Returns the te)108 240 R .263(xt of the history e) +-.15 F -.15(ve)-.25 G .263(nt be).15 F .263(ginning at)-.15 F F2(string) 2.763 E F0(+)2.763 E F2(*cinde)2.763 E(x)-.2 E F0(.)A F2(*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 252 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 F2(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 F2(string)3.209 -E F0 .709(where the history e)3.209 F -.15(ve)-.25 G .709 -(nt speci\214ca-).15 F .527(tion be)108 264 R(gins.)-.15 E F2(qc)5.527 E -(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 +(x)-.2 E F0 .262(is modi\214ed to point to after the)2.762 F -2.15 -.25 +(ev e)108 252 T .709(nt speci\214er).25 F 5.709(.A)-.55 G 3.209(tf) +-5.709 G .709(unction entry)-3.209 F(,)-.65 E F2(cinde)3.209 E(x)-.2 E +F0 .709(points to the inde)3.209 F 3.209(xi)-.15 G(nto)-3.209 E F2 +(string)3.21 E F0 .71(where the history e)3.21 F -.15(ve)-.25 G .71 +(nt speci\214ca-).15 F .528(tion be)108 264 R(gins.)-.15 E F2(qc)5.528 E +(har)-.15 E F0 .527(is a character that is allo)3.028 F .527 +(wed to end the e)-.25 F -.15(ve)-.25 G .527 (nt speci\214cation in addition to the `).15 F(`normal')-.74 E(')-.74 E (terminating characters.)108 276 Q F2 -.15(ch)108 300 S(ar **).15 E F1 (history_tok)2.5 E(enize)-.1 E F0(\()4.166 E F2(const c)A(har *string) --.15 E F0(\))1.666 E .239(Return an array of tok)108 312 R .239 -(ens parsed out of)-.1 F F2(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 +-.15 E F0(\))1.666 E .238(Return an array of tok)108 312 R .238 +(ens parsed out of)-.1 F F2(string)2.738 E F0 2.738(,m)C .239 +(uch as the shell might.)-2.738 F .239(The tok)5.239 F .239 (ens are split on the charac-)-.1 F(ters in the)108 324 Q F1(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 F2 -.15(ch)108 348 S(ar *).15 E F1(history_ar)2.5 E (g_extract)-.1 E F0(\()4.166 E F2(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 360 R .025(gment consisting of the)-.15 F F2 +(last, const)2.5 F -.15(ch)2.5 G(ar *string).15 E F0(\))3.332 E .026 +(Extract a string se)108 360 R .026(gment consisting of the)-.15 F F2 <8c72>2.526 E(st)-.1 E F0(through)2.526 E F2(last)2.526 E F0(ar)2.526 E -.026(guments present in)-.18 F F2(string)2.526 E F0 5.026(.A)C -.18(rg) --5.026 G .026(uments are split).18 F(using)108 372 Q F1(history_tok)2.5 +.025(guments present in)-.18 F F2(string)2.525 E F0 5.025(.A)C -.18(rg) +-5.025 G .025(uments are split).18 F(using)108 372 Q F1(history_tok)2.5 E(enize\(\))-.1 E F0(.)A F1(History V)87 400.8 Q(ariables)-.92 E F0 (This section describes the e)108 412.8 Q(xternally-visible v)-.15 E (ariables e)-.25 E(xported by the GNU History Library)-.15 E(.)-.65 E F2 @@ -753,12 +756,12 @@ F2(int)108 508.8 Q F1(history_max_entries)2.5 E F0 (int)108 544.8 Q F1(history_wite_timestamps)2.5 E F0 1.468 (If non-zero, timestamps are written to the history \214le, so the)108 556.8 R 3.968(yc)-.15 G 1.468(an be preserv)-3.968 F 1.468 -(ed between sessions.)-.15 F(The)6.468 E(def)108 568.8 Q .438(ault v)-.1 +(ed between sessions.)-.15 F(The)6.469 E(def)108 568.8 Q .439(ault v)-.1 F .439(alue is 0, meaning that timestamps are not sa)-.25 F -.15(ve)-.2 G 2.939(d. The).15 F .439(current timestamp format uses the v)2.939 F -.439(alue of)-.25 F F2(history_comment_c)108 580.8 Q(har)-.15 E F0 .051 -(to delimit timestamp entries in the history \214le.)2.552 F .051 -(If that v)5.051 F .051(ariable does not ha)-.25 F .351 -.15(ve a v)-.2 +.438(alue of)-.25 F F2(history_comment_c)108 580.8 Q(har)-.15 E F0 .051 +(to delimit timestamp entries in the history \214le.)2.551 F .051 +(If that v)5.051 F .052(ariable does not ha)-.25 F .352 -.15(ve a v)-.2 H(alue)-.1 E(\(the def)108 592.8 Q (ault\), timestamps will not be written.)-.1 E F2 -.15(ch)108 616.8 S (ar).15 E F1(history_expansion_char)2.5 E F0 @@ -769,14 +772,14 @@ H(alue)-.1 E(\(the def)108 592.8 Q (The character that in)108 664.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 F1(^)2.5 E F0(.)A F2 -.15(ch)108 688.8 S(ar).15 E F1 -(history_comment_char)2.5 E F0 .116(During tok)108 700.8 R .117 +(history_comment_char)2.5 E F0 .117(During tok)108 700.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 .277 +-.1 F .117(ord, then it and all subsequent char)-.1 F(-)-.2 E .276 (acters up to a ne)108 712.8 R .276 (wline are ignored, suppressing history e)-.25 F .276 -(xpansion for the remainder of the line.)-.15 F .276(This is dis-)5.276 -F(abled by def)108 724.8 Q(ault.)-.1 E(GNU History 6.2)72 768 Q -(2010 August 12)132.895 E(6)197.055 E 0 Cg EP +(xpansion for the remainder of the line.)-.15 F .277(This is dis-)5.276 +F(abled by def)108 724.8 Q(ault.)-.1 E(GNU History 6.3)72 768 Q +(2013 June 27)138.175 E(6)202.335 E 0 Cg EP %%Page: 7 7 %%BeginPageSetup BP @@ -790,30 +793,30 @@ F2 2.5("\\)2.5 G(t\\n\(\)<>;&|")-2.5 E F0(.)A F1 -.15(ch)108 120 S(ar *) .15 E F2(history_no_expand_chars)2.5 E F0 2.054 (The list of characters which inhibit history e)108 132 R 2.054 (xpansion if found immediately follo)-.15 F(wing)-.25 E F2 -(history_expan-)4.555 E(sion_char)108 144 Q F0 5(.T)C(he def)-5 E +(history_expan-)4.554 E(sion_char)108 144 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 168 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 180 R F1(:)2.901 E F0(and)2.901 E F1(?)2.901 E F0 + to space, tab,)108 180 R F1(:)2.901 E F0(and)2.901 E F1(?)2.902 E F0 (in the case of a substring search.)108 192 Q(The def)5 E(ault is empty) -.1 E(.)-.65 E F1(int)108 216 Q F2(history_quotes_inhibit_expansion)2.5 -E F0 .624(If non-zero, single-quoted w)108 228 R .625 -(ords are not scanned for the history e)-.1 F .625(xpansion character) --.15 F 5.625(.T)-.55 G .625(he def)-5.625 F .625(ault v)-.1 F .625 +E F0 .625(If non-zero, single-quoted w)108 228 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 240 Q F1(rl_lineb)108 264 Q(uf_func_t *)-.2 E F2 -(history_inhibit_expansion_function)2.5 E F0 .348 +(history_inhibit_expansion_function)2.5 E F0 .347 (This should be set to the address of a function that tak)108 276 R .348 -(es tw)-.1 F 2.848(oa)-.1 G -.18(rg)-2.848 G .347(uments: a).18 F F2 -.347(char *)2.847 F F0(\()2.847 E F1(string)A F0 2.847(\)a)C .347(nd an) --2.847 F F2(int)2.847 E F0(inde)2.847 E(x)-.15 E .227 -(into that string \()108 288 R F1(i)A F0 2.727(\). It)B .227 +(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 288 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.728 E F0 .228 -(should not)2.728 F .019(be performed; zero if the e)108 300 R .019 +.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 300 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 .018(that use)2.519 F(the history e)108 312 Q +2.519 E F0 .019(that use)2.519 F(the history e)108 312 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/F3 10.95/Times-Bold@0 SF(FILES)72 328.8 Q F1(~/.history)109.666 340.8 Q F0 @@ -827,26 +830,26 @@ F1(bash)108 405.6 Q F0(\(1\))A F1 -.37(re)108 417.6 S(adline).37 E F0 (ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 458.4 Q(g)-.18 E(Chet Rame)108 475.2 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 487.2 Q(U.Edu)-.4 E F3 -.11(BU)72 504 S 2.738(GR).11 G -(EPOR)-2.738 E(TS)-.438 E F0 .16(If you \214nd a b)108 516 R .16 +(chet.rame)108 487.2 Q(y@case.edu)-.15 E F3 -.11(BU)72 504 S 2.738(GR) +.11 G(EPOR)-2.738 E(TS)-.438 E F0 .16(If you \214nd a b)108 516 R .16 (ug in the)-.2 F F2(history)2.66 E F0(library)2.66 E 2.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 528 S (ug, and that it appears in the latest v)-2.7 E(ersion of the)-.15 E F2 -(history)2.5 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.).15 E .705 -(Once you ha)108 544.8 R 1.005 -.15(ve d)-.2 H .705(etermined that a b) -.15 F .704(ug actually e)-.2 F .704(xists, mail a b)-.15 F .704 -(ug report to)-.2 F F1 -.2(bu)3.204 G(g\255r).2 E(eadline)-.37 E F0(@)A -F1(gnu.or)A(g)-.37 E F0 5.704(.I)C 3.204(fy)-5.704 G(ou)-3.204 E(ha)108 -556.8 Q 1.809 -.15(ve a \214)-.2 H 1.509 -(x, you are welcome to mail that as well!).15 F 1.51 -(Suggestions and `philosophical' b)6.51 F 1.51(ug reports may be)-.2 F +(history)2.5 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.).15 E .704 +(Once you ha)108 544.8 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 F1 -.2(bu)3.205 G(g\255r).2 E(eadline)-.37 E F0(@)A +F1(gnu.or)A(g)-.37 E F0 5.705(.I)C 3.205(fy)-5.705 G(ou)-3.205 E(ha)108 +556.8 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 568.8 Q F1 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F1 (gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F2 (gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 585.6 Q (ug reports concerning this manual page should be directed to)-.2 E F1 --.15(ch)2.5 G(et@ins.CWR).15 E -.25(U.)-.4 G(Edu).25 E F0(.).25 E -(GNU History 6.2)72 768 Q(2010 August 12)132.895 E(7)197.055 E 0 Cg EP +-.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.).25 E +(GNU History 6.3)72 768 Q(2013 June 27)138.175 E(7)202.335 E 0 Cg EP %%Trailer end %%EOF |