Diff for /embedaddon/readline/doc/history_3.ps between versions 1.1.1.1 and 1.1.1.2

version 1.1.1.1, 2014/07/30 08:16:46 version 1.1.1.2, 2021/03/17 01:01:01
Line 1 Line 1
 %!PS-Adobe-3.0  %!PS-Adobe-3.0
%%Creator: groff version 1.19.2%%Creator: groff version 1.22.4
%%CreationDate: Tue Feb 11 16:57:26 2014%%CreationDate: Mon Oct 12 10:59:26 2020
 %%DocumentNeededResources: font Times-Roman  %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold  %%+ font Times-Bold
 %%+ font Times-Italic  %%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.19 2%%DocumentSuppliedResources: procset grops 1.22 4
 %%Pages: 7  %%Pages: 7
 %%PageOrder: Ascend  %%PageOrder: Ascend
 %%DocumentMedia: Default 612 792 0 () ()  %%DocumentMedia: Default 612 792 0 () ()
Line 14 Line 14
 %%PageMedia: Default  %%PageMedia: Default
 %%EndDefaults  %%EndDefaults
 %%BeginProlog  %%BeginProlog
%%BeginResource: procset grops 1.19 2%%BeginResource: procset grops 1.22 4
 %!PS-Adobe-3.0 Resource-ProcSet  %!PS-Adobe-3.0 Resource-ProcSet
 /setpacking where{  /setpacking where{
 pop  pop
Line 72  exch pop add exch pop Line 72  exch pop add exch pop
 /level0 save def  /level0 save def
 1 setlinecap  1 setlinecap
 1 setlinejoin  1 setlinejoin
   DEFS/BPhook known{DEFS begin BPhook end}if
 72 RES div dup scale  72 RES div dup scale
 LS{  LS{
 90 rotate  90 rotate
Line 137  pop Line 138  pop
 findfont  findfont
 dup maxlength 1 index/FontName known not{1 add}if dict begin  dup maxlength 1 index/FontName known not{1 add}if dict begin
 {  {
1 index/FID ne{def}{pop pop}ifelse1 index/FID ne
 2 index/UniqueID ne
 and
 {def}{pop pop}ifelse
 }forall  }forall
 /Encoding exch def  /Encoding exch def
 dup/FontName exch def  dup/FontName exch def
Line 175  newpath Line 179  newpath
 userdict begin  userdict begin
 /showpage{}def  /showpage{}def
 /setpagedevice{}def  /setpagedevice{}def
   mark
 }bind def  }bind def
 /PEND{  /PEND{
   cleartomark
 countdictstack CNT sub{end}repeat  countdictstack CNT sub{end}repeat
 level1 restore  level1 restore
 }bind def  }bind def
Line 229  def/PL 792 def/LS false def/ENC0[/asciicircum/asciitil Line 235  def/PL 792 def/LS false def/ENC0[/asciicircum/asciitil
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME)-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E/F1
.219 E F0(history \255 GNU History Library)108 96 Q F1(COPYRIGHT)7210.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0
112.8 Q F0(The GNU History Library is Cop)108 124.8 Q(history \255 GNU History Library)108 96 Q F1(COPYRIGHT)72 112.8 Q F0
(yright \251 1989-2011 by the Free Softw)-.1 E(are F)-.1 E(The GNU History Library is Cop)108 124.8 Q
 (yright \251 1989-2020 by the Free Softw)-.1 E(are F)-.1 E
 (oundation, Inc.)-.15 E F1(DESCRIPTION)72 141.6 Q F0(Man)108 153.6 Q  (oundation, Inc.)-.15 E F1(DESCRIPTION)72 141.6 Q F0(Man)108 153.6 Q
 2.81(yp)-.15 G .31(rograms read input from the user a line at a time.)  2.81(yp)-.15 G .31(rograms read input from the user a line at a time.)
 -2.81 F .309(The GNU History library is able to k)5.309 F .309  -2.81 F .309(The GNU History library is able to k)5.309 F .309
 (eep track of)-.1 F .024(those lines, associate arbitrary data with eac\  (eep track of)-.1 F .024(those lines, associate arbitrary data with eac\
 h line, and utilize information from pre)108 165.6 R .024  h line, and utilize information from pre)108 165.6 R .024
 (vious lines in composing)-.25 F(ne)108 177.6 Q 2.5(wo)-.25 G(nes.)-2.5  (vious lines in composing)-.25 F(ne)108 177.6 Q 2.5(wo)-.25 G(nes.)-2.5
E F1(HIST)72 199.2 Q(OR)-.197 E 2.738(YE)-.383 G(XP)-2.738 E(ANSION)-.81E F1(HIST)72 194.4 Q(OR)-.197 E 2.738(YE)-.383 G(XP)-2.738 E(ANSION)-.81
E F0 .823(The history library supports a history e)108 211.2 R .822E F0 .823(The history library supports a history e)108 206.4 R .822
 (xpansion feature that is identical to the history e)-.15 F .822  (xpansion feature that is identical to the history e)-.15 F .822
 (xpansion in)-.15 F/F2 10/Times-Bold@0 SF(bash.)3.322 E F0  (xpansion in)-.15 F/F2 10/Times-Bold@0 SF(bash.)3.322 E F0
(This section describes what syntax features are a)108 223.2 Q -.25(va)(This section describes what syntax features are a)108 218.4 Q -.25(va)
-.2 G(ilable.).25 E 1.305(History e)108 240 R 1.305-.2 G(ilable.).25 E 1.305(History e)108 235.2 R 1.305
 (xpansions introduce w)-.15 F 1.306(ords from the history list into the\  (xpansions introduce w)-.15 F 1.306(ords from the history list into the\
  input stream, making it easy to repeat)-.1 F .21   input stream, making it easy to repeat)-.1 F .21
(commands, insert the ar)108 252 R .21(guments to a pre)-.18 F .209(commands, insert the ar)108 247.2 R .21(guments to a pre)-.18 F .209
 (vious command into the current input line, or \214x errors in pre)-.25  (vious command into the current input line, or \214x errors in pre)-.25
F(vious)-.25 E(commands quickly)108 264 Q(.)-.65 E 1.296(History e)108F(vious)-.25 E(commands quickly)108 259.2 Q(.)-.65 E 1.296(History e)108
280.8 R 1.297(xpansion is usually performed immediately after a complet\276 R 1.297(xpansion is usually performed immediately after a complete \
e line is read.)-.15 F 1.297(It tak)6.297 F 1.297(es place in tw)-.1 Fline is read.)-.15 F 1.297(It tak)6.297 F 1.297(es place in tw)-.1 F(o)
(o)-.1 E 2.855(parts. The)108 292.8 R .354(\214rst is to determine whic\-.1 E 2.855(parts. The)108 288 R .354(\214rst is to determine which lin\
h line from the history list to use during substitution.)2.855 F .354e from the history list to use during substitution.)2.855 F .354
 (The second is to)5.354 F .116  (The second is to)5.354 F .116
 (select portions of that line for inclusion into the current one.)108  (select portions of that line for inclusion into the current one.)108
304.8 R .117(The line selected from the history is the)5.116 F/F3 10300 R .117(The line selected from the history is the)5.116 F/F3 10
 /Times-Italic@0 SF -.15(ev)2.617 G(ent).15 E F0(,)A .846  /Times-Italic@0 SF -.15(ev)2.617 G(ent).15 E F0(,)A .846
(and the portions of that line that are acted upon are)108 316.8 R F3(and the portions of that line that are acted upon are)108 312 R F3(wor)
(wor)3.346 E(ds)-.37 E F0 5.846(.V)C(arious)-6.956 E F3(modi\214er)3.3463.346 E(ds)-.37 E F0 5.846(.V)C(arious)-6.956 E F3(modi\214er)3.346 E(s)
E(s)-.1 E F0 .846(are a)3.346 F -.25(va)-.2 G .845(ilable to manipulate)-.1 E F0 .846(are a)3.346 F -.25(va)-.2 G .845(ilable to manipulate).25
.25 F .304(the selected w)108 328.8 R 2.804(ords. The)-.1 F .304F .304(the selected w)108 324 R 2.804(ords. The)-.1 F .304(line is brok)
(line is brok)2.804 F .304(en into w)-.1 F .304(ords in the same f)-.1 F2.804 F .304(en into w)-.1 F .304(ords in the same f)-.1 F .304
.304(ashion as)-.1 F F2(bash)2.804 E F0 .305(ashion as)-.1 F F2(bash)2.804 E F0 .305(does when reading input, so)
(does when reading input, so)2.804 F .539(that se)108 340.8 R -.15(ve)2.804 F .539(that se)108 336 R -.15(ve)-.25 G .539(ral w).15 F .539
-.25 G .539(ral w).15 F .539(ords that w)-.1 F .539(ords that w)-.1 F .539
 (ould otherwise be separated are considered one w)-.1 F .538  (ould otherwise be separated are considered one w)-.1 F .538
 (ord when surrounded by quotes)-.1 F .307(\(see the description of)108  (ord when surrounded by quotes)-.1 F .307(\(see the description of)108
352.8 R F2(history_tok)2.807 E(enize\(\))-.1 E F0(belo)2.807 E 2.807348 R F2(history_tok)2.807 E(enize\(\))-.1 E F0(belo)2.807 E 2.807
 (w\). History)-.25 F -.15(ex)2.807 G .307  (w\). History)-.25 F -.15(ex)2.807 G .307
 (pansions are introduced by the appearance of).15 F .52(the history e)  (pansions are introduced by the appearance of).15 F .52(the history e)
108 364.8 R .52(xpansion character)-.15 F 3.02(,w)-.4 G .52(hich is)108 360 R .52(xpansion character)-.15 F 3.02(,w)-.4 G .52(hich is)-3.02
-3.02 F F2(!)3.853 E F0 .52(by def)3.853 F 3.02(ault. Only)-.1 F .52F F2(!)3.853 E F0 .52(by def)3.853 F 3.02(ault. Only)-.1 F .52
 (backslash \()3.02 F F2(\\).833 E F0 3.02(\)a).833 G .52  (backslash \()3.02 F F2(\\).833 E F0 3.02(\)a).833 G .52
(nd single quotes can quote the)-3.02 F(history e)108 376.8 Q(nd single quotes can quote the)-3.02 F(history e)108 372 Q
(xpansion character)-.15 E(.)-.55 E F2(Ev)87 393.6 Q(ent Designators)-.1(xpansion character)-.15 E(.)-.55 E F2(Ev)87 388.8 Q(ent Designators)-.1
E F0 .204(An e)108 405.6 R -.15(ve)-.25 G .204(nt designator is a refer\E F0 .204(An e)108 400.8 R -.15(ve)-.25 G .204(nt designator is a refer\
 ence to a command line entry in the history list.).15 F .205  ence to a command line entry in the history list.).15 F .205
(Unless the reference is abso-)5.204 F(lute, e)108 417.6 Q -.15(ve)-.25(Unless the reference is abso-)5.204 F(lute, e)108 412.8 Q -.15(ve)-.25
 G(nts are relati).15 E .3 -.15(ve t)-.25 H 2.5(ot).15 G  G(nts are relati).15 E .3 -.15(ve t)-.25 H 2.5(ot).15 G
(he current position in the history list.)-2.5 E F2(!)108 434.4 Q F0(he current position in the history list.)-2.5 E F2(!)108 429.6 Q F0
(Start a history substitution, e)32.67 E(xcept when follo)-.15 E(Start a history substitution, e)144 429.6 Q(xcept when follo)-.15 E
 (wed by a)-.25 E F2(blank)2.5 E F0 2.5(,n)C -.25(ew)-2.5 G  (wed by a)-.25 E F2(blank)2.5 E F0 2.5(,n)C -.25(ew)-2.5 G
(line, = or \(.).25 E F2(!)108 446.4 Q F3(n)A F0(Refer to command line)(line, = or \(.).25 E F2(!)108 441.6 Q F3(n)A F0(Refer to command line)
27.67 E F3(n)2.5 E F0(.).24 E F2<21ad>108 458.4 Q F3(n)A F0144 441.6 Q F3(n)2.86 E F0(.).24 E F2<21ad>108 453.6 Q F3(n)A F0
(Refer to the current command minus)21.97 E F3(n)2.5 E F0(.).24 E F2(!!)(Refer to the current command minus)144 453.6 Q F3(n)2.86 E F0(.).24 E
108 470.4 Q F0(Refer to the pre)29.34 E(vious command.)-.25 EF2(!!)108 465.6 Q F0(Refer to the pre)144 465.6 Q(vious command.)-.25 E
(This is a synon)5 E(ym for `!\2551'.)-.15 E F2(!)108 482.4 Q F3(string)(This is a synon)5 E(ym for `!\2551'.)-.15 E F2(!)108 477.6 Q F3(string)
 A F0 .865(Refer to the most recent command preceding the current positi\  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(.)on in the history list starting with)144 477.6 R F3(string)144.34 489.6
.22 E F2(!?)108 506.4 Q F3(string)A F2([?])A F0 1.503(Refer to the most\Q F0(.).22 E F2(!?)108 501.6 Q F3(string)A F2([?])A F0 1.503(Refer to t\
 recent command preceding the current position in the history list cont\he most recent command preceding the current position in the history li\
aining)144 518.4 R F3(string)144 530.4 Q F0 5(.T).22 G(he trailing)-5 Est containing)144 513.6 R F3(string)144.34 525.6 Q F0 5.497(.T).22 G
F2(?)2.5 E F0(may be omitted if)2.5 E F3(string)2.84 E F0(is follo)2.72.497(he trailing)-5.497 F F2(?)2.997 E F0 .497(may be omitted if)2.997 F
E(wed immediately by a ne)-.25 E(wline.)-.25 E/F4 12/Times-Bold@0 SF(^)F3(string)3.337 E F0 .496(is follo)3.216 F .496(wed immediately by a ne)
108 547.4 Q F3(string1)-5 I F4(^)5 I F3(string2)-5 I F4(^)5 I F0 2.63-.25 F 2.996(wline. If)-.25 F F3(string)2.996 E F0(is)2.996 E .39(missi\
(Quick substitution.)144 554.4 R 2.629ng, the string from the most recent search is used; it is an error if t\
(Repeat the last command, replacing)7.629 F F3(string1)5.469 E F0(with)here is no pre)144 537.6 R .391(vious search)-.25 F(string.)144 549.6 Q
5.129 E F3(string2)5.129 E F0 7.629(.E).02 G(qui)-7.629 E -.25(va)-.25 G/F4 12/Times-Bold@0 SF(^)108 566.6 Q F3(string1)-5 I F4(^)5 I F3
2.629(lent to).25 F -.74(``)144 566.4 S(!!:s/).74 E F3(string1)A F0(/)A(string2)-5 I F4(^)5 I F0 2.599(Quick substitution.)144 573.6 R 2.598
F3(string2)A F0(/')A 2.5('\()-.74 G(see)-2.5 E F2(Modi\214ers)2.5 E F0(Repeat the last command, replacing)7.599 F F3(string1)5.438 E F0(with)
(belo)2.5 E(w\).)-.25 E F2(!#)108 578.4 Q F05.098 E F3(string2)5.438 E F0 7.598(.E).02 G(qui)-7.598 E -.25(va)-.25 G
(The entire command line typed so f)27.67 E(ar)-.1 E(.)-.55 E F2 -.752.598(lent to).25 F -.74(``)144 585.6 S(!!:s).74 E/F5 12/Times-Roman@0
(Wo)87 595.2 S(rd Designators).75 E F0 -.8(Wo)108 607.2 S 1.313SF(^)5 I F3(string1)-5 I F5(^)5 I F3(string2)-5 I F5(^)5 I F0 1.48 -.74
(rd designators are used to select desired w).8 F 1.314(ords from the e)('' \()-5 L(see).74 E F2(Modi\214ers)2.5 E F0(belo)2.5 E(w\).)-.25 E F2
-.1 F -.15(ve)-.25 G 3.814(nt. A).15 F F2(:)3.814 E F0 1.314(!#)108 597.6 Q F0(The entire command line typed so f)144 597.6 Q(ar)-.1
(separates the e)3.814 F -.15(ve)-.25 G 1.314(nt speci\214cation).15 FE(.)-.55 E F2 -.75(Wo)87 614.4 S(rd Designators).75 E F0 -.8(Wo)108
.53(from the w)108 619.2 R .529(ord designator)-.1 F 5.529(.I)-.55 G626.4 S 1.313(rd designators are used to select desired w).8 F 1.314
3.029(tm)-5.529 G .529(ay be omitted if the w)-3.029 F .529(ords from the e)-.1 F -.15(ve)-.25 G 3.814(nt. A).15 F F2(:)3.814 E F0
 1.314(separates the e)3.814 F -.15(ve)-.25 G 1.314(nt speci\214cation)
 .15 F .53(from the w)108 638.4 R .529(ord designator)-.1 F 5.529(.I)-.55
 G 3.029(tm)-5.529 G .529(ay be omitted if the w)-3.029 F .529
 (ord designator be)-.1 F .529(gins with a)-.15 F F2(^)3.029 E F0(,)A F2  (ord designator be)-.1 F .529(gins with a)-.15 F F2(^)3.029 E F0(,)A F2
 ($)3.029 E F0(,)A F2(*)3.029 E F0(,)A F2<ad>3.029 E F0 3.029(,o)C(r)  ($)3.029 E F0(,)A F2(*)3.029 E F0(,)A F2<ad>3.029 E F0 3.029(,o)C(r)
-3.029 E F2(%)3.029 E F0 5.529(.W)C(ords)-6.329 E 1.3-3.029 E F2(%)3.029 E F0 5.529(.W)C(ords)-6.329 E .515
(are numbered from the be)108 631.2 R 1.3(are numbered from the be)108 650.4 R .516
(ginning of the line, with the \214rst w)-.15 F 1.301(ginning of the line, with the \214rst w)-.15 F .516
(ord being denoted by 0 \(zero\).)-.1 F -.8(Wo)6.301 G 1.301(rds are).8(ord being denoted by 0 \(zero\).)-.1 F -.8(Wo)5.516 G .516(rds are in-)
F(inserted into the current line separated by single spaces.)108 643.2 Q.8 F(serted into the current line separated by single spaces.)108 662.4
F2 2.5(0\()108 660 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 672 Q 2.5Q F2 2.5(0\()108 679.2 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 691.2
(ord. F)-.1 F(or the shell, this is the command w)-.15 E(ord.)-.1 E F3Q 2.5(ord. F)-.1 F(or the shell, this is the command w)-.15 E(ord.)-.1 E
(n)108.36 684 Q F0(The)30.64 E F3(n)2.5 E F0(th w)A(ord.)-.1 E F2(^)108F3(n)108.36 703.2 Q F0(The)144 703.2 Q F3(n)2.5 E F0(th w)A(ord.)-.1 E
696 Q F0(The \214rst ar)32.67 E 2.5(gument. That)-.18 F(is, w)2.5 EF2(^)108 715.2 Q F0(The \214rst ar)144 715.2 Q 2.5(gument. That)-.18 F
(ord 1.)-.1 E F2($)108 708 Q F0 .064(The last w)31 F 2.564(ord. This)-.1(is, w)2.5 E(ord 1.)-.1 E(GNU History 8.1)72 768 Q(2020 July 17)139.005
F .064(is usually the last ar)2.564 F .064(gument, b)-.18 F .064E(1)203.165 E 0 Cg EP
(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  %%Page: 2 2
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E/F1 10/Times-Bold@0 SF(%)108 84 Q F0(The w)26 E-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E/F1
(ord matched by the most recent `?)-.1 E/F2 10/Times-Italic@0 SF(string)10/Times-Bold@0 SF($)108 84 Q F0 .064(The last w)144 84 R 2.564
A F0(?' search.)A F2(x)108.77 96 Q F1<ad>A F2(y)A F0 2.5(Ar)20.65 G(ord. This)-.1 F .064(is usually the last ar)2.564 F .064(gument, b)-.18
(ange of w)-2.5 E(ords; `\255)-.1 E F2(y)A F0 2.5('a)C(bbre)-2.5 EF .064(ut will e)-.2 F .064(xpand to the zeroth w)-.15 F .063
(viates `0\255)-.25 E F2(y)A F0('.)A F1(*)108 108 Q F0 .315(ord if there is only)-.1 F(one w)144 96 Q(ord in the line.)-.1 E F1(%)
(All of the w)31 F .315(ords b)-.1 F .315(ut the zeroth.)-.2 F .315108 108 Q F0 1.419(The \214rst w)144 108 R 1.419
(This is a synon)5.315 F .315(ym for `)-.15 F F2(1\255$)A F0 2.815(ord matched by the most recent `?)-.1 F/F2 10/Times-Italic@0 SF(string)
('. It)B .315(is not an error to use)2.815 F F1(*)2.816 E F0 .316A F0 1.42(?' search, if the search string be)B 1.42(gins with a)-.15 F
(if there is)2.816 F(just one w)144 120 Q(ord in the e)-.1 E -.15(ve)(character that is part of a w)144 120 Q(ord.)-.1 E F2(x)108.77 132 Q F1
-.25 G(nt; the empty string is returned in that case.).15 E F1(x*)108<ad>A F2(y)A F0 2.5(Ar)144 132 S(ange of w)-2.5 E(ords; `\255)-.1 E F2
132 Q F0(Abbre)26 E(viates)-.25 E F2(x\255$)2.5 E F0(.)A F1<78ad>108 144(y)A F0 2.5('a)C(bbre)-2.5 E(viates `0\255)-.25 E F2(y)A F0('.)A F1(*)
Q F0(Abbre)25.3 E(viates)-.25 E F2(x\255$)2.5 E F0(lik)2.5 E(e)-.1 E F1108 144 Q F0 .316(All of the w)144 144 R .316(ords b)-.1 F .316
(x*)2.5 E F0 2.5(,b)C(ut omits the last w)-2.7 E(ord.)-.1 E(If a w)108(ut the zeroth.)-.2 F .315(This is a synon)5.315 F .315(ym for `)-.15 F
160.8 Q(ord designator is supplied without an e)-.1 E -.15(ve)-.25 GF2(1\255$)A F0 2.815('. It)B .315(is not an error to use)2.815 F F1(*)
(nt speci\214cation, the pre).15 E(vious command is used as the e)-.25 E2.815 E F0 .315(if there is)2.815 F(just one w)144 156 Q(ord in the e)
-.15(ve)-.25 G(nt.).15 E F1(Modi\214ers)87 177.6 Q F0 .184-.1 E -.15(ve)-.25 G(nt; the empty string is returned in that case.).15
(After the optional w)108 189.6 R .184(ord designator)-.1 F 2.684(,t)-.4E F1(x*)108 168 Q F0(Abbre)144 168 Q(viates)-.25 E F2(x\255$)2.5 E F0(.)
G .183(here may appear a sequence of one or more of the follo)-2.684 FA F1<78ad>108 180 Q F0(Abbre)144 180 Q(viates)-.25 E F2(x\255$)2.5 E F0
.183(wing modi\214ers,)-.25 F(each preceded by a `:'.)108 201.6 Q F1(h)(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
108 218.4 Q F0(Remo)30.44 E .3 -.15(ve a t)-.15 H2.5(ord. If)-.1 F F1(x)2.5 E F0(is missing, it def)2.5 E(aults to 0.)-.1
 E(If a w)108 196.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 213.6 Q F0 .183(After the optional w)108 225.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 237.6 Q
 (These modify)5 E 2.5(,o)-.65 G 2.5(re)-2.5 G(dit, the w)-2.5 E
 (ord or w)-.1 E(ords selected from the history e)-.1 E -.15(ve)-.25 G
 (nt.).15 E F1(h)108 254.4 Q F0(Remo)144 254.4 Q .3 -.15(ve a t)-.15 H
 (railing \214le name component, lea).15 E(ving only the head.)-.2 E F1  (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(t)108 266.4 Q F0(Remo)144 266.4 Q .3 -.15(ve a)-.15 H
 (ll leading \214le name components, lea).15 E(ving the tail.)-.2 E F1(r)  (ll leading \214le name components, lea).15 E(ving the tail.)-.2 E F1(r)
108 242.4 Q F0(Remo)31.56 E .3 -.15(ve a t)-.15 H(railing suf).15 E108 278.4 Q F0(Remo)144 278.4 Q .3 -.15(ve a t)-.15 H(railing suf).15 E
 (\214x of the form)-.25 E F2(.xxx)2.5 E F0 2.5(,l)C(ea)-2.5 E  (\214x of the form)-.25 E F2(.xxx)2.5 E F0 2.5(,l)C(ea)-2.5 E
(ving the basename.)-.2 E F1(e)108 254.4 Q F0(Remo)31.56 E .3 -.15(ve a)(ving the basename.)-.2 E F1(e)108 290.4 Q F0(Remo)144 290.4 Q .3 -.15
-.15 H(ll b).15 E(ut the trailing suf)-.2 E(\214x.)-.25 E F1(p)108 266.4(ve a)-.15 H(ll b).15 E(ut the trailing suf)-.2 E(\214x.)-.25 E F1(p)108
Q F0(Print the ne)30.44 E 2.5(wc)-.25 G(ommand b)-2.5 E(ut do not e)-.2302.4 Q F0(Print the ne)144 302.4 Q 2.5(wc)-.25 G(ommand b)-2.5 E
E -.15(xe)-.15 G(cute it.).15 E F1(q)108 278.4 Q F0(ut do not e)-.2 E -.15(xe)-.15 G(cute it.).15 E F1(q)108 314.4 Q F0
(Quote the substituted w)30.44 E(ords, escaping further substitutions.)(Quote the substituted w)144 314.4 Q
-.1 E F1(x)108 290.4 Q F0(Quote the substituted w)31 E(ords as with)-.1(ords, escaping further substitutions.)-.1 E F1(x)108 326.4 Q F0 .386
E F1(q)2.5 E F0 2.5(,b)C(ut break into w)-2.7 E(ords at)-.1 E F1(blanks)(Quote the substituted w)144 326.4 R .386(ords as with)-.1 F F1(q)2.886
2.5 E F0(and ne)2.5 E(wlines.)-.25 E F1(s/)108 302.4 Q F2(old)A F1(/)AE F0 2.886(,b)C .386(ut break into w)-3.086 F .385(ords at)-.1 F F1
F2(ne)A(w)-.15 E F1(/)A F0(Substitute)144 314.4 Q F2(ne)3.081 E(w)-.15 E(blanks)2.885 E F0 .385(and ne)2.885 F 2.885(wlines. The)-.25 F F1(q)
F0 .221(for the \214rst occurrence of)3.031 F F2(old)2.951 E F0 .2212.885 E F0(and)2.885 E F1(x)2.885 E F0(modi\214ers are mutually e)144
(in the e)3.491 F -.15(ve)-.25 G .221(nt line.).15 F(An)5.221 E 2.721338.4 Q(xclusi)-.15 E -.15(ve)-.25 G 2.5(;t).15 G
(yd)-.15 G .221(elimiter can be used in place)-2.721 F .617(of /.)144(he last one supplied is used.)-2.5 E F1(s/)108 350.4 Q F2(old)A F1(/)A
326.4 R .617F2(ne)A(w)-.15 E F1(/)A F0(Substitute)144 362.4 Q F2(ne)3.328 E(w)-.15 E
 F0 .469(for the \214rst occurrence of)3.278 F F2(old)3.199 E F0 .469
 (in the e)3.739 F -.15(ve)-.25 G .469(nt line.).15 F(An)5.469 E 2.969
 (yc)-.15 G .469(haracter may be used as the)-2.969 F .954
 (delimiter in place of /.)144 374.4 R .953
 (The \214nal delimiter is optional if it is the last character of the e)  (The \214nal delimiter is optional if it is the last character of the e)
5.617 F -.15(ve)-.25 G .617(nt line.).15 F .616(The delimiter may)5.6165.953 F -.15(ve)-.25 G .953(nt line.).15 F .131
F .666(be quoted in)144 338.4 R F2(old)3.396 E F0(and)3.936 E F2(ne)(The delimiter may be quoted in)144 386.4 R F2(old)2.861 E F0(and)3.401
3.526 E(w)-.15 E F0 .666(with a single backslash.)3.476 F .666E F2(ne)2.991 E(w)-.15 E F0 .131(with a single backslash.)2.941 F .131
(If & appears in)5.666 F F2(ne)3.166 E(w)-.15 E F0 3.166(,i).31 G 3.166(If & appears in)5.131 F F2(ne)2.991 E(w)-.15 E F0 2.631(,i).31 G 2.631
(ti)-3.166 G 3.166(sr)-3.166 G .666(eplaced by)-3.166 F F2(old)3.166 E(ti)-2.631 G 2.631(sr)-2.631 G(e-)-2.631 E .62(placed by)144 398.4 R F2
F0 5.666(.A).77 G .275(single backslash will quote the &.)144 350.4 R(old)3.349 E F0 5.619(.A).77 G .619(single backslash will quote the &.)
(If)5.275 E F2(old)3.004 E F0 .274(is null, it is set to the last)3.544-2.5 F(If)5.619 E F2(old)3.349 E F0 .619(is null, it is set to the last)
F F2(old)3.004 E F0 .274(substituted, or)3.544 F 2.774(,i)-.4 G 2.7743.889 F F2(old)3.349 E F0(substi-)3.889 E .486(tuted, or)144 410.4 R
(fn)-2.774 G 2.774(op)-2.774 G(re)-2.774 E(vi-)-.25 E2.986(,i)-.4 G 2.986(fn)-2.986 G 2.986(op)-2.986 G(re)-2.986 E .486
(ous history substitutions took place, the last)144 362.4 Q F2(string)(vious history substitutions took place, the last)-.25 F F2(string)3.326
2.84 E F0(in a)2.72 E F1(!?)2.5 E F2(string)A F1([?])A F0(search.)5 E F1E F0 .487(in a)3.206 F F1(!?)2.987 E F2(string)A F1([?])A F0 2.987
(&)108 374.4 Q F0(Repeat the pre)27.67 E(vious substitution.)-.25 E F1(search. If)5.487 F F2(ne)144.36 422.4 Q(w)-.15 E F0
(g)108 386.4 Q F0 .397(Cause changes to be applied o)31 F -.15(ve)-.15 G(is null, each matching)2.81 E F2(old)2.73 E F0(is deleted.)3.27 E F1(&)
2.897(rt).15 G .398(he entire e)-2.897 F -.15(ve)-.25 G .398(nt line.)108 434.4 Q F0(Repeat the pre)144 434.4 Q(vious substitution.)-.25 E F1
.15 F .398(This is used in conjunction with `)5.398 F F1(:s)A F0 2.898(g)108 446.4 Q F0 .398(Cause changes to be applied o)144 446.4 R -.15
('\()C(e.g.,)-2.898 E(`)144 398.4 Q F1(:gs/)A F2(old)A F1(/)A F2(ne)A(w)(ve)-.15 G 2.898(rt).15 G .398(he entire e)-2.898 F -.15(ve)-.25 G .398
-.15 E F1(/)A F0 1.219('\) or `)B F1(:&)A F0 3.719('. If)B 1.219(nt line.).15 F .397(This is used in conjunction with `)5.398 F F1(:s)A
(used with `)3.719 F F1(:s)A F0 1.218(', an)B 3.718(yd)-.15 G 1.218F0 2.897('\()C(e.g.,)-2.897 E(`)144 458.4 Q F1(:gs/)A F2(old)A F1(/)A F2
(elimiter can be used in place of /, and the \214nal)-3.718 F .089(ne)A(w)-.15 E F1(/)A F0 .35('\) or `)B F1(:&)A F0 2.85('. If)B .35
(delimiter is optional if it is the last character of the e)144 410.4 R(used with `)2.85 F F1(:s)A F0 .35(', an)B 2.85(yd)-.15 G .351
-.15(ve)-.25 G .09(nt line.).15 F(An)5.09 E F1(a)2.59 E F0 .09(elimiter can be used in place of /, and the \214nal de-)-2.85 F
(may be used as a synon)2.59 F .09(ym for)-.15 F F1(g)144 422.4 Q F0(.)A(limiter is optional if it is the last character of the e)144 470.4 Q
F1(G)108 434.4 Q F0(Apply the follo)28.22 E(wing `)-.25 E F1(s)A F0 2.5-.15(ve)-.25 G(nt line.).15 E(An)5 E F1(a)2.5 E F0
('m)C(odi\214er once to each w)-2.5 E(ord in the e)-.1 E -.15(ve)-.25 G(may be used as a synon)2.5 E(ym for)-.15 E F1(g)2.5 E F0(.)A F1(G)108
(nt line.).15 E/F3 10.95/Times-Bold@0 SF(PR)72 451.2 Q482.4 Q F0(Apply the follo)144 482.4 Q(wing `)-.25 E F1(s)A F0 2.5('o)C
(OGRAMMING WITH HIST)-.329 E(OR)-.197 E 2.738(YF)-.383 G(UNCTIONS)-2.7382.5(r`)-2.5 G F1(&)-2.5 E F0 2.5('m)C(odi\214er once to each w)-2.5 E
E F0(This section describes ho)108 463.2 Q 2.5(wt)-.25 G 2.5(ou)-2.5 G(ord in the e)-.1 E -.15(ve)-.25 G(nt line.).15 E/F3 10.95/Times-Bold@0
(se the History library in other programs.)-2.5 E F1(Intr)87 480 QSF(PR)72 499.2 Q(OGRAMMING WITH HIST)-.329 E(OR)-.197 E 2.738(YF)-.383 G
(oduction to History)-.18 E F0 .797(UNCTIONS)-2.738 E F0(This section describes ho)108 511.2 Q 2.5(wt)-.25
(The programmer using the History library has a)108 492 R -.25(va)-.2 GG 2.5(ou)-2.5 G(se the History library in other programs.)-2.5 E F1
.796(ilable functions for remembering lines on a history list,).25 F(Intr)87 528 Q(oduction to History)-.18 E F0 2.883(Ap)108 540 S .383
.307(associating arbitrary data with a line, remo)108 504 R .308(rogrammer using the History library has a)-2.883 F -.25(va)-.2 G .382
 (ilable functions for remembering lines on a history list, as-).25 F .77
 (sociating arbitrary data with a line, remo)108 552 R .771
 (ving lines from the list, searching through the list for a line con-)  (ving lines from the list, searching through the list for a line con-)
-.15 F .303(taining an arbitrary te)108 516 R .303-.15 F .303(taining an arbitrary te)108 564 R .303
 (xt string, and referencing an)-.15 F 2.803(yl)-.15 G .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  (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.802 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(function is a)108 576 Q -.25(va)-.2 G(ilable which pro).25 E
 (vides for a consistent user interf)-.15 E(ace across dif)-.1 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 \  (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.8History library has the bene\214t of a consistent user interf)108 592.8
R .059(ace with a)-.1 F .918(set of well-kno)108 556.8 R .917R .059(ace with a)-.1 F .918(set of well-kno)108 604.8 R .917
 (wn commands for manipulating the te)-.25 F .917(xt of pre)-.15 F .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.417(wc)-.25  (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\G(om-)-3.417 E 4.183(mands. The)108 616.8 R 1.684(basic history manipul\
 ation commands are identical to the history substitution pro)4.183 F  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 .9041.684(vided by)-.15 F F1(bash)108 628.8 Q F0(.)A .915
(If the programmer desires, he can use the Readline library)108 597.6 R(The programmer can also use the Readline library)108 645.6 R 3.415(,w)
3.403(,w)-.65 G .903(hich includes some history manipulation by)-3.403 F-.65 G .915(hich includes some history manipulation by def)-3.415 F
(def)108 609.6 Q(ault, and has the added adv)-.1 E(ault,)-.1 E(and has the added adv)108 657.6 Q
 (antage of command line editing.)-.25 E .39(Before declaring an)108  (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 .39674.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  (unctionality the History library pro)-2.89 F .39
 (vides in other code, an appli-)-.15 F .067  (vides in other code, an appli-)-.15 F .067
(cation writer should include the \214le)108 638.4 R F2(<r)4.233 E(cation writer should include the \214le)108 686.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  (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  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(eatures.)-2.566 E .538(It supplies e)108 698.4 R .538
 (xtern declarations for all of the library')-.15 F 3.038(sp)-.55 G .538  (xtern declarations for all of the library')-.15 F 3.038(sp)-.55 G .538
 (ublic functions and v)-3.038 F .539(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-.25 F(public data structures.)108 710.4 Q(GNU History 8.1)72 768 Q
F0(The history list is an array of history entries.)108 703.2 Q 2.5(Ah)5(2020 July 17)139.005 E(2)203.165 E 0 Cg EP
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.3)72 768 Q(2013 June 27) 
138.175 E(2)202.335 E 0 Cg EP 
 %%Page: 3 3  %%Page: 3 3
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E(typedef struct _hist_entry {)108 84 Q-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E/F1
(char *line;)113 96 Q(char *timestamp;)113 108 Q(histdata_t data;)11310/Times-Bold@0 SF(History Storage)87 84 Q F0
120 Q 2.5(}H)108 132 S(IST_ENTR)-2.5 E -.92(Y;)-.65 G(The history list is an array of history entries.)108 96 Q 2.5(Ah)5 G
(The history list itself might therefore be declared as)108 148.8 Q/F1(istory entry is declared as follo)-2.5 E(ws:)-.25 E/F2 10
10/Times-Italic@0 SF(HIST_ENTR)108 165.6 Q 2.5(Y*)-.18 G(*)-2.5 E/F2 10/Times-Italic@0 SF(typedef void *)108 112.8 Q F1(histdata_t;)2.5 E F0
/Times-Bold@0 SF(the_history_list;)2.5 E F0(The state of the History li\(typedef struct _hist_entry {)108 129.6 Q(char *line;)113 141.6 Q
brary is encapsulated into a single structure:)108 182.4 Q(/*)108 199.2(char *timestamp;)113 153.6 Q(histdata_t data;)113 165.6 Q 2.5(}H)108
Q 2.5(*As)110.5 211.2 S177.6 S(IST_ENTR)-2.5 E -.92(Y;)-.65 G
 (The history list itself might therefore be declared as)108 194.4 Q F2
 (HIST_ENTR)108 211.2 Q 2.5(Y*)-.18 G(*)-2.5 E F1(the_history_list;)2.5 E
 F0(The state of the History library is encapsulated into a single struc\
 ture:)108 228 Q(/*)108 244.8 Q 2.5(*As)110.5 256.8 S
 (tructure used to pass around the current state of the history)-2.5 E(.)  (tructure used to pass around the current state of the history)-2.5 E(.)
-.65 E(*/)110.5 223.2 Q(typedef struct _hist_state {)108 235.2 Q-.65 E(*/)110.5 268.8 Q(typedef struct _hist_state {)108 280.8 Q
(HIST_ENTR)113 247.2 Q 2.5(Y*)-.65 G(HIST_ENTR)113 292.8 Q 2.5(Y*)-.65 G
 (*entries; /* Pointer to the entries themselv)-2.5 E(es. */)-.15 E  (*entries; /* Pointer to the entries themselv)-2.5 E(es. */)-.15 E
(int of)113 259.2 Q 25(fset; /*)-.25 F(int of)113 304.8 Q 25(fset; /*)-.25 F
 (The location pointer within this array)2.5 E 2.5(.*)-.65 G(/)-2.5 E  (The location pointer within this array)2.5 E 2.5(.*)-.65 G(/)-2.5 E
(int length;)113 271.2 Q(/* Number of elements within this array)27.5 E(int length;)113 316.8 Q(/* Number of elements within this array)27.5 E
2.5(.*)-.65 G(/)-2.5 E(int size;)113 283.2 Q2.5(.*)-.65 G(/)-2.5 E(int size;)113 328.8 Q
 (/* Number of slots allocated to this array)32.5 E 2.5(.*)-.65 G(/)-2.5  (/* Number of slots allocated to this array)32.5 E 2.5(.*)-.65 G(/)-2.5
E(int \215ags;)113 295.2 Q 2.5(}H)108 307.2 S(IST)-2.5 E(OR)-.18 E(Y_ST)E(int \215ags;)113 340.8 Q 2.5(}H)108 352.8 S(IST)-2.5 E(OR)-.18 E(Y_ST)
-.65 E -1.11(AT)-.93 G(E;)1.11 E(If the \215ags member includes)108 324-.65 E -1.11(AT)-.93 G(E;)1.11 E(If the \215ags member includes)108
Q F2(HS_STIFLED)2.5 E F0 2.5(,t)C(he history has been sti\215ed.)-2.5 E369.6 Q F1(HS_STIFLED)2.5 E F0 2.5(,t)C(he history has been sti\215ed.)
/F3 10.95/Times-Bold@0 SF(History Functions)72 340.8 Q F0-2.5 E/F3 10.95/Times-Bold@0 SF(History Functions)72 386.4 Q F0
(This section describes the calling sequence for the v)108 352.8 Q(This section describes the calling sequence for the v)108 398.4 Q
 (arious functions e)-.25 E(xported by the GNU History library)-.15 E(.)  (arious functions e)-.25 E(xported by the GNU History library)-.15 E(.)
-.65 E F2(Initializing History and State Management)87 369.6 Q F0 1.274-.65 E F1(Initializing History and State Management)87 415.2 Q F0 1.274
 (This section describes functions used to initialize and manage the sta\  (This section describes functions used to initialize and manage the sta\
te of the History library when you)108 381.6 R -.1(wa)108 393.6 Ste of the History library when you)108 427.2 R -.1(wa)108 439.2 S
(nt to use the history functions in your program.).1 E F1(void)108 417.6(nt to use the history functions in your program.).1 E F2(void)108 463.2
Q F2(using_history)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E(Be)108Q F1(using_history)2.5 E F0(\()4.166 E F2(void)A F0(\))1.666 E(Be)108
429.6 Q(gin a session in which the history functions might be used.)-.15475.2 Q(gin a session in which the history functions might be used.)-.15
 E(This initializes the interacti)5 E .3 -.15(ve v)-.25 H(ariables.)-.1 E  E(This initializes the interacti)5 E .3 -.15(ve v)-.25 H(ariables.)-.1 E
F1(HIST)108 453.6 Q(OR)-.18 E(Y_ST)-.18 E -.37(AT)-.5 G 2.5(E*).37 G F2F2(HIST)108 499.2 Q(OR)-.18 E(Y_ST)-.18 E -.37(AT)-.5 G 2.5(E*).37 G F1
(history_get_history_state)A F0(\()4.166 E F1(void)A F0(\))1.666 E(history_get_history_state)A F0(\()4.166 E F2(void)A F0(\))1.666 E
 (Return a structure describing the current state of the input history)  (Return a structure describing the current state of the input history)
108 465.6 Q(.)-.65 E F1(void)108 489.6 Q F2(history_set_history_state)108 511.2 Q(.)-.65 E F2(void)108 535.2 Q F1(history_set_history_state)
2.5 E F0(\()4.166 E F1(HIST)A(OR)-.18 E(Y_ST)-.18 E -.37(AT)-.5 G 2.52.5 E F0(\()4.166 E F2(HIST)A(OR)-.18 E(Y_ST)-.18 E -.37(AT)-.5 G 2.5
 (E*).37 G(state)-2.5 E F0(\))1.666 E  (E*).37 G(state)-2.5 E F0(\))1.666 E
(Set the state of the history list according to)108 501.6 Q F1(state)2.5(Set the state of the history list according to)108 547.2 Q F2(state)2.5
E F0(.)A F2(History List Management)87 530.4 Q F0E F0(.)A F1(History List Management)87 576 Q F0
(These functions manage indi)108 542.4 Q(vidual entries on the history \(These functions manage indi)108 588 Q(vidual entries on the history li\
list, or set parameters managing the list itself.)-.25 E F1(void)108st, or set parameters managing the list itself.)-.25 E F2(void)108 612 Q
566.4 Q F2(add_history)2.5 E F0(\()4.166 E F1(const c)A(har *string)-.15F1(add_history)2.5 E F0(\()4.166 E F2(const c)A(har *string)-.15 E F0
E F0(\))1.666 E(Place)108 578.4 Q F1(string)2.5 E F0(\))1.666 E(Place)108 624 Q F2(string)3.279 E F0 .779
(at the end of the history list.)2.5 E(at the end of the history list.)3.279 F .779
(The associated data \214eld \(if an)5 E(y\) is set to)-.15 E F2(NULL)(The associated data \214eld \(if an)5.779 F .779(y\) is set to)-.15 F
2.5 E F0(.)A F1(void)108 602.4 Q F2(add_history_time)2.5 E F0(\()4.166 EF1(NULL)3.279 E F0 5.779(.I)C 3.279(ft)-5.779 G .78(he maxi-)-3.279 F
F1(const c)A(har *string)-.15 E F0(\))1.666 E.787(mum number of history entries has been set using)108 636 R F1
 (sti\215e_history\(\))3.286 E F0 3.286(,a)C .786(nd the ne)-3.286 F
 3.286(wn)-.25 G .786(umber of history entries)-3.286 F -.1(wo)108 648 S
 (uld e).1 E(xceed that maximum, the oldest history entry is remo)-.15 E
 -.15(ve)-.15 G(d.).15 E F2(void)108 672 Q F1(add_history_time)2.5 E F0
 (\()4.166 E F2(const c)A(har *string)-.15 E F0(\))1.666 E
 (Change the time stamp associated with the most recent history entry to)  (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*)-.18108 684 Q F2(string)2.5 E F0(.)A F2(HIST_ENTR)108 708 Q 2.5(Y*)-.18 G F1
G F2 -.18(re)C(mo).18 E -.1(ve)-.1 G(_history).1 E F0(\()4.166 E F1-.18(re)C(mo).18 E -.1(ve)-.1 G(_history).1 E F0(\()4.166 E F2(int whic)
(int whic)A(h)-.15 E F0(\))1.666 E(Remo)108 650.4 Q .352 -.15(ve h)-.15A(h)-.15 E F0(\))1.666 E(Remo)108 720 Q .352 -.15(ve h)-.15 H .052
H .052(istory entry at of).15 F(fset)-.25 E F1(whic)2.553 E(h)-.15 E F0(istory entry at of).15 F(fset)-.25 E F2(whic)2.553 E(h)-.15 E F0 .053
.053(from the history)2.553 F 5.053(.T)-.65 G .053(he remo)-5.053 F -.15(from the history)2.553 F 5.053(.T)-.65 G .053(he remo)-5.053 F -.15(ve)
(ve)-.15 G 2.553(de).15 G .053(lement is returned so you can free the)-.15 G 2.553(de).15 G .053(lement is returned so you can free the)-2.553
-2.553 F(line, data, and containing structure.)108 662.4 Q F1F(GNU History 8.1)72 768 Q(2020 July 17)139.005 E(3)203.165 E 0 Cg EP
(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 .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 .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.3)72 768 Q(2013 June 27)138.175 E(3)202.335 E 0 Cg EP 
 %%Page: 4 4  %%Page: 4 4
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E/F1 10/Times-Italic@0 SF(HIST_ENTR)108 84 Q 2.5-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E
(Y*)-.18 G/F2 10/Times-Bold@0 SF -.18(re)C(place_history_entry).18 E F0(line, data, and containing structure.)108 84 Q/F1 10/Times-Italic@0 SF
(\()4.166 E F1(int whic)A -.834(h, const)-.15 F -.15(ch)2.5 G(ar *line)(histdata_t)108 108 Q/F2 10/Times-Bold@0 SF(fr)2.5 E(ee_history_entry)
.15 E 1.666(,h)-.1 G(istdata_t data)-1.666 E F0(\))3.332 E(Mak)108 96 Q-.18 E F0(\()4.166 E F1(HIST_ENTR)A 2.5(Y*)-.18 G(histent)-2.5 E F0(\))
3.062(et)-.1 G .562(he history entry at of)-3.062 F(fset)-.25 E F1(whic)1.666 E .934(Free the history entry)108 120 R F1(histent)3.433 E F0 .933
3.062 E(h)-.15 E F0(ha)3.062 E -.15(ve)-.2 G F1(line)3.212 E F0(and)(and an)3.433 F 3.433(yh)-.15 G .933(istory library pri)-3.433 F -.25
3.062 E F1(data)3.062 E F0 5.563(.T)C .563(va)-.25 G .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 132 Q F1
 (HIST_ENTR)108 156 Q 2.5(Y*)-.18 G F2 -.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 168 Q 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)  (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 E108 180 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  (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 F2F0 2.5(,a)C F2(NULL)A F0(pointer is returned.)2.5 E F1(void)108 204 Q F2
 (clear_history)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E  (clear_history)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E
(Clear the history list by deleting all the entries.)108 144 Q F1(void)(Clear the history list by deleting all the entries.)108 216 Q F1(void)
108 168 Q F2(sti\215e_history)2.5 E F0(\()4.166 E F1(int max)A F0(\))108 240 Q F2(sti\215e_history)2.5 E F0(\()4.166 E F1(int max)A F0(\))
1.666 E(Sti\215e the history list, remembering only the last)108 180 Q1.666 E .38(Sti\215e the history list, remembering only the last)108 252
F1(max)2.5 E F0(entries.)2.5 E F1(int)108 204 Q F2(unsti\215e_history)R F1(max)2.88 E F0 2.88(entries. The)2.88 F .38
2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E .46(history list will contain only)2.88 F F1(max)2.88 E F0(entries)2.88 E
(Stop sti\215ing the history)108 216 R 5.46(.T)-.65 G .46(at a time.)108 264 Q F1(int)108 288 Q F2(unsti\215e_history)2.5 E F0
(his returns the pre)-5.46 F .46(\()4.166 E F1(void)A F0(\))1.666 E .46(Stop sti\215ing the history)108
 300 R 5.46(.T)-.65 G .46(his returns the pre)-5.46 F .46
 (viously-set maximum number of history entries \(as set by)-.25 F F2  (viously-set maximum number of history entries \(as set by)-.25 F F2
(sti-)2.96 E(\215e_history\(\))108 228 Q F0 2.5(\). history)B -.1(wa)2.5(sti-)2.96 E(\215e_history\(\))108 312 Q F0 2.5(\). history)B -.1(wa)2.5
 G 2.5(ss).1 G 2.5(ti\215ed. The)-2.5 F -.25(va)2.5 G(lue is positi).25 E  G 2.5(ss).1 G 2.5(ti\215ed. The)-2.5 F -.25(va)2.5 G(lue is positi).25 E
 .3 -.15(ve i)-.25 H 2.5(ft).15 G(he history w)-2.5 E(as sti\215ed, ne)  .3 -.15(ve i)-.25 H 2.5(ft).15 G(he history w)-2.5 E(as sti\215ed, ne)
 -.1 E -.05(ga)-.15 G(ti).05 E .3 -.15(ve i)-.25 H 2.5(fi).15 G 2.5(tw)  -.1 E -.05(ga)-.15 G(ti).05 E .3 -.15(ve i)-.25 H 2.5(fi).15 G 2.5(tw)
-2.5 G(asn')-2.6 E(t.)-.18 E F1(int)108 252 Q F2(history_is_sti\215ed)-2.5 G(asn')-2.6 E(t.)-.18 E F1(int)108 336 Q F2(history_is_sti\215ed)
 2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E  2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E
 (Returns non-zero if the history is sti\215ed, zero if it is not.)108  (Returns non-zero if the history is sti\215ed, zero if it is not.)108
264 Q F2(Inf)87 292.8 Q(ormation About the History List)-.25 E F0(These\348 Q F2(Inf)87 376.8 Q(ormation About the History List)-.25 E F0(These\
  functions return information about the entire history list or indi)108   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*)-.18388.8 Q(vidual list entries.)-.25 E F1(HIST_ENTR)108 412.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  G(*)-2.5 E F2(history_list)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E
.707(Return a)108 340.8 R F2(NULL)3.207 E F0 .707(terminated array of).708(Return a)108 424.8 R F2(NULL)3.208 E F0 .708(terminated array of)
3.207 F F1(HIST_ENTR)3.207 E 3.208(Y*)-.18 G F0 .7083.208 F F1(HIST_ENTR)3.208 E 3.208(Y*)-.18 G F0 .708
(which is the current input history)B 5.708(.E)-.65 G .708(which is the current input history)B 5.707(.E)-.65 G .707
(lement 0 of this)-5.708 F(list is the be)108 352.8 Q(ginning of time.)(lement 0 of this)-5.707 F(list is the be)108 436.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  -.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 EE F0(.)A F1(int)108 460.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 QF1(void)A F0(\))1.666 E(Returns the of)108 472.8 Q
(fset of the current history element.)-.25 E F1(HIST_ENTR)108 412.8 Q(fset of the current history element.)-.25 E F1(HIST_ENTR)108 496.8 Q
 2.5(Y*)-.18 G F2(curr)A(ent_history)-.18 E F0(\()4.166 E F1(void)A F0  2.5(Y*)-.18 G F2(curr)A(ent_history)-.18 E F0(\()4.166 E F1(void)A F0
 (\))1.666 E 1.373  (\))1.666 E 1.373
 (Return the history entry at the current position, as determined by)108  (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)508.8 R F2(wher)3.873 E(e_history\(\))-.18 E F0 6.373(.I)C 3.873(ft)
-6.373 G 1.373(here is no entry)-3.873 F(there, return a)108 436.8 Q F2-6.373 G 1.374(here is no entry)-3.873 F(there, return a)108 520.8 Q F2
(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(HIST_ENTR)108 460.8 Q 2.5(Y*)(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(HIST_ENTR)108 544.8 Q 2.5(Y*)
 -.18 G F2(history_get)A F0(\()4.166 E F1(int of)A(fset)-.18 E F0(\))  -.18 G F2(history_get)A F0(\()4.166 E F1(int of)A(fset)-.18 E F0(\))
1.666 E .287(Return the history entry at position)108 472.8 R F1(of)1.666 E 1.069(Return the history entry at position)108 556.8 R F1(of)
2.787 E(fset)-.18 E F0 2.787(,s)C .287(tarting from)-2.787 F F23.569 E(fset)-.18 E F0 6.069(.T)C 1.069(he range of v)-6.069 F 1.069
(history_base)2.787 E F0 5.287(.I)C 2.787(ft)-5.287 G .287(alid v)-.25 F 1.069(alues of)-.25 F F1(of)3.569 E(fset)-.18 E F0 1.068
(here is no entry there, or if)-2.787 F F1(of)2.788 E(fset)-.18 E F0(starts at)3.569 F F2(history_base)3.568 E F0(and)3.568 E .286(ends at)
(is greater than the history length, return a)108 484.8 Q F2(NULL)2.5 E108 568.8 R F2(history_length)2.786 E F0 2.786<ad31>2.786 G 5.286(.I)
F0(pointer)2.5 E(.)-.55 E F1(time_t)108 508.8 Q F2(history_get_time)2.5-2.786 G 2.786(ft)-5.286 G .286(here is no entry there, or if)-2.786 F
E F0(\()4.166 E F1(HIST_ENTR)A 2.5(Y*)-.18 G F0(\))-.834 E(Return the t\F1(of)2.786 E(fset)-.18 E F0 .286(is outside the v)2.786 F .287
ime stamp associated with the history entry passed as the ar)108 520.8 Q(alid range, return a)-.25 F F2(NULL)2.787 E F0(pointer)108 580.8 Q(.)
(gument.)-.18 E F1(int)108 544.8 Q F2(history_total_bytes)2.5 E F0(\()-.55 E F1(time_t)108 604.8 Q F2(history_get_time)2.5 E F0(\()4.166 E F1
4.166 E F1(void)A F0(\))1.666 E .392(HIST_ENTR)A 2.5(Y*)-.18 G F0(\))-.834 E(Return the time stamp associat\
 ed with the history entry passed as the ar)108 616.8 Q(gument.)-.18 E F1
 (int)108 640.8 Q F2(history_total_bytes)2.5 E F0(\()4.166 E F1(void)A F0
 (\))1.666 E .392
 (Return the number of bytes that the primary history entries are using.)  (Return the number of bytes that the primary history entries are using.)
108 556.8 R .391(This function returns the sum of the)5.392 F108 652.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(lengths of all the lines in the history)108 664.8 Q(.)-.65 E F2(Mo)87
597.6 Q(ving Ar)-.1 E(ound the History List)-.18 E F0693.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(These functions allo)108 705.6 Q 2.5(wt)-.25 G(he current inde)-2.5 E
 2.5(xi)-.15 G(nto the history list to be set or changed.)-2.5 E F1(int)  2.5(xi)-.15 G(nto the history list to be set or changed.)-2.5 E F1(int)
108 633.6 Q F2(history_set_pos)2.5 E F0(\()4.166 E F1(int pos)A F0(\))108 729.6 Q F2(history_set_pos)2.5 E F0(\()4.166 E F1(int pos)A F0(\))
1.666 E .79(Set the current history of)108 645.6 R .79(fset to)-.25 F F11.666 E(GNU History 8.1)72 768 Q(2020 July 17)139.005 E(4)203.165 E 0 Cg
(pos)3.29 E F0 3.29(,a)C 3.29(na)-3.29 G .79(bsolute inde)-3.29 F 3.29EP
(xi)-.15 G .79(nto the list.)-3.29 F .79(Returns 1 on success, 0 if)5.79 
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 .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.3)72 768 Q(2013 June 27)138.175 E(4) 
202.335 E 0 Cg EP 
 %%Page: 5 5  %%Page: 5 5
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E(Mo)108 84 Q 1.046 -.15(ve t)-.15 H .746-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E .79
(he current history of).15 F .746(fset forw)-.25 F .746(ard to the ne)(Set the current history of)108 84 R .79(fset to)-.25 F/F1 10
-.1 F .746(xt history entry)-.15 F 3.246(,a)-.65 G .747/Times-Italic@0 SF(pos)3.29 E F0 3.29(,a)C 3.29(na)-3.29 G .79
(nd return the a pointer to that entry)-3.246 F 5.747(.I)-.65 G(f)-5.747(bsolute inde)-3.29 F 3.29(xi)-.15 G .79(nto the list.)-3.29 F .79
E(there is no ne)108 96 Q(xt entry)-.15 E 2.5(,r)-.65 G(eturn a)-2.5 E(Returns 1 on success, 0 if)5.79 F F1(pos)3.29 E F0 .79(is less)3.29 F
/F1 10/Times-Bold@0 SF(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(Sear)87(than zero or greater than the number of history entries.)108 96 Q F1
124.8 Q(ching the History List)-.18 E F0 .006(These functions allo)108(HIST_ENTR)108 120 Q 2.5(Y*)-.18 G/F2 10/Times-Bold@0 SF(pr)A -.15(ev)
136.8 R 2.506(ws)-.25 G .006(earching of the history list for entries c\-.18 G(ious_history).15 E F0(\()4.166 E F1(void)A F0(\))1.666 E .208
ontaining a speci\214c string.)-2.506 F .005(Searching may be)5.005 F(Back up the current history of)108 132 R .208(fset to the pre)-.25 F
1.451(performed both forw)108 148.8 R 1.451(ard and backw)-.1 F 1.451.208(vious history entry)-.25 F 2.707(,a)-.65 G .207
(ard from the current history position.)-.1 F 1.452(The search may be)(nd return a pointer to that entry)-2.707 F 5.207(.I)-.65 G 2.707(ft)
6.452 F/F2 10/Times-Italic@0 SF(anc)3.952 E(hor)-.15 E(ed)-.37 E F0(,)A-5.207 G .207(here is)-2.707 F(no pre)108 144 Q(vious entry)-.25 E 2.5
(meaning that the string must match at the be)108 160.8 Q(,r)-.65 G(eturn a)-2.5 E F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1
(ginning of the history entry)-.15 E(.)-.65 E F2(int)108 184.8 Q F1(HIST_ENTR)108 168 Q 2.5(Y*)-.18 G F2(next_history)A F0(\()4.166 E F1
(history_sear)2.5 E(ch)-.18 E F0(\()4.166 E F2(const c)A(har *string)(void)A F0(\))1.666 E .332(If the current history of)108 180 R .333
-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))1.666 E .156(fset refers to a v)-.25 F .333(alid history entry)-.25 F 2.833(,i)-.65
(Search the history for)108 196.8 R F2(string)2.656 E F0 2.656(,s)C .156G .333(ncrement the current history of)-2.833 F 2.833(fset. If)-.25 F
(tarting at the current history of)-2.656 F 2.656(fset. If)-.25 F F2.333(the possi-)2.833 F .202(bly-incremented history of)108 192 R .202
(dir)2.656 E(ection)-.37 E F0 .155(is less than 0, then the search)2.656(fset refers to a v)-.25 F .202(alid history entry)-.25 F 2.702(,r)-.65
F .801(is through pre)108 208.8 R .801G .202(eturn a pointer to that entry; otherwise, return)-2.702 F(a)108
 204 Q F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F2(Sear)87 232.8 Q
 (ching the History List)-.18 E F0 .005(These functions allo)108 244.8 R
 2.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 256.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 F1(anc)3.951 E(hor)-.15 E(ed)-.37 E F0(,)A
 (meaning that the string must match at the be)108 268.8 Q
 (ginning of the history entry)-.15 E(.)-.65 E F1(int)108 292.8 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 304.8 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.656
 F .802(is through pre)108 316.8 R .802
 (vious entries, otherwise through subsequent entries.)-.25 F(If)5.801 E  (vious entries, otherwise through subsequent entries.)-.25 F(If)5.801 E
F2(string)3.301 E F0 .802(is found, then the current his-)3.301 F .065F1(string)3.301 E F0 .801(is found, then the current his-)3.301 F .064
(tory inde)108 220.8 R 2.565(xi)-.15 G 2.564(ss)-2.565 G .064(tory inde)108 328.8 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.564  (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  F .064(alue returned is the of)-.25 F .064
(fset in the line of the entry where)-.25 F F2(string)2.564 E F0 -.1(wa)(fset in the line of the entry where)-.25 F F1(string)2.565 E F0 -.1(wa)
108 232.8 S 2.5(sf).1 G 2.5(ound. Otherwise,)-2.5 F108 340.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(nothing is changed, and a -1 is returned.)2.5 E F1(int)108 364.8 Q F2
(history_sear)2.5 E(ch_pr)-.18 E(e\214x)-.18 E F0(\()4.166 E F2(const c)(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(\))  A(har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))
1.666 E .683(Search the history for)108 268.8 R F2(string)3.183 E F01.666 E .684(Search the history for)108 376.8 R F1(string)3.183 E F0
 3.183(,s)C .683(tarting at the current history of)-3.183 F 3.183  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.064(fset. The)-.25 F .683(search is anchored: matching lines)3.183 F 1.063
(must be)108 280.8 R 1.064(gin with)-.15 F F2(string)3.564 E F0 6.064(must be)108 388.8 R 1.063(gin with)-.15 F F1(string)3.563 E F0 6.063
(.I)C(f)-6.064 E F2(dir)3.564 E(ection)-.37 E F0 1.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.564 F 1.063(is less than 0, then the search is through pre)3.563 F 1.064
(vious entries, otherwise)-.25 F 1.114(through subsequent entries.)108(vious entries, otherwise)-.25 F .34(through subsequent entries.)108
292.8 R(If)6.114 E F2(string)3.614 E F0 1.114400.8 R(If)5.34 E F1(string)2.84 E F0 .34
(is found, then the current history inde)3.614 F 3.615(xi)-.15 G 3.615(is found, then the current history inde)2.84 F 2.84(xi)-.15 G 2.84(ss)
(ss)-3.615 G 1.115(et to that entry)-3.615 F 3.615(,a)-.65 G 1.115-2.84 G .34(et to that entry)-2.84 F 2.84(,a)-.65 G .34(nd the re-)-2.84
(nd the)-3.615 F(return v)108 304.8 Q(alue is 0.)-.25 EF(turn v)108 412.8 Q(alue is 0.)-.25 E
(Otherwise, nothing is changed, and a -1 is returned.)5 E F2(int)108(Otherwise, nothing is changed, and a -1 is returned.)5 E F1(int)108
328.8 Q F1(history_sear)2.5 E(ch_pos)-.18 E F0(\()4.166 E F2(const c)A436.8 Q F2(history_sear)2.5 E(ch_pos)-.18 E F0(\()4.166 E F1(const c)A
 (har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E -.834(ection, int)  (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 .604(Search for)108 340.8 R F2(string)-.37 F(pos)2.5 E F0(\))3.332 E .603(Search for)108 448.8 R F1(string)
3.104 E F0 .604(in the history list, starting at)3.104 F F2(pos)3.104 E3.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  F0 3.104(,a)C 3.104(na)-3.104 G .604(bsolute inde)-3.104 F 3.104(xi)-.15
G .603(nto the list.)-3.104 F(If)5.603 E F2(dir)3.103 E(ection)-.37 E F0G .604(nto the list.)-3.104 F(If)5.604 E F1(dir)3.104 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.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 352.8 R .608(ard from)-.1 F F2(pos)3.108(the search proceeds backw)108 460.8 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  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  .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(he history ele-)-3.108 F(ment where)108 472.8 Q F1(string)2.5 E F0 -.1
(wa)2.5 G 2.5(sf).1 G(ound, or -1 otherwise.)-2.5 E F1(wa)2.5 G 2.5(sf).1 G(ound, or -1 otherwise.)-2.5 E F2
(Managing the History File)87 393.6 Q F0 .035(The History library can r\(Managing the History File)87 501.6 Q F0 .035(The History library can r\
ead the history from and write it to a \214le.)108 405.6 R .035ead the history from and write it to a \214le.)108 513.6 R .036
 (This section documents the functions for)5.035 F  (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)(managing a history \214le.)108 525.6 Q F1(int)108 549.6 Q F2 -.18(re)
2.5 G(ad_history).18 E F0(\()4.166 E F2(const c)A(har *\214lename)-.15 E2.5 G(ad_history).18 E F0(\()4.166 E F1(const c)A(har *\214lename)-.15 E
F0(\))1.666 E .15(Add the contents of)108 453.6 R F2(\214lename)2.65 EF0(\))1.666 E .151(Add the contents of)108 561.6 R F1(\214lename)2.651 E
F0 .15(to the history list, a line at a time.)2.65 F(If)5.151 E F2F0 .151(to the history list, a line at a time.)2.651 F(If)5.15 E F1
(\214lename)2.651 E F0(is)2.651 E F1(NULL)2.651 E F0 2.651(,t)C .151(\214lename)2.65 E F0(is)2.65 E F2(NULL)2.65 E F0 2.65(,t)C .15
(hen read from)-2.651 F F2(~/.his-)2.651 E(tory)108 465.6 Q F0 5(.R)C(hen read from)-2.65 F F1(~/.his-)2.65 E(tory)108 573.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(eturns 0 if successful, or)-5 E F2(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 EF1(int)108 597.6 Q F2 -.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 -.834F1(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 .053(Read a range of lines from)(om, int)-.45 F(to)2.5 E F0(\))3.332 E .052(Read a range of lines from)
108 501.6 R F2(\214lename)2.553 E F0 2.553(,a)C .053108 609.6 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)  (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 .052(and end at)2.553 F F2(to)2.552 E5.053 F F1(fr)2.553 E(om)-.45 E F0 .053(and end at)2.553 F F1(to)2.553 E
F0(.)A(If)108 513.6 Q F2(fr)2.888 E(om)-.45 E F0 .388F0(.)A(If)108 621.6 Q F1(fr)2.889 E(om)-.45 E F0 .389
(is zero, start at the be)2.888 F 2.889(ginning. If)-.15 F F2(to)2.889 E(is zero, start at the be)2.889 F 2.889(ginning. If)-.15 F F1(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 .389F0 .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.389 E F2(hen read until the end of the \214le.)-2.889 F(If)5.388 E F1
(\214lename)2.889 E F0(is)108 525.6 Q F1(NULL)2.5 E F0 2.5(,t)C(\214lename)2.888 E F0(is)108 633.6 Q F2(NULL)2.5 E F0 2.5(,t)C
(hen read from)-2.5 E F2(~/.history)2.5 E F0 5(.R)C(hen read from)-2.5 E F1(~/.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(eturns 0 if successful, or)-5 E F2(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)AF1(int)108 657.6 Q F2(write_history)2.5 E F0(\()4.166 E F1(const c)A
(har *\214lename)-.15 E F0(\))1.666 E .962(Write the current history to)(har *\214lename)-.15 E F0(\))1.666 E .961(Write the current history to)
108 561.6 R F2(\214lename)3.462 E F0 3.461(,o)C -.15(ve)-3.611 G108 669.6 R F1(\214lename)3.461 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(rwriting).15 E F1(\214lename)3.461 E F0 .961(if necessary)3.461 F 5.961
(.I)-.65 G(f)-5.961 E F2(\214lename)3.461 E F0(is)3.461 E F1(NULL)3.461(.I)-.65 G(f)-5.961 E F1(\214lename)3.462 E F0(is)3.462 E F2(NULL)3.462
E F0 3.461(,t)C .961(hen write)-3.461 F(the history list to)108 573.6 QE F0 3.462(,t)C .962(hen write)-3.462 F(the history list to)108 681.6 Q
F2(~/.history)2.5 E F0 5(.R)C(eturns 0 on success, or)-5 E F1(err)2.5 EF1(~/.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 F2(int)108 609.6 Q(no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F1(int)108 717.6 Q
F1(append_history)2.5 E F0(\()4.166 E F2(int nelements,)A(const c)1.666F2(append_history)2.5 E F0(\()4.166 E F1(int nelements,)A(const c)1.666
E(har *\214lename)-.15 E F0(\))1.666 E .838(Append the last)108 621.6 RE(har *\214lename)-.15 E F0(\))1.666 E .839(Append the last)108 729.6 R
F2(nelements)3.338 E F0 .839(of the history list to)3.339 F F2F1(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 F2(\214lename)3.339 E F0(\214lename)3.339 E F0 5.839(.I)C(f)-5.839 E F1(\214lename)3.339 E F0
(is)3.339 E F1(NULL)3.339 E F0 3.339(,t)C .839(hen append to)-3.339 F F2(is)3.339 E F2(NULL)3.339 E F0 3.339(,t)C .838(hen append to)-3.339 F F1
(~/.history)3.339 E F0(.)A(Returns 0 on success, or)108 633.6 Q F1(err)(~/.history)3.338 E F0(.)A(GNU History 8.1)72 768 Q(2020 July 17)139.005
2.5 E(no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F2(int)108E(5)203.165 E 0 Cg EP
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 .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.3)72 768 Q(2013 June 27)138.175 E(5)202.335 E 0 Cg EP 
 %%Page: 6 6  %%Page: 6 6
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E/F1 10/Times-Bold@0 SF(History Expansion)87 84 Q-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E
F0(These functions implement history e)108 96 Q(xpansion.)-.15 E/F2 10(Returns 0 on success, or)108 84 Q/F1 10/Times-Bold@0 SF(err)2.5 E(no)
/Times-Italic@0 SF(int)108 120 Q F1(history_expand)2.5 E F0(\()4.166 E-.15 E F0(on a read or write error)2.5 E(.)-.55 E/F2 10/Times-Italic@0
F2 -.15(ch)C(ar *string).15 E 1.666(,c)-.1 G(har **output)-1.816 E F0SF(int)108 108 Q F1(history_truncate_\214le)2.5 E F0(\()4.166 E F2
(\))1.666 E(Expand)108 132 Q F2(string)2.5 E F0 2.5(,p)C(const c)A(har *\214lename)-.15 E 1.666(,i)-.1 G(nt nlines)-1.666 E F0
(lacing the result into)-2.5 E F2(output)2.5 E F0 2.5(,ap)C(\))1.666 E -.35(Tr)108 120 S .38(uncate the history \214le).35 F F2
(ointer to a string.)-2.5 E(Returns:)5 E 31(0I)144 144 S 3.065(fn)-31 G(\214lename)2.88 E F0 2.88(,l)C(ea)-2.88 E .38(ving only the last)-.2 F
3.065(oe)-3.065 G .565(xpansions took place \(or)-3.215 F 3.065(,i)-.4 GF2(nlines)2.881 E F0 2.881(lines. If)2.881 F F2(\214lename)2.881 E F0
3.065(ft)-3.065 G .565(he only change in the te)-3.065 F .566(xt w)-.15(is)2.881 E F1(NULL)2.881 E F0 2.881(,t)C(hen)-2.881 E F2(~/.history)
F .566(as the remo)-.1 F -.25(va)-.15 G 3.066(lo).25 G 3.066(fe)-3.066 G2.881 E F0(is)2.881 E 2.5(truncated. Returns)108 132 R 2.5(0o)2.5 G 2.5
(scape)-3.066 E(characters preceding the history e)180 156 Q(ns)-2.5 G(uccess, or)-2.5 E F1(err)2.5 E(no)-.15 E F0(on f)2.5 E
(xpansion character\);)-.15 E 31(1i)144 168 S 2.5(fe)-31 G(ailure.)-.1 E F1(History Expansion)87 160.8 Q F0
(xpansions did tak)-2.65 E 2.5(ep)-.1 G(lace;)-2.5 E 25.17(-1 if)144 180(These functions implement history e)108 172.8 Q(xpansion.)-.15 E F2
R(there w)2.5 E(as an error in e)-.1 E(xpansion;)-.15 E 31(2i)144 192 S(int)108 196.8 Q F1(history_expand)2.5 E F0(\()4.166 E F2 -.15(ch)C
2.5(ft)-31 G(he returned line should be displayed, b)-2.5 E(ut not e)-.2(ar *string).15 E 1.666(,c)-.1 G(har **output)-1.816 E F0(\))1.666 E
E -.15(xe)-.15 G(cuted, as with the).15 E F1(:p)2.5 E F0(modi\214er)2.5(Expand)108 208.8 Q F2(string)2.5 E F0 2.5(,p)C(lacing the result into)
E(.)-.55 E(If an error ocurred in e)108 204 Q(xpansion, then)-.15 E F2-2.5 E F2(output)2.5 E F0 2.5(,ap)C(ointer to a string.)-2.5 E(Returns:)
 5 E(0)144 220.8 Q .566(If no e)180 220.8 R .566
 (xpansions took place \(or)-.15 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 232.8 Q(xpansion character\);)
 -.15 E(1)144 244.8 Q(if e)180 244.8 Q(xpansions did tak)-.15 E 2.5(ep)
 -.1 G(lace;)-2.5 E(-1)144 256.8 Q(if there w)180 256.8 Q
 (as an error in e)-.1 E(xpansion;)-.15 E(2)144 268.8 Q
 (if the returned line should be displayed, b)180 268.8 Q(ut not e)-.2 E
 -.15(xe)-.15 G(cuted, as with the).15 E F1(:p)2.5 E F0(modi\214er)2.5 E
 (.)-.55 E(If an error occurred in e)108 280.8 Q(xpansion, then)-.15 E F2
 (output)2.5 E F0(contains a descripti)2.5 E .3 -.15(ve e)-.25 H  (output)2.5 E F0(contains a descripti)2.5 E .3 -.15(ve e)-.25 H
(rror message.).15 E F2 -.15(ch)108 228 S(ar *).15 E F1(get_history_e)(rror message.).15 E F2 -.15(ch)108 304.8 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  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 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 .263(Returns the te)108 240 R .263(xt of the history e)E F0(\))3.332 E .262(Returns the te)108 316.8 R .262
-.15 F -.15(ve)-.25 G .263(nt be).15 F .263(ginning at)-.15 F F2(string)(xt of the history e)-.15 F -.15(ve)-.25 G .262(nt be).15 F .263
2.763 E F0(+)2.763 E F2(*cinde)2.763 E(x)-.2 E F0(.)A F2(*cinde)5.263 E(ginning at)-.15 F F2(string)2.763 E F0(+)2.763 E F2(*cinde)2.763 E(x)
(x)-.2 E F0 .262(is modi\214ed to point to after the)2.762 F -2.15 -.25-.2 E F0(.)A F2(*cinde)5.263 E(x)-.2 E F0 .263
(ev e)108 252 T .709(nt speci\214er).25 F 5.709(.A)-.55 G 3.209(tf)(is modi\214ed to point to after the)2.763 F -2.15 -.25(ev e)108 328.8 T
-5.709 G .709(unction entry)-3.209 F(,)-.65 E F2(cinde)3.209 E(x)-.2 E.71(nt speci\214er).25 F 5.71(.A)-.55 G 3.21(tf)-5.71 G .71
F0 .709(points to the inde)3.209 F 3.209(xi)-.15 G(nto)-3.209 E F2(unction entry)-3.21 F(,)-.65 E F2(cinde)3.21 E(x)-.2 E F0 .709
(string)3.21 E F0 .71(where the history e)3.21 F -.15(ve)-.25 G .71(points to the inde)3.21 F 3.209(xi)-.15 G(nto)-3.209 E F2(string)3.209
(nt speci\214ca-).15 F .528(tion be)108 264 R(gins.)-.15 E F2(qc)5.528 EE F0 .709(where the history e)3.209 F -.15(ve)-.25 G .709
(har)-.15 E F0 .527(is a character that is allo)3.028 F .527(nt speci\214ca-).15 F .527(tion be)108 340.8 R(gins.)-.15 E F2(qc)5.527
(wed to end the e)-.25 F -.15(ve)-.25 G .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  (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(terminating characters.)108 352.8 Q F2 -.15(ch)108 376.8 S(ar **).15 E
(history_tok)2.5 E(enize)-.1 E F0(\()4.166 E F2(const c)A(har *string)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 .238(Return an array of tok)108 312 R .238-.15 E F0(\))1.666 E .239(Return an array of tok)108 388.8 R .239
(ens parsed out of)-.1 F F2(string)2.738 E F0 2.738(,m)C .239(ens parsed out of)-.1 F F2(string)2.739 E F0 2.739(,m)C .238
(uch as the shell might.)-2.738 F .239(The tok)5.239 F .239(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 324 Q F1(history_w)(ens are split on the charac-)-.1 F(ters in the)108 400.8 Q F1
2.5 E(ord_delimiters)-.1 E F0 -.25(va)2.5 G(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  (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(yed.)-.15 E F2 -.15(ch)108 424.8 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  (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 .026(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 .026(gment consisting of the)-.15 F F2(Extract a string se)108 436.8 R .025(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  <8c72>2.526 E(st)-.1 E F0(through)2.526 E F2(last)2.526 E F0(ar)2.526 E
.025(guments present in)-.18 F F2(string)2.525 E F0 5.025(.A)C -.18(rg).026(guments present in)-.18 F F2(string)2.526 E F0 5.026(.A)C -.18(rg)
-5.025 G .025(uments are split).18 F(using)108 372 Q F1(history_tok)2.5-5.026 G .026(uments are split).18 F(using)108 448.8 Q F1(history_tok)
E(enize\(\))-.1 E F0(.)A F1(History V)87 400.8 Q(ariables)-.92 E F02.5 E(enize\(\))-.1 E F0(.)A F1(History V)87 477.6 Q(ariables)-.92 E F0
(This section describes the e)108 412.8 Q(xternally-visible v)-.15 E(This section describes the e)108 489.6 Q(xternally-visible v)-.15 E
 (ariables e)-.25 E(xported by the GNU History Library)-.15 E(.)-.65 E F2  (ariables e)-.25 E(xported by the GNU History Library)-.15 E(.)-.65 E F2
(int)108 436.8 Q F1(history_base)2.5 E F0(The logical of)108 448.8 Q(int)108 513.6 Q F1(history_base)2.5 E F0(The logical of)108 525.6 Q
(fset of the \214rst entry in the history list.)-.25 E F2(int)108 472.8(fset of the \214rst entry in the history list.)-.25 E F2(int)108 549.6
 Q F1(history_length)2.5 E F0  Q F1(history_length)2.5 E F0
(The number of entries currently stored in the history list.)108 484.8 Q(The number of entries currently stored in the history list.)108 561.6 Q
F2(int)108 508.8 Q F1(history_max_entries)2.5 E F0F2(int)108 585.6 Q F1(history_max_entries)2.5 E F0
(The maximum number of history entries.)108 520.8 Q(The maximum number of history entries.)108 597.6 Q
 (This must be changed using)5 E F1(sti\215e_history\(\))2.5 E F0(.)A F2  (This must be changed using)5 E F1(sti\215e_history\(\))2.5 E F0(.)A F2
(int)108 544.8 Q F1(history_wite_timestamps)2.5 E F0 1.468(int)108 621.6 Q F1(history_write_timestamps)2.5 E F0 .484
 (If non-zero, timestamps are written to the history \214le, so the)108  (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.468633.6 R 2.983(yc)-.15 G .483(an be preserv)-2.983 F .483
(ed between sessions.)-.15 F(The)6.469 E(def)108 568.8 Q .439(ault v)-.1(ed between sessions.)-.15 F .483(The de-)5.483 F -.1(fa)108 645.6 S
F .439(alue is 0, meaning that timestamps are not sa)-.25 F -.15(ve)-.2.994(ult v).1 F .994(alue is 0, meaning that timestamps are not sa)-.25
G 2.939(d. The).15 F .439(current timestamp format uses the v)2.939 FF -.15(ve)-.2 G 3.494(d. The).15 F .994
.438(alue of)-.25 F F2(history_comment_c)108 580.8 Q(har)-.15 E F0 .051(current timestamp format uses the v)3.494 F .995(alue of)-.25 F F2
(to delimit timestamp entries in the history \214le.)2.551 F .051(history_comment_c)108 657.6 Q(har)-.15 E F0 .051
(If that v)5.051 F .052(ariable does not ha)-.25 F .352 -.15(ve a v)-.2(to delimit timestamp entries in the history \214le.)2.552 F .051
H(alue)-.1 E(\(the def)108 592.8 Q(If that v)5.051 F .051(ariable does not ha)-.25 F .351 -.15(ve a v)-.2
(ault\), timestamps will not be written.)-.1 E F2 -.15(ch)108 616.8 SH(alue)-.1 E(\(the def)108 669.6 Q
 (ault\), timestamps will not be written.)-.1 E F2 -.15(ch)108 693.6 S
 (ar).15 E F1(history_expansion_char)2.5 E F0  (ar).15 E F1(history_expansion_char)2.5 E F0
(The character that introduces a history e)108 628.8 Q -.15(ve)-.25 G(The character that introduces a history e)108 705.6 Q -.15(ve)-.25 G
 2.5(nt. The).15 F(def)2.5 E(ault is)-.1 E F1(!)2.5 E F0 5(.S)C  2.5(nt. The).15 F(def)2.5 E(ault is)-.1 E F1(!)2.5 E F0 5(.S)C
 (etting this to 0 inhibits history e)-5 E(xpansion.)-.15 E F2 -.15(ch)  (etting this to 0 inhibits history e)-5 E(xpansion.)-.15 E F2 -.15(ch)
108 652.8 S(ar).15 E F1(history_subst_char)2.5 E F0108 729.6 S(ar).15 E F1(history_subst_char)2.5 E F0(GNU History 8.1)72
(The character that in)108 664.8 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(sw).1 G768 Q(2020 July 17)139.005 E(6)203.165 E 0 Cg EP
(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 .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 .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 .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  %%Page: 7 7
 %%BeginPageSetup  %%BeginPageSetup
 BP  BP
 %%EndPageSetup  %%EndPageSetup
/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 357.18(Y\(3\) HIST)-.65 F/F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
(OR)-.18 E(Y\(3\))-.65 E/F1 10/Times-Italic@0 SF -.15(ch)108 84 S(ar *)-.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E
.15 E/F2 10/Times-Bold@0 SF(history_w)2.5 E(ord_delimiters)-.1 E F0(The character that in)108 84 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(sw).1 G
(The characters that separate tok)108 96 Q(ens for)-.1 E F2(history_tok)(ord substitution if found at the start of a line.)-2.6 E(The def)5 E
2.5 E(enize\(\))-.1 E F0 5(.T)C(he def)-5 E(ault v)-.1 E(alue is)-.25 E(ault is)-.1 E/F1 10/Times-Bold@0 SF(^)2.5 E F0(.)A/F2 10/Times-Italic@0
F2 2.5("\\)2.5 G(t\\n\(\)<>;&|")-2.5 E F0(.)A F1 -.15(ch)108 120 S(ar *)SF -.15(ch)108 108 S(ar).15 E F1(history_comment_char)2.5 E F0 .116
.15 E F2(history_no_expand_chars)2.5 E F0 2.054(During tok)108 120 R .117
(The list of characters which inhibit history e)108 132 R 2.054(enization, if this character is seen as the \214rst character of a w)
(xpansion if found immediately follo)-.15 F(wing)-.25 E F2-.1 F .117(ord, then it and all subsequent char)-.1 F(-)-.2 E .277
(history_expan-)4.554 E(sion_char)108 144 Q F0 5(.T)C(he def)-5 E(acters up to a ne)108 132 R .276
(ault is space, tab, ne)-.1 E(wline,)-.25 E F2(\\r)2.5 E F0 2.5(,a)C(nd)(wline are ignored, suppressing history e)-.25 F .276
-2.5 E F2(=)2.5 E F0(.)A F1 -.15(ch)108 168 S(ar *).15 E F2(xpansion for the remainder of the line.)-.15 F .276(This is dis-)5.276
 F(abled by def)108 144 Q(ault.)-.1 E F2 -.15(ch)108 168 S(ar *).15 E F1
 (history_w)2.5 E(ord_delimiters)-.1 E F0
 (The characters that separate tok)108 180 Q(ens for)-.1 E F1
 (history_tok)2.5 E(enize\(\))-.1 E F0 5(.T)C(he def)-5 E(ault v)-.1 E
 (alue is)-.25 E F1 2.5("\\)2.5 G(t\\n\(\)<>;&|")-2.5 E F0(.)A F2 -.15
 (ch)108 204 S(ar *).15 E F1(history_no_expand_chars)2.5 E F0 2.054
 (The list of characters which inhibit history e)108 216 R 2.054
 (xpansion if found immediately follo)-.15 F(wing)-.25 E F1
 (history_expan-)4.555 E(sion_char)108 228 Q F0 5(.T)C(he def)-5 E
 (ault is space, tab, ne)-.1 E(wline,)-.25 E F1(\\r)2.5 E F0 2.5(,a)C(nd)
 -2.5 E F1(=)2.5 E F0(.)A F2 -.15(ch)108 252 S(ar *).15 E F1
 (history_sear)2.5 E(ch_delimiter_chars)-.18 E F0 .401(The list of addit\  (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\  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.902 E F0 to space, tab,)108 264 R F2(:)2.901 E F0(and)2.901 E F2(?)2.901 E F0
(in the case of a substring search.)108 192 Q(The def)5 E(ault is empty)(in the case of a substring search.)108 276 Q(The def)5 E(ault is empty)
-.1 E(.)-.65 E F1(int)108 216 Q F2(history_quotes_inhibit_expansion)2.5-.1 E(.)-.65 E F2(int)108 300 Q F1(history_quotes_inhibit_expansion)2.5
E F0 .625(If non-zero, single-quoted w)108 228 R .625E F0 .86(If non-zero, double-quoted w)108 312 R .861
(ords are not scanned for the history e)-.1 F .624(xpansion character)(ords are not scanned for the history e)-.1 F .861
-.15 F 5.624(.T)-.55 G .624(he def)-5.624 F .624(ault v)-.1 F .624(xpansion character or the history com-)-.15 F(ment character)108 324 Q
(alue is)-.25 F(0.)108 240 Q F1(rl_lineb)108 264 Q(uf_func_t *)-.2 E F25(.T)-.55 G(he def)-5 E(ault v)-.1 E(alue is 0.)-.25 E F2(rl_lineb)108
(history_inhibit_expansion_function)2.5 E F0 .347348 Q(uf_func_t *)-.2 E F1(history_inhibit_expansion_function)2.5 E F0
(This should be set to the address of a function that tak)108 276 R .348.348(This should be set to the address of a function that tak)108 360 R
(es tw)-.1 F 2.848(oa)-.1 G -.18(rg)-2.848 G .348(uments: a).18 F F2.348(es tw)-.1 F 2.848(oa)-.1 G -.18(rg)-2.848 G .347(uments: a).18 F F1
.348(char *)2.848 F F0(\()2.848 E F1(string)A F0 2.848(\)a)C .348(nd an).347(char *)2.847 F F0(\()2.847 E F2(string)A F0 2.847(\)a)C .347(nd an)
-2.848 F F2(int)2.848 E F0(inde)2.848 E(x)-.15 E .228-2.847 F F1(int)2.847 E F0(inde)2.847 E(x)-.15 E .227
(into that string \()108 288 R F1(i)A F0 2.728(\). It)B .227(into that string \()108 372 R F2(i)A F0 2.727(\). It)B .227
 (should return a non-zero v)2.727 F .227(alue if the history e)-.25 F  (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.227(xpansion starting at)-.15 F F2(string[i])2.728 E F0 .228
(should not)2.727 F .019(be performed; zero if the e)108 300 R .019(should not)2.728 F .019(be performed; zero if the e)108 384 R .019
 (xpansion should be done.)-.15 F .019  (xpansion should be done.)-.15 F .019
(It is intended for use by applications lik)5.019 F(e)-.1 E F2(bash)(It is intended for use by applications lik)5.019 F(e)-.1 E F1(bash)
2.519 E F0 .019(that use)2.519 F(the history e)108 312 Q2.519 E F0 .018(that use)2.519 F(the history e)108 396 Q
 (xpansion character for additional purposes.)-.15 E(By def)5 E  (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(ault, this v)-.1 E(ariable is set to)-.25 E F1(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 F010.95/Times-Bold@0 SF(FILES)72 412.8 Q F2(~/.history)109.666 424.8 Q F0
(Def)144 352.8 Q(ault \214lename for reading and writing sa)-.1 E -.15(Def)144 436.8 Q(ault \214lename for reading and writing sa)-.1 E -.15
(ve)-.2 G 2.5(dh).15 G(istory)-2.5 E F3(SEE ALSO)72 369.6 Q F1(ve)-.2 G 2.5(dh).15 G(istory)-2.5 E F3(SEE ALSO)72 453.6 Q F2
(The Gnu Readline Libr)108 381.6 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(The Gnu Readline Libr)108 465.6 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E
(ox and Chet Rame)-.15 E(y)-.15 E F1(The Gnu History Libr)108 393.6 Q(ox and Chet Rame)-.15 E(y)-.15 E F2(The Gnu History Libr)108 477.6 Q
 (ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E  (ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E
F1(bash)108 405.6 Q F0(\(1\))A F1 -.37(re)108 417.6 S(adline).37 E F0F2(bash)108 489.6 Q F0(\(1\))A F2 -.37(re)108 501.6 S(adline).37 E F0
(\(3\))A F3 -.548(AU)72 434.4 S(THORS).548 E F0(Brian F)108 446.4 Q(\(3\))A F3 -.548(AU)72 518.4 S(THORS).548 E F0(Brian F)108 530.4 Q
 (ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108  (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 E542.4 Q(g)-.18 E(Chet Rame)108 559.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  (estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E
(chet.rame)108 487.2 Q(y@case.edu)-.15 E F3 -.11(BU)72 504 S 2.738(GR)(chet.rame)108 571.2 Q(y@case.edu)-.15 E F3 -.11(BU)72 588 S 2.738(GR)
.11 G(EPOR)-2.738 E(TS)-.438 E F0 .16(If you \214nd a b)108 516 R .16.11 G(EPOR)-2.738 E(TS)-.438 E F0 .16(If you \214nd a b)108 600 R .16
(ug in the)-.2 F F2(history)2.66 E F0(library)2.66 E 2.66(,y)-.65 G .16(ug in the)-.2 F F1(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  (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 S2.66(es)-.1 G .16(ure that it really is)-2.66 F 2.5(ab)108 612 S
(ug, and that it appears in the latest v)-2.7 E(ersion of the)-.15 E F2(ug, and that it appears in the latest v)-2.7 E(ersion of the)-.15 E F1
(history)2.5 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.).15 E .704(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.004 -.15(ve d)-.2 H .704(etermined that a b)(Once you ha)108 628.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 .705.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.205 G(g\255r).2 E(eadline)-.37 E F0(@)A(ug report to)-.2 F F2 -.2(bu)3.204 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)108F2(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.81 -.15(ve a \214)-.2 H 1.51640.8 Q 1.809 -.15(ve a \214)-.2 H 1.509
(x, you are welcome to mail that as well!).15 F 1.509(x, you are welcome to mail that as well!).15 F 1.51
(Suggestions and `philosophical' b)6.509 F 1.509(ug reports may be)-.2 F(Suggestions and `philosophical' b)6.51 F 1.51(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(mailed to)108 652.8 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 F2(gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F1
(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 585.6 Q(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 669.6 Q
(ug reports concerning this manual page should be directed to)-.2 E F1(ug reports concerning this manual page should be directed to)-.2 E F2
 -.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.).25 E  -.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(GNU History 8.1)72 768 Q(2020 July 17)139.005 E(7)203.165 E 0 Cg EP
 %%Trailer  %%Trailer
 end  end
 %%EOF  %%EOF

Removed from v.1.1.1.1  
changed lines
  Added in v.1.1.1.2


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>