rluser.pot 124 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) YEAR Free Software Foundation, Inc.
  3. # This file is distributed under the same license as the PACKAGE package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: PACKAGE VERSION\n"
  10. "POT-Creation-Date: 2018-01-24 17:11+0100\n"
  11. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13. "Language-Team: LANGUAGE <LL@li.org>\n"
  14. "Language: \n"
  15. "MIME-Version: 1.0\n"
  16. "Content-Type: text/plain; charset=CHARSET\n"
  17. "Content-Transfer-Encoding: 8bit\n"
  18. #. type: chapter
  19. #: ./rluser.texi:42 ./rluser.texi:43
  20. #, no-wrap
  21. msgid "Command Line Editing"
  22. msgstr ""
  23. #. type: Plain text
  24. #: ./rluser.texi:47
  25. msgid ""
  26. "This chapter describes the basic features of the @sc{gnu} command line "
  27. "editing interface."
  28. msgstr ""
  29. #. type: ifset
  30. #: ./rluser.texi:60
  31. msgid ""
  32. "Command line editing is provided by the Readline library, which is used by "
  33. "several different programs, including Bash. Command line editing is enabled "
  34. "by default when using an interactive shell, unless the @option{--noediting} "
  35. "option is supplied at shell invocation. Line editing is also used when "
  36. "using the @option{-e} option to the @code{read} builtin command (@pxref{Bash "
  37. "Builtins}). By default, the line editing commands are similar to those of "
  38. "Emacs. A vi-style line editing interface is also available. Line editing "
  39. "can be enabled at any time using the @option{-o emacs} or @option{-o vi} "
  40. "options to the @code{set} builtin command (@pxref{The Set Builtin}), or "
  41. "disabled using the @option{+o emacs} or @option{+o vi} options to "
  42. "@code{set}."
  43. msgstr ""
  44. #. type: node
  45. #: ./rluser.texi:70 ./rluser.texi:80
  46. #, no-wrap
  47. msgid "Introduction and Notation"
  48. msgstr ""
  49. #. type: menuentry
  50. #: ./rluser.texi:70
  51. msgid "Notation used in this text."
  52. msgstr ""
  53. #. type: section
  54. #: ./rluser.texi:70 ./rluser.texi:118 ./rluser.texi:119
  55. #, no-wrap
  56. msgid "Readline Interaction"
  57. msgstr ""
  58. #. type: menuentry
  59. #: ./rluser.texi:70
  60. msgid "The minimum set of commands for editing a line."
  61. msgstr ""
  62. #. type: section
  63. #: ./rluser.texi:70 ./rluser.texi:334 ./rluser.texi:335
  64. #, no-wrap
  65. msgid "Readline Init File"
  66. msgstr ""
  67. #. type: menuentry
  68. #: ./rluser.texi:70
  69. msgid "Customizing Readline from a user's view."
  70. msgstr ""
  71. #. type: section
  72. #: ./rluser.texi:70 ./rluser.texi:1080 ./rluser.texi:1081
  73. #, no-wrap
  74. msgid "Bindable Readline Commands"
  75. msgstr ""
  76. #. type: menuentry
  77. #: ./rluser.texi:70
  78. msgid "A description of most of the Readline commands available for binding"
  79. msgstr ""
  80. #. type: section
  81. #: ./rluser.texi:70 ./rluser.texi:1746 ./rluser.texi:1747
  82. #, no-wrap
  83. msgid "Readline vi Mode"
  84. msgstr ""
  85. #. type: menuentry
  86. #: ./rluser.texi:70
  87. msgid "A short description of how to make Readline behave like the vi editor."
  88. msgstr ""
  89. #. type: ifset
  90. #: ./rluser.texi:77
  91. msgid ""
  92. "* Programmable Completion::\tHow to specify the possible completions for a "
  93. "specific command. * Programmable Completion Builtins::\tBuiltin commands to "
  94. "specify how to complete arguments for a particular command. * A "
  95. "Programmable Completion Example::\tAn example shell function for generating "
  96. "possible completions."
  97. msgstr ""
  98. #. type: section
  99. #: ./rluser.texi:81
  100. #, no-wrap
  101. msgid "Introduction to Line Editing"
  102. msgstr ""
  103. #. type: Plain text
  104. #: ./rluser.texi:85
  105. msgid "The following paragraphs describe the notation used to represent keystrokes."
  106. msgstr ""
  107. #. type: Plain text
  108. #: ./rluser.texi:89
  109. msgid ""
  110. "The text @kbd{C-k} is read as `Control-K' and describes the character "
  111. "produced when the @key{k} key is pressed while the Control key is depressed."
  112. msgstr ""
  113. #. type: Plain text
  114. #: ./rluser.texi:100
  115. msgid ""
  116. "The text @kbd{M-k} is read as `Meta-K' and describes the character produced "
  117. "when the Meta key (if you have one) is depressed, and the @key{k} key is "
  118. "pressed. The Meta key is labeled @key{ALT} on many keyboards. On keyboards "
  119. "with two keys labeled @key{ALT} (usually to either side of the space bar), "
  120. "the @key{ALT} on the left side is generally set to work as a Meta key. The "
  121. "@key{ALT} key on the right may also be configured to work as a Meta key or "
  122. "may be configured as some other modifier, such as a Compose key for typing "
  123. "accented characters."
  124. msgstr ""
  125. #. type: Plain text
  126. #: ./rluser.texi:105
  127. msgid ""
  128. "If you do not have a Meta or @key{ALT} key, or another key working as a Meta "
  129. "key, the identical keystroke can be generated by typing @key{ESC} "
  130. "@emph{first}, and then typing @key{k}. Either process is known as "
  131. "@dfn{metafying} the @key{k} key."
  132. msgstr ""
  133. #. type: Plain text
  134. #: ./rluser.texi:108
  135. msgid ""
  136. "The text @kbd{M-C-k} is read as `Meta-Control-k' and describes the character "
  137. "produced by @dfn{metafying} @kbd{C-k}."
  138. msgstr ""
  139. #. type: Plain text
  140. #: ./rluser.texi:117
  141. msgid ""
  142. "In addition, several keys have their own names. Specifically, @key{DEL}, "
  143. "@key{ESC}, @key{LFD}, @key{SPC}, @key{RET}, and @key{TAB} all stand for "
  144. "themselves when seen in this text, or in an init file (@pxref{Readline Init "
  145. "File}). If your keyboard lacks a @key{LFD} key, typing @key{C-j} will "
  146. "produce the desired character. The @key{RET} key may be labeled "
  147. "@key{Return} or @key{Enter} on some keyboards."
  148. msgstr ""
  149. #. type: cindex
  150. #: ./rluser.texi:120
  151. #, no-wrap
  152. msgid "interaction, readline"
  153. msgstr ""
  154. #. type: Plain text
  155. #: ./rluser.texi:132
  156. msgid ""
  157. "Often during an interactive session you type in a long line of text, only to "
  158. "notice that the first word on the line is misspelled. The Readline library "
  159. "gives you a set of commands for manipulating the text as you type it in, "
  160. "allowing you to just fix your typo, and not forcing you to retype the "
  161. "majority of the line. Using these editing commands, you move the cursor to "
  162. "the place that needs correction, and delete or insert the text of the "
  163. "corrections. Then, when you are satisfied with the line, you simply press "
  164. "@key{RET}. You do not have to be at the end of the line to press @key{RET}; "
  165. "the entire line is accepted regardless of the location of the cursor within "
  166. "the line."
  167. msgstr ""
  168. #. type: subsection
  169. #: ./rluser.texi:139 ./rluser.texi:141 ./rluser.texi:142
  170. #, no-wrap
  171. msgid "Readline Bare Essentials"
  172. msgstr ""
  173. #. type: menuentry
  174. #: ./rluser.texi:139
  175. msgid "The least you need to know about Readline."
  176. msgstr ""
  177. #. type: subsection
  178. #: ./rluser.texi:139 ./rluser.texi:187 ./rluser.texi:188
  179. #, no-wrap
  180. msgid "Readline Movement Commands"
  181. msgstr ""
  182. #. type: menuentry
  183. #: ./rluser.texi:139
  184. msgid "Moving about the input line."
  185. msgstr ""
  186. #. type: subsection
  187. #: ./rluser.texi:139 ./rluser.texi:214 ./rluser.texi:215
  188. #, no-wrap
  189. msgid "Readline Killing Commands"
  190. msgstr ""
  191. #. type: menuentry
  192. #: ./rluser.texi:139
  193. msgid "How to delete text, and how to get it back!"
  194. msgstr ""
  195. #. type: subsection
  196. #: ./rluser.texi:139 ./rluser.texi:271 ./rluser.texi:272
  197. #, no-wrap
  198. msgid "Readline Arguments"
  199. msgstr ""
  200. #. type: menuentry
  201. #: ./rluser.texi:139
  202. msgid "Giving numeric arguments to commands."
  203. msgstr ""
  204. #. type: node
  205. #: ./rluser.texi:139 ./rluser.texi:289
  206. #, no-wrap
  207. msgid "Searching"
  208. msgstr ""
  209. #. type: menuentry
  210. #: ./rluser.texi:139
  211. msgid "Searching through previous lines."
  212. msgstr ""
  213. #. type: cindex
  214. #: ./rluser.texi:143
  215. #, no-wrap
  216. msgid "notation, readline"
  217. msgstr ""
  218. #. type: cindex
  219. #: ./rluser.texi:144
  220. #, no-wrap
  221. msgid "command editing"
  222. msgstr ""
  223. #. type: cindex
  224. #: ./rluser.texi:145
  225. #, no-wrap
  226. msgid "editing command lines"
  227. msgstr ""
  228. #. type: Plain text
  229. #: ./rluser.texi:151
  230. msgid ""
  231. "In order to enter characters into the line, simply type them. The typed "
  232. "character appears where the cursor was, and then the cursor moves one space "
  233. "to the right. If you mistype a character, you can use your erase character "
  234. "to back up and delete the mistyped character."
  235. msgstr ""
  236. #. type: Plain text
  237. #: ./rluser.texi:157
  238. msgid ""
  239. "Sometimes you may mistype a character, and not notice the error until you "
  240. "have typed several other characters. In that case, you can type @kbd{C-b} "
  241. "to move the cursor to the left, and then correct your mistake. Afterwards, "
  242. "you can move the cursor to the right with @kbd{C-f}."
  243. msgstr ""
  244. #. type: Plain text
  245. #: ./rluser.texi:164
  246. msgid ""
  247. "When you add text in the middle of a line, you will notice that characters "
  248. "to the right of the cursor are `pushed over' to make room for the text that "
  249. "you have inserted. Likewise, when you delete text behind the cursor, "
  250. "characters to the right of the cursor are `pulled back' to fill in the blank "
  251. "space created by the removal of the text. A list of the bare essentials for "
  252. "editing the text of an input line follows."
  253. msgstr ""
  254. #. type: kbd{#1}
  255. #: ./rluser.texi:166
  256. #, no-wrap
  257. msgid "C-b"
  258. msgstr ""
  259. #. type: table
  260. #: ./rluser.texi:168
  261. msgid "Move back one character."
  262. msgstr ""
  263. #. type: kbd{#1}
  264. #: ./rluser.texi:168
  265. #, no-wrap
  266. msgid "C-f"
  267. msgstr ""
  268. #. type: table
  269. #: ./rluser.texi:170
  270. msgid "Move forward one character."
  271. msgstr ""
  272. #. type: item
  273. #: ./rluser.texi:170
  274. #, no-wrap
  275. msgid "@key{DEL} or @key{Backspace}"
  276. msgstr ""
  277. #. type: table
  278. #: ./rluser.texi:172
  279. msgid "Delete the character to the left of the cursor."
  280. msgstr ""
  281. #. type: kbd{#1}
  282. #: ./rluser.texi:172
  283. #, no-wrap
  284. msgid "C-d"
  285. msgstr ""
  286. #. type: table
  287. #: ./rluser.texi:174
  288. msgid "Delete the character underneath the cursor."
  289. msgstr ""
  290. #. type: w{#1}
  291. #: ./rluser.texi:174
  292. #, no-wrap
  293. msgid "Printing characters"
  294. msgstr ""
  295. #. type: table
  296. #: ./rluser.texi:176
  297. msgid "Insert the character into the line at the cursor."
  298. msgstr ""
  299. #. type: item
  300. #: ./rluser.texi:176
  301. #, no-wrap
  302. msgid "@kbd{C-_} or @kbd{C-x C-u}"
  303. msgstr ""
  304. #. type: table
  305. #: ./rluser.texi:179
  306. msgid ""
  307. "Undo the last editing command. You can undo all the way back to an empty "
  308. "line."
  309. msgstr ""
  310. #. type: Plain text
  311. #: ./rluser.texi:186
  312. msgid ""
  313. "(Depending on your configuration, the @key{Backspace} key be set to delete "
  314. "the character to the left of the cursor and the @key{DEL} key set to delete "
  315. "the character underneath the cursor, like @kbd{C-d}, rather than the "
  316. "character to the left of the cursor.)"
  317. msgstr ""
  318. #. type: Plain text
  319. #: ./rluser.texi:196
  320. msgid ""
  321. "The above table describes the most basic keystrokes that you need in order "
  322. "to do editing of the input line. For your convenience, many other commands "
  323. "have been added in addition to @kbd{C-b}, @kbd{C-f}, @kbd{C-d}, and "
  324. "@key{DEL}. Here are some commands for moving more rapidly about the line."
  325. msgstr ""
  326. #. type: item
  327. #: ./rluser.texi:198
  328. #, no-wrap
  329. msgid "C-a"
  330. msgstr ""
  331. #. type: table
  332. #: ./rluser.texi:200
  333. msgid "Move to the start of the line."
  334. msgstr ""
  335. #. type: item
  336. #: ./rluser.texi:200
  337. #, no-wrap
  338. msgid "C-e"
  339. msgstr ""
  340. #. type: Plain text
  341. #: ./rluser.texi:202 ./rluser.texi:1116
  342. msgid "Move to the end of the line."
  343. msgstr ""
  344. #. type: item
  345. #: ./rluser.texi:202
  346. #, no-wrap
  347. msgid "M-f"
  348. msgstr ""
  349. #. type: table
  350. #: ./rluser.texi:204
  351. msgid "Move forward a word, where a word is composed of letters and digits."
  352. msgstr ""
  353. #. type: item
  354. #: ./rluser.texi:204
  355. #, no-wrap
  356. msgid "M-b"
  357. msgstr ""
  358. #. type: table
  359. #: ./rluser.texi:206
  360. msgid "Move backward a word."
  361. msgstr ""
  362. #. type: item
  363. #: ./rluser.texi:206
  364. #, no-wrap
  365. msgid "C-l"
  366. msgstr ""
  367. #. type: table
  368. #: ./rluser.texi:208
  369. msgid "Clear the screen, reprinting the current line at the top."
  370. msgstr ""
  371. #. type: Plain text
  372. #: ./rluser.texi:213
  373. msgid ""
  374. "Notice how @kbd{C-f} moves forward a character, while @kbd{M-f} moves "
  375. "forward a word. It is a loose convention that control keystrokes operate on "
  376. "characters while meta keystrokes operate on words."
  377. msgstr ""
  378. #. type: cindex
  379. #: ./rluser.texi:217
  380. #, no-wrap
  381. msgid "killing text"
  382. msgstr ""
  383. #. type: cindex
  384. #: ./rluser.texi:218
  385. #, no-wrap
  386. msgid "yanking text"
  387. msgstr ""
  388. #. type: Plain text
  389. #: ./rluser.texi:224
  390. msgid ""
  391. "@dfn{Killing} text means to delete the text from the line, but to save it "
  392. "away for later use, usually by @dfn{yanking} (re-inserting) it back into "
  393. "the line. (`Cut' and `paste' are more recent jargon for `kill' and `yank'.)"
  394. msgstr ""
  395. #. type: Plain text
  396. #: ./rluser.texi:228
  397. msgid ""
  398. "If the description for a command says that it `kills' text, then you can be "
  399. "sure that you can get the text back in a different (or the same) place "
  400. "later."
  401. msgstr ""
  402. #. type: Plain text
  403. #: ./rluser.texi:235
  404. msgid ""
  405. "When you use a kill command, the text is saved in a @dfn{kill-ring}. Any "
  406. "number of consecutive kills save all of the killed text together, so that "
  407. "when you yank it back, you get it all. The kill ring is not line specific; "
  408. "the text that you killed on a previously typed line is available to be "
  409. "yanked back later, when you are typing another line."
  410. msgstr ""
  411. #. type: cindex
  412. #: ./rluser.texi:235
  413. #, no-wrap
  414. msgid "kill ring"
  415. msgstr ""
  416. #. type: Plain text
  417. #: ./rluser.texi:238
  418. msgid "Here is the list of commands for killing text."
  419. msgstr ""
  420. #. type: item
  421. #: ./rluser.texi:240
  422. #, no-wrap
  423. msgid "C-k"
  424. msgstr ""
  425. #. type: table
  426. #: ./rluser.texi:242
  427. msgid "Kill the text from the current cursor position to the end of the line."
  428. msgstr ""
  429. #. type: item
  430. #: ./rluser.texi:243
  431. #, no-wrap
  432. msgid "M-d"
  433. msgstr ""
  434. #. type: table
  435. #: ./rluser.texi:247
  436. msgid ""
  437. "Kill from the cursor to the end of the current word, or, if between words, "
  438. "to the end of the next word. Word boundaries are the same as those used by "
  439. "@kbd{M-f}."
  440. msgstr ""
  441. #. type: item
  442. #: ./rluser.texi:248
  443. #, no-wrap
  444. msgid "M-@key{DEL}"
  445. msgstr ""
  446. #. type: table
  447. #: ./rluser.texi:252
  448. msgid ""
  449. "Kill from the cursor the start of the current word, or, if between words, to "
  450. "the start of the previous word. Word boundaries are the same as those used "
  451. "by @kbd{M-b}."
  452. msgstr ""
  453. #. type: item
  454. #: ./rluser.texi:253
  455. #, no-wrap
  456. msgid "C-w"
  457. msgstr ""
  458. #. type: table
  459. #: ./rluser.texi:256
  460. msgid ""
  461. "Kill from the cursor to the previous whitespace. This is different than "
  462. "@kbd{M-@key{DEL}} because the word boundaries differ."
  463. msgstr ""
  464. #. type: Plain text
  465. #: ./rluser.texi:261
  466. msgid ""
  467. "Here is how to @dfn{yank} the text back into the line. Yanking means to "
  468. "copy the most-recently-killed text from the kill buffer."
  469. msgstr ""
  470. #. type: item
  471. #: ./rluser.texi:263
  472. #, no-wrap
  473. msgid "C-y"
  474. msgstr ""
  475. #. type: table
  476. #: ./rluser.texi:265
  477. msgid "Yank the most recently killed text back into the buffer at the cursor."
  478. msgstr ""
  479. #. type: item
  480. #: ./rluser.texi:266
  481. #, no-wrap
  482. msgid "M-y"
  483. msgstr ""
  484. #. type: table
  485. #: ./rluser.texi:269
  486. msgid ""
  487. "Rotate the kill-ring, and yank the new top. You can only do this if the "
  488. "prior command is @kbd{C-y} or @kbd{M-y}."
  489. msgstr ""
  490. #. type: Plain text
  491. #: ./rluser.texi:280
  492. msgid ""
  493. "You can pass numeric arguments to Readline commands. Sometimes the argument "
  494. "acts as a repeat count, other times it is the @i{sign} of the argument that "
  495. "is significant. If you pass a negative argument to a command which normally "
  496. "acts in a forward direction, that command will act in a backward direction. "
  497. "For example, to kill text back to the start of the line, you might type "
  498. "@samp{M-- C-k}."
  499. msgstr ""
  500. #. type: Plain text
  501. #: ./rluser.texi:288
  502. msgid ""
  503. "The general way to pass numeric arguments to a command is to type meta "
  504. "digits before the command. If the first `digit' typed is a minus sign "
  505. "(@samp{-}), then the sign of the argument will be negative. Once you have "
  506. "typed one meta digit to get the argument started, you can type the remainder "
  507. "of the digits, and then the command. For example, to give the @kbd{C-d} "
  508. "command an argument of 10, you could type @samp{M-1 0 C-d}, which will "
  509. "delete the next ten characters on the input line."
  510. msgstr ""
  511. #. type: subsection
  512. #: ./rluser.texi:290
  513. #, no-wrap
  514. msgid "Searching for Commands in the History"
  515. msgstr ""
  516. #. type: Plain text
  517. #: ./rluser.texi:293
  518. msgid "Readline provides commands for searching through the command history"
  519. msgstr ""
  520. #. type: ifset
  521. #: ./rluser.texi:295
  522. msgid "(@pxref{Bash History Facilities})"
  523. msgstr ""
  524. #. type: Plain text
  525. #: ./rluser.texi:298
  526. msgid ""
  527. "for lines containing a specified string. There are two search modes: "
  528. "@dfn{incremental} and @dfn{non-incremental}."
  529. msgstr ""
  530. #. type: Plain text
  531. #: ./rluser.texi:314
  532. msgid ""
  533. "Incremental searches begin before the user has finished typing the search "
  534. "string. As each character of the search string is typed, Readline displays "
  535. "the next entry from the history matching the string typed so far. An "
  536. "incremental search requires only as many characters as needed to find the "
  537. "desired history entry. To search backward in the history for a particular "
  538. "string, type @kbd{C-r}. Typing @kbd{C-s} searches forward through the "
  539. "history. The characters present in the value of the "
  540. "@code{isearch-terminators} variable are used to terminate an incremental "
  541. "search. If that variable has not been assigned a value, the @key{ESC} and "
  542. "@kbd{C-J} characters will terminate an incremental search. @kbd{C-g} will "
  543. "abort an incremental search and restore the original line. When the search "
  544. "is terminated, the history entry containing the search string becomes the "
  545. "current line."
  546. msgstr ""
  547. #. type: Plain text
  548. #: ./rluser.texi:325
  549. msgid ""
  550. "To find other matching entries in the history list, type @kbd{C-r} or "
  551. "@kbd{C-s} as appropriate. This will search backward or forward in the "
  552. "history for the next entry matching the search string typed so far. Any "
  553. "other key sequence bound to a Readline command will terminate the search and "
  554. "execute that command. For instance, a @key{RET} will terminate the search "
  555. "and accept the line, thereby executing the command from the history list. A "
  556. "movement command will terminate the search, make the last line found the "
  557. "current line, and begin editing."
  558. msgstr ""
  559. #. type: Plain text
  560. #: ./rluser.texi:329
  561. msgid ""
  562. "Readline remembers the last incremental search string. If two @kbd{C-r}s "
  563. "are typed without any intervening characters defining a new search string, "
  564. "any remembered search string is used."
  565. msgstr ""
  566. #. type: Plain text
  567. #: ./rluser.texi:333
  568. msgid ""
  569. "Non-incremental searches read the entire search string before starting to "
  570. "search for matching history lines. The search string may be typed by the "
  571. "user or be part of the contents of the current line."
  572. msgstr ""
  573. #. type: cindex
  574. #: ./rluser.texi:336
  575. #, no-wrap
  576. msgid "initialization file, readline"
  577. msgstr ""
  578. #. type: Plain text
  579. #: ./rluser.texi:344
  580. msgid ""
  581. "Although the Readline library comes with a set of Emacs-like keybindings "
  582. "installed by default, it is possible to use a different set of keybindings. "
  583. "Any user can customize programs that use Readline by putting commands in an "
  584. "@dfn{inputrc} file, conventionally in his home directory. The name of this"
  585. msgstr ""
  586. #. type: ifset
  587. #: ./rluser.texi:346
  588. msgid "file is taken from the value of the shell variable @env{INPUTRC}. If"
  589. msgstr ""
  590. #. type: ifclear
  591. #: ./rluser.texi:349
  592. msgid "file is taken from the value of the environment variable @env{INPUTRC}. If"
  593. msgstr ""
  594. #. type: Plain text
  595. #: ./rluser.texi:353
  596. msgid ""
  597. "that variable is unset, the default is @file{~/.inputrc}. If that file does "
  598. "not exist or cannot be read, the ultimate default is @file{/etc/inputrc}."
  599. msgstr ""
  600. #. type: Plain text
  601. #: ./rluser.texi:356
  602. msgid ""
  603. "When a program which uses the Readline library starts up, the init file is "
  604. "read, and the key bindings are set."
  605. msgstr ""
  606. #. type: Plain text
  607. #: ./rluser.texi:359
  608. msgid ""
  609. "In addition, the @code{C-x C-r} command re-reads this init file, thus "
  610. "incorporating any changes that you might have made to it."
  611. msgstr ""
  612. #. type: subsection
  613. #: ./rluser.texi:362 ./rluser.texi:368 ./rluser.texi:369
  614. #, no-wrap
  615. msgid "Readline Init File Syntax"
  616. msgstr ""
  617. #. type: menuentry
  618. #: ./rluser.texi:362
  619. msgid "Syntax for the commands in the inputrc file."
  620. msgstr ""
  621. #. type: subsection
  622. #: ./rluser.texi:364 ./rluser.texi:905 ./rluser.texi:906
  623. #, no-wrap
  624. msgid "Conditional Init Constructs"
  625. msgstr ""
  626. #. type: menuentry
  627. #: ./rluser.texi:364
  628. msgid "Conditional key bindings in the inputrc file."
  629. msgstr ""
  630. #. type: subsection
  631. #: ./rluser.texi:366 ./rluser.texi:971 ./rluser.texi:972
  632. #, no-wrap
  633. msgid "Sample Init File"
  634. msgstr ""
  635. #. type: menuentry
  636. #: ./rluser.texi:366
  637. msgid "An example inputrc file."
  638. msgstr ""
  639. #. type: Plain text
  640. #: ./rluser.texi:377
  641. msgid ""
  642. "There are only a few basic constructs allowed in the Readline init file. "
  643. "Blank lines are ignored. Lines beginning with a @samp{#} are comments. "
  644. "Lines beginning with a @samp{$} indicate conditional constructs "
  645. "(@pxref{Conditional Init Constructs}). Other lines denote variable settings "
  646. "and key bindings."
  647. msgstr ""
  648. #. type: item
  649. #: ./rluser.texi:379
  650. #, no-wrap
  651. msgid "Variable Settings"
  652. msgstr ""
  653. #. type: table
  654. #: ./rluser.texi:384
  655. msgid ""
  656. "You can modify the run-time behavior of Readline by altering the values of "
  657. "variables in Readline using the @code{set} command within the init file. "
  658. "The syntax is simple:"
  659. msgstr ""
  660. #. type: example
  661. #: ./rluser.texi:387
  662. #, no-wrap
  663. msgid "set @var{variable} @var{value}\n"
  664. msgstr ""
  665. #. type: table
  666. #: ./rluser.texi:393
  667. msgid ""
  668. "Here, for example, is how to change from the default Emacs-like key binding "
  669. "to use @code{vi} line editing commands:"
  670. msgstr ""
  671. #. type: example
  672. #: ./rluser.texi:396
  673. #, no-wrap
  674. msgid "set editing-mode vi\n"
  675. msgstr ""
  676. #. type: table
  677. #: ./rluser.texi:400
  678. msgid ""
  679. "Variable names and values, where appropriate, are recognized without regard "
  680. "to case. Unrecognized variable names are ignored."
  681. msgstr ""
  682. #. type: table
  683. #: ./rluser.texi:404
  684. msgid ""
  685. "Boolean variables (those that can be set to on or off) are set to on if the "
  686. "value is null or empty, @var{on} (case-insensitive), or 1. Any other value "
  687. "results in the variable being set to off."
  688. msgstr ""
  689. #. type: ifset
  690. #: ./rluser.texi:408
  691. msgid ""
  692. "The @w{@code{bind -V}} command lists the current Readline variable names and "
  693. "values. @xref{Bash Builtins}."
  694. msgstr ""
  695. #. type: table
  696. #: ./rluser.texi:412
  697. msgid ""
  698. "A great deal of run-time behavior is changeable with the following "
  699. "variables."
  700. msgstr ""
  701. #. type: cindex
  702. #: ./rluser.texi:413
  703. #, no-wrap
  704. msgid "variables, readline"
  705. msgstr ""
  706. #. type: vindex
  707. #: ./rluser.texi:416 ./rluser.texi:417
  708. #, no-wrap
  709. msgid "bell-style"
  710. msgstr ""
  711. #. type: table
  712. #: ./rluser.texi:423
  713. msgid ""
  714. "Controls what happens when Readline wants to ring the terminal bell. If set "
  715. "to @samp{none}, Readline never rings the bell. If set to @samp{visible}, "
  716. "Readline uses a visible bell if one is available. If set to @samp{audible} "
  717. "(the default), Readline attempts to ring the terminal's bell."
  718. msgstr ""
  719. #. type: vindex
  720. #: ./rluser.texi:424 ./rluser.texi:425
  721. #, no-wrap
  722. msgid "bind-tty-special-chars"
  723. msgstr ""
  724. #. type: table
  725. #: ./rluser.texi:429
  726. msgid ""
  727. "If set to @samp{on} (the default), Readline attempts to bind the control "
  728. "characters treated specially by the kernel's terminal driver to their "
  729. "Readline equivalents."
  730. msgstr ""
  731. #. type: vindex
  732. #: ./rluser.texi:430 ./rluser.texi:431
  733. #, no-wrap
  734. msgid "blink-matching-paren"
  735. msgstr ""
  736. #. type: table
  737. #: ./rluser.texi:435
  738. msgid ""
  739. "If set to @samp{on}, Readline attempts to briefly move the cursor to an "
  740. "opening parenthesis when a closing parenthesis is inserted. The default is "
  741. "@samp{off}."
  742. msgstr ""
  743. #. type: vindex
  744. #: ./rluser.texi:436 ./rluser.texi:437
  745. #, no-wrap
  746. msgid "colored-completion-prefix"
  747. msgstr ""
  748. #. type: table
  749. #: ./rluser.texi:443
  750. msgid ""
  751. "If set to @samp{on}, when listing completions, Readline displays the common "
  752. "prefix of the set of possible completions using a different color. The "
  753. "color definitions are taken from the value of the @env{LS_COLORS} "
  754. "environment variable. The default is @samp{off}."
  755. msgstr ""
  756. #. type: vindex
  757. #: ./rluser.texi:444 ./rluser.texi:445
  758. #, no-wrap
  759. msgid "colored-stats"
  760. msgstr ""
  761. #. type: table
  762. #: ./rluser.texi:451
  763. msgid ""
  764. "If set to @samp{on}, Readline displays possible completions using different "
  765. "colors to indicate their file type. The color definitions are taken from "
  766. "the value of the @env{LS_COLORS} environment variable. The default is "
  767. "@samp{off}."
  768. msgstr ""
  769. #. type: vindex
  770. #: ./rluser.texi:452 ./rluser.texi:453
  771. #, no-wrap
  772. msgid "comment-begin"
  773. msgstr ""
  774. #. type: table
  775. #: ./rluser.texi:457
  776. msgid ""
  777. "The string to insert at the beginning of the line when the "
  778. "@code{insert-comment} command is executed. The default value is "
  779. "@code{\"#\"}."
  780. msgstr ""
  781. #. type: vindex
  782. #: ./rluser.texi:458 ./rluser.texi:459
  783. #, no-wrap
  784. msgid "completion-display-width"
  785. msgstr ""
  786. #. type: table
  787. #: ./rluser.texi:466
  788. msgid ""
  789. "The number of screen columns used to display possible matches when "
  790. "performing completion. The value is ignored if it is less than 0 or greater "
  791. "than the terminal screen width. A value of 0 will cause matches to be "
  792. "displayed one per line. The default value is -1."
  793. msgstr ""
  794. #. type: vindex
  795. #: ./rluser.texi:467 ./rluser.texi:468
  796. #, no-wrap
  797. msgid "completion-ignore-case"
  798. msgstr ""
  799. #. type: table
  800. #: ./rluser.texi:472
  801. msgid ""
  802. "If set to @samp{on}, Readline performs filename matching and completion in a "
  803. "case-insensitive fashion. The default value is @samp{off}."
  804. msgstr ""
  805. #. type: vindex
  806. #: ./rluser.texi:473 ./rluser.texi:474
  807. #, no-wrap
  808. msgid "completion-map-case"
  809. msgstr ""
  810. #. type: table
  811. #: ./rluser.texi:478
  812. msgid ""
  813. "If set to @samp{on}, and @var{completion-ignore-case} is enabled, Readline "
  814. "treats hyphens (@samp{-}) and underscores (@samp{_}) as equivalent when "
  815. "performing case-insensitive filename matching and completion."
  816. msgstr ""
  817. #. type: vindex
  818. #: ./rluser.texi:479 ./rluser.texi:480
  819. #, no-wrap
  820. msgid "completion-prefix-display-length"
  821. msgstr ""
  822. #. type: table
  823. #: ./rluser.texi:485
  824. msgid ""
  825. "The length in characters of the common prefix of a list of possible "
  826. "completions that is displayed without modification. When set to a value "
  827. "greater than zero, common prefixes longer than this value are replaced with "
  828. "an ellipsis when displaying possible completions."
  829. msgstr ""
  830. #. type: vindex
  831. #: ./rluser.texi:486 ./rluser.texi:487
  832. #, no-wrap
  833. msgid "completion-query-items"
  834. msgstr ""
  835. #. type: table
  836. #: ./rluser.texi:496
  837. msgid ""
  838. "The number of possible completions that determines when the user is asked "
  839. "whether the list of possibilities should be displayed. If the number of "
  840. "possible completions is greater than this value, Readline will ask the user "
  841. "whether or not he wishes to view them; otherwise, they are simply listed. "
  842. "This variable must be set to an integer value greater than or equal to 0. A "
  843. "negative value means Readline should never ask. The default limit is "
  844. "@code{100}."
  845. msgstr ""
  846. #. type: vindex
  847. #: ./rluser.texi:497 ./rluser.texi:498
  848. #, no-wrap
  849. msgid "convert-meta"
  850. msgstr ""
  851. #. type: table
  852. #: ./rluser.texi:505
  853. msgid ""
  854. "If set to @samp{on}, Readline will convert characters with the eighth bit "
  855. "set to an @sc{ascii} key sequence by stripping the eighth bit and prefixing "
  856. "an @key{ESC} character, converting them to a meta-prefixed key sequence. "
  857. "The default value is @samp{on}, but will be set to @samp{off} if the locale "
  858. "is one that contains eight-bit characters."
  859. msgstr ""
  860. #. type: vindex
  861. #: ./rluser.texi:506 ./rluser.texi:507
  862. #, no-wrap
  863. msgid "disable-completion"
  864. msgstr ""
  865. #. type: table
  866. #: ./rluser.texi:511
  867. msgid ""
  868. "If set to @samp{On}, Readline will inhibit word completion. Completion "
  869. "characters will be inserted into the line as if they had been mapped to "
  870. "@code{self-insert}. The default is @samp{off}."
  871. msgstr ""
  872. #. type: vindex
  873. #: ./rluser.texi:512 ./rluser.texi:513
  874. #, no-wrap
  875. msgid "echo-control-characters"
  876. msgstr ""
  877. #. type: table
  878. #: ./rluser.texi:517
  879. msgid ""
  880. "When set to @samp{on}, on operating systems that indicate they support it, "
  881. "readline echoes a character corresponding to a signal generated from the "
  882. "keyboard. The default is @samp{on}."
  883. msgstr ""
  884. #. type: vindex
  885. #: ./rluser.texi:518 ./rluser.texi:519
  886. #, no-wrap
  887. msgid "editing-mode"
  888. msgstr ""
  889. #. type: table
  890. #: ./rluser.texi:524
  891. msgid ""
  892. "The @code{editing-mode} variable controls which default set of key bindings "
  893. "is used. By default, Readline starts up in Emacs editing mode, where the "
  894. "keystrokes are most similar to Emacs. This variable can be set to either "
  895. "@samp{emacs} or @samp{vi}."
  896. msgstr ""
  897. #. type: vindex
  898. #: ./rluser.texi:525 ./rluser.texi:526
  899. #, no-wrap
  900. msgid "emacs-mode-string"
  901. msgstr ""
  902. #. type: table
  903. #: ./rluser.texi:535
  904. msgid ""
  905. "This string is displayed immediately before the last line of the primary "
  906. "prompt when emacs editing mode is active. The value is expanded like a key "
  907. "binding, so the standard set of meta- and control prefixes and backslash "
  908. "escape sequences is available. Use the @samp{\\1} and @samp{\\2} escapes to "
  909. "begin and end sequences of non-printing characters, which can be used to "
  910. "embed a terminal control sequence into the mode string. The default is "
  911. "@samp{@@}."
  912. msgstr ""
  913. #. type: vindex
  914. #: ./rluser.texi:536 ./rluser.texi:537
  915. #, no-wrap
  916. msgid "enable-bracketed-paste"
  917. msgstr ""
  918. #. type: table
  919. #: ./rluser.texi:543
  920. msgid ""
  921. "When set to @samp{On}, Readline will configure the terminal in a way that "
  922. "will enable it to insert each paste into the editing buffer as a single "
  923. "string of characters, instead of treating each character as if it had been "
  924. "read from the keyboard. This can prevent pasted characters from being "
  925. "interpreted as editing commands. The default is @samp{off}."
  926. msgstr ""
  927. #. type: vindex
  928. #: ./rluser.texi:544 ./rluser.texi:545
  929. #, no-wrap
  930. msgid "enable-keypad"
  931. msgstr ""
  932. #. type: table
  933. #: ./rluser.texi:549
  934. msgid ""
  935. "When set to @samp{on}, Readline will try to enable the application keypad "
  936. "when it is called. Some systems need this to enable the arrow keys. The "
  937. "default is @samp{off}."
  938. msgstr ""
  939. #. type: item
  940. #: ./rluser.texi:550
  941. #, no-wrap
  942. msgid "enable-meta-key"
  943. msgstr ""
  944. #. type: table
  945. #: ./rluser.texi:555
  946. msgid ""
  947. "When set to @samp{on}, Readline will try to enable any meta modifier key the "
  948. "terminal claims to support when it is called. On many terminals, the meta "
  949. "key is used to send eight-bit characters. The default is @samp{on}."
  950. msgstr ""
  951. #. type: vindex
  952. #: ./rluser.texi:556 ./rluser.texi:557
  953. #, no-wrap
  954. msgid "expand-tilde"
  955. msgstr ""
  956. #. type: table
  957. #: ./rluser.texi:560
  958. msgid ""
  959. "If set to @samp{on}, tilde expansion is performed when Readline attempts "
  960. "word completion. The default is @samp{off}."
  961. msgstr ""
  962. #. type: vindex
  963. #: ./rluser.texi:561 ./rluser.texi:562
  964. #, no-wrap
  965. msgid "history-preserve-point"
  966. msgstr ""
  967. #. type: table
  968. #: ./rluser.texi:567
  969. msgid ""
  970. "If set to @samp{on}, the history code attempts to place the point (the "
  971. "current cursor position) at the same location on each history line retrieved "
  972. "with @code{previous-history} or @code{next-history}. The default is "
  973. "@samp{off}."
  974. msgstr ""
  975. #. type: vindex
  976. #: ./rluser.texi:568 ./rluser.texi:569
  977. #, no-wrap
  978. msgid "history-size"
  979. msgstr ""
  980. #. type: table
  981. #: ./rluser.texi:578
  982. msgid ""
  983. "Set the maximum number of history entries saved in the history list. If set "
  984. "to zero, any existing history entries are deleted and no new entries are "
  985. "saved. If set to a value less than zero, the number of history entries is "
  986. "not limited. By default, the number of history entries is not limited. If "
  987. "an attempt is made to set @var{history-size} to a non-numeric value, the "
  988. "maximum number of history entries will be set to 500."
  989. msgstr ""
  990. #. type: vindex
  991. #: ./rluser.texi:579 ./rluser.texi:580
  992. #, no-wrap
  993. msgid "horizontal-scroll-mode"
  994. msgstr ""
  995. #. type: table
  996. #: ./rluser.texi:586
  997. msgid ""
  998. "This variable can be set to either @samp{on} or @samp{off}. Setting it to "
  999. "@samp{on} means that the text of the lines being edited will scroll "
  1000. "horizontally on a single screen line when they are longer than the width of "
  1001. "the screen, instead of wrapping onto a new screen line. By default, this "
  1002. "variable is set to @samp{off}."
  1003. msgstr ""
  1004. #. type: vindex
  1005. #: ./rluser.texi:587 ./rluser.texi:588
  1006. #, no-wrap
  1007. msgid "input-meta"
  1008. msgstr ""
  1009. #. type: vindex
  1010. #: ./rluser.texi:589
  1011. #, no-wrap
  1012. msgid "meta-flag"
  1013. msgstr ""
  1014. #. type: table
  1015. #: ./rluser.texi:596
  1016. msgid ""
  1017. "If set to @samp{on}, Readline will enable eight-bit input (it will not clear "
  1018. "the eighth bit in the characters it reads), regardless of what the terminal "
  1019. "claims it can support. The default value is @samp{off}, but Readline will "
  1020. "set it to @samp{on} if the locale contains eight-bit characters. The name "
  1021. "@code{meta-flag} is a synonym for this variable."
  1022. msgstr ""
  1023. #. type: vindex
  1024. #: ./rluser.texi:597 ./rluser.texi:598
  1025. #, no-wrap
  1026. msgid "isearch-terminators"
  1027. msgstr ""
  1028. #. type: table
  1029. #: ./rluser.texi:603
  1030. msgid ""
  1031. "The string of characters that should terminate an incremental search without "
  1032. "subsequently executing the character as a command (@pxref{Searching}). If "
  1033. "this variable has not been given a value, the characters @key{ESC} and "
  1034. "@kbd{C-J} will terminate an incremental search."
  1035. msgstr ""
  1036. #. type: vindex
  1037. #: ./rluser.texi:604 ./rluser.texi:605
  1038. #, no-wrap
  1039. msgid "keymap"
  1040. msgstr ""
  1041. #. type: table
  1042. #: ./rluser.texi:621
  1043. msgid ""
  1044. "Sets Readline's idea of the current keymap for key binding commands. "
  1045. "Acceptable @code{keymap} names are @code{emacs}, @code{emacs-standard}, "
  1046. "@code{emacs-meta}, @code{emacs-ctlx}, @code{vi}, @code{vi-move}, "
  1047. "@code{vi-command}, and @code{vi-insert}. @code{vi} is equivalent to "
  1048. "@code{vi-command} (@code{vi-move} is also a synonym); @code{emacs} is "
  1049. "equivalent to @code{emacs-standard}. The default value is @code{emacs}. "
  1050. "The value of the @code{editing-mode} variable also affects the default "
  1051. "keymap."
  1052. msgstr ""
  1053. #. type: item
  1054. #: ./rluser.texi:622
  1055. #, no-wrap
  1056. msgid "keyseq-timeout"
  1057. msgstr ""
  1058. #. type: table
  1059. #: ./rluser.texi:637
  1060. msgid ""
  1061. "Specifies the duration Readline will wait for a character when reading an "
  1062. "ambiguous key sequence (one that can form a complete key sequence using the "
  1063. "input read so far, or can take additional input to complete a longer key "
  1064. "sequence). If no input is received within the timeout, Readline will use "
  1065. "the shorter but complete key sequence. Readline uses this value to "
  1066. "determine whether or not input is available on the current input source "
  1067. "(@code{rl_instream} by default). The value is specified in milliseconds, so "
  1068. "a value of 1000 means that Readline will wait one second for additional "
  1069. "input. If this variable is set to a value less than or equal to zero, or to "
  1070. "a non-numeric value, Readline will wait until another key is pressed to "
  1071. "decide which key sequence to complete. The default value is @code{500}."
  1072. msgstr ""
  1073. #. type: item
  1074. #: ./rluser.texi:638
  1075. #, no-wrap
  1076. msgid "mark-directories"
  1077. msgstr ""
  1078. #. type: table
  1079. #: ./rluser.texi:641
  1080. msgid ""
  1081. "If set to @samp{on}, completed directory names have a slash appended. The "
  1082. "default is @samp{on}."
  1083. msgstr ""
  1084. #. type: vindex
  1085. #: ./rluser.texi:642 ./rluser.texi:643
  1086. #, no-wrap
  1087. msgid "mark-modified-lines"
  1088. msgstr ""
  1089. #. type: table
  1090. #: ./rluser.texi:647
  1091. msgid ""
  1092. "This variable, when set to @samp{on}, causes Readline to display an asterisk "
  1093. "(@samp{*}) at the start of history lines which have been modified. This "
  1094. "variable is @samp{off} by default."
  1095. msgstr ""
  1096. #. type: vindex
  1097. #: ./rluser.texi:648 ./rluser.texi:649
  1098. #, no-wrap
  1099. msgid "mark-symlinked-directories"
  1100. msgstr ""
  1101. #. type: table
  1102. #: ./rluser.texi:654
  1103. msgid ""
  1104. "If set to @samp{on}, completed names which are symbolic links to directories "
  1105. "have a slash appended (subject to the value of @code{mark-directories}). "
  1106. "The default is @samp{off}."
  1107. msgstr ""
  1108. #. type: vindex
  1109. #: ./rluser.texi:655 ./rluser.texi:656
  1110. #, no-wrap
  1111. msgid "match-hidden-files"
  1112. msgstr ""
  1113. #. type: table
  1114. #: ./rluser.texi:663
  1115. msgid ""
  1116. "This variable, when set to @samp{on}, causes Readline to match files whose "
  1117. "names begin with a @samp{.} (hidden files) when performing filename "
  1118. "completion. If set to @samp{off}, the leading @samp{.} must be supplied by "
  1119. "the user in the filename to be completed. This variable is @samp{on} by "
  1120. "default."
  1121. msgstr ""
  1122. #. type: vindex
  1123. #: ./rluser.texi:664 ./rluser.texi:665
  1124. #, no-wrap
  1125. msgid "menu-complete-display-prefix"
  1126. msgstr ""
  1127. #. type: table
  1128. #: ./rluser.texi:669
  1129. msgid ""
  1130. "If set to @samp{on}, menu completion displays the common prefix of the list "
  1131. "of possible completions (which may be empty) before cycling through the "
  1132. "list. The default is @samp{off}."
  1133. msgstr ""
  1134. #. type: vindex
  1135. #: ./rluser.texi:670 ./rluser.texi:671
  1136. #, no-wrap
  1137. msgid "output-meta"
  1138. msgstr ""
  1139. #. type: table
  1140. #: ./rluser.texi:677
  1141. msgid ""
  1142. "If set to @samp{on}, Readline will display characters with the eighth bit "
  1143. "set directly rather than as a meta-prefixed escape sequence. The default is "
  1144. "@samp{off}, but Readline will set it to @samp{on} if the locale contains "
  1145. "eight-bit characters."
  1146. msgstr ""
  1147. #. type: vindex
  1148. #: ./rluser.texi:678 ./rluser.texi:679
  1149. #, no-wrap
  1150. msgid "page-completions"
  1151. msgstr ""
  1152. #. type: table
  1153. #: ./rluser.texi:683
  1154. msgid ""
  1155. "If set to @samp{on}, Readline uses an internal @code{more}-like pager to "
  1156. "display a screenful of possible completions at a time. This variable is "
  1157. "@samp{on} by default."
  1158. msgstr ""
  1159. #. type: item
  1160. #: ./rluser.texi:684
  1161. #, no-wrap
  1162. msgid "print-completions-horizontally"
  1163. msgstr ""
  1164. #. type: table
  1165. #: ./rluser.texi:688
  1166. msgid ""
  1167. "If set to @samp{on}, Readline will display completions with matches sorted "
  1168. "horizontally in alphabetical order, rather than down the screen. The "
  1169. "default is @samp{off}."
  1170. msgstr ""
  1171. #. type: vindex
  1172. #: ./rluser.texi:689 ./rluser.texi:690
  1173. #, no-wrap
  1174. msgid "revert-all-at-newline"
  1175. msgstr ""
  1176. #. type: table
  1177. #: ./rluser.texi:695
  1178. msgid ""
  1179. "If set to @samp{on}, Readline will undo all changes to history lines before "
  1180. "returning when @code{accept-line} is executed. By default, history lines "
  1181. "may be modified and retain individual undo lists across calls to "
  1182. "@code{readline}. The default is @samp{off}."
  1183. msgstr ""
  1184. #. type: vindex
  1185. #: ./rluser.texi:696 ./rluser.texi:697
  1186. #, no-wrap
  1187. msgid "show-all-if-ambiguous"
  1188. msgstr ""
  1189. #. type: table
  1190. #: ./rluser.texi:703
  1191. msgid ""
  1192. "This alters the default behavior of the completion functions. If set to "
  1193. "@samp{on}, words which have more than one possible completion cause the "
  1194. "matches to be listed immediately instead of ringing the bell. The default "
  1195. "value is @samp{off}."
  1196. msgstr ""
  1197. #. type: vindex
  1198. #: ./rluser.texi:704 ./rluser.texi:705
  1199. #, no-wrap
  1200. msgid "show-all-if-unmodified"
  1201. msgstr ""
  1202. #. type: table
  1203. #: ./rluser.texi:714
  1204. msgid ""
  1205. "This alters the default behavior of the completion functions in a fashion "
  1206. "similar to @var{show-all-if-ambiguous}. If set to @samp{on}, words which "
  1207. "have more than one possible completion without any possible partial "
  1208. "completion (the possible completions don't share a common prefix) cause the "
  1209. "matches to be listed immediately instead of ringing the bell. The default "
  1210. "value is @samp{off}."
  1211. msgstr ""
  1212. #. type: vindex
  1213. #: ./rluser.texi:715 ./rluser.texi:716
  1214. #, no-wrap
  1215. msgid "show-mode-in-prompt"
  1216. msgstr ""
  1217. #. type: table
  1218. #: ./rluser.texi:721
  1219. msgid ""
  1220. "If set to @samp{on}, add a character to the beginning of the prompt "
  1221. "indicating the editing mode: emacs, vi command, or vi insertion. The mode "
  1222. "strings are user-settable. The default value is @samp{off}."
  1223. msgstr ""
  1224. #. type: vindex
  1225. #: ./rluser.texi:722 ./rluser.texi:723
  1226. #, no-wrap
  1227. msgid "skip-completed-text"
  1228. msgstr ""
  1229. #. type: table
  1230. #: ./rluser.texi:735
  1231. msgid ""
  1232. "If set to @samp{on}, this alters the default completion behavior when "
  1233. "inserting a single match into the line. It's only active when performing "
  1234. "completion in the middle of a word. If enabled, readline does not insert "
  1235. "characters from the completion that match characters after point in the word "
  1236. "being completed, so portions of the word following the cursor are not "
  1237. "duplicated. For instance, if this is enabled, attempting completion when "
  1238. "the cursor is after the @samp{e} in @samp{Makefile} will result in "
  1239. "@samp{Makefile} rather than @samp{Makefilefile}, assuming there is a single "
  1240. "possible completion. The default value is @samp{off}."
  1241. msgstr ""
  1242. #. type: vindex
  1243. #: ./rluser.texi:736 ./rluser.texi:737
  1244. #, no-wrap
  1245. msgid "vi-cmd-mode-string"
  1246. msgstr ""
  1247. #. type: table
  1248. #: ./rluser.texi:747
  1249. msgid ""
  1250. "This string is displayed immediately before the last line of the primary "
  1251. "prompt when vi editing mode is active and in command mode. The value is "
  1252. "expanded like a key binding, so the standard set of meta- and control "
  1253. "prefixes and backslash escape sequences is available. Use the @samp{\\1} "
  1254. "and @samp{\\2} escapes to begin and end sequences of non-printing "
  1255. "characters, which can be used to embed a terminal control sequence into the "
  1256. "mode string. The default is @samp{(cmd)}."
  1257. msgstr ""
  1258. #. type: vindex
  1259. #: ./rluser.texi:748 ./rluser.texi:749
  1260. #, no-wrap
  1261. msgid "vi-ins-mode-string"
  1262. msgstr ""
  1263. #. type: table
  1264. #: ./rluser.texi:759
  1265. msgid ""
  1266. "This string is displayed immediately before the last line of the primary "
  1267. "prompt when vi editing mode is active and in insertion mode. The value is "
  1268. "expanded like a key binding, so the standard set of meta- and control "
  1269. "prefixes and backslash escape sequences is available. Use the @samp{\\1} "
  1270. "and @samp{\\2} escapes to begin and end sequences of non-printing "
  1271. "characters, which can be used to embed a terminal control sequence into the "
  1272. "mode string. The default is @samp{(ins)}."
  1273. msgstr ""
  1274. #. type: vindex
  1275. #: ./rluser.texi:760 ./rluser.texi:761
  1276. #, no-wrap
  1277. msgid "visible-stats"
  1278. msgstr ""
  1279. #. type: table
  1280. #: ./rluser.texi:765
  1281. msgid ""
  1282. "If set to @samp{on}, a character denoting a file's type is appended to the "
  1283. "filename when listing possible completions. The default is @samp{off}."
  1284. msgstr ""
  1285. #. type: item
  1286. #: ./rluser.texi:768
  1287. #, no-wrap
  1288. msgid "Key Bindings"
  1289. msgstr ""
  1290. #. type: table
  1291. #: ./rluser.texi:774
  1292. msgid ""
  1293. "The syntax for controlling key bindings in the init file is simple. First "
  1294. "you need to find the name of the command that you want to change. The "
  1295. "following sections contain tables of the command name, the default "
  1296. "keybinding, if any, and a short description of what the command does."
  1297. msgstr ""
  1298. #. type: table
  1299. #: ./rluser.texi:783
  1300. msgid ""
  1301. "Once you know the name of the command, simply place on a line in the init "
  1302. "file the name of the key you wish to bind the command to, a colon, and then "
  1303. "the name of the command. There can be no space between the key name and the "
  1304. "colon -- that will be interpreted as part of the key name. The name of the "
  1305. "key can be expressed in different ways, depending on what you find most "
  1306. "comfortable."
  1307. msgstr ""
  1308. #. type: table
  1309. #: ./rluser.texi:786
  1310. msgid ""
  1311. "In addition to command names, readline allows keys to be bound to a string "
  1312. "that is inserted when the key is pressed (a @var{macro})."
  1313. msgstr ""
  1314. #. type: ifset
  1315. #: ./rluser.texi:791
  1316. msgid ""
  1317. "The @w{@code{bind -p}} command displays Readline function names and bindings "
  1318. "in a format that can put directly into an initialization file. @xref{Bash "
  1319. "Builtins}."
  1320. msgstr ""
  1321. #. type: w{#1}
  1322. #: ./rluser.texi:794
  1323. #, no-wrap
  1324. msgid "@var{keyname}: @var{function-name} or @var{macro}"
  1325. msgstr ""
  1326. #. type: table
  1327. #: ./rluser.texi:796
  1328. msgid "@var{keyname} is the name of a key spelled out in English. For example:"
  1329. msgstr ""
  1330. #. type: example
  1331. #: ./rluser.texi:800
  1332. #, no-wrap
  1333. msgid ""
  1334. "Control-u: universal-argument\n"
  1335. "Meta-Rubout: backward-kill-word\n"
  1336. "Control-o: \"> output\"\n"
  1337. msgstr ""
  1338. #. type: table
  1339. #: ./rluser.texi:808
  1340. msgid ""
  1341. "In the above example, @kbd{C-u} is bound to the function "
  1342. "@code{universal-argument}, @kbd{M-DEL} is bound to the function "
  1343. "@code{backward-kill-word}, and @kbd{C-o} is bound to run the macro expressed "
  1344. "on the right hand side (that is, to insert the text @samp{> output} into the "
  1345. "line)."
  1346. msgstr ""
  1347. #. type: table
  1348. #: ./rluser.texi:823
  1349. msgid ""
  1350. "A number of symbolic character names are recognized while processing this "
  1351. "key binding syntax: @var{DEL}, @var{ESC}, @var{ESCAPE}, @var{LFD}, "
  1352. "@var{NEWLINE}, @var{RET}, @var{RETURN}, @var{RUBOUT}, @var{SPACE}, "
  1353. "@var{SPC}, and @var{TAB}."
  1354. msgstr ""
  1355. #. type: w{#1}
  1356. #: ./rluser.texi:824
  1357. #, no-wrap
  1358. msgid "\"@var{keyseq}\": @var{function-name} or @var{macro}"
  1359. msgstr ""
  1360. #. type: table
  1361. #: ./rluser.texi:830
  1362. msgid ""
  1363. "@var{keyseq} differs from @var{keyname} above in that strings denoting an "
  1364. "entire key sequence can be specified, by placing the key sequence in double "
  1365. "quotes. Some @sc{gnu} Emacs style key escapes can be used, as in the "
  1366. "following example, but the special character names are not recognized."
  1367. msgstr ""
  1368. #. type: example
  1369. #: ./rluser.texi:835
  1370. #, no-wrap
  1371. msgid ""
  1372. "\"\\C-u\": universal-argument\n"
  1373. "\"\\C-x\\C-r\": re-read-init-file\n"
  1374. "\"\\e[11~\": \"Function Key 1\"\n"
  1375. msgstr ""
  1376. #. type: table
  1377. #: ./rluser.texi:842
  1378. msgid ""
  1379. "In the above example, @kbd{C-u} is again bound to the function "
  1380. "@code{universal-argument} (just as it was in the first example), "
  1381. "@samp{@kbd{C-x} @kbd{C-r}} is bound to the function "
  1382. "@code{re-read-init-file}, and @samp{@key{ESC} @key{[} @key{1} @key{1} "
  1383. "@key{~}} is bound to insert the text @samp{Function Key 1}."
  1384. msgstr ""
  1385. #. type: table
  1386. #: ./rluser.texi:847
  1387. msgid ""
  1388. "The following @sc{gnu} Emacs style escape sequences are available when "
  1389. "specifying key sequences:"
  1390. msgstr ""
  1391. #. type: kbd{#1}
  1392. #: ./rluser.texi:849
  1393. #, no-wrap
  1394. msgid "\\C-"
  1395. msgstr ""
  1396. #. type: table
  1397. #: ./rluser.texi:851
  1398. msgid "control prefix"
  1399. msgstr ""
  1400. #. type: kbd{#1}
  1401. #: ./rluser.texi:851
  1402. #, no-wrap
  1403. msgid "\\M-"
  1404. msgstr ""
  1405. #. type: table
  1406. #: ./rluser.texi:853
  1407. msgid "meta prefix"
  1408. msgstr ""
  1409. #. type: kbd{#1}
  1410. #: ./rluser.texi:853
  1411. #, no-wrap
  1412. msgid "\\e"
  1413. msgstr ""
  1414. #. type: table
  1415. #: ./rluser.texi:855
  1416. msgid "an escape character"
  1417. msgstr ""
  1418. #. type: kbd{#1}
  1419. #: ./rluser.texi:855
  1420. #, no-wrap
  1421. msgid "\\\\"
  1422. msgstr ""
  1423. #. type: table
  1424. #: ./rluser.texi:857
  1425. msgid "backslash"
  1426. msgstr ""
  1427. #. type: kbd{#1}
  1428. #: ./rluser.texi:857
  1429. #, no-wrap
  1430. msgid "\\\""
  1431. msgstr ""
  1432. #. type: table
  1433. #: ./rluser.texi:859
  1434. msgid "@key{\"}, a double quotation mark"
  1435. msgstr ""
  1436. #. type: kbd{#1}
  1437. #: ./rluser.texi:859
  1438. #, no-wrap
  1439. msgid "\\'"
  1440. msgstr ""
  1441. #. type: table
  1442. #: ./rluser.texi:861
  1443. msgid "@key{'}, a single quote or apostrophe"
  1444. msgstr ""
  1445. #. type: table
  1446. #: ./rluser.texi:865
  1447. msgid ""
  1448. "In addition to the @sc{gnu} Emacs style escape sequences, a second set of "
  1449. "backslash escapes is available:"
  1450. msgstr ""
  1451. #. type: item
  1452. #: ./rluser.texi:867
  1453. #, no-wrap
  1454. msgid "\\a"
  1455. msgstr ""
  1456. #. type: table
  1457. #: ./rluser.texi:869
  1458. msgid "alert (bell)"
  1459. msgstr ""
  1460. #. type: item
  1461. #: ./rluser.texi:869
  1462. #, no-wrap
  1463. msgid "\\b"
  1464. msgstr ""
  1465. #. type: table
  1466. #: ./rluser.texi:871
  1467. msgid "backspace"
  1468. msgstr ""
  1469. #. type: item
  1470. #: ./rluser.texi:871
  1471. #, no-wrap
  1472. msgid "\\d"
  1473. msgstr ""
  1474. #. type: table
  1475. #: ./rluser.texi:873
  1476. msgid "delete"
  1477. msgstr ""
  1478. #. type: item
  1479. #: ./rluser.texi:873
  1480. #, no-wrap
  1481. msgid "\\f"
  1482. msgstr ""
  1483. #. type: table
  1484. #: ./rluser.texi:875
  1485. msgid "form feed"
  1486. msgstr ""
  1487. #. type: item
  1488. #: ./rluser.texi:875
  1489. #, no-wrap
  1490. msgid "\\n"
  1491. msgstr ""
  1492. #. type: table
  1493. #: ./rluser.texi:877
  1494. msgid "newline"
  1495. msgstr ""
  1496. #. type: item
  1497. #: ./rluser.texi:877
  1498. #, no-wrap
  1499. msgid "\\r"
  1500. msgstr ""
  1501. #. type: table
  1502. #: ./rluser.texi:879
  1503. msgid "carriage return"
  1504. msgstr ""
  1505. #. type: item
  1506. #: ./rluser.texi:879
  1507. #, no-wrap
  1508. msgid "\\t"
  1509. msgstr ""
  1510. #. type: table
  1511. #: ./rluser.texi:881
  1512. msgid "horizontal tab"
  1513. msgstr ""
  1514. #. type: item
  1515. #: ./rluser.texi:881
  1516. #, no-wrap
  1517. msgid "\\v"
  1518. msgstr ""
  1519. #. type: table
  1520. #: ./rluser.texi:883
  1521. msgid "vertical tab"
  1522. msgstr ""
  1523. #. type: item
  1524. #: ./rluser.texi:883
  1525. #, no-wrap
  1526. msgid "\\@var{nnn}"
  1527. msgstr ""
  1528. #. type: table
  1529. #: ./rluser.texi:886
  1530. msgid ""
  1531. "the eight-bit character whose value is the octal value @var{nnn} (one to "
  1532. "three digits)"
  1533. msgstr ""
  1534. #. type: item
  1535. #: ./rluser.texi:886
  1536. #, no-wrap
  1537. msgid "\\x@var{HH}"
  1538. msgstr ""
  1539. #. type: table
  1540. #: ./rluser.texi:889
  1541. msgid ""
  1542. "the eight-bit character whose value is the hexadecimal value @var{HH} (one "
  1543. "or two hex digits)"
  1544. msgstr ""
  1545. #. type: table
  1546. #: ./rluser.texi:899
  1547. msgid ""
  1548. "When entering the text of a macro, single or double quotes must be used to "
  1549. "indicate a macro definition. Unquoted text is assumed to be a function "
  1550. "name. In the macro body, the backslash escapes described above are "
  1551. "expanded. Backslash will quote any other character in the macro text, "
  1552. "including @samp{\"} and @samp{'}. For example, the following binding will "
  1553. "make @samp{@kbd{C-x} \\} insert a single @samp{\\} into the line:"
  1554. msgstr ""
  1555. #. type: example
  1556. #: ./rluser.texi:901
  1557. #, no-wrap
  1558. msgid "\"\\C-x\\\\\": \"\\\\\"\n"
  1559. msgstr ""
  1560. #. type: Plain text
  1561. #: ./rluser.texi:912
  1562. msgid ""
  1563. "Readline implements a facility similar in spirit to the conditional "
  1564. "compilation features of the C preprocessor which allows key bindings and "
  1565. "variable settings to be performed as the result of tests. There are four "
  1566. "parser directives used."
  1567. msgstr ""
  1568. #. type: item
  1569. #: ./rluser.texi:914
  1570. #, no-wrap
  1571. msgid "$if"
  1572. msgstr ""
  1573. #. type: table
  1574. #: ./rluser.texi:919
  1575. msgid ""
  1576. "The @code{$if} construct allows bindings to be made based on the editing "
  1577. "mode, the terminal being used, or the application using Readline. The text "
  1578. "of the test extends to the end of the line; no characters are required to "
  1579. "isolate it."
  1580. msgstr ""
  1581. #. type: item
  1582. #: ./rluser.texi:921
  1583. #, no-wrap
  1584. msgid "mode"
  1585. msgstr ""
  1586. #. type: table
  1587. #: ./rluser.texi:928
  1588. msgid ""
  1589. "The @code{mode=} form of the @code{$if} directive is used to test whether "
  1590. "Readline is in @code{emacs} or @code{vi} mode. This may be used in "
  1591. "conjunction with the @samp{set keymap} command, for instance, to set "
  1592. "bindings in the @code{emacs-standard} and @code{emacs-ctlx} keymaps only if "
  1593. "Readline is starting out in @code{emacs} mode."
  1594. msgstr ""
  1595. #. type: item
  1596. #: ./rluser.texi:929
  1597. #, no-wrap
  1598. msgid "term"
  1599. msgstr ""
  1600. #. type: table
  1601. #: ./rluser.texi:937
  1602. msgid ""
  1603. "The @code{term=} form may be used to include terminal-specific key bindings, "
  1604. "perhaps to bind the key sequences output by the terminal's function keys. "
  1605. "The word on the right side of the @samp{=} is tested against both the full "
  1606. "name of the terminal and the portion of the terminal name before the first "
  1607. "@samp{-}. This allows @code{sun} to match both @code{sun} and "
  1608. "@code{sun-cmd}, for instance."
  1609. msgstr ""
  1610. #. type: item
  1611. #: ./rluser.texi:938
  1612. #, no-wrap
  1613. msgid "application"
  1614. msgstr ""
  1615. #. type: table
  1616. #: ./rluser.texi:946
  1617. msgid ""
  1618. "The @var{application} construct is used to include application-specific "
  1619. "settings. Each program using the Readline library sets the @var{application "
  1620. "name}, and you can test for a particular value. This could be used to bind "
  1621. "key sequences to functions useful for a specific program. For instance, the "
  1622. "following command adds a key sequence that quotes the current or previous "
  1623. "word in Bash:"
  1624. msgstr ""
  1625. #. type: example
  1626. #: ./rluser.texi:951
  1627. #, no-wrap
  1628. msgid ""
  1629. "$if Bash\n"
  1630. "# Quote the current or previous word\n"
  1631. "\"\\C-xq\": \"\\eb\\\"\\ef\\\"\"\n"
  1632. "$endif\n"
  1633. msgstr ""
  1634. #. type: item
  1635. #: ./rluser.texi:954
  1636. #, no-wrap
  1637. msgid "$endif"
  1638. msgstr ""
  1639. #. type: table
  1640. #: ./rluser.texi:957
  1641. msgid ""
  1642. "This command, as seen in the previous example, terminates an @code{$if} "
  1643. "command."
  1644. msgstr ""
  1645. #. type: item
  1646. #: ./rluser.texi:958
  1647. #, no-wrap
  1648. msgid "$else"
  1649. msgstr ""
  1650. #. type: table
  1651. #: ./rluser.texi:961
  1652. msgid ""
  1653. "Commands in this branch of the @code{$if} directive are executed if the test "
  1654. "fails."
  1655. msgstr ""
  1656. #. type: item
  1657. #: ./rluser.texi:962
  1658. #, no-wrap
  1659. msgid "$include"
  1660. msgstr ""
  1661. #. type: table
  1662. #: ./rluser.texi:966
  1663. msgid ""
  1664. "This directive takes a single filename as an argument and reads commands and "
  1665. "bindings from that file. For example, the following directive reads from "
  1666. "@file{/etc/inputrc}:"
  1667. msgstr ""
  1668. #. type: example
  1669. #: ./rluser.texi:968
  1670. #, no-wrap
  1671. msgid "$include /etc/inputrc\n"
  1672. msgstr ""
  1673. #. type: Plain text
  1674. #: ./rluser.texi:976
  1675. msgid ""
  1676. "Here is an example of an @var{inputrc} file. This illustrates key binding, "
  1677. "variable assignment, and conditional syntax."
  1678. msgstr ""
  1679. #. type: example
  1680. #: ./rluser.texi:989
  1681. #, no-wrap
  1682. msgid ""
  1683. "# This file controls the behaviour of line input editing for\n"
  1684. "# programs that use the GNU Readline library. Existing\n"
  1685. "# programs include FTP, Bash, and GDB.\n"
  1686. "#\n"
  1687. "# You can re-read the inputrc file with C-x C-r.\n"
  1688. "# Lines beginning with '#' are comments.\n"
  1689. "#\n"
  1690. "# First, include any system-wide bindings and variable\n"
  1691. "# assignments from /etc/Inputrc\n"
  1692. "$include /etc/Inputrc\n"
  1693. "\n"
  1694. msgstr ""
  1695. #. type: example
  1696. #: ./rluser.texi:992
  1697. #, no-wrap
  1698. msgid ""
  1699. "#\n"
  1700. "# Set various bindings for emacs mode.\n"
  1701. "\n"
  1702. msgstr ""
  1703. #. type: example
  1704. #: ./rluser.texi:994
  1705. #, no-wrap
  1706. msgid ""
  1707. "set editing-mode emacs \n"
  1708. "\n"
  1709. msgstr ""
  1710. #. type: example
  1711. #: ./rluser.texi:996
  1712. #, no-wrap
  1713. msgid ""
  1714. "$if mode=emacs\n"
  1715. "\n"
  1716. msgstr ""
  1717. #. type: example
  1718. #: ./rluser.texi:998
  1719. #, no-wrap
  1720. msgid ""
  1721. "Meta-Control-h:\tbackward-kill-word\tText after the function name is "
  1722. "ignored\n"
  1723. "\n"
  1724. msgstr ""
  1725. #. type: example
  1726. #: ./rluser.texi:1027
  1727. #, no-wrap
  1728. msgid ""
  1729. "#\n"
  1730. "# Arrow keys in keypad mode\n"
  1731. "#\n"
  1732. "#\"\\M-OD\": backward-char\n"
  1733. "#\"\\M-OC\": forward-char\n"
  1734. "#\"\\M-OA\": previous-history\n"
  1735. "#\"\\M-OB\": next-history\n"
  1736. "#\n"
  1737. "# Arrow keys in ANSI mode\n"
  1738. "#\n"
  1739. "\"\\M-[D\": backward-char\n"
  1740. "\"\\M-[C\": forward-char\n"
  1741. "\"\\M-[A\": previous-history\n"
  1742. "\"\\M-[B\": next-history\n"
  1743. "#\n"
  1744. "# Arrow keys in 8 bit keypad mode\n"
  1745. "#\n"
  1746. "#\"\\M-\\C-OD\": backward-char\n"
  1747. "#\"\\M-\\C-OC\": forward-char\n"
  1748. "#\"\\M-\\C-OA\": previous-history\n"
  1749. "#\"\\M-\\C-OB\": next-history\n"
  1750. "#\n"
  1751. "# Arrow keys in 8 bit ANSI mode\n"
  1752. "#\n"
  1753. "#\"\\M-\\C-[D\": backward-char\n"
  1754. "#\"\\M-\\C-[C\": forward-char\n"
  1755. "#\"\\M-\\C-[A\": previous-history\n"
  1756. "#\"\\M-\\C-[B\": next-history\n"
  1757. "\n"
  1758. msgstr ""
  1759. #. type: example
  1760. #: ./rluser.texi:1029
  1761. #, no-wrap
  1762. msgid ""
  1763. "C-q: quoted-insert\n"
  1764. "\n"
  1765. msgstr ""
  1766. #. type: example
  1767. #: ./rluser.texi:1031
  1768. #, no-wrap
  1769. msgid ""
  1770. "$endif\n"
  1771. "\n"
  1772. msgstr ""
  1773. #. type: example
  1774. #: ./rluser.texi:1034
  1775. #, no-wrap
  1776. msgid ""
  1777. "# An old-style binding. This happens to be the default.\n"
  1778. "TAB: complete\n"
  1779. "\n"
  1780. msgstr ""
  1781. #. type: example
  1782. #: ./rluser.texi:1053
  1783. #, no-wrap
  1784. msgid ""
  1785. "# Macros that are convenient for shell interaction\n"
  1786. "$if Bash\n"
  1787. "# edit the path\n"
  1788. "\"\\C-xp\": \"PATH=$@{PATH@}\\e\\C-e\\C-a\\ef\\C-f\"\n"
  1789. "# prepare to type a quoted word --\n"
  1790. "# insert open and close double quotes\n"
  1791. "# and move to just after the open quote\n"
  1792. "\"\\C-x\\\"\": \"\\\"\\\"\\C-b\"\n"
  1793. "# insert a backslash (testing backslash escapes\n"
  1794. "# in sequences and macros)\n"
  1795. "\"\\C-x\\\\\": \"\\\\\"\n"
  1796. "# Quote the current or previous word\n"
  1797. "\"\\C-xq\": \"\\eb\\\"\\ef\\\"\"\n"
  1798. "# Add a binding to refresh the line, which is unbound\n"
  1799. "\"\\C-xr\": redraw-current-line\n"
  1800. "# Edit variable on current line.\n"
  1801. "\"\\M-\\C-v\": \"\\C-a\\C-k$\\C-y\\M-\\C-e\\C-a\\C-y=\"\n"
  1802. "$endif\n"
  1803. "\n"
  1804. msgstr ""
  1805. #. type: example
  1806. #: ./rluser.texi:1056
  1807. #, no-wrap
  1808. msgid ""
  1809. "# use a visible bell if one is available\n"
  1810. "set bell-style visible\n"
  1811. "\n"
  1812. msgstr ""
  1813. #. type: example
  1814. #: ./rluser.texi:1059
  1815. #, no-wrap
  1816. msgid ""
  1817. "# don't strip characters to 7 bits when reading\n"
  1818. "set input-meta on\n"
  1819. "\n"
  1820. msgstr ""
  1821. #. type: example
  1822. #: ./rluser.texi:1063
  1823. #, no-wrap
  1824. msgid ""
  1825. "# allow iso-latin1 characters to be inserted rather\n"
  1826. "# than converted to prefix-meta sequences\n"
  1827. "set convert-meta off\n"
  1828. "\n"
  1829. msgstr ""
  1830. #. type: example
  1831. #: ./rluser.texi:1067
  1832. #, no-wrap
  1833. msgid ""
  1834. "# display characters with the eighth bit set directly\n"
  1835. "# rather than as meta-prefixed characters\n"
  1836. "set output-meta on\n"
  1837. "\n"
  1838. msgstr ""
  1839. #. type: example
  1840. #: ./rluser.texi:1071
  1841. #, no-wrap
  1842. msgid ""
  1843. "# if there are more than 150 possible completions for\n"
  1844. "# a word, ask the user if he wants to see all of them\n"
  1845. "set completion-query-items 150\n"
  1846. "\n"
  1847. msgstr ""
  1848. #. type: example
  1849. #: ./rluser.texi:1078
  1850. #, no-wrap
  1851. msgid ""
  1852. "# For FTP\n"
  1853. "$if Ftp\n"
  1854. "\"\\C-xg\": \"get \\M-?\"\n"
  1855. "\"\\C-xt\": \"put \\M-?\"\n"
  1856. "\"\\M-.\": yank-last-arg\n"
  1857. "$endif\n"
  1858. msgstr ""
  1859. #. type: subsection
  1860. #: ./rluser.texi:1092 ./rluser.texi:1108 ./rluser.texi:1109
  1861. #, no-wrap
  1862. msgid "Commands For Moving"
  1863. msgstr ""
  1864. #. type: menuentry
  1865. #: ./rluser.texi:1092
  1866. msgid "Moving about the line."
  1867. msgstr ""
  1868. #. type: node
  1869. #: ./rluser.texi:1092 ./rluser.texi:1150
  1870. #, no-wrap
  1871. msgid "Commands For History"
  1872. msgstr ""
  1873. #. type: menuentry
  1874. #: ./rluser.texi:1092
  1875. msgid "Getting at previous lines."
  1876. msgstr ""
  1877. #. type: node
  1878. #: ./rluser.texi:1092 ./rluser.texi:1258
  1879. #, no-wrap
  1880. msgid "Commands For Text"
  1881. msgstr ""
  1882. #. type: menuentry
  1883. #: ./rluser.texi:1092
  1884. msgid "Commands for changing text."
  1885. msgstr ""
  1886. #. type: node
  1887. #: ./rluser.texi:1092 ./rluser.texi:1345
  1888. #, no-wrap
  1889. msgid "Commands For Killing"
  1890. msgstr ""
  1891. #. type: menuentry
  1892. #: ./rluser.texi:1092
  1893. msgid "Commands for killing and yanking."
  1894. msgstr ""
  1895. #. type: node
  1896. #: ./rluser.texi:1092 ./rluser.texi:1421
  1897. #, no-wrap
  1898. msgid "Numeric Arguments"
  1899. msgstr ""
  1900. #. type: menuentry
  1901. #: ./rluser.texi:1092
  1902. msgid "Specifying numeric arguments, repeat counts."
  1903. msgstr ""
  1904. #. type: node
  1905. #: ./rluser.texi:1092 ./rluser.texi:1444
  1906. #, no-wrap
  1907. msgid "Commands For Completion"
  1908. msgstr ""
  1909. #. type: menuentry
  1910. #: ./rluser.texi:1092
  1911. msgid "Getting Readline to do the typing for you."
  1912. msgstr ""
  1913. #. type: subsection
  1914. #: ./rluser.texi:1092 ./rluser.texi:1559 ./rluser.texi:1560
  1915. #, no-wrap
  1916. msgid "Keyboard Macros"
  1917. msgstr ""
  1918. #. type: menuentry
  1919. #: ./rluser.texi:1092
  1920. msgid "Saving and re-executing typed characters"
  1921. msgstr ""
  1922. #. type: node
  1923. #: ./rluser.texi:1092 ./rluser.texi:1580
  1924. #, no-wrap
  1925. msgid "Miscellaneous Commands"
  1926. msgstr ""
  1927. #. type: menuentry
  1928. #: ./rluser.texi:1092
  1929. msgid "Other miscellaneous commands."
  1930. msgstr ""
  1931. #. type: Plain text
  1932. #: ./rluser.texi:1096
  1933. msgid "This section describes Readline commands that may be bound to key sequences."
  1934. msgstr ""
  1935. #. type: ifset
  1936. #: ./rluser.texi:1100
  1937. msgid ""
  1938. "You can list your key bindings by executing @w{@code{bind -P}} or, for a "
  1939. "more terse format, suitable for an @var{inputrc} file, @w{@code{bind -p}}. "
  1940. "(@xref{Bash Builtins}.)"
  1941. msgstr ""
  1942. #. type: Plain text
  1943. #: ./rluser.texi:1102
  1944. msgid "Command names without an accompanying key sequence are unbound by default."
  1945. msgstr ""
  1946. #. type: Plain text
  1947. #: ./rluser.texi:1107
  1948. msgid ""
  1949. "In the following descriptions, @dfn{point} refers to the current cursor "
  1950. "position, and @dfn{mark} refers to a cursor position saved by the "
  1951. "@code{set-mark} command. The text between the point and mark is referred to "
  1952. "as the @dfn{region}."
  1953. msgstr ""
  1954. #. type: Plain text
  1955. #: ./rluser.texi:1111 ./rluser.texi:1154 ./rluser.texi:1262 ./rluser.texi:1349 ./rluser.texi:1424 ./rluser.texi:1448 ./rluser.texi:1562 ./rluser.texi:1583
  1956. msgid "@ftable @code"
  1957. msgstr ""
  1958. #. type: item
  1959. #: ./rluser.texi:1111
  1960. #, no-wrap
  1961. msgid "beginning-of-line (C-a)"
  1962. msgstr ""
  1963. #. type: Plain text
  1964. #: ./rluser.texi:1113
  1965. msgid "Move to the start of the current line."
  1966. msgstr ""
  1967. #. type: item
  1968. #: ./rluser.texi:1114
  1969. #, no-wrap
  1970. msgid "end-of-line (C-e)"
  1971. msgstr ""
  1972. #. type: item
  1973. #: ./rluser.texi:1117
  1974. #, no-wrap
  1975. msgid "forward-char (C-f)"
  1976. msgstr ""
  1977. #. type: Plain text
  1978. #: ./rluser.texi:1119
  1979. msgid "Move forward a character."
  1980. msgstr ""
  1981. #. type: item
  1982. #: ./rluser.texi:1120
  1983. #, no-wrap
  1984. msgid "backward-char (C-b)"
  1985. msgstr ""
  1986. #. type: Plain text
  1987. #: ./rluser.texi:1122
  1988. msgid "Move back a character."
  1989. msgstr ""
  1990. #. type: item
  1991. #: ./rluser.texi:1123
  1992. #, no-wrap
  1993. msgid "forward-word (M-f)"
  1994. msgstr ""
  1995. #. type: Plain text
  1996. #: ./rluser.texi:1126
  1997. msgid ""
  1998. "Move forward to the end of the next word. Words are composed of letters and "
  1999. "digits."
  2000. msgstr ""
  2001. #. type: item
  2002. #: ./rluser.texi:1127
  2003. #, no-wrap
  2004. msgid "backward-word (M-b)"
  2005. msgstr ""
  2006. #. type: Plain text
  2007. #: ./rluser.texi:1130
  2008. msgid ""
  2009. "Move back to the start of the current or previous word. Words are composed "
  2010. "of letters and digits."
  2011. msgstr ""
  2012. #. type: item
  2013. #: ./rluser.texi:1132
  2014. #, no-wrap
  2015. msgid "shell-forward-word ()"
  2016. msgstr ""
  2017. #. type: ifset
  2018. #: ./rluser.texi:1135
  2019. msgid ""
  2020. "Move forward to the end of the next word. Words are delimited by non-quoted "
  2021. "shell metacharacters."
  2022. msgstr ""
  2023. #. type: item
  2024. #: ./rluser.texi:1136
  2025. #, no-wrap
  2026. msgid "shell-backward-word ()"
  2027. msgstr ""
  2028. #. type: ifset
  2029. #: ./rluser.texi:1139
  2030. msgid ""
  2031. "Move back to the start of the current or previous word. Words are delimited "
  2032. "by non-quoted shell metacharacters."
  2033. msgstr ""
  2034. #. type: item
  2035. #: ./rluser.texi:1141
  2036. #, no-wrap
  2037. msgid "clear-screen (C-l)"
  2038. msgstr ""
  2039. #. type: Plain text
  2040. #: ./rluser.texi:1144
  2041. msgid ""
  2042. "Clear the screen and redraw the current line, leaving the current line at "
  2043. "the top of the screen."
  2044. msgstr ""
  2045. #. type: item
  2046. #: ./rluser.texi:1145
  2047. #, no-wrap
  2048. msgid "redraw-current-line ()"
  2049. msgstr ""
  2050. #. type: Plain text
  2051. #: ./rluser.texi:1147
  2052. msgid "Refresh the current line. By default, this is unbound."
  2053. msgstr ""
  2054. #. type: subsection
  2055. #: ./rluser.texi:1151
  2056. #, no-wrap
  2057. msgid "Commands For Manipulating The History"
  2058. msgstr ""
  2059. #. type: item
  2060. #: ./rluser.texi:1154
  2061. #, no-wrap
  2062. msgid "accept-line (Newline or Return)"
  2063. msgstr ""
  2064. #. type: ifset
  2065. #: ./rluser.texi:1162
  2066. msgid ""
  2067. "Accept the line regardless of where the cursor is. If this line is "
  2068. "non-empty, add it to the history list according to the setting of the "
  2069. "@env{HISTCONTROL} and @env{HISTIGNORE} variables. If this line is a "
  2070. "modified history line, then restore the history line to its original state."
  2071. msgstr ""
  2072. #. type: ifclear
  2073. #: ./rluser.texi:1170
  2074. msgid ""
  2075. "Accept the line regardless of where the cursor is. If this line is "
  2076. "non-empty, it may be added to the history list for future recall with "
  2077. "@code{add_history()}. If this line is a modified history line, the history "
  2078. "line is restored to its original state."
  2079. msgstr ""
  2080. #. type: item
  2081. #: ./rluser.texi:1172
  2082. #, no-wrap
  2083. msgid "previous-history (C-p)"
  2084. msgstr ""
  2085. #. type: Plain text
  2086. #: ./rluser.texi:1174
  2087. msgid "Move `back' through the history list, fetching the previous command."
  2088. msgstr ""
  2089. #. type: item
  2090. #: ./rluser.texi:1175
  2091. #, no-wrap
  2092. msgid "next-history (C-n)"
  2093. msgstr ""
  2094. #. type: Plain text
  2095. #: ./rluser.texi:1177
  2096. msgid "Move `forward' through the history list, fetching the next command."
  2097. msgstr ""
  2098. #. type: item
  2099. #: ./rluser.texi:1178
  2100. #, no-wrap
  2101. msgid "beginning-of-history (M-<)"
  2102. msgstr ""
  2103. #. type: Plain text
  2104. #: ./rluser.texi:1180
  2105. msgid "Move to the first line in the history."
  2106. msgstr ""
  2107. #. type: item
  2108. #: ./rluser.texi:1181
  2109. #, no-wrap
  2110. msgid "end-of-history (M->)"
  2111. msgstr ""
  2112. #. type: Plain text
  2113. #: ./rluser.texi:1184
  2114. msgid ""
  2115. "Move to the end of the input history, i.e., the line currently being "
  2116. "entered."
  2117. msgstr ""
  2118. #. type: item
  2119. #: ./rluser.texi:1185
  2120. #, no-wrap
  2121. msgid "reverse-search-history (C-r)"
  2122. msgstr ""
  2123. #. type: Plain text
  2124. #: ./rluser.texi:1188
  2125. msgid ""
  2126. "Search backward starting at the current line and moving `up' through the "
  2127. "history as necessary. This is an incremental search."
  2128. msgstr ""
  2129. #. type: item
  2130. #: ./rluser.texi:1189
  2131. #, no-wrap
  2132. msgid "forward-search-history (C-s)"
  2133. msgstr ""
  2134. #. type: Plain text
  2135. #: ./rluser.texi:1192
  2136. msgid ""
  2137. "Search forward starting at the current line and moving `down' through the "
  2138. "history as necessary. This is an incremental search."
  2139. msgstr ""
  2140. #. type: item
  2141. #: ./rluser.texi:1193
  2142. #, no-wrap
  2143. msgid "non-incremental-reverse-search-history (M-p)"
  2144. msgstr ""
  2145. #. type: Plain text
  2146. #: ./rluser.texi:1198
  2147. msgid ""
  2148. "Search backward starting at the current line and moving `up' through the "
  2149. "history as necessary using a non-incremental search for a string supplied by "
  2150. "the user. The search string may match anywhere in a history line."
  2151. msgstr ""
  2152. #. type: item
  2153. #: ./rluser.texi:1199
  2154. #, no-wrap
  2155. msgid "non-incremental-forward-search-history (M-n)"
  2156. msgstr ""
  2157. #. type: Plain text
  2158. #: ./rluser.texi:1204
  2159. msgid ""
  2160. "Search forward starting at the current line and moving `down' through the "
  2161. "history as necessary using a non-incremental search for a string supplied by "
  2162. "the user. The search string may match anywhere in a history line."
  2163. msgstr ""
  2164. #. type: item
  2165. #: ./rluser.texi:1205
  2166. #, no-wrap
  2167. msgid "history-search-forward ()"
  2168. msgstr ""
  2169. #. type: Plain text
  2170. #: ./rluser.texi:1211
  2171. msgid ""
  2172. "Search forward through the history for the string of characters between the "
  2173. "start of the current line and the point. The search string must match at "
  2174. "the beginning of a history line. This is a non-incremental search. By "
  2175. "default, this command is unbound."
  2176. msgstr ""
  2177. #. type: item
  2178. #: ./rluser.texi:1212
  2179. #, no-wrap
  2180. msgid "history-search-backward ()"
  2181. msgstr ""
  2182. #. type: Plain text
  2183. #: ./rluser.texi:1218
  2184. msgid ""
  2185. "Search backward through the history for the string of characters between the "
  2186. "start of the current line and the point. The search string must match at "
  2187. "the beginning of a history line. This is a non-incremental search. By "
  2188. "default, this command is unbound."
  2189. msgstr ""
  2190. #. type: item
  2191. #: ./rluser.texi:1219
  2192. #, no-wrap
  2193. msgid "history-substr-search-forward ()"
  2194. msgstr ""
  2195. #. type: Plain text
  2196. #: ./rluser.texi:1225
  2197. msgid ""
  2198. "Search forward through the history for the string of characters between the "
  2199. "start of the current line and the point. The search string may match "
  2200. "anywhere in a history line. This is a non-incremental search. By default, "
  2201. "this command is unbound."
  2202. msgstr ""
  2203. #. type: item
  2204. #: ./rluser.texi:1226
  2205. #, no-wrap
  2206. msgid "history-substr-search-backward ()"
  2207. msgstr ""
  2208. #. type: Plain text
  2209. #: ./rluser.texi:1232
  2210. msgid ""
  2211. "Search backward through the history for the string of characters between the "
  2212. "start of the current line and the point. The search string may match "
  2213. "anywhere in a history line. This is a non-incremental search. By default, "
  2214. "this command is unbound."
  2215. msgstr ""
  2216. #. type: item
  2217. #: ./rluser.texi:1233
  2218. #, no-wrap
  2219. msgid "yank-nth-arg (M-C-y)"
  2220. msgstr ""
  2221. #. type: Plain text
  2222. #: ./rluser.texi:1242
  2223. msgid ""
  2224. "Insert the first argument to the previous command (usually the second word "
  2225. "on the previous line) at point. With an argument @var{n}, insert the "
  2226. "@var{n}th word from the previous command (the words in the previous command "
  2227. "begin with word 0). A negative argument inserts the @var{n}th word from the "
  2228. "end of the previous command. Once the argument @var{n} is computed, the "
  2229. "argument is extracted as if the @samp{!@var{n}} history expansion had been "
  2230. "specified."
  2231. msgstr ""
  2232. #. type: item
  2233. #: ./rluser.texi:1243
  2234. #, no-wrap
  2235. msgid "yank-last-arg (M-. or M-_)"
  2236. msgstr ""
  2237. #. type: Plain text
  2238. #: ./rluser.texi:1255
  2239. msgid ""
  2240. "Insert last argument to the previous command (the last word of the previous "
  2241. "history entry). With a numeric argument, behave exactly like "
  2242. "@code{yank-nth-arg}. Successive calls to @code{yank-last-arg} move back "
  2243. "through the history list, inserting the last word (or the word specified by "
  2244. "the argument to the first call) of each line in turn. Any numeric argument "
  2245. "supplied to these successive calls determines the direction to move through "
  2246. "the history. A negative argument switches the direction through the history "
  2247. "(back or forward). The history expansion facilities are used to extract the "
  2248. "last argument, as if the @samp{!$} history expansion had been specified."
  2249. msgstr ""
  2250. #. type: subsection
  2251. #: ./rluser.texi:1259
  2252. #, no-wrap
  2253. msgid "Commands For Changing Text"
  2254. msgstr ""
  2255. #. type: item
  2256. #: ./rluser.texi:1263
  2257. #, no-wrap
  2258. msgid "@i{end-of-file} (usually C-d)"
  2259. msgstr ""
  2260. #. type: Plain text
  2261. #: ./rluser.texi:1268
  2262. msgid ""
  2263. "The character indicating end-of-file as set, for example, by @code{stty}. "
  2264. "If this character is read when there are no characters on the line, and "
  2265. "point is at the beginning of the line, Readline interprets it as the end of "
  2266. "input and returns @sc{eof}."
  2267. msgstr ""
  2268. #. type: item
  2269. #: ./rluser.texi:1269
  2270. #, no-wrap
  2271. msgid "delete-char (C-d)"
  2272. msgstr ""
  2273. #. type: Plain text
  2274. #: ./rluser.texi:1273
  2275. msgid ""
  2276. "Delete the character at point. If this function is bound to the same "
  2277. "character as the tty @sc{eof} character, as @kbd{C-d} commonly is, see above "
  2278. "for the effects."
  2279. msgstr ""
  2280. #. type: item
  2281. #: ./rluser.texi:1274
  2282. #, no-wrap
  2283. msgid "backward-delete-char (Rubout)"
  2284. msgstr ""
  2285. #. type: Plain text
  2286. #: ./rluser.texi:1277
  2287. msgid ""
  2288. "Delete the character behind the cursor. A numeric argument means to kill "
  2289. "the characters instead of deleting them."
  2290. msgstr ""
  2291. #. type: item
  2292. #: ./rluser.texi:1278
  2293. #, no-wrap
  2294. msgid "forward-backward-delete-char ()"
  2295. msgstr ""
  2296. #. type: Plain text
  2297. #: ./rluser.texi:1282
  2298. msgid ""
  2299. "Delete the character under the cursor, unless the cursor is at the end of "
  2300. "the line, in which case the character behind the cursor is deleted. By "
  2301. "default, this is not bound to a key."
  2302. msgstr ""
  2303. #. type: item
  2304. #: ./rluser.texi:1283
  2305. #, no-wrap
  2306. msgid "quoted-insert (C-q or C-v)"
  2307. msgstr ""
  2308. #. type: Plain text
  2309. #: ./rluser.texi:1286
  2310. msgid ""
  2311. "Add the next character typed to the line verbatim. This is how to insert "
  2312. "key sequences like @kbd{C-q}, for example."
  2313. msgstr ""
  2314. #. type: item
  2315. #: ./rluser.texi:1288
  2316. #, no-wrap
  2317. msgid "tab-insert (M-@key{TAB})"
  2318. msgstr ""
  2319. #. type: ifclear
  2320. #: ./rluser.texi:1290
  2321. msgid "Insert a tab character."
  2322. msgstr ""
  2323. #. type: item
  2324. #: ./rluser.texi:1292
  2325. #, no-wrap
  2326. msgid "self-insert (a, b, A, 1, !, @dots{})"
  2327. msgstr ""
  2328. #. type: Plain text
  2329. #: ./rluser.texi:1294
  2330. msgid "Insert yourself."
  2331. msgstr ""
  2332. #. type: item
  2333. #: ./rluser.texi:1295
  2334. #, no-wrap
  2335. msgid "bracketed-paste-begin ()"
  2336. msgstr ""
  2337. #. type: Plain text
  2338. #: ./rluser.texi:1302
  2339. msgid ""
  2340. "This function is intended to be bound to the \"bracketed paste\" escape "
  2341. "sequence sent by some terminals, and such a binding is assigned by default. "
  2342. "It allows Readline to insert the pasted text as a single unit without "
  2343. "treating each character as if it had been read from the keyboard. The "
  2344. "characters are inserted as if each one was bound to @code{self-insert}) "
  2345. "instead of executing any editing commands."
  2346. msgstr ""
  2347. #. type: item
  2348. #: ./rluser.texi:1303
  2349. #, no-wrap
  2350. msgid "transpose-chars (C-t)"
  2351. msgstr ""
  2352. #. type: Plain text
  2353. #: ./rluser.texi:1310
  2354. msgid ""
  2355. "Drag the character before the cursor forward over the character at the "
  2356. "cursor, moving the cursor forward as well. If the insertion point is at the "
  2357. "end of the line, then this transposes the last two characters of the line. "
  2358. "Negative arguments have no effect."
  2359. msgstr ""
  2360. #. type: item
  2361. #: ./rluser.texi:1311
  2362. #, no-wrap
  2363. msgid "transpose-words (M-t)"
  2364. msgstr ""
  2365. #. type: Plain text
  2366. #: ./rluser.texi:1316
  2367. msgid ""
  2368. "Drag the word before point past the word after point, moving point past that "
  2369. "word as well. If the insertion point is at the end of the line, this "
  2370. "transposes the last two words on the line."
  2371. msgstr ""
  2372. #. type: item
  2373. #: ./rluser.texi:1317
  2374. #, no-wrap
  2375. msgid "upcase-word (M-u)"
  2376. msgstr ""
  2377. #. type: Plain text
  2378. #: ./rluser.texi:1320
  2379. msgid ""
  2380. "Uppercase the current (or following) word. With a negative argument, "
  2381. "uppercase the previous word, but do not move the cursor."
  2382. msgstr ""
  2383. #. type: item
  2384. #: ./rluser.texi:1321
  2385. #, no-wrap
  2386. msgid "downcase-word (M-l)"
  2387. msgstr ""
  2388. #. type: Plain text
  2389. #: ./rluser.texi:1324
  2390. msgid ""
  2391. "Lowercase the current (or following) word. With a negative argument, "
  2392. "lowercase the previous word, but do not move the cursor."
  2393. msgstr ""
  2394. #. type: item
  2395. #: ./rluser.texi:1325
  2396. #, no-wrap
  2397. msgid "capitalize-word (M-c)"
  2398. msgstr ""
  2399. #. type: Plain text
  2400. #: ./rluser.texi:1328
  2401. msgid ""
  2402. "Capitalize the current (or following) word. With a negative argument, "
  2403. "capitalize the previous word, but do not move the cursor."
  2404. msgstr ""
  2405. #. type: item
  2406. #: ./rluser.texi:1329
  2407. #, no-wrap
  2408. msgid "overwrite-mode ()"
  2409. msgstr ""
  2410. #. type: Plain text
  2411. #: ./rluser.texi:1335
  2412. msgid ""
  2413. "Toggle overwrite mode. With an explicit positive numeric argument, switches "
  2414. "to overwrite mode. With an explicit non-positive numeric argument, switches "
  2415. "to insert mode. This command affects only @code{emacs} mode; @code{vi} mode "
  2416. "does overwrite differently. Each call to @code{readline()} starts in insert "
  2417. "mode."
  2418. msgstr ""
  2419. #. type: Plain text
  2420. #: ./rluser.texi:1340
  2421. msgid ""
  2422. "In overwrite mode, characters bound to @code{self-insert} replace the text "
  2423. "at point rather than pushing the text to the right. Characters bound to "
  2424. "@code{backward-delete-char} replace the character before point with a space."
  2425. msgstr ""
  2426. #. type: Plain text
  2427. #: ./rluser.texi:1342
  2428. msgid "By default, this command is unbound."
  2429. msgstr ""
  2430. #. type: subsection
  2431. #: ./rluser.texi:1346
  2432. #, no-wrap
  2433. msgid "Killing And Yanking"
  2434. msgstr ""
  2435. #. type: item
  2436. #: ./rluser.texi:1350
  2437. #, no-wrap
  2438. msgid "kill-line (C-k)"
  2439. msgstr ""
  2440. #. type: Plain text
  2441. #: ./rluser.texi:1352
  2442. msgid "Kill the text from point to the end of the line."
  2443. msgstr ""
  2444. #. type: item
  2445. #: ./rluser.texi:1353
  2446. #, no-wrap
  2447. msgid "backward-kill-line (C-x Rubout)"
  2448. msgstr ""
  2449. #. type: Plain text
  2450. #: ./rluser.texi:1355 ./rluser.texi:1358
  2451. msgid "Kill backward from the cursor to the beginning of the current line."
  2452. msgstr ""
  2453. #. type: item
  2454. #: ./rluser.texi:1356
  2455. #, no-wrap
  2456. msgid "unix-line-discard (C-u)"
  2457. msgstr ""
  2458. #. type: item
  2459. #: ./rluser.texi:1359
  2460. #, no-wrap
  2461. msgid "kill-whole-line ()"
  2462. msgstr ""
  2463. #. type: Plain text
  2464. #: ./rluser.texi:1362
  2465. msgid ""
  2466. "Kill all characters on the current line, no matter where point is. By "
  2467. "default, this is unbound."
  2468. msgstr ""
  2469. #. type: item
  2470. #: ./rluser.texi:1363
  2471. #, no-wrap
  2472. msgid "kill-word (M-d)"
  2473. msgstr ""
  2474. #. type: Plain text
  2475. #: ./rluser.texi:1367
  2476. msgid ""
  2477. "Kill from point to the end of the current word, or if between words, to the "
  2478. "end of the next word. Word boundaries are the same as @code{forward-word}."
  2479. msgstr ""
  2480. #. type: item
  2481. #: ./rluser.texi:1368
  2482. #, no-wrap
  2483. msgid "backward-kill-word (M-@key{DEL})"
  2484. msgstr ""
  2485. #. type: Plain text
  2486. #: ./rluser.texi:1371
  2487. msgid ""
  2488. "Kill the word behind point. Word boundaries are the same as "
  2489. "@code{backward-word}."
  2490. msgstr ""
  2491. #. type: item
  2492. #: ./rluser.texi:1373
  2493. #, no-wrap
  2494. msgid "shell-kill-word ()"
  2495. msgstr ""
  2496. #. type: ifset
  2497. #: ./rluser.texi:1377
  2498. msgid ""
  2499. "Kill from point to the end of the current word, or if between words, to the "
  2500. "end of the next word. Word boundaries are the same as "
  2501. "@code{shell-forward-word}."
  2502. msgstr ""
  2503. #. type: item
  2504. #: ./rluser.texi:1378
  2505. #, no-wrap
  2506. msgid "shell-backward-kill-word ()"
  2507. msgstr ""
  2508. #. type: ifset
  2509. #: ./rluser.texi:1381
  2510. msgid ""
  2511. "Kill the word behind point. Word boundaries are the same as "
  2512. "@code{shell-backward-word}."
  2513. msgstr ""
  2514. #. type: item
  2515. #: ./rluser.texi:1383
  2516. #, no-wrap
  2517. msgid "unix-word-rubout (C-w)"
  2518. msgstr ""
  2519. #. type: Plain text
  2520. #: ./rluser.texi:1386
  2521. msgid ""
  2522. "Kill the word behind point, using white space as a word boundary. The "
  2523. "killed text is saved on the kill-ring."
  2524. msgstr ""
  2525. #. type: item
  2526. #: ./rluser.texi:1387
  2527. #, no-wrap
  2528. msgid "unix-filename-rubout ()"
  2529. msgstr ""
  2530. #. type: Plain text
  2531. #: ./rluser.texi:1391
  2532. msgid ""
  2533. "Kill the word behind point, using white space and the slash character as the "
  2534. "word boundaries. The killed text is saved on the kill-ring."
  2535. msgstr ""
  2536. #. type: item
  2537. #: ./rluser.texi:1392
  2538. #, no-wrap
  2539. msgid "delete-horizontal-space ()"
  2540. msgstr ""
  2541. #. type: Plain text
  2542. #: ./rluser.texi:1394
  2543. msgid "Delete all spaces and tabs around point. By default, this is unbound."
  2544. msgstr ""
  2545. #. type: item
  2546. #: ./rluser.texi:1395
  2547. #, no-wrap
  2548. msgid "kill-region ()"
  2549. msgstr ""
  2550. #. type: Plain text
  2551. #: ./rluser.texi:1398
  2552. msgid "Kill the text in the current region. By default, this command is unbound."
  2553. msgstr ""
  2554. #. type: item
  2555. #: ./rluser.texi:1399
  2556. #, no-wrap
  2557. msgid "copy-region-as-kill ()"
  2558. msgstr ""
  2559. #. type: Plain text
  2560. #: ./rluser.texi:1402
  2561. msgid ""
  2562. "Copy the text in the region to the kill buffer, so it can be yanked right "
  2563. "away. By default, this command is unbound."
  2564. msgstr ""
  2565. #. type: item
  2566. #: ./rluser.texi:1403
  2567. #, no-wrap
  2568. msgid "copy-backward-word ()"
  2569. msgstr ""
  2570. #. type: Plain text
  2571. #: ./rluser.texi:1407
  2572. msgid ""
  2573. "Copy the word before point to the kill buffer. The word boundaries are the "
  2574. "same as @code{backward-word}. By default, this command is unbound."
  2575. msgstr ""
  2576. #. type: item
  2577. #: ./rluser.texi:1408
  2578. #, no-wrap
  2579. msgid "copy-forward-word ()"
  2580. msgstr ""
  2581. #. type: Plain text
  2582. #: ./rluser.texi:1412
  2583. msgid ""
  2584. "Copy the word following point to the kill buffer. The word boundaries are "
  2585. "the same as @code{forward-word}. By default, this command is unbound."
  2586. msgstr ""
  2587. #. type: item
  2588. #: ./rluser.texi:1413
  2589. #, no-wrap
  2590. msgid "yank (C-y)"
  2591. msgstr ""
  2592. #. type: Plain text
  2593. #: ./rluser.texi:1415
  2594. msgid "Yank the top of the kill ring into the buffer at point."
  2595. msgstr ""
  2596. #. type: item
  2597. #: ./rluser.texi:1416
  2598. #, no-wrap
  2599. msgid "yank-pop (M-y)"
  2600. msgstr ""
  2601. #. type: Plain text
  2602. #: ./rluser.texi:1419
  2603. msgid ""
  2604. "Rotate the kill-ring, and yank the new top. You can only do this if the "
  2605. "prior command is @code{yank} or @code{yank-pop}."
  2606. msgstr ""
  2607. #. type: subsection
  2608. #: ./rluser.texi:1422
  2609. #, no-wrap
  2610. msgid "Specifying Numeric Arguments"
  2611. msgstr ""
  2612. #. type: item
  2613. #: ./rluser.texi:1425
  2614. #, no-wrap
  2615. msgid "digit-argument (@kbd{M-0}, @kbd{M-1}, @dots{} @kbd{M--})"
  2616. msgstr ""
  2617. #. type: Plain text
  2618. #: ./rluser.texi:1428
  2619. msgid ""
  2620. "Add this digit to the argument already accumulating, or start a new "
  2621. "argument. @kbd{M--} starts a negative argument."
  2622. msgstr ""
  2623. #. type: item
  2624. #: ./rluser.texi:1429
  2625. #, no-wrap
  2626. msgid "universal-argument ()"
  2627. msgstr ""
  2628. #. type: Plain text
  2629. #: ./rluser.texi:1442
  2630. msgid ""
  2631. "This is another way to specify an argument. If this command is followed by "
  2632. "one or more digits, optionally with a leading minus sign, those digits "
  2633. "define the argument. If the command is followed by digits, executing "
  2634. "@code{universal-argument} again ends the numeric argument, but is otherwise "
  2635. "ignored. As a special case, if this command is immediately followed by a "
  2636. "character that is neither a digit nor minus sign, the argument count for the "
  2637. "next command is multiplied by four. The argument count is initially one, so "
  2638. "executing this function the first time makes the argument count four, a "
  2639. "second time makes the argument count sixteen, and so on. By default, this "
  2640. "is not bound to a key."
  2641. msgstr ""
  2642. #. type: subsection
  2643. #: ./rluser.texi:1445
  2644. #, no-wrap
  2645. msgid "Letting Readline Type For You"
  2646. msgstr ""
  2647. #. type: item
  2648. #: ./rluser.texi:1448
  2649. #, no-wrap
  2650. msgid "complete (@key{TAB})"
  2651. msgstr ""
  2652. #. type: Plain text
  2653. #: ./rluser.texi:1451
  2654. msgid ""
  2655. "Attempt to perform completion on the text before point. The actual "
  2656. "completion performed is application-specific."
  2657. msgstr ""
  2658. #. type: ifset
  2659. #: ./rluser.texi:1457
  2660. msgid ""
  2661. "Bash attempts completion treating the text as a variable (if the text begins "
  2662. "with @samp{$}), username (if the text begins with @samp{~}), hostname (if "
  2663. "the text begins with @samp{@@}), or command (including aliases and "
  2664. "functions) in turn. If none of these produces a match, filename completion "
  2665. "is attempted."
  2666. msgstr ""
  2667. #. type: ifclear
  2668. #: ./rluser.texi:1460
  2669. msgid "The default is filename completion."
  2670. msgstr ""
  2671. #. type: item
  2672. #: ./rluser.texi:1462
  2673. #, no-wrap
  2674. msgid "possible-completions (M-?)"
  2675. msgstr ""
  2676. #. type: Plain text
  2677. #: ./rluser.texi:1467
  2678. msgid ""
  2679. "List the possible completions of the text before point. When displaying "
  2680. "completions, Readline sets the number of columns used for display to the "
  2681. "value of @code{completion-display-width}, the value of the environment "
  2682. "variable @env{COLUMNS}, or the screen width, in that order."
  2683. msgstr ""
  2684. #. type: item
  2685. #: ./rluser.texi:1468
  2686. #, no-wrap
  2687. msgid "insert-completions (M-*)"
  2688. msgstr ""
  2689. #. type: Plain text
  2690. #: ./rluser.texi:1471
  2691. msgid ""
  2692. "Insert all completions of the text before point that would have been "
  2693. "generated by @code{possible-completions}."
  2694. msgstr ""
  2695. #. type: item
  2696. #: ./rluser.texi:1472
  2697. #, no-wrap
  2698. msgid "menu-complete ()"
  2699. msgstr ""
  2700. #. type: Plain text
  2701. #: ./rluser.texi:1485
  2702. msgid ""
  2703. "Similar to @code{complete}, but replaces the word to be completed with a "
  2704. "single match from the list of possible completions. Repeated execution of "
  2705. "@code{menu-complete} steps through the list of possible completions, "
  2706. "inserting each match in turn. At the end of the list of completions, the "
  2707. "bell is rung (subject to the setting of @code{bell-style}) and the original "
  2708. "text is restored. An argument of @var{n} moves @var{n} positions forward in "
  2709. "the list of matches; a negative argument may be used to move backward "
  2710. "through the list. This command is intended to be bound to @key{TAB}, but is "
  2711. "unbound by default."
  2712. msgstr ""
  2713. #. type: item
  2714. #: ./rluser.texi:1486
  2715. #, no-wrap
  2716. msgid "menu-complete-backward ()"
  2717. msgstr ""
  2718. #. type: Plain text
  2719. #: ./rluser.texi:1490
  2720. msgid ""
  2721. "Identical to @code{menu-complete}, but moves backward through the list of "
  2722. "possible completions, as if @code{menu-complete} had been given a negative "
  2723. "argument."
  2724. msgstr ""
  2725. #. type: item
  2726. #: ./rluser.texi:1491
  2727. #, no-wrap
  2728. msgid "delete-char-or-list ()"
  2729. msgstr ""
  2730. #. type: Plain text
  2731. #: ./rluser.texi:1497
  2732. msgid ""
  2733. "Deletes the character under the cursor if not at the beginning or end of the "
  2734. "line (like @code{delete-char}). If at the end of the line, behaves "
  2735. "identically to @code{possible-completions}. This command is unbound by "
  2736. "default."
  2737. msgstr ""
  2738. #. type: item
  2739. #: ./rluser.texi:1499
  2740. #, no-wrap
  2741. msgid "complete-filename (M-/)"
  2742. msgstr ""
  2743. #. type: ifset
  2744. #: ./rluser.texi:1501
  2745. msgid "Attempt filename completion on the text before point."
  2746. msgstr ""
  2747. #. type: item
  2748. #: ./rluser.texi:1502
  2749. #, no-wrap
  2750. msgid "possible-filename-completions (C-x /)"
  2751. msgstr ""
  2752. #. type: ifset
  2753. #: ./rluser.texi:1505
  2754. msgid ""
  2755. "List the possible completions of the text before point, treating it as a "
  2756. "filename."
  2757. msgstr ""
  2758. #. type: item
  2759. #: ./rluser.texi:1506
  2760. #, no-wrap
  2761. msgid "complete-username (M-~)"
  2762. msgstr ""
  2763. #. type: ifset
  2764. #: ./rluser.texi:1509
  2765. msgid "Attempt completion on the text before point, treating it as a username."
  2766. msgstr ""
  2767. #. type: item
  2768. #: ./rluser.texi:1510
  2769. #, no-wrap
  2770. msgid "possible-username-completions (C-x ~)"
  2771. msgstr ""
  2772. #. type: ifset
  2773. #: ./rluser.texi:1513
  2774. msgid ""
  2775. "List the possible completions of the text before point, treating it as a "
  2776. "username."
  2777. msgstr ""
  2778. #. type: item
  2779. #: ./rluser.texi:1514
  2780. #, no-wrap
  2781. msgid "complete-variable (M-$)"
  2782. msgstr ""
  2783. #. type: ifset
  2784. #: ./rluser.texi:1517
  2785. msgid ""
  2786. "Attempt completion on the text before point, treating it as a shell "
  2787. "variable."
  2788. msgstr ""
  2789. #. type: item
  2790. #: ./rluser.texi:1518
  2791. #, no-wrap
  2792. msgid "possible-variable-completions (C-x $)"
  2793. msgstr ""
  2794. #. type: ifset
  2795. #: ./rluser.texi:1521
  2796. msgid ""
  2797. "List the possible completions of the text before point, treating it as a "
  2798. "shell variable."
  2799. msgstr ""
  2800. #. type: item
  2801. #: ./rluser.texi:1522
  2802. #, no-wrap
  2803. msgid "complete-hostname (M-@@)"
  2804. msgstr ""
  2805. #. type: ifset
  2806. #: ./rluser.texi:1525
  2807. msgid "Attempt completion on the text before point, treating it as a hostname."
  2808. msgstr ""
  2809. #. type: item
  2810. #: ./rluser.texi:1526
  2811. #, no-wrap
  2812. msgid "possible-hostname-completions (C-x @@)"
  2813. msgstr ""
  2814. #. type: ifset
  2815. #: ./rluser.texi:1529
  2816. msgid ""
  2817. "List the possible completions of the text before point, treating it as a "
  2818. "hostname."
  2819. msgstr ""
  2820. #. type: item
  2821. #: ./rluser.texi:1530
  2822. #, no-wrap
  2823. msgid "complete-command (M-!)"
  2824. msgstr ""
  2825. #. type: ifset
  2826. #: ./rluser.texi:1536
  2827. msgid ""
  2828. "Attempt completion on the text before point, treating it as a command name. "
  2829. "Command completion attempts to match the text against aliases, reserved "
  2830. "words, shell functions, shell builtins, and finally executable filenames, in "
  2831. "that order."
  2832. msgstr ""
  2833. #. type: item
  2834. #: ./rluser.texi:1537
  2835. #, no-wrap
  2836. msgid "possible-command-completions (C-x !)"
  2837. msgstr ""
  2838. #. type: ifset
  2839. #: ./rluser.texi:1540
  2840. msgid ""
  2841. "List the possible completions of the text before point, treating it as a "
  2842. "command name."
  2843. msgstr ""
  2844. #. type: item
  2845. #: ./rluser.texi:1541
  2846. #, no-wrap
  2847. msgid "dynamic-complete-history (M-@key{TAB})"
  2848. msgstr ""
  2849. #. type: ifset
  2850. #: ./rluser.texi:1545
  2851. msgid ""
  2852. "Attempt completion on the text before point, comparing the text against "
  2853. "lines from the history list for possible completion matches."
  2854. msgstr ""
  2855. #. type: item
  2856. #: ./rluser.texi:1546
  2857. #, no-wrap
  2858. msgid "dabbrev-expand ()"
  2859. msgstr ""
  2860. #. type: ifset
  2861. #: ./rluser.texi:1550
  2862. msgid ""
  2863. "Attempt menu completion on the text before point, comparing the text against "
  2864. "lines from the history list for possible completion matches."
  2865. msgstr ""
  2866. #. type: item
  2867. #: ./rluser.texi:1551
  2868. #, no-wrap
  2869. msgid "complete-into-braces (M-@{)"
  2870. msgstr ""
  2871. #. type: ifset
  2872. #: ./rluser.texi:1555
  2873. msgid ""
  2874. "Perform filename completion and insert the list of possible completions "
  2875. "enclosed within braces so the list is available to the shell (@pxref{Brace "
  2876. "Expansion})."
  2877. msgstr ""
  2878. #. type: item
  2879. #: ./rluser.texi:1563
  2880. #, no-wrap
  2881. msgid "start-kbd-macro (C-x ()"
  2882. msgstr ""
  2883. #. type: Plain text
  2884. #: ./rluser.texi:1565
  2885. msgid "Begin saving the characters typed into the current keyboard macro."
  2886. msgstr ""
  2887. #. type: item
  2888. #: ./rluser.texi:1566
  2889. #, no-wrap
  2890. msgid "end-kbd-macro (C-x ))"
  2891. msgstr ""
  2892. #. type: Plain text
  2893. #: ./rluser.texi:1569
  2894. msgid ""
  2895. "Stop saving the characters typed into the current keyboard macro and save "
  2896. "the definition."
  2897. msgstr ""
  2898. #. type: item
  2899. #: ./rluser.texi:1570
  2900. #, no-wrap
  2901. msgid "call-last-kbd-macro (C-x e)"
  2902. msgstr ""
  2903. #. type: Plain text
  2904. #: ./rluser.texi:1573
  2905. msgid ""
  2906. "Re-execute the last keyboard macro defined, by making the characters in the "
  2907. "macro appear as if typed at the keyboard."
  2908. msgstr ""
  2909. #. type: item
  2910. #: ./rluser.texi:1574
  2911. #, no-wrap
  2912. msgid "print-last-kbd-macro ()"
  2913. msgstr ""
  2914. #. type: Plain text
  2915. #: ./rluser.texi:1577
  2916. msgid ""
  2917. "Print the last keboard macro defined in a format suitable for the "
  2918. "@var{inputrc} file."
  2919. msgstr ""
  2920. #. type: subsection
  2921. #: ./rluser.texi:1581
  2922. #, no-wrap
  2923. msgid "Some Miscellaneous Commands"
  2924. msgstr ""
  2925. #. type: item
  2926. #: ./rluser.texi:1584
  2927. #, no-wrap
  2928. msgid "re-read-init-file (C-x C-r)"
  2929. msgstr ""
  2930. #. type: Plain text
  2931. #: ./rluser.texi:1587
  2932. msgid ""
  2933. "Read in the contents of the @var{inputrc} file, and incorporate any bindings "
  2934. "or variable assignments found there."
  2935. msgstr ""
  2936. #. type: item
  2937. #: ./rluser.texi:1588
  2938. #, no-wrap
  2939. msgid "abort (C-g)"
  2940. msgstr ""
  2941. #. type: Plain text
  2942. #: ./rluser.texi:1592
  2943. msgid ""
  2944. "Abort the current editing command and ring the terminal's bell (subject to "
  2945. "the setting of @code{bell-style})."
  2946. msgstr ""
  2947. #. type: item
  2948. #: ./rluser.texi:1593
  2949. #, no-wrap
  2950. msgid "do-uppercase-version (M-a, M-b, M-@var{x}, @dots{})"
  2951. msgstr ""
  2952. #. type: Plain text
  2953. #: ./rluser.texi:1596
  2954. msgid ""
  2955. "If the metafied character @var{x} is lowercase, run the command that is "
  2956. "bound to the corresponding uppercase character."
  2957. msgstr ""
  2958. #. type: item
  2959. #: ./rluser.texi:1597
  2960. #, no-wrap
  2961. msgid "prefix-meta (@key{ESC})"
  2962. msgstr ""
  2963. #. type: Plain text
  2964. #: ./rluser.texi:1601
  2965. msgid ""
  2966. "Metafy the next character typed. This is for keyboards without a meta key. "
  2967. "Typing @samp{@key{ESC} f} is equivalent to typing @kbd{M-f}."
  2968. msgstr ""
  2969. #. type: item
  2970. #: ./rluser.texi:1602
  2971. #, no-wrap
  2972. msgid "undo (C-_ or C-x C-u)"
  2973. msgstr ""
  2974. #. type: Plain text
  2975. #: ./rluser.texi:1604
  2976. msgid "Incremental undo, separately remembered for each line."
  2977. msgstr ""
  2978. #. type: item
  2979. #: ./rluser.texi:1605
  2980. #, no-wrap
  2981. msgid "revert-line (M-r)"
  2982. msgstr ""
  2983. #. type: Plain text
  2984. #: ./rluser.texi:1608
  2985. msgid ""
  2986. "Undo all changes made to this line. This is like executing the @code{undo} "
  2987. "command enough times to get back to the beginning."
  2988. msgstr ""
  2989. #. type: item
  2990. #: ./rluser.texi:1610
  2991. #, no-wrap
  2992. msgid "tilde-expand (M-&)"
  2993. msgstr ""
  2994. #. type: item
  2995. #: ./rluser.texi:1613
  2996. #, no-wrap
  2997. msgid "tilde-expand (M-~)"
  2998. msgstr ""
  2999. #. type: Plain text
  3000. #: ./rluser.texi:1616
  3001. msgid "Perform tilde expansion on the current word."
  3002. msgstr ""
  3003. #. type: item
  3004. #: ./rluser.texi:1617
  3005. #, no-wrap
  3006. msgid "set-mark (C-@@)"
  3007. msgstr ""
  3008. #. type: Plain text
  3009. #: ./rluser.texi:1620
  3010. msgid ""
  3011. "Set the mark to the point. If a numeric argument is supplied, the mark is "
  3012. "set to that position."
  3013. msgstr ""
  3014. #. type: item
  3015. #: ./rluser.texi:1621
  3016. #, no-wrap
  3017. msgid "exchange-point-and-mark (C-x C-x)"
  3018. msgstr ""
  3019. #. type: Plain text
  3020. #: ./rluser.texi:1624
  3021. msgid ""
  3022. "Swap the point with the mark. The current cursor position is set to the "
  3023. "saved position, and the old cursor position is saved as the mark."
  3024. msgstr ""
  3025. #. type: item
  3026. #: ./rluser.texi:1625
  3027. #, no-wrap
  3028. msgid "character-search (C-])"
  3029. msgstr ""
  3030. #. type: Plain text
  3031. #: ./rluser.texi:1628
  3032. msgid ""
  3033. "A character is read and point is moved to the next occurrence of that "
  3034. "character. A negative count searches for previous occurrences."
  3035. msgstr ""
  3036. #. type: item
  3037. #: ./rluser.texi:1629
  3038. #, no-wrap
  3039. msgid "character-search-backward (M-C-])"
  3040. msgstr ""
  3041. #. type: Plain text
  3042. #: ./rluser.texi:1633
  3043. msgid ""
  3044. "A character is read and point is moved to the previous occurrence of that "
  3045. "character. A negative count searches for subsequent occurrences."
  3046. msgstr ""
  3047. #. type: item
  3048. #: ./rluser.texi:1634
  3049. #, no-wrap
  3050. msgid "skip-csi-sequence ()"
  3051. msgstr ""
  3052. #. type: Plain text
  3053. #: ./rluser.texi:1642
  3054. msgid ""
  3055. "Read enough characters to consume a multi-key sequence such as those defined "
  3056. "for keys like Home and End. Such sequences begin with a Control Sequence "
  3057. "Indicator (CSI), usually ESC-[. If this sequence is bound to \"\\e[\", keys "
  3058. "producing such sequences will have no effect unless explicitly bound to a "
  3059. "readline command, instead of inserting stray characters into the editing "
  3060. "buffer. This is unbound by default, but usually bound to ESC-[."
  3061. msgstr ""
  3062. #. type: item
  3063. #: ./rluser.texi:1643
  3064. #, no-wrap
  3065. msgid "insert-comment (M-#)"
  3066. msgstr ""
  3067. #. type: Plain text
  3068. #: ./rluser.texi:1652
  3069. msgid ""
  3070. "Without a numeric argument, the value of the @code{comment-begin} variable "
  3071. "is inserted at the beginning of the current line. If a numeric argument is "
  3072. "supplied, this command acts as a toggle: if the characters at the beginning "
  3073. "of the line do not match the value of @code{comment-begin}, the value is "
  3074. "inserted, otherwise the characters in @code{comment-begin} are deleted from "
  3075. "the beginning of the line. In either case, the line is accepted as if a "
  3076. "newline had been typed."
  3077. msgstr ""
  3078. #. type: ifset
  3079. #: ./rluser.texi:1657
  3080. msgid ""
  3081. "The default value of @code{comment-begin} causes this command to make the "
  3082. "current line a shell comment. If a numeric argument causes the comment "
  3083. "character to be removed, the line will be executed by the shell."
  3084. msgstr ""
  3085. #. type: item
  3086. #: ./rluser.texi:1659
  3087. #, no-wrap
  3088. msgid "dump-functions ()"
  3089. msgstr ""
  3090. #. type: Plain text
  3091. #: ./rluser.texi:1664
  3092. msgid ""
  3093. "Print all of the functions and their key bindings to the Readline output "
  3094. "stream. If a numeric argument is supplied, the output is formatted in such "
  3095. "a way that it can be made part of an @var{inputrc} file. This command is "
  3096. "unbound by default."
  3097. msgstr ""
  3098. #. type: item
  3099. #: ./rluser.texi:1665
  3100. #, no-wrap
  3101. msgid "dump-variables ()"
  3102. msgstr ""
  3103. #. type: Plain text
  3104. #: ./rluser.texi:1670
  3105. msgid ""
  3106. "Print all of the settable variables and their values to the Readline output "
  3107. "stream. If a numeric argument is supplied, the output is formatted in such "
  3108. "a way that it can be made part of an @var{inputrc} file. This command is "
  3109. "unbound by default."
  3110. msgstr ""
  3111. #. type: item
  3112. #: ./rluser.texi:1671
  3113. #, no-wrap
  3114. msgid "dump-macros ()"
  3115. msgstr ""
  3116. #. type: Plain text
  3117. #: ./rluser.texi:1676
  3118. msgid ""
  3119. "Print all of the Readline key sequences bound to macros and the strings they "
  3120. "output. If a numeric argument is supplied, the output is formatted in such "
  3121. "a way that it can be made part of an @var{inputrc} file. This command is "
  3122. "unbound by default."
  3123. msgstr ""
  3124. #. type: item
  3125. #: ./rluser.texi:1678
  3126. #, no-wrap
  3127. msgid "glob-complete-word (M-g)"
  3128. msgstr ""
  3129. #. type: ifset
  3130. #: ./rluser.texi:1682
  3131. msgid ""
  3132. "The word before point is treated as a pattern for pathname expansion, with "
  3133. "an asterisk implicitly appended. This pattern is used to generate a list of "
  3134. "matching file names for possible completions."
  3135. msgstr ""
  3136. #. type: item
  3137. #: ./rluser.texi:1683
  3138. #, no-wrap
  3139. msgid "glob-expand-word (C-x *)"
  3140. msgstr ""
  3141. #. type: ifset
  3142. #: ./rluser.texi:1688
  3143. msgid ""
  3144. "The word before point is treated as a pattern for pathname expansion, and "
  3145. "the list of matching file names is inserted, replacing the word. If a "
  3146. "numeric argument is supplied, a @samp{*} is appended before pathname "
  3147. "expansion."
  3148. msgstr ""
  3149. #. type: item
  3150. #: ./rluser.texi:1689
  3151. #, no-wrap
  3152. msgid "glob-list-expansions (C-x g)"
  3153. msgstr ""
  3154. #. type: ifset
  3155. #: ./rluser.texi:1694
  3156. msgid ""
  3157. "The list of expansions that would have been generated by "
  3158. "@code{glob-expand-word} is displayed, and the line is redrawn. If a numeric "
  3159. "argument is supplied, a @samp{*} is appended before pathname expansion."
  3160. msgstr ""
  3161. #. type: item
  3162. #: ./rluser.texi:1695
  3163. #, no-wrap
  3164. msgid "display-shell-version (C-x C-v)"
  3165. msgstr ""
  3166. #. type: ifset
  3167. #: ./rluser.texi:1697
  3168. msgid "Display version information about the current instance of Bash."
  3169. msgstr ""
  3170. #. type: item
  3171. #: ./rluser.texi:1698
  3172. #, no-wrap
  3173. msgid "shell-expand-line (M-C-e)"
  3174. msgstr ""
  3175. #. type: ifset
  3176. #: ./rluser.texi:1702
  3177. msgid ""
  3178. "Expand the line as the shell does. This performs alias and history "
  3179. "expansion as well as all of the shell word expansions (@pxref{Shell "
  3180. "Expansions})."
  3181. msgstr ""
  3182. #. type: item
  3183. #: ./rluser.texi:1703
  3184. #, no-wrap
  3185. msgid "history-expand-line (M-^)"
  3186. msgstr ""
  3187. #. type: ifset
  3188. #: ./rluser.texi:1705
  3189. msgid "Perform history expansion on the current line."
  3190. msgstr ""
  3191. #. type: item
  3192. #: ./rluser.texi:1706
  3193. #, no-wrap
  3194. msgid "magic-space ()"
  3195. msgstr ""
  3196. #. type: ifset
  3197. #: ./rluser.texi:1709
  3198. msgid ""
  3199. "Perform history expansion on the current line and insert a space "
  3200. "(@pxref{History Interaction})."
  3201. msgstr ""
  3202. #. type: item
  3203. #: ./rluser.texi:1710
  3204. #, no-wrap
  3205. msgid "alias-expand-line ()"
  3206. msgstr ""
  3207. #. type: ifset
  3208. #: ./rluser.texi:1712
  3209. msgid "Perform alias expansion on the current line (@pxref{Aliases})."
  3210. msgstr ""
  3211. #. type: item
  3212. #: ./rluser.texi:1713
  3213. #, no-wrap
  3214. msgid "history-and-alias-expand-line ()"
  3215. msgstr ""
  3216. #. type: ifset
  3217. #: ./rluser.texi:1715
  3218. msgid "Perform history and alias expansion on the current line."
  3219. msgstr ""
  3220. #. type: item
  3221. #: ./rluser.texi:1716
  3222. #, no-wrap
  3223. msgid "insert-last-argument (M-. or M-_)"
  3224. msgstr ""
  3225. #. type: ifset
  3226. #: ./rluser.texi:1718
  3227. msgid "A synonym for @code{yank-last-arg}."
  3228. msgstr ""
  3229. #. type: item
  3230. #: ./rluser.texi:1719
  3231. #, no-wrap
  3232. msgid "operate-and-get-next (C-o)"
  3233. msgstr ""
  3234. #. type: ifset
  3235. #: ./rluser.texi:1723
  3236. msgid ""
  3237. "Accept the current line for execution and fetch the next line relative to "
  3238. "the current line from the history for editing. Any argument is ignored."
  3239. msgstr ""
  3240. #. type: item
  3241. #: ./rluser.texi:1724
  3242. #, no-wrap
  3243. msgid "edit-and-execute-command (C-xC-e)"
  3244. msgstr ""
  3245. #. type: ifset
  3246. #: ./rluser.texi:1730
  3247. msgid ""
  3248. "Invoke an editor on the current command line, and execute the result as "
  3249. "shell commands. Bash attempts to invoke @code{$VISUAL}, @code{$EDITOR}, and "
  3250. "@code{emacs} as the editor, in that order."
  3251. msgstr ""
  3252. #. type: item
  3253. #: ./rluser.texi:1734
  3254. #, no-wrap
  3255. msgid "emacs-editing-mode (C-e)"
  3256. msgstr ""
  3257. #. type: ifclear
  3258. #: ./rluser.texi:1737
  3259. msgid ""
  3260. "When in @code{vi} command mode, this causes a switch to @code{emacs} editing "
  3261. "mode."
  3262. msgstr ""
  3263. #. type: item
  3264. #: ./rluser.texi:1738
  3265. #, no-wrap
  3266. msgid "vi-editing-mode (M-C-j)"
  3267. msgstr ""
  3268. #. type: ifclear
  3269. #: ./rluser.texi:1741
  3270. msgid ""
  3271. "When in @code{emacs} editing mode, this causes a switch to @code{vi} editing "
  3272. "mode."
  3273. msgstr ""
  3274. #. type: Plain text
  3275. #: ./rluser.texi:1753
  3276. msgid ""
  3277. "While the Readline library does not have a full set of @code{vi} editing "
  3278. "functions, it does contain enough to allow simple editing of the line. The "
  3279. "Readline @code{vi} mode behaves as specified in the @sc{posix} standard."
  3280. msgstr ""
  3281. #. type: ifset
  3282. #: ./rluser.texi:1758
  3283. msgid ""
  3284. "In order to switch interactively between @code{emacs} and @code{vi} editing "
  3285. "modes, use the @samp{set -o emacs} and @samp{set -o vi} commands (@pxref{The "
  3286. "Set Builtin})."
  3287. msgstr ""
  3288. #. type: ifclear
  3289. #: ./rluser.texi:1763
  3290. msgid ""
  3291. "In order to switch interactively between @code{emacs} and @code{vi} editing "
  3292. "modes, use the command @kbd{M-C-j} (bound to emacs-editing-mode when in "
  3293. "@code{vi} mode and to vi-editing-mode in @code{emacs} mode)."
  3294. msgstr ""
  3295. #. type: Plain text
  3296. #: ./rluser.texi:1765
  3297. msgid "The Readline default is @code{emacs} mode."
  3298. msgstr ""
  3299. #. type: Plain text
  3300. #: ./rluser.texi:1772
  3301. msgid ""
  3302. "When you enter a line in @code{vi} mode, you are already placed in "
  3303. "`insertion' mode, as if you had typed an @samp{i}. Pressing @key{ESC} "
  3304. "switches you into `command' mode, where you can edit the text of the line "
  3305. "with the standard @code{vi} movement keys, move to previous history lines "
  3306. "with @samp{k} and subsequent lines with @samp{j}, and so forth."
  3307. msgstr ""
  3308. #. type: section
  3309. #: ./rluser.texi:1774 ./rluser.texi:1775
  3310. #, no-wrap
  3311. msgid "Programmable Completion"
  3312. msgstr ""
  3313. #. type: cindex
  3314. #: ./rluser.texi:1776
  3315. #, no-wrap
  3316. msgid "programmable completion"
  3317. msgstr ""
  3318. #. type: ifset
  3319. #: ./rluser.texi:1782
  3320. msgid ""
  3321. "When word completion is attempted for an argument to a command for which a "
  3322. "completion specification (a @var{compspec}) has been defined using the "
  3323. "@code{complete} builtin (@pxref{Programmable Completion Builtins}), the "
  3324. "programmable completion facilities are invoked."
  3325. msgstr ""
  3326. #. type: ifset
  3327. #: ./rluser.texi:1795
  3328. msgid ""
  3329. "First, the command name is identified. If a compspec has been defined for "
  3330. "that command, the compspec is used to generate the list of possible "
  3331. "completions for the word. If the command word is the empty string "
  3332. "(completion attempted at the beginning of an empty line), any compspec "
  3333. "defined with the @option{-E} option to @code{complete} is used. If the "
  3334. "command word is a full pathname, a compspec for the full pathname is "
  3335. "searched for first. If no compspec is found for the full pathname, an "
  3336. "attempt is made to find a compspec for the portion following the final "
  3337. "slash. If those searches do not result in a compspec, any compspec defined "
  3338. "with the @option{-D} option to @code{complete} is used as the default."
  3339. msgstr ""
  3340. #. type: ifset
  3341. #: ./rluser.texi:1800
  3342. msgid ""
  3343. "Once a compspec has been found, it is used to generate the list of matching "
  3344. "words. If a compspec is not found, the default Bash completion described "
  3345. "above (@pxref{Commands For Completion}) is performed."
  3346. msgstr ""
  3347. #. type: ifset
  3348. #: ./rluser.texi:1808
  3349. msgid ""
  3350. "First, the actions specified by the compspec are used. Only matches which "
  3351. "are prefixed by the word being completed are returned. When the @option{-f} "
  3352. "or @option{-d} option is used for filename or directory name completion, the "
  3353. "shell variable @env{FIGNORE} is used to filter the matches. @xref{Bash "
  3354. "Variables}, for a description of @env{FIGNORE}."
  3355. msgstr ""
  3356. #. type: ifset
  3357. #: ./rluser.texi:1814
  3358. msgid ""
  3359. "Any completions specified by a filename expansion pattern to the @option{-G} "
  3360. "option are generated next. The words generated by the pattern need not "
  3361. "match the word being completed. The @env{GLOBIGNORE} shell variable is not "
  3362. "used to filter the matches, but the @env{FIGNORE} shell variable is used."
  3363. msgstr ""
  3364. #. type: ifset
  3365. #: ./rluser.texi:1828
  3366. msgid ""
  3367. "Next, the string specified as the argument to the @option{-W} option is "
  3368. "considered. The string is first split using the characters in the @env{IFS} "
  3369. "special variable as delimiters. Shell quoting is honored. Each word is "
  3370. "then expanded using brace expansion, tilde expansion, parameter and variable "
  3371. "expansion, command substitution, and arithmetic expansion, as described "
  3372. "above (@pxref{Shell Expansions}). The results are split using the rules "
  3373. "described above (@pxref{Word Splitting}). The results of the expansion are "
  3374. "prefix-matched against the word being completed, and the matching words "
  3375. "become the possible completions."
  3376. msgstr ""
  3377. #. type: ifset
  3378. #: ./rluser.texi:1844
  3379. msgid ""
  3380. "After these matches have been generated, any shell function or command "
  3381. "specified with the @option{-F} and @option{-C} options is invoked. When the "
  3382. "command or function is invoked, the @env{COMP_LINE}, @env{COMP_POINT}, "
  3383. "@env{COMP_KEY}, and @env{COMP_TYPE} variables are assigned values as "
  3384. "described above (@pxref{Bash Variables}). If a shell function is being "
  3385. "invoked, the @env{COMP_WORDS} and @env{COMP_CWORD} variables are also set. "
  3386. "When the function or command is invoked, the first argument ($1) is the name "
  3387. "of the command whose arguments are being completed, the second argument ($2) "
  3388. "is the word being completed, and the third argument ($3) is the word "
  3389. "preceding the word being completed on the current command line. No "
  3390. "filtering of the generated completions against the word being completed is "
  3391. "performed; the function or command has complete freedom in generating the "
  3392. "matches."
  3393. msgstr ""
  3394. #. type: ifset
  3395. #: ./rluser.texi:1851
  3396. msgid ""
  3397. "Any function specified with @option{-F} is invoked first. The function may "
  3398. "use any of the shell facilities, including the @code{compgen} and "
  3399. "@code{compopt} builtins described below (@pxref{Programmable Completion "
  3400. "Builtins}), to generate the matches. It must put the possible completions "
  3401. "in the @env{COMPREPLY} array variable, one per array element."
  3402. msgstr ""
  3403. #. type: ifset
  3404. #: ./rluser.texi:1857
  3405. msgid ""
  3406. "Next, any command specified with the @option{-C} option is invoked in an "
  3407. "environment equivalent to command substitution. It should print a list of "
  3408. "completions, one per line, to the standard output. Backslash may be used to "
  3409. "escape a newline, if necessary."
  3410. msgstr ""
  3411. #. type: ifset
  3412. #: ./rluser.texi:1871
  3413. msgid ""
  3414. "After all of the possible completions are generated, any filter specified "
  3415. "with the @option{-X} option is applied to the list. The filter is a pattern "
  3416. "as used for pathname expansion; a @samp{&} in the pattern is replaced with "
  3417. "the text of the word being completed. A literal @samp{&} may be escaped "
  3418. "with a backslash; the backslash is removed before attempting a match. Any "
  3419. "completion that matches the pattern will be removed from the list. A "
  3420. "leading @samp{!} negates the pattern; in this case any completion not "
  3421. "matching the pattern will be removed. If the @code{nocasematch} shell "
  3422. "option (see the description of @code{shopt} in @ref{The Shopt Builtin}) is "
  3423. "enabled, the match is performed without regard to the case of alphabetic "
  3424. "characters."
  3425. msgstr ""
  3426. #. type: ifset
  3427. #: ./rluser.texi:1876
  3428. msgid ""
  3429. "Finally, any prefix and suffix specified with the @option{-P} and "
  3430. "@option{-S} options are added to each member of the completion list, and the "
  3431. "result is returned to the Readline completion code as the list of possible "
  3432. "completions."
  3433. msgstr ""
  3434. #. type: ifset
  3435. #: ./rluser.texi:1880
  3436. msgid ""
  3437. "If the previously-applied actions do not generate any matches, and the "
  3438. "@option{-o dirnames} option was supplied to @code{complete} when the "
  3439. "compspec was defined, directory name completion is attempted."
  3440. msgstr ""
  3441. #. type: ifset
  3442. #: ./rluser.texi:1884
  3443. msgid ""
  3444. "If the @option{-o plusdirs} option was supplied to @code{complete} when the "
  3445. "compspec was defined, directory name completion is attempted and any matches "
  3446. "are added to the results of the other actions."
  3447. msgstr ""
  3448. #. type: ifset
  3449. #: ./rluser.texi:1896
  3450. msgid ""
  3451. "By default, if a compspec is found, whatever it generates is returned to the "
  3452. "completion code as the full set of possible completions. The default Bash "
  3453. "completions are not attempted, and the Readline default of filename "
  3454. "completion is disabled. If the @option{-o bashdefault} option was supplied "
  3455. "to @code{complete} when the compspec was defined, the default Bash "
  3456. "completions are attempted if the compspec generates no matches. If the "
  3457. "@option{-o default} option was supplied to @code{complete} when the compspec "
  3458. "was defined, Readline's default completion will be performed if the compspec "
  3459. "(and, if attempted, the default Bash completions) generate no matches."
  3460. msgstr ""
  3461. #. type: ifset
  3462. #: ./rluser.texi:1902
  3463. msgid ""
  3464. "When a compspec indicates that directory name completion is desired, the "
  3465. "programmable completion functions force Readline to append a slash to "
  3466. "completed names which are symbolic links to directories, subject to the "
  3467. "value of the @var{mark-directories} Readline variable, regardless of the "
  3468. "setting of the @var{mark-symlinked-directories} Readline variable."
  3469. msgstr ""
  3470. #. type: ifset
  3471. #: ./rluser.texi:1914
  3472. msgid ""
  3473. "There is some support for dynamically modifying completions. This is most "
  3474. "useful when used in combination with a default completion specified with "
  3475. "@option{-D}. It's possible for shell functions executed as completion "
  3476. "handlers to indicate that completion should be retried by returning an exit "
  3477. "status of 124. If a shell function returns 124, and changes the compspec "
  3478. "associated with the command on which completion is being attempted (supplied "
  3479. "as the first argument when the function is executed), programmable "
  3480. "completion restarts from the beginning, with an attempt to find a new "
  3481. "compspec for that command. This allows a set of completions to be built "
  3482. "dynamically as completion is attempted, rather than being loaded all at "
  3483. "once."
  3484. msgstr ""
  3485. #. type: ifset
  3486. #: ./rluser.texi:1918
  3487. msgid ""
  3488. "For instance, assuming that there is a library of compspecs, each kept in a "
  3489. "file corresponding to the name of the command, the following default "
  3490. "completion function would load completions dynamically:"
  3491. msgstr ""
  3492. #. type: example
  3493. #: ./rluser.texi:1925
  3494. #, no-wrap
  3495. msgid ""
  3496. "_completion_loader()\n"
  3497. "@{\n"
  3498. " . \"/etc/bash_completion.d/$1.sh\" >/dev/null 2>&1 && return 124\n"
  3499. "@}\n"
  3500. "complete -D -F _completion_loader -o bashdefault -o default\n"
  3501. msgstr ""
  3502. #. type: section
  3503. #: ./rluser.texi:1927 ./rluser.texi:1928
  3504. #, no-wrap
  3505. msgid "Programmable Completion Builtins"
  3506. msgstr ""
  3507. #. type: cindex
  3508. #: ./rluser.texi:1929
  3509. #, no-wrap
  3510. msgid "completion builtins"
  3511. msgstr ""
  3512. #. type: ifset
  3513. #: ./rluser.texi:1934
  3514. msgid ""
  3515. "Three builtin commands are available to manipulate the programmable "
  3516. "completion facilities: one to specify how the arguments to a particular "
  3517. "command are to be completed, and two to modify the completion as it is "
  3518. "happening."
  3519. msgstr ""
  3520. #. type: btindex
  3521. #: ./rluser.texi:1936 ./rluser.texi:1937
  3522. #, no-wrap
  3523. msgid "compgen"
  3524. msgstr ""
  3525. #. type: example
  3526. #: ./rluser.texi:1940
  3527. #, no-wrap
  3528. msgid "@code{compgen [@var{option}] [@var{word}]}\n"
  3529. msgstr ""
  3530. #. type: table
  3531. #: ./rluser.texi:1950
  3532. msgid ""
  3533. "Generate possible completion matches for @var{word} according to the "
  3534. "@var{option}s, which may be any option accepted by the @code{complete} "
  3535. "builtin with the exception of @option{-p} and @option{-r}, and write the "
  3536. "matches to the standard output. When using the @option{-F} or @option{-C} "
  3537. "options, the various shell variables set by the programmable completion "
  3538. "facilities, while available, will not have useful values."
  3539. msgstr ""
  3540. #. type: table
  3541. #: ./rluser.texi:1956
  3542. msgid ""
  3543. "The matches will be generated in the same way as if the programmable "
  3544. "completion code had generated them directly from a completion specification "
  3545. "with the same flags. If @var{word} is specified, only those completions "
  3546. "matching @var{word} will be displayed."
  3547. msgstr ""
  3548. #. type: table
  3549. #: ./rluser.texi:1959
  3550. msgid ""
  3551. "The return value is true unless an invalid option is supplied, or no matches "
  3552. "were generated."
  3553. msgstr ""
  3554. #. type: btindex
  3555. #: ./rluser.texi:1960 ./rluser.texi:1961
  3556. #, no-wrap
  3557. msgid "complete"
  3558. msgstr ""
  3559. #. type: example
  3560. #: ./rluser.texi:1967
  3561. #, no-wrap
  3562. msgid ""
  3563. "@code{complete [-abcdefgjksuv] [-o @var{comp-option}] [-DE] [-A "
  3564. "@var{action}] [-G @var{globpat}] [-W @var{wordlist}]\n"
  3565. "[-F @var{function}] [-C @var{command}] [-X @var{filterpat}]\n"
  3566. "[-P @var{prefix}] [-S @var{suffix}] @var{name} [@var{name} @dots{}]}\n"
  3567. "@code{complete -pr [-DE] [@var{name} @dots{}]}\n"
  3568. msgstr ""
  3569. #. type: table
  3570. #: ./rluser.texi:1982
  3571. msgid ""
  3572. "Specify how arguments to each @var{name} should be completed. If the "
  3573. "@option{-p} option is supplied, or if no options are supplied, existing "
  3574. "completion specifications are printed in a way that allows them to be reused "
  3575. "as input. The @option{-r} option removes a completion specification for "
  3576. "each @var{name}, or, if no @var{name}s are supplied, all completion "
  3577. "specifications. The @option{-D} option indicates that the remaining options "
  3578. "and actions should apply to the ``default'' command completion; that is, "
  3579. "completion attempted on a command for which no completion has previously "
  3580. "been defined. The @option{-E} option indicates that the remaining options "
  3581. "and actions should apply to ``empty'' command completion; that is, "
  3582. "completion attempted on a blank line."
  3583. msgstr ""
  3584. #. type: table
  3585. #: ./rluser.texi:1986
  3586. msgid ""
  3587. "The process of applying these completion specifications when word completion "
  3588. "is attempted is described above (@pxref{Programmable Completion}). The "
  3589. "@option{-D} option takes precedence over @option{-E}."
  3590. msgstr ""
  3591. #. type: table
  3592. #: ./rluser.texi:1992
  3593. msgid ""
  3594. "Other options, if specified, have the following meanings. The arguments to "
  3595. "the @option{-G}, @option{-W}, and @option{-X} options (and, if necessary, "
  3596. "the @option{-P} and @option{-S} options) should be quoted to protect them "
  3597. "from expansion before the @code{complete} builtin is invoked."
  3598. msgstr ""
  3599. #. type: item
  3600. #: ./rluser.texi:1995
  3601. #, no-wrap
  3602. msgid "-o @var{comp-option}"
  3603. msgstr ""
  3604. #. type: table
  3605. #: ./rluser.texi:1999
  3606. msgid ""
  3607. "The @var{comp-option} controls several aspects of the compspec's behavior "
  3608. "beyond the simple generation of completions. @var{comp-option} may be one "
  3609. "of:"
  3610. msgstr ""
  3611. #. type: item
  3612. #: ./rluser.texi:2002
  3613. #, no-wrap
  3614. msgid "bashdefault"
  3615. msgstr ""
  3616. #. type: table
  3617. #: ./rluser.texi:2005
  3618. msgid ""
  3619. "Perform the rest of the default Bash completions if the compspec generates "
  3620. "no matches."
  3621. msgstr ""
  3622. #. type: item
  3623. #: ./rluser.texi:2006
  3624. #, no-wrap
  3625. msgid "default"
  3626. msgstr ""
  3627. #. type: table
  3628. #: ./rluser.texi:2009
  3629. msgid ""
  3630. "Use Readline's default filename completion if the compspec generates no "
  3631. "matches."
  3632. msgstr ""
  3633. #. type: item
  3634. #: ./rluser.texi:2010
  3635. #, no-wrap
  3636. msgid "dirnames"
  3637. msgstr ""
  3638. #. type: table
  3639. #: ./rluser.texi:2012
  3640. msgid "Perform directory name completion if the compspec generates no matches."
  3641. msgstr ""
  3642. #. type: item
  3643. #: ./rluser.texi:2013
  3644. #, no-wrap
  3645. msgid "filenames"
  3646. msgstr ""
  3647. #. type: table
  3648. #: ./rluser.texi:2019
  3649. msgid ""
  3650. "Tell Readline that the compspec generates filenames, so it can perform any "
  3651. "filename-specific processing (like adding a slash to directory names quoting "
  3652. "special characters, or suppressing trailing spaces). This option is "
  3653. "intended to be used with shell functions specified with @option{-F}."
  3654. msgstr ""
  3655. #. type: item
  3656. #: ./rluser.texi:2020
  3657. #, no-wrap
  3658. msgid "noquote"
  3659. msgstr ""
  3660. #. type: table
  3661. #: ./rluser.texi:2023
  3662. msgid ""
  3663. "Tell Readline not to quote the completed words if they are filenames "
  3664. "(quoting filenames is the default)."
  3665. msgstr ""
  3666. #. type: item
  3667. #: ./rluser.texi:2024
  3668. #, no-wrap
  3669. msgid "nosort"
  3670. msgstr ""
  3671. #. type: table
  3672. #: ./rluser.texi:2026
  3673. msgid "Tell Readline not to sort the list of possible completions alphabetically."
  3674. msgstr ""
  3675. #. type: item
  3676. #: ./rluser.texi:2027
  3677. #, no-wrap
  3678. msgid "nospace"
  3679. msgstr ""
  3680. #. type: table
  3681. #: ./rluser.texi:2030
  3682. msgid ""
  3683. "Tell Readline not to append a space (the default) to words completed at the "
  3684. "end of the line."
  3685. msgstr ""
  3686. #. type: item
  3687. #: ./rluser.texi:2031
  3688. #, no-wrap
  3689. msgid "plusdirs"
  3690. msgstr ""
  3691. #. type: table
  3692. #: ./rluser.texi:2035
  3693. msgid ""
  3694. "After any matches defined by the compspec are generated, directory name "
  3695. "completion is attempted and any matches are added to the results of the "
  3696. "other actions."
  3697. msgstr ""
  3698. #. type: item
  3699. #: ./rluser.texi:2038
  3700. #, no-wrap
  3701. msgid "-A @var{action}"
  3702. msgstr ""
  3703. #. type: table
  3704. #: ./rluser.texi:2041
  3705. msgid ""
  3706. "The @var{action} may be one of the following to generate a list of possible "
  3707. "completions:"
  3708. msgstr ""
  3709. #. type: item
  3710. #: ./rluser.texi:2043
  3711. #, no-wrap
  3712. msgid "alias"
  3713. msgstr ""
  3714. #. type: table
  3715. #: ./rluser.texi:2045
  3716. msgid "Alias names. May also be specified as @option{-a}."
  3717. msgstr ""
  3718. #. type: item
  3719. #: ./rluser.texi:2046
  3720. #, no-wrap
  3721. msgid "arrayvar"
  3722. msgstr ""
  3723. #. type: table
  3724. #: ./rluser.texi:2048
  3725. msgid "Array variable names."
  3726. msgstr ""
  3727. #. type: item
  3728. #: ./rluser.texi:2049
  3729. #, no-wrap
  3730. msgid "binding"
  3731. msgstr ""
  3732. #. type: table
  3733. #: ./rluser.texi:2051
  3734. msgid "Readline key binding names (@pxref{Bindable Readline Commands})."
  3735. msgstr ""
  3736. #. type: item
  3737. #: ./rluser.texi:2052
  3738. #, no-wrap
  3739. msgid "builtin"
  3740. msgstr ""
  3741. #. type: table
  3742. #: ./rluser.texi:2054
  3743. msgid "Names of shell builtin commands. May also be specified as @option{-b}."
  3744. msgstr ""
  3745. #. type: item
  3746. #: ./rluser.texi:2055
  3747. #, no-wrap
  3748. msgid "command"
  3749. msgstr ""
  3750. #. type: table
  3751. #: ./rluser.texi:2057
  3752. msgid "Command names. May also be specified as @option{-c}."
  3753. msgstr ""
  3754. #. type: item
  3755. #: ./rluser.texi:2058
  3756. #, no-wrap
  3757. msgid "directory"
  3758. msgstr ""
  3759. #. type: table
  3760. #: ./rluser.texi:2060
  3761. msgid "Directory names. May also be specified as @option{-d}."
  3762. msgstr ""
  3763. #. type: item
  3764. #: ./rluser.texi:2061
  3765. #, no-wrap
  3766. msgid "disabled"
  3767. msgstr ""
  3768. #. type: table
  3769. #: ./rluser.texi:2063
  3770. msgid "Names of disabled shell builtins."
  3771. msgstr ""
  3772. #. type: item
  3773. #: ./rluser.texi:2064
  3774. #, no-wrap
  3775. msgid "enabled"
  3776. msgstr ""
  3777. #. type: table
  3778. #: ./rluser.texi:2066
  3779. msgid "Names of enabled shell builtins."
  3780. msgstr ""
  3781. #. type: item
  3782. #: ./rluser.texi:2067
  3783. #, no-wrap
  3784. msgid "export"
  3785. msgstr ""
  3786. #. type: table
  3787. #: ./rluser.texi:2069
  3788. msgid "Names of exported shell variables. May also be specified as @option{-e}."
  3789. msgstr ""
  3790. #. type: item
  3791. #: ./rluser.texi:2070
  3792. #, no-wrap
  3793. msgid "file"
  3794. msgstr ""
  3795. #. type: table
  3796. #: ./rluser.texi:2072
  3797. msgid "File names. May also be specified as @option{-f}."
  3798. msgstr ""
  3799. #. type: item
  3800. #: ./rluser.texi:2073
  3801. #, no-wrap
  3802. msgid "function"
  3803. msgstr ""
  3804. #. type: table
  3805. #: ./rluser.texi:2075
  3806. msgid "Names of shell functions."
  3807. msgstr ""
  3808. #. type: item
  3809. #: ./rluser.texi:2076
  3810. #, no-wrap
  3811. msgid "group"
  3812. msgstr ""
  3813. #. type: table
  3814. #: ./rluser.texi:2078
  3815. msgid "Group names. May also be specified as @option{-g}."
  3816. msgstr ""
  3817. #. type: item
  3818. #: ./rluser.texi:2079
  3819. #, no-wrap
  3820. msgid "helptopic"
  3821. msgstr ""
  3822. #. type: table
  3823. #: ./rluser.texi:2081
  3824. msgid "Help topics as accepted by the @code{help} builtin (@pxref{Bash Builtins})."
  3825. msgstr ""
  3826. #. type: item
  3827. #: ./rluser.texi:2082
  3828. #, no-wrap
  3829. msgid "hostname"
  3830. msgstr ""
  3831. #. type: table
  3832. #: ./rluser.texi:2085
  3833. msgid ""
  3834. "Hostnames, as taken from the file specified by the @env{HOSTFILE} shell "
  3835. "variable (@pxref{Bash Variables})."
  3836. msgstr ""
  3837. #. type: item
  3838. #: ./rluser.texi:2086
  3839. #, no-wrap
  3840. msgid "job"
  3841. msgstr ""
  3842. #. type: table
  3843. #: ./rluser.texi:2088
  3844. msgid "Job names, if job control is active. May also be specified as @option{-j}."
  3845. msgstr ""
  3846. #. type: item
  3847. #: ./rluser.texi:2089
  3848. #, no-wrap
  3849. msgid "keyword"
  3850. msgstr ""
  3851. #. type: table
  3852. #: ./rluser.texi:2091
  3853. msgid "Shell reserved words. May also be specified as @option{-k}."
  3854. msgstr ""
  3855. #. type: item
  3856. #: ./rluser.texi:2092
  3857. #, no-wrap
  3858. msgid "running"
  3859. msgstr ""
  3860. #. type: table
  3861. #: ./rluser.texi:2094
  3862. msgid "Names of running jobs, if job control is active."
  3863. msgstr ""
  3864. #. type: item
  3865. #: ./rluser.texi:2095
  3866. #, no-wrap
  3867. msgid "service"
  3868. msgstr ""
  3869. #. type: table
  3870. #: ./rluser.texi:2097
  3871. msgid "Service names. May also be specified as @option{-s}."
  3872. msgstr ""
  3873. #. type: item
  3874. #: ./rluser.texi:2098
  3875. #, no-wrap
  3876. msgid "setopt"
  3877. msgstr ""
  3878. #. type: table
  3879. #: ./rluser.texi:2101
  3880. msgid ""
  3881. "Valid arguments for the @option{-o} option to the @code{set} builtin "
  3882. "(@pxref{The Set Builtin})."
  3883. msgstr ""
  3884. #. type: item
  3885. #: ./rluser.texi:2102
  3886. #, no-wrap
  3887. msgid "shopt"
  3888. msgstr ""
  3889. #. type: table
  3890. #: ./rluser.texi:2105
  3891. msgid ""
  3892. "Shell option names as accepted by the @code{shopt} builtin (@pxref{Bash "
  3893. "Builtins})."
  3894. msgstr ""
  3895. #. type: item
  3896. #: ./rluser.texi:2106
  3897. #, no-wrap
  3898. msgid "signal"
  3899. msgstr ""
  3900. #. type: table
  3901. #: ./rluser.texi:2108
  3902. msgid "Signal names."
  3903. msgstr ""
  3904. #. type: item
  3905. #: ./rluser.texi:2109
  3906. #, no-wrap
  3907. msgid "stopped"
  3908. msgstr ""
  3909. #. type: table
  3910. #: ./rluser.texi:2111
  3911. msgid "Names of stopped jobs, if job control is active."
  3912. msgstr ""
  3913. #. type: item
  3914. #: ./rluser.texi:2112
  3915. #, no-wrap
  3916. msgid "user"
  3917. msgstr ""
  3918. #. type: table
  3919. #: ./rluser.texi:2114
  3920. msgid "User names. May also be specified as @option{-u}."
  3921. msgstr ""
  3922. #. type: item
  3923. #: ./rluser.texi:2115
  3924. #, no-wrap
  3925. msgid "variable"
  3926. msgstr ""
  3927. #. type: table
  3928. #: ./rluser.texi:2117
  3929. msgid "Names of all shell variables. May also be specified as @option{-v}."
  3930. msgstr ""
  3931. #. type: item
  3932. #: ./rluser.texi:2119
  3933. #, no-wrap
  3934. msgid "-C @var{command}"
  3935. msgstr ""
  3936. #. type: table
  3937. #: ./rluser.texi:2122
  3938. msgid ""
  3939. "@var{command} is executed in a subshell environment, and its output is used "
  3940. "as the possible completions."
  3941. msgstr ""
  3942. #. type: item
  3943. #: ./rluser.texi:2123
  3944. #, no-wrap
  3945. msgid "-F @var{function}"
  3946. msgstr ""
  3947. #. type: table
  3948. #: ./rluser.texi:2132
  3949. msgid ""
  3950. "The shell function @var{function} is executed in the current shell "
  3951. "environment. When it is executed, $1 is the name of the command whose "
  3952. "arguments are being completed, $2 is the word being completed, and $3 is the "
  3953. "word preceding the word being completed, as described above "
  3954. "(@pxref{Programmable Completion}). When it finishes, the possible "
  3955. "completions are retrieved from the value of the @env{COMPREPLY} array "
  3956. "variable."
  3957. msgstr ""
  3958. #. type: item
  3959. #: ./rluser.texi:2133
  3960. #, no-wrap
  3961. msgid "-G @var{globpat}"
  3962. msgstr ""
  3963. #. type: table
  3964. #: ./rluser.texi:2136
  3965. msgid ""
  3966. "The filename expansion pattern @var{globpat} is expanded to generate the "
  3967. "possible completions."
  3968. msgstr ""
  3969. #. type: item
  3970. #: ./rluser.texi:2137
  3971. #, no-wrap
  3972. msgid "-P @var{prefix}"
  3973. msgstr ""
  3974. #. type: table
  3975. #: ./rluser.texi:2140
  3976. msgid ""
  3977. "@var{prefix} is added at the beginning of each possible completion after all "
  3978. "other options have been applied."
  3979. msgstr ""
  3980. #. type: item
  3981. #: ./rluser.texi:2141
  3982. #, no-wrap
  3983. msgid "-S @var{suffix}"
  3984. msgstr ""
  3985. #. type: table
  3986. #: ./rluser.texi:2144
  3987. msgid ""
  3988. "@var{suffix} is appended to each possible completion after all other options "
  3989. "have been applied."
  3990. msgstr ""
  3991. #. type: item
  3992. #: ./rluser.texi:2145
  3993. #, no-wrap
  3994. msgid "-W @var{wordlist}"
  3995. msgstr ""
  3996. #. type: table
  3997. #: ./rluser.texi:2151
  3998. msgid ""
  3999. "The @var{wordlist} is split using the characters in the @env{IFS} special "
  4000. "variable as delimiters, and each resultant word is expanded. The possible "
  4001. "completions are the members of the resultant list which match the word being "
  4002. "completed."
  4003. msgstr ""
  4004. #. type: item
  4005. #: ./rluser.texi:2152
  4006. #, no-wrap
  4007. msgid "-X @var{filterpat}"
  4008. msgstr ""
  4009. #. type: table
  4010. #: ./rluser.texi:2159
  4011. msgid ""
  4012. "@var{filterpat} is a pattern as used for filename expansion. It is applied "
  4013. "to the list of possible completions generated by the preceding options and "
  4014. "arguments, and each completion matching @var{filterpat} is removed from the "
  4015. "list. A leading @samp{!} in @var{filterpat} negates the pattern; in this "
  4016. "case, any completion not matching @var{filterpat} is removed."
  4017. msgstr ""
  4018. #. type: table
  4019. #: ./rluser.texi:2166
  4020. msgid ""
  4021. "The return value is true unless an invalid option is supplied, an option "
  4022. "other than @option{-p} or @option{-r} is supplied without a @var{name} "
  4023. "argument, an attempt is made to remove a completion specification for a "
  4024. "@var{name} for which no specification exists, or an error occurs adding a "
  4025. "completion specification."
  4026. msgstr ""
  4027. #. type: btindex
  4028. #: ./rluser.texi:2167 ./rluser.texi:2168
  4029. #, no-wrap
  4030. msgid "compopt"
  4031. msgstr ""
  4032. #. type: example
  4033. #: ./rluser.texi:2171
  4034. #, no-wrap
  4035. msgid "@code{compopt} [-o @var{option}] [-DE] [+o @var{option}] [@var{name}]\n"
  4036. msgstr ""
  4037. #. type: table
  4038. #: ./rluser.texi:2185
  4039. msgid ""
  4040. "Modify completion options for each @var{name} according to the "
  4041. "@var{option}s, or for the currently-executing completion if no @var{name}s "
  4042. "are supplied. If no @var{option}s are given, display the completion options "
  4043. "for each @var{name} or the current completion. The possible values of "
  4044. "@var{option} are those valid for the @code{complete} builtin described "
  4045. "above. The @option{-D} option indicates that the remaining options should "
  4046. "apply to the ``default'' command completion; that is, completion attempted "
  4047. "on a command for which no completion has previously been defined. The "
  4048. "@option{-E} option indicates that the remaining options should apply to "
  4049. "``empty'' command completion; that is, completion attempted on a blank line."
  4050. msgstr ""
  4051. #. type: table
  4052. #: ./rluser.texi:2187
  4053. msgid "The @option{-D} option takes precedence over @option{-E}."
  4054. msgstr ""
  4055. #. type: table
  4056. #: ./rluser.texi:2191
  4057. msgid ""
  4058. "The return value is true unless an invalid option is supplied, an attempt is "
  4059. "made to modify the options for a @var{name} for which no completion "
  4060. "specification exists, or an output error occurs."
  4061. msgstr ""
  4062. #. type: section
  4063. #: ./rluser.texi:2194 ./rluser.texi:2195
  4064. #, no-wrap
  4065. msgid "A Programmable Completion Example"
  4066. msgstr ""
  4067. #. type: ifset
  4068. #: ./rluser.texi:2200
  4069. msgid ""
  4070. "The most common way to obtain additional completion functionality beyond the "
  4071. "default actions @code{complete} and @code{compgen} provide is to use a shell "
  4072. "function and bind it to a particular command using @code{complete -F}."
  4073. msgstr ""
  4074. #. type: ifset
  4075. #: ./rluser.texi:2207
  4076. msgid ""
  4077. "The following function provides completions for the @code{cd} builtin. It "
  4078. "is a reasonably good example of what shell functions must do when used for "
  4079. "completion. This function uses the word passsed as @code{$2} to determine "
  4080. "the directory name to complete. You can also use the @code{COMP_WORDS} "
  4081. "array variable; the current word is indexed by the @code{COMP_CWORD} "
  4082. "variable."
  4083. msgstr ""
  4084. #. type: ifset
  4085. #: ./rluser.texi:2219
  4086. msgid ""
  4087. "The function relies on the @code{complete} and @code{compgen} builtins to do "
  4088. "much of the work, adding only the things that the Bash @code{cd} does beyond "
  4089. "accepting basic directory names: tilde expansion (@pxref{Tilde Expansion}), "
  4090. "searching directories in @var{$CDPATH}, which is described above "
  4091. "(@pxref{Bourne Shell Builtins}), and basic support for the "
  4092. "@code{cdable_vars} shell option (@pxref{The Shopt Builtin}). "
  4093. "@code{_comp_cd} modifies the value of @var{IFS} so that it contains only a "
  4094. "newline to accommodate file names containing spaces and tabs -- "
  4095. "@code{compgen} prints the possible completions it generates one per line."
  4096. msgstr ""
  4097. #. type: ifset
  4098. #: ./rluser.texi:2223
  4099. msgid ""
  4100. "Possible completions go into the @var{COMPREPLY} array variable, one "
  4101. "completion per array element. The programmable completion system retrieves "
  4102. "the completions from there when the function returns."
  4103. msgstr ""
  4104. #. type: example
  4105. #: ./rluser.texi:2232
  4106. #, no-wrap
  4107. msgid ""
  4108. "# A completion function for the cd builtin\n"
  4109. "# based on the cd completion function from the bash_completion package\n"
  4110. "_comp_cd()\n"
  4111. "@{\n"
  4112. " local IFS=$' \\t\\n' # normalize IFS\n"
  4113. " local cur _skipdot _cdpath\n"
  4114. " local i j k\n"
  4115. "\n"
  4116. msgstr ""
  4117. #. type: example
  4118. #: ./rluser.texi:2238
  4119. #, no-wrap
  4120. msgid ""
  4121. " # Tilde expansion, with side effect of expanding tilde to full "
  4122. "pathname\n"
  4123. " case \"$2\" in\n"
  4124. " \\~*) eval cur=\"$2\" ;;\n"
  4125. " *) cur=$2 ;;\n"
  4126. " esac\n"
  4127. "\n"
  4128. msgstr ""
  4129. #. type: example
  4130. #: ./rluser.texi:2263
  4131. #, no-wrap
  4132. msgid ""
  4133. " # no cdpath or absolute pathname -- straight directory completion\n"
  4134. " if [[ -z \"$@{CDPATH:-@}\" ]] || [[ \"$cur\" == @@(./*|../*|/*) ]]; "
  4135. "then\n"
  4136. " # compgen prints paths one per line; could also use while loop\n"
  4137. " IFS=$'\\n'\n"
  4138. " COMPREPLY=( $(compgen -d -- \"$cur\") )\n"
  4139. " IFS=$' \\t\\n'\n"
  4140. " # CDPATH+directories in the current directory if not in CDPATH\n"
  4141. " else\n"
  4142. " IFS=$'\\n'\n"
  4143. " _skipdot=false\n"
  4144. " # preprocess CDPATH to convert null directory names to .\n"
  4145. " _cdpath=$@{CDPATH/#:/.:@}\n"
  4146. " _cdpath=$@{_cdpath//::/:.:@}\n"
  4147. " _cdpath=$@{_cdpath/%:/:.@}\n"
  4148. " for i in $@{_cdpath//:/$'\\n'@}; do\n"
  4149. " if [[ $i -ef . ]]; then _skipdot=true; fi\n"
  4150. " k=\"$@{#COMPREPLY[@@]@}\"\n"
  4151. " for j in $( compgen -d -- \"$i/$cur\" ); do\n"
  4152. " COMPREPLY[k++]=$@{j#$i/@} # cut off directory\n"
  4153. " done\n"
  4154. " done\n"
  4155. " $_skipdot || COMPREPLY+=( $(compgen -d -- \"$cur\") )\n"
  4156. " IFS=$' \\t\\n'\n"
  4157. " fi\n"
  4158. "\n"
  4159. msgstr ""
  4160. #. type: example
  4161. #: ./rluser.texi:2268
  4162. #, no-wrap
  4163. msgid ""
  4164. " # variable names if appropriate shell option set and no completions\n"
  4165. " if shopt -q cdable_vars && [[ $@{#COMPREPLY[@@]@} -eq 0 ]]; then\n"
  4166. " COMPREPLY=( $(compgen -v -- \"$cur\") )\n"
  4167. " fi\n"
  4168. "\n"
  4169. msgstr ""
  4170. #. type: example
  4171. #: ./rluser.texi:2271
  4172. #, no-wrap
  4173. msgid ""
  4174. " return 0\n"
  4175. "@}\n"
  4176. msgstr ""
  4177. #. type: ifset
  4178. #: ./rluser.texi:2275
  4179. msgid ""
  4180. "We install the completion function using the @option{-F} option to "
  4181. "@code{complete}:"
  4182. msgstr ""
  4183. #. type: example
  4184. #: ./rluser.texi:2280
  4185. #, no-wrap
  4186. msgid ""
  4187. "# Tell readline to quote appropriate and append slashes to directories;\n"
  4188. "# use the bash default completion for other arguments\n"
  4189. "complete -o filenames -o nospace -o bashdefault -F _comp_cd cd\n"
  4190. msgstr ""
  4191. #. type: ifset
  4192. #: ./rluser.texi:2298
  4193. msgid ""
  4194. "Since we'd like Bash and Readline to take care of some of the other details "
  4195. "for us, we use several other options to tell Bash and Readline what to do. "
  4196. "The @option{-o filenames} option tells Readline that the possible "
  4197. "completions should be treated as filenames, and quoted appropriately. That "
  4198. "option will also cause Readline to append a slash to filenames it can "
  4199. "determine are directories (which is why we might want to extend "
  4200. "@code{_comp_cd} to append a slash if we're using directories found via "
  4201. "@var{CDPATH}: Readline can't tell those completions are directories). The "
  4202. "@option{-o nospace} option tells Readline to not append a space character to "
  4203. "the directory name, in case we want to append to it. The @option{-o "
  4204. "bashdefault} option brings in the rest of the \"Bash default\" completions "
  4205. "-- possible completion that Bash adds to the default Readline set. These "
  4206. "include things like command name completion, variable completion for words "
  4207. "beginning with @samp{@{}, completions containing pathname expansion patterns "
  4208. "(@pxref{Filename Expansion}), and so on."
  4209. msgstr ""
  4210. #. type: ifset
  4211. #: ./rluser.texi:2301
  4212. msgid ""
  4213. "Once installed using @code{complete}, @code{_comp_cd} will be called every "
  4214. "time we attempt word completion for a @code{cd} command."
  4215. msgstr ""
  4216. #. type: ifset
  4217. #: ./rluser.texi:2308
  4218. msgid ""
  4219. "Many more examples -- an extensive collection of completions for most of the "
  4220. "common GNU, Unix, and Linux commands -- are available as part of the "
  4221. "bash_completion project. This is installed by default on many GNU/Linux "
  4222. "distributions. Originally written by Ian Macdonald, the project now lives "
  4223. "at @url{http://bash-completion.alioth.debian.org/}. There are ports for "
  4224. "other systems such as Solaris and Mac OS X."
  4225. msgstr ""
  4226. #. type: ifset
  4227. #: ./rluser.texi:2311
  4228. msgid ""
  4229. "An older version of the bash_completion package is distributed with bash in "
  4230. "the @file{examples/complete} subdirectory."
  4231. msgstr ""