summaryrefslogtreecommitdiff
path: root/doc/readline_3.ps
blob: c7b925e1f5fa79ea3be72c85fa1e95fd9a003b7f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon May 21 10:32:52 2018
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%+ font Courier
%%DocumentSuppliedResources: procset grops 1.22 3
%%Pages: 17
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.22 3
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
DEFS/BPhook known{DEFS begin BPhook end}if
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne
2 index/UniqueID ne
and
{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
mark
}bind def
/PEND{
cleartomark
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
%%IncludeResource: font Courier
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/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
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Courier@0 ENC0/Courier RE/Times-Italic@0 ENC0/Times-Italic RE
/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10.95/Times-Bold@0 SF
-.219(NA)72 84 S(ME).219 E F0
(readline \255 get a line from a user with editing)108 96 Q F1(SYNOPSIS)
72 112.8 Q/F2 10/Times-Bold@0 SF(#include <stdio.h>)108 124.8 Q
(#include <r)108 136.8 Q(eadline/r)-.18 E(eadline.h>)-.18 E(#include <r)
108 148.8 Q(eadline/history)-.18 E(.h>)-.7 E/F3 10/Times-Italic@0 SF
-.15(ch)108 165.6 S(ar *).15 E F2 -.18(re)108 177.6 S(adline).18 E F0
(\()2.5 E F3(const c)A(har *pr)-.15 E(ompt)-.45 E F0(\);)A F1(COPYRIGHT)
72 194.4 Q F0(Readline is Cop)108 206.4 Q
(yright \251 1989\2552014 Free Softw)-.1 E(are F)-.1 E(oundation, Inc.)
-.15 E F1(DESCRIPTION)72 223.2 Q F2 -.18(re)108 235.2 S(adline).18 E F0
.088(will read a line from the terminal and return it, using)2.588 F F2
(pr)2.587 E(ompt)-.18 E F0 .087(as a prompt.)2.587 F(If)5.087 E F2(pr)
2.587 E(ompt)-.18 E F0(is)2.587 E F2(NULL)2.587 E F0(or)2.587 E .42
(the empty string, no prompt is issued.)108 247.2 R .421
(The line returned is allocated with)5.42 F F3(malloc)2.921 E F0 .421
(\(3\); the caller must free it).31 F(when \214nished.)108 259.2 Q
(The line returned has the \214nal ne)5 E(wline remo)-.25 E -.15(ve)-.15
G(d, so only the te).15 E(xt of the line remains.)-.15 E F2 -.18(re)108
276 S(adline).18 E F0(of)3.79 E 1.29
(fers editing capabilities while the user is entering the line.)-.25 F
1.289(By def)6.289 F 1.289(ault, the line editing com-)-.1 F
(mands are similar to those of emacs.)108 288 Q 2.5(Av)5 G
(i\255style line editing interf)-2.5 E(ace is also a)-.1 E -.25(va)-.2 G
(ilable.).25 E .272
(This manual page describes only the most basic use of)108 304.8 R F2
-.18(re)2.772 G(adline).18 E F0 5.272(.M)C .272
(uch more functionality is a)-5.272 F -.25(va)-.2 G .272(ilable; see).25
F F3(The GNU Readline Libr)108 316.8 Q(ary)-.15 E F0(and)2.5 E F3
(The GNU History Libr)2.5 E(ary)-.15 E F0(for additional information.)
2.5 E F1(RETURN V)72 333.6 Q(ALUE)-1.478 E F2 -.18(re)108 345.6 S
(adline).18 E F0 1.09(returns the te)3.59 F 1.09(xt of the line read.)
-.15 F 3.589(Ab)6.09 G 1.089(lank line returns the empty string.)-3.589
F(If)6.089 E F2(EOF)3.589 E F0 1.089(is encountered)3.589 F .283
(while reading a line, and the line is empty)108 357.6 R(,)-.65 E F2
(NULL)2.783 E F0 .283(is returned.)2.783 F .283(If an)5.283 F F2(EOF)
2.783 E F0 .283(is read with a non\255empty line, it)2.783 F
(is treated as a ne)108 369.6 Q(wline.)-.25 E F1(NO)72 386.4 Q -.986(TA)
-.438 G(TION)-.054 E F0 .077
(An Emacs-style notation is used to denote k)108 398.4 R -.15(ey)-.1 G
(strok).15 E 2.576(es. Control)-.1 F -.1(ke)2.576 G .076
(ys are denoted by C\255)-.05 F F3 -.1(ke)C(y)-.2 E F0 2.576(,e)C .076
(.g., C\255n means)-2.576 F 2.582(Control\255N. Similarly)108 410.4 R(,)
-.65 E F3(meta)2.962 E F0 -.1(ke)2.842 G .082(ys are denoted by M\255)
-.05 F F3 -.1(ke)C(y)-.2 E F0 2.583(,s)C 2.583(oM)-2.583 G .083
(\255x means Meta\255X.)-2.583 F .083(\(On k)5.083 F -.15(ey)-.1 G .083
(boards without a).15 F F3(meta)108.38 422.4 Q F0 -.1(ke)3.472 G 2.012
-.65(y, M)-.05 H<ad>.65 E F3(x)A F0 .712(means ESC)3.212 F F3(x)3.212 E
F0 3.212(,i)C .712(.e., press the Escape k)-3.212 F 1.011 -.15(ey t)-.1
H .711(hen the).15 F F3(x)3.981 E F0 -.1(ke)3.741 G 4.511 -.65(y. T)-.05
H .711(his mak).65 F .711(es ESC the)-.1 F F3 .711(meta pr)3.211 F
(e\214x)-.37 E F0(.)A .48(The combination M\255C\255)108 434.4 R F3(x)A
F0 .48(means ESC\255Control\255)2.98 F F3(x)A F0 2.98(,o)C 2.98(rp)-2.98
G .48(ress the Escape k)-2.98 F .78 -.15(ey t)-.1 H .48
(hen hold the Control k).15 F .78 -.15(ey w)-.1 H(hile).15 E
(pressing the)108 446.4 Q F3(x)3.27 E F0 -.1(ke)3.03 G -.65(y.)-.05 G
(\)).65 E .62(Readline commands may be gi)108 463.2 R -.15(ve)-.25 G
3.119(nn).15 G(umeric)-3.119 E F3(ar)3.119 E(guments)-.37 E F0 3.119(,w)
.27 G .619(hich normally act as a repeat count.)-3.119 F(Sometimes,)
5.619 E(ho)108 475.2 Q(we)-.25 E -.15(ve)-.25 G 1.418 -.4(r, i).15 H
3.118(ti).4 G 3.119(st)-3.118 G .619(he sign of the ar)-3.119 F .619
(gument that is signi\214cant.)-.18 F -.15(Pa)5.619 G .619(ssing a ne)
.15 F -.05(ga)-.15 G(ti).05 E .919 -.15(ve a)-.25 H -.18(rg).15 G .619
(ument to a command that).18 F 1.019(acts in the forw)108 487.2 R 1.018
(ard direction \(e.g.,)-.1 F F2(kill\255line)3.518 E F0 3.518(\)c)C
1.018(auses that command to act in a backw)-3.518 F 1.018
(ard direction.)-.1 F(Com-)6.018 E(mands whose beha)108 499.2 Q
(vior with ar)-.2 E(guments de)-.18 E(viates from this are noted belo)
-.25 E -.65(w.)-.25 G .811(When a command is described as)108 516 R F3
(killing)3.311 E F0(te)3.311 E .811(xt, the te)-.15 F .811
(xt deleted is sa)-.15 F -.15(ve)-.2 G 3.311(df).15 G .812
(or possible future retrie)-3.311 F -.25(va)-.25 G 3.312(l\().25 G F3
(yank-)-3.312 E(ing)108 528 Q F0 2.529(\). The)B .029(killed te)2.529 F
.029(xt is sa)-.15 F -.15(ve)-.2 G 2.529(di).15 G 2.529(na)-2.529 G F3
.029(kill ring)B F0 5.029(.C)C(onsecuti)-5.029 E .329 -.15(ve k)-.25 H
.029(ills cause the te).15 F .029(xt to be accumulated into one unit,)
-.15 F .567(which can be yank)108 540 R .567(ed all at once.)-.1 F .567
(Commands which do not kill te)5.567 F .567
(xt separate the chunks of te)-.15 F .567(xt on the kill)-.15 F(ring.)
108 552 Q F1(INITIALIZA)72 568.8 Q(TION FILE)-1.04 E F0 .091(Readline i\
s customized by putting commands in an initialization \214le \(the)108
580.8 R F3(inputr)2.591 E(c)-.37 E F0 2.591(\214le\). The)2.591 F .091
(name of this \214le)2.591 F 1.442(is tak)108 592.8 R 1.443
(en from the v)-.1 F 1.443(alue of the)-.25 F F2(INPUTRC)3.943 E F0(en)
3.943 E 1.443(vironment v)-.4 F 3.943(ariable. If)-.25 F 1.443(that v)
3.943 F 1.443(ariable is unset, the def)-.25 F 1.443(ault is)-.1 F F3
(~/.inputr)108 604.8 Q(c)-.37 E F0 5.058(.I).31 G 2.558(ft)-5.058 G .058
(hat \214le)-2.558 F .058(does not e)5.058 F .058
(xist or cannot be read, the ultimate def)-.15 F .058(ault is)-.1 F F3
(/etc/inputr)2.557 E(c)-.37 E F0 5.057(.W).31 G .057(hen a program)
-5.057 F 1.158(which uses the readline library starts up, the init \214\
le is read, and the k)108 616.8 R 1.459 -.15(ey b)-.1 H 1.159
(indings and v).15 F 1.159(ariables are set.)-.25 F .029
(There are only a fe)108 628.8 R 2.529(wb)-.25 G .029
(asic constructs allo)-2.529 F .028(wed in the readline init \214le.)
-.25 F .028(Blank lines are ignored.)5.028 F .028(Lines be)5.028 F(gin-)
-.15 E .553(ning with a)108 640.8 R F2(#)3.053 E F0 .554(are comments.)
3.053 F .554(Lines be)5.554 F .554(ginning with a)-.15 F F2($)3.054 E F0
.554(indicate conditional constructs.)3.054 F .554(Other lines denote)
5.554 F -.1(ke)108 652.8 S 2.987(yb)-.05 G .487(indings and v)-2.987 F
.487(ariable settings.)-.25 F .487
(Each program using this library may add its o)5.487 F .486
(wn commands and bind-)-.25 F(ings.)108 664.8 Q -.15(Fo)108 681.6 S 2.5
(re).15 G(xample, placing)-2.65 E(M\255Control\255u: uni)144 698.4 Q
-.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(or)108 710.4 Q
(C\255Meta\255u: uni)144 722.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)
-.18 E(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(1)190.955 E
0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(into the)108 84 Q/F1 10
/Times-Italic@0 SF(inputr)2.51 E(c)-.37 E F0 -.1(wo)2.81 G(uld mak).1 E
2.5(eM)-.1 G(\255C\255u e)-2.5 E -.15(xe)-.15 G
(cute the readline command).15 E F1(univer)2.5 E(sal\255ar)-.1 E(gument)
-.37 E F0(.).68 E 2.795(The follo)108 100.8 R 2.795
(wing symbolic character names are recognized while processing k)-.25 F
3.095 -.15(ey b)-.1 H(indings:).15 E F1(DEL)5.295 E F0(,).53 E F1(ESC)
5.295 E F0(,).72 E F1(ESCAPE)108 112.8 Q F0(,).73 E F1(LFD)2.5 E F0(,)
.28 E F1(NEWLINE)2.5 E F0(,).73 E F1(RET)2.5 E F0(,)1.27 E F1(RETURN)2.5
E F0(,)1.1 E F1 -.4(RU)2.5 G(BOUT).4 E F0(,)1.27 E F1(SP)2.5 E -.3(AC)
-.9 G(E).3 E F0(,).73 E F1(SPC)2.5 E F0 2.5(,a).72 G(nd)-2.5 E F1 -.5
(TA)2.5 G(B).5 E F0(.).27 E .209
(In addition to command names, readline allo)108 129.6 R .209(ws k)-.25
F -.15(ey)-.1 G 2.709(st).15 G 2.709(ob)-2.709 G 2.709(eb)-2.709 G .209
(ound to a string that is inserted when the k)-2.709 F .509 -.15(ey i)
-.1 H(s).15 E(pressed \(a)108 141.6 Q F1(macr)2.5 E(o)-.45 E F0(\).)A/F2
10/Times-Bold@0 SF -.25(Ke)87 158.4 S 2.5(yB).25 G(indings)-2.5 E F0
.366(The syntax for controlling k)108 170.4 R .666 -.15(ey b)-.1 H .366
(indings in the).15 F F1(inputr)2.876 E(c)-.37 E F0 .366
(\214le is simple.)3.176 F .366(All that is required is the name of the)
5.366 F .264(command or the te)108 182.4 R .264(xt of a macro and a k)
-.15 F .564 -.15(ey s)-.1 H .264(equence to which it should be bound.)
.15 F .263(The name may be speci-)5.264 F .853(\214ed in one of tw)108
194.4 R 3.353(ow)-.1 G .853(ays: as a symbolic k)-3.453 F 1.153 -.15
(ey n)-.1 H .853(ame, possibly with).15 F F1(Meta\255)3.353 E F0(or)
3.353 E F1(Contr)3.353 E(ol\255)-.45 E F0(pre\214x)3.353 E .853
(es, or as a k)-.15 F -.15(ey)-.1 G 2.919(sequence. The)108 206.4 R .419
(name and k)2.919 F .719 -.15(ey s)-.1 H .419
(equence are separated by a colon.).15 F .419
(There can be no whitespace between the)5.419 F(name and the colon.)108
218.4 Q .361(When using the form)108 235.2 R F2 -.1(ke)2.861 G(yname).1
E F0(:)A F1(function-name).833 E F0(or)2.861 E F1(macr)2.861 E(o)-.45 E
F0(,)A F1 -.1(ke)2.861 G(yname)-.2 E F0 .362(is the name of a k)3.042 F
.662 -.15(ey s)-.1 H .362(pelled out in Eng-).15 F 2.5(lish. F)108 247.2
R(or e)-.15 E(xample:)-.15 E(Control\255u: uni)144 271.2 Q -.15(ve)-.25
G(rsal\255ar).15 E(gument)-.18 E(Meta\255Rubout: backw)144 283.2 Q
(ard\255kill\255w)-.1 E(ord)-.1 E(Control\255o: "> output")144 295.2 Q
.148(In the abo)108 312 R .448 -.15(ve ex)-.15 H(ample,).15 E F1(C\255u)
2.488 E F0 .148(is bound to the function)2.898 F F2(uni)2.647 E -.1(ve)
-.1 G(rsal\255ar).1 E(gument)-.1 E F0(,)A F1(M-DEL)3.327 E F0 .147
(is bound to the function)3.177 F F2(backward\255kill\255w)108 324 Q
(ord)-.1 E F0 3.835(,a)C(nd)-3.835 E F1(C\255o)3.675 E F0 1.336
(is bound to run the macro e)4.016 F 1.336
(xpressed on the right hand side \(that is, to)-.15 F(insert the te)108
336 Q(xt)-.15 E/F3 10/Courier@0 SF 6(>o)2.5 G(utput)-6 E F0
(into the line\).)2.5 E .056(In the second form,)108 352.8 R F2("k)2.556
E(eyseq")-.1 E F0(:)A F1(function\255name).833 E F0(or)2.556 E F1(macr)
2.556 E(o)-.45 E F0(,)A F2 -.1(ke)2.556 G(yseq).1 E F0(dif)2.555 E .055
(fers from)-.25 F F2 -.1(ke)2.555 G(yname).1 E F0(abo)2.555 E .355 -.15
(ve i)-.15 H 2.555(nt).15 G .055(hat strings)-2.555 F 1.284
(denoting an entire k)108 364.8 R 1.584 -.15(ey s)-.1 H 1.284(equence m\
ay be speci\214ed by placing the sequence within double quotes.).15 F
(Some)6.284 E .386(GNU Emacs style k)108 376.8 R .686 -.15(ey e)-.1 H
.385(scapes can be used, as in the follo).15 F .385(wing e)-.25 F .385
(xample, b)-.15 F .385(ut the symbolic character names)-.2 F
(are not recognized.)108 388.8 Q("\\C\255u": uni)144 412.8 Q -.15(ve)
-.25 G(rsal\255ar).15 E(gument)-.18 E
("\\C\255x\\C\255r": re\255read\255init\255\214le)144 424.8 Q
("\\e[11~": "Function K)144 436.8 Q .3 -.15(ey 1)-.25 H(").15 E .198
(In this e)108 453.6 R(xample,)-.15 E F1(C-u)2.538 E F0 .199(is ag)2.949
F .199(ain bound to the function)-.05 F F2(uni)2.699 E -.1(ve)-.1 G
(rsal\255ar).1 E(gument)-.1 E F0(.)A F1 .199(C-x C-r)5.039 F F0 .199
(is bound to the function)3.429 F F2 -.18(re)108 465.6 S<ad72>.18 E
(ead\255init\255\214le)-.18 E F0 2.5(,a)C(nd)-2.5 E F1(ESC [ 1 1 ~)3.01
E F0(is bound to insert the te)3.94 E(xt)-.15 E F3(Function Key 1)2.5 E
F0(.)A(The full set of GNU Emacs style escape sequences a)108 482.4 Q
-.25(va)-.2 G(ilable when specifying k).25 E .3 -.15(ey s)-.1 H
(equences is).15 E F2<5c43ad>144 494.4 Q F0(control pre\214x)180 494.4 Q
F2<5c4dad>144 506.4 Q F0(meta pre\214x)180 506.4 Q F2(\\e)144 518.4 Q F0
(an escape character)180 518.4 Q F2(\\\\)144 530.4 Q F0(backslash)180
530.4 Q F2(\\")144 542.4 Q F0(literal ", a double quote)180 542.4 Q F2
(\\')144 554.4 Q F0(literal ', a single quote)180 554.4 Q(In addition t\
o the GNU Emacs style escape sequences, a second set of backslash escap\
es is a)108 571.2 Q -.25(va)-.2 G(ilable:).25 E F2(\\a)144 583.2 Q F0
(alert \(bell\))180 583.2 Q F2(\\b)144 595.2 Q F0(backspace)180 595.2 Q
F2(\\d)144 607.2 Q F0(delete)180 607.2 Q F2(\\f)144 619.2 Q F0
(form feed)180 619.2 Q F2(\\n)144 631.2 Q F0(ne)180 631.2 Q(wline)-.25 E
F2(\\r)144 643.2 Q F0(carriage return)180 643.2 Q F2(\\t)144 655.2 Q F0
(horizontal tab)180 655.2 Q F2(\\v)144 667.2 Q F0 -.15(ve)180 667.2 S
(rtical tab).15 E F2(\\)144 679.2 Q F1(nnn)A F0
(the eight-bit character whose v)180 679.2 Q(alue is the octal v)-.25 E
(alue)-.25 E F1(nnn)2.5 E F0(\(one to three digits\))2.5 E F2(\\x)144
691.2 Q F1(HH)A F0(the eight-bit character whose v)180 691.2 Q
(alue is the he)-.25 E(xadecimal v)-.15 E(alue)-.25 E F1(HH)2.5 E F0
(\(one or tw)2.5 E 2.5(oh)-.1 G .3 -.15(ex d)-2.5 H(igits\)).15 E .74
(When entering the te)108 708 R .74(xt of a macro, single or double quo\
tes should be used to indicate a macro de\214nition.)-.15 F .089
(Unquoted te)108 720 R .089(xt is assumed to be a function name.)-.15 F
.09(In the macro body)5.089 F 2.59(,t)-.65 G .09
(he backslash escapes described abo)-2.59 F -.15(ve)-.15 G
(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(2)190.955 E 0 Cg
EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(are e)108 84 Q 2.5
(xpanded. Backslash)-.15 F(will quote an)2.5 E 2.5(yo)-.15 G
(ther character in the macro te)-2.5 E(xt, including " and '.)-.15 E/F1
10/Times-Bold@0 SF(Bash)108 100.8 Q F0(allo)2.93 E .43
(ws the current readline k)-.25 F .73 -.15(ey b)-.1 H .429
(indings to be displayed or modi\214ed with the).15 F F1(bind)2.929 E F0
-.2(bu)2.929 G .429(iltin command.).2 F 1.095
(The editing mode may be switched during interacti)108 112.8 R 1.395
-.15(ve u)-.25 H 1.095(se by using the).15 F F1<ad6f>3.595 E F0 1.095
(option to the)3.595 F F1(set)3.595 E F0 -.2(bu)3.595 G 1.095
(iltin com-).2 F 3.076(mand. Other)108 124.8 R .576
(programs using this library pro)3.076 F .575(vide similar mechanisms.)
-.15 F(The)5.575 E/F2 10/Times-Italic@0 SF(inputr)3.085 E(c)-.37 E F0
.575(\214le may be edited and)3.385 F(re-read if a program does not pro)
108 136.8 Q(vide an)-.15 E 2.5(yo)-.15 G(ther means to incorporate ne)
-2.5 E 2.5(wb)-.25 G(indings.)-2.5 E F1 -.92(Va)87 153.6 S(riables).92 E
F0 .043(Readline has v)108 165.6 R .043
(ariables that can be used to further customize its beha)-.25 F(vior)-.2
E 5.043(.A)-.55 G -.25(va)-2.5 G .043(riable may be set in the).25 F F2
(inpu-)2.554 E(tr)108 177.6 Q(c)-.37 E F0
(\214le with a statement of the form)2.81 E F1(set)144 194.4 Q F2
(variable\255name value)2.5 E F0 .79(Except where noted, readline v)108
211.2 R .79(ariables can tak)-.25 F 3.29(et)-.1 G .79(he v)-3.29 F
(alues)-.25 E F1(On)3.29 E F0(or)3.29 E F1(Off)3.29 E F0 .79
(\(without re)3.29 F -.05(ga)-.15 G .79(rd to case\).).05 F(Unrecog-)
5.79 E .448(nized v)108 223.2 R .448(ariable names are ignored.)-.25 F
.448(When a v)5.448 F .448(ariable v)-.25 F .448
(alue is read, empty or null v)-.25 F .449(alues, "on" \(case-insensi-)
-.25 F(ti)108 235.2 Q -.15(ve)-.25 G .468(\), and "1" are equi).15 F
-.25(va)-.25 G .468(lent to).25 F F1(On)2.968 E F0 5.468(.A)C .468
(ll other v)-5.468 F .468(alues are equi)-.25 F -.25(va)-.25 G .468
(lent to).25 F F1(Off)2.968 E F0 5.468(.T)C .467(he v)-5.468 F .467
(ariables and their def)-.25 F(ault)-.1 E -.25(va)108 247.2 S(lues are:)
.25 E F1(bell\255style \(audible\))108 264 Q F0 .01
(Controls what happens when readline w)144 276 R .011
(ants to ring the terminal bell.)-.1 F .011(If set to)5.011 F F1(none)
2.511 E F0 2.511(,r)C .011(eadline ne)-2.511 F -.15(ve)-.25 G(r).15 E
.94(rings the bell.)144 288 R .94(If set to)5.94 F F1(visible)3.44 E F0
3.44(,r)C .94(eadline uses a visible bell if one is a)-3.44 F -.25(va)
-.2 G 3.44(ilable. If).25 F .94(set to)3.44 F F1(audible)3.44 E F0(,)A
(readline attempts to ring the terminal')144 300 Q 2.5(sb)-.55 G(ell.)
-2.5 E F1(bind\255tty\255special\255chars \(On\))108 312 Q F0 .333
(If set to)144 324 R F1(On)2.833 E F0 .334(\(the def)2.833 F .334
(ault\), readline attempts to bind the control characters)-.1 F .334
(treated specially by the)7.834 F -.1(ke)144 336 S(rnel').1 E 2.5(st)
-.55 G(erminal dri)-2.5 E -.15(ve)-.25 G 2.5(rt).15 G 2.5(ot)-2.5 G
(heir readline equi)-2.5 E -.25(va)-.25 G(lents.).25 E F1
(blink\255matching\255par)108 348 Q(en \(Off\))-.18 E F0 .21(If set to)
144 360 R F1(On)2.71 E F0 2.71(,r)C .21
(eadline attempts to brie\215y mo)-2.71 F .51 -.15(ve t)-.15 H .21
(he cursor to an opening parenthesis when a closing).15 F
(parenthesis is inserted.)144 372 Q F1(color)108 384 Q
(ed\255completion\255pr)-.18 E(e\214x \(Off\))-.18 E F0 .515(If set to)
144 396 R F1(On)3.015 E F0 3.015(,w)C .515(hen listing completions, rea\
dline displays the common pre\214x of the set of possible)-3.015 F 2.936
(completions using a dif)144 408 R 2.936(ferent color)-.25 F 7.936(.T)
-.55 G 2.936(he color de\214nitions are tak)-7.936 F 2.935
(en from the v)-.1 F 2.935(alue of the)-.25 F F1(LS_COLORS)144 420 Q F0
(en)2.5 E(vironment v)-.4 E(ariable.)-.25 E F1(color)108 432 Q
(ed\255stats \(Off\))-.18 E F0 1.579(If set to)144 444 R F1(On)4.079 E
F0 4.079(,r)C 1.579(eadline displays possible completions using dif)
-4.079 F 1.58(ferent colors to indicate their \214le)-.25 F 2.5
(type. The)144 456 R(color de\214nitions are tak)2.5 E(en from the v)-.1
E(alue of the)-.25 E F1(LS_COLORS)2.5 E F0(en)2.5 E(vironment v)-.4 E
(ariable.)-.25 E F1(comment\255begin \(`)108 468 Q(`#')-.63 E('\))-.63 E
F0 .062(The string that is inserted in)144 480 R F1(vi)2.562 E F0 .062
(mode when the)2.562 F F1(insert\255comment)2.562 E F0 .062
(command is e)2.562 F -.15(xe)-.15 G 2.562(cuted. This).15 F(com-)2.562
E(mand is bound to)144 492 Q F1(M\255#)2.5 E F0(in emacs mode and to)2.5
E F1(#)2.5 E F0(in vi command mode.)2.5 E F1
(completion\255display\255width \(\2551\))108 504 Q F0 1.453(The number\
 of screen columns used to display possible matches when performing com\
pletion.)144 516 R .194(The v)144 528 R .193(alue is ignored if it is l\
ess than 0 or greater than the terminal screen width.)-.25 F 2.693(Av)
5.193 G .193(alue of 0 will)-2.943 F
(cause matches to be displayed one per line.)144 540 Q(The def)5 E
(ault v)-.1 E(alue is \2551.)-.25 E F1(completion\255ignor)108 552 Q
(e\255case \(Off\))-.18 E F0(If set to)144 564 Q F1(On)2.5 E F0 2.5(,r)C
(eadline performs \214lename matching and completion in a case\255insen\
siti)-2.5 E .3 -.15(ve f)-.25 H(ashion.).05 E F1
(completion\255map\255case \(Off\))108 576 Q F0 .093(If set to)144 588 R
F1(On)2.593 E F0 2.593(,a)C(nd)-2.593 E F1(completion\255ignor)2.593 E
(e\255case)-.18 E F0 .093(is enabled, readline treats h)2.593 F .093
(yphens \()-.05 F F2<ad>A F0 2.593(\)a)C .094(nd underscores)-2.593 F
(\()144 600 Q F2(_)A F0 2.5(\)a)C 2.5(se)-2.5 G(qui)-2.5 E -.25(va)-.25
G(lent when performing case\255insensiti).25 E .3 -.15(ve \214)-.25 H
(lename matching and completion.).15 E F1(completion\255pr)108 612 Q
(e\214x\255display\255length \(0\))-.18 E F0 .829(The length in charact\
ers of the common pre\214x of a list of possible completions that is di\
splayed)144 624 R 1.274(without modi\214cation.)144 636 R 1.274
(When set to a v)6.274 F 1.274(alue greater than zero, common pre\214x)
-.25 F 1.275(es longer than this)-.15 F -.25(va)144 648 S(lue are repla\
ced with an ellipsis when displaying possible completions.).25 E F1
(completion\255query\255items \(100\))108 660 Q F0 .53
(This determines when the user is queried about vie)144 672 R .529
(wing the number of possible completions gen-)-.25 F .56(erated by the)
144 684 R F1(possible\255completions)3.06 E F0 3.06(command. It)3.06 F
.561(may be set to an)3.061 F 3.061(yi)-.15 G(nte)-3.061 E .561(ger v)
-.15 F .561(alue greater than or)-.25 F .783(equal to zero.)144 696 R
.783(If the number of possible completions is greater than or equal to \
the v)5.783 F .782(alue of this)-.25 F -.25(va)144 708 S .237
(riable, the user is ask).25 F .237(ed whether or not he wishes to vie)
-.1 F 2.737(wt)-.25 G .237(hem; otherwise the)-2.737 F 2.737(ya)-.15 G
.237(re simply listed)-2.737 F(on the terminal.)144 720 Q 2.5(An)5 G
-2.25 -.15(eg a)-2.5 H(ti).15 E .3 -.15(ve v)-.25 H
(alue causes readline to ne)-.1 E -.15(ve)-.25 G 2.5(ra).15 G(sk.)-2.5 E
(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(3)190.955 E 0 Cg
EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(con)108 84 Q -.1(ve)-.4 G(rt\255meta \(On\)).1 E F0 .613(If set to)144
96 R F1(On)3.113 E F0 3.113(,r)C .613(eadline will con)-3.113 F -.15(ve)
-.4 G .613(rt characters with the eighth bit set to an ASCII k).15 F
.912 -.15(ey s)-.1 H .612(equence by).15 F 1.315(stripping the eighth b\
it and pre\214xing it with an escape character \(in ef)144 108 R 1.316
(fect, using escape as the)-.25 F/F2 10/Times-Italic@0 SF .503(meta pr)
144 120 R(e\214x)-.37 E F0 3.003(\). The)B(def)3.003 E .503(ault is)-.1
F F2(On)3.003 E F0 3.003(,b)C .503(ut readline will set it to)-3.203 F
F2(Of)3.003 E(f)-.18 E F0 .502(if the locale contains eight-bit char)
3.003 F(-)-.2 E(acters.)144 132 Q F1(disable\255completion \(Off\))108
144 Q F0 .038(If set to)144 156 R F1(On)2.538 E F0 2.538(,r)C .038
(eadline will inhibit w)-2.538 F .038(ord completion.)-.1 F .038
(Completion characters will be inserted into the)5.038 F(line as if the)
144 168 Q 2.5(yh)-.15 G(ad been mapped to)-2.5 E F1(self-insert)2.5 E F0
(.)A F1(echo\255contr)108 180 Q(ol\255characters \(On\))-.18 E F0 1.211
(When set to)144 192 R F1(On)3.711 E F0 3.711(,o)C 3.711(no)-3.711 G
1.211(perating systems that indicate the)-3.711 F 3.711(ys)-.15 G 1.21
(upport it, readline echoes a character)-3.711 F
(corresponding to a signal generated from the k)144 204 Q -.15(ey)-.1 G
(board.).15 E F1(editing\255mode \(emacs\))108 216 Q F0 .141
(Controls whether readline be)144 228 R .141(gins with a set of k)-.15 F
.441 -.15(ey b)-.1 H .141(indings similar to).15 F F2(Emacs)2.642 E F0
(or)2.642 E F2(vi)2.642 E F0(.)A F1(editing\255mode)5.142 E F0
(can be set to either)144 240 Q F1(emacs)2.5 E F0(or)2.5 E F1(vi)2.5 E
F0(.)A F1(emacs\255mode\255string \(@\))108 252 Q F0 .518(If the)144 264
R F2(show\255mode\255in\255pr)3.018 E(ompt)-.45 E F0 -.25(va)3.018 G
.517(riable is enabled, this string is displayed immediately before the)
.25 F .622
(last line of the primary prompt when emacs editing mode is acti)144 276
R -.15(ve)-.25 G 5.622(.T).15 G .622(he v)-5.622 F .622(alue is e)-.25 F
.622(xpanded lik)-.15 F 3.122(ea)-.1 G -.1(ke)144 288 S 3.34(yb)-.05 G
.839(inding, so the standard set of meta- and control pre\214x)-3.34 F
.839(es and backslash escape sequences is)-.15 F -.2(av)144 300 S 2.798
(ailable. Use)-.05 F .298(the \\1 and \\2 escapes to be)2.798 F .298
(gin and end sequences of non-printing characters, which)-.15 F
(can be used to embed a terminal control sequence into the mode string.)
144 312 Q F1(enable\255brack)108 324 Q(eted\255paste \(Off\))-.1 E F0
1.222(When set to)144 336 R F1(On)3.721 E F0 3.721(,r)C 1.221
(eadline will con\214gure the terminal in a w)-3.721 F 1.221
(ay that will enable it to insert each)-.1 F .353
(paste into the editing b)144 348 R(uf)-.2 E .353(fer as a single strin\
g of characters, instead of treating each character as if)-.25 F .544
(it had been read from the k)144 360 R -.15(ey)-.1 G 3.043(board. This)
.15 F .543(can pre)3.043 F -.15(ve)-.25 G .543
(nt pasted characters from being interpreted as).15 F(editing commands.)
144 372 Q F1(enable\255k)108 384 Q(eypad \(Off\))-.1 E F0 .892
(When set to)144 396 R F1(On)3.393 E F0 3.393(,r)C .893
(eadline will try to enable the application k)-3.393 F -.15(ey)-.1 G
.893(pad when it is called.).15 F .893(Some sys-)5.893 F
(tems need this to enable the arro)144 408 Q 2.5(wk)-.25 G -.15(ey)-2.6
G(s.).15 E F1(enable\255meta\255k)108 420 Q(ey \(On\))-.1 E F0 .64
(When set to)144 432 R F1(On)3.14 E F0 3.14(,r)C .64
(eadline will try to enable an)-3.14 F 3.14(ym)-.15 G .64
(eta modi\214er k)-3.14 F .94 -.15(ey t)-.1 H .64
(he terminal claims to support).15 F(when it is called.)144 444 Q
(On man)5 E 2.5(yt)-.15 G(erminals, the meta k)-2.5 E .3 -.15(ey i)-.1 H
2.5(su).15 G(sed to send eight-bit characters.)-2.5 E F1
(expand\255tilde \(Off\))108 456 Q F0(If set to)144 468 Q F1(On)2.5 E F0
2.5(,t)C(ilde e)-2.5 E(xpansion is performed when readline attempts w)
-.15 E(ord completion.)-.1 E F1(history\255pr)108 480 Q(eser)-.18 E -.1
(ve)-.1 G(\255point \(Off\)).1 E F0 1.338(If set to)144 492 R F1(On)
3.838 E F0 3.838(,t)C 1.338(he history code attempts to place point at \
the same location on each history line)-3.838 F(retrie)144 504 Q -.15
(ve)-.25 G 2.5(dw).15 G(ith)-2.5 E F1(pr)2.5 E -.15(ev)-.18 G
(ious-history).15 E F0(or)2.5 E F1(next-history)2.5 E F0(.)A F1
(history\255size \(unset\))108 516 Q F0 .949
(Set the maximum number of history entries sa)144 528 R -.15(ve)-.2 G
3.448(di).15 G 3.448(nt)-3.448 G .948(he history list.)-3.448 F .948
(If set to zero, an)5.948 F 3.448(ye)-.15 G(xisting)-3.598 E .482
(history entries are deleted and no ne)144 540 R 2.982(we)-.25 G .483
(ntries are sa)-2.982 F -.15(ve)-.2 G 2.983(d. If).15 F .483(set to a v)
2.983 F .483(alue less than zero, the num-)-.25 F .356
(ber of history entries is not limited.)144 552 R .356(By def)5.356 F
.355(ault, the number of history entries is not limited.)-.1 F .355
(If an)5.355 F 1.97(attempt is made to set)144 564 R F2(history\255size)
4.47 E F0 1.97(to a non-numeric v)4.47 F 1.97
(alue, the maximum number of history)-.25 F(entries will be set to 500.)
144 576 Q F1(horizontal\255scr)108 588 Q(oll\255mode \(Off\))-.18 E F0
.449(When set to)144 600 R F1(On)2.949 E F0 2.949(,m)C(ak)-2.949 E .448
(es readline use a single line for display)-.1 F 2.948(,s)-.65 G .448
(crolling the input horizontally on a)-2.948 F 1.194(single screen line\
 when it becomes longer than the screen width rather than wrapping to a\
 ne)144 612 R(w)-.25 E(line.)144 624 Q F1(input\255meta \(Off\))108 636
Q F0 .367(If set to)144 648 R F1(On)2.867 E F0 2.867(,r)C .367(eadline \
will enable eight-bit input \(that is, it will not clear the eighth bit\
 in the char)-2.867 F(-)-.2 E .956(acters it reads\), re)144 660 R -.05
(ga)-.15 G .956(rdless of what the terminal claims it can support.).05 F
.957(The name)5.956 F F1(meta\255\215ag)3.457 E F0 .957(is a)3.457 F
(synon)144 672 Q .77(ym for this v)-.15 F 3.27(ariable. The)-.25 F(def)
3.27 E .77(ault is)-.1 F F2(Of)3.27 E(f)-.18 E F0 3.27(,b)C .77
(ut readline will set it to)-3.47 F F2(On)3.27 E F0 .77
(if the locale contains)3.27 F(eight-bit characters.)144 684 Q F1(isear)
108 696 Q(ch\255terminators \(`)-.18 E(`C\255[ C\255J')-.63 E('\))-.63 E
F0 .439(The string of characters that should terminate an incremental s\
earch without subsequently e)144 708 R -.15(xe)-.15 G(cut-).15 E .935
(ing the character as a command.)144 720 R .935(If this v)5.935 F .935
(ariable has not been gi)-.25 F -.15(ve)-.25 G 3.434(nav).15 G .934
(alue, the characters)-3.684 F F2(ESC)3.434 E F0(GNU Readline 7.0)72 768
Q(2017 December 28)121.245 E(4)190.955 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(and)144 84 Q/F1 10
/Times-Italic@0 SF(C\255J)2.5 E F0
(will terminate an incremental search.)2.5 E/F2 10/Times-Bold@0 SF -.1
(ke)108 96 S(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144
108 R -.15(ey)-.1 G 4.823(map. The).15 F 2.323(set of le)4.823 F -.05
(ga)-.15 G 4.823(lk).05 G -.15(ey)-4.923 G 2.323(map names is).15 F F1
2.324(emacs, emacs-standar)4.823 F(d,)-.37 E .809
(emacs-meta, emacs-ctlx, vi, vi-mo)144 120 R(ve)-.1 E 3.308(,v)-.1 G
(i-command)-3.308 E F0 3.308(,a)C(nd)-3.308 E F1(vi-insert)3.308 E F0(.)
.68 E F1(vi)5.808 E F0 .808(is equi)3.308 F -.25(va)-.25 G .808(lent to)
.25 F F1(vi-command)3.308 E F0(;)A F1(emacs)144 132 Q F0 .697(is equi)
3.196 F -.25(va)-.25 G .697(lent to).25 F F1(emacs-standar)3.197 E(d)
-.37 E F0 5.697(.T)C .697(he def)-5.697 F .697(ault v)-.1 F .697
(alue is)-.25 F F1(emacs)3.197 E F0 5.697(.T).27 G .697(he v)-5.697 F
.697(alue of)-.25 F F2(editing\255mode)3.197 E F0(also af)144 144 Q
(fects the def)-.25 E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F2 -.1(ke)
108 156 S(yseq\255timeout \(500\)).1 E F0 .368(Speci\214es the duration)
144 168 R F1 -.37(re)2.867 G(adline).37 E F0 .367(will w)2.867 F .367
(ait for a character when reading an ambiguous k)-.1 F .667 -.15(ey s)
-.1 H(equence).15 E 1.356(\(one that can form a complete k)144 180 R
1.656 -.15(ey s)-.1 H 1.356(equence using the input read so f).15 F(ar)
-.1 E 3.856(,o)-.4 G 3.856(rc)-3.856 G 1.356(an tak)-3.856 F 3.856(ea)
-.1 G(dditional)-3.856 E .32(input to complete a longer k)144 192 R .62
-.15(ey s)-.1 H 2.82(equence\). If).15 F .32(no input is recei)2.82 F
-.15(ve)-.25 G 2.82(dw).15 G .32(ithin the timeout,)-2.82 F F1 -.37(re)
2.82 G(adline).37 E F0(will)2.82 E .906(use the shorter b)144 204 R .907
(ut complete k)-.2 F 1.207 -.15(ey s)-.1 H 3.407(equence. The).15 F -.25
(va)3.407 G .907(lue is speci\214ed in milliseconds, so a v).25 F .907
(alue of)-.25 F .05(1000 means that)144 216 R F1 -.37(re)2.55 G(adline)
.37 E F0 .05(will w)2.55 F .05(ait one second for additional input.)-.1
F .05(If this v)5.05 F .05(ariable is set to a v)-.25 F(alue)-.25 E .051
(less than or equal to zero, or to a non-numeric v)144 228 R(alue,)-.25
E F1 -.37(re)2.551 G(adline).37 E F0 .051(will w)2.551 F .051
(ait until another k)-.1 F .352 -.15(ey i)-.1 H 2.552(sp).15 G(ressed)
-2.552 E(to decide which k)144 240 Q .3 -.15(ey s)-.1 H
(equence to complete.).15 E F2(mark\255dir)108 252 Q(ectories \(On\))
-.18 E F0(If set to)144 264 Q F2(On)2.5 E F0 2.5(,c)C
(ompleted directory names ha)-2.5 E .3 -.15(ve a s)-.2 H(lash appended.)
.15 E F2(mark\255modi\214ed\255lines \(Off\))108 276 Q F0(If set to)144
288 Q F2(On)2.5 E F0 2.5(,h)C(istory lines that ha)-2.5 E .3 -.15(ve b)
-.2 H(een modi\214ed are displayed with a preceding asterisk \().15 E F2
(*)A F0(\).)A F2(mark\255symlink)108 300 Q(ed\255dir)-.1 E
(ectories \(Off\))-.18 E F0 .175(If set to)144 312 R F2(On)2.675 E F0
2.675(,c)C .175
(ompleted names which are symbolic links to directories ha)-2.675 F .475
-.15(ve a s)-.2 H .175(lash appended \(sub-).15 F(ject to the v)144 324
Q(alue of)-.25 E F2(mark\255dir)2.5 E(ectories)-.18 E F0(\).)A F2
(match\255hidden\255\214les \(On\))108 336 Q F0 .192(This v)144 348 R
.192(ariable, when set to)-.25 F F2(On)2.692 E F0 2.692(,c)C .192
(auses readline to match \214les whose names be)-2.692 F .193
(gin with a `.)-.15 F 2.693('\()-.7 G(hidden)-2.693 E .457
(\214les\) when performing \214lename completion.)144 360 R .456
(If set to)5.456 F F2(Off)2.956 E F0 2.956(,t)C .456(he leading `.)
-2.956 F 2.956('m)-.7 G .456(ust be supplied by the)-2.956 F
(user in the \214lename to be completed.)144 372 Q F2
(menu\255complete\255display\255pr)108 384 Q(e\214x \(Off\))-.18 E F0
1.585(If set to)144 396 R F2(On)4.085 E F0 4.085(,m)C 1.585(enu complet\
ion displays the common pre\214x of the list of possible completions)
-4.085 F(\(which may be empty\) before c)144 408 Q
(ycling through the list.)-.15 E F2(output\255meta \(Off\))108 420 Q F0
.507(If set to)144 432 R F2(On)3.007 E F0 3.007(,r)C .507(eadline will \
display characters with the eighth bit set directly rather than as a me\
ta-)-3.007 F(pre\214x)144 444 Q .884(ed escape sequence.)-.15 F .884
(The def)5.884 F .884(ault is)-.1 F F1(Of)3.384 E(f)-.18 E F0 3.384(,b)C
.884(ut readline will set it to)-3.584 F F1(On)3.384 E F0 .885
(if the locale contains)3.384 F(eight-bit characters.)144 456 Q F2
(page\255completions \(On\))108 468 Q F0 .809(If set to)144 480 R F2(On)
3.308 E F0 3.308(,r)C .808(eadline uses an internal)-3.308 F F1(mor)
3.308 E(e)-.37 E F0(-lik)A 3.308(ep)-.1 G .808
(ager to display a screenful of possible comple-)-3.308 F
(tions at a time.)144 492 Q F2
(print\255completions\255horizontally \(Off\))108 504 Q F0 1.318
(If set to)144 516 R F2(On)3.818 E F0 3.818(,r)C 1.319(eadline will dis\
play completions with matches sorted horizontally in alphabetical)-3.818
F(order)144 528 Q 2.5(,r)-.4 G(ather than do)-2.5 E(wn the screen.)-.25
E F2 -2.29 -.18(re v)108 540 T(ert\255all\255at\255newline \(Off\)).08 E
F0 .699(If set to)144 552 R F2(On)3.199 E F0 3.199(,r)C .699
(eadline will undo all changes to history lines before returning when)
-3.199 F F2(accept\255line)3.198 E F0(is)3.198 E -.15(exe)144 564 S
2.686(cuted. By).15 F(def)2.686 E .186
(ault, history lines may be modi\214ed and retain indi)-.1 F .186
(vidual undo lists across calls to)-.25 F F2 -.18(re)144 576 S(adline)
.18 E F0(.)A F2(sho)108 588 Q(w\255all\255if\255ambiguous \(Off\))-.1 E
F0 .304(This alters the def)144 600 R .304(ault beha)-.1 F .304
(vior of the completion functions.)-.2 F .304(If set to)5.304 F F2(On)
2.804 E F0 2.803(,w)C .303(ords which ha)-2.903 F .603 -.15(ve m)-.2 H
(ore).15 E 1.264(than one possible completion cause the matches to be l\
isted immediately instead of ringing the)144 612 R(bell.)144 624 Q F2
(sho)108 636 Q(w\255all\255if\255unmodi\214ed \(Off\))-.1 E F0 5.346
(This alters the def)144 648 R 5.346(ault beha)-.1 F 5.345
(vior of the completion functions in a f)-.2 F 5.345(ashion similar to)
-.1 F F2(sho)144 660 Q(w\255all\255if\255ambiguous)-.1 E F0 6.69(.I)C
4.19(fs)-6.69 G 1.691(et to)-4.19 F F2(On)4.191 E F0 4.191(,w)C 1.691
(ords which ha)-4.291 F 1.991 -.15(ve m)-.2 H 1.691
(ore than one possible completion).15 F 1.04(without an)144 672 R 3.54
(yp)-.15 G 1.039
(ossible partial completion \(the possible completions don')-3.54 F
3.539(ts)-.18 G 1.039(hare a common pre\214x\))-3.539 F(cause the match\
es to be listed immediately instead of ringing the bell.)144 684 Q F2
(sho)108 696 Q(w\255mode\255in\255pr)-.1 E(ompt \(Off\))-.18 E F0 1.021
(If set to)144 708 R F2(On)3.521 E F0 3.521(,a)C 1.022
(dd a string to the be)-3.521 F 1.022
(ginning of the prompt indicating the editing mode: emacs, vi)-.15 F
(command, or vi insertion.)144 720 Q(The mode strings are user)5 E
(-settable \(e.g.,)-.2 E F1(emacs\255mode\255string)2.5 E F0(\).)A
(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(5)190.955 E 0 Cg
EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(skip\255completed\255text \(Off\))108 84 Q F0 .095(If set to)144 96 R
F1(On)2.595 E F0 2.595(,t)C .095(his alters the def)-2.595 F .095
(ault completion beha)-.1 F .094
(vior when inserting a single match into the line.)-.2 F(It')144 108 Q
2.545(so)-.55 G .045(nly acti)-2.545 F .345 -.15(ve w)-.25 H .046
(hen performing completion in the middle of a w).15 F 2.546(ord. If)-.1
F .046(enabled, readline does not)2.546 F 1.394(insert characters from \
the completion that match characters after point in the w)144 120 R
1.394(ord being com-)-.1 F(pleted, so portions of the w)144 132 Q
(ord follo)-.1 E(wing the cursor are not duplicated.)-.25 E F1
(vi\255cmd\255mode\255string \(\(cmd\)\))108 144 Q F0 .517(If the)144
156 R/F2 10/Times-Italic@0 SF(show\255mode\255in\255pr)3.017 E(ompt)-.45
E F0 -.25(va)3.017 G .518
(riable is enabled, this string is displayed immediately before the).25
F .475(last line of the primary prompt when vi editing mode is acti)144
168 R .775 -.15(ve a)-.25 H .475(nd in command mode.).15 F .475(The v)
5.475 F(alue)-.25 E 1.235(is e)144 180 R 1.235(xpanded lik)-.15 F 3.735
(eak)-.1 G 1.535 -.15(ey b)-3.835 H 1.236
(inding, so the standard set of meta- and control pre\214x).15 F 1.236
(es and backslash)-.15 F .315(escape sequences is a)144 192 R -.25(va)
-.2 G 2.815(ilable. Use).25 F .314(the \\1 and \\2 escapes to be)2.815 F
.314(gin and end sequences of non-print-)-.15 F(ing characters, which c\
an be used to embed a terminal control sequence into the mode string.)
144 204 Q F1(vi\255ins\255mode\255string \(\(ins\)\))108 216 Q F0 .517
(If the)144 228 R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0
-.25(va)3.017 G .518
(riable is enabled, this string is displayed immediately before the).25
F .186(last line of the primary prompt when vi editing mode is acti)144
240 R .486 -.15(ve a)-.25 H .186(nd in insertion mode.).15 F .186(The v)
5.186 F .186(alue is)-.25 F -.15(ex)144 252 S 1.929(panded lik).15 F
4.429(eak)-.1 G 2.229 -.15(ey b)-4.529 H 1.929
(inding, so the standard set of meta- and control pre\214x).15 F 1.93
(es and backslash)-.15 F .315(escape sequences is a)144 264 R -.25(va)
-.2 G 2.815(ilable. Use).25 F .314(the \\1 and \\2 escapes to be)2.815 F
.314(gin and end sequences of non-print-)-.15 F(ing characters, which c\
an be used to embed a terminal control sequence into the mode string.)
144 276 Q F1(visible\255stats \(Off\))108 288 Q F0 .846(If set to)144
300 R F1(On)3.346 E F0 3.346(,ac)C .846(haracter denoting a \214le')
-3.346 F 3.346(st)-.55 G .846(ype as reported by)-3.346 F F2(stat)3.346
E F0 .846(\(2\) is appended to the \214lename)B
(when listing possible completions.)144 312 Q F1(Conditional Constructs)
87 328.8 Q F0 .05(Readline implements a f)108 340.8 R .05(acility simil\
ar in spirit to the conditional compilation features of the C preproces\
sor)-.1 F .096(which allo)108 352.8 R .096(ws k)-.25 F .396 -.15(ey b)
-.1 H .096(indings and v).15 F .096
(ariable settings to be performed as the result of tests.)-.25 F .097
(There are four parser)5.096 F(directi)108 364.8 Q -.15(ve)-.25 G 2.5
(su).15 G(sed.)-2.5 E F1($if)108 381.6 Q F0(The)144 381.6 Q F1($if)2.963
E F0 .463(construct allo)2.963 F .462(ws bindings to be made based on t\
he editing mode, the terminal being used,)-.25 F .961
(or the application using readline.)144 393.6 R .961(The te)5.961 F .961
(xt of the test, after an)-.15 F 3.462(yc)-.15 G .962
(omparison operator)-3.462 F 3.462(,e)-.4 G .962(xtends to)-3.612 F(the\
 end of the line; unless otherwise noted, no characters are required to\
 isolate it.)144 405.6 Q F1(mode)144 422.4 Q F0(The)180 422.4 Q F1
(mode=)3.712 E F0 1.212(form of the)3.712 F F1($if)3.711 E F0(directi)
3.711 E 1.511 -.15(ve i)-.25 H 3.711(su).15 G 1.211
(sed to test whether readline is in emacs or vi)-3.711 F 3.065
(mode. This)180 434.4 R .565(may be used in conjunction with the)3.065 F
F1 .565(set k)3.065 F(eymap)-.1 E F0 .565(command, for instance, to)
3.065 F .03(set bindings in the)180 446.4 R F2(emacs-standar)2.529 E(d)
-.37 E F0(and)2.529 E F2(emacs-ctlx)2.529 E F0 -.1(ke)2.529 G .029
(ymaps only if readline is starting out)-.05 F(in emacs mode.)180 458.4
Q F1(term)144 475.2 Q F0(The)180 475.2 Q F1(term=)3.196 E F0 .696
(form may be used to include terminal-speci\214c k)3.196 F .996 -.15
(ey b)-.1 H .697(indings, perhaps to bind).15 F .654(the k)180 487.2 R
.954 -.15(ey s)-.1 H .654(equences output by the terminal').15 F 3.154
(sf)-.55 G .654(unction k)-3.154 F -.15(ey)-.1 G 3.154(s. The).15 F -.1
(wo)3.154 G .654(rd on the right side of).1 F(the)180 499.2 Q F1(=)3.003
E F0 .503(is tested ag)3.003 F .504(ainst the full name of the terminal\
 and the portion of the terminal name)-.05 F(before the \214rst)180
511.2 Q F1<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E F2(sun)2.84 E F0
(to match both)2.74 E F2(sun)2.84 E F0(and)2.74 E F2(sun\255cmd)2.5 E F0
2.5(,f).77 G(or instance.)-2.5 E F1 -.1(ve)144 528 S(rsion).1 E F0(The)
180 540 Q F1 -.1(ve)3.109 G(rsion).1 E F0 .608
(test may be used to perform comparisons ag)3.109 F .608
(ainst speci\214c readline v)-.05 F(ersions.)-.15 E(The)180 552 Q F1 -.1
(ve)3.928 G(rsion).1 E F0 -.15(ex)3.928 G 1.428
(pands to the current readline v).15 F 3.928(ersion. The)-.15 F 1.429
(set of comparison operators)3.929 F(includes)180 564 Q F1(=)2.606 E F0
2.606(,\()C(and)-2.606 E F1(==)2.606 E F0(\),)A F1(!=)2.606 E F0(,)A F1
(<=)2.606 E F0(,)A F1(>=)2.606 E F0(,)A F1(<)2.606 E F0 2.606(,a)C(nd)
-2.606 E F1(>)2.606 E F0 5.106(.T)C .106(he v)-5.106 F .106
(ersion number supplied on the right side)-.15 F 1.471
(of the operator consists of a major v)180 576 R 1.471(ersion number)
-.15 F 3.972(,a)-.4 G 3.972(no)-3.972 G 1.472
(ptional decimal point, and an)-3.972 F .767(optional minor v)180 588 R
.767(ersion \(e.g.,)-.15 F F1(7.1)3.267 E F0 .766(\). If the minor v)B
.766(ersion is omitted, it is assumed to be)-.15 F F1(0)3.266 E F0(.)A
1.755(The operator may be separated from the string)180 600 R F1 -.1(ve)
4.255 G(rsion).1 E F0 1.756(and from the v)4.256 F 1.756(ersion number)
-.15 F(ar)180 612 Q(gument by whitespace.)-.18 E F1(application)144
628.8 Q F0(The)180 640.8 Q F1(application)3.003 E F0 .503
(construct is used to include application-speci\214c settings.)3.003 F
.503(Each program)5.503 F .114(using the readline library sets the)180
652.8 R F2 .114(application name)2.614 F F0 2.614(,a)C .114
(nd an initialization \214le can test for a)-2.614 F .501(particular v)
180 664.8 R 3.001(alue. This)-.25 F .501(could be used to bind k)3.001 F
.801 -.15(ey s)-.1 H .5(equences to functions useful for a spe-).15 F
.396(ci\214c program.)180 676.8 R -.15(Fo)5.396 G 2.896(ri).15 G .396
(nstance, the follo)-2.896 F .396(wing command adds a k)-.25 F .696 -.15
(ey s)-.1 H .397(equence that quotes the).15 F(current or pre)180 688.8
Q(vious w)-.25 E(ord in)-.1 E F1(bash)2.5 E F0(:)A F1($if)180 712.8 Q F0
(Bash)2.5 E 2.5(#Q)180 724.8 S(uote the current or pre)-2.5 E(vious w)
-.25 E(ord)-.1 E(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(6)
190.955 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E
("\\C-xq": "\\eb\\"\\ef\\"")180 84 Q/F1 10/Times-Bold@0 SF($endif)180 96
Q/F2 10/Times-Italic@0 SF(variable)144 112.8 Q F0(The)180 124.8 Q F2
(variable)3.777 E F0 1.277(construct pro)3.777 F 1.276
(vides simple equality tests for readline v)-.15 F 1.276(ariables and v)
-.25 F(alues.)-.25 E .079(The permitted comparison operators are)180
136.8 R F2(=)2.579 E F0(,)A F2(==)2.579 E F0 2.579(,a)C(nd)-2.579 E F2
(!=)2.579 E F0 5.079(.T)C .079(he v)-5.079 F .08
(ariable name must be sepa-)-.25 F .98(rated from the comparison operat\
or by whitespace; the operator may be separated from)180 148.8 R .129
(the v)180 160.8 R .129(alue on the right hand side by whitespace.)-.25
F .13(Both string and boolean v)5.129 F .13(ariables may be)-.25 F
(tested. Boolean v)180 172.8 Q(ariables must be tested ag)-.25 E
(ainst the v)-.05 E(alues)-.25 E F2(on)2.5 E F0(and)2.5 E F2(of)2.5 E(f)
-.18 E F0(.)A F1($endif)108 189.6 Q F0(This command, as seen in the pre)
144 189.6 Q(vious e)-.25 E(xample, terminates an)-.15 E F1($if)2.5 E F0
(command.)2.5 E F1($else)108 206.4 Q F0(Commands in this branch of the)
144 206.4 Q F1($if)2.5 E F0(directi)2.5 E .3 -.15(ve a)-.25 H(re e).15 E
-.15(xe)-.15 G(cuted if the test f).15 E(ails.)-.1 E F1($include)108
223.2 Q F0 .357(This directi)144 235.2 R .657 -.15(ve t)-.25 H(ak).15 E
.357(es a single \214lename as an ar)-.1 F .356
(gument and reads commands and bindings from that)-.18 F 2.5(\214le. F)
144 247.2 R(or e)-.15 E(xample, the follo)-.15 E(wing directi)-.25 E .3
-.15(ve w)-.25 H(ould read).05 E F2(/etc/inputr)2.5 E(c)-.37 E F0(:)A F1
($include)144 271.2 Q F2(/etc/inputr)5.833 E(c)-.37 E/F3 10.95
/Times-Bold@0 SF(SEARCHING)72 288 Q F0 1.003(Readline pro)108 300 R
1.003(vides commands for searching through the command history for line\
s containing a speci\214ed)-.15 F 2.5(string. There)108 312 R(are tw)2.5
E 2.5(os)-.1 G(earch modes:)-2.5 E F2(incr)2.51 E(emental)-.37 E F0(and)
3.01 E F2(non-incr)2.5 E(emental)-.37 E F0(.).51 E .698
(Incremental searches be)108 328.8 R .698
(gin before the user has \214nished typing the search string.)-.15 F
.697(As each character of the)5.697 F .112
(search string is typed, readline displays the ne)108 340.8 R .112
(xt entry from the history matching the string typed so f)-.15 F(ar)-.1
E 5.113(.A)-.55 G(n)-5.113 E .545
(incremental search requires only as man)108 352.8 R 3.045(yc)-.15 G
.544(haracters as needed to \214nd the desired history entry)-3.045 F
5.544(.T)-.65 G 3.044(os)-6.344 G(earch)-3.044 E(backw)108 364.8 Q .18
(ard in the history for a particular string, type)-.1 F F1(C\255r)2.681
E F0 5.181(.T)C(yping)-5.981 E F1(C\255s)2.681 E F0 .181(searches forw)
2.681 F .181(ard through the history)-.1 F(.)-.65 E .354
(The characters present in the v)108 376.8 R .354(alue of the)-.25 F F1
(isear)2.854 E(ch-terminators)-.18 E F0 -.25(va)2.854 G .354
(riable are used to terminate an incremen-).25 F .6(tal search.)108
388.8 R .6(If that v)5.6 F .6(ariable has not been assigned a v)-.25 F
.6(alue the)-.25 F F2(Escape)3.1 E F0(and)3.1 E F1(C\255J)3.1 E F0 .6
(characters will terminate an)3.1 F .123(incremental search.)108 400.8 R
F1(C\255G)5.123 E F0 .123
(will abort an incremental search and restore the original line.)2.623 F
.122(When the search is)5.122 F(terminated, the history entry containin\
g the search string becomes the current line.)108 412.8 Q 2.406 -.8
(To \214)108 429.6 T .806
(nd other matching entries in the history list, type).8 F F1(C\255s)
3.306 E F0(or)3.306 E F1(C\255r)3.306 E F0 .806(as appropriate.)3.306 F
.807(This will search back-)5.806 F -.1(wa)108 441.6 S 1.309(rd or forw)
.1 F 1.309(ard in the history for the ne)-.1 F 1.309
(xt line matching the search string typed so f)-.15 F(ar)-.1 E 6.309(.A)
-.55 G 1.609 -.15(ny o)-6.309 H 1.308(ther k).15 F -.15(ey)-.1 G .317
(sequence bound to a readline command will terminate the search and e)
108 453.6 R -.15(xe)-.15 G .318(cute that command.).15 F -.15(Fo)5.318 G
2.818(ri).15 G(nstance,)-2.818 E 3.481(an)108 465.6 S -.25(ew)-3.481 G
.981(line will terminate the search and accept the line, thereby e).25 F
-.15(xe)-.15 G .98(cuting the command from the history).15 F 3.061
(list. A)108 477.6 R(mo)3.061 E -.15(ve)-.15 G .562
(ment command will terminate the search, mak).15 F 3.062(et)-.1 G .562
(he last line found the current line, and be)-3.062 F(gin)-.15 E
(editing.)108 489.6 Q .567(Non-incremental searches read the entire sea\
rch string before starting to search for matching history lines.)108
506.4 R(The search string may be typed by the user or be part of the co\
ntents of the current line.)108 518.4 Q F3(EDITING COMMANDS)72 535.2 Q
F0 1.391(The follo)108 547.2 R 1.391
(wing is a list of the names of the commands and the def)-.25 F 1.391
(ault k)-.1 F 1.691 -.15(ey s)-.1 H 1.391(equences to which the).15 F
3.892(ya)-.15 G(re)-3.892 E 2.5(bound. Command)108 559.2 R
(names without an accompan)2.5 E(ying k)-.15 E .3 -.15(ey s)-.1 H
(equence are unbound by def).15 E(ault.)-.1 E .055(In the follo)108 576
R .055(wing descriptions,)-.25 F F2(point)2.555 E F0 .055
(refers to the current cursor position, and)2.555 F F2(mark)2.555 E F0
.054(refers to a cursor position)2.554 F(sa)108 588 Q -.15(ve)-.2 G 2.5
(db).15 G 2.5(yt)-2.5 G(he)-2.5 E F1(set\255mark)2.5 E F0 2.5
(command. The)2.5 F(te)2.5 E
(xt between the point and mark is referred to as the)-.15 E F2 -.37(re)
2.5 G(gion)-.03 E F0(.)A F1(Commands f)87 604.8 Q(or Mo)-.25 E(ving)-.1
E(beginning\255of\255line \(C\255a\))108 616.8 Q F0(Mo)144 628.8 Q .3
-.15(ve t)-.15 H 2.5(ot).15 G(he start of the current line.)-2.5 E F1
(end\255of\255line \(C\255e\))108 640.8 Q F0(Mo)144 652.8 Q .3 -.15
(ve t)-.15 H 2.5(ot).15 G(he end of the line.)-2.5 E F1 -.25(fo)108
664.8 S(rward\255char \(C\255f\)).25 E F0(Mo)144 676.8 Q .3 -.15(ve f)
-.15 H(orw).15 E(ard a character)-.1 E(.)-.55 E F1
(backward\255char \(C\255b\))108 688.8 Q F0(Mo)144 700.8 Q .3 -.15(ve b)
-.15 H(ack a character).15 E(.)-.55 E(GNU Readline 7.0)72 768 Q
(2017 December 28)121.245 E(7)190.955 E 0 Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
-.25(fo)108 84 S(rward\255w).25 E(ord \(M\255f\))-.1 E F0(Mo)144 96 Q
.822 -.15(ve f)-.15 H(orw).15 E .522(ard to the end of the ne)-.1 F .523
(xt w)-.15 F 3.023(ord. W)-.1 F .523
(ords are composed of alphanumeric characters \(let-)-.8 F
(ters and digits\).)144 108 Q F1(backward\255w)108 120 Q(ord \(M\255b\))
-.1 E F0(Mo)144 132 Q 1.71 -.15(ve b)-.15 H 1.41
(ack to the start of the current or pre).15 F 1.41(vious w)-.25 F 3.91
(ord. W)-.1 F 1.41(ords are composed of alphanumeric)-.8 F
(characters \(letters and digits\).)144 144 Q F1(pr)108 156 Q -.15(ev)
-.18 G(ious\255scr).15 E(een\255line)-.18 E F0 .89(Attempt to mo)144 168
R 1.19 -.15(ve p)-.15 H .89(oint to the same ph).15 F .891
(ysical screen column on the pre)-.05 F .891(vious ph)-.25 F .891
(ysical screen line.)-.05 F .87(This will not ha)144 180 R 1.17 -.15
(ve t)-.2 H .87(he desired ef).15 F .87
(fect if the current Readline line does not tak)-.25 F 3.37(eu)-.1 G
3.37(pm)-3.37 G .87(ore than one)-3.37 F(ph)144 192 Q(ysical line or if\
 point is not greater than the length of the prompt plus the screen wid\
th.)-.05 E F1(next\255scr)108 204 Q(een\255line)-.18 E F0 .637
(Attempt to mo)144 216 R .937 -.15(ve p)-.15 H .637(oint to the same ph)
.15 F .638(ysical screen column on the ne)-.05 F .638(xt ph)-.15 F .638
(ysical screen line. This)-.05 F .009(will not ha)144 228 R .309 -.15
(ve t)-.2 H .009(he desired ef).15 F .009
(fect if the current Readline line does not tak)-.25 F 2.509(eu)-.1 G
2.509(pm)-2.509 G .008(ore than one ph)-2.509 F(ysical)-.05 E .772(line\
 or if the length of the current Readline line is not greater than the \
length of the prompt plus)144 240 R(the screen width.)144 252 Q F1
(clear\255scr)108 264 Q(een \(C\255l\))-.18 E F0 .993
(Clear the screen lea)144 276 R .993
(ving the current line at the top of the screen.)-.2 F -.4(Wi)5.993 G
.993(th an ar).4 F .993(gument, refresh the)-.18 F
(current line without clearing the screen.)144 288 Q F1 -.18(re)108 300
S(draw\255curr).18 E(ent\255line)-.18 E F0(Refresh the current line.)144
312 Q F1(Commands f)87 328.8 Q(or Manipulating the History)-.25 E
(accept\255line \(Newline, Retur)108 340.8 Q(n\))-.15 E F0 .364
(Accept the line re)144 352.8 R -.05(ga)-.15 G .364
(rdless of where the cursor is.).05 F .364(If this line is non-empty)
5.364 F 2.864(,i)-.65 G 2.864(tm)-2.864 G .365(ay be added to the)-2.864
F .741(history list for future recall with)144 364.8 R F1
(add_history\(\))3.241 E F0 5.741(.I)C 3.241(ft)-5.741 G .74
(he line is a modi\214ed history line, the history)-3.241 F
(line is restored to its original state.)144 376.8 Q F1(pr)108 388.8 Q
-.15(ev)-.18 G(ious\255history \(C\255p\)).15 E F0(Fetch the pre)144
400.8 Q(vious command from the history list, mo)-.25 E
(ving back in the list.)-.15 E F1(next\255history \(C\255n\))108 412.8 Q
F0(Fetch the ne)144 424.8 Q(xt command from the history list, mo)-.15 E
(ving forw)-.15 E(ard in the list.)-.1 E F1
(beginning\255of\255history \(M\255<\))108 436.8 Q F0(Mo)144 448.8 Q .3
-.15(ve t)-.15 H 2.5(ot).15 G(he \214rst line in the history)-2.5 E(.)
-.65 E F1(end\255of\255history \(M\255>\))108 460.8 Q F0(Mo)144 472.8 Q
.3 -.15(ve t)-.15 H 2.5(ot).15 G(he end of the input history)-2.5 E 2.5
(,i)-.65 G(.e., the line currently being entered.)-2.5 E F1 -2.29 -.18
(re v)108 484.8 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0
1.47(Search backw)144 496.8 R 1.471
(ard starting at the current line and mo)-.1 F 1.471
(ving `up' through the history as necessary)-.15 F(.)-.65 E
(This is an incremental search.)144 508.8 Q F1 -.25(fo)108 520.8 S
(rward\255sear).25 E(ch\255history \(C\255s\))-.18 E F0 1.132
(Search forw)144 532.8 R 1.132(ard starting at the current line and mo)
-.1 F 1.131(ving `do)-.15 F 1.131(wn' through the history as necessary)
-.25 F(.)-.65 E(This is an incremental search.)144 544.8 Q F1
(non\255incr)108 556.8 Q(emental\255r)-.18 E -2.3 -.15(ev e)-.18 H
(rse\255sear).15 E(ch\255history \(M\255p\))-.18 E F0 .164(Search backw)
144 568.8 R .164(ard through the history starting at the current line u\
sing a non-incremental search for)-.1 F 2.5(as)144 580.8 S
(tring supplied by the user)-2.5 E(.)-.55 E F1(non\255incr)108 592.8 Q
(emental\255f)-.18 E(orward\255sear)-.25 E(ch\255history \(M\255n\))-.18
E F0 1.354(Search forw)144 604.8 R 1.354(ard through the history using \
a non-incremental search for a string supplied by the)-.1 F(user)144
616.8 Q(.)-.55 E F1(history\255sear)108 628.8 Q(ch\255backward)-.18 E F0
.95(Search backw)144 640.8 R .951(ard through the history for the strin\
g of characters between the start of the current)-.1 F .12
(line and the current cursor position \(the)144 652.8 R/F2 10
/Times-Italic@0 SF(point)2.62 E F0 2.62(\). The)B .12
(search string must match at the be)2.62 F .12(ginning of a)-.15 F
(history line.)144 664.8 Q(This is a non-incremental search.)5 E F1
(history\255sear)108 676.8 Q(ch\255f)-.18 E(orward)-.25 E F0 .248
(Search forw)144 688.8 R .249(ard through the history for the string of\
 characters between the start of the current line)-.1 F .036
(and the point.)144 700.8 R .036(The search string must match at the be)
5.036 F .035(ginning of a history line.)-.15 F .035
(This is a non-incre-)5.035 F(mental search.)144 712.8 Q
(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(8)190.955 E 0 Cg
EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(history\255substring\255sear)108 84 Q(ch\255backward)-.18 E F0 .95
(Search backw)144 96 R .951(ard through the history for the string of c\
haracters between the start of the current)-.1 F .007
(line and the current cursor position \(the)144 108 R/F2 10
/Times-Italic@0 SF(point)2.507 E F0 2.507(\). The)B .007
(search string may match an)2.507 F .006(ywhere in a history)-.15 F 2.5
(line. This)144 120 R(is a non-incremental search.)2.5 E F1
(history\255substring\255sear)108 132 Q(ch\255f)-.18 E(orward)-.25 E F0
.248(Search forw)144 144 R .249(ard through the history for the string \
of characters between the start of the current line)-.1 F .319
(and the point.)144 156 R .319(The search string may match an)5.319 F
.319(ywhere in a history line.)-.15 F .318(This is a non-incremental)
5.318 F(search.)144 168 Q F1(yank\255nth\255ar)108 180 Q 2.5(g\()-.1 G
<4dad43ad7929>-2.5 E F0 .622(Insert the \214rst ar)144 192 R .622
(gument to the pre)-.18 F .622(vious command \(usually the second w)-.25
F .622(ord on the pre)-.1 F .622(vious line\))-.25 F .795(at point.)144
204 R -.4(Wi)5.795 G .794(th an ar).4 F(gument)-.18 E F2(n)3.294 E F0
3.294(,i).24 G .794(nsert the)-3.294 F F2(n)3.294 E F0 .794(th w)B .794
(ord from the pre)-.1 F .794(vious command \(the w)-.25 F .794
(ords in the)-.1 F(pre)144 216 Q .291(vious command be)-.25 F .291
(gin with w)-.15 F .291(ord 0\).)-.1 F 2.791(An)5.291 G -2.25 -.15(eg a)
-2.791 H(ti).15 E .591 -.15(ve a)-.25 H -.18(rg).15 G .291
(ument inserts the).18 F F2(n)2.791 E F0 .291(th w)B .292
(ord from the end of)-.1 F .282(the pre)144 228 R .282(vious command.)
-.25 F .282(Once the ar)5.282 F(gument)-.18 E F2(n)2.781 E F0 .281
(is computed, the ar)2.781 F .281(gument is e)-.18 F .281
(xtracted as if the "!)-.15 F F2(n)A F0(")A(history e)144 240 Q
(xpansion had been speci\214ed.)-.15 E F1(yank\255last\255ar)108 252 Q
2.5(g\()-.1 G -1.667(M\255. ,)-2.5 F -1.667(M\255_ \))2.5 F F0 1.307
(Insert the last ar)144 264 R 1.307(gument to the pre)-.18 F 1.307
(vious command \(the last w)-.25 F 1.308(ord of the pre)-.1 F 1.308
(vious history entry\).)-.25 F -.4(Wi)144 276 S .204(th a numeric ar).4
F .204(gument, beha)-.18 F .504 -.15(ve ex)-.2 H .204(actly lik).15 F(e)
-.1 E F1(yank\255nth\255ar)2.704 E(g)-.1 E F0 5.203(.S)C(uccessi)-5.203
E .503 -.15(ve c)-.25 H .203(alls to).15 F F1(yank\255last\255ar)2.703 E
(g)-.1 E F0(mo)144 288 Q .806 -.15(ve b)-.15 H .507
(ack through the history list, inserting the last w).15 F .507
(ord \(or the w)-.1 F .507(ord speci\214ed by the ar)-.1 F(gument)-.18 E
1.397(to the \214rst call\) of each line in turn.)144 300 R(An)6.396 E
3.896(yn)-.15 G 1.396(umeric ar)-3.896 F 1.396
(gument supplied to these successi)-.18 F 1.696 -.15(ve c)-.25 H(alls)
.15 E .491(determines the direction to mo)144 312 R .791 -.15(ve t)-.15
H .491(hrough the history).15 F 5.492(.A)-.65 G(ne)-2.5 E -.05(ga)-.15 G
(ti).05 E .792 -.15(ve a)-.25 H -.18(rg).15 G .492
(ument switches the direction).18 F .494
(through the history \(back or forw)144 324 R 2.994(ard\). The)-.1 F
.494(history e)2.994 F .494(xpansion f)-.15 F .494
(acilities are used to e)-.1 F .494(xtract the last)-.15 F(ar)144 336 Q
(gument, as if the "!$" history e)-.18 E(xpansion had been speci\214ed.)
-.15 E F1(Commands f)87 352.8 Q(or Changing T)-.25 E(ext)-.92 E F2
(end\255of\255\214le)108 364.8 Q F1(\(usually C\255d\))2.5 E F0 .798
(The character indicating end-of-\214le as set, for e)144 376.8 R .799
(xample, by)-.15 F/F3 10/Courier@0 SF(stty)3.299 E F0 5.799(.I)C 3.299
(ft)-5.799 G .799(his character is read when)-3.299 F .592
(there are no characters on the line, and point is at the be)144 388.8 R
.592(ginning of the line, Readline interprets it)-.15 F
(as the end of input and returns)144 400.8 Q/F4 9/Times-Bold@0 SF(EOF)
2.5 E/F5 9/Times-Roman@0 SF(.)A F1(delete\255char \(C\255d\))108 412.8 Q
F0 .441(Delete the character at point.)144 424.8 R .442
(If this function is bound to the same character as the tty)5.441 F F1
(EOF)2.942 E F0(char)2.942 E(-)-.2 E(acter)144 436.8 Q 2.5(,a)-.4 G(s)
-2.5 E F1(C\255d)2.5 E F0(commonly is, see abo)2.5 E .3 -.15(ve f)-.15 H
(or the ef).15 E(fects.)-.25 E F1(backward\255delete\255char \(Rubout\))
108 448.8 Q F0 .553(Delete the character behind the cursor)144 460.8 R
5.553(.W)-.55 G .553(hen gi)-5.553 F -.15(ve)-.25 G 3.053(nan).15 G .553
(umeric ar)-3.053 F .552(gument, sa)-.18 F .852 -.15(ve t)-.2 H .552
(he deleted te).15 F .552(xt on)-.15 F(the kill ring.)144 472.8 Q F1
-.25(fo)108 484.8 S(rward\255backward\255delete\255char).25 E F0 .473
(Delete the character under the cursor)144 496.8 R 2.973(,u)-.4 G .474
(nless the cursor is at the end of the line, in which case the)-2.973 F
(character behind the cursor is deleted.)144 508.8 Q F1
(quoted\255insert \(C\255q, C\255v\))108 520.8 Q F0 1.229(Add the ne)144
532.8 R 1.228(xt character that you type to the line v)-.15 F 3.728
(erbatim. This)-.15 F 1.228(is ho)3.728 F 3.728(wt)-.25 G 3.728(oi)
-3.728 G 1.228(nsert characters lik)-3.728 F(e)-.1 E F1(C\255q)144 544.8
Q F0 2.5(,f)C(or e)-2.5 E(xample.)-.15 E F1(tab\255insert \(M-T)108
556.8 Q(AB\))-.9 E F0(Insert a tab character)144 568.8 Q(.)-.55 E F1
(self\255insert \(a, b, A, 1, !, ...\))108 580.8 Q F0
(Insert the character typed.)144 592.8 Q F1
(transpose\255chars \(C\255t\))108 604.8 Q F0 .321
(Drag the character before point forw)144 616.8 R .321(ard o)-.1 F -.15
(ve)-.15 G 2.821(rt).15 G .321(he character at point, mo)-2.821 F .322
(ving point forw)-.15 F .322(ard as well.)-.1 F 1.182
(If point is at the end of the line, then this transposes the tw)144
628.8 R 3.682(oc)-.1 G 1.182(haracters before point.)-3.682 F(Ne)6.182 E
-.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G(ar)144 640.8 Q(guments ha)-.18 E
.3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect.).25 E F1
(transpose\255w)108 652.8 Q(ords \(M\255t\))-.1 E F0 .023(Drag the w)144
664.8 R .023(ord before point past the w)-.1 F .023(ord after point, mo)
-.1 F .023(ving point o)-.15 F -.15(ve)-.15 G 2.524(rt).15 G .024(hat w)
-2.524 F .024(ord as well.)-.1 F .024(If point)5.024 F
(is at the end of the line, this transposes the last tw)144 676.8 Q 2.5
(ow)-.1 G(ords on the line.)-2.6 E F1(upcase\255w)108 688.8 Q
(ord \(M\255u\))-.1 E F0 1.699(Uppercase the current \(or follo)144
700.8 R 1.698(wing\) w)-.25 F 4.198(ord. W)-.1 F 1.698(ith a ne)-.4 F
-.05(ga)-.15 G(ti).05 E 1.998 -.15(ve a)-.25 H -.18(rg).15 G 1.698
(ument, uppercase the pre).18 F(vious)-.25 E -.1(wo)144 712.8 S(rd, b).1
E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E(GNU Readline 7.0)72
768 Q(2017 December 28)121.245 E(9)190.955 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(do)108 84 Q(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 96 Q 1.647
(wercase the current \(or follo)-.25 F 1.647(wing\) w)-.25 F 4.147
(ord. W)-.1 F 1.648(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E 1.948 -.15
(ve a)-.25 H -.18(rg).15 G 1.648(ument, lo).18 F 1.648(wercase the pre)
-.25 F(vious)-.25 E -.1(wo)144 108 S(rd, b).1 E(ut do not mo)-.2 E .3
-.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 120 Q
(ord \(M\255c\))-.1 E F0 1.975(Capitalize the current \(or follo)144 132
R 1.974(wing\) w)-.25 F 4.474(ord. W)-.1 F 1.974(ith a ne)-.4 F -.05(ga)
-.15 G(ti).05 E 2.274 -.15(ve a)-.25 H -.18(rg).15 G 1.974
(ument, capitalize the pre).18 F(vious)-.25 E -.1(wo)144 144 S(rd, b).1
E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1 -.1(ove)108 156
S(rwrite\255mode).1 E F0 -.8(To)144 168 S .437(ggle o).8 F -.15(ve)-.15
G .437(rwrite mode.).15 F -.4(Wi)5.437 G .437(th an e).4 F .437
(xplicit positi)-.15 F .738 -.15(ve n)-.25 H .438(umeric ar).15 F .438
(gument, switches to o)-.18 F -.15(ve)-.15 G .438(rwrite mode.).15 F -.4
(Wi)144 180 S .781(th an e).4 F .781(xplicit non-positi)-.15 F 1.081
-.15(ve n)-.25 H .781(umeric ar).15 F .781
(gument, switches to insert mode.)-.18 F .78(This command af)5.781 F
(fects)-.25 E(only)144 192 Q F1(emacs)4.394 E F0(mode;)4.394 E F1(vi)
4.394 E F0 1.894(mode does o)4.394 F -.15(ve)-.15 G 1.894(rwrite dif).15
F(ferently)-.25 E 6.894(.E)-.65 G 1.894(ach call to)-6.894 F/F2 10
/Times-Italic@0 SF -.37(re)4.395 G(adline\(\)).37 E F0 1.895
(starts in insert)4.395 F 3.969(mode. In)144 204 R -.15(ove)3.969 G
1.469(rwrite mode, characters bound to).15 F F1(self\255insert)3.969 E
F0 1.468(replace the te)3.969 F 1.468(xt at point rather than)-.15 F
.957(pushing the te)144 216 R .957(xt to the right.)-.15 F .958
(Characters bound to)5.957 F F1(backward\255delete\255char)3.458 E F0
.958(replace the character)3.458 F(before point with a space.)144 228 Q
(By def)5 E(ault, this command is unbound.)-.1 E F1(Killing and Y)87
244.8 Q(anking)-.85 E(kill\255line \(C\255k\))108 256.8 Q F0
(Kill the te)144 268.8 Q(xt from point to the end of the line.)-.15 E F1
(backward\255kill\255line \(C\255x Rubout\))108 280.8 Q F0(Kill backw)
144 292.8 Q(ard to the be)-.1 E(ginning of the line.)-.15 E F1
(unix\255line\255discard \(C\255u\))108 304.8 Q F0(Kill backw)144 316.8
Q(ard from point to the be)-.1 E(ginning of the line.)-.15 E
(The killed te)5 E(xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)
-2.5 G(he kill-ring.)-2.5 E F1(kill\255whole\255line)108 328.8 Q F0
(Kill all characters on the current line, no matter where point is.)144
340.8 Q F1(kill\255w)108 352.8 Q(ord \(M\255d\))-.1 E F0 1.308
(Kill from point the end of the current w)144 364.8 R 1.308
(ord, or if between w)-.1 F 1.308(ords, to the end of the ne)-.1 F 1.307
(xt w)-.15 F(ord.)-.1 E -.8(Wo)144 376.8 S
(rd boundaries are the same as those used by).8 E F1 -.25(fo)2.5 G
(rward\255w).25 E(ord)-.1 E F0(.)A F1(backward\255kill\255w)108 388.8 Q
(ord \(M\255Rubout\))-.1 E F0(Kill the w)144 400.8 Q(ord behind point.)
-.1 E -.8(Wo)5 G(rd boundaries are the same as those used by).8 E F1
(backward\255w)2.5 E(ord)-.1 E F0(.)A F1(unix\255w)108 412.8 Q
(ord\255rubout \(C\255w\))-.1 E F0 .364(Kill the w)144 424.8 R .364
(ord behind point, using white space as a w)-.1 F .365(ord boundary)-.1
F 5.365(.T)-.65 G .365(he killed te)-5.365 F .365(xt is sa)-.15 F -.15
(ve)-.2 G 2.865(do).15 G 2.865(nt)-2.865 G(he)-2.865 E(kill-ring.)144
436.8 Q F1(unix\255\214lename\255rubout)108 448.8 Q F0 .167(Kill the w)
144 460.8 R .166
(ord behind point, using white space and the slash character as the w)
-.1 F .166(ord boundaries.)-.1 F(The)5.166 E(killed te)144 472.8 Q
(xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)-2.5 G(he kill-ring.)
-2.5 E F1(delete\255horizontal\255space \(M\255\\\))108 484.8 Q F0
(Delete all spaces and tabs around point.)144 496.8 Q F1(kill\255r)108
508.8 Q(egion)-.18 E F0 1.13(Kill the te)144 520.8 R 1.13
(xt between the point and)-.15 F F2(mark)3.63 E F0(\(sa)3.63 E -.15(ve)
-.2 G 3.63(dc).15 G 1.13(ursor position\).)-3.63 F 1.13(This te)6.13 F
1.13(xt is referred to as the)-.15 F F2 -.37(re)144 532.8 S(gion)-.03 E
F0(.)A F1(copy\255r)108 544.8 Q(egion\255as\255kill)-.18 E F0(Cop)144
556.8 Q 2.5(yt)-.1 G(he te)-2.5 E(xt in the re)-.15 E
(gion to the kill b)-.15 E(uf)-.2 E(fer)-.25 E(.)-.55 E F1
(copy\255backward\255w)108 568.8 Q(ord)-.1 E F0(Cop)144 580.8 Q 4.801
(yt)-.1 G 2.301(he w)-4.801 F 2.301(ord before point to the kill b)-.1 F
(uf)-.2 E(fer)-.25 E 7.301(.T)-.55 G 2.301(he w)-7.301 F 2.3
(ord boundaries are the same as)-.1 F F1(back-)4.8 E(ward\255w)144 592.8
Q(ord)-.1 E F0(.)A F1(copy\255f)108 604.8 Q(orward\255w)-.25 E(ord)-.1 E
F0(Cop)144 616.8 Q 4.507(yt)-.1 G 2.007(he w)-4.507 F 2.007(ord follo)
-.1 F 2.007(wing point to the kill b)-.25 F(uf)-.2 E(fer)-.25 E 7.008
(.T)-.55 G 2.008(he w)-7.008 F 2.008(ord boundaries are the same as)-.1
F F1 -.25(fo)4.508 G -.37(r-).25 G(ward\255w)144 628.8 Q(ord)-.1 E F0(.)
A F1(yank \(C\255y\))108 640.8 Q F0 -1(Ya)144 652.8 S
(nk the top of the kill ring into the b)1 E(uf)-.2 E(fer at point.)-.25
E F1(yank\255pop \(M\255y\))108 664.8 Q F0
(Rotate the kill ring, and yank the ne)144 676.8 Q 2.5(wt)-.25 G 2.5
(op. Only)-2.5 F -.1(wo)2.5 G(rks follo).1 E(wing)-.25 E F1(yank)2.5 E
F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 693.6 Q
(guments)-.1 E(digit\255ar)108 705.6 Q
(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 .367
(Add this digit to the ar)144 717.6 R .367
(gument already accumulating, or start a ne)-.18 F 2.867(wa)-.25 G -.18
(rg)-2.867 G 2.867(ument. M\255\255).18 F .366(starts a ne)2.867 F -.05
(ga)-.15 G(-).05 E(ti)144 729.6 Q .3 -.15(ve a)-.25 H -.18(rg).15 G
(ument.).18 E(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(10)
185.955 E 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(uni)108 84 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0 .778
(This is another w)144 96 R .779(ay to specify an ar)-.1 F 3.279
(gument. If)-.18 F .779(this command is follo)3.279 F .779
(wed by one or more digits,)-.25 F 1.376
(optionally with a leading minus sign, those digits de\214ne the ar)144
108 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144
120 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni)
3.67 E -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0(ag)3.67 E 1.17
(ain ends the numeric ar)-.05 F 1.17(gument, b)-.18 F 1.17(ut is other)
-.2 F(-)-.2 E .899(wise ignored.)144 132 R .898
(As a special case, if this command is immediately follo)5.899 F .898
(wed by a character that is)-.25 F .243
(neither a digit or minus sign, the ar)144 144 R .243
(gument count for the ne)-.18 F .243(xt command is multiplied by four)
-.15 F 5.243(.T)-.55 G(he)-5.243 E(ar)144 156 Q .378
(gument count is initially one, so e)-.18 F -.15(xe)-.15 G .378
(cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F
.378(gument count)-.18 F(four)144 168 Q 2.5(,as)-.4 G(econd time mak)
-2.5 E(es the ar)-.1 E(gument count sixteen, and so on.)-.18 E F1
(Completing)87 184.8 Q(complete \(T)108 196.8 Q(AB\))-.9 E F0 1.908
(Attempt to perform completion on the te)144 208.8 R 1.908
(xt before point.)-.15 F 1.909(The actual completion performed is)6.909
F(application-speci\214c.)144 220.8 Q F1(Bash)5.518 E F0 3.018(,f)C .518
(or instance, attempts completion treating the te)-3.018 F .517
(xt as a v)-.15 F .517(ariable \(if the)-.25 F(te)144 232.8 Q .656
(xt be)-.15 F .656(gins with)-.15 F F1($)3.156 E F0 .656
(\), username \(if the te)B .656(xt be)-.15 F .656(gins with)-.15 F F1
(~)3.156 E F0 .656(\), hostname \(if the te)B .656(xt be)-.15 F .656
(gins with)-.15 F F1(@)3.157 E F0 .657(\), or)B .93
(command \(including aliases and functions\) in turn.)144 244.8 R .929
(If none of these produces a match, \214lename)5.929 F 1.273
(completion is attempted.)144 256.8 R F1(Gdb)6.273 E F0 3.773(,o)C 3.773
(nt)-3.773 G 1.273(he other hand, allo)-3.773 F 1.273
(ws completion of program functions and)-.25 F -.25(va)144 268.8 S(riab\
les, and only attempts \214lename completion under certain circumstance\
s.).25 E F1(possible\255completions \(M\255?\))108 280.8 Q F0 .262
(List the possible completions of the te)144 292.8 R .262
(xt before point.)-.15 F .261
(When displaying completions, readline sets)5.261 F 1.002
(the number of columns used for display to the v)144 304.8 R 1.002
(alue of)-.25 F F1(completion-display-width)3.502 E F0 3.502(,t)C 1.003
(he v)-3.502 F 1.003(alue of)-.25 F(the en)144 316.8 Q(vironment v)-.4 E
(ariable)-.25 E/F2 9/Times-Bold@0 SF(COLUMNS)2.5 E/F3 9/Times-Roman@0 SF
(,)A F0(or the screen width, in that order)2.25 E(.)-.55 E F1
(insert\255completions \(M\255*\))108 328.8 Q F0 .783
(Insert all completions of the te)144 340.8 R .783
(xt before point that w)-.15 F .783(ould ha)-.1 F 1.083 -.15(ve b)-.2 H
.783(een generated by).15 F F1(possible\255com-)3.282 E(pletions)144
352.8 Q F0(.)A F1(menu\255complete)108 364.8 Q F0 .928(Similar to)144
376.8 R F1(complete)3.428 E F0 3.428(,b)C .929(ut replaces the w)-3.628
F .929(ord to be completed with a single match from the list of)-.1 F
1.194(possible completions.)144 388.8 R 1.194(Repeated e)6.194 F -.15
(xe)-.15 G 1.194(cution of).15 F F1(menu\255complete)3.694 E F0 1.193
(steps through the list of possible)3.694 F .828
(completions, inserting each match in turn.)144 400.8 R .828
(At the end of the list of completions, the bell is rung)5.828 F .727
(\(subject to the setting of)144 412.8 R F1(bell\255style)3.227 E F0
3.227(\)a)C .727(nd the original te)-3.227 F .727(xt is restored.)-.15 F
.727(An ar)5.727 F .727(gument of)-.18 F/F4 10/Times-Italic@0 SF(n)3.227
E F0(mo)3.227 E -.15(ve)-.15 G(s).15 E F4(n)3.227 E F0 1.73
(positions forw)144 424.8 R 1.73(ard in the list of matches; a ne)-.1 F
-.05(ga)-.15 G(ti).05 E 2.03 -.15(ve a)-.25 H -.18(rg).15 G 1.73
(ument may be used to mo).18 F 2.03 -.15(ve b)-.15 H(ackw).15 E(ard)-.1
E(through the list.)144 436.8 Q(This command is intended to be bound to)
5 E F1 -.9(TA)2.5 G(B).9 E F0 2.5(,b)C(ut is unbound by def)-2.7 E
(ault.)-.1 E F1(menu\255complete\255backward)108 448.8 Q F0 .82
(Identical to)144 460.8 R F1(menu\255complete)3.32 E F0 3.32(,b)C .82
(ut mo)-3.52 F -.15(ve)-.15 G 3.32(sb).15 G(ackw)-3.32 E .82
(ard through the list of possible completions, as if)-.1 F F1
(menu\255complete)144 472.8 Q F0(had been gi)2.5 E -.15(ve)-.25 G 2.5
(nan).15 G -2.25 -.15(eg a)-2.5 H(ti).15 E .3 -.15(ve a)-.25 H -.18(rg)
.15 G 2.5(ument. This).18 F(command is unbound by def)2.5 E(ault.)-.1 E
F1(delete\255char\255or\255list)108 484.8 Q F0 .373
(Deletes the character under the cursor if not at the be)144 496.8 R
.374(ginning or end of the line \(lik)-.15 F(e)-.1 E F1(delete-char)
2.874 E F0(\).)A(If at the end of the line, beha)144 508.8 Q -.15(ve)-.2
G 2.5(si).15 G(dentically to)-2.5 E F1(possible-completions)2.5 E F0(.)A
F1 -.25(Ke)87 525.6 S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr)
108 537.6 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)).833 E F0(Be)144 549.6 Q
(gin sa)-.15 E(ving the characters typed into the current k)-.2 E -.15
(ey)-.1 G(board macro.).15 E F1(end\255kbd\255macr)108 561.6 Q 2.5(o\()
-.18 G(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 573.6 Q
(ving the characters typed into the current k)-.2 E -.15(ey)-.1 G
(board macro and store the de\214nition.).15 E F1
(call\255last\255kbd\255macr)108 585.6 Q 2.5(o\()-.18 G(C\255x e\))-2.5
E F0(Re-e)144 597.6 Q -.15(xe)-.15 G 1(cute the last k).15 F -.15(ey)-.1
G .999(board macro de\214ned, by making the characters in the macro app\
ear as if).15 F(typed at the k)144 609.6 Q -.15(ey)-.1 G(board.).15 E F1
(print\255last\255kbd\255macr)108 621.6 Q 2.5(o\()-.18 G(\))-2.5 E F0
(Print the last k)144 633.6 Q -.15(ey)-.1 G
(board macro de\214ned in a format suitable for the).15 E F4(inputr)2.5
E(c)-.37 E F0(\214le.)2.5 E F1(Miscellaneous)87 650.4 Q -.18(re)108
662.4 S<ad72>.18 E(ead\255init\255\214le \(C\255x C\255r\))-.18 E F0
1.776(Read in the contents of the)144 674.4 R F4(inputr)4.276 E(c)-.37 E
F0 1.777(\214le, and incorporate an)4.276 F 4.277(yb)-.15 G 1.777
(indings or v)-4.277 F 1.777(ariable assignments)-.25 F(found there.)144
686.4 Q F1(abort \(C\255g\))108 698.4 Q F0 3.249
(Abort the current editing command and ring the terminal')144 710.4 R
5.748(sb)-.55 G 3.248(ell \(subject to the setting of)-5.748 F F1
(bell\255style)144 722.4 Q F0(\).)A(GNU Readline 7.0)72 768 Q
(2017 December 28)121.245 E(11)185.955 E 0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(do\255lo)108 84 Q(wer)-.1 E(case\255v)-.18 E
(ersion \(M\255A, M\255B, M\255)-.1 E/F2 10/Times-Italic@0 SF(x)A F1 2.5
(,.)C(..\))-2.5 E F0 1.738(If the meta\214ed character)144 96 R F2(x)
4.238 E F0 1.739
(is uppercase, run the command that is bound to the corresponding)4.238
F(meta\214ed lo)144 108 Q(wercase character)-.25 E 5(.T)-.55 G(he beha)
-5 E(vior is unde\214ned if)-.2 E F2(x)2.5 E F0(is already lo)2.5 E
(wercase.)-.25 E F1(pr)108 120 Q(e\214x\255meta \(ESC\))-.18 E F0
(Metafy the ne)144 132 Q(xt character typed.)-.15 E/F3 9/Times-Bold@0 SF
(ESC)5 E F1(f)2.25 E F0(is equi)2.5 E -.25(va)-.25 G(lent to).25 E F1
(Meta\255f)2.5 E F0(.)A F1(undo \(C\255_, C\255x C\255u\))108 144 Q F0
(Incremental undo, separately remembered for each line.)144 156 Q F1
-2.29 -.18(re v)108 168 T(ert\255line \(M\255r\)).08 E F0 1.095
(Undo all changes made to this line.)144 180 R 1.095(This is lik)6.095 F
3.595(ee)-.1 G -.15(xe)-3.745 G 1.095(cuting the).15 F F1(undo)3.595 E
F0 1.095(command enough times to)3.595 F
(return the line to its initial state.)144 192 Q F1
(tilde\255expand \(M\255&\))108 204 Q F0(Perform tilde e)144 216 Q
(xpansion on the current w)-.15 E(ord.)-.1 E F1
(set\255mark \(C\255@, M\255<space>\))108 228 Q F0
(Set the mark to the point.)144 240 Q(If a numeric ar)5 E
(gument is supplied, the mark is set to that position.)-.18 E F1
(exchange\255point\255and\255mark \(C\255x C\255x\))108 252 Q F0(Sw)144
264 Q .282(ap the point with the mark.)-.1 F .283
(The current cursor position is set to the sa)5.283 F -.15(ve)-.2 G
2.783(dp).15 G .283(osition, and the old)-2.783 F(cursor position is sa)
144 276 Q -.15(ve)-.2 G 2.5(da).15 G 2.5(st)-2.5 G(he mark.)-2.5 E F1
(character\255sear)108 288 Q(ch \(C\255]\))-.18 E F0 3.036(Ac)144 300 S
.536(haracter is read and point is mo)-3.036 F -.15(ve)-.15 G 3.035(dt)
.15 G 3.035(ot)-3.035 G .535(he ne)-3.035 F .535
(xt occurrence of that character)-.15 F 5.535(.A)-.55 G(ne)-2.5 E -.05
(ga)-.15 G(ti).05 E .835 -.15(ve c)-.25 H(ount).15 E(searches for pre)
144 312 Q(vious occurrences.)-.25 E F1(character\255sear)108 324 Q
(ch\255backward \(M\255C\255]\))-.18 E F0 3.543(Ac)144 336 S 1.043
(haracter is read and point is mo)-3.543 F -.15(ve)-.15 G 3.544(dt).15 G
3.544(ot)-3.544 G 1.044(he pre)-3.544 F 1.044
(vious occurrence of that character)-.25 F 6.044(.A)-.55 G(ne)-2.5 E
-.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G
(count searches for subsequent occurrences.)144 348 Q F1
(skip\255csi\255sequence)108 360 Q F0 1.827
(Read enough characters to consume a multi-k)144 372 R 2.126 -.15(ey s)
-.1 H 1.826(equence such as those de\214ned for k).15 F -.15(ey)-.1 G
4.326(sl).15 G(ik)-4.326 E(e)-.1 E .79(Home and End.)144 384 R .791
(Such sequences be)5.79 F .791
(gin with a Control Sequence Indicator \(CSI\), usually ESC\255[.)-.15 F
.332(If this sequence is bound to "\\[", k)144 396 R -.15(ey)-.1 G 2.831
(sp).15 G .331(roducing such sequences will ha)-2.831 F .631 -.15(ve n)
-.2 H 2.831(oe).15 G -.25(ff)-2.831 G .331(ect unless e).25 F(xplic-)
-.15 E .026(itly bound to a readline command, instead of inserting stra\
y characters into the editing b)144 408 R(uf)-.2 E(fer)-.25 E 5.026(.T)
-.55 G(his)-5.026 E(is unbound by def)144 420 Q(ault, b)-.1 E
(ut usually bound to ESC\255[.)-.2 E F1(insert\255comment \(M\255#\))108
432 Q F0 -.4(Wi)144 444 S .481(thout a numeric ar).4 F .481
(gument, the v)-.18 F .481(alue of the readline)-.25 F F1
(comment\255begin)2.981 E F0 -.25(va)2.981 G .48
(riable is inserted at the).25 F(be)144 456 Q .244
(ginning of the current line.)-.15 F .245(If a numeric ar)5.244 F .245
(gument is supplied, this command acts as a toggle: if)-.18 F .322
(the characters at the be)144 468 R .321
(ginning of the line do not match the v)-.15 F .321(alue of)-.25 F F1
(comment\255begin)2.821 E F0 2.821(,t)C .321(he v)-2.821 F .321(alue is)
-.25 F 1.013(inserted, otherwise the characters in)144 480 R F1
(comment-begin)3.514 E F0 1.014(are deleted from the be)3.514 F 1.014
(ginning of the line.)-.15 F 1.469
(In either case, the line is accepted as if a ne)144 492 R 1.468
(wline had been typed.)-.25 F 1.468(The def)6.468 F 1.468(ault v)-.1 F
1.468(alue of)-.25 F F1(com-)3.968 E(ment\255begin)144 504 Q F0(mak)
2.982 E .483(es the current line a shell comment.)-.1 F .483
(If a numeric ar)5.483 F .483(gument causes the comment)-.18 F
(character to be remo)144 516 Q -.15(ve)-.15 G(d, the line will be e).15
E -.15(xe)-.15 G(cuted by the shell.).15 E F1(dump\255functions)108 528
Q F0 .627(Print all of the functions and their k)144 540 R .927 -.15
(ey b)-.1 H .626(indings to the readline output stream.).15 F .626
(If a numeric ar)5.626 F(gu-)-.18 E
(ment is supplied, the output is formatted in such a w)144 552 Q
(ay that it can be made part of an)-.1 E F2(inputr)2.5 E(c)-.37 E F0
(\214le.)2.5 E F1(dump\255v)108 564 Q(ariables)-.1 E F0 .283
(Print all of the settable v)144 576 R .283(ariables and their v)-.25 F
.283(alues to the readline output stream.)-.25 F .283(If a numeric ar)
5.283 F(gu-)-.18 E
(ment is supplied, the output is formatted in such a w)144 588 Q
(ay that it can be made part of an)-.1 E F2(inputr)2.5 E(c)-.37 E F0
(\214le.)2.5 E F1(dump\255macr)108 600 Q(os)-.18 E F0 .593
(Print all of the readline k)144 612 R .893 -.15(ey s)-.1 H .592
(equences bound to macros and the strings the).15 F 3.092(yo)-.15 G
3.092(utput. If)-3.092 F 3.092(an)3.092 G(umeric)-3.092 E(ar)144 624 Q
.528(gument is supplied, the output is formatted in such a w)-.18 F .528
(ay that it can be made part of an)-.1 F F2(inputr)3.028 E(c)-.37 E F0
(\214le.)144 636 Q F1(emacs\255editing\255mode \(C\255e\))108 648 Q F0
(When in)144 660 Q F1(vi)2.5 E F0(command mode, this causes a switch to)
2.5 E F1(emacs)2.5 E F0(editing mode.)2.5 E F1
(vi\255editing\255mode \(M\255C\255j\))108 672 Q F0(When in)144 684 Q F1
(emacs)2.5 E F0(editing mode, this causes a switch to)2.5 E F1(vi)2.5 E
F0(editing mode.)2.5 E/F4 10.95/Times-Bold@0 SF(DEF)72 700.8 Q -.548(AU)
-.986 G 2.014 -1.007(LT K).548 H(EY BINDINGS)1.007 E F0 .065(The follo)
108 712.8 R .065(wing is a list of the def)-.25 F .065
(ault emacs and vi bindings.)-.1 F .064
(Characters with the eighth bit set are written as)5.064 F .527
(M\255<character>, and are referred to as)108 724.8 R F2(meta\214ed)
3.407 E F0 3.027(characters. The)3.797 F .527
(printable ASCII characters not mentioned)3.027 F(GNU Readline 7.0)72
768 Q(2017 December 28)121.245 E(12)185.955 E 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 1.116
(in the list of emacs standard bindings are bound to the)108 84 R/F1 10
/Times-Bold@0 SF(self\255insert)3.615 E F0 1.115
(function, which just inserts the gi)3.615 F -.15(ve)-.25 G(n).15 E .945
(character into the input line.)108 96 R .945(In vi insertion mode, all\
 characters not speci\214cally mentioned are bound to)5.945 F F1
(self\255insert)108 108 Q F0 5.359(.C)C .359
(haracters assigned to signal generation by)-5.359 F/F2 10
/Times-Italic@0 SF(stty)2.859 E F0 .359(\(1\) or the terminal dri).32 F
-.15(ve)-.25 G 1.159 -.4(r, s).15 H .358(uch as C-Z or C-C,).4 F .187
(retain that function.)108 120 R .187(Upper and lo)5.187 F .188(wer cas\
e meta\214ed characters are bound to the same function in the emacs)-.25
F .305(mode meta k)108 132 R -.15(ey)-.1 G 2.805(map. The).15 F .305(re\
maining characters are unbound, which causes readline to ring the bell \
\(subject)2.805 F(to the setting of the)108 144 Q F1(bell\255style)2.5 E
F0 -.25(va)2.5 G(riable\).).25 E F1(Emacs Mode)87 160.8 Q F0
(Emacs Standard bindings)151.2 172.8 Q 2.5("C-@" set-mark)151.2 196.8 R
2.5("C-A" be)151.2 208.8 R(ginning-of-line)-.15 E 2.5("C-B" backw)151.2
220.8 R(ard-char)-.1 E 2.5("C-D" delete-char)151.2 232.8 R 2.5
("C-E" end-of-line)151.2 244.8 R 2.5("C-F" forw)151.2 256.8 R(ard-char)
-.1 E 2.5("C-G" abort)151.2 268.8 R 2.5("C-H" backw)151.2 280.8 R
(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 292.8 R 2.5
("C-J" accept-line)151.2 304.8 R 2.5("C-K" kill-line)151.2 316.8 R 2.5
("C-L" clear)151.2 328.8 R(-screen)-.2 E 2.5("C-M" accept-line)151.2
340.8 R 2.5("C-N" ne)151.2 352.8 R(xt-history)-.15 E 2.5("C-P" pre)151.2
364.8 R(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 376.8 R 2.5
("C-R" re)151.2 388.8 R -.15(ve)-.25 G(rse-search-history).15 E 2.5
("C-S" forw)151.2 400.8 R(ard-search-history)-.1 E 2.5
("C-T" transpose-chars)151.2 412.8 R 2.5("C-U" unix-line-discard)151.2
424.8 R 2.5("C-V" quoted-insert)151.2 436.8 R 2.5("C-W" unix-w)151.2
448.8 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 460.8 R 2.5
("C-]" character)151.2 472.8 R(-search)-.2 E 2.5("C-_" undo)151.2 484.8
R 3.333("")151.2 496.8 S(to "/")-.833 E(self-insert)5 E 2.5("0" to)151.2
508.8 R 2.5("9" self-insert)2.5 F 2.5(":" to)151.2 520.8 R 2.5
("~" self-insert)2.5 F 2.5("C-?" backw)151.2 532.8 R(ard-delete-char)-.1
E(Emacs Meta bindings)151.2 549.6 Q 2.5("M-C-G" abort)151.2 573.6 R 2.5
("M-C-H" backw)151.2 585.6 R(ard-kill-w)-.1 E(ord)-.1 E 2.5
("M-C-I" tab-insert)151.2 597.6 R 2.5("M-C-J" vi-editing-mode)151.2
609.6 R 2.5("M-C-M" vi-editing-mode)151.2 621.6 R 2.5("M-C-R" re)151.2
633.6 R -.15(ve)-.25 G(rt-line).15 E 2.5("M-C-Y" yank-nth-ar)151.2 645.6
R(g)-.18 E 2.5("M-C-[" complete)151.2 657.6 R 2.5("M-C-]" character)
151.2 669.6 R(-search-backw)-.2 E(ard)-.1 E 2.5("M-space" set-mark)151.2
681.6 R 2.5("M-#" insert-comment)151.2 693.6 R 2.5("M-&" tilde-e)151.2
705.6 R(xpand)-.15 E 2.5("M-*" insert-completions)151.2 717.6 R 2.5
("M--" digit-ar)151.2 729.6 R(gument)-.18 E(GNU Readline 7.0)72 768 Q
(2017 December 28)121.245 E(13)185.955 E 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("M-." yank-last-ar)
151.2 84 R(g)-.18 E 2.5("M-0" digit-ar)151.2 96 R(gument)-.18 E 2.5
("M-1" digit-ar)151.2 108 R(gument)-.18 E 2.5("M-2" digit-ar)151.2 120 R
(gument)-.18 E 2.5("M-3" digit-ar)151.2 132 R(gument)-.18 E 2.5
("M-4" digit-ar)151.2 144 R(gument)-.18 E 2.5("M-5" digit-ar)151.2 156 R
(gument)-.18 E 2.5("M-6" digit-ar)151.2 168 R(gument)-.18 E 2.5
("M-7" digit-ar)151.2 180 R(gument)-.18 E 2.5("M-8" digit-ar)151.2 192 R
(gument)-.18 E 2.5("M-9" digit-ar)151.2 204 R(gument)-.18 E 2.5
("M-<" be)151.2 216 R(ginning-of-history)-.15 E 2.5
("M-=" possible-completions)151.2 228 R 2.5("M->" end-of-history)151.2
240 R 2.5("M-?" possible-completions)151.2 252 R 2.5("M-B" backw)151.2
264 R(ard-w)-.1 E(ord)-.1 E 2.5("M-C" capitalize-w)151.2 276 R(ord)-.1 E
2.5("M-D" kill-w)151.2 288 R(ord)-.1 E 2.5("M-F" forw)151.2 300 R(ard-w)
-.1 E(ord)-.1 E 2.5("M-L" do)151.2 312 R(wncase-w)-.25 E(ord)-.1 E 2.5
("M-N" non-incremental-forw)151.2 324 R(ard-search-history)-.1 E 2.5
("M-P" non-incremental-re)151.2 336 R -.15(ve)-.25 G(rse-search-history)
.15 E 2.5("M-R" re)151.2 348 R -.15(ve)-.25 G(rt-line).15 E 2.5
("M-T" transpose-w)151.2 360 R(ords)-.1 E 2.5("M-U" upcase-w)151.2 372 R
(ord)-.1 E 2.5("M-Y" yank-pop)151.2 384 R 2.5
("M-\\" delete-horizontal-space)151.2 396 R 2.5("M-~" tilde-e)151.2 408
R(xpand)-.15 E 2.5("M-C-?" backw)151.2 420 R(ard-kill-w)-.1 E(ord)-.1 E
2.5("M-_" yank-last-ar)151.2 432 R(g)-.18 E(Emacs Control-X bindings)
151.2 448.8 Q 2.5("C-XC-G" abort)151.2 472.8 R 2.5
("C-XC-R" re-read-init-\214le)151.2 484.8 R 2.5("C-XC-U" undo)151.2
496.8 R 2.5("C-XC-X" e)151.2 508.8 R(xchange-point-and-mark)-.15 E 2.5
("C-X\(" start-kbd-macro)151.2 520.8 R 2.5("C-X\)" end-kbd-macro)151.2
532.8 R 2.5("C-XE" call-last-kbd-macro)151.2 544.8 R 2.5("C-XC-?" backw)
151.2 556.8 R(ard-kill-line)-.1 E/F1 10/Times-Bold@0 SF
(VI Mode bindings)87 585.6 Q F0(VI Insert Mode functions)151.2 597.6 Q
2.5("C-D" vi-eof-maybe)151.2 621.6 R 2.5("C-H" backw)151.2 633.6 R
(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 645.6 R 2.5
("C-J" accept-line)151.2 657.6 R 2.5("C-M" accept-line)151.2 669.6 R 2.5
("C-R" re)151.2 681.6 R -.15(ve)-.25 G(rse-search-history).15 E 2.5
("C-S" forw)151.2 693.6 R(ard-search-history)-.1 E 2.5
("C-T" transpose-chars)151.2 705.6 R 2.5("C-U" unix-line-discard)151.2
717.6 R 2.5("C-V" quoted-insert)151.2 729.6 R(GNU Readline 7.0)72 768 Q
(2017 December 28)121.245 E(14)185.955 E 0 Cg EP
%%Page: 15 15
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-W" unix-w)151.2
84 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 96 R 2.5("C-[" vi-mo)151.2
108 R -.15(ve)-.15 G(ment-mode).15 E 2.5("C-_" undo)151.2 120 R 3.333
("")151.2 132 S(to "~")-.833 E(self-insert)5 E 2.5("C-?" backw)151.2 144
R(ard-delete-char)-.1 E(VI Command Mode functions)151.2 160.8 Q 2.5
("C-D" vi-eof-maybe)151.2 184.8 R 2.5("C-E" emacs-editing-mode)151.2
196.8 R 2.5("C-G" abort)151.2 208.8 R 2.5("C-H" backw)151.2 220.8 R
(ard-char)-.1 E 2.5("C-J" accept-line)151.2 232.8 R 2.5("C-K" kill-line)
151.2 244.8 R 2.5("C-L" clear)151.2 256.8 R(-screen)-.2 E 2.5
("C-M" accept-line)151.2 268.8 R 2.5("C-N" ne)151.2 280.8 R(xt-history)
-.15 E 2.5("C-P" pre)151.2 292.8 R(vious-history)-.25 E 2.5
("C-Q" quoted-insert)151.2 304.8 R 2.5("C-R" re)151.2 316.8 R -.15(ve)
-.25 G(rse-search-history).15 E 2.5("C-S" forw)151.2 328.8 R
(ard-search-history)-.1 E 2.5("C-T" transpose-chars)151.2 340.8 R 2.5
("C-U" unix-line-discard)151.2 352.8 R 2.5("C-V" quoted-insert)151.2
364.8 R 2.5("C-W" unix-w)151.2 376.8 R(ord-rubout)-.1 E 2.5("C-Y" yank)
151.2 388.8 R 2.5("C-_" vi-undo)151.2 400.8 R -4.166 3.333("" f)151.2
412.8 T(orw)-3.333 E(ard-char)-.1 E 2.5("#" insert-comment)151.2 424.8 R
2.5("$" end-of-line)151.2 436.8 R 2.5("%" vi-match)151.2 448.8 R 2.5
("&" vi-tilde-e)151.2 460.8 R(xpand)-.15 E 2.5("*" vi-complete)151.2
472.8 R 2.5("+" ne)151.2 484.8 R(xt-history)-.15 E 2.5("," vi-char)151.2
496.8 R(-search)-.2 E 2.5("-" pre)151.2 508.8 R(vious-history)-.25 E 2.5
("." vi-redo)151.2 520.8 R 2.5("/" vi-search)151.2 532.8 R 2.5("0" be)
151.2 544.8 R(ginning-of-line)-.15 E("1" to "9")151.2 556.8 Q(vi-ar)5 E
(g-digit)-.18 E 2.5(";" vi-char)151.2 568.8 R(-search)-.2 E 2.5
("=" vi-complete)151.2 580.8 R 2.5("?" vi-search)151.2 592.8 R 2.5
("A" vi-append-eol)151.2 604.8 R 2.5("B" vi-pre)151.2 616.8 R(v-w)-.25 E
(ord)-.1 E 2.5("C" vi-change-to)151.2 628.8 R 2.5("D" vi-delete-to)151.2
640.8 R 2.5("E" vi-end-w)151.2 652.8 R(ord)-.1 E 2.5("F" vi-char)151.2
664.8 R(-search)-.2 E 2.5("G" vi-fetch-history)151.2 676.8 R 2.5
("I" vi-insert-be)151.2 688.8 R(g)-.15 E 2.5("N" vi-search-ag)151.2
700.8 R(ain)-.05 E 2.5("P" vi-put)151.2 712.8 R 2.5("R" vi-replace)151.2
724.8 R(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(15)185.955
E 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("S" vi-subst)151.2
84 R 2.5("T" vi-char)151.2 96 R(-search)-.2 E 2.5("U" re)151.2 108 R
-.15(ve)-.25 G(rt-line).15 E 2.5("W" vi-ne)151.2 120 R(xt-w)-.15 E(ord)
-.1 E 2.5("X" backw)151.2 132 R(ard-delete-char)-.1 E 2.5
("Y" vi-yank-to)151.2 144 R 2.5("\\" vi-complete)151.2 156 R 2.5
("^" vi-\214rst-print)151.2 168 R 2.5("_" vi-yank-ar)151.2 180 R(g)-.18
E 2.5("`" vi-goto-mark)151.2 192 R 2.5("a" vi-append-mode)151.2 204 R
2.5("b" vi-pre)151.2 216 R(v-w)-.25 E(ord)-.1 E 2.5("c" vi-change-to)
151.2 228 R 2.5("d" vi-delete-to)151.2 240 R 2.5("e" vi-end-w)151.2 252
R(ord)-.1 E 2.5("f" vi-char)151.2 264 R(-search)-.2 E 2.5("h" backw)
151.2 276 R(ard-char)-.1 E 2.5("i" vi-insertion-mode)151.2 288 R 2.5
("j" ne)151.2 300 R(xt-history)-.15 E 2.5("k" pre)151.2 312 R(v-history)
-.25 E 2.5("l" forw)151.2 324 R(ard-char)-.1 E 2.5("m" vi-set-mark)151.2
336 R 2.5("n" vi-search-ag)151.2 348 R(ain)-.05 E 2.5("p" vi-put)151.2
360 R 2.5("r" vi-change-char)151.2 372 R 2.5("s" vi-subst)151.2 384 R
2.5("t" vi-char)151.2 396 R(-search)-.2 E 2.5("u" vi-undo)151.2 408 R
2.5("w" vi-ne)151.2 420 R(xt-w)-.15 E(ord)-.1 E 2.5("x" vi-delete)151.2
432 R 2.5("y" vi-yank-to)151.2 444 R 2.5("|" vi-column)151.2 456 R 2.5
("~" vi-change-case)151.2 468 R/F1 10.95/Times-Bold@0 SF(SEE ALSO)72
484.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 496.8 Q(ary)
-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F2
(The Gnu History Libr)108 508.8 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E
(ox and Chet Rame)-.15 E(y)-.15 E F2(bash)108 520.8 Q F0(\(1\))A F1
(FILES)72 537.6 Q F2(~/.inputr)109.666 549.6 Q(c)-.37 E F0(Indi)144
561.6 Q(vidual)-.25 E/F3 10/Times-Bold@0 SF -.18(re)2.5 G(adline).18 E
F0(initialization \214le)2.5 E F1 -.548(AU)72 578.4 S(THORS).548 E F0
(Brian F)108 590.4 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E
(bfox@gnu.or)108 602.4 Q(g)-.18 E(Chet Rame)108 619.2 Q 1.3 -.65(y, C)
-.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)
-.25 G(rsity).15 E(chet.rame)108 631.2 Q(y@case.edu)-.15 E F1 -.11(BU)72
648 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .69(If you \214nd a b)
108 660 R .69(ug in)-.2 F F3 -.18(re)3.19 G(adline,).18 E F0 .69
(you should report it.)3.19 F .691(But \214rst, you should mak)5.69 F
3.191(es)-.1 G .691(ure that it really is a b)-3.191 F(ug,)-.2 E
(and that it appears in the latest v)108 672 Q(ersion of the)-.15 E F3
-.18(re)2.5 G(adline).18 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.)
.15 E .705(Once you ha)108 688.8 R 1.005 -.15(ve d)-.2 H .705
(etermined that a b).15 F .704(ug actually e)-.2 F .704(xists, mail a b)
-.15 F .704(ug report to)-.2 F F2 -.2(bu)3.204 G(g\255r).2 E(eadline)
-.37 E F0(@)A F2(gnu.or)A(g)-.37 E F0 5.704(.I)C 3.204(fy)-5.704 G(ou)
-3.204 E(ha)108 700.8 Q 1.809 -.15(ve a \214)-.2 H 1.509
(x, you are welcome to mail that as well!).15 F 1.51
(Suggestions and `philosophical' b)6.51 F 1.51(ug reports may be)-.2 F
(mailed to)108 712.8 Q F2 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F2
(gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F3
(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 729.6 Q
(ug reports concerning this manual page should be directed to)-.2 E F2
-.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.).25 E
(GNU Readline 7.0)72 768 Q(2017 December 28)121.245 E(16)185.955 E 0 Cg
EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10.95/Times-Bold@0 SF
-.11(BU)72 84 S(GS).11 E F0(It')108 96 Q 2.5(st)-.55 G
(oo big and too slo)-2.5 E -.65(w.)-.25 G(GNU Readline 7.0)72 768 Q
(2017 December 28)121.245 E(17)185.955 E 0 Cg EP
%%Trailer
end
%%EOF