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