1: %!PS-Adobe-3.0
2: %%Creator: groff version 1.22.4
3: %%CreationDate: Mon Oct 12 10:59:26 2020
4: %%DocumentNeededResources: font Times-Roman
5: %%+ font Times-Bold
6: %%+ font Times-Italic
7: %%DocumentSuppliedResources: procset grops 1.22 4
8: %%Pages: 7
9: %%PageOrder: Ascend
10: %%DocumentMedia: Default 612 792 0 () ()
11: %%Orientation: Portrait
12: %%EndComments
13: %%BeginDefaults
14: %%PageMedia: Default
15: %%EndDefaults
16: %%BeginProlog
17: %%BeginResource: procset grops 1.22 4
18: %!PS-Adobe-3.0 Resource-ProcSet
19: /setpacking where{
20: pop
21: currentpacking
22: true setpacking
23: }if
24: /grops 120 dict dup begin
25: /SC 32 def
26: /A/show load def
27: /B{0 SC 3 -1 roll widthshow}bind def
28: /C{0 exch ashow}bind def
29: /D{0 exch 0 SC 5 2 roll awidthshow}bind def
30: /E{0 rmoveto show}bind def
31: /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
32: /G{0 rmoveto 0 exch ashow}bind def
33: /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
34: /I{0 exch rmoveto show}bind def
35: /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
36: /K{0 exch rmoveto 0 exch ashow}bind def
37: /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
38: /M{rmoveto show}bind def
39: /N{rmoveto 0 SC 3 -1 roll widthshow}bind def
40: /O{rmoveto 0 exch ashow}bind def
41: /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
42: /Q{moveto show}bind def
43: /R{moveto 0 SC 3 -1 roll widthshow}bind def
44: /S{moveto 0 exch ashow}bind def
45: /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
46: /SF{
47: findfont exch
48: [exch dup 0 exch 0 exch neg 0 0]makefont
49: dup setfont
50: [exch/setfont cvx]cvx bind def
51: }bind def
52: /MF{
53: findfont
54: [5 2 roll
55: 0 3 1 roll
56: neg 0 0]makefont
57: dup setfont
58: [exch/setfont cvx]cvx bind def
59: }bind def
60: /level0 0 def
61: /RES 0 def
62: /PL 0 def
63: /LS 0 def
64: /MANUAL{
65: statusdict begin/manualfeed true store end
66: }bind def
67: /PLG{
68: gsave newpath clippath pathbbox grestore
69: exch pop add exch pop
70: }bind def
71: /BP{
72: /level0 save def
73: 1 setlinecap
74: 1 setlinejoin
75: DEFS/BPhook known{DEFS begin BPhook end}if
76: 72 RES div dup scale
77: LS{
78: 90 rotate
79: }{
80: 0 PL translate
81: }ifelse
82: 1 -1 scale
83: }bind def
84: /EP{
85: level0 restore
86: showpage
87: }def
88: /DA{
89: newpath arcn stroke
90: }bind def
91: /SN{
92: transform
93: .25 sub exch .25 sub exch
94: round .25 add exch round .25 add exch
95: itransform
96: }bind def
97: /DL{
98: SN
99: moveto
100: SN
101: lineto stroke
102: }bind def
103: /DC{
104: newpath 0 360 arc closepath
105: }bind def
106: /TM matrix def
107: /DE{
108: TM currentmatrix pop
109: translate scale newpath 0 0 .5 0 360 arc closepath
110: TM setmatrix
111: }bind def
112: /RC/rcurveto load def
113: /RL/rlineto load def
114: /ST/stroke load def
115: /MT/moveto load def
116: /CL/closepath load def
117: /Fr{
118: setrgbcolor fill
119: }bind def
120: /setcmykcolor where{
121: pop
122: /Fk{
123: setcmykcolor fill
124: }bind def
125: }if
126: /Fg{
127: setgray fill
128: }bind def
129: /FL/fill load def
130: /LW/setlinewidth load def
131: /Cr/setrgbcolor load def
132: /setcmykcolor where{
133: pop
134: /Ck/setcmykcolor load def
135: }if
136: /Cg/setgray load def
137: /RE{
138: findfont
139: dup maxlength 1 index/FontName known not{1 add}if dict begin
140: {
141: 1 index/FID ne
142: 2 index/UniqueID ne
143: and
144: {def}{pop pop}ifelse
145: }forall
146: /Encoding exch def
147: dup/FontName exch def
148: currentdict end definefont pop
149: }bind def
150: /DEFS 0 def
151: /EBEGIN{
152: moveto
153: DEFS begin
154: }bind def
155: /EEND/end load def
156: /CNT 0 def
157: /level1 0 def
158: /PBEGIN{
159: /level1 save def
160: translate
161: div 3 1 roll div exch scale
162: neg exch neg exch translate
163: 0 setgray
164: 0 setlinecap
165: 1 setlinewidth
166: 0 setlinejoin
167: 10 setmiterlimit
168: []0 setdash
169: /setstrokeadjust where{
170: pop
171: false setstrokeadjust
172: }if
173: /setoverprint where{
174: pop
175: false setoverprint
176: }if
177: newpath
178: /CNT countdictstack def
179: userdict begin
180: /showpage{}def
181: /setpagedevice{}def
182: mark
183: }bind def
184: /PEND{
185: cleartomark
186: countdictstack CNT sub{end}repeat
187: level1 restore
188: }bind def
189: end def
190: /setpacking where{
191: pop
192: setpacking
193: }if
194: %%EndResource
195: %%EndProlog
196: %%BeginSetup
197: %%BeginFeature: *PageSize Default
198: << /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
199: %%EndFeature
200: %%IncludeResource: font Times-Roman
201: %%IncludeResource: font Times-Bold
202: %%IncludeResource: font Times-Italic
203: grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
204: def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
205: /scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
206: /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
207: /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
208: /.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
209: /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
210: /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
211: /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
212: /P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
213: /underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
214: /z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
215: /guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
216: /endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
217: /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
218: /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
219: /brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
220: /logicalnot/minus/registered/macron/degree/plusminus/twosuperior
221: /threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
222: /ordmasculine/guilsinglright/onequarter/onehalf/threequarters
223: /questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
224: /Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
225: /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
226: /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
227: /germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
228: /egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
229: /eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
230: /ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
231: /Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE
232: /Times-Roman@0 ENC0/Times-Roman RE
233: %%EndSetup
234: %%Page: 1 1
235: %%BeginPageSetup
236: BP
237: %%EndPageSetup
238: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
239: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E/F1
240: 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0
241: (history \255 GNU History Library)108 96 Q F1(COPYRIGHT)72 112.8 Q F0
242: (The GNU History Library is Cop)108 124.8 Q
243: (yright \251 1989-2020 by the Free Softw)-.1 E(are F)-.1 E
244: (oundation, Inc.)-.15 E F1(DESCRIPTION)72 141.6 Q F0(Man)108 153.6 Q
245: 2.81(yp)-.15 G .31(rograms read input from the user a line at a time.)
246: -2.81 F .309(The GNU History library is able to k)5.309 F .309
247: (eep track of)-.1 F .024(those lines, associate arbitrary data with eac\
248: h line, and utilize information from pre)108 165.6 R .024
249: (vious lines in composing)-.25 F(ne)108 177.6 Q 2.5(wo)-.25 G(nes.)-2.5
250: E F1(HIST)72 194.4 Q(OR)-.197 E 2.738(YE)-.383 G(XP)-2.738 E(ANSION)-.81
251: E F0 .823(The history library supports a history e)108 206.4 R .822
252: (xpansion feature that is identical to the history e)-.15 F .822
253: (xpansion in)-.15 F/F2 10/Times-Bold@0 SF(bash.)3.322 E F0
254: (This section describes what syntax features are a)108 218.4 Q -.25(va)
255: -.2 G(ilable.).25 E 1.305(History e)108 235.2 R 1.305
256: (xpansions introduce w)-.15 F 1.306(ords from the history list into the\
257: input stream, making it easy to repeat)-.1 F .21
258: (commands, insert the ar)108 247.2 R .21(guments to a pre)-.18 F .209
259: (vious command into the current input line, or \214x errors in pre)-.25
260: F(vious)-.25 E(commands quickly)108 259.2 Q(.)-.65 E 1.296(History e)108
261: 276 R 1.297(xpansion is usually performed immediately after a complete \
262: line is read.)-.15 F 1.297(It tak)6.297 F 1.297(es place in tw)-.1 F(o)
263: -.1 E 2.855(parts. The)108 288 R .354(\214rst is to determine which lin\
264: e from the history list to use during substitution.)2.855 F .354
265: (The second is to)5.354 F .116
266: (select portions of that line for inclusion into the current one.)108
267: 300 R .117(The line selected from the history is the)5.116 F/F3 10
268: /Times-Italic@0 SF -.15(ev)2.617 G(ent).15 E F0(,)A .846
269: (and the portions of that line that are acted upon are)108 312 R F3(wor)
270: 3.346 E(ds)-.37 E F0 5.846(.V)C(arious)-6.956 E F3(modi\214er)3.346 E(s)
271: -.1 E F0 .846(are a)3.346 F -.25(va)-.2 G .845(ilable to manipulate).25
272: F .304(the selected w)108 324 R 2.804(ords. The)-.1 F .304(line is brok)
273: 2.804 F .304(en into w)-.1 F .304(ords in the same f)-.1 F .304
274: (ashion as)-.1 F F2(bash)2.804 E F0 .305(does when reading input, so)
275: 2.804 F .539(that se)108 336 R -.15(ve)-.25 G .539(ral w).15 F .539
276: (ords that w)-.1 F .539
277: (ould otherwise be separated are considered one w)-.1 F .538
278: (ord when surrounded by quotes)-.1 F .307(\(see the description of)108
279: 348 R F2(history_tok)2.807 E(enize\(\))-.1 E F0(belo)2.807 E 2.807
280: (w\). History)-.25 F -.15(ex)2.807 G .307
281: (pansions are introduced by the appearance of).15 F .52(the history e)
282: 108 360 R .52(xpansion character)-.15 F 3.02(,w)-.4 G .52(hich is)-3.02
283: F F2(!)3.853 E F0 .52(by def)3.853 F 3.02(ault. Only)-.1 F .52
284: (backslash \()3.02 F F2(\\).833 E F0 3.02(\)a).833 G .52
285: (nd single quotes can quote the)-3.02 F(history e)108 372 Q
286: (xpansion character)-.15 E(.)-.55 E F2(Ev)87 388.8 Q(ent Designators)-.1
287: E F0 .204(An e)108 400.8 R -.15(ve)-.25 G .204(nt designator is a refer\
288: ence to a command line entry in the history list.).15 F .205
289: (Unless the reference is abso-)5.204 F(lute, e)108 412.8 Q -.15(ve)-.25
290: G(nts are relati).15 E .3 -.15(ve t)-.25 H 2.5(ot).15 G
291: (he current position in the history list.)-2.5 E F2(!)108 429.6 Q F0
292: (Start a history substitution, e)144 429.6 Q(xcept when follo)-.15 E
293: (wed by a)-.25 E F2(blank)2.5 E F0 2.5(,n)C -.25(ew)-2.5 G
294: (line, = or \(.).25 E F2(!)108 441.6 Q F3(n)A F0(Refer to command line)
295: 144 441.6 Q F3(n)2.86 E F0(.).24 E F2<21ad>108 453.6 Q F3(n)A F0
296: (Refer to the current command minus)144 453.6 Q F3(n)2.86 E F0(.).24 E
297: F2(!!)108 465.6 Q F0(Refer to the pre)144 465.6 Q(vious command.)-.25 E
298: (This is a synon)5 E(ym for `!\2551'.)-.15 E F2(!)108 477.6 Q F3(string)
299: A F0 .865(Refer to the most recent command preceding the current positi\
300: on in the history list starting with)144 477.6 R F3(string)144.34 489.6
301: Q F0(.).22 E F2(!?)108 501.6 Q F3(string)A F2([?])A F0 1.503(Refer to t\
302: he most recent command preceding the current position in the history li\
303: st containing)144 513.6 R F3(string)144.34 525.6 Q F0 5.497(.T).22 G
304: .497(he trailing)-5.497 F F2(?)2.997 E F0 .497(may be omitted if)2.997 F
305: F3(string)3.337 E F0 .496(is follo)3.216 F .496(wed immediately by a ne)
306: -.25 F 2.996(wline. If)-.25 F F3(string)2.996 E F0(is)2.996 E .39(missi\
307: ng, the string from the most recent search is used; it is an error if t\
308: here is no pre)144 537.6 R .391(vious search)-.25 F(string.)144 549.6 Q
309: /F4 12/Times-Bold@0 SF(^)108 566.6 Q F3(string1)-5 I F4(^)5 I F3
310: (string2)-5 I F4(^)5 I F0 2.599(Quick substitution.)144 573.6 R 2.598
311: (Repeat the last command, replacing)7.599 F F3(string1)5.438 E F0(with)
312: 5.098 E F3(string2)5.438 E F0 7.598(.E).02 G(qui)-7.598 E -.25(va)-.25 G
313: 2.598(lent to).25 F -.74(``)144 585.6 S(!!:s).74 E/F5 12/Times-Roman@0
314: SF(^)5 I F3(string1)-5 I F5(^)5 I F3(string2)-5 I F5(^)5 I F0 1.48 -.74
315: ('' \()-5 L(see).74 E F2(Modi\214ers)2.5 E F0(belo)2.5 E(w\).)-.25 E F2
316: (!#)108 597.6 Q F0(The entire command line typed so f)144 597.6 Q(ar)-.1
317: E(.)-.55 E F2 -.75(Wo)87 614.4 S(rd Designators).75 E F0 -.8(Wo)108
318: 626.4 S 1.313(rd designators are used to select desired w).8 F 1.314
319: (ords from the e)-.1 F -.15(ve)-.25 G 3.814(nt. A).15 F F2(:)3.814 E F0
320: 1.314(separates the e)3.814 F -.15(ve)-.25 G 1.314(nt speci\214cation)
321: .15 F .53(from the w)108 638.4 R .529(ord designator)-.1 F 5.529(.I)-.55
322: G 3.029(tm)-5.529 G .529(ay be omitted if the w)-3.029 F .529
323: (ord designator be)-.1 F .529(gins with a)-.15 F F2(^)3.029 E F0(,)A F2
324: ($)3.029 E F0(,)A F2(*)3.029 E F0(,)A F2<ad>3.029 E F0 3.029(,o)C(r)
325: -3.029 E F2(%)3.029 E F0 5.529(.W)C(ords)-6.329 E .515
326: (are numbered from the be)108 650.4 R .516
327: (ginning of the line, with the \214rst w)-.15 F .516
328: (ord being denoted by 0 \(zero\).)-.1 F -.8(Wo)5.516 G .516(rds are in-)
329: .8 F(serted into the current line separated by single spaces.)108 662.4
330: Q F2 2.5(0\()108 679.2 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 691.2
331: Q 2.5(ord. F)-.1 F(or the shell, this is the command w)-.15 E(ord.)-.1 E
332: F3(n)108.36 703.2 Q F0(The)144 703.2 Q F3(n)2.5 E F0(th w)A(ord.)-.1 E
333: F2(^)108 715.2 Q F0(The \214rst ar)144 715.2 Q 2.5(gument. That)-.18 F
334: (is, w)2.5 E(ord 1.)-.1 E(GNU History 8.1)72 768 Q(2020 July 17)139.005
335: E(1)203.165 E 0 Cg EP
336: %%Page: 2 2
337: %%BeginPageSetup
338: BP
339: %%EndPageSetup
340: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
341: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E/F1
342: 10/Times-Bold@0 SF($)108 84 Q F0 .064(The last w)144 84 R 2.564
343: (ord. This)-.1 F .064(is usually the last ar)2.564 F .064(gument, b)-.18
344: F .064(ut will e)-.2 F .064(xpand to the zeroth w)-.15 F .063
345: (ord if there is only)-.1 F(one w)144 96 Q(ord in the line.)-.1 E F1(%)
346: 108 108 Q F0 1.419(The \214rst w)144 108 R 1.419
347: (ord matched by the most recent `?)-.1 F/F2 10/Times-Italic@0 SF(string)
348: A F0 1.42(?' search, if the search string be)B 1.42(gins with a)-.15 F
349: (character that is part of a w)144 120 Q(ord.)-.1 E F2(x)108.77 132 Q F1
350: <ad>A F2(y)A F0 2.5(Ar)144 132 S(ange of w)-2.5 E(ords; `\255)-.1 E F2
351: (y)A F0 2.5('a)C(bbre)-2.5 E(viates `0\255)-.25 E F2(y)A F0('.)A F1(*)
352: 108 144 Q F0 .316(All of the w)144 144 R .316(ords b)-.1 F .316
353: (ut the zeroth.)-.2 F .315(This is a synon)5.315 F .315(ym for `)-.15 F
354: F2(1\255$)A F0 2.815('. It)B .315(is not an error to use)2.815 F F1(*)
355: 2.815 E F0 .315(if there is)2.815 F(just one w)144 156 Q(ord in the e)
356: -.1 E -.15(ve)-.25 G(nt; the empty string is returned in that case.).15
357: E F1(x*)108 168 Q F0(Abbre)144 168 Q(viates)-.25 E F2(x\255$)2.5 E F0(.)
358: A F1<78ad>108 180 Q F0(Abbre)144 180 Q(viates)-.25 E F2(x\255$)2.5 E F0
359: (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
360: 2.5(ord. If)-.1 F F1(x)2.5 E F0(is missing, it def)2.5 E(aults to 0.)-.1
361: E(If a w)108 196.8 Q(ord designator is supplied without an e)-.1 E -.15
362: (ve)-.25 G(nt speci\214cation, the pre).15 E
363: (vious command is used as the e)-.25 E -.15(ve)-.25 G(nt.).15 E F1
364: (Modi\214ers)87 213.6 Q F0 .183(After the optional w)108 225.6 R .183
365: (ord designator)-.1 F 2.683(,t)-.4 G .184
366: (here may appear a sequence of one or more of the follo)-2.683 F .184
367: (wing modi\214ers,)-.25 F(each preceded by a `:'.)108 237.6 Q
368: (These modify)5 E 2.5(,o)-.65 G 2.5(re)-2.5 G(dit, the w)-2.5 E
369: (ord or w)-.1 E(ords selected from the history e)-.1 E -.15(ve)-.25 G
370: (nt.).15 E F1(h)108 254.4 Q F0(Remo)144 254.4 Q .3 -.15(ve a t)-.15 H
371: (railing \214le name component, lea).15 E(ving only the head.)-.2 E F1
372: (t)108 266.4 Q F0(Remo)144 266.4 Q .3 -.15(ve a)-.15 H
373: (ll leading \214le name components, lea).15 E(ving the tail.)-.2 E F1(r)
374: 108 278.4 Q F0(Remo)144 278.4 Q .3 -.15(ve a t)-.15 H(railing suf).15 E
375: (\214x of the form)-.25 E F2(.xxx)2.5 E F0 2.5(,l)C(ea)-2.5 E
376: (ving the basename.)-.2 E F1(e)108 290.4 Q F0(Remo)144 290.4 Q .3 -.15
377: (ve a)-.15 H(ll b).15 E(ut the trailing suf)-.2 E(\214x.)-.25 E F1(p)108
378: 302.4 Q F0(Print the ne)144 302.4 Q 2.5(wc)-.25 G(ommand b)-2.5 E
379: (ut do not e)-.2 E -.15(xe)-.15 G(cute it.).15 E F1(q)108 314.4 Q F0
380: (Quote the substituted w)144 314.4 Q
381: (ords, escaping further substitutions.)-.1 E F1(x)108 326.4 Q F0 .386
382: (Quote the substituted w)144 326.4 R .386(ords as with)-.1 F F1(q)2.886
383: E F0 2.886(,b)C .386(ut break into w)-3.086 F .385(ords at)-.1 F F1
384: (blanks)2.885 E F0 .385(and ne)2.885 F 2.885(wlines. The)-.25 F F1(q)
385: 2.885 E F0(and)2.885 E F1(x)2.885 E F0(modi\214ers are mutually e)144
386: 338.4 Q(xclusi)-.15 E -.15(ve)-.25 G 2.5(;t).15 G
387: (he last one supplied is used.)-2.5 E F1(s/)108 350.4 Q F2(old)A F1(/)A
388: F2(ne)A(w)-.15 E F1(/)A F0(Substitute)144 362.4 Q F2(ne)3.328 E(w)-.15 E
389: F0 .469(for the \214rst occurrence of)3.278 F F2(old)3.199 E F0 .469
390: (in the e)3.739 F -.15(ve)-.25 G .469(nt line.).15 F(An)5.469 E 2.969
391: (yc)-.15 G .469(haracter may be used as the)-2.969 F .954
392: (delimiter in place of /.)144 374.4 R .953
393: (The \214nal delimiter is optional if it is the last character of the e)
394: 5.953 F -.15(ve)-.25 G .953(nt line.).15 F .131
395: (The delimiter may be quoted in)144 386.4 R F2(old)2.861 E F0(and)3.401
396: E F2(ne)2.991 E(w)-.15 E F0 .131(with a single backslash.)2.941 F .131
397: (If & appears in)5.131 F F2(ne)2.991 E(w)-.15 E F0 2.631(,i).31 G 2.631
398: (ti)-2.631 G 2.631(sr)-2.631 G(e-)-2.631 E .62(placed by)144 398.4 R F2
399: (old)3.349 E F0 5.619(.A).77 G .619(single backslash will quote the &.)
400: -2.5 F(If)5.619 E F2(old)3.349 E F0 .619(is null, it is set to the last)
401: 3.889 F F2(old)3.349 E F0(substi-)3.889 E .486(tuted, or)144 410.4 R
402: 2.986(,i)-.4 G 2.986(fn)-2.986 G 2.986(op)-2.986 G(re)-2.986 E .486
403: (vious history substitutions took place, the last)-.25 F F2(string)3.326
404: E F0 .487(in a)3.206 F F1(!?)2.987 E F2(string)A F1([?])A F0 2.987
405: (search. If)5.487 F F2(ne)144.36 422.4 Q(w)-.15 E F0
406: (is null, each matching)2.81 E F2(old)2.73 E F0(is deleted.)3.27 E F1(&)
407: 108 434.4 Q F0(Repeat the pre)144 434.4 Q(vious substitution.)-.25 E F1
408: (g)108 446.4 Q F0 .398(Cause changes to be applied o)144 446.4 R -.15
409: (ve)-.15 G 2.898(rt).15 G .398(he entire e)-2.898 F -.15(ve)-.25 G .398
410: (nt line.).15 F .397(This is used in conjunction with `)5.398 F F1(:s)A
411: F0 2.897('\()C(e.g.,)-2.897 E(`)144 458.4 Q F1(:gs/)A F2(old)A F1(/)A F2
412: (ne)A(w)-.15 E F1(/)A F0 .35('\) or `)B F1(:&)A F0 2.85('. If)B .35
413: (used with `)2.85 F F1(:s)A F0 .35(', an)B 2.85(yd)-.15 G .351
414: (elimiter can be used in place of /, and the \214nal de-)-2.85 F
415: (limiter is optional if it is the last character of the e)144 470.4 Q
416: -.15(ve)-.25 G(nt line.).15 E(An)5 E F1(a)2.5 E F0
417: (may be used as a synon)2.5 E(ym for)-.15 E F1(g)2.5 E F0(.)A F1(G)108
418: 482.4 Q F0(Apply the follo)144 482.4 Q(wing `)-.25 E F1(s)A F0 2.5('o)C
419: 2.5(r`)-2.5 G F1(&)-2.5 E F0 2.5('m)C(odi\214er once to each w)-2.5 E
420: (ord in the e)-.1 E -.15(ve)-.25 G(nt line.).15 E/F3 10.95/Times-Bold@0
421: SF(PR)72 499.2 Q(OGRAMMING WITH HIST)-.329 E(OR)-.197 E 2.738(YF)-.383 G
422: (UNCTIONS)-2.738 E F0(This section describes ho)108 511.2 Q 2.5(wt)-.25
423: G 2.5(ou)-2.5 G(se the History library in other programs.)-2.5 E F1
424: (Intr)87 528 Q(oduction to History)-.18 E F0 2.883(Ap)108 540 S .383
425: (rogrammer using the History library has a)-2.883 F -.25(va)-.2 G .382
426: (ilable functions for remembering lines on a history list, as-).25 F .77
427: (sociating arbitrary data with a line, remo)108 552 R .771
428: (ving lines from the list, searching through the list for a line con-)
429: -.15 F .303(taining an arbitrary te)108 564 R .303
430: (xt string, and referencing an)-.15 F 2.803(yl)-.15 G .303
431: (ine in the list directly)-2.803 F 5.303(.I)-.65 G 2.803(na)-5.303 G
432: .303(ddition, a history)-2.803 F F2 -.2(ex)2.802 G(pansion).2 E F0
433: (function is a)108 576 Q -.25(va)-.2 G(ilable which pro).25 E
434: (vides for a consistent user interf)-.15 E(ace across dif)-.1 E
435: (ferent programs.)-.25 E .059(The user using programs written with the \
436: History library has the bene\214t of a consistent user interf)108 592.8
437: R .059(ace with a)-.1 F .918(set of well-kno)108 604.8 R .917
438: (wn commands for manipulating the te)-.25 F .917(xt of pre)-.15 F .917
439: (vious lines and using that te)-.25 F .917(xt in ne)-.15 F 3.417(wc)-.25
440: G(om-)-3.417 E 4.183(mands. The)108 616.8 R 1.684(basic history manipul\
441: ation commands are identical to the history substitution pro)4.183 F
442: 1.684(vided by)-.15 F F1(bash)108 628.8 Q F0(.)A .915
443: (The programmer can also use the Readline library)108 645.6 R 3.415(,w)
444: -.65 G .915(hich includes some history manipulation by def)-3.415 F
445: (ault,)-.1 E(and has the added adv)108 657.6 Q
446: (antage of command line editing.)-.25 E .39(Before declaring an)108
447: 674.4 R 2.89(yf)-.15 G .39(unctions using an)-2.89 F 2.89(yf)-.15 G .39
448: (unctionality the History library pro)-2.89 F .39
449: (vides in other code, an appli-)-.15 F .067
450: (cation writer should include the \214le)108 686.4 R F2(<r)4.233 E
451: (eadline/history)-.37 E(.h>)-.55 E F0 .067(in an)4.233 F 2.566<798c>-.15
452: G .066(le that uses the History library')-2.566 F 2.566(sf)-.55 G
453: (eatures.)-2.566 E .538(It supplies e)108 698.4 R .538
454: (xtern declarations for all of the library')-.15 F 3.038(sp)-.55 G .538
455: (ublic functions and v)-3.038 F .539(ariables, and declares all of the)
456: -.25 F(public data structures.)108 710.4 Q(GNU History 8.1)72 768 Q
457: (2020 July 17)139.005 E(2)203.165 E 0 Cg EP
458: %%Page: 3 3
459: %%BeginPageSetup
460: BP
461: %%EndPageSetup
462: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
463: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E/F1
464: 10/Times-Bold@0 SF(History Storage)87 84 Q F0
465: (The history list is an array of history entries.)108 96 Q 2.5(Ah)5 G
466: (istory entry is declared as follo)-2.5 E(ws:)-.25 E/F2 10
467: /Times-Italic@0 SF(typedef void *)108 112.8 Q F1(histdata_t;)2.5 E F0
468: (typedef struct _hist_entry {)108 129.6 Q(char *line;)113 141.6 Q
469: (char *timestamp;)113 153.6 Q(histdata_t data;)113 165.6 Q 2.5(}H)108
470: 177.6 S(IST_ENTR)-2.5 E -.92(Y;)-.65 G
471: (The history list itself might therefore be declared as)108 194.4 Q F2
472: (HIST_ENTR)108 211.2 Q 2.5(Y*)-.18 G(*)-2.5 E F1(the_history_list;)2.5 E
473: F0(The state of the History library is encapsulated into a single struc\
474: ture:)108 228 Q(/*)108 244.8 Q 2.5(*As)110.5 256.8 S
475: (tructure used to pass around the current state of the history)-2.5 E(.)
476: -.65 E(*/)110.5 268.8 Q(typedef struct _hist_state {)108 280.8 Q
477: (HIST_ENTR)113 292.8 Q 2.5(Y*)-.65 G
478: (*entries; /* Pointer to the entries themselv)-2.5 E(es. */)-.15 E
479: (int of)113 304.8 Q 25(fset; /*)-.25 F
480: (The location pointer within this array)2.5 E 2.5(.*)-.65 G(/)-2.5 E
481: (int length;)113 316.8 Q(/* Number of elements within this array)27.5 E
482: 2.5(.*)-.65 G(/)-2.5 E(int size;)113 328.8 Q
483: (/* Number of slots allocated to this array)32.5 E 2.5(.*)-.65 G(/)-2.5
484: E(int \215ags;)113 340.8 Q 2.5(}H)108 352.8 S(IST)-2.5 E(OR)-.18 E(Y_ST)
485: -.65 E -1.11(AT)-.93 G(E;)1.11 E(If the \215ags member includes)108
486: 369.6 Q F1(HS_STIFLED)2.5 E F0 2.5(,t)C(he history has been sti\215ed.)
487: -2.5 E/F3 10.95/Times-Bold@0 SF(History Functions)72 386.4 Q F0
488: (This section describes the calling sequence for the v)108 398.4 Q
489: (arious functions e)-.25 E(xported by the GNU History library)-.15 E(.)
490: -.65 E F1(Initializing History and State Management)87 415.2 Q F0 1.274
491: (This section describes functions used to initialize and manage the sta\
492: te of the History library when you)108 427.2 R -.1(wa)108 439.2 S
493: (nt to use the history functions in your program.).1 E F2(void)108 463.2
494: Q F1(using_history)2.5 E F0(\()4.166 E F2(void)A F0(\))1.666 E(Be)108
495: 475.2 Q(gin a session in which the history functions might be used.)-.15
496: E(This initializes the interacti)5 E .3 -.15(ve v)-.25 H(ariables.)-.1 E
497: F2(HIST)108 499.2 Q(OR)-.18 E(Y_ST)-.18 E -.37(AT)-.5 G 2.5(E*).37 G F1
498: (history_get_history_state)A F0(\()4.166 E F2(void)A F0(\))1.666 E
499: (Return a structure describing the current state of the input history)
500: 108 511.2 Q(.)-.65 E F2(void)108 535.2 Q F1(history_set_history_state)
501: 2.5 E F0(\()4.166 E F2(HIST)A(OR)-.18 E(Y_ST)-.18 E -.37(AT)-.5 G 2.5
502: (E*).37 G(state)-2.5 E F0(\))1.666 E
503: (Set the state of the history list according to)108 547.2 Q F2(state)2.5
504: E F0(.)A F1(History List Management)87 576 Q F0
505: (These functions manage indi)108 588 Q(vidual entries on the history li\
506: st, or set parameters managing the list itself.)-.25 E F2(void)108 612 Q
507: F1(add_history)2.5 E F0(\()4.166 E F2(const c)A(har *string)-.15 E F0
508: (\))1.666 E(Place)108 624 Q F2(string)3.279 E F0 .779
509: (at the end of the history list.)3.279 F .779
510: (The associated data \214eld \(if an)5.779 F .779(y\) is set to)-.15 F
511: F1(NULL)3.279 E F0 5.779(.I)C 3.279(ft)-5.779 G .78(he maxi-)-3.279 F
512: .787(mum number of history entries has been set using)108 636 R F1
513: (sti\215e_history\(\))3.286 E F0 3.286(,a)C .786(nd the ne)-3.286 F
514: 3.286(wn)-.25 G .786(umber of history entries)-3.286 F -.1(wo)108 648 S
515: (uld e).1 E(xceed that maximum, the oldest history entry is remo)-.15 E
516: -.15(ve)-.15 G(d.).15 E F2(void)108 672 Q F1(add_history_time)2.5 E F0
517: (\()4.166 E F2(const c)A(har *string)-.15 E F0(\))1.666 E
518: (Change the time stamp associated with the most recent history entry to)
519: 108 684 Q F2(string)2.5 E F0(.)A F2(HIST_ENTR)108 708 Q 2.5(Y*)-.18 G F1
520: -.18(re)C(mo).18 E -.1(ve)-.1 G(_history).1 E F0(\()4.166 E F2(int whic)
521: A(h)-.15 E F0(\))1.666 E(Remo)108 720 Q .352 -.15(ve h)-.15 H .052
522: (istory entry at of).15 F(fset)-.25 E F2(whic)2.553 E(h)-.15 E F0 .053
523: (from the history)2.553 F 5.053(.T)-.65 G .053(he remo)-5.053 F -.15(ve)
524: -.15 G 2.553(de).15 G .053(lement is returned so you can free the)-2.553
525: F(GNU History 8.1)72 768 Q(2020 July 17)139.005 E(3)203.165 E 0 Cg EP
526: %%Page: 4 4
527: %%BeginPageSetup
528: BP
529: %%EndPageSetup
530: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
531: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E
532: (line, data, and containing structure.)108 84 Q/F1 10/Times-Italic@0 SF
533: (histdata_t)108 108 Q/F2 10/Times-Bold@0 SF(fr)2.5 E(ee_history_entry)
534: -.18 E F0(\()4.166 E F1(HIST_ENTR)A 2.5(Y*)-.18 G(histent)-2.5 E F0(\))
535: 1.666 E .934(Free the history entry)108 120 R F1(histent)3.433 E F0 .933
536: (and an)3.433 F 3.433(yh)-.15 G .933(istory library pri)-3.433 F -.25
537: (va)-.25 G .933(te data associated with it.).25 F .933
538: (Returns the applica-)5.933 F
539: (tion-speci\214c data so the caller can dispose of it.)108 132 Q F1
540: (HIST_ENTR)108 156 Q 2.5(Y*)-.18 G F2 -.18(re)C(place_history_entry).18
541: E F0(\()4.166 E F1(int whic)A -.834(h, const)-.15 F -.15(ch)2.5 G
542: (ar *line).15 E 1.666(,h)-.1 G(istdata_t data)-1.666 E F0(\))3.332 E
543: (Mak)108 168 Q 3.062(et)-.1 G .562(he history entry at of)-3.062 F(fset)
544: -.25 E F1(whic)3.062 E(h)-.15 E F0(ha)3.062 E -.15(ve)-.2 G F1(line)
545: 3.212 E F0(and)3.062 E F1(data)3.062 E F0 5.563(.T)C .563
546: (his returns the old entry so the caller can dis-)-5.563 F(pose of an)
547: 108 180 Q 2.5(ya)-.15 G(pplication-speci\214c data.)-2.5 E
548: (In the case of an in)5 E -.25(va)-.4 G(lid).25 E F1(whic)2.5 E(h)-.15 E
549: F0 2.5(,a)C F2(NULL)A F0(pointer is returned.)2.5 E F1(void)108 204 Q F2
550: (clear_history)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E
551: (Clear the history list by deleting all the entries.)108 216 Q F1(void)
552: 108 240 Q F2(sti\215e_history)2.5 E F0(\()4.166 E F1(int max)A F0(\))
553: 1.666 E .38(Sti\215e the history list, remembering only the last)108 252
554: R F1(max)2.88 E F0 2.88(entries. The)2.88 F .38
555: (history list will contain only)2.88 F F1(max)2.88 E F0(entries)2.88 E
556: (at a time.)108 264 Q F1(int)108 288 Q F2(unsti\215e_history)2.5 E F0
557: (\()4.166 E F1(void)A F0(\))1.666 E .46(Stop sti\215ing the history)108
558: 300 R 5.46(.T)-.65 G .46(his returns the pre)-5.46 F .46
559: (viously-set maximum number of history entries \(as set by)-.25 F F2
560: (sti-)2.96 E(\215e_history\(\))108 312 Q F0 2.5(\). history)B -.1(wa)2.5
561: G 2.5(ss).1 G 2.5(ti\215ed. The)-2.5 F -.25(va)2.5 G(lue is positi).25 E
562: .3 -.15(ve i)-.25 H 2.5(ft).15 G(he history w)-2.5 E(as sti\215ed, ne)
563: -.1 E -.05(ga)-.15 G(ti).05 E .3 -.15(ve i)-.25 H 2.5(fi).15 G 2.5(tw)
564: -2.5 G(asn')-2.6 E(t.)-.18 E F1(int)108 336 Q F2(history_is_sti\215ed)
565: 2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E
566: (Returns non-zero if the history is sti\215ed, zero if it is not.)108
567: 348 Q F2(Inf)87 376.8 Q(ormation About the History List)-.25 E F0(These\
568: functions return information about the entire history list or indi)108
569: 388.8 Q(vidual list entries.)-.25 E F1(HIST_ENTR)108 412.8 Q 2.5(Y*)-.18
570: G(*)-2.5 E F2(history_list)2.5 E F0(\()4.166 E F1(void)A F0(\))1.666 E
571: .708(Return a)108 424.8 R F2(NULL)3.208 E F0 .708(terminated array of)
572: 3.208 F F1(HIST_ENTR)3.208 E 3.208(Y*)-.18 G F0 .708
573: (which is the current input history)B 5.707(.E)-.65 G .707
574: (lement 0 of this)-5.707 F(list is the be)108 436.8 Q(ginning of time.)
575: -.15 E(If there is no history)5 E 2.5(,r)-.65 G(eturn)-2.5 E F2(NULL)2.5
576: E F0(.)A F1(int)108 460.8 Q F2(wher)2.5 E(e_history)-.18 E F0(\()4.166 E
577: F1(void)A F0(\))1.666 E(Returns the of)108 472.8 Q
578: (fset of the current history element.)-.25 E F1(HIST_ENTR)108 496.8 Q
579: 2.5(Y*)-.18 G F2(curr)A(ent_history)-.18 E F0(\()4.166 E F1(void)A F0
580: (\))1.666 E 1.373
581: (Return the history entry at the current position, as determined by)108
582: 508.8 R F2(wher)3.873 E(e_history\(\))-.18 E F0 6.373(.I)C 3.873(ft)
583: -6.373 G 1.374(here is no entry)-3.873 F(there, return a)108 520.8 Q F2
584: (NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1(HIST_ENTR)108 544.8 Q 2.5(Y*)
585: -.18 G F2(history_get)A F0(\()4.166 E F1(int of)A(fset)-.18 E F0(\))
586: 1.666 E 1.069(Return the history entry at position)108 556.8 R F1(of)
587: 3.569 E(fset)-.18 E F0 6.069(.T)C 1.069(he range of v)-6.069 F 1.069
588: (alid v)-.25 F 1.069(alues of)-.25 F F1(of)3.569 E(fset)-.18 E F0 1.068
589: (starts at)3.569 F F2(history_base)3.568 E F0(and)3.568 E .286(ends at)
590: 108 568.8 R F2(history_length)2.786 E F0 2.786<ad31>2.786 G 5.286(.I)
591: -2.786 G 2.786(ft)-5.286 G .286(here is no entry there, or if)-2.786 F
592: F1(of)2.786 E(fset)-.18 E F0 .286(is outside the v)2.786 F .287
593: (alid range, return a)-.25 F F2(NULL)2.787 E F0(pointer)108 580.8 Q(.)
594: -.55 E F1(time_t)108 604.8 Q F2(history_get_time)2.5 E F0(\()4.166 E F1
595: (HIST_ENTR)A 2.5(Y*)-.18 G F0(\))-.834 E(Return the time stamp associat\
596: ed with the history entry passed as the ar)108 616.8 Q(gument.)-.18 E F1
597: (int)108 640.8 Q F2(history_total_bytes)2.5 E F0(\()4.166 E F1(void)A F0
598: (\))1.666 E .392
599: (Return the number of bytes that the primary history entries are using.)
600: 108 652.8 R .391(This function returns the sum of the)5.392 F
601: (lengths of all the lines in the history)108 664.8 Q(.)-.65 E F2(Mo)87
602: 693.6 Q(ving Ar)-.1 E(ound the History List)-.18 E F0
603: (These functions allo)108 705.6 Q 2.5(wt)-.25 G(he current inde)-2.5 E
604: 2.5(xi)-.15 G(nto the history list to be set or changed.)-2.5 E F1(int)
605: 108 729.6 Q F2(history_set_pos)2.5 E F0(\()4.166 E F1(int pos)A F0(\))
606: 1.666 E(GNU History 8.1)72 768 Q(2020 July 17)139.005 E(4)203.165 E 0 Cg
607: EP
608: %%Page: 5 5
609: %%BeginPageSetup
610: BP
611: %%EndPageSetup
612: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
613: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E .79
614: (Set the current history of)108 84 R .79(fset to)-.25 F/F1 10
615: /Times-Italic@0 SF(pos)3.29 E F0 3.29(,a)C 3.29(na)-3.29 G .79
616: (bsolute inde)-3.29 F 3.29(xi)-.15 G .79(nto the list.)-3.29 F .79
617: (Returns 1 on success, 0 if)5.79 F F1(pos)3.29 E F0 .79(is less)3.29 F
618: (than zero or greater than the number of history entries.)108 96 Q F1
619: (HIST_ENTR)108 120 Q 2.5(Y*)-.18 G/F2 10/Times-Bold@0 SF(pr)A -.15(ev)
620: -.18 G(ious_history).15 E F0(\()4.166 E F1(void)A F0(\))1.666 E .208
621: (Back up the current history of)108 132 R .208(fset to the pre)-.25 F
622: .208(vious history entry)-.25 F 2.707(,a)-.65 G .207
623: (nd return a pointer to that entry)-2.707 F 5.207(.I)-.65 G 2.707(ft)
624: -5.207 G .207(here is)-2.707 F(no pre)108 144 Q(vious entry)-.25 E 2.5
625: (,r)-.65 G(eturn a)-2.5 E F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F1
626: (HIST_ENTR)108 168 Q 2.5(Y*)-.18 G F2(next_history)A F0(\()4.166 E F1
627: (void)A F0(\))1.666 E .332(If the current history of)108 180 R .333
628: (fset refers to a v)-.25 F .333(alid history entry)-.25 F 2.833(,i)-.65
629: G .333(ncrement the current history of)-2.833 F 2.833(fset. If)-.25 F
630: .333(the possi-)2.833 F .202(bly-incremented history of)108 192 R .202
631: (fset refers to a v)-.25 F .202(alid history entry)-.25 F 2.702(,r)-.65
632: G .202(eturn a pointer to that entry; otherwise, return)-2.702 F(a)108
633: 204 Q F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F2(Sear)87 232.8 Q
634: (ching the History List)-.18 E F0 .005(These functions allo)108 244.8 R
635: 2.505(ws)-.25 G .006(earching of the history list for entries containin\
636: g a speci\214c string.)-2.505 F .006(Searching may be)5.006 F 1.452
637: (performed both forw)108 256.8 R 1.452(ard and backw)-.1 F 1.451
638: (ard from the current history position.)-.1 F 1.451(The search may be)
639: 6.451 F F1(anc)3.951 E(hor)-.15 E(ed)-.37 E F0(,)A
640: (meaning that the string must match at the be)108 268.8 Q
641: (ginning of the history entry)-.15 E(.)-.65 E F1(int)108 292.8 Q F2
642: (history_sear)2.5 E(ch)-.18 E F0(\()4.166 E F1(const c)A(har *string)
643: -.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))1.666 E .155
644: (Search the history for)108 304.8 R F1(string)2.655 E F0 2.656(,s)C .156
645: (tarting at the current history of)-2.656 F 2.656(fset. If)-.25 F F1
646: (dir)2.656 E(ection)-.37 E F0 .156(is less than 0, then the search)2.656
647: F .802(is through pre)108 316.8 R .802
648: (vious entries, otherwise through subsequent entries.)-.25 F(If)5.801 E
649: F1(string)3.301 E F0 .801(is found, then the current his-)3.301 F .064
650: (tory inde)108 328.8 R 2.564(xi)-.15 G 2.564(ss)-2.564 G .064
651: (et to that history entry)-2.564 F 2.564(,a)-.65 G .064(nd the v)-2.564
652: F .064(alue returned is the of)-.25 F .064
653: (fset in the line of the entry where)-.25 F F1(string)2.565 E F0 -.1(wa)
654: 108 340.8 S 2.5(sf).1 G 2.5(ound. Otherwise,)-2.5 F
655: (nothing is changed, and a -1 is returned.)2.5 E F1(int)108 364.8 Q F2
656: (history_sear)2.5 E(ch_pr)-.18 E(e\214x)-.18 E F0(\()4.166 E F1(const c)
657: A(har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E(ection)-.37 E F0(\))
658: 1.666 E .684(Search the history for)108 376.8 R F1(string)3.183 E F0
659: 3.183(,s)C .683(tarting at the current history of)-3.183 F 3.183
660: (fset. The)-.25 F .683(search is anchored: matching lines)3.183 F 1.063
661: (must be)108 388.8 R 1.063(gin with)-.15 F F1(string)3.563 E F0 6.063
662: (.I)C(f)-6.063 E F1(dir)3.563 E(ection)-.37 E F0 1.064
663: (is less than 0, then the search is through pre)3.563 F 1.064
664: (vious entries, otherwise)-.25 F .34(through subsequent entries.)108
665: 400.8 R(If)5.34 E F1(string)2.84 E F0 .34
666: (is found, then the current history inde)2.84 F 2.84(xi)-.15 G 2.84(ss)
667: -2.84 G .34(et to that entry)-2.84 F 2.84(,a)-.65 G .34(nd the re-)-2.84
668: F(turn v)108 412.8 Q(alue is 0.)-.25 E
669: (Otherwise, nothing is changed, and a -1 is returned.)5 E F1(int)108
670: 436.8 Q F2(history_sear)2.5 E(ch_pos)-.18 E F0(\()4.166 E F1(const c)A
671: (har *string)-.15 E 1.666(,i)-.1 G(nt dir)-1.666 E -.834(ection, int)
672: -.37 F(pos)2.5 E F0(\))3.332 E .603(Search for)108 448.8 R F1(string)
673: 3.103 E F0 .603(in the history list, starting at)3.103 F F1(pos)3.104 E
674: F0 3.104(,a)C 3.104(na)-3.104 G .604(bsolute inde)-3.104 F 3.104(xi)-.15
675: G .604(nto the list.)-3.104 F(If)5.604 E F1(dir)3.104 E(ection)-.37 E F0
676: .604(is ne)3.104 F -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G(,).15 E .608
677: (the search proceeds backw)108 460.8 R .608(ard from)-.1 F F1(pos)3.108
678: E F0 3.108(,o)C .608(therwise forw)-3.108 F 3.108(ard. Returns)-.1 F
679: .608(the absolute inde)3.108 F 3.108(xo)-.15 G 3.108(ft)-3.108 G .608
680: (he history ele-)-3.108 F(ment where)108 472.8 Q F1(string)2.5 E F0 -.1
681: (wa)2.5 G 2.5(sf).1 G(ound, or -1 otherwise.)-2.5 E F2
682: (Managing the History File)87 501.6 Q F0 .035(The History library can r\
683: ead the history from and write it to a \214le.)108 513.6 R .036
684: (This section documents the functions for)5.035 F
685: (managing a history \214le.)108 525.6 Q F1(int)108 549.6 Q F2 -.18(re)
686: 2.5 G(ad_history).18 E F0(\()4.166 E F1(const c)A(har *\214lename)-.15 E
687: F0(\))1.666 E .151(Add the contents of)108 561.6 R F1(\214lename)2.651 E
688: F0 .151(to the history list, a line at a time.)2.651 F(If)5.15 E F1
689: (\214lename)2.65 E F0(is)2.65 E F2(NULL)2.65 E F0 2.65(,t)C .15
690: (hen read from)-2.65 F F1(~/.his-)2.65 E(tory)108 573.6 Q F0 5(.R)C
691: (eturns 0 if successful, or)-5 E F2(err)2.5 E(no)-.15 E F0(if not.)2.5 E
692: F1(int)108 597.6 Q F2 -.18(re)2.5 G(ad_history_range).18 E F0(\()4.166 E
693: F1(const c)A(har *\214lename)-.15 E 1.666(,i)-.1 G(nt fr)-1.666 E -.834
694: (om, int)-.45 F(to)2.5 E F0(\))3.332 E .052(Read a range of lines from)
695: 108 609.6 R F1(\214lename)2.553 E F0 2.553(,a)C .053
696: (dding them to the history list.)-2.553 F .053(Start reading at line)
697: 5.053 F F1(fr)2.553 E(om)-.45 E F0 .053(and end at)2.553 F F1(to)2.553 E
698: F0(.)A(If)108 621.6 Q F1(fr)2.889 E(om)-.45 E F0 .389
699: (is zero, start at the be)2.889 F 2.889(ginning. If)-.15 F F1(to)2.889 E
700: F0 .389(is less than)2.889 F F1(fr)2.889 E(om)-.45 E F0 2.889(,t)C .388
701: (hen read until the end of the \214le.)-2.889 F(If)5.388 E F1
702: (\214lename)2.888 E F0(is)108 633.6 Q F2(NULL)2.5 E F0 2.5(,t)C
703: (hen read from)-2.5 E F1(~/.history)2.5 E F0 5(.R)C
704: (eturns 0 if successful, or)-5 E F2(err)2.5 E(no)-.15 E F0(if not.)2.5 E
705: F1(int)108 657.6 Q F2(write_history)2.5 E F0(\()4.166 E F1(const c)A
706: (har *\214lename)-.15 E F0(\))1.666 E .961(Write the current history to)
707: 108 669.6 R F1(\214lename)3.461 E F0 3.461(,o)C -.15(ve)-3.611 G
708: (rwriting).15 E F1(\214lename)3.461 E F0 .961(if necessary)3.461 F 5.961
709: (.I)-.65 G(f)-5.961 E F1(\214lename)3.462 E F0(is)3.462 E F2(NULL)3.462
710: E F0 3.462(,t)C .962(hen write)-3.462 F(the history list to)108 681.6 Q
711: F1(~/.history)2.5 E F0 5(.R)C(eturns 0 on success, or)-5 E F2(err)2.5 E
712: (no)-.15 E F0(on a read or write error)2.5 E(.)-.55 E F1(int)108 717.6 Q
713: F2(append_history)2.5 E F0(\()4.166 E F1(int nelements,)A(const c)1.666
714: E(har *\214lename)-.15 E F0(\))1.666 E .839(Append the last)108 729.6 R
715: F1(nelements)3.339 E F0 .839(of the history list to)3.339 F F1
716: (\214lename)3.339 E F0 5.839(.I)C(f)-5.839 E F1(\214lename)3.339 E F0
717: (is)3.339 E F2(NULL)3.339 E F0 3.339(,t)C .838(hen append to)-3.339 F F1
718: (~/.history)3.338 E F0(.)A(GNU History 8.1)72 768 Q(2020 July 17)139.005
719: E(5)203.165 E 0 Cg EP
720: %%Page: 6 6
721: %%BeginPageSetup
722: BP
723: %%EndPageSetup
724: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
725: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E
726: (Returns 0 on success, or)108 84 Q/F1 10/Times-Bold@0 SF(err)2.5 E(no)
727: -.15 E F0(on a read or write error)2.5 E(.)-.55 E/F2 10/Times-Italic@0
728: SF(int)108 108 Q F1(history_truncate_\214le)2.5 E F0(\()4.166 E F2
729: (const c)A(har *\214lename)-.15 E 1.666(,i)-.1 G(nt nlines)-1.666 E F0
730: (\))1.666 E -.35(Tr)108 120 S .38(uncate the history \214le).35 F F2
731: (\214lename)2.88 E F0 2.88(,l)C(ea)-2.88 E .38(ving only the last)-.2 F
732: F2(nlines)2.881 E F0 2.881(lines. If)2.881 F F2(\214lename)2.881 E F0
733: (is)2.881 E F1(NULL)2.881 E F0 2.881(,t)C(hen)-2.881 E F2(~/.history)
734: 2.881 E F0(is)2.881 E 2.5(truncated. Returns)108 132 R 2.5(0o)2.5 G 2.5
735: (ns)-2.5 G(uccess, or)-2.5 E F1(err)2.5 E(no)-.15 E F0(on f)2.5 E
736: (ailure.)-.1 E F1(History Expansion)87 160.8 Q F0
737: (These functions implement history e)108 172.8 Q(xpansion.)-.15 E F2
738: (int)108 196.8 Q F1(history_expand)2.5 E F0(\()4.166 E F2 -.15(ch)C
739: (ar *string).15 E 1.666(,c)-.1 G(har **output)-1.816 E F0(\))1.666 E
740: (Expand)108 208.8 Q F2(string)2.5 E F0 2.5(,p)C(lacing the result into)
741: -2.5 E F2(output)2.5 E F0 2.5(,ap)C(ointer to a string.)-2.5 E(Returns:)
742: 5 E(0)144 220.8 Q .566(If no e)180 220.8 R .566
743: (xpansions took place \(or)-.15 F 3.065(,i)-.4 G 3.065(ft)-3.065 G .565
744: (he only change in the te)-3.065 F .565(xt w)-.15 F .565(as the remo)-.1
745: F -.25(va)-.15 G 3.065(lo).25 G 3.065(fe)-3.065 G(scape)-3.065 E
746: (characters preceding the history e)180 232.8 Q(xpansion character\);)
747: -.15 E(1)144 244.8 Q(if e)180 244.8 Q(xpansions did tak)-.15 E 2.5(ep)
748: -.1 G(lace;)-2.5 E(-1)144 256.8 Q(if there w)180 256.8 Q
749: (as an error in e)-.1 E(xpansion;)-.15 E(2)144 268.8 Q
750: (if the returned line should be displayed, b)180 268.8 Q(ut not e)-.2 E
751: -.15(xe)-.15 G(cuted, as with the).15 E F1(:p)2.5 E F0(modi\214er)2.5 E
752: (.)-.55 E(If an error occurred in e)108 280.8 Q(xpansion, then)-.15 E F2
753: (output)2.5 E F0(contains a descripti)2.5 E .3 -.15(ve e)-.25 H
754: (rror message.).15 E F2 -.15(ch)108 304.8 S(ar *).15 E F1(get_history_e)
755: 2.5 E -.1(ve)-.15 G(nt).1 E F0(\()4.166 E F2(const c)A(har *string)-.15
756: E 1.666(,i)-.1 G(nt *cinde)-1.666 E -.834(x, int)-.2 F(qc)2.5 E(har)-.15
757: E F0(\))3.332 E .262(Returns the te)108 316.8 R .262
758: (xt of the history e)-.15 F -.15(ve)-.25 G .262(nt be).15 F .263
759: (ginning at)-.15 F F2(string)2.763 E F0(+)2.763 E F2(*cinde)2.763 E(x)
760: -.2 E F0(.)A F2(*cinde)5.263 E(x)-.2 E F0 .263
761: (is modi\214ed to point to after the)2.763 F -2.15 -.25(ev e)108 328.8 T
762: .71(nt speci\214er).25 F 5.71(.A)-.55 G 3.21(tf)-5.71 G .71
763: (unction entry)-3.21 F(,)-.65 E F2(cinde)3.21 E(x)-.2 E F0 .709
764: (points to the inde)3.21 F 3.209(xi)-.15 G(nto)-3.209 E F2(string)3.209
765: E F0 .709(where the history e)3.209 F -.15(ve)-.25 G .709
766: (nt speci\214ca-).15 F .527(tion be)108 340.8 R(gins.)-.15 E F2(qc)5.527
767: E(har)-.15 E F0 .527(is a character that is allo)3.027 F .527
768: (wed to end the e)-.25 F -.15(ve)-.25 G .528
769: (nt speci\214cation in addition to the `).15 F(`normal')-.74 E(')-.74 E
770: (terminating characters.)108 352.8 Q F2 -.15(ch)108 376.8 S(ar **).15 E
771: F1(history_tok)2.5 E(enize)-.1 E F0(\()4.166 E F2(const c)A(har *string)
772: -.15 E F0(\))1.666 E .239(Return an array of tok)108 388.8 R .239
773: (ens parsed out of)-.1 F F2(string)2.739 E F0 2.739(,m)C .238
774: (uch as the shell might.)-2.739 F .238(The tok)5.238 F .238
775: (ens are split on the charac-)-.1 F(ters in the)108 400.8 Q F1
776: (history_w)2.5 E(ord_delimiters)-.1 E F0 -.25(va)2.5 G
777: (riable, and shell quoting con).25 E -.15(ve)-.4 G(ntions are obe).15 E
778: (yed.)-.15 E F2 -.15(ch)108 424.8 S(ar *).15 E F1(history_ar)2.5 E
779: (g_extract)-.1 E F0(\()4.166 E F2(int \214r)A -.834(st, int)-.1 F -.834
780: (last, const)2.5 F -.15(ch)2.5 G(ar *string).15 E F0(\))3.332 E .025
781: (Extract a string se)108 436.8 R .025(gment consisting of the)-.15 F F2
782: <8c72>2.526 E(st)-.1 E F0(through)2.526 E F2(last)2.526 E F0(ar)2.526 E
783: .026(guments present in)-.18 F F2(string)2.526 E F0 5.026(.A)C -.18(rg)
784: -5.026 G .026(uments are split).18 F(using)108 448.8 Q F1(history_tok)
785: 2.5 E(enize\(\))-.1 E F0(.)A F1(History V)87 477.6 Q(ariables)-.92 E F0
786: (This section describes the e)108 489.6 Q(xternally-visible v)-.15 E
787: (ariables e)-.25 E(xported by the GNU History Library)-.15 E(.)-.65 E F2
788: (int)108 513.6 Q F1(history_base)2.5 E F0(The logical of)108 525.6 Q
789: (fset of the \214rst entry in the history list.)-.25 E F2(int)108 549.6
790: Q F1(history_length)2.5 E F0
791: (The number of entries currently stored in the history list.)108 561.6 Q
792: F2(int)108 585.6 Q F1(history_max_entries)2.5 E F0
793: (The maximum number of history entries.)108 597.6 Q
794: (This must be changed using)5 E F1(sti\215e_history\(\))2.5 E F0(.)A F2
795: (int)108 621.6 Q F1(history_write_timestamps)2.5 E F0 .484
796: (If non-zero, timestamps are written to the history \214le, so the)108
797: 633.6 R 2.983(yc)-.15 G .483(an be preserv)-2.983 F .483
798: (ed between sessions.)-.15 F .483(The de-)5.483 F -.1(fa)108 645.6 S
799: .994(ult v).1 F .994(alue is 0, meaning that timestamps are not sa)-.25
800: F -.15(ve)-.2 G 3.494(d. The).15 F .994
801: (current timestamp format uses the v)3.494 F .995(alue of)-.25 F F2
802: (history_comment_c)108 657.6 Q(har)-.15 E F0 .051
803: (to delimit timestamp entries in the history \214le.)2.552 F .051
804: (If that v)5.051 F .051(ariable does not ha)-.25 F .351 -.15(ve a v)-.2
805: H(alue)-.1 E(\(the def)108 669.6 Q
806: (ault\), timestamps will not be written.)-.1 E F2 -.15(ch)108 693.6 S
807: (ar).15 E F1(history_expansion_char)2.5 E F0
808: (The character that introduces a history e)108 705.6 Q -.15(ve)-.25 G
809: 2.5(nt. The).15 F(def)2.5 E(ault is)-.1 E F1(!)2.5 E F0 5(.S)C
810: (etting this to 0 inhibits history e)-5 E(xpansion.)-.15 E F2 -.15(ch)
811: 108 729.6 S(ar).15 E F1(history_subst_char)2.5 E F0(GNU History 8.1)72
812: 768 Q(2020 July 17)139.005 E(6)203.165 E 0 Cg EP
813: %%Page: 7 7
814: %%BeginPageSetup
815: BP
816: %%EndPageSetup
817: /F0 10/Times-Roman@0 SF(HIST)72 48 Q(OR)-.18 E 124.845(Y\(3\) Library)
818: -.65 F(Functions Manual)2.5 E(HIST)127.345 E(OR)-.18 E(Y\(3\))-.65 E
819: (The character that in)108 84 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(sw).1 G
820: (ord substitution if found at the start of a line.)-2.6 E(The def)5 E
821: (ault is)-.1 E/F1 10/Times-Bold@0 SF(^)2.5 E F0(.)A/F2 10/Times-Italic@0
822: SF -.15(ch)108 108 S(ar).15 E F1(history_comment_char)2.5 E F0 .116
823: (During tok)108 120 R .117
824: (enization, if this character is seen as the \214rst character of a w)
825: -.1 F .117(ord, then it and all subsequent char)-.1 F(-)-.2 E .277
826: (acters up to a ne)108 132 R .276
827: (wline are ignored, suppressing history e)-.25 F .276
828: (xpansion for the remainder of the line.)-.15 F .276(This is dis-)5.276
829: F(abled by def)108 144 Q(ault.)-.1 E F2 -.15(ch)108 168 S(ar *).15 E F1
830: (history_w)2.5 E(ord_delimiters)-.1 E F0
831: (The characters that separate tok)108 180 Q(ens for)-.1 E F1
832: (history_tok)2.5 E(enize\(\))-.1 E F0 5(.T)C(he def)-5 E(ault v)-.1 E
833: (alue is)-.25 E F1 2.5("\\)2.5 G(t\\n\(\)<>;&|")-2.5 E F0(.)A F2 -.15
834: (ch)108 204 S(ar *).15 E F1(history_no_expand_chars)2.5 E F0 2.054
835: (The list of characters which inhibit history e)108 216 R 2.054
836: (xpansion if found immediately follo)-.15 F(wing)-.25 E F1
837: (history_expan-)4.555 E(sion_char)108 228 Q F0 5(.T)C(he def)-5 E
838: (ault is space, tab, ne)-.1 E(wline,)-.25 E F1(\\r)2.5 E F0 2.5(,a)C(nd)
839: -2.5 E F1(=)2.5 E F0(.)A F2 -.15(ch)108 252 S(ar *).15 E F1
840: (history_sear)2.5 E(ch_delimiter_chars)-.18 E F0 .401(The list of addit\
841: ional characters which can delimit a history search string, in addition\
842: to space, tab,)108 264 R F2(:)2.901 E F0(and)2.901 E F2(?)2.901 E F0
843: (in the case of a substring search.)108 276 Q(The def)5 E(ault is empty)
844: -.1 E(.)-.65 E F2(int)108 300 Q F1(history_quotes_inhibit_expansion)2.5
845: E F0 .86(If non-zero, double-quoted w)108 312 R .861
846: (ords are not scanned for the history e)-.1 F .861
847: (xpansion character or the history com-)-.15 F(ment character)108 324 Q
848: 5(.T)-.55 G(he def)-5 E(ault v)-.1 E(alue is 0.)-.25 E F2(rl_lineb)108
849: 348 Q(uf_func_t *)-.2 E F1(history_inhibit_expansion_function)2.5 E F0
850: .348(This should be set to the address of a function that tak)108 360 R
851: .348(es tw)-.1 F 2.848(oa)-.1 G -.18(rg)-2.848 G .347(uments: a).18 F F1
852: .347(char *)2.847 F F0(\()2.847 E F2(string)A F0 2.847(\)a)C .347(nd an)
853: -2.847 F F1(int)2.847 E F0(inde)2.847 E(x)-.15 E .227
854: (into that string \()108 372 R F2(i)A F0 2.727(\). It)B .227
855: (should return a non-zero v)2.727 F .227(alue if the history e)-.25 F
856: .227(xpansion starting at)-.15 F F2(string[i])2.728 E F0 .228
857: (should not)2.728 F .019(be performed; zero if the e)108 384 R .019
858: (xpansion should be done.)-.15 F .019
859: (It is intended for use by applications lik)5.019 F(e)-.1 E F1(bash)
860: 2.519 E F0 .018(that use)2.519 F(the history e)108 396 Q
861: (xpansion character for additional purposes.)-.15 E(By def)5 E
862: (ault, this v)-.1 E(ariable is set to)-.25 E F1(NULL)2.5 E F0(.)A/F3
863: 10.95/Times-Bold@0 SF(FILES)72 412.8 Q F2(~/.history)109.666 424.8 Q F0
864: (Def)144 436.8 Q(ault \214lename for reading and writing sa)-.1 E -.15
865: (ve)-.2 G 2.5(dh).15 G(istory)-2.5 E F3(SEE ALSO)72 453.6 Q F2
866: (The Gnu Readline Libr)108 465.6 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E
867: (ox and Chet Rame)-.15 E(y)-.15 E F2(The Gnu History Libr)108 477.6 Q
868: (ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E
869: F2(bash)108 489.6 Q F0(\(1\))A F2 -.37(re)108 501.6 S(adline).37 E F0
870: (\(3\))A F3 -.548(AU)72 518.4 S(THORS).548 E F0(Brian F)108 530.4 Q
871: (ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108
872: 542.4 Q(g)-.18 E(Chet Rame)108 559.2 Q 1.3 -.65(y, C)-.15 H(ase W).65 E
873: (estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E
874: (chet.rame)108 571.2 Q(y@case.edu)-.15 E F3 -.11(BU)72 588 S 2.738(GR)
875: .11 G(EPOR)-2.738 E(TS)-.438 E F0 .16(If you \214nd a b)108 600 R .16
876: (ug in the)-.2 F F1(history)2.66 E F0(library)2.66 E 2.66(,y)-.65 G .16
877: (ou should report it.)-2.66 F .16(But \214rst, you should mak)5.16 F
878: 2.66(es)-.1 G .16(ure that it really is)-2.66 F 2.5(ab)108 612 S
879: (ug, and that it appears in the latest v)-2.7 E(ersion of the)-.15 E F1
880: (history)2.5 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.).15 E .705
881: (Once you ha)108 628.8 R 1.005 -.15(ve d)-.2 H .705(etermined that a b)
882: .15 F .704(ug actually e)-.2 F .704(xists, mail a b)-.15 F .704
883: (ug report to)-.2 F F2 -.2(bu)3.204 G(g\255r).2 E(eadline)-.37 E F0(@)A
884: F2(gnu.or)A(g)-.37 E F0 5.704(.I)C 3.204(fy)-5.704 G(ou)-3.204 E(ha)108
885: 640.8 Q 1.809 -.15(ve a \214)-.2 H 1.509
886: (x, you are welcome to mail that as well!).15 F 1.51
887: (Suggestions and `philosophical' b)6.51 F 1.51(ug reports may be)-.2 F
888: (mailed to)108 652.8 Q F2 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F2
889: (gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F1
890: (gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 669.6 Q
891: (ug reports concerning this manual page should be directed to)-.2 E F2
892: -.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.).25 E
893: (GNU History 8.1)72 768 Q(2020 July 17)139.005 E(7)203.165 E 0 Cg EP
894: %%Trailer
895: end
896: %%EOF
897:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to history_3.ps CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / readline / doc